@freighttech/shipment-tracking 0.6.0

package/dist/modules/shipment_tracking/setup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/shipment_tracking/setup.ts"],
+  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\n\ntype SchedulerServiceType = {\n  register: (registration: {\n    name: string\n    description?: string\n    scopeType: 'system' | 'organization' | 'tenant'\n    organizationId?: string\n    tenantId?: string\n    scheduleType: 'cron' | 'interval'\n    scheduleValue: string\n    timezone?: string\n    targetType: 'queue' | 'command'\n    targetQueue?: string\n    targetCommand?: string\n    targetPayload?: unknown\n    sourceType?: 'user' | 'module'\n    sourceModule?: string\n    isEnabled?: boolean\n  }) => Promise<void>\n}\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    admin: ['shipment_tracking.*'],\n    employee: [\n      'shipment_tracking.shipments.view',\n      'shipment_tracking.tracking_jobs.view',\n      'shipment_tracking.carrier_configs.view',\n      'shipment_tracking.shipsgo_config.view',\n      'shipment_tracking.webhooks.view',\n      'shipment_tracking.location_overrides.view',\n    ],\n  },\n\n  seedDefaults: async (ctx) => {\n    // Register scheduled jobs for this organization\n    // The scheduler service may not be available in all installations\n    try {\n      const schedulerService = ctx.container.resolve<SchedulerServiceType>('schedulerService')\n\n      // Register daily poll schedule\n      await schedulerService.register({\n        name: 'Daily Shipment Tracking Poll',\n        description:\n          'Polls all active tracking jobs for carrier updates every day at 6:00 AM UTC. You can change the schedule time in the scheduler settings.',\n        scopeType: 'organization',\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId,\n        scheduleType: 'cron',\n        scheduleValue: '0 6 * * *', // 6:00 AM UTC daily\n        timezone: 'UTC',\n        targetType: 'command',\n        targetCommand: 'shipment_tracking.tracking.poll_all',\n        targetPayload: {\n          tenantId: ctx.tenantId,\n          organizationId: ctx.organizationId,\n        },\n        sourceType: 'module',\n        sourceModule: 'shipment_tracking',\n        isEnabled: true,\n      })\n      console.log(\n        `[shipment-tracking] Registered daily poll schedule for org ${ctx.organizationId}`,\n      )\n\n      // Register PRE_ARRIVAL evaluation schedule\n      // Runs every 6 hours to check IN_TRANSIT shipments approaching destination\n      await schedulerService.register({\n        name: 'Pre-Arrival Status Evaluation',\n        description:\n          'Checks IN_TRANSIT shipments every 6 hours and upgrades them to PRE_ARRIVAL when ETA is within 7 days.',\n        scopeType: 'organization',\n        tenantId: ctx.tenantId,\n        organizationId: ctx.organizationId,\n        scheduleType: 'cron',\n        scheduleValue: '0 */6 * * *', // Every 6 hours\n        timezone: 'UTC',\n        targetType: 'command',\n        targetCommand: 'shipment_tracking.tracking.evaluate_pre_arrival',\n        targetPayload: {\n          tenantId: ctx.tenantId,\n          organizationId: ctx.organizationId,\n        },\n        sourceType: 'module',\n        sourceModule: 'shipment_tracking',\n        isEnabled: true,\n      })\n      console.log(\n        `[shipment-tracking] Registered pre-arrival evaluation schedule for org ${ctx.organizationId}`,\n      )\n    } catch (error) {\n      // Scheduler module may not be installed - this is fine\n      console.debug('[shipment-tracking] Scheduler service not available, skipping schedule registration')\n    }\n  },\n}\n\nexport default setup\n"],
+  "mappings": "AAsBO,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,OAAO,CAAC,qBAAqB;AAAA,IAC7B,UAAU;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAEA,cAAc,OAAO,QAAQ;AAG3B,QAAI;AACF,YAAM,mBAAmB,IAAI,UAAU,QAA8B,kBAAkB;AAGvF,YAAM,iBAAiB,SAAS;AAAA,QAC9B,MAAM;AAAA,QACN,aACE;AAAA,QACF,WAAW;AAAA,QACX,UAAU,IAAI;AAAA,QACd,gBAAgB,IAAI;AAAA,QACpB,cAAc;AAAA,QACd,eAAe;AAAA;AAAA,QACf,UAAU;AAAA,QACV,YAAY;AAAA,QACZ,eAAe;AAAA,QACf,eAAe;AAAA,UACb,UAAU,IAAI;AAAA,UACd,gBAAgB,IAAI;AAAA,QACtB;AAAA,QACA,YAAY;AAAA,QACZ,cAAc;AAAA,QACd,WAAW;AAAA,MACb,CAAC;AACD,cAAQ;AAAA,QACN,8DAA8D,IAAI,cAAc;AAAA,MAClF;AAIA,YAAM,iBAAiB,SAAS;AAAA,QAC9B,MAAM;AAAA,QACN,aACE;AAAA,QACF,WAAW;AAAA,QACX,UAAU,IAAI;AAAA,QACd,gBAAgB,IAAI;AAAA,QACpB,cAAc;AAAA,QACd,eAAe;AAAA;AAAA,QACf,UAAU;AAAA,QACV,YAAY;AAAA,QACZ,eAAe;AAAA,QACf,eAAe;AAAA,UACb,UAAU,IAAI;AAAA,UACd,gBAAgB,IAAI;AAAA,QACtB;AAAA,QACA,YAAY;AAAA,QACZ,cAAc;AAAA,QACd,WAAW;AAAA,MACb,CAAC;AACD,cAAQ;AAAA,QACN,0EAA0E,IAAI,cAAc;AAAA,MAC9F;AAAA,IACF,SAAS,OAAO;AAEd,cAAQ,MAAM,qFAAqF;AAAA,IACrG;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/cargo-event-created.js

@@ -0,0 +1,60 @@
+const metadata = {
+  event: "shipment_tracking.tracking_event.created",
+  persistent: true,
+  id: "shipment_tracking:tracking-event-created"
+};
+async function handle(payload, ctx) {
+  try {
+    const webhookService = ctx.resolve("shipmentTrackingWebhookService");
+    await webhookService.dispatchEvent({
+      eventType: "shipment_tracking.tracking_event.created",
+      payload: {
+        event: {
+          // IDs
+          id: payload.id,
+          trackingJobId: payload.trackingJobId,
+          // Event source
+          source: payload.source,
+          sourceEventId: payload.sourceEventId,
+          // Core event fields
+          eventType: payload.eventType,
+          eventCode: payload.eventCode,
+          eventClassifierCode: payload.eventClassifierCode,
+          eventDateTime: payload.eventDateTime,
+          description: payload.description,
+          // Equipment fields (critical for multi-container bookings)
+          equipmentReference: payload.equipmentReference,
+          isoEquipmentCode: payload.isoEquipmentCode,
+          emptyIndicatorCode: payload.emptyIndicatorCode,
+          isTransshipmentMove: payload.isTransshipmentMove,
+          // Location fields
+          locationName: payload.locationName,
+          locationUnlocode: payload.locationUnlocode,
+          locationCountry: payload.locationCountry,
+          facilityCode: payload.facilityCode,
+          facilityTypeCode: payload.facilityTypeCode,
+          // Transport call fields
+          vesselName: payload.vesselName,
+          vesselImo: payload.vesselImo,
+          voyageNumber: payload.voyageNumber,
+          carrierServiceCode: payload.carrierServiceCode,
+          modeOfTransport: payload.modeOfTransport,
+          // Document references
+          relatedDocumentReferences: payload.relatedDocumentReferences,
+          // Metadata
+          publisherName: payload.publisherName,
+          publisherRole: payload.publisherRole
+        }
+      },
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId
+    });
+  } catch (error) {
+    console.error("[shipment-tracking:subscriber] Failed to dispatch tracking_event.created webhook:", error);
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=cargo-event-created.js.map

package/dist/modules/shipment_tracking/subscribers/cargo-event-created.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/cargo-event-created.ts"],
+  "sourcesContent": ["import type { DocumentReference } from '../data/entities'\n\nexport const metadata = {\n  event: 'shipment_tracking.tracking_event.created',\n  persistent: true,\n  id: 'shipment_tracking:tracking-event-created',\n}\n\ntype TrackingEventCreatedPayload = {\n  id: string\n  trackingJobId: string\n  tenantId: string\n  organizationId: string\n\n  // Event source\n  source: string\n  sourceEventId?: string | null\n\n  // Core event fields\n  eventType: string\n  eventCode: string\n  eventClassifierCode?: string | null\n  eventDateTime?: string | null\n  description?: string | null\n\n  // Equipment fields (critical for multi-container bookings)\n  equipmentReference?: string | null\n  isoEquipmentCode?: string | null\n  emptyIndicatorCode?: string | null\n  isTransshipmentMove?: boolean | null\n\n  // Location fields\n  locationName?: string | null\n  locationUnlocode?: string | null\n  locationCountry?: string | null\n  facilityCode?: string | null\n  facilityTypeCode?: string | null\n\n  // Transport call fields\n  vesselName?: string | null\n  vesselImo?: string | null\n  voyageNumber?: string | null\n  carrierServiceCode?: string | null\n  modeOfTransport?: string | null\n\n  // Document references\n  relatedDocumentReferences?: DocumentReference[] | null\n\n  // Metadata\n  publisherName?: string | null\n  publisherRole?: string | null\n}\n\ntype ResolverContext = {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport default async function handle(payload: TrackingEventCreatedPayload, ctx: ResolverContext) {\n  try {\n    const webhookService = ctx.resolve<any>('shipmentTrackingWebhookService')\n\n    await webhookService.dispatchEvent({\n      eventType: 'shipment_tracking.tracking_event.created',\n      payload: {\n        event: {\n          // IDs\n          id: payload.id,\n          trackingJobId: payload.trackingJobId,\n\n          // Event source\n          source: payload.source,\n          sourceEventId: payload.sourceEventId,\n\n          // Core event fields\n          eventType: payload.eventType,\n          eventCode: payload.eventCode,\n          eventClassifierCode: payload.eventClassifierCode,\n          eventDateTime: payload.eventDateTime,\n          description: payload.description,\n\n          // Equipment fields (critical for multi-container bookings)\n          equipmentReference: payload.equipmentReference,\n          isoEquipmentCode: payload.isoEquipmentCode,\n          emptyIndicatorCode: payload.emptyIndicatorCode,\n          isTransshipmentMove: payload.isTransshipmentMove,\n\n          // Location fields\n          locationName: payload.locationName,\n          locationUnlocode: payload.locationUnlocode,\n          locationCountry: payload.locationCountry,\n          facilityCode: payload.facilityCode,\n          facilityTypeCode: payload.facilityTypeCode,\n\n          // Transport call fields\n          vesselName: payload.vesselName,\n          vesselImo: payload.vesselImo,\n          voyageNumber: payload.voyageNumber,\n          carrierServiceCode: payload.carrierServiceCode,\n          modeOfTransport: payload.modeOfTransport,\n\n          // Document references\n          relatedDocumentReferences: payload.relatedDocumentReferences,\n\n          // Metadata\n          publisherName: payload.publisherName,\n          publisherRole: payload.publisherRole,\n        },\n      },\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n  } catch (error) {\n    console.error('[shipment-tracking:subscriber] Failed to dispatch tracking_event.created webhook:', error)\n  }\n}\n"],
+  "mappings": "AAEO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAmDA,eAAO,OAA8B,SAAsC,KAAsB;AAC/F,MAAI;AACF,UAAM,iBAAiB,IAAI,QAAa,gCAAgC;AAExE,UAAM,eAAe,cAAc;AAAA,MACjC,WAAW;AAAA,MACX,SAAS;AAAA,QACP,OAAO;AAAA;AAAA,UAEL,IAAI,QAAQ;AAAA,UACZ,eAAe,QAAQ;AAAA;AAAA,UAGvB,QAAQ,QAAQ;AAAA,UAChB,eAAe,QAAQ;AAAA;AAAA,UAGvB,WAAW,QAAQ;AAAA,UACnB,WAAW,QAAQ;AAAA,UACnB,qBAAqB,QAAQ;AAAA,UAC7B,eAAe,QAAQ;AAAA,UACvB,aAAa,QAAQ;AAAA;AAAA,UAGrB,oBAAoB,QAAQ;AAAA,UAC5B,kBAAkB,QAAQ;AAAA,UAC1B,oBAAoB,QAAQ;AAAA,UAC5B,qBAAqB,QAAQ;AAAA;AAAA,UAG7B,cAAc,QAAQ;AAAA,UACtB,kBAAkB,QAAQ;AAAA,UAC1B,iBAAiB,QAAQ;AAAA,UACzB,cAAc,QAAQ;AAAA,UACtB,kBAAkB,QAAQ;AAAA;AAAA,UAG1B,YAAY,QAAQ;AAAA,UACpB,WAAW,QAAQ;AAAA,UACnB,cAAc,QAAQ;AAAA,UACtB,oBAAoB,QAAQ;AAAA,UAC5B,iBAAiB,QAAQ;AAAA;AAAA,UAGzB,2BAA2B,QAAQ;AAAA;AAAA,UAGnC,eAAe,QAAQ;AAAA,UACvB,eAAe,QAAQ;AAAA,QACzB;AAAA,MACF;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ;AAAA,IAC1B,CAAC;AAAA,EACH,SAAS,OAAO;AACd,YAAQ,MAAM,qFAAqF,KAAK;AAAA,EAC1G;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/dcsa-event-webhook-dispatch.js

@@ -0,0 +1,58 @@
+const metadata = {
+  event: "shipment_tracking.transport.*,shipment_tracking.equipment.*",
+  persistent: true,
+  id: "shipment_tracking:dcsa-event-webhook-dispatch"
+};
+async function handle(payload, ctx) {
+  try {
+    const webhookService = ctx.resolve("shipmentTrackingWebhookService");
+    await webhookService.dispatchEvent({
+      eventType: ctx.eventName,
+      payload: {
+        event: {
+          // IDs
+          id: payload.id,
+          shipmentId: payload.shipmentId,
+          // Core event fields
+          eventType: payload.eventType,
+          eventCode: payload.eventCode,
+          eventClassifierCode: payload.eventClassifierCode,
+          eventDateTime: payload.eventDateTime,
+          description: payload.description,
+          // Equipment fields (critical for multi-container bookings)
+          equipmentReference: payload.equipmentReference,
+          isoEquipmentCode: payload.isoEquipmentCode,
+          emptyIndicatorCode: payload.emptyIndicatorCode,
+          isTransshipmentMove: payload.isTransshipmentMove,
+          // Location fields
+          locationName: payload.locationName,
+          locationUnlocode: payload.locationUnlocode,
+          locationCountry: payload.locationCountry,
+          facilityCode: payload.facilityCode,
+          facilityTypeCode: payload.facilityTypeCode,
+          // Transport call fields
+          vesselName: payload.vesselName,
+          vesselImo: payload.vesselImo,
+          voyageNumber: payload.voyageNumber,
+          carrierServiceCode: payload.carrierServiceCode,
+          modeOfTransport: payload.modeOfTransport,
+          // Document references
+          relatedDocumentReferences: payload.relatedDocumentReferences,
+          // Metadata
+          publisherName: payload.publisherName,
+          publisherRole: payload.publisherRole
+        }
+      },
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId
+    });
+    console.debug(`[shipment-tracking:dcsa-webhook] Dispatched ${ctx.eventName} for tracking event ${payload.id}`);
+  } catch (error) {
+    console.error(`[shipment-tracking:dcsa-webhook] Failed to dispatch ${ctx.eventName} webhook:`, error);
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=dcsa-event-webhook-dispatch.js.map

package/dist/modules/shipment_tracking/subscribers/dcsa-event-webhook-dispatch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/dcsa-event-webhook-dispatch.ts"],
+  "sourcesContent": ["import type { DocumentReference } from '../data/entities'\n\n/**\n * Handles DCSA-compliant transport and equipment events and dispatches webhooks.\n * These are granular events like transport.departed, equipment.loaded, etc.\n */\nexport const metadata = {\n  event: 'shipment_tracking.transport.*,shipment_tracking.equipment.*',\n  persistent: true,\n  id: 'shipment_tracking:dcsa-event-webhook-dispatch',\n}\n\ntype DcsaEventPayload = {\n  id: string\n  shipmentId: string\n  tenantId: string\n  organizationId: string\n\n  // Core event fields\n  eventId: string\n  eventType: string\n  eventCode: string\n  eventClassifierCode?: string | null\n  eventDateTime?: string | null\n  description?: string | null\n\n  // Equipment fields\n  equipmentReference?: string | null\n  isoEquipmentCode?: string | null\n  emptyIndicatorCode?: string | null\n  isTransshipmentMove?: boolean | null\n\n  // Location fields\n  locationName?: string | null\n  locationUnlocode?: string | null\n  locationCountry?: string | null\n  facilityCode?: string | null\n  facilityTypeCode?: string | null\n\n  // Transport call fields\n  vesselName?: string | null\n  vesselImo?: string | null\n  voyageNumber?: string | null\n  carrierServiceCode?: string | null\n  modeOfTransport?: string | null\n\n  // Document references\n  relatedDocumentReferences?: DocumentReference[] | null\n\n  // Metadata\n  publisherName?: string | null\n  publisherRole?: string | null\n}\n\ntype ResolverContext = {\n  resolve: <T = unknown>(name: string) => T\n  eventName: string\n}\n\nexport default async function handle(payload: DcsaEventPayload, ctx: ResolverContext) {\n  try {\n    const webhookService = ctx.resolve<any>('shipmentTrackingWebhookService')\n\n    await webhookService.dispatchEvent({\n      eventType: ctx.eventName,\n      payload: {\n        event: {\n          // IDs\n          id: payload.id,\n          shipmentId: payload.shipmentId,\n\n          // Core event fields\n          eventType: payload.eventType,\n          eventCode: payload.eventCode,\n          eventClassifierCode: payload.eventClassifierCode,\n          eventDateTime: payload.eventDateTime,\n          description: payload.description,\n\n          // Equipment fields (critical for multi-container bookings)\n          equipmentReference: payload.equipmentReference,\n          isoEquipmentCode: payload.isoEquipmentCode,\n          emptyIndicatorCode: payload.emptyIndicatorCode,\n          isTransshipmentMove: payload.isTransshipmentMove,\n\n          // Location fields\n          locationName: payload.locationName,\n          locationUnlocode: payload.locationUnlocode,\n          locationCountry: payload.locationCountry,\n          facilityCode: payload.facilityCode,\n          facilityTypeCode: payload.facilityTypeCode,\n\n          // Transport call fields\n          vesselName: payload.vesselName,\n          vesselImo: payload.vesselImo,\n          voyageNumber: payload.voyageNumber,\n          carrierServiceCode: payload.carrierServiceCode,\n          modeOfTransport: payload.modeOfTransport,\n\n          // Document references\n          relatedDocumentReferences: payload.relatedDocumentReferences,\n\n          // Metadata\n          publisherName: payload.publisherName,\n          publisherRole: payload.publisherRole,\n        },\n      },\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    console.debug(`[shipment-tracking:dcsa-webhook] Dispatched ${ctx.eventName} for tracking event ${payload.id}`)\n  } catch (error) {\n    console.error(`[shipment-tracking:dcsa-webhook] Failed to dispatch ${ctx.eventName} webhook:`, error)\n  }\n}\n"],
+  "mappings": "AAMO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAiDA,eAAO,OAA8B,SAA2B,KAAsB;AACpF,MAAI;AACF,UAAM,iBAAiB,IAAI,QAAa,gCAAgC;AAExE,UAAM,eAAe,cAAc;AAAA,MACjC,WAAW,IAAI;AAAA,MACf,SAAS;AAAA,QACP,OAAO;AAAA;AAAA,UAEL,IAAI,QAAQ;AAAA,UACZ,YAAY,QAAQ;AAAA;AAAA,UAGpB,WAAW,QAAQ;AAAA,UACnB,WAAW,QAAQ;AAAA,UACnB,qBAAqB,QAAQ;AAAA,UAC7B,eAAe,QAAQ;AAAA,UACvB,aAAa,QAAQ;AAAA;AAAA,UAGrB,oBAAoB,QAAQ;AAAA,UAC5B,kBAAkB,QAAQ;AAAA,UAC1B,oBAAoB,QAAQ;AAAA,UAC5B,qBAAqB,QAAQ;AAAA;AAAA,UAG7B,cAAc,QAAQ;AAAA,UACtB,kBAAkB,QAAQ;AAAA,UAC1B,iBAAiB,QAAQ;AAAA,UACzB,cAAc,QAAQ;AAAA,UACtB,kBAAkB,QAAQ;AAAA;AAAA,UAG1B,YAAY,QAAQ;AAAA,UACpB,WAAW,QAAQ;AAAA,UACnB,cAAc,QAAQ;AAAA,UACtB,oBAAoB,QAAQ;AAAA,UAC5B,iBAAiB,QAAQ;AAAA;AAAA,UAGzB,2BAA2B,QAAQ;AAAA;AAAA,UAGnC,eAAe,QAAQ;AAAA,UACvB,eAAe,QAAQ;AAAA,QACzB;AAAA,MACF;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ;AAAA,IAC1B,CAAC;AAED,YAAQ,MAAM,+CAA+C,IAAI,SAAS,uBAAuB,QAAQ,EAAE,EAAE;AAAA,EAC/G,SAAS,OAAO;AACd,YAAQ,MAAM,uDAAuD,IAAI,SAAS,aAAa,KAAK;AAAA,EACtG;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/poi-event-notification.js

@@ -0,0 +1,82 @@
+import { resolveNotificationService } from "@open-mercato/core/modules/notifications/lib/notificationService";
+import { buildNotificationFromType } from "@open-mercato/core/modules/notifications/lib/notificationBuilder";
+import { getTrackingJobCreator } from "../lib/audit-helpers.js";
+import { notificationTypes } from "../notifications.js";
+const metadata = {
+  event: "shipment_tracking.tracking_job.poi.*",
+  persistent: true,
+  id: "shipment_tracking:tracking-job-poi-notification"
+};
+function mapEventTypeToNotificationType(eventType) {
+  const map = {
+    PORT_ARRIVAL: "shipment_tracking.tracking_job.poi.port_arrival",
+    PORT_PROXIMITY_ARRIVAL: "shipment_tracking.tracking_job.poi.port_proximity_arrival",
+    PORT_PROXIMITY_DEPARTURE: "shipment_tracking.tracking_job.poi.port_departure",
+    TERMINAL_ARRIVAL: "shipment_tracking.tracking_job.poi.terminal_arrival",
+    TERMINAL_PROXIMITY_ARRIVAL: "shipment_tracking.tracking_job.poi.terminal_proximity_arrival",
+    TERMINAL_PROXIMITY_DEPARTURE: "shipment_tracking.tracking_job.poi.terminal_departure",
+    WAYPOINT_REACHED: "shipment_tracking.tracking_job.poi.waypoint_reached"
+  };
+  return map[eventType];
+}
+function buildReferenceInfo(bookingNumber, bolNumber, containerNumber) {
+  if (bookingNumber) {
+    return `Booking ${bookingNumber}`;
+  }
+  if (bolNumber) {
+    return `BOL ${bolNumber}`;
+  }
+  if (containerNumber) {
+    return `Container ${containerNumber}`;
+  }
+  return "Shipment";
+}
+async function handle(payload, ctx) {
+  try {
+    const em = ctx.resolve("em");
+    const creatorUserId = await getTrackingJobCreator(em, payload.trackingJobId, payload.tenantId);
+    if (!creatorUserId) {
+      console.info(
+        `[poi-notification] Skipping notification - no creator found for tracking job ${payload.trackingJobId}`
+      );
+      return;
+    }
+    const notificationType = mapEventTypeToNotificationType(payload.eventType);
+    const typeDef = notificationTypes.find((t) => t.type === notificationType);
+    if (!typeDef) {
+      console.warn(`[poi-notification] No notification type found for event: ${payload.eventType}`);
+      return;
+    }
+    const referenceInfo = buildReferenceInfo(
+      payload.bookingNumber,
+      payload.bolNumber,
+      payload.containerNumber
+    );
+    const notificationInput = buildNotificationFromType(typeDef, {
+      recipientUserId: creatorUserId,
+      bodyVariables: {
+        vesselName: payload.vesselName,
+        location: payload.poiCode ?? "unknown location",
+        referenceInfo
+      },
+      sourceEntityType: "shipment_tracking:shipment",
+      sourceEntityId: payload.shipmentId,
+      linkHref: `/backend/shipment-tracking?shipment=${payload.shipmentId}`
+    });
+    const notificationService = resolveNotificationService(ctx);
+    await notificationService.create(notificationInput, {
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId ?? null
+    });
+    console.info(
+      `[poi-notification] Created notification for tracking job ${payload.trackingJobId} (event: ${payload.eventType}, recipient: ${creatorUserId}, ref: ${referenceInfo})`
+    );
+  } catch (error) {
+    console.error("[poi-notification] Failed to process POI event notification:", error);
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=poi-event-notification.js.map

package/dist/modules/shipment_tracking/subscribers/poi-event-notification.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/poi-event-notification.ts"],
+  "sourcesContent": ["/**\n * POI Event Notification Subscriber\n *\n * Subscribes to per-tracking-job POI proximity events and creates in-app\n * notifications for the user who created the tracking job.\n *\n * These events are emitted once per tracking job (BOL/Booking), not per\n * shipment (container), so no deduplication is needed.\n */\n\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { resolveNotificationService } from '@open-mercato/core/modules/notifications/lib/notificationService'\nimport { buildNotificationFromType } from '@open-mercato/core/modules/notifications/lib/notificationBuilder'\nimport type { ProximityEventType } from '../lib/poi-types'\nimport { getTrackingJobCreator } from '../lib/audit-helpers'\nimport { notificationTypes } from '../notifications'\n\nexport const metadata = {\n  event: 'shipment_tracking.tracking_job.poi.*',\n  persistent: true,\n  id: 'shipment_tracking:tracking-job-poi-notification',\n}\n\ntype TrackingJobPoiEventPayload = {\n  trackingJobId: string\n  shipmentId: string\n  trackingEventId: string\n  organizationId: string\n  tenantId: string\n  vesselName: string\n  vesselMmsi: number\n  vesselImo: string | null\n  eventType: ProximityEventType\n  poiCode: string | null\n  latitude: number\n  longitude: number\n  eventDateTime: string\n  distanceToPoiMeters: number | null\n  containerNumber?: string | null\n  bookingNumber?: string | null\n  bolNumber?: string | null\n}\n\ntype ResolverContext = {\n  resolve: <T = unknown>(name: string) => T\n}\n\n/**\n * Map POI event types to per-job notification type identifiers.\n */\nfunction mapEventTypeToNotificationType(eventType: ProximityEventType): string {\n  const map: Record<ProximityEventType, string> = {\n    PORT_ARRIVAL: 'shipment_tracking.tracking_job.poi.port_arrival',\n    PORT_PROXIMITY_ARRIVAL: 'shipment_tracking.tracking_job.poi.port_proximity_arrival',\n    PORT_PROXIMITY_DEPARTURE: 'shipment_tracking.tracking_job.poi.port_departure',\n    TERMINAL_ARRIVAL: 'shipment_tracking.tracking_job.poi.terminal_arrival',\n    TERMINAL_PROXIMITY_ARRIVAL: 'shipment_tracking.tracking_job.poi.terminal_proximity_arrival',\n    TERMINAL_PROXIMITY_DEPARTURE: 'shipment_tracking.tracking_job.poi.terminal_departure',\n    WAYPOINT_REACHED: 'shipment_tracking.tracking_job.poi.waypoint_reached',\n  }\n  return map[eventType]\n}\n\n/**\n * Build a reference info string for the notification body.\n * Shows the booking number, BOL number, or container number.\n *\n * Format: \"Booking BOOK123\" or \"BOL 12345\" or \"Container MSCU1234567\"\n */\nfunction buildReferenceInfo(\n  bookingNumber: string | null | undefined,\n  bolNumber: string | null | undefined,\n  containerNumber: string | null | undefined\n): string {\n  if (bookingNumber) {\n    return `Booking ${bookingNumber}`\n  }\n  if (bolNumber) {\n    return `BOL ${bolNumber}`\n  }\n  if (containerNumber) {\n    return `Container ${containerNumber}`\n  }\n  return 'Shipment'\n}\n\nexport default async function handle(payload: TrackingJobPoiEventPayload, ctx: ResolverContext) {\n  try {\n    const em = ctx.resolve<EntityManager>('em')\n\n    // Get the creator of the tracking job from audit logs\n    const creatorUserId = await getTrackingJobCreator(em, payload.trackingJobId, payload.tenantId)\n\n    if (!creatorUserId) {\n      console.info(\n        `[poi-notification] Skipping notification - no creator found for tracking job ${payload.trackingJobId}`\n      )\n      return\n    }\n\n    // Find the notification type definition\n    const notificationType = mapEventTypeToNotificationType(payload.eventType)\n    const typeDef = notificationTypes.find((t) => t.type === notificationType)\n\n    if (!typeDef) {\n      console.warn(`[poi-notification] No notification type found for event: ${payload.eventType}`)\n      return\n    }\n\n    // Build reference info string (e.g., \"Booking BOOK123\")\n    const referenceInfo = buildReferenceInfo(\n      payload.bookingNumber,\n      payload.bolNumber,\n      payload.containerNumber\n    )\n\n    // Build notification input\n    const notificationInput = buildNotificationFromType(typeDef, {\n      recipientUserId: creatorUserId,\n      bodyVariables: {\n        vesselName: payload.vesselName,\n        location: payload.poiCode ?? 'unknown location',\n        referenceInfo,\n      },\n      sourceEntityType: 'shipment_tracking:shipment',\n      sourceEntityId: payload.shipmentId,\n      linkHref: `/backend/shipment-tracking?shipment=${payload.shipmentId}`,\n    })\n\n    // Create the notification\n    const notificationService = resolveNotificationService(ctx)\n    await notificationService.create(notificationInput, {\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId ?? null,\n    })\n\n    console.info(\n      `[poi-notification] Created notification for tracking job ${payload.trackingJobId} ` +\n        `(event: ${payload.eventType}, recipient: ${creatorUserId}, ref: ${referenceInfo})`\n    )\n  } catch (error) {\n    console.error('[poi-notification] Failed to process POI event notification:', error)\n  }\n}\n"],
+  "mappings": "AAWA,SAAS,kCAAkC;AAC3C,SAAS,iCAAiC;AAE1C,SAAS,6BAA6B;AACtC,SAAS,yBAAyB;AAE3B,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AA6BA,SAAS,+BAA+B,WAAuC;AAC7E,QAAM,MAA0C;AAAA,IAC9C,cAAc;AAAA,IACd,wBAAwB;AAAA,IACxB,0BAA0B;AAAA,IAC1B,kBAAkB;AAAA,IAClB,4BAA4B;AAAA,IAC5B,8BAA8B;AAAA,IAC9B,kBAAkB;AAAA,EACpB;AACA,SAAO,IAAI,SAAS;AACtB;AAQA,SAAS,mBACP,eACA,WACA,iBACQ;AACR,MAAI,eAAe;AACjB,WAAO,WAAW,aAAa;AAAA,EACjC;AACA,MAAI,WAAW;AACb,WAAO,OAAO,SAAS;AAAA,EACzB;AACA,MAAI,iBAAiB;AACnB,WAAO,aAAa,eAAe;AAAA,EACrC;AACA,SAAO;AACT;AAEA,eAAO,OAA8B,SAAqC,KAAsB;AAC9F,MAAI;AACF,UAAM,KAAK,IAAI,QAAuB,IAAI;AAG1C,UAAM,gBAAgB,MAAM,sBAAsB,IAAI,QAAQ,eAAe,QAAQ,QAAQ;AAE7F,QAAI,CAAC,eAAe;AAClB,cAAQ;AAAA,QACN,gFAAgF,QAAQ,aAAa;AAAA,MACvG;AACA;AAAA,IACF;AAGA,UAAM,mBAAmB,+BAA+B,QAAQ,SAAS;AACzE,UAAM,UAAU,kBAAkB,KAAK,CAAC,MAAM,EAAE,SAAS,gBAAgB;AAEzE,QAAI,CAAC,SAAS;AACZ,cAAQ,KAAK,4DAA4D,QAAQ,SAAS,EAAE;AAC5F;AAAA,IACF;AAGA,UAAM,gBAAgB;AAAA,MACpB,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAGA,UAAM,oBAAoB,0BAA0B,SAAS;AAAA,MAC3D,iBAAiB;AAAA,MACjB,eAAe;AAAA,QACb,YAAY,QAAQ;AAAA,QACpB,UAAU,QAAQ,WAAW;AAAA,QAC7B;AAAA,MACF;AAAA,MACA,kBAAkB;AAAA,MAClB,gBAAgB,QAAQ;AAAA,MACxB,UAAU,uCAAuC,QAAQ,UAAU;AAAA,IACrE,CAAC;AAGD,UAAM,sBAAsB,2BAA2B,GAAG;AAC1D,UAAM,oBAAoB,OAAO,mBAAmB;AAAA,MAClD,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ,kBAAkB;AAAA,IAC5C,CAAC;AAED,YAAQ;AAAA,MACN,4DAA4D,QAAQ,aAAa,YACpE,QAAQ,SAAS,gBAAgB,aAAa,UAAU,aAAa;AAAA,IACpF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,gEAAgE,KAAK;AAAA,EACrF;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/poi-event-webhook-dispatch.js

@@ -0,0 +1,53 @@
+const metadata = {
+  event: "shipment_tracking.poi.*",
+  persistent: true,
+  id: "shipment_tracking:poi-event-webhook-dispatch"
+};
+async function handle(payload, ctx) {
+  try {
+    const webhookService = ctx.resolve("shipmentTrackingWebhookService");
+    if (!webhookService) {
+      console.debug("[shipment-tracking:poi-webhook] WebhookService not available, skipping dispatch");
+      return;
+    }
+    await webhookService.dispatchEvent({
+      eventType: ctx.eventName,
+      payload: {
+        event: {
+          // IDs
+          trackingEventId: payload.trackingEventId,
+          shipmentId: payload.shipmentId,
+          // Event type
+          eventType: payload.eventType,
+          eventDateTime: payload.eventDateTime,
+          // Vessel info
+          vesselName: payload.vesselName,
+          vesselMmsi: payload.vesselMmsi,
+          vesselImo: payload.vesselImo,
+          // Location info
+          poiCode: payload.poiCode,
+          latitude: payload.latitude,
+          longitude: payload.longitude,
+          distanceToPoiMeters: payload.distanceToPoiMeters,
+          // Source identifier
+          source: "ais"
+        }
+      },
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId
+    });
+    console.debug(
+      `[shipment-tracking:poi-webhook] Dispatched ${ctx.eventName} for shipment ${payload.shipmentId}`
+    );
+  } catch (error) {
+    console.error(
+      `[shipment-tracking:poi-webhook] Failed to dispatch ${ctx.eventName} webhook:`,
+      error
+    );
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=poi-event-webhook-dispatch.js.map

package/dist/modules/shipment_tracking/subscribers/poi-event-webhook-dispatch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/poi-event-webhook-dispatch.ts"],
+  "sourcesContent": ["/**\n * POI Event Webhook Dispatcher\n *\n * Handles POI proximity events and dispatches webhooks to registered endpoints.\n */\n\nimport type { ProximityEventType } from '../lib/poi-types'\n\nexport const metadata = {\n  event: 'shipment_tracking.poi.*',\n  persistent: true,\n  id: 'shipment_tracking:poi-event-webhook-dispatch',\n}\n\ntype PoiEventPayload = {\n  shipmentId: string\n  trackingEventId: string\n  organizationId: string\n  tenantId: string\n  vesselName: string\n  vesselMmsi: number\n  vesselImo: string | null\n  eventType: ProximityEventType\n  poiCode: string | null\n  latitude: number\n  longitude: number\n  eventDateTime: string\n  distanceToPoiMeters: number | null\n}\n\ntype ResolverContext = {\n  resolve: <T = unknown>(name: string) => T\n  eventName: string\n}\n\ntype WebhookService = {\n  dispatchEvent: (params: {\n    eventType: string\n    payload: unknown\n    tenantId: string\n    organizationId: string\n  }) => Promise<void>\n}\n\nexport default async function handle(payload: PoiEventPayload, ctx: ResolverContext) {\n  try {\n    const webhookService = ctx.resolve<WebhookService | undefined>('shipmentTrackingWebhookService')\n\n    if (!webhookService) {\n      console.debug('[shipment-tracking:poi-webhook] WebhookService not available, skipping dispatch')\n      return\n    }\n\n    await webhookService.dispatchEvent({\n      eventType: ctx.eventName,\n      payload: {\n        event: {\n          // IDs\n          trackingEventId: payload.trackingEventId,\n          shipmentId: payload.shipmentId,\n\n          // Event type\n          eventType: payload.eventType,\n          eventDateTime: payload.eventDateTime,\n\n          // Vessel info\n          vesselName: payload.vesselName,\n          vesselMmsi: payload.vesselMmsi,\n          vesselImo: payload.vesselImo,\n\n          // Location info\n          poiCode: payload.poiCode,\n          latitude: payload.latitude,\n          longitude: payload.longitude,\n          distanceToPoiMeters: payload.distanceToPoiMeters,\n\n          // Source identifier\n          source: 'ais',\n        },\n      },\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n\n    console.debug(\n      `[shipment-tracking:poi-webhook] Dispatched ${ctx.eventName} for shipment ${payload.shipmentId}`\n    )\n  } catch (error) {\n    console.error(\n      `[shipment-tracking:poi-webhook] Failed to dispatch ${ctx.eventName} webhook:`,\n      error\n    )\n  }\n}\n"],
+  "mappings": "AAQO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAgCA,eAAO,OAA8B,SAA0B,KAAsB;AACnF,MAAI;AACF,UAAM,iBAAiB,IAAI,QAAoC,gCAAgC;AAE/F,QAAI,CAAC,gBAAgB;AACnB,cAAQ,MAAM,iFAAiF;AAC/F;AAAA,IACF;AAEA,UAAM,eAAe,cAAc;AAAA,MACjC,WAAW,IAAI;AAAA,MACf,SAAS;AAAA,QACP,OAAO;AAAA;AAAA,UAEL,iBAAiB,QAAQ;AAAA,UACzB,YAAY,QAAQ;AAAA;AAAA,UAGpB,WAAW,QAAQ;AAAA,UACnB,eAAe,QAAQ;AAAA;AAAA,UAGvB,YAAY,QAAQ;AAAA,UACpB,YAAY,QAAQ;AAAA,UACpB,WAAW,QAAQ;AAAA;AAAA,UAGnB,SAAS,QAAQ;AAAA,UACjB,UAAU,QAAQ;AAAA,UAClB,WAAW,QAAQ;AAAA,UACnB,qBAAqB,QAAQ;AAAA;AAAA,UAG7B,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ;AAAA,IAC1B,CAAC;AAED,YAAQ;AAAA,MACN,8CAA8C,IAAI,SAAS,iBAAiB,QAAQ,UAAU;AAAA,IAChG;AAAA,EACF,SAAS,OAAO;AACd,YAAQ;AAAA,MACN,sDAAsD,IAAI,SAAS;AAAA,MACnE;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/shipment-status-changed.js

@@ -0,0 +1,28 @@
+const metadata = {
+  event: "shipment_tracking.shipment.status_changed",
+  persistent: true,
+  id: "shipment_tracking:shipment-status-changed"
+};
+async function handle(payload, ctx) {
+  try {
+    const webhookService = ctx.resolve("shipmentTrackingWebhookService");
+    const shipmentData = await webhookService.buildFullShipmentPayload(payload.id);
+    await webhookService.dispatchEvent({
+      eventType: "shipment_tracking.shipment.status_changed",
+      payload: {
+        previousStatus: payload.previousStatus,
+        newStatus: payload.newStatus,
+        shipment: shipmentData
+      },
+      tenantId: payload.tenantId,
+      organizationId: payload.organizationId
+    });
+  } catch (error) {
+    console.error("[shipment-tracking:subscriber] Failed to dispatch status_changed webhook:", error);
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=shipment-status-changed.js.map

package/dist/modules/shipment_tracking/subscribers/shipment-status-changed.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/shipment-status-changed.ts"],
+  "sourcesContent": ["import type { WebhookService } from '../services/webhookService'\n\nexport const metadata = {\n  event: 'shipment_tracking.shipment.status_changed',\n  persistent: true,\n  id: 'shipment_tracking:shipment-status-changed',\n}\n\ntype StatusChangedPayload = {\n  id: string\n  previousStatus: string\n  newStatus: string\n  tenantId: string\n  organizationId: string\n}\n\ntype ResolverContext = {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport default async function handle(payload: StatusChangedPayload, ctx: ResolverContext) {\n  try {\n    const webhookService = ctx.resolve<WebhookService>('shipmentTrackingWebhookService')\n\n    // Build full shipment payload to include in the webhook\n    const shipmentData = await webhookService.buildFullShipmentPayload(payload.id)\n\n    await webhookService.dispatchEvent({\n      eventType: 'shipment_tracking.shipment.status_changed',\n      payload: {\n        previousStatus: payload.previousStatus,\n        newStatus: payload.newStatus,\n        shipment: shipmentData,\n      },\n      tenantId: payload.tenantId,\n      organizationId: payload.organizationId,\n    })\n  } catch (error) {\n    console.error('[shipment-tracking:subscriber] Failed to dispatch status_changed webhook:', error)\n  }\n}\n"],
+  "mappings": "AAEO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAcA,eAAO,OAA8B,SAA+B,KAAsB;AACxF,MAAI;AACF,UAAM,iBAAiB,IAAI,QAAwB,gCAAgC;AAGnF,UAAM,eAAe,MAAM,eAAe,yBAAyB,QAAQ,EAAE;AAE7E,UAAM,eAAe,cAAc;AAAA,MACjC,WAAW;AAAA,MACX,SAAS;AAAA,QACP,gBAAgB,QAAQ;AAAA,QACxB,WAAW,QAAQ;AAAA,QACnB,UAAU;AAAA,MACZ;AAAA,MACA,UAAU,QAAQ;AAAA,MAClB,gBAAgB,QAAQ;AAAA,IAC1B,CAAC;AAAA,EACH,SAAS,OAAO;AACd,YAAQ,MAAM,6EAA6E,KAAK;AAAA,EAClG;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/terminal-event-ingest.js

@@ -0,0 +1,67 @@
+import { Shipment, TrackingEvent } from "../data/entities.js";
+const metadata = {
+  event: "terminal_tracking.terminal_event.created",
+  persistent: false,
+  id: "shipment_tracking:terminal-event-ingest"
+};
+async function handle(payload, ctx) {
+  if (!payload?.containerNumber || !payload?.sourceEventId) return;
+  const em = ctx.resolve("em").fork();
+  const trackingService = ctx.resolve("shipmentTrackingService");
+  const shipments = await em.find(
+    Shipment,
+    {
+      organizationId: payload.organizationId,
+      tenantId: payload.tenantId,
+      containerNumber: payload.containerNumber,
+      deletedAt: null,
+      isActive: true,
+      status: { $nin: ["DELIVERED"] }
+    },
+    { populate: ["trackingJob"] }
+  );
+  const eventDateTime = new Date(payload.eventDateTime);
+  const touchedJobs = /* @__PURE__ */ new Map();
+  for (const shipment of shipments) {
+    if (!shipment.trackingJob) continue;
+    const exists = await em.findOne(TrackingEvent, {
+      trackingJob: shipment.trackingJob.id,
+      source: "port",
+      sourceEventId: payload.sourceEventId
+    });
+    if (exists) continue;
+    const event = new TrackingEvent();
+    event.organizationId = shipment.organizationId;
+    event.tenantId = shipment.tenantId;
+    event.trackingJob = shipment.trackingJob;
+    event.source = "port";
+    event.sourceEventId = payload.sourceEventId;
+    event.eventType = payload.eventType;
+    event.eventCode = payload.eventCode;
+    event.eventClassifierCode = payload.eventClassifierCode ?? "ACT";
+    event.eventDateTime = eventDateTime;
+    event.equipmentReference = payload.containerNumber;
+    event.locationUnlocode = payload.unlocode ?? null;
+    event.facilityCode = payload.facilityCode ?? null;
+    event.facilityCodeListProvider = payload.facilityCodeListProvider ?? null;
+    event.vesselName = payload.vesselName ?? null;
+    event.voyageNumber = payload.voyageNumber ?? null;
+    event.modeOfTransport = payload.modeOfTransport ?? null;
+    event.seals = payload.seals ?? null;
+    event.rawData = payload.rawData ?? null;
+    em.persist(event);
+    const set = touchedJobs.get(shipment.trackingJob.id) ?? /* @__PURE__ */ new Set();
+    set.add(shipment.id);
+    touchedJobs.set(shipment.trackingJob.id, set);
+  }
+  if (touchedJobs.size === 0) return;
+  await em.flush();
+  for (const [jobId, shipmentIds] of touchedJobs) {
+    await trackingService.refreshShipmentsFromEvents(em, jobId, Array.from(shipmentIds));
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=terminal-event-ingest.js.map

package/dist/modules/shipment_tracking/subscribers/terminal-event-ingest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/terminal-event-ingest.ts"],
+  "sourcesContent": ["/**\n * Terminal Event Ingest (bridge)\n *\n * Surfaces terminal-tracking events on the shipment-tracking timeline. Reacts\n * to the `terminal_tracking.terminal_event.created` event (string coupling\n * only \u2014 this module does NOT import @freighttech/terminal-tracking), finds the\n * matching tracked Shipment by container number, and records a `source:'port'`\n * TrackingEvent. Fully additive; no-ops when no matching shipment is tracked.\n */\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { Shipment, TrackingEvent } from '../data/entities'\nimport type { TrackingService } from '../services/trackingService'\n\nexport const metadata = {\n  event: 'terminal_tracking.terminal_event.created',\n  persistent: false,\n  id: 'shipment_tracking:terminal-event-ingest',\n}\n\ntype TerminalEventPayload = {\n  sourceEventId: string\n  eventType: 'EQUIPMENT' | 'TRANSPORT'\n  eventCode: string\n  eventClassifierCode?: 'ACT' | 'PLN' | 'EST' | null\n  eventDateTime: string\n  containerNumber: string\n  tenantId: string\n  organizationId: string\n  unlocode?: string | null\n  facilityCode?: string | null\n  facilityCodeListProvider?: 'SMDG' | 'BIC' | null\n  vesselName?: string | null\n  voyageNumber?: string | null\n  modeOfTransport?: 'VESSEL' | 'RAIL' | 'TRUCK' | 'BARGE' | null\n  seals?: Array<{ number: string; type?: string | null; source?: string | null }> | null\n  rawData?: Record<string, unknown> | null\n}\n\ntype ResolverContext = { resolve: <T = unknown>(name: string) => T }\n\nexport default async function handle(payload: TerminalEventPayload, ctx: ResolverContext) {\n  if (!payload?.containerNumber || !payload?.sourceEventId) return\n\n  const em = ctx.resolve<EntityManager>('em').fork()\n  const trackingService = ctx.resolve<TrackingService>('shipmentTrackingService')\n\n  // Scope to currently-tracked, non-delivered shipments (mirror\n  // poi-event-processor). A container number is reused across journeys over\n  // time, so without this a returned container's new-visit events would refresh\n  // and override a historic, already-delivered shipment with the same number.\n  const shipments = await em.find(\n    Shipment,\n    {\n      organizationId: payload.organizationId,\n      tenantId: payload.tenantId,\n      containerNumber: payload.containerNumber,\n      deletedAt: null,\n      isActive: true,\n      status: { $nin: ['DELIVERED'] },\n    },\n    { populate: ['trackingJob'] },\n  )\n\n  const eventDateTime = new Date(payload.eventDateTime)\n  const touchedJobs = new Map<string, Set<string>>()\n\n  for (const shipment of shipments) {\n    if (!shipment.trackingJob) continue\n\n    const exists = await em.findOne(TrackingEvent, {\n      trackingJob: shipment.trackingJob.id,\n      source: 'port',\n      sourceEventId: payload.sourceEventId,\n    })\n    if (exists) continue\n\n    const event = new TrackingEvent()\n    event.organizationId = shipment.organizationId\n    event.tenantId = shipment.tenantId\n    event.trackingJob = shipment.trackingJob\n    event.source = 'port'\n    event.sourceEventId = payload.sourceEventId\n    event.eventType = payload.eventType\n    event.eventCode = payload.eventCode\n    event.eventClassifierCode = payload.eventClassifierCode ?? 'ACT'\n    event.eventDateTime = eventDateTime\n    event.equipmentReference = payload.containerNumber\n    event.locationUnlocode = payload.unlocode ?? null\n    event.facilityCode = payload.facilityCode ?? null\n    event.facilityCodeListProvider = payload.facilityCodeListProvider ?? null\n    event.vesselName = payload.vesselName ?? null\n    event.voyageNumber = payload.voyageNumber ?? null\n    event.modeOfTransport = payload.modeOfTransport ?? null\n    event.seals = payload.seals ?? null\n    event.rawData = payload.rawData ?? null\n    em.persist(event)\n\n    const set = touchedJobs.get(shipment.trackingJob.id) ?? new Set<string>()\n    set.add(shipment.id)\n    touchedJobs.set(shipment.trackingJob.id, set)\n  }\n\n  if (touchedJobs.size === 0) return\n  await em.flush()\n\n  for (const [jobId, shipmentIds] of touchedJobs) {\n    await trackingService.refreshShipmentsFromEvents(em, jobId, Array.from(shipmentIds))\n  }\n}\n"],
+  "mappings": "AAUA,SAAS,UAAU,qBAAqB;AAGjC,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAuBA,eAAO,OAA8B,SAA+B,KAAsB;AACxF,MAAI,CAAC,SAAS,mBAAmB,CAAC,SAAS,cAAe;AAE1D,QAAM,KAAK,IAAI,QAAuB,IAAI,EAAE,KAAK;AACjD,QAAM,kBAAkB,IAAI,QAAyB,yBAAyB;AAM9E,QAAM,YAAY,MAAM,GAAG;AAAA,IACzB;AAAA,IACA;AAAA,MACE,gBAAgB,QAAQ;AAAA,MACxB,UAAU,QAAQ;AAAA,MAClB,iBAAiB,QAAQ;AAAA,MACzB,WAAW;AAAA,MACX,UAAU;AAAA,MACV,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE;AAAA,IAChC;AAAA,IACA,EAAE,UAAU,CAAC,aAAa,EAAE;AAAA,EAC9B;AAEA,QAAM,gBAAgB,IAAI,KAAK,QAAQ,aAAa;AACpD,QAAM,cAAc,oBAAI,IAAyB;AAEjD,aAAW,YAAY,WAAW;AAChC,QAAI,CAAC,SAAS,YAAa;AAE3B,UAAM,SAAS,MAAM,GAAG,QAAQ,eAAe;AAAA,MAC7C,aAAa,SAAS,YAAY;AAAA,MAClC,QAAQ;AAAA,MACR,eAAe,QAAQ;AAAA,IACzB,CAAC;AACD,QAAI,OAAQ;AAEZ,UAAM,QAAQ,IAAI,cAAc;AAChC,UAAM,iBAAiB,SAAS;AAChC,UAAM,WAAW,SAAS;AAC1B,UAAM,cAAc,SAAS;AAC7B,UAAM,SAAS;AACf,UAAM,gBAAgB,QAAQ;AAC9B,UAAM,YAAY,QAAQ;AAC1B,UAAM,YAAY,QAAQ;AAC1B,UAAM,sBAAsB,QAAQ,uBAAuB;AAC3D,UAAM,gBAAgB;AACtB,UAAM,qBAAqB,QAAQ;AACnC,UAAM,mBAAmB,QAAQ,YAAY;AAC7C,UAAM,eAAe,QAAQ,gBAAgB;AAC7C,UAAM,2BAA2B,QAAQ,4BAA4B;AACrE,UAAM,aAAa,QAAQ,cAAc;AACzC,UAAM,eAAe,QAAQ,gBAAgB;AAC7C,UAAM,kBAAkB,QAAQ,mBAAmB;AACnD,UAAM,QAAQ,QAAQ,SAAS;AAC/B,UAAM,UAAU,QAAQ,WAAW;AACnC,OAAG,QAAQ,KAAK;AAEhB,UAAM,MAAM,YAAY,IAAI,SAAS,YAAY,EAAE,KAAK,oBAAI,IAAY;AACxE,QAAI,IAAI,SAAS,EAAE;AACnB,gBAAY,IAAI,SAAS,YAAY,IAAI,GAAG;AAAA,EAC9C;AAEA,MAAI,YAAY,SAAS,EAAG;AAC5B,QAAM,GAAG,MAAM;AAEf,aAAW,CAAC,OAAO,WAAW,KAAK,aAAa;AAC9C,UAAM,gBAAgB,2BAA2B,IAAI,OAAO,MAAM,KAAK,WAAW,CAAC;AAAA,EACrF;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/tracking-job-initial-poll.js

@@ -0,0 +1,30 @@
+const metadata = {
+  event: "shipment_tracking.tracking_job.created",
+  persistent: false,
+  // In-process, immediate execution
+  id: "shipment_tracking:tracking-job-initial-poll"
+};
+async function handle(payload, ctx) {
+  const trackingService = ctx.resolve("shipmentTrackingService");
+  console.log("[shipment-tracking] Triggering initial poll for new tracking job:", {
+    jobId: payload.id,
+    carrierCode: payload.carrierCode,
+    reference: `${payload.referenceType}:${payload.referenceValue}`
+  });
+  try {
+    const result = await trackingService.pollTrackingJob(payload.id);
+    console.log("[shipment-tracking] Initial poll completed:", {
+      jobId: payload.id,
+      newEvents: result.newEvents,
+      shipmentsCreated: result.shipmentsCreated,
+      shipmentsUpdated: result.shipmentsUpdated
+    });
+  } catch (error) {
+    console.error("[shipment-tracking] Initial poll failed for job:", payload.id, error);
+  }
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=tracking-job-initial-poll.js.map

package/dist/modules/shipment_tracking/subscribers/tracking-job-initial-poll.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/tracking-job-initial-poll.ts"],
+  "sourcesContent": ["/**\n * Tracking Job Initial Poll Subscriber\n *\n * Triggers an immediate poll when a new tracking job is created.\n * This ensures the carrier API is queried right away instead of waiting\n * for the next scheduled poll interval.\n */\n\nimport type { TrackingService } from '../services/trackingService'\n\nexport const metadata = {\n  event: 'shipment_tracking.tracking_job.created',\n  persistent: false, // In-process, immediate execution\n  id: 'shipment_tracking:tracking-job-initial-poll',\n}\n\ntype TrackingJobCreatedPayload = {\n  id: string\n  carrierCode: string\n  referenceType: string\n  referenceValue: string\n  tenantId: string\n  organizationId: string\n}\n\ntype ResolverContext = {\n  resolve: <T = unknown>(name: string) => T\n}\n\nexport default async function handle(payload: TrackingJobCreatedPayload, ctx: ResolverContext) {\n  const trackingService = ctx.resolve<TrackingService>('shipmentTrackingService')\n\n  console.log('[shipment-tracking] Triggering initial poll for new tracking job:', {\n    jobId: payload.id,\n    carrierCode: payload.carrierCode,\n    reference: `${payload.referenceType}:${payload.referenceValue}`,\n  })\n\n  try {\n    const result = await trackingService.pollTrackingJob(payload.id)\n\n    console.log('[shipment-tracking] Initial poll completed:', {\n      jobId: payload.id,\n      newEvents: result.newEvents,\n      shipmentsCreated: result.shipmentsCreated,\n      shipmentsUpdated: result.shipmentsUpdated,\n    })\n  } catch (error) {\n    // Log error but don't rethrow - the job is created and will be polled on schedule\n    // Errors are already recorded in the job's errorHistory by pollTrackingJob\n    console.error('[shipment-tracking] Initial poll failed for job:', payload.id, error)\n  }\n}\n"],
+  "mappings": "AAUO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA;AAAA,EACZ,IAAI;AACN;AAeA,eAAO,OAA8B,SAAoC,KAAsB;AAC7F,QAAM,kBAAkB,IAAI,QAAyB,yBAAyB;AAE9E,UAAQ,IAAI,qEAAqE;AAAA,IAC/E,OAAO,QAAQ;AAAA,IACf,aAAa,QAAQ;AAAA,IACrB,WAAW,GAAG,QAAQ,aAAa,IAAI,QAAQ,cAAc;AAAA,EAC/D,CAAC;AAED,MAAI;AACF,UAAM,SAAS,MAAM,gBAAgB,gBAAgB,QAAQ,EAAE;AAE/D,YAAQ,IAAI,+CAA+C;AAAA,MACzD,OAAO,QAAQ;AAAA,MACf,WAAW,OAAO;AAAA,MAClB,kBAAkB,OAAO;AAAA,MACzB,kBAAkB,OAAO;AAAA,IAC3B,CAAC;AAAA,EACH,SAAS,OAAO;AAGd,YAAQ,MAAM,oDAAoD,QAAQ,IAAI,KAAK;AAAA,EACrF;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/subscribers/tracking-job-webhook-dispatch.js

@@ -0,0 +1,19 @@
+const metadata = {
+  event: "shipment_tracking.tracking_job.*",
+  persistent: true,
+  id: "shipment_tracking:tracking-job-webhook-dispatch"
+};
+async function handle(payload, ctx) {
+  const eventParts = ctx.eventName.split(".");
+  const action = eventParts[eventParts.length - 1];
+  console.debug(`[shipment-tracking:internal] Tracking job event: ${action}`, {
+    jobId: payload.id,
+    shipmentId: payload.shipmentId,
+    carrierCode: payload.carrierCode
+  });
+}
+export {
+  handle as default,
+  metadata
+};
+//# sourceMappingURL=tracking-job-webhook-dispatch.js.map

package/dist/modules/shipment_tracking/subscribers/tracking-job-webhook-dispatch.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/subscribers/tracking-job-webhook-dispatch.ts"],
+  "sourcesContent": ["/**\n * Tracking Job Event Handler\n *\n * NOTE: As of DCSA T&T compliance update, tracking_job events are marked as\n * internal events (excludeFromTriggers: true) and are NOT dispatched to\n * external webhooks. These events are for internal system monitoring only.\n *\n * This subscriber remains for internal audit logging but does not dispatch\n * webhooks to external consumers. External consumers should subscribe to\n * DCSA-compliant events like:\n * - shipment_tracking.transport.* (departed, arrived, eta_updated, etc.)\n * - shipment_tracking.equipment.* (loaded, discharged, gate_in, etc.)\n * - shipment_tracking.shipment.* (created, updated, status_changed, etc.)\n */\n\nexport const metadata = {\n  event: 'shipment_tracking.tracking_job.*',\n  persistent: true,\n  id: 'shipment_tracking:tracking-job-webhook-dispatch',\n}\n\ntype TrackingJobEventPayload = {\n  id: string\n  shipmentId?: string\n  carrierCode?: string\n  tenantId: string\n  organizationId: string\n}\n\ntype ResolverContext = {\n  resolve: <T = unknown>(name: string) => T\n  eventName: string\n}\n\nexport default async function handle(payload: TrackingJobEventPayload, ctx: ResolverContext) {\n  // Extract the action from the event name (e.g., \"created\", \"updated\", \"failed\")\n  const eventParts = ctx.eventName.split('.')\n  const action = eventParts[eventParts.length - 1]\n\n  // Internal logging only - no webhook dispatch for tracking_job events\n  // These are internal system events per DCSA compliance requirements\n  console.debug(`[shipment-tracking:internal] Tracking job event: ${action}`, {\n    jobId: payload.id,\n    shipmentId: payload.shipmentId,\n    carrierCode: payload.carrierCode,\n  })\n\n  // NOTE: Webhook dispatch removed - tracking_job events are internal only\n  // External consumers should subscribe to DCSA-compliant transport/equipment events\n}\n"],
+  "mappings": "AAeO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,IAAI;AACN;AAeA,eAAO,OAA8B,SAAkC,KAAsB;AAE3F,QAAM,aAAa,IAAI,UAAU,MAAM,GAAG;AAC1C,QAAM,SAAS,WAAW,WAAW,SAAS,CAAC;AAI/C,UAAQ,MAAM,oDAAoD,MAAM,IAAI;AAAA,IAC1E,OAAO,QAAQ;AAAA,IACf,YAAY,QAAQ;AAAA,IACpB,aAAa,QAAQ;AAAA,EACvB,CAAC;AAIH;",
+  "names": []
+}

package/dist/modules/shipment_tracking/tables/index.js

@@ -0,0 +1,6 @@
+import trackingJob from "./tracking_job/table.js";
+const tables = [trackingJob];
+export {
+  tables
+};
+//# sourceMappingURL=index.js.map

package/dist/modules/shipment_tracking/tables/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/tables/index.ts"],
+  "sourcesContent": ["import type { TableDefinition } from '@freighttech/ui/backend/dynamic-table'\nimport trackingJob from './tracking_job/table'\n\nexport const tables: TableDefinition[] = [trackingJob]\n"],
+  "mappings": "AACA,OAAO,iBAAiB;AAEjB,MAAM,SAA4B,CAAC,WAAW;",
+  "names": []
+}