How to Integrate Bolt.new with AfterShip

1// lib/aftership.ts
2const AFTERSHIP_BASE = 'https://api.aftership.com/tracking/2023-10';
3
4export type TrackingTag =
5  | 'Pending'
6  | 'InfoReceived'
7  | 'InTransit'
8  | 'OutForDelivery'
9  | 'AttemptFail'
10  | 'Delivered'
11  | 'AvailableForPickup'
12  | 'Exception'
13  | 'Expired';
14
15export interface TrackingEvent {
16  slug: string;
17  city: string | null;
18  state: string | null;
19  country_iso3: string | null;
20  message: string;
21  tag: TrackingTag;
22  subtag: string;
23  subtag_message: string;
24  created_at: string;
25  updated_at: string;
26  location: string | null;
27}
28
29export interface Tracking {
30  id: string;
31  tracking_number: string;
32  slug: string;
33  title: string | null;
34  customer_name: string | null;
35  tag: TrackingTag;
36  subtag_message: string;
37  created_at: string;
38  updated_at: string;
39  last_updated_at: string;
40  expected_delivery: string | null;
41  origin_country_iso3: string | null;
42  destination_country_iso3: string | null;
43  checkpoints: TrackingEvent[];
44}
45
46export async function aftershipFetch<T>(
47  path: string,
48  options: RequestInit = {}
49): Promise<{ meta: { code: number; message: string }; data: T }> {
50  const res = await fetch(`${AFTERSHIP_BASE}${path}`, {
51    ...options,
52    headers: {
53      'as-api-key': process.env.AFTERSHIP_API_KEY!,
54      'Content-Type': 'application/json',
55      ...options.headers,
56    },
57  });
58
59  const json = await res.json();
60  if (!res.ok) throw new Error(`AfterShip error ${res.status}: ${json.meta?.message}`);
61  return json;
62}

1// app/api/aftership/trackings/route.ts
2import { NextRequest, NextResponse } from 'next/server';
3import { aftershipFetch } from '@/lib/aftership';
4
5export async function GET(request: NextRequest) {
6  const page = request.nextUrl.searchParams.get('page') ?? '1';
7  const limit = request.nextUrl.searchParams.get('limit') ?? '20';
8
9  try {
10    const result = await aftershipFetch<{ trackings: unknown[]; total: number }>(
11      `/trackings?page=${page}&limit=${limit}`
12    );
13    return NextResponse.json(result.data);
14  } catch (error) {
15    return NextResponse.json({ error: String(error) }, { status: 500 });
16  }
17}
18
19export async function POST(request: NextRequest) {
20  const body = await request.json();
21  const { tracking_number, slug, title, customer_name } = body;
22
23  if (!tracking_number) {
24    return NextResponse.json({ error: 'tracking_number is required' }, { status: 400 });
25  }
26
27  try {
28    const result = await aftershipFetch('/trackings', {
29      method: 'POST',
30      body: JSON.stringify({
31        tracking: {
32          tracking_number,
33          slug: slug || undefined,
34          title: title || undefined,
35          customer_name: customer_name || undefined,
36        },
37      }),
38    });
39    return NextResponse.json(result.data);
40  } catch (error) {
41    return NextResponse.json({ error: String(error) }, { status: 500 });
42  }
43}

1// app/api/aftership/webhook/route.ts
2// NOTE: Webhooks only work on deployed apps (Netlify/Bolt Cloud)
3// The WebContainer cannot receive incoming HTTP connections
4import { NextRequest, NextResponse } from 'next/server';
5import crypto from 'crypto';
6
7export async function POST(request: NextRequest) {
8  const body = await request.text();
9  const signature = request.headers.get('hmac') ?? '';
10
11  const webhookSecret = process.env.AFTERSHIP_WEBHOOK_SECRET;
12  if (webhookSecret) {
13    const expected = crypto
14      .createHmac('sha256', webhookSecret)
15      .update(body)
16      .digest('hex');
17    if (signature !== expected) {
18      return NextResponse.json({ error: 'Invalid signature' }, { status: 401 });
19    }
20  }
21
22  const payload = JSON.parse(body);
23  const tracking = payload.msg;
24
25  if (!tracking) {
26    return NextResponse.json({ received: true });
27  }
28
29  const tag = tracking.tag as string;
30  const trackingNumber = tracking.tracking_number as string;
31  const customerName = tracking.customer_name as string;
32
33  console.log(`AfterShip webhook: ${trackingNumber} is now ${tag}`);
34
35  switch (tag) {
36    case 'OutForDelivery':
37      console.log(`Notifying ${customerName}: Package out for delivery`);
38      // Send email via SendGrid here
39      break;
40    case 'Delivered':
41      console.log(`Notifying ${customerName}: Package delivered`);
42      break;
43    case 'Exception':
44      console.log(`Alert: Delivery exception for ${trackingNumber}`);
45      break;
46  }
47
48  return NextResponse.json({ received: true });
49}