@freighttech/shipment-tracking 0.6.0

package/dist/modules/shipment_tracking/lib/adapters/msc.js

@@ -0,0 +1,170 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { extractDocumentReferences } from "../carrier-adapter.js";
+import { base64UrlEncode } from "../auth/base64url.js";
+import { buildDcsaQueryParams } from "../dcsa-params.js";
+import { parseDcsaEvents } from "../dcsa-event-parser.js";
+import { withCarrierApiSpan } from "../logger.js";
+const EVENTS_URL = "https://api.tech.msc.com/msc/trackandtrace/v2.2/events";
+function getAuth(authConfig) {
+  const certBase64 = authConfig?.certificate_base64;
+  const clientId = authConfig?.client_id;
+  const scope = authConfig?.scope;
+  const tokenUrl = authConfig?.token_url;
+  const aud = authConfig?.aud || tokenUrl;
+  const missing = [
+    !certBase64 && "certificate_base64",
+    !clientId && "client_id",
+    !scope && "scope",
+    !tokenUrl && "token_url"
+  ].filter(Boolean);
+  if (missing.length) {
+    throw new Error(`MSC authConfig requires: ${missing.join(", ")}`);
+  }
+  return {
+    certificate_base64: certBase64,
+    clientId,
+    scope,
+    tokenUrl,
+    aud
+  };
+}
+function extractPfxComponents(pfxBuffer) {
+  const tempDir = os.tmpdir();
+  const uid = crypto.randomUUID();
+  const pfxPath = path.join(tempDir, `msc_${uid}.pfx`);
+  const certPath = path.join(tempDir, `msc_cert_${uid}.pem`);
+  const keyPath = path.join(tempDir, `msc_key_${uid}.pem`);
+  try {
+    fs.writeFileSync(pfxPath, pfxBuffer);
+    execFileSync("openssl", ["pkcs12", "-in", pfxPath, "-nokeys", "-out", certPath, "-passin", "pass:"]);
+    execFileSync("openssl", ["pkcs12", "-in", pfxPath, "-nocerts", "-nodes", "-out", keyPath, "-passin", "pass:"]);
+    const certPem = fs.readFileSync(certPath, "utf8");
+    const privateKeyPem = fs.readFileSync(keyPath, "utf8");
+    return { privateKeyPem, certPem };
+  } finally {
+    for (const filePath of [pfxPath, certPath, keyPath]) {
+      try {
+        fs.unlinkSync(filePath);
+      } catch {
+      }
+    }
+  }
+}
+function createMscJwt(auth) {
+  const pfxBuffer = Buffer.from(auth.certificate_base64, "base64");
+  const { privateKeyPem, certPem } = extractPfxComponents(pfxBuffer);
+  const certMatches = certPem.match(/-----BEGIN CERTIFICATE-----[\s\S]*?-----END CERTIFICATE-----/g);
+  if (!certMatches?.length) {
+    throw new Error("No certificates found in PFX");
+  }
+  const lastCert = certMatches[certMatches.length - 1];
+  const certDerBase64 = lastCert.replace(/-----BEGIN CERTIFICATE-----/g, "").replace(/-----END CERTIFICATE-----/g, "").replace(/\r?\n/g, "").trim();
+  const certDer = Buffer.from(certDerBase64, "base64");
+  const sha1Hash = crypto.createHash("sha1").update(certDer).digest();
+  const x5t = base64UrlEncode(sha1Hash);
+  const now = Math.floor(Date.now() / 1e3);
+  const header = { alg: "RS256", typ: "JWT", x5t };
+  const payload = {
+    aud: auth.aud,
+    exp: now + 120,
+    iss: auth.clientId,
+    jti: crypto.randomUUID(),
+    nbf: now,
+    sub: auth.clientId
+  };
+  const encodedHeader = base64UrlEncode(JSON.stringify(header));
+  const encodedPayload = base64UrlEncode(JSON.stringify(payload));
+  const unsignedToken = `${encodedHeader}.${encodedPayload}`;
+  const sign = crypto.createSign("RSA-SHA256");
+  sign.update(unsignedToken);
+  const signature = sign.sign(privateKeyPem);
+  const encodedSignature = base64UrlEncode(signature);
+  return `${unsignedToken}.${encodedSignature}`;
+}
+async function authenticate(auth) {
+  return withCarrierApiSpan(
+    { carrierCode: "msc", operation: "authenticate" },
+    async (span) => {
+      const jwt = createMscJwt(auth);
+      const body = new URLSearchParams({
+        client_id: auth.clientId,
+        client_assertion: jwt,
+        client_assertion_type: "urn:ietf:params:oauth:client-assertion-type:jwt-bearer",
+        scope: auth.scope,
+        grant_type: "client_credentials"
+      });
+      const response = await fetch(auth.tokenUrl, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${jwt}`,
+          "Content-Type": "application/x-www-form-urlencoded"
+        },
+        body: body.toString()
+      });
+      span.setAttribute("http.status_code", response.status);
+      if (!response.ok) {
+        const errorText = await response.text().catch(() => "unknown");
+        throw new Error(`MSC token request failed (${response.status}): ${errorText}`);
+      }
+      const data = await response.json();
+      return data.access_token;
+    }
+  );
+}
+class MscAdapter {
+  constructor() {
+    this.carrierCode = "msc";
+    this.supportedReferenceTypes = ["container", "booking", "bol"];
+  }
+  async fetchEvents(input) {
+    return withCarrierApiSpan(
+      {
+        carrierCode: this.carrierCode,
+        operation: "fetchEvents",
+        referenceType: input.referenceType,
+        referenceValue: input.referenceValue
+      },
+      async (span) => {
+        const auth = getAuth(input.authConfig);
+        const token = await authenticate(auth);
+        const params = buildDcsaQueryParams(input.referenceValue, input.referenceType);
+        const url = `${input.apiEndpoint || EVENTS_URL}?${params}`;
+        const response = await fetch(url, {
+          headers: {
+            "Authorization": `Bearer ${token}`,
+            "Content-Type": "application/json"
+          }
+        });
+        span.setAttribute("http.status_code", response.status);
+        if (!response.ok) {
+          const errorText = await response.text().catch(() => "unknown");
+          throw new Error(`MSC API error (${response.status}): ${errorText}`);
+        }
+        const data = await response.json();
+        const events = parseDcsaEvents(data, "MSC");
+        const { bookingNumber, bolNumber } = extractDocumentReferences(events);
+        span.setAttribute("events.count", events.length);
+        return { events, bookingNumber, bolNumber };
+      }
+    );
+  }
+  async testConnection(input) {
+    const start = Date.now();
+    try {
+      const auth = getAuth(input.authConfig);
+      await authenticate(auth);
+      return { success: true, message: "MSC authentication successful", latencyMs: Date.now() - start };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return { success: false, message: `MSC connection failed: ${message}`, latencyMs: Date.now() - start };
+    }
+  }
+}
+export {
+  MscAdapter
+};
+//# sourceMappingURL=msc.js.map

package/dist/modules/shipment_tracking/lib/adapters/msc.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/shipment_tracking/lib/adapters/msc.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto'\nimport fs, { writeFileSync } from 'node:fs'\nimport os from 'node:os'\nimport path from 'node:path'\nimport { execFileSync } from 'node:child_process'\nimport type { CarrierAdapter, CarrierFetchResult, CarrierAdapterTestResult } from '../carrier-adapter'\nimport { extractDocumentReferences } from '../carrier-adapter'\nimport type { TrackingReferenceType } from '../../data/entities'\nimport { base64UrlEncode } from '../auth/base64url'\nimport { buildDcsaQueryParams } from '../dcsa-params'\nimport { parseDcsaEvents } from '../dcsa-event-parser'\nimport { withCarrierApiSpan } from '../logger'\n\n// MSC's public track-and-trace events endpoint (DCSA). Overridable per carrier\n// config via `apiEndpoint`.\nconst EVENTS_URL = 'https://api.tech.msc.com/msc/trackandtrace/v2.2/events'\n\n/**\n * MSC OAuth account identity. These values are specific to the API account MSC\n * issues to each integrator (Azure AD tenant, registered client_id and API\n * scope) and are NOT shipped as defaults \u2014 supply them, together with the PFX\n * certificate, through the carrier config's `authConfig`.\n */\ntype MscAuthConfig = {\n  certificate_base64: string\n  clientId: string\n  scope: string\n  tokenUrl: string\n  aud: string\n}\n\nfunction getAuth(authConfig: Record<string, unknown> | null | undefined): MscAuthConfig {\n  const certBase64 = authConfig?.certificate_base64 as string | undefined\n  const clientId = authConfig?.client_id as string | undefined\n  const scope = authConfig?.scope as string | undefined\n  const tokenUrl = authConfig?.token_url as string | undefined\n  const aud = (authConfig?.aud as string | undefined) || tokenUrl\n  const missing = [\n    !certBase64 && 'certificate_base64',\n    !clientId && 'client_id',\n    !scope && 'scope',\n    !tokenUrl && 'token_url',\n  ].filter(Boolean)\n  if (missing.length) {\n    throw new Error(`MSC authConfig requires: ${missing.join(', ')}`)\n  }\n  return {\n    certificate_base64: certBase64!,\n    clientId: clientId!,\n    scope: scope!,\n    tokenUrl: tokenUrl!,\n    aud: aud!,\n  }\n}\n\nfunction extractPfxComponents(pfxBuffer: Buffer): { privateKeyPem: string; certPem: string } {\n  const tempDir = os.tmpdir()\n  const uid = crypto.randomUUID()\n  const pfxPath = path.join(tempDir, `msc_${uid}.pfx`)\n  const certPath = path.join(tempDir, `msc_cert_${uid}.pem`)\n  const keyPath = path.join(tempDir, `msc_key_${uid}.pem`)\n\n  try {\n    fs.writeFileSync(pfxPath, pfxBuffer)\n\n    execFileSync('openssl', ['pkcs12', '-in', pfxPath, '-nokeys', '-out', certPath, '-passin', 'pass:'])\n    execFileSync('openssl', ['pkcs12', '-in', pfxPath, '-nocerts', '-nodes', '-out', keyPath, '-passin', 'pass:'])\n\n    const certPem = fs.readFileSync(certPath, 'utf8')\n    const privateKeyPem = fs.readFileSync(keyPath, 'utf8')\n\n    return { privateKeyPem, certPem }\n  } finally {\n    for (const filePath of [pfxPath, certPath, keyPath]) {\n      try { fs.unlinkSync(filePath) } catch { /* ignore cleanup errors */ }\n    }\n  }\n}\n\nfunction createMscJwt(auth: MscAuthConfig): string {\n  const pfxBuffer = Buffer.from(auth.certificate_base64, 'base64')\n  const { privateKeyPem, certPem } = extractPfxComponents(pfxBuffer)\n\n  // Extract the last certificate from the chain for x5t thumbprint\n  const certMatches = certPem.match(/-----BEGIN CERTIFICATE-----[\\s\\S]*?-----END CERTIFICATE-----/g)\n  if (!certMatches?.length) {\n    throw new Error('No certificates found in PFX')\n  }\n\n  const lastCert = certMatches[certMatches.length - 1]\n  const certDerBase64 = lastCert\n    .replace(/-----BEGIN CERTIFICATE-----/g, '')\n    .replace(/-----END CERTIFICATE-----/g, '')\n    .replace(/\\r?\\n/g, '')\n    .trim()\n\n  const certDer = Buffer.from(certDerBase64, 'base64')\n  const sha1Hash = crypto.createHash('sha1').update(certDer).digest()\n  const x5t = base64UrlEncode(sha1Hash)\n\n  const now = Math.floor(Date.now() / 1000)\n\n  const header = { alg: 'RS256', typ: 'JWT', x5t }\n  const payload = {\n    aud: auth.aud,\n    exp: now + 120,\n    iss: auth.clientId,\n    jti: crypto.randomUUID(),\n    nbf: now,\n    sub: auth.clientId,\n  }\n\n  const encodedHeader = base64UrlEncode(JSON.stringify(header))\n  const encodedPayload = base64UrlEncode(JSON.stringify(payload))\n  const unsignedToken = `${encodedHeader}.${encodedPayload}`\n\n  const sign = crypto.createSign('RSA-SHA256')\n  sign.update(unsignedToken)\n  const signature = sign.sign(privateKeyPem)\n  const encodedSignature = base64UrlEncode(signature)\n\n  return `${unsignedToken}.${encodedSignature}`\n}\n\nasync function authenticate(auth: MscAuthConfig): Promise<string> {\n  return withCarrierApiSpan(\n    { carrierCode: 'msc', operation: 'authenticate' },\n    async (span) => {\n      const jwt = createMscJwt(auth)\n\n      const body = new URLSearchParams({\n        client_id: auth.clientId,\n        client_assertion: jwt,\n        client_assertion_type: 'urn:ietf:params:oauth:client-assertion-type:jwt-bearer',\n        scope: auth.scope,\n        grant_type: 'client_credentials',\n      })\n\n      const response = await fetch(auth.tokenUrl, {\n        method: 'POST',\n        headers: {\n          'Authorization': `Bearer ${jwt}`,\n          'Content-Type': 'application/x-www-form-urlencoded',\n        },\n        body: body.toString(),\n      })\n\n      span.setAttribute('http.status_code', response.status)\n\n      if (!response.ok) {\n        const errorText = await response.text().catch(() => 'unknown')\n        throw new Error(`MSC token request failed (${response.status}): ${errorText}`)\n      }\n\n      const data = await response.json() as { access_token: string }\n      return data.access_token\n    },\n  )\n}\n\nexport class MscAdapter implements CarrierAdapter {\n  readonly carrierCode = 'msc'\n  readonly supportedReferenceTypes: TrackingReferenceType[] = ['container', 'booking', 'bol']\n\n  async fetchEvents(input: {\n    referenceType: TrackingReferenceType\n    referenceValue: string\n    apiEndpoint?: string | null\n    authConfig?: Record<string, unknown> | null\n  }): Promise<CarrierFetchResult> {\n    return withCarrierApiSpan(\n      {\n        carrierCode: this.carrierCode,\n        operation: 'fetchEvents',\n        referenceType: input.referenceType,\n        referenceValue: input.referenceValue,\n      },\n      async (span) => {\n        const auth = getAuth(input.authConfig)\n        const token = await authenticate(auth)\n        const params = buildDcsaQueryParams(input.referenceValue, input.referenceType)\n        const url = `${input.apiEndpoint || EVENTS_URL}?${params}`\n\n        const response = await fetch(url, {\n          headers: {\n            'Authorization': `Bearer ${token}`,\n            'Content-Type': 'application/json',\n          },\n        })\n\n        span.setAttribute('http.status_code', response.status)\n\n        if (!response.ok) {\n          const errorText = await response.text().catch(() => 'unknown')\n          throw new Error(`MSC API error (${response.status}): ${errorText}`)\n        }\n\n        const data = await response.json()\n        const events = parseDcsaEvents(data, 'MSC')\n\n        const { bookingNumber, bolNumber } = extractDocumentReferences(events)\n\n        span.setAttribute('events.count', events.length)\n        return { events, bookingNumber, bolNumber }\n      },\n    )\n  }\n\n  async testConnection(input: {\n    apiEndpoint?: string | null\n    authConfig?: Record<string, unknown> | null\n  }): Promise<CarrierAdapterTestResult> {\n    const start = Date.now()\n    try {\n      const auth = getAuth(input.authConfig)\n      await authenticate(auth)\n      return { success: true, message: 'MSC authentication successful', latencyMs: Date.now() - start }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error'\n      return { success: false, message: `MSC connection failed: ${message}`, latencyMs: Date.now() - start }\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/adapters/zim.js

@@ -0,0 +1,85 @@
+import { extractDocumentReferences } from "../carrier-adapter.js";
+import { fetchOAuthToken } from "../auth/oauth-client.js";
+import { buildDcsaQueryParams } from "../dcsa-params.js";
+import { parseDcsaEvents } from "../dcsa-event-parser.js";
+import { withCarrierApiSpan } from "../logger.js";
+const TOKEN_URL = "https://apigw.zim.com/authorize/v1";
+const EVENTS_URL = "https://apigw.zim.com/trackAndTrace/v1";
+function getAuth(authConfig) {
+  const clientId = authConfig?.client_id;
+  const clientSecret = authConfig?.client_secret;
+  const subscriptionKey = authConfig?.subscription_key;
+  if (!clientId || !clientSecret || !subscriptionKey) {
+    throw new Error("ZIM authConfig requires client_id, client_secret, and subscription_key");
+  }
+  return { client_id: clientId, client_secret: clientSecret, subscription_key: subscriptionKey };
+}
+async function authenticate(auth) {
+  return withCarrierApiSpan(
+    { carrierCode: "zim", operation: "authenticate" },
+    async (span) => {
+      const token = await fetchOAuthToken({
+        tokenUrl: TOKEN_URL,
+        clientId: auth.client_id,
+        clientSecret: auth.client_secret,
+        authMethod: "body",
+        extraBody: { scope: "tracing" }
+      });
+      return token;
+    }
+  );
+}
+class ZimAdapter {
+  constructor() {
+    this.carrierCode = "zim";
+    this.supportedReferenceTypes = ["container", "booking", "bol"];
+  }
+  async fetchEvents(input) {
+    return withCarrierApiSpan(
+      {
+        carrierCode: this.carrierCode,
+        operation: "fetchEvents",
+        referenceType: input.referenceType,
+        referenceValue: input.referenceValue
+      },
+      async (span) => {
+        const auth = getAuth(input.authConfig);
+        const token = await authenticate(auth);
+        const params = buildDcsaQueryParams(input.referenceValue, input.referenceType);
+        const url = `${input.apiEndpoint || EVENTS_URL}?${params}`;
+        const response = await fetch(url, {
+          headers: {
+            "Authorization": `Bearer ${token}`,
+            "Ocp-Apim-Subscription-Key": auth.subscription_key,
+            "Content-Type": "application/json"
+          }
+        });
+        span.setAttribute("http.status_code", response.status);
+        if (!response.ok) {
+          const errorText = await response.text().catch(() => "unknown");
+          throw new Error(`ZIM API error (${response.status}): ${errorText}`);
+        }
+        const data = await response.json();
+        const events = parseDcsaEvents(data, "ZIM");
+        const { bookingNumber, bolNumber } = extractDocumentReferences(events);
+        span.setAttribute("events.count", events.length);
+        return { events, bookingNumber, bolNumber };
+      }
+    );
+  }
+  async testConnection(input) {
+    const start = Date.now();
+    try {
+      const auth = getAuth(input.authConfig);
+      await authenticate(auth);
+      return { success: true, message: "ZIM authentication successful", latencyMs: Date.now() - start };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      return { success: false, message: `ZIM connection failed: ${message}`, latencyMs: Date.now() - start };
+    }
+  }
+}
+export {
+  ZimAdapter
+};
+//# sourceMappingURL=zim.js.map

package/dist/modules/shipment_tracking/lib/adapters/zim.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/shipment_tracking/lib/adapters/zim.ts"],
+  "sourcesContent": ["import type { CarrierAdapter, CarrierFetchResult, CarrierAdapterTestResult } from '../carrier-adapter'\nimport { extractDocumentReferences } from '../carrier-adapter'\nimport type { TrackingReferenceType } from '../../data/entities'\nimport { fetchOAuthToken } from '../auth/oauth-client'\nimport { buildDcsaQueryParams } from '../dcsa-params'\nimport { parseDcsaEvents } from '../dcsa-event-parser'\nimport { withCarrierApiSpan } from '../logger'\n\nconst TOKEN_URL = 'https://apigw.zim.com/authorize/v1'\nconst EVENTS_URL = 'https://apigw.zim.com/trackAndTrace/v1'\n\ntype ZimAuthConfig = {\n  client_id: string\n  client_secret: string\n  subscription_key: string\n}\n\nfunction getAuth(authConfig: Record<string, unknown> | null | undefined): ZimAuthConfig {\n  const clientId = authConfig?.client_id as string | undefined\n  const clientSecret = authConfig?.client_secret as string | undefined\n  const subscriptionKey = authConfig?.subscription_key as string | undefined\n  if (!clientId || !clientSecret || !subscriptionKey) {\n    throw new Error('ZIM authConfig requires client_id, client_secret, and subscription_key')\n  }\n  return { client_id: clientId, client_secret: clientSecret, subscription_key: subscriptionKey }\n}\n\nasync function authenticate(auth: ZimAuthConfig): Promise<string> {\n  return withCarrierApiSpan(\n    { carrierCode: 'zim', operation: 'authenticate' },\n    async (span) => {\n      const token = await fetchOAuthToken({\n        tokenUrl: TOKEN_URL,\n        clientId: auth.client_id,\n        clientSecret: auth.client_secret,\n        authMethod: 'body',\n        extraBody: { scope: 'tracing' },\n      })\n      return token\n    },\n  )\n}\n\nexport class ZimAdapter implements CarrierAdapter {\n  readonly carrierCode = 'zim'\n  readonly supportedReferenceTypes: TrackingReferenceType[] = ['container', 'booking', 'bol']\n\n  async fetchEvents(input: {\n    referenceType: TrackingReferenceType\n    referenceValue: string\n    apiEndpoint?: string | null\n    authConfig?: Record<string, unknown> | null\n  }): Promise<CarrierFetchResult> {\n    return withCarrierApiSpan(\n      {\n        carrierCode: this.carrierCode,\n        operation: 'fetchEvents',\n        referenceType: input.referenceType,\n        referenceValue: input.referenceValue,\n      },\n      async (span) => {\n        const auth = getAuth(input.authConfig)\n        const token = await authenticate(auth)\n        const params = buildDcsaQueryParams(input.referenceValue, input.referenceType)\n        const url = `${input.apiEndpoint || EVENTS_URL}?${params}`\n\n        const response = await fetch(url, {\n          headers: {\n            'Authorization': `Bearer ${token}`,\n            'Ocp-Apim-Subscription-Key': auth.subscription_key,\n            'Content-Type': 'application/json',\n          },\n        })\n\n        span.setAttribute('http.status_code', response.status)\n\n        if (!response.ok) {\n          const errorText = await response.text().catch(() => 'unknown')\n          throw new Error(`ZIM API error (${response.status}): ${errorText}`)\n        }\n\n        const data = await response.json()\n        const events = parseDcsaEvents(data, 'ZIM')\n        const { bookingNumber, bolNumber } = extractDocumentReferences(events)\n\n        span.setAttribute('events.count', events.length)\n        return { events, bookingNumber, bolNumber }\n      },\n    )\n  }\n\n  async testConnection(input: {\n    apiEndpoint?: string | null\n    authConfig?: Record<string, unknown> | null\n  }): Promise<CarrierAdapterTestResult> {\n    const start = Date.now()\n    try {\n      const auth = getAuth(input.authConfig)\n      await authenticate(auth)\n      return { success: true, message: 'ZIM authentication successful', latencyMs: Date.now() - start }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error'\n      return { success: false, message: `ZIM connection failed: ${message}`, latencyMs: Date.now() - start }\n    }\n  }\n}\n"],
+  "mappings": "AACA,SAAS,iCAAiC;AAE1C,SAAS,uBAAuB;AAChC,SAAS,4BAA4B;AACrC,SAAS,uBAAuB;AAChC,SAAS,0BAA0B;AAEnC,MAAM,YAAY;AAClB,MAAM,aAAa;AAQnB,SAAS,QAAQ,YAAuE;AACtF,QAAM,WAAW,YAAY;AAC7B,QAAM,eAAe,YAAY;AACjC,QAAM,kBAAkB,YAAY;AACpC,MAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,iBAAiB;AAClD,UAAM,IAAI,MAAM,wEAAwE;AAAA,EAC1F;AACA,SAAO,EAAE,WAAW,UAAU,eAAe,cAAc,kBAAkB,gBAAgB;AAC/F;AAEA,eAAe,aAAa,MAAsC;AAChE,SAAO;AAAA,IACL,EAAE,aAAa,OAAO,WAAW,eAAe;AAAA,IAChD,OAAO,SAAS;AACd,YAAM,QAAQ,MAAM,gBAAgB;AAAA,QAClC,UAAU;AAAA,QACV,UAAU,KAAK;AAAA,QACf,cAAc,KAAK;AAAA,QACnB,YAAY;AAAA,QACZ,WAAW,EAAE,OAAO,UAAU;AAAA,MAChC,CAAC;AACD,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAEO,MAAM,WAAqC;AAAA,EAA3C;AACL,SAAS,cAAc;AACvB,SAAS,0BAAmD,CAAC,aAAa,WAAW,KAAK;AAAA;AAAA,EAE1F,MAAM,YAAY,OAKc;AAC9B,WAAO;AAAA,MACL;AAAA,QACE,aAAa,KAAK;AAAA,QAClB,WAAW;AAAA,QACX,eAAe,MAAM;AAAA,QACrB,gBAAgB,MAAM;AAAA,MACxB;AAAA,MACA,OAAO,SAAS;AACd,cAAM,OAAO,QAAQ,MAAM,UAAU;AACrC,cAAM,QAAQ,MAAM,aAAa,IAAI;AACrC,cAAM,SAAS,qBAAqB,MAAM,gBAAgB,MAAM,aAAa;AAC7E,cAAM,MAAM,GAAG,MAAM,eAAe,UAAU,IAAI,MAAM;AAExD,cAAM,WAAW,MAAM,MAAM,KAAK;AAAA,UAChC,SAAS;AAAA,YACP,iBAAiB,UAAU,KAAK;AAAA,YAChC,6BAA6B,KAAK;AAAA,YAClC,gBAAgB;AAAA,UAClB;AAAA,QACF,CAAC;AAED,aAAK,aAAa,oBAAoB,SAAS,MAAM;AAErD,YAAI,CAAC,SAAS,IAAI;AAChB,gBAAM,YAAY,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,SAAS;AAC7D,gBAAM,IAAI,MAAM,kBAAkB,SAAS,MAAM,MAAM,SAAS,EAAE;AAAA,QACpE;AAEA,cAAM,OAAO,MAAM,SAAS,KAAK;AACjC,cAAM,SAAS,gBAAgB,MAAM,KAAK;AAC1C,cAAM,EAAE,eAAe,UAAU,IAAI,0BAA0B,MAAM;AAErE,aAAK,aAAa,gBAAgB,OAAO,MAAM;AAC/C,eAAO,EAAE,QAAQ,eAAe,UAAU;AAAA,MAC5C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,eAAe,OAGiB;AACpC,UAAM,QAAQ,KAAK,IAAI;AACvB,QAAI;AACF,YAAM,OAAO,QAAQ,MAAM,UAAU;AACrC,YAAM,aAAa,IAAI;AACvB,aAAO,EAAE,SAAS,MAAM,SAAS,iCAAiC,WAAW,KAAK,IAAI,IAAI,MAAM;AAAA,IAClG,SAAS,OAAO;AACd,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AACzD,aAAO,EAAE,SAAS,OAAO,SAAS,0BAA0B,OAAO,IAAI,WAAW,KAAK,IAAI,IAAI,MAAM;AAAA,IACvG;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/audit-helpers.js

@@ -0,0 +1,20 @@
+import { ActionLog } from "@open-mercato/core/modules/audit_logs/data/entities";
+async function getTrackingJobCreator(em, trackingJobId, tenantId) {
+  const createLog = await em.findOne(
+    ActionLog,
+    {
+      tenantId,
+      resourceKind: "shipment_tracking.tracking_job",
+      resourceId: trackingJobId,
+      commandId: "shipment_tracking.tracking_job.create",
+      executionState: "done",
+      deletedAt: null
+    },
+    { orderBy: { createdAt: "asc" } }
+  );
+  return createLog?.actorUserId ?? null;
+}
+export {
+  getTrackingJobCreator
+};
+//# sourceMappingURL=audit-helpers.js.map

package/dist/modules/shipment_tracking/lib/audit-helpers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/audit-helpers.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { ActionLog } from '@open-mercato/core/modules/audit_logs/data/entities'\n\n/**\n * Get the user ID of who created a tracking job by querying audit logs.\n *\n * This is used for notifications where we need to notify the user who created\n * the tracking job, but the TrackingJob entity doesn't store createdByUserId.\n */\nexport async function getTrackingJobCreator(\n  em: EntityManager,\n  trackingJobId: string,\n  tenantId: string,\n): Promise<string | null> {\n  const createLog = await em.findOne(\n    ActionLog,\n    {\n      tenantId,\n      resourceKind: 'shipment_tracking.tracking_job',\n      resourceId: trackingJobId,\n      commandId: 'shipment_tracking.tracking_job.create',\n      executionState: 'done',\n      deletedAt: null,\n    },\n    { orderBy: { createdAt: 'asc' } },\n  )\n\n  return createLog?.actorUserId ?? null\n}\n"],
+  "mappings": "AACA,SAAS,iBAAiB;AAQ1B,eAAsB,sBACpB,IACA,eACA,UACwB;AACxB,QAAM,YAAY,MAAM,GAAG;AAAA,IACzB;AAAA,IACA;AAAA,MACE;AAAA,MACA,cAAc;AAAA,MACd,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,gBAAgB;AAAA,MAChB,WAAW;AAAA,IACb;AAAA,IACA,EAAE,SAAS,EAAE,WAAW,MAAM,EAAE;AAAA,EAClC;AAEA,SAAO,WAAW,eAAe;AACnC;",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/auth/base64url.js

@@ -0,0 +1,8 @@
+function base64UrlEncode(data) {
+  const buffer = Buffer.isBuffer(data) ? data : Buffer.from(data);
+  return buffer.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+export {
+  base64UrlEncode
+};
+//# sourceMappingURL=base64url.js.map

package/dist/modules/shipment_tracking/lib/auth/base64url.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/shipment_tracking/lib/auth/base64url.ts"],
+  "sourcesContent": ["export function base64UrlEncode(data: string | Buffer): string {\n  const buffer = Buffer.isBuffer(data) ? data : Buffer.from(data)\n  return buffer.toString('base64').replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '')\n}\n"],
+  "mappings": "AAAO,SAAS,gBAAgB,MAA+B;AAC7D,QAAM,SAAS,OAAO,SAAS,IAAI,IAAI,OAAO,OAAO,KAAK,IAAI;AAC9D,SAAO,OAAO,SAAS,QAAQ,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,MAAM,EAAE;AAC3F;",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/auth/oauth-client.js

@@ -0,0 +1,38 @@
+async function fetchOAuthToken(config) {
+  const { tokenUrl, clientId, clientSecret, scope, extraHeaders, extraBody, authMethod = "body" } = config;
+  const body = new URLSearchParams({ grant_type: "client_credentials" });
+  if (authMethod === "body") {
+    body.set("client_id", clientId);
+    body.set("client_secret", clientSecret);
+  }
+  if (scope) {
+    body.set("scope", scope);
+  }
+  if (extraBody) {
+    for (const [key, value] of Object.entries(extraBody)) {
+      body.set(key, value);
+    }
+  }
+  const headers = {
+    "Content-Type": "application/x-www-form-urlencoded",
+    ...extraHeaders
+  };
+  if (authMethod === "basic") {
+    headers["Authorization"] = `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString("base64")}`;
+  }
+  const response = await fetch(tokenUrl, {
+    method: "POST",
+    headers,
+    body: body.toString()
+  });
+  if (!response.ok) {
+    const errorText = await response.text().catch(() => "unknown");
+    throw new Error(`OAuth token request failed (${response.status}): ${errorText}`);
+  }
+  const data = await response.json();
+  return data.access_token;
+}
+export {
+  fetchOAuthToken
+};
+//# sourceMappingURL=oauth-client.js.map

package/dist/modules/shipment_tracking/lib/auth/oauth-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/shipment_tracking/lib/auth/oauth-client.ts"],
+  "sourcesContent": ["type OAuthConfig = {\n  tokenUrl: string\n  clientId: string\n  clientSecret: string\n  scope?: string\n  extraHeaders?: Record<string, string>\n  extraBody?: Record<string, string>\n  authMethod?: 'body' | 'basic'\n}\n\nexport async function fetchOAuthToken(config: OAuthConfig): Promise<string> {\n  const { tokenUrl, clientId, clientSecret, scope, extraHeaders, extraBody, authMethod = 'body' } = config\n\n  const body = new URLSearchParams({ grant_type: 'client_credentials' })\n\n  if (authMethod === 'body') {\n    body.set('client_id', clientId)\n    body.set('client_secret', clientSecret)\n  }\n\n  if (scope) {\n    body.set('scope', scope)\n  }\n\n  if (extraBody) {\n    for (const [key, value] of Object.entries(extraBody)) {\n      body.set(key, value)\n    }\n  }\n\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/x-www-form-urlencoded',\n    ...extraHeaders,\n  }\n\n  if (authMethod === 'basic') {\n    headers['Authorization'] = `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString('base64')}`\n  }\n\n  const response = await fetch(tokenUrl, {\n    method: 'POST',\n    headers,\n    body: body.toString(),\n  })\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => 'unknown')\n    throw new Error(`OAuth token request failed (${response.status}): ${errorText}`)\n  }\n\n  const data = await response.json() as { access_token: string }\n  return data.access_token\n}\n"],
+  "mappings": "AAUA,eAAsB,gBAAgB,QAAsC;AAC1E,QAAM,EAAE,UAAU,UAAU,cAAc,OAAO,cAAc,WAAW,aAAa,OAAO,IAAI;AAElG,QAAM,OAAO,IAAI,gBAAgB,EAAE,YAAY,qBAAqB,CAAC;AAErE,MAAI,eAAe,QAAQ;AACzB,SAAK,IAAI,aAAa,QAAQ;AAC9B,SAAK,IAAI,iBAAiB,YAAY;AAAA,EACxC;AAEA,MAAI,OAAO;AACT,SAAK,IAAI,SAAS,KAAK;AAAA,EACzB;AAEA,MAAI,WAAW;AACb,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,GAAG;AACpD,WAAK,IAAI,KAAK,KAAK;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,UAAkC;AAAA,IACtC,gBAAgB;AAAA,IAChB,GAAG;AAAA,EACL;AAEA,MAAI,eAAe,SAAS;AAC1B,YAAQ,eAAe,IAAI,SAAS,OAAO,KAAK,GAAG,QAAQ,IAAI,YAAY,EAAE,EAAE,SAAS,QAAQ,CAAC;AAAA,EACnG;AAEA,QAAM,WAAW,MAAM,MAAM,UAAU;AAAA,IACrC,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,KAAK,SAAS;AAAA,EACtB,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,YAAY,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,SAAS;AAC7D,UAAM,IAAI,MAAM,+BAA+B,SAAS,MAAM,MAAM,SAAS,EAAE;AAAA,EACjF;AAEA,QAAM,OAAO,MAAM,SAAS,KAAK;AACjC,SAAO,KAAK;AACd;",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/background.js

@@ -0,0 +1,15 @@
+function runInBackground(fn, label) {
+  setImmediate(() => {
+    fn().catch((err) => {
+      console.error(`[background${label ? `:${label}` : ""}] Error:`, err);
+    });
+  });
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  runInBackground,
+  sleep
+};
+//# sourceMappingURL=background.js.map

package/dist/modules/shipment_tracking/lib/background.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/background.ts"],
+  "sourcesContent": ["/**\n * Runs a function in the background without blocking the caller.\n * Errors are logged but not propagated.\n *\n * Uses setImmediate to defer execution to the next event loop iteration,\n * allowing the caller to return immediately (non-blocking).\n *\n * @param fn - Async function to run in background\n * @param label - Optional label for error logging\n */\nexport function runInBackground(fn: () => Promise<void>, label?: string): void {\n  setImmediate(() => {\n    fn().catch((err) => {\n      console.error(`[background${label ? `:${label}` : ''}] Error:`, err)\n    })\n  })\n}\n\n/**\n * Sleep helper for retry delays\n */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n"],
+  "mappings": "AAUO,SAAS,gBAAgB,IAAyB,OAAsB;AAC7E,eAAa,MAAM;AACjB,OAAG,EAAE,MAAM,CAAC,QAAQ;AAClB,cAAQ,MAAM,cAAc,QAAQ,IAAI,KAAK,KAAK,EAAE,YAAY,GAAG;AAAA,IACrE,CAAC;AAAA,EACH,CAAC;AACH;AAKO,SAAS,MAAM,IAA2B;AAC/C,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/bic-api-client.js

@@ -0,0 +1,106 @@
+class BicApiClient {
+  constructor(config) {
+    this.accessToken = null;
+    this.tokenExpiresAt = null;
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.username = config.username;
+    this.password = config.password;
+  }
+  /**
+   * Get OAuth2 token via Basic Auth
+   */
+  async getToken() {
+    const now = /* @__PURE__ */ new Date();
+    if (this.accessToken && this.tokenExpiresAt && this.tokenExpiresAt > new Date(now.getTime() + 6e4)) {
+      return this.accessToken;
+    }
+    const credentials = Buffer.from(`${this.username}:${this.password}`).toString("base64");
+    const response = await fetch(`${this.baseUrl}/v2/oauth/token`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Basic ${credentials}`,
+        "Content-Type": "application/json"
+      }
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`BIC OAuth failed: ${response.status} - ${text}`);
+    }
+    const data = await response.json();
+    this.accessToken = data.accessToken || data.access_token;
+    this.tokenExpiresAt = new Date(data.accessTokenExpiresAt);
+    return this.accessToken;
+  }
+  /**
+   * Look up facility by code
+   * 
+   * @param facilityCode - The facility code (BIC: 9 chars, SMDG: varies)
+   * @param codeProvider - 'BIC' or 'SMDG'
+   * @param unlocode - Required for SMDG codes to build the full lookup code
+   * @returns Facility data or null if not found
+   */
+  async getFacility(facilityCode, codeProvider, unlocode) {
+    const token = await this.getToken();
+    const lookupCode = codeProvider === "SMDG" && unlocode ? `${unlocode}${facilityCode}` : facilityCode;
+    const url = `${this.baseUrl}/v2/facilities/${lookupCode}?codeProvider=${codeProvider}`;
+    const response = await fetch(url, {
+      headers: { "Authorization": `Bearer ${token}` }
+    });
+    if (response.status === 404) {
+      return null;
+    }
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`BIC API error: ${response.status} - ${text}`);
+    }
+    return response.json();
+  }
+  /**
+   * Test connection by fetching a token
+   * @returns true if authentication succeeds
+   */
+  async testConnection() {
+    await this.getToken();
+    return true;
+  }
+  // ─── Static Helpers ──────────────────────────────────────────
+  /**
+   * Parse coordinates from BIC response (strings to numbers)
+   */
+  static parseCoordinates(facility) {
+    const coords = facility.facility?.geographicalCoordinate;
+    if (!coords?.latitude || !coords?.longitude) return null;
+    const lat = parseFloat(coords.latitude);
+    const lng = parseFloat(coords.longitude);
+    if (isNaN(lat) || isNaN(lng)) return null;
+    return { latitude: lat, longitude: lng };
+  }
+  /**
+   * Format address from BIC response
+   */
+  static formatAddress(facility) {
+    if (facility.facility?.formattedAddress) {
+      return facility.facility.formattedAddress;
+    }
+    const addr = facility.facility?.address;
+    if (!addr) return null;
+    const parts = [addr.street, addr.city, addr.state, addr.postcode, addr.country];
+    return parts.filter(Boolean).join(", ") || null;
+  }
+  /**
+   * Get facility name from BIC response
+   */
+  static getFacilityName(facility) {
+    return facility.facility?.name || null;
+  }
+  /**
+   * Get operator name from BIC response
+   */
+  static getOperatorName(facility) {
+    return facility.operator?.name || null;
+  }
+}
+export {
+  BicApiClient
+};
+//# sourceMappingURL=bic-api-client.js.map

package/dist/modules/shipment_tracking/lib/bic-api-client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/bic-api-client.ts"],
+  "sourcesContent": ["/**\n * BIC Facility Code API v2 Client\n * \n * Provides facility enrichment data (coordinates, addresses, operator names)\n * from the BIC Facility Code Database.\n * \n * API Documentation: https://app.swaggerhub.com/apis/BIC-ORG/Facility-Codes/2.0.1\n */\n\n// \u2500\u2500\u2500 Types \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface BicTokenResponse {\n  accessToken: string\n  access_token: string  // Also provided for compatibility\n  accessTokenExpiresAt: string  // ISO datetime\n}\n\nexport interface BicAddress {\n  street?: string\n  city?: string\n  postcode?: string\n  state?: string\n  country?: string\n}\n\nexport interface BicCoordinates {\n  latitude: string   // Note: strings in BIC API, need to parse\n  longitude: string\n}\n\nexport interface BicFacilityDetails {\n  name: string\n  address?: BicAddress\n  formattedAddress?: string\n  geographicalCoordinate?: BicCoordinates\n}\n\nexport interface BicOperator {\n  name: string\n}\n\nexport interface BicFacility {\n  code: string\n  codeProvider: 'BIC' | 'SMDG'\n  countryCode: string\n  unLocode: string\n  aliasCode?: string  // If this code is deprecated\n  codeListProviderCode?: string  // Short code for SMDG\n  operator?: BicOperator\n  facility?: BicFacilityDetails\n}\n\nexport interface BicClientConfig {\n  baseUrl: string\n  username: string\n  password: string\n}\n\n// \u2500\u2500\u2500 Client \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport class BicApiClient {\n  private baseUrl: string\n  private username: string\n  private password: string\n  private accessToken: string | null = null\n  private tokenExpiresAt: Date | null = null\n\n  constructor(config: BicClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, '')  // Remove trailing slash\n    this.username = config.username\n    this.password = config.password\n  }\n\n  /**\n   * Get OAuth2 token via Basic Auth\n   */\n  private async getToken(): Promise<string> {\n    const now = new Date()\n    // Refresh if token expires in less than 60 seconds\n    if (this.accessToken && this.tokenExpiresAt && this.tokenExpiresAt > new Date(now.getTime() + 60_000)) {\n      return this.accessToken\n    }\n\n    const credentials = Buffer.from(`${this.username}:${this.password}`).toString('base64')\n\n    const response = await fetch(`${this.baseUrl}/v2/oauth/token`, {\n      method: 'POST',\n      headers: {\n        'Authorization': `Basic ${credentials}`,\n        'Content-Type': 'application/json',\n      },\n    })\n\n    if (!response.ok) {\n      const text = await response.text()\n      throw new Error(`BIC OAuth failed: ${response.status} - ${text}`)\n    }\n\n    const data: BicTokenResponse = await response.json()\n    this.accessToken = data.accessToken || data.access_token\n    this.tokenExpiresAt = new Date(data.accessTokenExpiresAt)\n    return this.accessToken\n  }\n\n  /**\n   * Look up facility by code\n   * \n   * @param facilityCode - The facility code (BIC: 9 chars, SMDG: varies)\n   * @param codeProvider - 'BIC' or 'SMDG'\n   * @param unlocode - Required for SMDG codes to build the full lookup code\n   * @returns Facility data or null if not found\n   */\n  async getFacility(\n    facilityCode: string,\n    codeProvider: 'BIC' | 'SMDG',\n    unlocode?: string\n  ): Promise<BicFacility | null> {\n    const token = await this.getToken()\n\n    // Build lookup code:\n    // - BIC codes are already complete (9 chars)\n    // - SMDG codes need unlocode prefix (e.g., \"PLGDY\" + \"DCT\" = \"PLGDYDCT\")\n    const lookupCode = codeProvider === 'SMDG' && unlocode\n      ? `${unlocode}${facilityCode}`\n      : facilityCode\n\n    const url = `${this.baseUrl}/v2/facilities/${lookupCode}?codeProvider=${codeProvider}`\n\n    const response = await fetch(url, {\n      headers: { 'Authorization': `Bearer ${token}` },\n    })\n\n    if (response.status === 404) {\n      return null\n    }\n\n    if (!response.ok) {\n      const text = await response.text()\n      throw new Error(`BIC API error: ${response.status} - ${text}`)\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Test connection by fetching a token\n   * @returns true if authentication succeeds\n   */\n  async testConnection(): Promise<boolean> {\n    await this.getToken()\n    return true\n  }\n\n  // \u2500\u2500\u2500 Static Helpers \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  /**\n   * Parse coordinates from BIC response (strings to numbers)\n   */\n  static parseCoordinates(facility: BicFacility): { latitude: number; longitude: number } | null {\n    const coords = facility.facility?.geographicalCoordinate\n    if (!coords?.latitude || !coords?.longitude) return null\n\n    const lat = parseFloat(coords.latitude)\n    const lng = parseFloat(coords.longitude)\n\n    if (isNaN(lat) || isNaN(lng)) return null\n    return { latitude: lat, longitude: lng }\n  }\n\n  /**\n   * Format address from BIC response\n   */\n  static formatAddress(facility: BicFacility): string | null {\n    // Prefer formatted address if available\n    if (facility.facility?.formattedAddress) {\n      return facility.facility.formattedAddress\n    }\n\n    const addr = facility.facility?.address\n    if (!addr) return null\n\n    const parts = [addr.street, addr.city, addr.state, addr.postcode, addr.country]\n    return parts.filter(Boolean).join(', ') || null\n  }\n\n  /**\n   * Get facility name from BIC response\n   */\n  static getFacilityName(facility: BicFacility): string | null {\n    return facility.facility?.name || null\n  }\n\n  /**\n   * Get operator name from BIC response\n   */\n  static getOperatorName(facility: BicFacility): string | null {\n    return facility.operator?.name || null\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/carrier-adapter.js

@@ -0,0 +1,17 @@
+function extractDocumentReferences(events) {
+  let bookingNumber = null;
+  let bolNumber = null;
+  for (const event of events) {
+    if (!event.relatedDocumentReferences) continue;
+    for (const ref of event.relatedDocumentReferences) {
+      if (!bookingNumber && ref.type === "BKG" && ref.value) bookingNumber = ref.value;
+      if (!bolNumber && (ref.type === "TRD" || ref.type === "SHI") && ref.value) bolNumber = ref.value;
+      if (bookingNumber && bolNumber) return { bookingNumber, bolNumber };
+    }
+  }
+  return { bookingNumber, bolNumber };
+}
+export {
+  extractDocumentReferences
+};
+//# sourceMappingURL=carrier-adapter.js.map

package/dist/modules/shipment_tracking/lib/carrier-adapter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/carrier-adapter.ts"],
+  "sourcesContent": ["import type { TrackingEventType, TrackingEventClassifierCode, TrackingEventSource, TrackingReferenceType } from '../data/entities'\nimport type { SealInfo } from './route-extraction'\n\nexport type { SealInfo } from './route-extraction'\n\nexport type DocumentReference = {\n  type: string // BKG, TRD, SHI, CBR, ARN, VGM, etc.\n  value: string\n}\n\nexport type CarrierFetchedEvent = {\n  // \u2500\u2500\u2500 Event Source \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  source: TrackingEventSource\n  sourceEventId: string // Original ID from the source system (e.g., DCSA eventId)\n\n  // \u2500\u2500\u2500 Core Event Fields \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  eventType: TrackingEventType\n  eventCode: string\n  eventClassifierCode?: TrackingEventClassifierCode | null\n  eventDateTime: Date\n  eventDateTimeOffset?: string | null\n  description?: string | null\n  rawData?: Record<string, unknown> | null\n\n  // \u2500\u2500\u2500 Equipment Fields (DCSA EQUIPMENT events) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  equipmentReference?: string | null // Container number (BIC ISO)\n  isoEquipmentCode?: string | null // Container type (22G1, 45R1, etc.)\n  emptyIndicatorCode?: 'EMPTY' | 'LADEN' | null\n  isTransshipmentMove?: boolean | null\n\n  // \u2500\u2500\u2500 Location Fields \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  locationName?: string | null\n  locationUnlocode?: string | null\n  locationCountry?: string | null\n  facilityCode?: string | null // Terminal/depot code (SMDG/BIC)\n  facilityCodeListProvider?: 'SMDG' | 'BIC' | null\n  facilityTypeCode?: string | null // POTE, DEPO, CLOC, COFS, etc.\n  facilityAddress?: string | null // Full address string (from DCSA otherFacility)\n  latitude?: number | null\n  longitude?: number | null\n\n  // \u2500\u2500\u2500 Transport Call Fields \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  transportCallReference?: string | null\n  modeOfTransport?: 'VESSEL' | 'RAIL' | 'TRUCK' | 'BARGE' | 'AIR' | null\n  vesselName?: string | null\n  vesselImo?: string | null\n  voyageNumber?: string | null\n  carrierServiceCode?: string | null\n  carrierExportVoyageNumber?: string | null\n  carrierImportVoyageNumber?: string | null\n  universalServiceReference?: string | null\n  universalExportVoyageReference?: string | null\n  universalImportVoyageReference?: string | null\n  portVisitReference?: string | null\n\n  // \u2500\u2500\u2500 Document References \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  relatedDocumentReferences?: DocumentReference[] | null\n\n  // \u2500\u2500\u2500 Metadata Fields \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  eventCreatedDateTime?: Date | null\n  retractedEventId?: string | null\n  publisherName?: string | null\n  publisherRole?: string | null // CA, AG, VSL, TR, etc.\n\n  // \u2500\u2500\u2500 Additional Event Fields \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\u2500\u2500\u2500\u2500\u2500\n  delayReasonCode?: string | null // SMDG delay reason code\n  changeRemark?: string | null\n  seals?: SealInfo[] | null\n}\n\nexport type CarrierAdapterTestResult = {\n  success: boolean\n  message: string\n  latencyMs?: number\n}\n\nexport type CarrierFetchResult = {\n  events: CarrierFetchedEvent[]\n  containerNumber?: string | null\n  bookingNumber?: string | null\n  bolNumber?: string | null\n  vesselName?: string | null\n  vesselImo?: string | null\n  // \u2500\u2500\u2500 Air (mode='air') \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Air shipments have no container/vessel; identity is the AWB + flight/airline.\n  awbNumber?: string | null\n  flightNumber?: string | null\n  airlineCode?: string | null\n  airlineName?: string | null\n  /** ShipsGo top-level air status (NEW/BOOKED/EN_ROUTE/LANDED/DELIVERED/\u2026). */\n  airStatus?: string | null\n  /**\n   * Provider shipment-level metadata that has no dedicated column \u2014 merged into\n   * `Shipment.extra`. Ocean: ShipsGo route summary (POL/POD + dates, transit\n   * time, CO2, transshipments). Air: cargo (pieces/weight/volume) + status_extended.\n   */\n  extra?: Record<string, unknown> | null\n}\n\n/**\n * Extracts booking and BOL numbers from DCSA document references across all events.\n * BKG = Booking reference, TRD/SHI = Transport Document / Shipping Instruction (BOL).\n */\nexport function extractDocumentReferences(events: CarrierFetchedEvent[]): {\n  bookingNumber: string | null\n  bolNumber: string | null\n} {\n  let bookingNumber: string | null = null\n  let bolNumber: string | null = null\n  for (const event of events) {\n    if (!event.relatedDocumentReferences) continue\n    for (const ref of event.relatedDocumentReferences) {\n      if (!bookingNumber && ref.type === 'BKG' && ref.value) bookingNumber = ref.value\n      if (!bolNumber && (ref.type === 'TRD' || ref.type === 'SHI') && ref.value) bolNumber = ref.value\n      if (bookingNumber && bolNumber) return { bookingNumber, bolNumber }\n    }\n  }\n  return { bookingNumber, bolNumber }\n}\n\nexport interface CarrierAdapter {\n  readonly carrierCode: string\n  readonly supportedReferenceTypes: TrackingReferenceType[]\n\n  fetchEvents(input: {\n    referenceType: TrackingReferenceType\n    referenceValue: string\n    apiEndpoint?: string | null\n    authConfig?: Record<string, unknown> | null\n  }): Promise<CarrierFetchResult>\n\n  testConnection(input: {\n    apiEndpoint?: string | null\n    authConfig?: Record<string, unknown> | null\n  }): Promise<CarrierAdapterTestResult>\n}\n"],
+  "mappings": "AAuGO,SAAS,0BAA0B,QAGxC;AACA,MAAI,gBAA+B;AACnC,MAAI,YAA2B;AAC/B,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,MAAM,0BAA2B;AACtC,eAAW,OAAO,MAAM,2BAA2B;AACjD,UAAI,CAAC,iBAAiB,IAAI,SAAS,SAAS,IAAI,MAAO,iBAAgB,IAAI;AAC3E,UAAI,CAAC,cAAc,IAAI,SAAS,SAAS,IAAI,SAAS,UAAU,IAAI,MAAO,aAAY,IAAI;AAC3F,UAAI,iBAAiB,UAAW,QAAO,EAAE,eAAe,UAAU;AAAA,IACpE;AAAA,EACF;AACA,SAAO,EAAE,eAAe,UAAU;AACpC;",
+  "names": []
+}