@freighttech/shipment-tracking 0.6.0

package/dist/modules/shipment_tracking/migrations/Migration20260821120000_shipment_tracking_shipsgo.js

@@ -0,0 +1,47 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260821120000_shipment_tracking_shipsgo extends Migration {
+  async up() {
+    this.addSql(`create table if not exists "shipment_tracking_shipsgo_configs" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "is_enabled" boolean not null default false,
+      "api_token" text not null,
+      "base_url" text not null default 'https://api.shipsgo.com/v2',
+      "ocean_enabled" boolean not null default true,
+      "air_enabled" boolean not null default true,
+      "rate_limit_requests" int not null default 60,
+      "rate_limit_window_seconds" int not null default 60,
+      "is_active" boolean not null default true,
+      "created_at" timestamptz not null default now(),
+      "updated_at" timestamptz not null default now(),
+      "deleted_at" timestamptz null,
+      constraint "shipment_tracking_shipsgo_configs_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index if not exists "st_shipsgo_configs_org_tenant_idx" on "shipment_tracking_shipsgo_configs" ("organization_id", "tenant_id");`);
+    this.addSql(`create unique index if not exists "st_shipsgo_configs_scope_unique" on "shipment_tracking_shipsgo_configs" ("organization_id", "tenant_id");`);
+    this.addSql(`alter table "shipment_tracking_jobs" add column if not exists "provider" text not null default 'carrier';`);
+    this.addSql(`alter table "shipment_tracking_jobs" add column if not exists "mode" text not null default 'ocean';`);
+    this.addSql(`alter table "shipment_tracking_jobs" add column if not exists "provider_shipment_id" text null;`);
+    this.addSql(`alter table "shipment_tracking_shipments" add column if not exists "mode" text not null default 'ocean';`);
+    this.addSql(`alter table "shipment_tracking_shipments" add column if not exists "awb_number" text null;`);
+    this.addSql(`alter table "shipment_tracking_shipments" add column if not exists "flight_number" text null;`);
+    this.addSql(`alter table "shipment_tracking_shipments" add column if not exists "airline_code" text null;`);
+    this.addSql(`alter table "shipment_tracking_shipments" add column if not exists "airline_name" text null;`);
+  }
+  async down() {
+    this.addSql(`alter table "shipment_tracking_shipments" drop column if exists "airline_name";`);
+    this.addSql(`alter table "shipment_tracking_shipments" drop column if exists "airline_code";`);
+    this.addSql(`alter table "shipment_tracking_shipments" drop column if exists "flight_number";`);
+    this.addSql(`alter table "shipment_tracking_shipments" drop column if exists "awb_number";`);
+    this.addSql(`alter table "shipment_tracking_shipments" drop column if exists "mode";`);
+    this.addSql(`alter table "shipment_tracking_jobs" drop column if exists "provider_shipment_id";`);
+    this.addSql(`alter table "shipment_tracking_jobs" drop column if exists "mode";`);
+    this.addSql(`alter table "shipment_tracking_jobs" drop column if exists "provider";`);
+    this.addSql(`drop table if exists "shipment_tracking_shipsgo_configs";`);
+  }
+}
+export {
+  Migration20260821120000_shipment_tracking_shipsgo
+};
+//# sourceMappingURL=Migration20260821120000_shipment_tracking_shipsgo.js.map

package/dist/modules/shipment_tracking/migrations/Migration20260821120000_shipment_tracking_shipsgo.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/migrations/Migration20260821120000_shipment_tracking_shipsgo.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\n/**\n * ShipsGo fallback tracking (Phase 1 \u2014 ocean fallback + air groundwork).\n *\n * Additive only:\n *  - `shipment_tracking_shipsgo_configs`: per-tenant ShipsGo config (encrypted api_token).\n *  - `shipment_tracking_jobs`: `provider` ('carrier'|'shipsgo'), `mode` ('ocean'|'air'),\n *    `provider_shipment_id` (ShipsGo id, set on registration).\n *  - `shipment_tracking_shipments`: `mode` + air fields (awb/flight/airline), all nullable.\n *\n * Existing rows default to provider='carrier', mode='ocean' \u2014 no backfill needed.\n */\nexport class Migration20260821120000_shipment_tracking_shipsgo extends Migration {\n\n  override async up(): Promise<void> {\n    // ShipsGoConfig\n    this.addSql(`create table if not exists \"shipment_tracking_shipsgo_configs\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"is_enabled\" boolean not null default false,\n      \"api_token\" text not null,\n      \"base_url\" text not null default 'https://api.shipsgo.com/v2',\n      \"ocean_enabled\" boolean not null default true,\n      \"air_enabled\" boolean not null default true,\n      \"rate_limit_requests\" int not null default 60,\n      \"rate_limit_window_seconds\" int not null default 60,\n      \"is_active\" boolean not null default true,\n      \"created_at\" timestamptz not null default now(),\n      \"updated_at\" timestamptz not null default now(),\n      \"deleted_at\" timestamptz null,\n      constraint \"shipment_tracking_shipsgo_configs_pkey\" primary key (\"id\")\n    );`);\n    this.addSql(`create index if not exists \"st_shipsgo_configs_org_tenant_idx\" on \"shipment_tracking_shipsgo_configs\" (\"organization_id\", \"tenant_id\");`);\n    this.addSql(`create unique index if not exists \"st_shipsgo_configs_scope_unique\" on \"shipment_tracking_shipsgo_configs\" (\"organization_id\", \"tenant_id\");`);\n\n    // TrackingJob provider/mode\n    this.addSql(`alter table \"shipment_tracking_jobs\" add column if not exists \"provider\" text not null default 'carrier';`);\n    this.addSql(`alter table \"shipment_tracking_jobs\" add column if not exists \"mode\" text not null default 'ocean';`);\n    this.addSql(`alter table \"shipment_tracking_jobs\" add column if not exists \"provider_shipment_id\" text null;`);\n\n    // Shipment mode + air fields\n    this.addSql(`alter table \"shipment_tracking_shipments\" add column if not exists \"mode\" text not null default 'ocean';`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" add column if not exists \"awb_number\" text null;`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" add column if not exists \"flight_number\" text null;`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" add column if not exists \"airline_code\" text null;`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" add column if not exists \"airline_name\" text null;`);\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"shipment_tracking_shipments\" drop column if exists \"airline_name\";`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" drop column if exists \"airline_code\";`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" drop column if exists \"flight_number\";`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" drop column if exists \"awb_number\";`);\n    this.addSql(`alter table \"shipment_tracking_shipments\" drop column if exists \"mode\";`);\n\n    this.addSql(`alter table \"shipment_tracking_jobs\" drop column if exists \"provider_shipment_id\";`);\n    this.addSql(`alter table \"shipment_tracking_jobs\" drop column if exists \"mode\";`);\n    this.addSql(`alter table \"shipment_tracking_jobs\" drop column if exists \"provider\";`);\n\n    this.addSql(`drop table if exists \"shipment_tracking_shipsgo_configs\";`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAanB,MAAM,0DAA0D,UAAU;AAAA,EAE/E,MAAe,KAAoB;AAEjC,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAgBT;AACH,SAAK,OAAO,yIAAyI;AACrJ,SAAK,OAAO,8IAA8I;AAG1J,SAAK,OAAO,2GAA2G;AACvH,SAAK,OAAO,qGAAqG;AACjH,SAAK,OAAO,iGAAiG;AAG7G,SAAK,OAAO,0GAA0G;AACtH,SAAK,OAAO,4FAA4F;AACxG,SAAK,OAAO,+FAA+F;AAC3G,SAAK,OAAO,8FAA8F;AAC1G,SAAK,OAAO,8FAA8F;AAAA,EAC5G;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,iFAAiF;AAC7F,SAAK,OAAO,iFAAiF;AAC7F,SAAK,OAAO,kFAAkF;AAC9F,SAAK,OAAO,+EAA+E;AAC3F,SAAK,OAAO,yEAAyE;AAErF,SAAK,OAAO,oFAAoF;AAChG,SAAK,OAAO,oEAAoE;AAChF,SAAK,OAAO,wEAAwE;AAEpF,SAAK,OAAO,2DAA2D;AAAA,EACzE;AAEF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/notifications.js

@@ -0,0 +1,145 @@
+const notificationTypes = [
+  // ─── Tracking Job POI Port Events ──────────────────────────────
+  {
+    type: "shipment_tracking.tracking_job.poi.port_arrival",
+    module: "shipment_tracking",
+    titleKey: "shipment_tracking.notifications.tracking_job.poi.port_arrival.title",
+    bodyKey: "shipment_tracking.notifications.tracking_job.poi.port_arrival.body",
+    icon: "anchor",
+    severity: "success",
+    actions: [
+      {
+        id: "view",
+        labelKey: "common.view",
+        variant: "outline",
+        href: "/backend/shipment-tracking?shipment={sourceEntityId}",
+        icon: "external-link"
+      }
+    ],
+    linkHref: "/backend/shipment-tracking?shipment={sourceEntityId}",
+    expiresAfterHours: 168
+    // 7 days
+  },
+  {
+    type: "shipment_tracking.tracking_job.poi.port_proximity_arrival",
+    module: "shipment_tracking",
+    titleKey: "shipment_tracking.notifications.tracking_job.poi.port_proximity_arrival.title",
+    bodyKey: "shipment_tracking.notifications.tracking_job.poi.port_proximity_arrival.body",
+    icon: "navigation",
+    severity: "info",
+    actions: [
+      {
+        id: "view",
+        labelKey: "common.view",
+        variant: "outline",
+        href: "/backend/shipment-tracking?shipment={sourceEntityId}",
+        icon: "external-link"
+      }
+    ],
+    linkHref: "/backend/shipment-tracking?shipment={sourceEntityId}",
+    expiresAfterHours: 168
+  },
+  {
+    type: "shipment_tracking.tracking_job.poi.port_departure",
+    module: "shipment_tracking",
+    titleKey: "shipment_tracking.notifications.tracking_job.poi.port_departure.title",
+    bodyKey: "shipment_tracking.notifications.tracking_job.poi.port_departure.body",
+    icon: "ship",
+    severity: "info",
+    actions: [
+      {
+        id: "view",
+        labelKey: "common.view",
+        variant: "outline",
+        href: "/backend/shipment-tracking?shipment={sourceEntityId}",
+        icon: "external-link"
+      }
+    ],
+    linkHref: "/backend/shipment-tracking?shipment={sourceEntityId}",
+    expiresAfterHours: 168
+  },
+  // ─── Tracking Job POI Terminal Events ──────────────────────────
+  {
+    type: "shipment_tracking.tracking_job.poi.terminal_arrival",
+    module: "shipment_tracking",
+    titleKey: "shipment_tracking.notifications.tracking_job.poi.terminal_arrival.title",
+    bodyKey: "shipment_tracking.notifications.tracking_job.poi.terminal_arrival.body",
+    icon: "container",
+    severity: "success",
+    actions: [
+      {
+        id: "view",
+        labelKey: "common.view",
+        variant: "outline",
+        href: "/backend/shipment-tracking?shipment={sourceEntityId}",
+        icon: "external-link"
+      }
+    ],
+    linkHref: "/backend/shipment-tracking?shipment={sourceEntityId}",
+    expiresAfterHours: 168
+  },
+  {
+    type: "shipment_tracking.tracking_job.poi.terminal_proximity_arrival",
+    module: "shipment_tracking",
+    titleKey: "shipment_tracking.notifications.tracking_job.poi.terminal_proximity_arrival.title",
+    bodyKey: "shipment_tracking.notifications.tracking_job.poi.terminal_proximity_arrival.body",
+    icon: "navigation",
+    severity: "info",
+    actions: [
+      {
+        id: "view",
+        labelKey: "common.view",
+        variant: "outline",
+        href: "/backend/shipment-tracking?shipment={sourceEntityId}",
+        icon: "external-link"
+      }
+    ],
+    linkHref: "/backend/shipment-tracking?shipment={sourceEntityId}",
+    expiresAfterHours: 168
+  },
+  {
+    type: "shipment_tracking.tracking_job.poi.terminal_departure",
+    module: "shipment_tracking",
+    titleKey: "shipment_tracking.notifications.tracking_job.poi.terminal_departure.title",
+    bodyKey: "shipment_tracking.notifications.tracking_job.poi.terminal_departure.body",
+    icon: "ship",
+    severity: "info",
+    actions: [
+      {
+        id: "view",
+        labelKey: "common.view",
+        variant: "outline",
+        href: "/backend/shipment-tracking?shipment={sourceEntityId}",
+        icon: "external-link"
+      }
+    ],
+    linkHref: "/backend/shipment-tracking?shipment={sourceEntityId}",
+    expiresAfterHours: 168
+  },
+  // ─── Tracking Job POI Waypoint Events ──────────────────────────
+  {
+    type: "shipment_tracking.tracking_job.poi.waypoint_reached",
+    module: "shipment_tracking",
+    titleKey: "shipment_tracking.notifications.tracking_job.poi.waypoint_reached.title",
+    bodyKey: "shipment_tracking.notifications.tracking_job.poi.waypoint_reached.body",
+    icon: "map-pin",
+    severity: "info",
+    actions: [
+      {
+        id: "view",
+        labelKey: "common.view",
+        variant: "outline",
+        href: "/backend/shipment-tracking?shipment={sourceEntityId}",
+        icon: "external-link"
+      }
+    ],
+    linkHref: "/backend/shipment-tracking?shipment={sourceEntityId}",
+    expiresAfterHours: 168
+  }
+];
+var notifications_default = notificationTypes;
+export {
+  notifications_default as default,
+  notificationTypes
+};
+//# sourceMappingURL=notifications.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/shipment_tracking/notifications.ts"],
+  "sourcesContent": ["import type { NotificationTypeDefinition } from '@open-mercato/shared/modules/notifications/types'\n\n/**\n * Shipment Tracking Notification Types\n *\n * These are per-tracking-job notification types for POI proximity events.\n * Using per-job events ensures only one notification per booking/BOL,\n * regardless of how many containers are being tracked.\n */\nexport const notificationTypes: NotificationTypeDefinition[] = [\n  // \u2500\u2500\u2500 Tracking Job POI Port Events \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  {\n    type: 'shipment_tracking.tracking_job.poi.port_arrival',\n    module: 'shipment_tracking',\n    titleKey: 'shipment_tracking.notifications.tracking_job.poi.port_arrival.title',\n    bodyKey: 'shipment_tracking.notifications.tracking_job.poi.port_arrival.body',\n    icon: 'anchor',\n    severity: 'success',\n    actions: [\n      {\n        id: 'view',\n        labelKey: 'common.view',\n        variant: 'outline',\n        href: '/backend/shipment-tracking?shipment={sourceEntityId}',\n        icon: 'external-link',\n      },\n    ],\n    linkHref: '/backend/shipment-tracking?shipment={sourceEntityId}',\n    expiresAfterHours: 168, // 7 days\n  },\n  {\n    type: 'shipment_tracking.tracking_job.poi.port_proximity_arrival',\n    module: 'shipment_tracking',\n    titleKey: 'shipment_tracking.notifications.tracking_job.poi.port_proximity_arrival.title',\n    bodyKey: 'shipment_tracking.notifications.tracking_job.poi.port_proximity_arrival.body',\n    icon: 'navigation',\n    severity: 'info',\n    actions: [\n      {\n        id: 'view',\n        labelKey: 'common.view',\n        variant: 'outline',\n        href: '/backend/shipment-tracking?shipment={sourceEntityId}',\n        icon: 'external-link',\n      },\n    ],\n    linkHref: '/backend/shipment-tracking?shipment={sourceEntityId}',\n    expiresAfterHours: 168,\n  },\n  {\n    type: 'shipment_tracking.tracking_job.poi.port_departure',\n    module: 'shipment_tracking',\n    titleKey: 'shipment_tracking.notifications.tracking_job.poi.port_departure.title',\n    bodyKey: 'shipment_tracking.notifications.tracking_job.poi.port_departure.body',\n    icon: 'ship',\n    severity: 'info',\n    actions: [\n      {\n        id: 'view',\n        labelKey: 'common.view',\n        variant: 'outline',\n        href: '/backend/shipment-tracking?shipment={sourceEntityId}',\n        icon: 'external-link',\n      },\n    ],\n    linkHref: '/backend/shipment-tracking?shipment={sourceEntityId}',\n    expiresAfterHours: 168,\n  },\n\n  // \u2500\u2500\u2500 Tracking Job POI Terminal Events \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  {\n    type: 'shipment_tracking.tracking_job.poi.terminal_arrival',\n    module: 'shipment_tracking',\n    titleKey: 'shipment_tracking.notifications.tracking_job.poi.terminal_arrival.title',\n    bodyKey: 'shipment_tracking.notifications.tracking_job.poi.terminal_arrival.body',\n    icon: 'container',\n    severity: 'success',\n    actions: [\n      {\n        id: 'view',\n        labelKey: 'common.view',\n        variant: 'outline',\n        href: '/backend/shipment-tracking?shipment={sourceEntityId}',\n        icon: 'external-link',\n      },\n    ],\n    linkHref: '/backend/shipment-tracking?shipment={sourceEntityId}',\n    expiresAfterHours: 168,\n  },\n  {\n    type: 'shipment_tracking.tracking_job.poi.terminal_proximity_arrival',\n    module: 'shipment_tracking',\n    titleKey: 'shipment_tracking.notifications.tracking_job.poi.terminal_proximity_arrival.title',\n    bodyKey: 'shipment_tracking.notifications.tracking_job.poi.terminal_proximity_arrival.body',\n    icon: 'navigation',\n    severity: 'info',\n    actions: [\n      {\n        id: 'view',\n        labelKey: 'common.view',\n        variant: 'outline',\n        href: '/backend/shipment-tracking?shipment={sourceEntityId}',\n        icon: 'external-link',\n      },\n    ],\n    linkHref: '/backend/shipment-tracking?shipment={sourceEntityId}',\n    expiresAfterHours: 168,\n  },\n  {\n    type: 'shipment_tracking.tracking_job.poi.terminal_departure',\n    module: 'shipment_tracking',\n    titleKey: 'shipment_tracking.notifications.tracking_job.poi.terminal_departure.title',\n    bodyKey: 'shipment_tracking.notifications.tracking_job.poi.terminal_departure.body',\n    icon: 'ship',\n    severity: 'info',\n    actions: [\n      {\n        id: 'view',\n        labelKey: 'common.view',\n        variant: 'outline',\n        href: '/backend/shipment-tracking?shipment={sourceEntityId}',\n        icon: 'external-link',\n      },\n    ],\n    linkHref: '/backend/shipment-tracking?shipment={sourceEntityId}',\n    expiresAfterHours: 168,\n  },\n\n  // \u2500\u2500\u2500 Tracking Job POI Waypoint Events \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  {\n    type: 'shipment_tracking.tracking_job.poi.waypoint_reached',\n    module: 'shipment_tracking',\n    titleKey: 'shipment_tracking.notifications.tracking_job.poi.waypoint_reached.title',\n    bodyKey: 'shipment_tracking.notifications.tracking_job.poi.waypoint_reached.body',\n    icon: 'map-pin',\n    severity: 'info',\n    actions: [\n      {\n        id: 'view',\n        labelKey: 'common.view',\n        variant: 'outline',\n        href: '/backend/shipment-tracking?shipment={sourceEntityId}',\n        icon: 'external-link',\n      },\n    ],\n    linkHref: '/backend/shipment-tracking?shipment={sourceEntityId}',\n    expiresAfterHours: 168,\n  },\n]\n\nexport default notificationTypes\n"],
+  "mappings": "AASO,MAAM,oBAAkD;AAAA;AAAA,EAE7D;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,MACP;AAAA,QACE,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,UAAU;AAAA,IACV,mBAAmB;AAAA;AAAA,EACrB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,MACP;AAAA,QACE,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,UAAU;AAAA,IACV,mBAAmB;AAAA,EACrB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,MACP;AAAA,QACE,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,UAAU;AAAA,IACV,mBAAmB;AAAA,EACrB;AAAA;AAAA,EAGA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,MACP;AAAA,QACE,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,UAAU;AAAA,IACV,mBAAmB;AAAA,EACrB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,MACP;AAAA,QACE,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,UAAU;AAAA,IACV,mBAAmB;AAAA,EACrB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,MACP;AAAA,QACE,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,UAAU;AAAA,IACV,mBAAmB;AAAA,EACrB;AAAA;AAAA,EAGA;AAAA,IACE,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,MACP;AAAA,QACE,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,UAAU;AAAA,IACV,mBAAmB;AAAA,EACrB;AACF;AAEA,IAAO,wBAAQ;",
+  "names": []
+}

package/dist/modules/shipment_tracking/services/carrierRegistry.js

@@ -0,0 +1,24 @@
+class CarrierRegistryService {
+  constructor() {
+    this.adapters = /* @__PURE__ */ new Map();
+  }
+  register(adapter) {
+    this.adapters.set(adapter.carrierCode.toLowerCase(), adapter);
+  }
+  get(carrierCode) {
+    return this.adapters.get(carrierCode.toLowerCase());
+  }
+  list() {
+    return Array.from(this.adapters.values());
+  }
+  has(carrierCode) {
+    return this.adapters.has(carrierCode.toLowerCase());
+  }
+  names() {
+    return Array.from(this.adapters.keys());
+  }
+}
+export {
+  CarrierRegistryService
+};
+//# sourceMappingURL=carrierRegistry.js.map

package/dist/modules/shipment_tracking/services/carrierRegistry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/services/carrierRegistry.ts"],
+  "sourcesContent": ["import type { CarrierAdapter } from '../lib/carrier-adapter'\n\n/**\n * Singleton registry for carrier adapters.\n * Modules register concrete adapters at startup via DI.\n */\nexport class CarrierRegistryService {\n  private adapters = new Map<string, CarrierAdapter>()\n\n  register(adapter: CarrierAdapter): void {\n    this.adapters.set(adapter.carrierCode.toLowerCase(), adapter)\n  }\n\n  get(carrierCode: string): CarrierAdapter | undefined {\n    return this.adapters.get(carrierCode.toLowerCase())\n  }\n\n  list(): CarrierAdapter[] {\n    return Array.from(this.adapters.values())\n  }\n\n  has(carrierCode: string): boolean {\n    return this.adapters.has(carrierCode.toLowerCase())\n  }\n\n  names(): string[] {\n    return Array.from(this.adapters.keys())\n  }\n}\n"],
+  "mappings": "AAMO,MAAM,uBAAuB;AAAA,EAA7B;AACL,SAAQ,WAAW,oBAAI,IAA4B;AAAA;AAAA,EAEnD,SAAS,SAA+B;AACtC,SAAK,SAAS,IAAI,QAAQ,YAAY,YAAY,GAAG,OAAO;AAAA,EAC9D;AAAA,EAEA,IAAI,aAAiD;AACnD,WAAO,KAAK,SAAS,IAAI,YAAY,YAAY,CAAC;AAAA,EACpD;AAAA,EAEA,OAAyB;AACvB,WAAO,MAAM,KAAK,KAAK,SAAS,OAAO,CAAC;AAAA,EAC1C;AAAA,EAEA,IAAI,aAA8B;AAChC,WAAO,KAAK,SAAS,IAAI,YAAY,YAAY,CAAC;AAAA,EACpD;AAAA,EAEA,QAAkB;AAChB,WAAO,MAAM,KAAK,KAAK,SAAS,KAAK,CAAC;AAAA,EACxC;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/services/poiNatsService.js

@@ -0,0 +1,397 @@
+import { connect, JSONCodec, AckPolicy, DeliverPolicy, ReplayPolicy } from "nats";
+import { loadPoiNatsConfig, validatePoiNatsConfig, isPoiNatsConfigured } from "../lib/poi-nats-config.js";
+import { getJobPoiEventId } from "../lib/poi-types.js";
+import { mapToOpenMercatoEventId } from "../lib/poi-event-processor.js";
+import {
+  processPoiEvent,
+  isEventAlreadyProcessed,
+  createTrackingEventFromPoi
+} from "../lib/poi-event-processor.js";
+import { Shipment } from "../data/entities.js";
+import { trackingLogger } from "../lib/logger.js";
+const LOG_COMPONENT = "poi-nats";
+class PoiNatsService {
+  constructor(deps) {
+    this.connection = null;
+    this.jetstream = null;
+    this.consumer = null;
+    this.consumerMessages = null;
+    this.status = "disconnected";
+    this.stats = {
+      status: "disconnected",
+      messagesReceived: 0,
+      messagesProcessed: 0,
+      eventsCreated: 0,
+      errors: 0,
+      lastMessageAt: null,
+      connectedAt: null
+    };
+    /**
+     * Track per-job events already emitted in this batch to avoid duplicates.
+     * Key format: `${trackingJobId}:${eventType}:${sourceEventId}`
+     */
+    this.emittedJobEvents = /* @__PURE__ */ new Set();
+    this.deps = deps;
+    this.config = loadPoiNatsConfig();
+  }
+  /**
+   * Get current service statistics.
+   */
+  getStats() {
+    return { ...this.stats, status: this.status };
+  }
+  /**
+   * Check if the service is connected.
+   */
+  isConnected() {
+    return this.status === "connected";
+  }
+  /**
+   * Check if POI NATS integration is configured.
+   */
+  isConfigured() {
+    return isPoiNatsConfigured();
+  }
+  /**
+   * Start the NATS subscriber.
+   */
+  async start() {
+    if (!isPoiNatsConfigured()) {
+      trackingLogger.info("POI_NATS_URL not configured, skipping POI event subscription", {
+        component: LOG_COMPONENT
+      });
+      return;
+    }
+    if (this.status === "connected" || this.status === "connecting") {
+      trackingLogger.warn("Service is already started or connecting", {
+        component: LOG_COMPONENT,
+        status: this.status
+      });
+      return;
+    }
+    try {
+      validatePoiNatsConfig(this.config);
+      this.status = "connecting";
+      trackingLogger.info("Connecting to NATS server", {
+        component: LOG_COMPONENT,
+        serverUrl: this.config.serverUrl
+      });
+      this.connection = await connect({
+        servers: this.config.serverUrl,
+        name: this.config.connectionName,
+        reconnect: true,
+        maxReconnectAttempts: this.config.reconnect.maxAttempts,
+        reconnectTimeWait: this.config.reconnect.initialDelayMs,
+        reconnectJitter: this.config.reconnect.maxDelayMs - this.config.reconnect.initialDelayMs
+      });
+      this.status = "connected";
+      this.stats.connectedAt = /* @__PURE__ */ new Date();
+      trackingLogger.info("Connected to NATS server", { component: LOG_COMPONENT });
+      this.setupConnectionHandlers();
+      await this.subscribe();
+      trackingLogger.info("Subscribed to POI subject", {
+        component: LOG_COMPONENT,
+        subject: this.config.subject
+      });
+    } catch (error) {
+      this.status = "disconnected";
+      trackingLogger.error("Failed to connect to NATS", {
+        component: LOG_COMPONENT,
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : void 0
+      });
+      throw error;
+    }
+  }
+  /**
+   * Stop the NATS subscriber gracefully.
+   */
+  async stop() {
+    if (!this.connection) {
+      return;
+    }
+    this.status = "draining";
+    trackingLogger.info("Draining NATS connection", { component: LOG_COMPONENT });
+    try {
+      if (this.consumerMessages) {
+        this.consumerMessages.stop();
+        this.consumerMessages = null;
+      }
+      this.consumer = null;
+      this.jetstream = null;
+      await this.connection.drain();
+      this.connection = null;
+      this.status = "closed";
+      trackingLogger.info("NATS connection closed", { component: LOG_COMPONENT });
+    } catch (error) {
+      trackingLogger.error("Error during NATS shutdown", {
+        component: LOG_COMPONENT,
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : void 0
+      });
+      this.status = "disconnected";
+      throw error;
+    }
+  }
+  /**
+   * Subscribe to POI proximity events via JetStream.
+   *
+   * Auto-creates the durable consumer if it doesn't exist.
+   * Each instance gets a unique consumer name (based on JWT_SECRET hash)
+   * so multiple self-hosted installations can each receive all messages.
+   */
+  async subscribe() {
+    if (!this.connection) {
+      throw new Error("Not connected to NATS");
+    }
+    const jsm = await this.connection.jetstreamManager();
+    await this.ensureConsumer(jsm);
+    this.jetstream = this.connection.jetstream();
+    trackingLogger.debug("Binding to JetStream consumer", {
+      component: LOG_COMPONENT,
+      consumerName: this.config.consumerName,
+      streamName: this.config.streamName
+    });
+    this.consumer = await this.jetstream.consumers.get(
+      this.config.streamName,
+      this.config.consumerName
+    );
+    trackingLogger.debug("Consumer bound, starting to consume messages", {
+      component: LOG_COMPONENT,
+      consumerName: this.config.consumerName
+    });
+    this.consumerMessages = await this.consumer.consume();
+    this.processMessages();
+  }
+  /**
+   * Ensure the durable consumer exists on the stream.
+   * Creates it if it doesn't exist with the appropriate configuration.
+   */
+  async ensureConsumer(jsm) {
+    const consumerConfig = {
+      durable_name: this.config.consumerName,
+      ack_policy: AckPolicy.Explicit,
+      deliver_policy: DeliverPolicy.All,
+      // Replay all messages from stream start
+      replay_policy: ReplayPolicy.Instant,
+      // Don't throttle replay
+      filter_subject: this.config.subject,
+      max_deliver: 5
+      // Prevent infinite redelivery of poison messages
+    };
+    try {
+      await jsm.consumers.info(this.config.streamName, this.config.consumerName);
+      trackingLogger.debug("Consumer exists", {
+        component: LOG_COMPONENT,
+        consumerName: this.config.consumerName
+      });
+    } catch (error) {
+      const errorCode = error?.code;
+      if (errorCode === "404" || error?.api_error?.err_code === 10014) {
+        trackingLogger.info("Creating JetStream consumer", {
+          component: LOG_COMPONENT,
+          consumerName: this.config.consumerName,
+          streamName: this.config.streamName
+        });
+        await jsm.consumers.add(this.config.streamName, consumerConfig);
+        trackingLogger.info("JetStream consumer created", {
+          component: LOG_COMPONENT,
+          consumerName: this.config.consumerName
+        });
+      } else {
+        throw error;
+      }
+    }
+  }
+  /**
+   * Process incoming messages from the JetStream consumer.
+   */
+  async processMessages() {
+    if (!this.consumerMessages) {
+      return;
+    }
+    const jsonCodec = JSONCodec();
+    for await (const msg of this.consumerMessages) {
+      this.stats.messagesReceived++;
+      this.stats.lastMessageAt = /* @__PURE__ */ new Date();
+      try {
+        const event = jsonCodec.decode(msg.data);
+        if (!event || !event.type || !event.mmsi) {
+          trackingLogger.debug("Skipping invalid message (missing type or mmsi)", {
+            component: LOG_COMPONENT
+          });
+          msg.ack();
+          continue;
+        }
+        await this.handlePoiEvent(event);
+        msg.ack();
+        this.stats.messagesProcessed++;
+      } catch (error) {
+        this.stats.errors++;
+        trackingLogger.error("Error processing NATS message", {
+          component: LOG_COMPONENT,
+          error: error instanceof Error ? error.message : String(error),
+          stack: error instanceof Error ? error.stack : void 0
+        });
+        msg.nak();
+      }
+    }
+  }
+  /**
+   * Handle a single POI proximity event.
+   */
+  async handlePoiEvent(event) {
+    this.emittedJobEvents.clear();
+    trackingLogger.debug("Received POI event", {
+      component: LOG_COMPONENT,
+      eventType: event.type,
+      vesselName: event.shipName,
+      mmsi: event.mmsi
+    });
+    const em = this.deps.em().fork({ clear: true });
+    try {
+      const processed = await processPoiEvent(em, event);
+      if (!processed) {
+        return;
+      }
+      trackingLogger.info("Matched shipments for POI event", {
+        component: LOG_COMPONENT,
+        mmsi: event.mmsi,
+        eventType: event.type,
+        matchedShipmentCount: processed.shipmentIds.length
+      });
+      const affectedJobIds = /* @__PURE__ */ new Set();
+      for (const shipmentId of processed.shipmentIds) {
+        const shipment = await em.findOne(
+          Shipment,
+          { id: shipmentId },
+          { populate: ["trackingJob"] }
+        );
+        if (!shipment?.trackingJob) {
+          continue;
+        }
+        const alreadyProcessed = await isEventAlreadyProcessed(
+          em,
+          shipment.trackingJob.id,
+          processed.sourceEventId
+        );
+        if (alreadyProcessed) {
+          trackingLogger.debug("Event already processed", {
+            component: LOG_COMPONENT,
+            sourceEventId: processed.sourceEventId,
+            trackingJobId: shipment.trackingJob.id
+          });
+          continue;
+        }
+        const trackingEvent = createTrackingEventFromPoi(processed, shipment.trackingJob);
+        em.persist(trackingEvent);
+        this.stats.eventsCreated++;
+        affectedJobIds.add(shipment.trackingJob.id);
+        const shipmentEventId = mapToOpenMercatoEventId(event.type);
+        await this.deps.eventBus.emit(shipmentEventId, {
+          shipmentId: shipment.id,
+          trackingEventId: trackingEvent.id,
+          organizationId: shipment.organizationId,
+          tenantId: shipment.tenantId,
+          vesselName: event.shipName,
+          vesselMmsi: event.mmsi,
+          vesselImo: processed.vesselImo,
+          eventType: event.type,
+          poiCode: processed.poiCode,
+          latitude: event.lat,
+          longitude: event.lng,
+          eventDateTime: processed.eventDateTime.toISOString(),
+          distanceToPoiMeters: event.distanceToPoiMeters
+        });
+        const trackingJobId = shipment.trackingJob.id;
+        const jobEventKey = `${trackingJobId}:${event.type}:${processed.sourceEventId}`;
+        if (!this.emittedJobEvents.has(jobEventKey)) {
+          this.emittedJobEvents.add(jobEventKey);
+          const jobEventId = getJobPoiEventId(event.type);
+          await this.deps.eventBus.emit(jobEventId, {
+            trackingJobId,
+            shipmentId: shipment.id,
+            trackingEventId: trackingEvent.id,
+            organizationId: shipment.organizationId,
+            tenantId: shipment.tenantId,
+            vesselName: event.shipName,
+            vesselMmsi: event.mmsi,
+            vesselImo: processed.vesselImo,
+            eventType: event.type,
+            poiCode: processed.poiCode,
+            latitude: event.lat,
+            longitude: event.lng,
+            eventDateTime: processed.eventDateTime.toISOString(),
+            distanceToPoiMeters: event.distanceToPoiMeters,
+            // Include shipment reference info for notification body
+            containerNumber: shipment.containerNumber,
+            bookingNumber: shipment.bookingNumber,
+            bolNumber: shipment.bolNumber
+          });
+          trackingLogger.debug("Emitted per-job POI event", {
+            component: LOG_COMPONENT,
+            trackingJobId,
+            eventType: event.type
+          });
+        }
+        trackingLogger.info("Created tracking event from POI", {
+          component: LOG_COMPONENT,
+          shipmentId,
+          eventType: event.type,
+          trackingEventId: trackingEvent.id
+        });
+      }
+      await em.flush();
+      for (const trackingJobId of affectedJobIds) {
+        await this.deps.trackingService.refreshShipmentsFromEvents(em, trackingJobId);
+      }
+    } catch (error) {
+      trackingLogger.error("Error handling POI event", {
+        component: LOG_COMPONENT,
+        eventType: event.type,
+        mmsi: event.mmsi,
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : void 0
+      });
+      throw error;
+    }
+  }
+  /**
+   * Set up connection event handlers.
+   */
+  setupConnectionHandlers() {
+    if (!this.connection) {
+      return;
+    }
+    ;
+    (async () => {
+      if (!this.connection) return;
+      for await (const status of this.connection.status()) {
+        switch (status.type) {
+          case "disconnect":
+            trackingLogger.warn("Disconnected from NATS server", { component: LOG_COMPONENT });
+            this.status = "disconnected";
+            break;
+          case "reconnect":
+            trackingLogger.info("Reconnected to NATS server", { component: LOG_COMPONENT });
+            this.status = "connected";
+            break;
+          case "reconnecting":
+            trackingLogger.info("Reconnecting to NATS server", { component: LOG_COMPONENT });
+            this.status = "connecting";
+            break;
+          case "error":
+            trackingLogger.error("NATS connection error", {
+              component: LOG_COMPONENT,
+              data: status.data
+            });
+            break;
+        }
+      }
+    })();
+  }
+}
+export {
+  PoiNatsService
+};
+//# sourceMappingURL=poiNatsService.js.map