@freighttech/shipment-tracking 0.6.0

package/src/modules/shipment_tracking/api/webhooks/deliveries/route.ts

@@ -0,0 +1,82 @@
+import { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'
+import { z } from 'zod'
+import { WebhookDelivery } from '../../../data/entities'
+import { webhookDeliveryListSchema } from '../../../data/validators'
+import {
+  createShipmentTrackingCrudOpenApi,
+  createPagedListResponseSchema,
+} from '../../openapi'
+
+type DeliveryListQuery = z.infer<typeof webhookDeliveryListSchema>
+
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ['shipment_tracking.webhooks.view'] },
+}
+
+const listFields = [
+  'id',
+  'webhook_id',
+  'event_type',
+  'status',
+  'retry_count',
+  'next_retry_at',
+  'response_status',
+  'error_message',
+  'created_at',
+]
+
+const buildFilters = (query: DeliveryListQuery): Record<string, unknown> => {
+  const filters: Record<string, unknown> = {}
+
+  if (query.webhookId) {
+    filters.webhook = query.webhookId
+  }
+
+  if (query.status) {
+    filters.status = query.status
+  }
+
+  if (query.eventType) {
+    filters.eventType = query.eventType
+  }
+
+  return filters
+}
+
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: WebhookDelivery,
+    idField: 'id',
+    orgField: null,
+    tenantField: null,
+  },
+  list: {
+    schema: webhookDeliveryListSchema,
+    fields: listFields,
+    sortFieldMap: {
+      id: 'id',
+      status: 'status',
+      eventType: 'event_type',
+      createdAt: 'created_at',
+    },
+    buildFilters: async (query) => buildFilters(query),
+  },
+})
+
+export const openApi = createShipmentTrackingCrudOpenApi({
+  resourceName: 'WebhookDelivery',
+  pluralName: 'WebhookDeliveries',
+  querySchema: webhookDeliveryListSchema,
+  listResponseSchema: createPagedListResponseSchema(z.object({
+    id: z.string().uuid(),
+    eventType: z.string(),
+    status: z.string(),
+    retryCount: z.number(),
+    responseStatus: z.number().nullable(),
+    createdAt: z.string(),
+  })),
+})
+
+export const metadata = crud.metadata
+export const GET = crud.GET

package/src/modules/shipment_tracking/api/webhooks/route.ts

@@ -0,0 +1,138 @@
+import { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'
+import { z } from 'zod'
+import { Webhook } from '../../data/entities'
+import { webhookListSchema, webhookCreateSchema, webhookUpdateSchema } from '../../data/validators'
+import { parseBooleanToken } from '@open-mercato/shared/lib/boolean'
+import {
+  createShipmentTrackingCrudOpenApi,
+  createPagedListResponseSchema,
+  defaultOkResponseSchema,
+} from '../openapi'
+import { withScopedPayload } from '../utils'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+
+const rawBodySchema = z.object({}).passthrough()
+
+type WebhookListQuery = z.infer<typeof webhookListSchema>
+
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ['shipment_tracking.webhooks.view'] },
+  POST: { requireAuth: true, requireFeatures: ['shipment_tracking.webhooks.manage'] },
+  PUT: { requireAuth: true, requireFeatures: ['shipment_tracking.webhooks.manage'] },
+  DELETE: { requireAuth: true, requireFeatures: ['shipment_tracking.webhooks.manage'] },
+}
+
+const listFields = [
+  'id',
+  'url',
+  'eventsSubscribed',
+  'hmacSecret',
+  'isActive',
+  'createdAt',
+  'updatedAt',
+]
+
+const buildFilters = (query: WebhookListQuery): Record<string, unknown> => {
+  const filters: Record<string, unknown> = {}
+
+  if (query.id) {
+    filters.id = { $eq: query.id }
+  }
+
+  if (query.isActive !== undefined) {
+    const parsed = parseBooleanToken(query.isActive)
+    if (parsed !== null) {
+      filters.isActive = parsed
+    }
+  }
+
+  return filters
+}
+
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: Webhook,
+    idField: 'id',
+    orgField: 'organizationId',
+    tenantField: 'tenantId',
+  },
+  list: {
+    schema: webhookListSchema,
+    fields: listFields,
+    sortFieldMap: {
+      id: 'id',
+      url: 'url',
+      isActive: 'is_active',
+      createdAt: 'created_at',
+    },
+    buildFilters: async (query) => buildFilters(query),
+  },
+  actions: {
+    create: {
+      commandId: 'shipment_tracking.webhook.create',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate)
+        return webhookCreateSchema.parse(scoped)
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 201,
+    },
+    update: {
+      commandId: 'shipment_tracking.webhook.update',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate)
+        return webhookUpdateSchema.parse(scoped)
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 200,
+    },
+    delete: {
+      commandId: 'shipment_tracking.webhook.delete',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate)
+        return { id: (raw as any)?.id, ...scoped }
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 200,
+    },
+  },
+})
+
+export const openApi = createShipmentTrackingCrudOpenApi({
+  resourceName: 'Webhook',
+  pluralName: 'Webhooks',
+  querySchema: webhookListSchema,
+  listResponseSchema: createPagedListResponseSchema(z.object({
+    id: z.string().uuid(),
+    url: z.string(),
+    eventsSubscribed: z.array(z.string()),
+    isActive: z.boolean(),
+  })),
+  create: {
+    schema: rawBodySchema,
+    description: 'Creates a new webhook subscription.',
+  },
+  update: {
+    schema: rawBodySchema,
+    responseSchema: defaultOkResponseSchema,
+    description: 'Updates an existing webhook.',
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: defaultOkResponseSchema,
+    description: 'Deletes a webhook.',
+  },
+})
+
+export const metadata = crud.metadata
+export const GET = crud.GET
+export const POST = crud.POST
+export const PUT = crud.PUT
+export const DELETE = crud.DELETE

package/src/modules/shipment_tracking/api/webhooks/test/route.ts

@@ -0,0 +1,84 @@
+import { NextRequest, NextResponse } from 'next/server'
+import { z } from 'zod'
+import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
+import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
+import { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'
+import type { CommandBus } from '@open-mercato/shared/lib/commands'
+
+export const metadata = {
+  POST: { requireAuth: true, requireFeatures: ['shipment_tracking.webhooks.manage'] },
+}
+
+const testWebhookSchema = z.object({
+  id: z.string().uuid(),
+})
+
+/**
+ * POST: Send a test webhook delivery to verify the endpoint is working
+ */
+export async function POST(request: NextRequest) {
+  const auth = await getAuthFromRequest(request)
+
+  if (!auth || !auth.orgId || !auth.tenantId) {
+    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })
+  }
+
+  // Parse request body
+  let body: unknown
+  try {
+    body = await request.json()
+  } catch {
+    return NextResponse.json({ error: 'Invalid JSON body' }, { status: 400 })
+  }
+
+  const parsed = testWebhookSchema.safeParse(body)
+  if (!parsed.success) {
+    return NextResponse.json(
+      { error: 'Invalid request', details: parsed.error.flatten() },
+      { status: 400 }
+    )
+  }
+
+  const container = await createRequestContainer()
+  const scope = await resolveOrganizationScopeForRequest({ container, auth, request })
+  const commandBus = container.resolve('commandBus') as CommandBus
+
+  const selectedOrgId = scope?.selectedId ?? auth.orgId
+  const tenantId = auth.tenantId
+
+  try {
+    const { result } = await commandBus.execute<
+      { id: string; tenantId: string; organizationId: string },
+      { success: boolean; deliveryId: string }
+    >('shipment_tracking.webhook.test', {
+      input: {
+        id: parsed.data.id,
+        tenantId,
+        organizationId: selectedOrgId,
+      },
+      ctx: {
+        container,
+        auth,
+        organizationScope: scope,
+        selectedOrganizationId: selectedOrgId ?? null,
+        organizationIds: scope?.filterIds ?? (selectedOrgId ? [selectedOrgId] : null),
+        request,
+      },
+      metadata: {
+        tenantId: tenantId ?? null,
+        organizationId: selectedOrgId ?? null,
+        resourceKind: 'shipment_tracking.webhook',
+        resourceId: parsed.data.id,
+      },
+    })
+
+    return NextResponse.json({
+      success: result.success,
+      deliveryId: result.deliveryId,
+    })
+  } catch (error) {
+    console.error('[webhooks/test] error:', error)
+    const message = error instanceof Error ? error.message : 'Failed to send test webhook'
+    return NextResponse.json({ error: message }, { status: 400 })
+  }
+}

package/src/modules/shipment_tracking/assets/index.ts

@@ -0,0 +1,66 @@
+/**
+ * Carrier logo assets for shipment tracking.
+ *
+ * These images are bundled with the package and imported as static assets.
+ * When used with Next.js (via transpilePackages), they work with next/image
+ * for automatic optimization.
+ */
+
+import maerskLogo from './carriers/maersk.png'
+import mscLogo from './carriers/msc.png'
+import oneLogo from './carriers/one.png'
+import cmaCgmLogo from './carriers/cma_cgm.png'
+import hapagLloydLogo from './carriers/hapag_lloyd.png'
+import coscoLogo from './carriers/cosco.png'
+import evergreenLogo from './carriers/evergreen.png'
+import ooclLogo from './carriers/oocl.png'
+import zimLogo from './carriers/zim.png'
+import yangMingLogo from './carriers/yang_ming.png'
+
+export const carrierLogos = {
+  maersk: maerskLogo,
+  maeu: maerskLogo,
+  msc: mscLogo,
+  mscu: mscLogo,
+  one: oneLogo,
+  oney: oneLogo,
+  'cma-cgm': cmaCgmLogo,
+  cmdu: cmaCgmLogo,
+  'hapag-lloyd': hapagLloydLogo,
+  hlcu: hapagLloydLogo,
+  cosco: coscoLogo,
+  cosu: coscoLogo,
+  evergreen: evergreenLogo,
+  eglv: evergreenLogo,
+  oocl: ooclLogo,
+  oolu: ooclLogo,
+  zim: zimLogo,
+  zimu: zimLogo,
+  'yang-ming': yangMingLogo,
+  ymlu: yangMingLogo,
+} as const
+
+export type CarrierCode = keyof typeof carrierLogos
+
+/**
+ * Get the carrier logo StaticImageData for a given carrier code.
+ * Returns undefined if the carrier code is not recognized.
+ */
+export function getCarrierLogo(carrierCode: string | null | undefined) {
+  if (!carrierCode) return undefined
+  const code = carrierCode.toLowerCase() as CarrierCode
+  return carrierLogos[code]
+}
+
+export {
+  maerskLogo,
+  mscLogo,
+  oneLogo,
+  cmaCgmLogo,
+  hapagLloydLogo,
+  coscoLogo,
+  evergreenLogo,
+  ooclLogo,
+  zimLogo,
+  yangMingLogo,
+}

package/src/modules/shipment_tracking/backend/carrier-configs/page.meta.ts

@@ -0,0 +1,16 @@
+import React from 'react'
+import { KeyRound } from 'lucide-react'
+
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['shipment_tracking.carrier_configs.view'],
+  pageTitle: 'Tracking Auth Config',
+  pageTitleKey: 'shipment_tracking.nav.carrier_configs',
+  pageGroup: 'Shipment Tracking',
+  pageGroupKey: 'shipment_tracking.nav.group',
+  pageContext: 'settings' as const,
+  pagePriority: 10,
+  pageOrder: 120,
+  icon: React.createElement(KeyRound, { size: 16 }),
+  breadcrumb: [{ label: 'Tracking Auth Config', labelKey: 'shipment_tracking.nav.carrier_configs' }],
+}