@freighttech/shipment-tracking 0.6.0

package/dist/modules/shipment_tracking/lib/timestamp-utils.js

@@ -0,0 +1,100 @@
+function getLatestTimestamp(entries) {
+  if (!entries?.length) return null;
+  const latest = entries.reduce(
+    (best, entry) => entry.updatedAt >= best.updatedAt ? entry : best
+  );
+  return {
+    value: new Date(latest.value),
+    offset: latest.offset,
+    source: latest.source,
+    updatedAt: new Date(latest.updatedAt),
+    sourceEventId: latest.sourceEventId
+  };
+}
+function getPrimaryTimestampValue(entries) {
+  return getLatestTimestamp(entries)?.value ?? null;
+}
+function getPrimaryTimestampOffset(entries) {
+  return getLatestTimestamp(entries)?.offset ?? null;
+}
+function createTimestampEntry(value, offset, source, sourceEventId) {
+  const dateValue = typeof value === "string" ? new Date(value) : value;
+  return {
+    value: dateValue.toISOString(),
+    offset,
+    source,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    sourceEventId: sourceEventId ?? null
+  };
+}
+function addTimestampEntry(entries, newEntry) {
+  const result = entries ? [...entries] : [];
+  const isDuplicate = result.some(
+    (e) => e.value === newEntry.value && e.source === newEntry.source
+  );
+  if (!isDuplicate) {
+    result.push(newEntry);
+  }
+  return result;
+}
+function mergeExtractedTimestamps(current, extracted, source, sourceEventId) {
+  let changed = false;
+  let etdTimestamps = current.etdTimestamps ?? null;
+  let etaTimestamps = current.etaTimestamps ?? null;
+  let atdTimestamps = current.atdTimestamps ?? null;
+  let ataTimestamps = current.ataTimestamps ?? null;
+  if (extracted.etd) {
+    const entry = createTimestampEntry(extracted.etd, extracted.etdOffset ?? null, source, sourceEventId);
+    const before = etdTimestamps?.length ?? 0;
+    etdTimestamps = addTimestampEntry(etdTimestamps, entry);
+    if ((etdTimestamps?.length ?? 0) > before) changed = true;
+  }
+  if (extracted.eta) {
+    const entry = createTimestampEntry(extracted.eta, extracted.etaOffset ?? null, source, sourceEventId);
+    const before = etaTimestamps?.length ?? 0;
+    etaTimestamps = addTimestampEntry(etaTimestamps, entry);
+    if ((etaTimestamps?.length ?? 0) > before) changed = true;
+  }
+  if (extracted.atd) {
+    const entry = createTimestampEntry(extracted.atd, extracted.atdOffset ?? null, source, sourceEventId);
+    const before = atdTimestamps?.length ?? 0;
+    atdTimestamps = addTimestampEntry(atdTimestamps, entry);
+    if ((atdTimestamps?.length ?? 0) > before) changed = true;
+  }
+  if (extracted.ata) {
+    const entry = createTimestampEntry(extracted.ata, extracted.ataOffset ?? null, source, sourceEventId);
+    const before = ataTimestamps?.length ?? 0;
+    ataTimestamps = addTimestampEntry(ataTimestamps, entry);
+    if ((ataTimestamps?.length ?? 0) > before) changed = true;
+  }
+  return {
+    etdTimestamps,
+    etaTimestamps,
+    atdTimestamps,
+    ataTimestamps,
+    changed
+  };
+}
+function hasTimestamps(entries) {
+  return !!entries && entries.length > 0;
+}
+function getTimestampsBySource(entries, source) {
+  if (!entries) return [];
+  return entries.filter((e) => e.source === source);
+}
+function getTimestampHistory(entries) {
+  if (!entries) return [];
+  return [...entries].sort((a, b) => a.updatedAt.localeCompare(b.updatedAt));
+}
+export {
+  addTimestampEntry,
+  createTimestampEntry,
+  getLatestTimestamp,
+  getPrimaryTimestampOffset,
+  getPrimaryTimestampValue,
+  getTimestampHistory,
+  getTimestampsBySource,
+  hasTimestamps,
+  mergeExtractedTimestamps
+};
+//# sourceMappingURL=timestamp-utils.js.map

package/dist/modules/shipment_tracking/lib/timestamp-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/timestamp-utils.ts"],
+  "sourcesContent": ["/**\n * Multi-source timestamp utilities for shipment tracking.\n *\n * Supports tracking ETD/ETA/ATD/ATA from multiple sources with full history (SCD pattern).\n * Primary value is computed using \"latest update wins\" strategy.\n */\n\nexport type TimestampSource = 'carrier_api' | 'manual' | 'ais' | 'port' | 'edi'\n\nexport type TimestampType = 'ETD' | 'ETA' | 'ATD' | 'ATA'\n\n/**\n * A single timestamp entry tracking value, source, and when it was recorded.\n * Multiple entries per source are allowed (SCD - Slowly Changing Dimension pattern).\n */\nexport type ShipmentTimestampEntry = {\n  /** ISO 8601 datetime value (e.g., \"2026-02-24T15:30:00\") */\n  value: string\n  /** Original timezone offset (e.g., \"+08:00\", \"-05:00\", \"Z\") */\n  offset: string | null\n  /** Source system that provided this timestamp */\n  source: TimestampSource\n  /** When this entry was recorded/updated (ISO 8601) */\n  updatedAt: string\n  /** Optional reference to the source tracking event ID */\n  sourceEventId?: string | null\n}\n\n/**\n * Computed primary timestamp with its metadata.\n */\nexport type ComputedTimestamp = {\n  value: Date\n  offset: string | null\n  source: TimestampSource\n  updatedAt: Date\n  sourceEventId?: string | null\n}\n\n/**\n * Gets the latest (primary) timestamp from an array of entries.\n * Uses \"latest update wins\" strategy - the entry with most recent updatedAt is primary.\n *\n * @param entries Array of timestamp entries or null/undefined\n * @returns The latest entry or null if no entries\n */\nexport function getLatestTimestamp(\n  entries: ShipmentTimestampEntry[] | null | undefined,\n): ComputedTimestamp | null {\n  if (!entries?.length) return null\n\n  // Use >= to prefer later entries when updatedAt is equal.\n  // This handles the case where entries are added in the same millisecond.\n  const latest = entries.reduce((best, entry) =>\n    entry.updatedAt >= best.updatedAt ? entry : best,\n  )\n\n  return {\n    value: new Date(latest.value),\n    offset: latest.offset,\n    source: latest.source,\n    updatedAt: new Date(latest.updatedAt),\n    sourceEventId: latest.sourceEventId,\n  }\n}\n\n/**\n * Gets the primary value as a Date, or null if no entries.\n * Convenience wrapper around getLatestTimestamp.\n */\nexport function getPrimaryTimestampValue(\n  entries: ShipmentTimestampEntry[] | null | undefined,\n): Date | null {\n  return getLatestTimestamp(entries)?.value ?? null\n}\n\n/**\n * Gets the primary offset, or null if no entries.\n */\nexport function getPrimaryTimestampOffset(\n  entries: ShipmentTimestampEntry[] | null | undefined,\n): string | null {\n  return getLatestTimestamp(entries)?.offset ?? null\n}\n\n/**\n * Creates a new timestamp entry.\n *\n * @param value The timestamp value (Date or ISO string)\n * @param offset Timezone offset string (e.g., \"+08:00\") or null\n * @param source Source system\n * @param sourceEventId Optional source event ID for traceability\n * @returns A new ShipmentTimestampEntry\n */\nexport function createTimestampEntry(\n  value: Date | string,\n  offset: string | null,\n  source: TimestampSource,\n  sourceEventId?: string | null,\n): ShipmentTimestampEntry {\n  const dateValue = typeof value === 'string' ? new Date(value) : value\n\n  return {\n    value: dateValue.toISOString(),\n    offset,\n    source,\n    updatedAt: new Date().toISOString(),\n    sourceEventId: sourceEventId ?? null,\n  }\n}\n\n/**\n * Adds a timestamp entry to an array with time-based deduplication.\n * Deduplication: if an entry with the same value+source exists, it won't be added.\n * Multiple entries per source with different values ARE allowed (SCD pattern).\n *\n * @param entries Existing entries array (will be mutated) or null\n * @param newEntry Entry to add\n * @returns The updated array (creates new array if input was null)\n */\nexport function addTimestampEntry(\n  entries: ShipmentTimestampEntry[] | null | undefined,\n  newEntry: ShipmentTimestampEntry,\n): ShipmentTimestampEntry[] {\n  const result = entries ? [...entries] : []\n\n  // Dedupe: check if exact same value+source combo already exists\n  const isDuplicate = result.some(\n    (e) => e.value === newEntry.value && e.source === newEntry.source,\n  )\n\n  if (!isDuplicate) {\n    result.push(newEntry)\n  }\n\n  return result\n}\n\n/**\n * Merges extracted times into existing timestamp arrays.\n * Used when processing tracking events to update shipment timestamps.\n *\n * @param current Current timestamp arrays from shipment\n * @param extracted Newly extracted timestamps from events\n * @param source Source of the extracted timestamps\n * @param sourceEventId Optional source event ID\n * @returns Updated timestamp arrays\n */\nexport function mergeExtractedTimestamps(\n  current: {\n    etdTimestamps?: ShipmentTimestampEntry[] | null\n    etaTimestamps?: ShipmentTimestampEntry[] | null\n    atdTimestamps?: ShipmentTimestampEntry[] | null\n    ataTimestamps?: ShipmentTimestampEntry[] | null\n  },\n  extracted: {\n    etd?: Date | null\n    etdOffset?: string | null\n    eta?: Date | null\n    etaOffset?: string | null\n    atd?: Date | null\n    atdOffset?: string | null\n    ata?: Date | null\n    ataOffset?: string | null\n  },\n  source: TimestampSource,\n  sourceEventId?: string | null,\n): {\n  etdTimestamps: ShipmentTimestampEntry[] | null\n  etaTimestamps: ShipmentTimestampEntry[] | null\n  atdTimestamps: ShipmentTimestampEntry[] | null\n  ataTimestamps: ShipmentTimestampEntry[] | null\n  changed: boolean\n} {\n  let changed = false\n  let etdTimestamps = current.etdTimestamps ?? null\n  let etaTimestamps = current.etaTimestamps ?? null\n  let atdTimestamps = current.atdTimestamps ?? null\n  let ataTimestamps = current.ataTimestamps ?? null\n\n  if (extracted.etd) {\n    const entry = createTimestampEntry(extracted.etd, extracted.etdOffset ?? null, source, sourceEventId)\n    const before = etdTimestamps?.length ?? 0\n    etdTimestamps = addTimestampEntry(etdTimestamps, entry)\n    if ((etdTimestamps?.length ?? 0) > before) changed = true\n  }\n\n  if (extracted.eta) {\n    const entry = createTimestampEntry(extracted.eta, extracted.etaOffset ?? null, source, sourceEventId)\n    const before = etaTimestamps?.length ?? 0\n    etaTimestamps = addTimestampEntry(etaTimestamps, entry)\n    if ((etaTimestamps?.length ?? 0) > before) changed = true\n  }\n\n  if (extracted.atd) {\n    const entry = createTimestampEntry(extracted.atd, extracted.atdOffset ?? null, source, sourceEventId)\n    const before = atdTimestamps?.length ?? 0\n    atdTimestamps = addTimestampEntry(atdTimestamps, entry)\n    if ((atdTimestamps?.length ?? 0) > before) changed = true\n  }\n\n  if (extracted.ata) {\n    const entry = createTimestampEntry(extracted.ata, extracted.ataOffset ?? null, source, sourceEventId)\n    const before = ataTimestamps?.length ?? 0\n    ataTimestamps = addTimestampEntry(ataTimestamps, entry)\n    if ((ataTimestamps?.length ?? 0) > before) changed = true\n  }\n\n  return {\n    etdTimestamps,\n    etaTimestamps,\n    atdTimestamps,\n    ataTimestamps,\n    changed,\n  }\n}\n\n/**\n * Checks if a timestamp array has any entries.\n */\nexport function hasTimestamps(entries: ShipmentTimestampEntry[] | null | undefined): boolean {\n  return !!entries && entries.length > 0\n}\n\n/**\n * Gets all timestamps from a specific source.\n */\nexport function getTimestampsBySource(\n  entries: ShipmentTimestampEntry[] | null | undefined,\n  source: TimestampSource,\n): ShipmentTimestampEntry[] {\n  if (!entries) return []\n  return entries.filter((e) => e.source === source)\n}\n\n/**\n * Gets the history of timestamp changes, sorted by updatedAt (oldest first).\n */\nexport function getTimestampHistory(\n  entries: ShipmentTimestampEntry[] | null | undefined,\n): ShipmentTimestampEntry[] {\n  if (!entries) return []\n  return [...entries].sort((a, b) => a.updatedAt.localeCompare(b.updatedAt))\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/vessel-api.js

@@ -0,0 +1,111 @@
+function vesselApiBaseUrl() {
+  const baseUrl = process.env.NEXT_PUBLIC_VESSEL_API_URL || "";
+  if (!baseUrl) {
+    throw new Error(
+      "Vessel API is not configured \u2014 set NEXT_PUBLIC_VESSEL_API_URL to your vessel-tracking API base URL"
+    );
+  }
+  return baseUrl.replace(/\/+$/, "");
+}
+async function fetchVessel(imoOrMmsi) {
+  const id = typeof imoOrMmsi === "string" ? imoOrMmsi : String(imoOrMmsi);
+  try {
+    const response = await fetch(`${vesselApiBaseUrl()}/vessel/${encodeURIComponent(id)}`);
+    if (response.status === 404) {
+      return null;
+    }
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    return data.vessel;
+  } catch (error) {
+    console.error("[vessel-api] Failed to fetch vessel:", error);
+    throw error;
+  }
+}
+async function fetchVesselTrace(imoOrMmsi, bounds, limit, timeRange) {
+  const id = typeof imoOrMmsi === "string" ? imoOrMmsi : String(imoOrMmsi);
+  const params = new URLSearchParams();
+  if (bounds) {
+    params.set("north", String(bounds.north));
+    params.set("south", String(bounds.south));
+    params.set("east", String(bounds.east));
+    params.set("west", String(bounds.west));
+  }
+  if (limit) {
+    params.set("limit", String(limit));
+  }
+  if (timeRange?.from) {
+    params.set("from", timeRange.from);
+  }
+  if (timeRange?.to) {
+    params.set("to", timeRange.to);
+  }
+  const queryString = params.toString();
+  const url = `${vesselApiBaseUrl()}/vessel/${encodeURIComponent(id)}/trace${queryString ? `?${queryString}` : ""}`;
+  try {
+    const response = await fetch(url);
+    if (response.status === 404) {
+      return {
+        vessel: { imo: 0, mmsi: null, name: "Unknown" },
+        trace: [],
+        count: 0,
+        limit: limit || 5e3
+      };
+    }
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    return data;
+  } catch (error) {
+    console.error("[vessel-api] Failed to fetch vessel trace:", error);
+    throw error;
+  }
+}
+async function fetchPois(bounds, options) {
+  const params = new URLSearchParams();
+  if (bounds) {
+    params.set("north", String(bounds.north));
+    params.set("south", String(bounds.south));
+    params.set("east", String(bounds.east));
+    params.set("west", String(bounds.west));
+  }
+  if (options?.type) {
+    params.set("type", options.type);
+  }
+  if (options?.limit) {
+    params.set("limit", String(options.limit));
+  }
+  const queryString = params.toString();
+  const url = `${vesselApiBaseUrl()}/poi${queryString ? `?${queryString}` : ""}`;
+  try {
+    const response = await fetch(url);
+    if (response.status === 404) {
+      return [];
+    }
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Unknown error" }));
+      throw new Error(error.error || `HTTP ${response.status}`);
+    }
+    const data = await response.json();
+    const seen = /* @__PURE__ */ new Set();
+    return (data.pois ?? []).filter((poi) => {
+      if (seen.has(poi.code)) return false;
+      seen.add(poi.code);
+      return true;
+    });
+  } catch (error) {
+    console.error("[vessel-api] Failed to fetch POIs:", error);
+    throw error;
+  }
+}
+export {
+  fetchPois,
+  fetchVessel,
+  fetchVesselTrace
+};
+//# sourceMappingURL=vessel-api.js.map

package/dist/modules/shipment_tracking/lib/vessel-api.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/vessel-api.ts"],
+  "sourcesContent": ["/**\n * Vessel API client for fetching real-time vessel position and trace data.\n *\n * The base URL is deployment-specific and MUST be provided via the\n * `NEXT_PUBLIC_VESSEL_API_URL` environment variable. There is no default: when\n * it is unset the vessel/trace/POI calls throw a clear \"not configured\" error\n * and the map features that depend on them are simply unavailable.\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 VesselDimensions {\n  a: number\n  b: number\n  c: number\n  d: number\n}\n\nexport interface PortInfo {\n  locode: string\n  name: string\n  city: string\n  country: string\n}\n\nexport interface Position {\n  lat: number\n  lng: number\n}\n\nexport type VesselStatus = 'AT_SEA' | 'IN_PORT'\nexport type PoiType = 'PORT' | 'TERMINAL' | 'WAYPOINT' | 'PORT_GEOMETRIC_CENTER'\n\nexport interface VesselInfo {\n  imo: number\n  mmsi: number | null\n  name: string\n  callsign: string | null\n  shipType: string | null\n  operatorName: string | null\n  owner: string | null\n  dimensions: VesselDimensions | null\n  status: VesselStatus | null\n  lastPosition: Position | null\n  lastHeading: number | null\n  lastDestination: string | null\n  lastDestinationPort: PortInfo | null\n  currentPort: PortInfo | null\n  currentPoiCode: string | null\n  currentPoiType: PoiType | null\n  isStationary: boolean\n  updatedAt: string\n}\n\nexport type TraceEventType =\n  | 'POSITION_UPDATE'\n  | 'PORT_ARRIVAL'\n  | 'PORT_DEPARTURE'\n  | 'TERMINAL_ARRIVAL'\n  | 'TERMINAL_DEPARTURE'\n  | 'DESTINATION_CHANGE'\n\nexport interface TracePoint {\n  lat: number\n  lng: number\n  speed: number | null\n  heading: number | null\n  eventType: TraceEventType\n  destination: string | null\n  timestamp: string\n}\n\nexport interface BoundingBox {\n  north: number\n  south: number\n  east: number\n  west: number\n}\n\n/**\n * A point of interest (port, terminal, waypoint, or port geometric center) returned by the\n * vessel-api `/poi` endpoint, modeled as a circle (center + radius) ready to draw on a map.\n */\nexport interface PoiInfo {\n  code: string\n  locode: string\n  type: PoiType\n  center: Position\n  radiusMeters: number\n  portName: string | null\n  terminalName: string | null\n  city: string | null\n  country: string | null\n  /** Maritime region name in Polish (waypoints; may fall back to English). */\n  regionNamePl: string | null\n  /** Maritime region name in English. */\n  regionNameEn: string | null\n}\n\nexport interface PoiListResponse {\n  pois: PoiInfo[]\n  count: number\n  limit: number\n  /** Present only when a bounding-box filter was applied. */\n  bounds?: BoundingBox\n  /** Present only when a type filter was applied. */\n  type?: PoiType\n}\n\nexport interface TimeRange {\n  from?: string  // ISO 8601 date\n  to?: string    // ISO 8601 date\n}\n\nexport interface VesselResponse {\n  vessel: VesselInfo\n}\n\nexport interface TraceResponse {\n  vessel: {\n    imo: number\n    mmsi: number | null\n    name: string\n  }\n  trace: TracePoint[]\n  count: number\n  limit: number\n  bounds?: BoundingBox\n  timeRange?: TimeRange\n}\n\n// \u2500\u2500\u2500 Configuration \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\nfunction vesselApiBaseUrl(): string {\n  const baseUrl = process.env.NEXT_PUBLIC_VESSEL_API_URL || ''\n  if (!baseUrl) {\n    throw new Error(\n      'Vessel API is not configured \u2014 set NEXT_PUBLIC_VESSEL_API_URL to your vessel-tracking API base URL'\n    )\n  }\n  return baseUrl.replace(/\\/+$/, '')\n}\n\n// \u2500\u2500\u2500 API Functions \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\n/**\n * Fetch vessel information by IMO number or MMSI.\n *\n * @param imoOrMmsi - IMO number (7 digits) or MMSI (9 digits)\n * @returns Vessel info or null if not found\n */\nexport async function fetchVessel(imoOrMmsi: number | string): Promise<VesselInfo | null> {\n  const id = typeof imoOrMmsi === 'string' ? imoOrMmsi : String(imoOrMmsi)\n\n  try {\n    const response = await fetch(`${vesselApiBaseUrl()}/vessel/${encodeURIComponent(id)}`)\n\n    if (response.status === 404) {\n      return null\n    }\n\n    if (!response.ok) {\n      const error = await response.json().catch(() => ({ error: 'Unknown error' }))\n      throw new Error(error.error || `HTTP ${response.status}`)\n    }\n\n    const data: VesselResponse = await response.json()\n    return data.vessel\n  } catch (error) {\n    console.error('[vessel-api] Failed to fetch vessel:', error)\n    throw error\n  }\n}\n\n/**\n * Fetch vessel trace (position history) with optional bounding box and time filters.\n *\n * @param imoOrMmsi - IMO number or MMSI\n * @param bounds - Optional bounding box to filter trace points\n * @param limit - Maximum number of points to return (default: 5000)\n * @param timeRange - Optional time range filter (from/to in ISO 8601)\n * @returns Trace data with array of position points\n */\nexport async function fetchVesselTrace(\n  imoOrMmsi: number | string,\n  bounds?: BoundingBox,\n  limit?: number,\n  timeRange?: TimeRange\n): Promise<TraceResponse> {\n  const id = typeof imoOrMmsi === 'string' ? imoOrMmsi : String(imoOrMmsi)\n\n  const params = new URLSearchParams()\n\n  if (bounds) {\n    params.set('north', String(bounds.north))\n    params.set('south', String(bounds.south))\n    params.set('east', String(bounds.east))\n    params.set('west', String(bounds.west))\n  }\n\n  if (limit) {\n    params.set('limit', String(limit))\n  }\n\n  if (timeRange?.from) {\n    params.set('from', timeRange.from)\n  }\n\n  if (timeRange?.to) {\n    params.set('to', timeRange.to)\n  }\n\n  const queryString = params.toString()\n  const url = `${vesselApiBaseUrl()}/vessel/${encodeURIComponent(id)}/trace${queryString ? `?${queryString}` : ''}`\n\n  try {\n    const response = await fetch(url)\n\n    if (response.status === 404) {\n      return {\n        vessel: { imo: 0, mmsi: null, name: 'Unknown' },\n        trace: [],\n        count: 0,\n        limit: limit || 5000,\n      }\n    }\n\n    if (!response.ok) {\n      const error = await response.json().catch(() => ({ error: 'Unknown error' }))\n      throw new Error(error.error || `HTTP ${response.status}`)\n    }\n\n    const data: TraceResponse = await response.json()\n    return data\n  } catch (error) {\n    console.error('[vessel-api] Failed to fetch vessel trace:', error)\n    throw error\n  }\n}\n\n/**\n * Fetch points of interest (ports, terminals, waypoints) as map circles, optionally\n * constrained to a viewport bounding box and/or a single POI type.\n *\n * @param bounds - Optional bounding box to fetch only POIs in the current viewport\n * @param options - Optional `type` filter and `limit` (API default/cap is 5000)\n * @returns Array of POIs (empty on 404)\n */\nexport async function fetchPois(\n  bounds?: BoundingBox,\n  options?: { type?: PoiType; limit?: number }\n): Promise<PoiInfo[]> {\n  const params = new URLSearchParams()\n\n  if (bounds) {\n    params.set('north', String(bounds.north))\n    params.set('south', String(bounds.south))\n    params.set('east', String(bounds.east))\n    params.set('west', String(bounds.west))\n  }\n\n  if (options?.type) {\n    params.set('type', options.type)\n  }\n\n  if (options?.limit) {\n    params.set('limit', String(options.limit))\n  }\n\n  const queryString = params.toString()\n  const url = `${vesselApiBaseUrl()}/poi${queryString ? `?${queryString}` : ''}`\n\n  try {\n    const response = await fetch(url)\n\n    if (response.status === 404) {\n      return []\n    }\n\n    if (!response.ok) {\n      const error = await response.json().catch(() => ({ error: 'Unknown error' }))\n      throw new Error(error.error || `HTTP ${response.status}`)\n    }\n\n    const data: PoiListResponse = await response.json()\n    // The API contract says `code` is unique, but the live endpoint can return the same code\n    // more than once. Dedupe by code so downstream React keys stay unique and we don't draw\n    // overlapping duplicate circles.\n    const seen = new Set<string>()\n    return (data.pois ?? []).filter((poi) => {\n      if (seen.has(poi.code)) return false\n      seen.add(poi.code)\n      return true\n    })\n  } catch (error) {\n    console.error('[vessel-api] Failed to fetch POIs:', error)\n    throw error\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/vessel-cache.js

@@ -0,0 +1,50 @@
+import { fetchVessel } from "./vessel-api.js";
+const TTL_MS = 5 * 60 * 1e3;
+const MAX_ENTRIES = 500;
+const DEFAULT_CONCURRENCY = 8;
+const cache = /* @__PURE__ */ new Map();
+function evictIfNeeded(now) {
+  for (const [key, entry] of cache) {
+    if (entry.exp <= now) cache.delete(key);
+  }
+  while (cache.size >= MAX_ENTRIES) {
+    const oldest = cache.keys().next().value;
+    if (oldest === void 0) break;
+    cache.delete(oldest);
+  }
+}
+async function getVesselCached(imo) {
+  const now = Date.now();
+  const hit = cache.get(imo);
+  if (hit && hit.exp > now) return hit.v;
+  const vessel = await fetchVessel(imo);
+  evictIfNeeded(Date.now());
+  cache.set(imo, { v: vessel, exp: Date.now() + TTL_MS });
+  return vessel;
+}
+function __clearVesselCache() {
+  cache.clear();
+}
+async function mapWithConcurrency(items, task, concurrency = DEFAULT_CONCURRENCY) {
+  const results = new Array(items.length);
+  let cursor = 0;
+  async function worker() {
+    while (cursor < items.length) {
+      const index = cursor++;
+      try {
+        results[index] = { status: "fulfilled", value: await task(items[index]) };
+      } catch (reason) {
+        results[index] = { status: "rejected", reason };
+      }
+    }
+  }
+  const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker());
+  await Promise.all(workers);
+  return results;
+}
+export {
+  __clearVesselCache,
+  getVesselCached,
+  mapWithConcurrency
+};
+//# sourceMappingURL=vessel-cache.js.map

package/dist/modules/shipment_tracking/lib/vessel-cache.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/vessel-cache.ts"],
+  "sourcesContent": ["/**\n * Process-global, bounded, short-TTL cache for public AIS vessel data, plus a small\n * concurrency limiter for fanning out `fetchVessel` calls.\n *\n * Why this exists: the ships-map dashboard widget resolves many shipments to a handful\n * of distinct vessels (a vessel carries several of our containers), then fetches each\n * vessel's live position from the external `vessel-api`. That service has no batch\n * endpoint, so we make one HTTP call per distinct IMO. To keep latency and upstream\n * quota in check we:\n *   - cache the public `VesselInfo` keyed by IMO (TTL ~5 min),\n *   - bound the cache so it can't grow over the process lifetime,\n *   - cap concurrency on the fan-out.\n *\n * The cache stores ONLY public maritime data (`VesselInfo` keyed by IMO) \u2014 never\n * tenant-scoped rows \u2014 so it is safe to share across tenants. The tenant-scoped\n * `Shipment` query and the shipment\u2192vessel grouping are computed per request and\n * never cached here.\n */\n\nimport { fetchVessel, type VesselInfo } from './vessel-api'\n\n// \u2500\u2500\u2500 Configuration \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\nconst TTL_MS = 5 * 60 * 1000 // 5 minutes\nconst MAX_ENTRIES = 500 // hard cap so the cache can't grow unbounded over process life\nconst DEFAULT_CONCURRENCY = 8\n\ntype CacheEntry = { v: VesselInfo | null; exp: number }\n\n// Module-level (process-global) cache. Keyed by IMO string.\nconst cache = new Map<string, CacheEntry>()\n\n// \u2500\u2500\u2500 Cache \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\n/**\n * Evict expired entries; if still at capacity, drop the oldest insertion (Map preserves\n * insertion order) so the cache stays bounded.\n */\nfunction evictIfNeeded(now: number): void {\n  for (const [key, entry] of cache) {\n    if (entry.exp <= now) cache.delete(key)\n  }\n  while (cache.size >= MAX_ENTRIES) {\n    const oldest = cache.keys().next().value\n    if (oldest === undefined) break\n    cache.delete(oldest)\n  }\n}\n\n/**\n * Returns the cached `VesselInfo` for an IMO, fetching from `vessel-api` on a miss.\n *\n * A fetch failure is NOT cached \u2014 it propagates to the caller so the request handler can\n * fold the IMO into `unresolvedCount` (via `Promise.allSettled`). A successful fetch that\n * yields `null` (404 / unknown vessel) IS cached to avoid re-hitting a known-miss.\n */\nexport async function getVesselCached(imo: string): Promise<VesselInfo | null> {\n  const now = Date.now()\n  const hit = cache.get(imo)\n  if (hit && hit.exp > now) return hit.v\n\n  const vessel = await fetchVessel(imo)\n  evictIfNeeded(Date.now())\n  cache.set(imo, { v: vessel, exp: Date.now() + TTL_MS })\n  return vessel\n}\n\n/** Test-only: clear the process-global cache. */\nexport function __clearVesselCache(): void {\n  cache.clear()\n}\n\n// \u2500\u2500\u2500 Concurrency-capped fan-out \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 * Run `task` over `items` with at most `concurrency` in flight, returning results in the\n * same order as `items`. Mirrors `Promise.allSettled` semantics: never rejects \u2014 each slot\n * resolves to `{ status: 'fulfilled', value }` or `{ status: 'rejected', reason }`.\n */\nexport async function mapWithConcurrency<T, R>(\n  items: readonly T[],\n  task: (item: T) => Promise<R>,\n  concurrency: number = DEFAULT_CONCURRENCY,\n): Promise<PromiseSettledResult<R>[]> {\n  const results: PromiseSettledResult<R>[] = new Array(items.length)\n  let cursor = 0\n\n  async function worker(): Promise<void> {\n    while (cursor < items.length) {\n      const index = cursor++\n      try {\n        results[index] = { status: 'fulfilled', value: await task(items[index]) }\n      } catch (reason) {\n        results[index] = { status: 'rejected', reason }\n      }\n    }\n  }\n\n  const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => worker())\n  await Promise.all(workers)\n  return results\n}\n"],
+  "mappings": "AAmBA,SAAS,mBAAoC;AAI7C,MAAM,SAAS,IAAI,KAAK;AACxB,MAAM,cAAc;AACpB,MAAM,sBAAsB;AAK5B,MAAM,QAAQ,oBAAI,IAAwB;AAQ1C,SAAS,cAAc,KAAmB;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO;AAChC,QAAI,MAAM,OAAO,IAAK,OAAM,OAAO,GAAG;AAAA,EACxC;AACA,SAAO,MAAM,QAAQ,aAAa;AAChC,UAAM,SAAS,MAAM,KAAK,EAAE,KAAK,EAAE;AACnC,QAAI,WAAW,OAAW;AAC1B,UAAM,OAAO,MAAM;AAAA,EACrB;AACF;AASA,eAAsB,gBAAgB,KAAyC;AAC7E,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,MAAM,MAAM,IAAI,GAAG;AACzB,MAAI,OAAO,IAAI,MAAM,IAAK,QAAO,IAAI;AAErC,QAAM,SAAS,MAAM,YAAY,GAAG;AACpC,gBAAc,KAAK,IAAI,CAAC;AACxB,QAAM,IAAI,KAAK,EAAE,GAAG,QAAQ,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC;AACtD,SAAO;AACT;AAGO,SAAS,qBAA2B;AACzC,QAAM,MAAM;AACd;AASA,eAAsB,mBACpB,OACA,MACA,cAAsB,qBACc;AACpC,QAAM,UAAqC,IAAI,MAAM,MAAM,MAAM;AACjE,MAAI,SAAS;AAEb,iBAAe,SAAwB;AACrC,WAAO,SAAS,MAAM,QAAQ;AAC5B,YAAM,QAAQ;AACd,UAAI;AACF,gBAAQ,KAAK,IAAI,EAAE,QAAQ,aAAa,OAAO,MAAM,KAAK,MAAM,KAAK,CAAC,EAAE;AAAA,MAC1E,SAAS,QAAQ;AACf,gBAAQ,KAAK,IAAI,EAAE,QAAQ,YAAY,OAAO;AAAA,MAChD;AAAA,IACF;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,aAAa,MAAM,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;AAC1F,QAAM,QAAQ,IAAI,OAAO;AACzB,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/vessel-extraction.js

@@ -0,0 +1,13 @@
+function findLatestVesselInfo(events) {
+  const eventWithVessel = [...events].reverse().find((e) => e.vesselName || e.vesselImo || e.voyageNumber);
+  if (!eventWithVessel) return null;
+  return {
+    vesselName: eventWithVessel.vesselName ?? null,
+    vesselImo: eventWithVessel.vesselImo ?? null,
+    voyageNumber: eventWithVessel.voyageNumber ?? null
+  };
+}
+export {
+  findLatestVesselInfo
+};
+//# sourceMappingURL=vessel-extraction.js.map

package/dist/modules/shipment_tracking/lib/vessel-extraction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/vessel-extraction.ts"],
+  "sourcesContent": ["/**\n * Vessel info extraction utilities for shipment tracking.\n */\n\nexport type VesselInfo = {\n  vesselName: string | null\n  vesselImo: string | null\n  voyageNumber: string | null\n}\n\ntype EventWithVesselFields = {\n  vesselName?: string | null\n  vesselImo?: string | null\n  voyageNumber?: string | null\n}\n\n/**\n * Finds the latest vessel info from a list of tracking events.\n *\n * For completed voyages, the last event may be a gate operation (GTOT/GTIN)\n * that doesn't have vessel data. This function finds the latest event\n * that has any vessel info (vesselName, vesselImo, or voyageNumber).\n *\n * @param events - Array of tracking events sorted by eventDateTime\n * @returns VesselInfo from the latest event with vessel data, or null if none found\n */\nexport function findLatestVesselInfo(events: EventWithVesselFields[]): VesselInfo | null {\n  const eventWithVessel = [...events]\n    .reverse()\n    .find((e) => e.vesselName || e.vesselImo || e.voyageNumber)\n\n  if (!eventWithVessel) return null\n\n  return {\n    vesselName: eventWithVessel.vesselName ?? null,\n    vesselImo: eventWithVessel.vesselImo ?? null,\n    voyageNumber: eventWithVessel.voyageNumber ?? null,\n  }\n}\n"],
+  "mappings": "AA0BO,SAAS,qBAAqB,QAAoD;AACvF,QAAM,kBAAkB,CAAC,GAAG,MAAM,EAC/B,QAAQ,EACR,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY;AAE5D,MAAI,CAAC,gBAAiB,QAAO;AAE7B,SAAO;AAAA,IACL,YAAY,gBAAgB,cAAc;AAAA,IAC1C,WAAW,gBAAgB,aAAa;AAAA,IACxC,cAAc,gBAAgB,gBAAgB;AAAA,EAChD;AACF;",
+  "names": []
+}

package/dist/modules/shipment_tracking/lib/webhook-dispatcher.js

@@ -0,0 +1,62 @@
+import { createHmac } from "node:crypto";
+function signPayload(payload, secret) {
+  return createHmac("sha256", secret).update(payload).digest("hex");
+}
+async function dispatchWebhook(input) {
+  const { url, payload, hmacSecret, timeoutMs = 1e4 } = input;
+  const body = JSON.stringify(payload);
+  const timestamp = Math.floor(Date.now() / 1e3).toString();
+  const headers = {
+    "Content-Type": "application/json",
+    "X-Webhook-Timestamp": timestamp
+  };
+  if (hmacSecret) {
+    const signaturePayload = `${timestamp}.${body}`;
+    headers["X-Webhook-Signature"] = signPayload(signaturePayload, hmacSecret);
+  }
+  const startTime = Date.now();
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body,
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    const durationMs = Date.now() - startTime;
+    let responseBody;
+    try {
+      responseBody = await response.text();
+    } catch {
+    }
+    if (response.ok) {
+      return {
+        success: true,
+        responseStatus: response.status,
+        responseBody,
+        durationMs
+      };
+    }
+    return {
+      success: false,
+      responseStatus: response.status,
+      responseBody,
+      errorMessage: `HTTP ${response.status}: ${response.statusText}`,
+      durationMs
+    };
+  } catch (error) {
+    const durationMs = Date.now() - startTime;
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return {
+      success: false,
+      errorMessage: message,
+      durationMs
+    };
+  }
+}
+export {
+  dispatchWebhook
+};
+//# sourceMappingURL=webhook-dispatcher.js.map

package/dist/modules/shipment_tracking/lib/webhook-dispatcher.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/lib/webhook-dispatcher.ts"],
+  "sourcesContent": ["import { createHmac } from 'node:crypto'\n\nexport type WebhookDispatchResult = {\n  success: boolean\n  responseStatus?: number\n  responseBody?: string\n  errorMessage?: string\n  durationMs: number\n}\n\nfunction signPayload(payload: string, secret: string): string {\n  return createHmac('sha256', secret).update(payload).digest('hex')\n}\n\n/**\n * Dispatches a webhook HTTP POST with HMAC-SHA256 signing.\n *\n * Headers sent:\n * - Content-Type: application/json\n * - X-Webhook-Timestamp: Unix timestamp in seconds\n * - X-Webhook-Signature: HMAC-SHA256 of `{timestamp}.{body}` (only if hmacSecret provided)\n */\nexport async function dispatchWebhook(input: {\n  url: string\n  payload: Record<string, unknown>\n  hmacSecret?: string | null\n  timeoutMs?: number\n}): Promise<WebhookDispatchResult> {\n  const { url, payload, hmacSecret, timeoutMs = 10000 } = input\n  const body = JSON.stringify(payload)\n  const timestamp = Math.floor(Date.now() / 1000).toString()\n\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    'X-Webhook-Timestamp': timestamp,\n  }\n\n  if (hmacSecret) {\n    const signaturePayload = `${timestamp}.${body}`\n    headers['X-Webhook-Signature'] = signPayload(signaturePayload, hmacSecret)\n  }\n\n  const startTime = Date.now()\n\n  try {\n    const controller = new AbortController()\n    const timeout = setTimeout(() => controller.abort(), timeoutMs)\n\n    const response = await fetch(url, {\n      method: 'POST',\n      headers,\n      body,\n      signal: controller.signal,\n    })\n\n    clearTimeout(timeout)\n\n    const durationMs = Date.now() - startTime\n    let responseBody: string | undefined\n\n    try {\n      responseBody = await response.text()\n    } catch {\n      // Body read failure is non-critical\n    }\n\n    if (response.ok) {\n      return {\n        success: true,\n        responseStatus: response.status,\n        responseBody,\n        durationMs,\n      }\n    }\n\n    return {\n      success: false,\n      responseStatus: response.status,\n      responseBody,\n      errorMessage: `HTTP ${response.status}: ${response.statusText}`,\n      durationMs,\n    }\n  } catch (error) {\n    const durationMs = Date.now() - startTime\n    const message = error instanceof Error ? error.message : 'Unknown error'\n\n    return {\n      success: false,\n      errorMessage: message,\n      durationMs,\n    }\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAU3B,SAAS,YAAY,SAAiB,QAAwB;AAC5D,SAAO,WAAW,UAAU,MAAM,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK;AAClE;AAUA,eAAsB,gBAAgB,OAKH;AACjC,QAAM,EAAE,KAAK,SAAS,YAAY,YAAY,IAAM,IAAI;AACxD,QAAM,OAAO,KAAK,UAAU,OAAO;AACnC,QAAM,YAAY,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI,EAAE,SAAS;AAEzD,QAAM,UAAkC;AAAA,IACtC,gBAAgB;AAAA,IAChB,uBAAuB;AAAA,EACzB;AAEA,MAAI,YAAY;AACd,UAAM,mBAAmB,GAAG,SAAS,IAAI,IAAI;AAC7C,YAAQ,qBAAqB,IAAI,YAAY,kBAAkB,UAAU;AAAA,EAC3E;AAEA,QAAM,YAAY,KAAK,IAAI;AAE3B,MAAI;AACF,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,UAAU,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS;AAE9D,UAAM,WAAW,MAAM,MAAM,KAAK;AAAA,MAChC,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA,QAAQ,WAAW;AAAA,IACrB,CAAC;AAED,iBAAa,OAAO;AAEpB,UAAM,aAAa,KAAK,IAAI,IAAI;AAChC,QAAI;AAEJ,QAAI;AACF,qBAAe,MAAM,SAAS,KAAK;AAAA,IACrC,QAAQ;AAAA,IAER;AAEA,QAAI,SAAS,IAAI;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,gBAAgB,SAAS;AAAA,QACzB;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,gBAAgB,SAAS;AAAA,MACzB;AAAA,MACA,cAAc,QAAQ,SAAS,MAAM,KAAK,SAAS,UAAU;AAAA,MAC7D;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,UAAM,aAAa,KAAK,IAAI,IAAI;AAChC,UAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AAEzD,WAAO;AAAA,MACL,SAAS;AAAA,MACT,cAAc;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,48 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260422161208_shipment_tracking extends Migration {
+  async up() {
+    this.addSql(`create table if not exists "shipment_tracking_bic_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, "username" text not null, "password" text not null, "base_url" text not null default 'https://api.bic-code.org', "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), constraint "shipment_tracking_bic_configs_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_bic_configs_org_tenant_idx" on "shipment_tracking_bic_configs" ("organization_id", "tenant_id");`);
+    this.addSql(`DO $$ BEGIN alter table "shipment_tracking_bic_configs" add constraint "st_bic_configs_scope_unique" unique ("organization_id", "tenant_id"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);
+    this.addSql(`create table if not exists "shipment_tracking_carrier_configs" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "carrier_code" text not null, "api_endpoint" text null, "auth_config" jsonb null, "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_carrier_configs_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_carrier_configs_org_tenant_idx" on "shipment_tracking_carrier_configs" ("organization_id", "tenant_id");`);
+    this.addSql(`DO $$ BEGIN alter table "shipment_tracking_carrier_configs" add constraint "st_carrier_configs_code_uniq" unique ("organization_id", "tenant_id", "carrier_code"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);
+    this.addSql(`create table if not exists "shipment_tracking_location_overrides" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "carrier_code" text null, "unlocode" text not null, "facility_code" text not null, "facility_code_list_provider" text not null, "override_data" jsonb not null, "description" text null, "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, "created_by_user_id" uuid null, "updated_by_user_id" uuid null, constraint "shipment_tracking_location_overrides_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_location_overrides_lookup_idx" on "shipment_tracking_location_overrides" ("unlocode", "facility_code", "facility_code_list_provider");`);
+    this.addSql(`create index if not exists "st_location_overrides_org_tenant_idx" on "shipment_tracking_location_overrides" ("organization_id", "tenant_id");`);
+    this.addSql(`DO $$ BEGIN alter table "shipment_tracking_location_overrides" add constraint "st_location_overrides_match_uniq" unique ("organization_id", "tenant_id", "carrier_code", "unlocode", "facility_code", "facility_code_list_provider"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);
+    this.addSql(`create table if not exists "shipment_tracking_jobs" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "carrier_code" text not null, "reference_type" text not null, "reference_value" text not null, "origin_unlocode" text null, "destination_unlocode" text null, "status" text not null default 'active', "schedule" jsonb null, "next_poll_at" timestamptz null, "last_poll_at" timestamptz null, "retry_count" int not null default 0, "error_history" jsonb null, "created_at" timestamptz not null default now(), "updated_at" timestamptz not null default now(), "deleted_at" timestamptz null, constraint "shipment_tracking_jobs_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_jobs_next_poll_idx" on "shipment_tracking_jobs" ("next_poll_at");`);
+    this.addSql(`create index if not exists "st_jobs_status_idx" on "shipment_tracking_jobs" ("status");`);
+    this.addSql(`create index if not exists "st_jobs_org_tenant_idx" on "shipment_tracking_jobs" ("organization_id", "tenant_id");`);
+    this.addSql(`create table if not exists "shipment_tracking_events" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "tracking_job_id" uuid not null, "source" text not null default 'dcsa', "source_event_id" text null, "event_type" text not null, "event_code" text not null, "event_classifier_code" text null, "event_date_time" timestamptz not null, "event_date_time_offset" text null, "description" text null, "raw_data" jsonb null, "equipment_reference" text null, "iso_equipment_code" text null, "empty_indicator_code" text null, "is_transshipment_move" boolean null, "location_name" text null, "location_unlocode" text null, "location_country" text null, "facility_code" text null, "facility_code_list_provider" text null, "facility_type_code" text null, "facility_address" text null, "latitude" real null, "longitude" real null, "transport_call_reference" text null, "mode_of_transport" text null, "vessel_name" text null, "vessel_imo" text null, "voyage_number" text null, "carrier_service_code" text null, "carrier_export_voyage_number" text null, "carrier_import_voyage_number" text null, "universal_service_reference" text null, "universal_export_voyage_reference" text null, "universal_import_voyage_reference" text null, "port_visit_reference" text null, "related_document_references" jsonb null, "event_created_date_time" timestamptz null, "retracted_event_id" text null, "publisher_name" text null, "publisher_role" text null, "delay_reason_code" text null, "change_remark" text null, "seals" jsonb null, "created_at" timestamptz not null default now(), constraint "shipment_tracking_events_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_events_event_date_time_idx" on "shipment_tracking_events" ("event_date_time");`);
+    this.addSql(`create index if not exists "st_events_equipment_ref_idx" on "shipment_tracking_events" ("equipment_reference");`);
+    this.addSql(`create index if not exists "st_events_tracking_job_idx" on "shipment_tracking_events" ("tracking_job_id");`);
+    this.addSql(`create index if not exists "st_events_org_tenant_idx" on "shipment_tracking_events" ("organization_id", "tenant_id");`);
+    this.addSql(`DO $$ BEGIN alter table "shipment_tracking_events" add constraint "st_events_source_event_uniq" unique ("tracking_job_id", "source", "source_event_id"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);
+    this.addSql(`create table if not exists "shipment_tracking_shipments" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "status" text not null default 'PENDING', "carrier_code" text null, "container_number" text null, "iso_equipment_code" text null, "booking_number" text null, "bol_number" text null, "etd_timestamps" jsonb null, "eta_timestamps" jsonb null, "atd_timestamps" jsonb null, "ata_timestamps" jsonb null, "origin_location" jsonb null, "destination_location" jsonb null, "vessel_name" text null, "vessel_imo" text null, "voyage_number" text null, "event_count" int not null default 0, "last_event_at" timestamptz null, "extra" jsonb null, "route_stops" jsonb null, "cargo_events" jsonb null, "seals" jsonb null, "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, "created_by_user_id" uuid null, "tracking_job_id" uuid null, constraint "shipment_tracking_shipments_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_shipments_tracking_job_idx" on "shipment_tracking_shipments" ("tracking_job_id");`);
+    this.addSql(`create index if not exists "st_shipments_carrier_idx" on "shipment_tracking_shipments" ("carrier_code");`);
+    this.addSql(`create index if not exists "st_shipments_status_idx" on "shipment_tracking_shipments" ("status");`);
+    this.addSql(`create index if not exists "st_shipments_org_tenant_idx" on "shipment_tracking_shipments" ("organization_id", "tenant_id");`);
+    this.addSql(`create table if not exists "shipment_tracking_webhooks" ("id" uuid not null default gen_random_uuid(), "organization_id" uuid not null, "tenant_id" uuid not null, "url" text not null, "events_subscribed" jsonb not null, "hmac_secret" text null, "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_webhooks_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_webhooks_org_tenant_idx" on "shipment_tracking_webhooks" ("organization_id", "tenant_id");`);
+    this.addSql(`create table if not exists "shipment_tracking_webhook_deliveries" ("id" uuid not null default gen_random_uuid(), "webhook_id" uuid not null, "event_type" text not null, "status" text not null default 'pending', "retry_count" int not null default 0, "next_retry_at" timestamptz null, "payload" jsonb not null, "response_status" int null, "response_body" text null, "error_message" text null, "created_at" timestamptz not null default now(), constraint "shipment_tracking_webhook_deliveries_pkey" primary key ("id"));`);
+    this.addSql(`create index if not exists "st_webhook_deliveries_next_retry_idx" on "shipment_tracking_webhook_deliveries" ("next_retry_at");`);
+    this.addSql(`create index if not exists "st_webhook_deliveries_status_idx" on "shipment_tracking_webhook_deliveries" ("status");`);
+    this.addSql(`create index if not exists "st_webhook_deliveries_webhook_idx" on "shipment_tracking_webhook_deliveries" ("webhook_id");`);
+    this.addSql(`DO $$ BEGIN alter table "shipment_tracking_events" add constraint "shipment_tracking_events_tracking_job_id_foreign" foreign key ("tracking_job_id") references "shipment_tracking_jobs" ("id") on update cascade; EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);
+    this.addSql(`DO $$ BEGIN alter table "shipment_tracking_shipments" add constraint "shipment_tracking_shipments_tracking_job_id_foreign" foreign key ("tracking_job_id") references "shipment_tracking_jobs" ("id") on update cascade on delete set null; EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);
+    this.addSql(`DO $$ BEGIN alter table "shipment_tracking_webhook_deliveries" add constraint "shipment_tracking_webhook_deliveries_webhook_id_foreign" foreign key ("webhook_id") references "shipment_tracking_webhooks" ("id") on update cascade; EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);
+  }
+  async down() {
+    this.addSql(`alter table "shipment_tracking_events" drop constraint if exists "shipment_tracking_events_tracking_job_id_foreign";`);
+    this.addSql(`alter table "shipment_tracking_shipments" drop constraint if exists "shipment_tracking_shipments_tracking_job_id_foreign";`);
+    this.addSql(`alter table "shipment_tracking_webhook_deliveries" drop constraint if exists "shipment_tracking_webhook_deliveries_webhook_id_foreign";`);
+  }
+}
+export {
+  Migration20260422161208_shipment_tracking
+};
+//# sourceMappingURL=Migration20260422161208_shipment_tracking.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/migrations/Migration20260422161208_shipment_tracking.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260422161208_shipment_tracking extends Migration {\n\n  override async up(): Promise<void> {\n    this.addSql(`create table if not exists \"shipment_tracking_bic_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, \"username\" text not null, \"password\" text not null, \"base_url\" text not null default 'https://api.bic-code.org', \"created_at\" timestamptz not null default now(), \"updated_at\" timestamptz not null default now(), constraint \"shipment_tracking_bic_configs_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_bic_configs_org_tenant_idx\" on \"shipment_tracking_bic_configs\" (\"organization_id\", \"tenant_id\");`);\n    this.addSql(`DO $$ BEGIN alter table \"shipment_tracking_bic_configs\" add constraint \"st_bic_configs_scope_unique\" unique (\"organization_id\", \"tenant_id\"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);\n\n    this.addSql(`create table if not exists \"shipment_tracking_carrier_configs\" (\"id\" uuid not null default gen_random_uuid(), \"organization_id\" uuid not null, \"tenant_id\" uuid not null, \"carrier_code\" text not null, \"api_endpoint\" text null, \"auth_config\" jsonb null, \"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_carrier_configs_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_carrier_configs_org_tenant_idx\" on \"shipment_tracking_carrier_configs\" (\"organization_id\", \"tenant_id\");`);\n    this.addSql(`DO $$ BEGIN alter table \"shipment_tracking_carrier_configs\" add constraint \"st_carrier_configs_code_uniq\" unique (\"organization_id\", \"tenant_id\", \"carrier_code\"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);\n\n    this.addSql(`create table if not exists \"shipment_tracking_location_overrides\" (\"id\" uuid not null default gen_random_uuid(), \"organization_id\" uuid not null, \"tenant_id\" uuid not null, \"carrier_code\" text null, \"unlocode\" text not null, \"facility_code\" text not null, \"facility_code_list_provider\" text not null, \"override_data\" jsonb not null, \"description\" text null, \"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, \"created_by_user_id\" uuid null, \"updated_by_user_id\" uuid null, constraint \"shipment_tracking_location_overrides_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_location_overrides_lookup_idx\" on \"shipment_tracking_location_overrides\" (\"unlocode\", \"facility_code\", \"facility_code_list_provider\");`);\n    this.addSql(`create index if not exists \"st_location_overrides_org_tenant_idx\" on \"shipment_tracking_location_overrides\" (\"organization_id\", \"tenant_id\");`);\n    this.addSql(`DO $$ BEGIN alter table \"shipment_tracking_location_overrides\" add constraint \"st_location_overrides_match_uniq\" unique (\"organization_id\", \"tenant_id\", \"carrier_code\", \"unlocode\", \"facility_code\", \"facility_code_list_provider\"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);\n\n    this.addSql(`create table if not exists \"shipment_tracking_jobs\" (\"id\" uuid not null default gen_random_uuid(), \"organization_id\" uuid not null, \"tenant_id\" uuid not null, \"carrier_code\" text not null, \"reference_type\" text not null, \"reference_value\" text not null, \"origin_unlocode\" text null, \"destination_unlocode\" text null, \"status\" text not null default 'active', \"schedule\" jsonb null, \"next_poll_at\" timestamptz null, \"last_poll_at\" timestamptz null, \"retry_count\" int not null default 0, \"error_history\" jsonb null, \"created_at\" timestamptz not null default now(), \"updated_at\" timestamptz not null default now(), \"deleted_at\" timestamptz null, constraint \"shipment_tracking_jobs_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_jobs_next_poll_idx\" on \"shipment_tracking_jobs\" (\"next_poll_at\");`);\n    this.addSql(`create index if not exists \"st_jobs_status_idx\" on \"shipment_tracking_jobs\" (\"status\");`);\n    this.addSql(`create index if not exists \"st_jobs_org_tenant_idx\" on \"shipment_tracking_jobs\" (\"organization_id\", \"tenant_id\");`);\n\n    this.addSql(`create table if not exists \"shipment_tracking_events\" (\"id\" uuid not null default gen_random_uuid(), \"organization_id\" uuid not null, \"tenant_id\" uuid not null, \"tracking_job_id\" uuid not null, \"source\" text not null default 'dcsa', \"source_event_id\" text null, \"event_type\" text not null, \"event_code\" text not null, \"event_classifier_code\" text null, \"event_date_time\" timestamptz not null, \"event_date_time_offset\" text null, \"description\" text null, \"raw_data\" jsonb null, \"equipment_reference\" text null, \"iso_equipment_code\" text null, \"empty_indicator_code\" text null, \"is_transshipment_move\" boolean null, \"location_name\" text null, \"location_unlocode\" text null, \"location_country\" text null, \"facility_code\" text null, \"facility_code_list_provider\" text null, \"facility_type_code\" text null, \"facility_address\" text null, \"latitude\" real null, \"longitude\" real null, \"transport_call_reference\" text null, \"mode_of_transport\" text null, \"vessel_name\" text null, \"vessel_imo\" text null, \"voyage_number\" text null, \"carrier_service_code\" text null, \"carrier_export_voyage_number\" text null, \"carrier_import_voyage_number\" text null, \"universal_service_reference\" text null, \"universal_export_voyage_reference\" text null, \"universal_import_voyage_reference\" text null, \"port_visit_reference\" text null, \"related_document_references\" jsonb null, \"event_created_date_time\" timestamptz null, \"retracted_event_id\" text null, \"publisher_name\" text null, \"publisher_role\" text null, \"delay_reason_code\" text null, \"change_remark\" text null, \"seals\" jsonb null, \"created_at\" timestamptz not null default now(), constraint \"shipment_tracking_events_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_events_event_date_time_idx\" on \"shipment_tracking_events\" (\"event_date_time\");`);\n    this.addSql(`create index if not exists \"st_events_equipment_ref_idx\" on \"shipment_tracking_events\" (\"equipment_reference\");`);\n    this.addSql(`create index if not exists \"st_events_tracking_job_idx\" on \"shipment_tracking_events\" (\"tracking_job_id\");`);\n    this.addSql(`create index if not exists \"st_events_org_tenant_idx\" on \"shipment_tracking_events\" (\"organization_id\", \"tenant_id\");`);\n    this.addSql(`DO $$ BEGIN alter table \"shipment_tracking_events\" add constraint \"st_events_source_event_uniq\" unique (\"tracking_job_id\", \"source\", \"source_event_id\"); EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);\n\n    this.addSql(`create table if not exists \"shipment_tracking_shipments\" (\"id\" uuid not null default gen_random_uuid(), \"organization_id\" uuid not null, \"tenant_id\" uuid not null, \"status\" text not null default 'PENDING', \"carrier_code\" text null, \"container_number\" text null, \"iso_equipment_code\" text null, \"booking_number\" text null, \"bol_number\" text null, \"etd_timestamps\" jsonb null, \"eta_timestamps\" jsonb null, \"atd_timestamps\" jsonb null, \"ata_timestamps\" jsonb null, \"origin_location\" jsonb null, \"destination_location\" jsonb null, \"vessel_name\" text null, \"vessel_imo\" text null, \"voyage_number\" text null, \"event_count\" int not null default 0, \"last_event_at\" timestamptz null, \"extra\" jsonb null, \"route_stops\" jsonb null, \"cargo_events\" jsonb null, \"seals\" jsonb null, \"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, \"created_by_user_id\" uuid null, \"tracking_job_id\" uuid null, constraint \"shipment_tracking_shipments_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_shipments_tracking_job_idx\" on \"shipment_tracking_shipments\" (\"tracking_job_id\");`);\n    this.addSql(`create index if not exists \"st_shipments_carrier_idx\" on \"shipment_tracking_shipments\" (\"carrier_code\");`);\n    this.addSql(`create index if not exists \"st_shipments_status_idx\" on \"shipment_tracking_shipments\" (\"status\");`);\n    this.addSql(`create index if not exists \"st_shipments_org_tenant_idx\" on \"shipment_tracking_shipments\" (\"organization_id\", \"tenant_id\");`);\n\n    this.addSql(`create table if not exists \"shipment_tracking_webhooks\" (\"id\" uuid not null default gen_random_uuid(), \"organization_id\" uuid not null, \"tenant_id\" uuid not null, \"url\" text not null, \"events_subscribed\" jsonb not null, \"hmac_secret\" text null, \"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_webhooks_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_webhooks_org_tenant_idx\" on \"shipment_tracking_webhooks\" (\"organization_id\", \"tenant_id\");`);\n\n    this.addSql(`create table if not exists \"shipment_tracking_webhook_deliveries\" (\"id\" uuid not null default gen_random_uuid(), \"webhook_id\" uuid not null, \"event_type\" text not null, \"status\" text not null default 'pending', \"retry_count\" int not null default 0, \"next_retry_at\" timestamptz null, \"payload\" jsonb not null, \"response_status\" int null, \"response_body\" text null, \"error_message\" text null, \"created_at\" timestamptz not null default now(), constraint \"shipment_tracking_webhook_deliveries_pkey\" primary key (\"id\"));`);\n    this.addSql(`create index if not exists \"st_webhook_deliveries_next_retry_idx\" on \"shipment_tracking_webhook_deliveries\" (\"next_retry_at\");`);\n    this.addSql(`create index if not exists \"st_webhook_deliveries_status_idx\" on \"shipment_tracking_webhook_deliveries\" (\"status\");`);\n    this.addSql(`create index if not exists \"st_webhook_deliveries_webhook_idx\" on \"shipment_tracking_webhook_deliveries\" (\"webhook_id\");`);\n\n    this.addSql(`DO $$ BEGIN alter table \"shipment_tracking_events\" add constraint \"shipment_tracking_events_tracking_job_id_foreign\" foreign key (\"tracking_job_id\") references \"shipment_tracking_jobs\" (\"id\") on update cascade; EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);\n\n    this.addSql(`DO $$ BEGIN alter table \"shipment_tracking_shipments\" add constraint \"shipment_tracking_shipments_tracking_job_id_foreign\" foreign key (\"tracking_job_id\") references \"shipment_tracking_jobs\" (\"id\") on update cascade on delete set null; EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);\n\n    this.addSql(`DO $$ BEGIN alter table \"shipment_tracking_webhook_deliveries\" add constraint \"shipment_tracking_webhook_deliveries_webhook_id_foreign\" foreign key (\"webhook_id\") references \"shipment_tracking_webhooks\" (\"id\") on update cascade; EXCEPTION WHEN duplicate_object THEN NULL; WHEN duplicate_table THEN NULL; END $$;`);\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"shipment_tracking_events\" drop constraint if exists \"shipment_tracking_events_tracking_job_id_foreign\";`);\n\n    this.addSql(`alter table \"shipment_tracking_shipments\" drop constraint if exists \"shipment_tracking_shipments_tracking_job_id_foreign\";`);\n\n    this.addSql(`alter table \"shipment_tracking_webhook_deliveries\" drop constraint if exists \"shipment_tracking_webhook_deliveries_webhook_id_foreign\";`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,kDAAkD,UAAU;AAAA,EAEvE,MAAe,KAAoB;AACjC,SAAK,OAAO,4eAA4e;AACxf,SAAK,OAAO,iIAAiI;AAC7I,SAAK,OAAO,kOAAkO;AAE9O,SAAK,OAAO,slBAAslB;AAClmB,SAAK,OAAO,yIAAyI;AACrJ,SAAK,OAAO,uPAAuP;AAEnQ,SAAK,OAAO,+pBAA+pB;AAC3qB,SAAK,OAAO,uKAAuK;AACnL,SAAK,OAAO,+IAA+I;AAC3J,SAAK,OAAO,0TAA0T;AAEtU,SAAK,OAAO,isBAAisB;AAC7sB,SAAK,OAAO,kGAAkG;AAC9G,SAAK,OAAO,yFAAyF;AACrG,SAAK,OAAO,mHAAmH;AAE/H,SAAK,OAAO,2oDAA2oD;AACvpD,SAAK,OAAO,+GAA+G;AAC3H,SAAK,OAAO,iHAAiH;AAC7H,SAAK,OAAO,4GAA4G;AACxH,SAAK,OAAO,uHAAuH;AACnI,SAAK,OAAO,6OAA6O;AAEzP,SAAK,OAAO,6iCAA6iC;AACzjC,SAAK,OAAO,kHAAkH;AAC9H,SAAK,OAAO,0GAA0G;AACtH,SAAK,OAAO,mGAAmG;AAC/G,SAAK,OAAO,6HAA6H;AAEzI,SAAK,OAAO,oeAAoe;AAChf,SAAK,OAAO,2HAA2H;AAEvI,SAAK,OAAO,qgBAAqgB;AACjhB,SAAK,OAAO,gIAAgI;AAC5I,SAAK,OAAO,qHAAqH;AACjI,SAAK,OAAO,0HAA0H;AAEtI,SAAK,OAAO,uSAAuS;AAEnT,SAAK,OAAO,gUAAgU;AAE5U,SAAK,OAAO,yTAAyT;AAAA,EACvU;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,sHAAsH;AAElI,SAAK,OAAO,4HAA4H;AAExI,SAAK,OAAO,yIAAyI;AAAA,EACvJ;AAEF;",
+  "names": []
+}

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

@@ -0,0 +1,15 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260529120000_shipment_tracking_poi_region_names extends Migration {
+  async up() {
+    this.addSql(`alter table "shipment_tracking_events" add column if not exists "region_name_pl" text null;`);
+    this.addSql(`alter table "shipment_tracking_events" add column if not exists "region_name_en" text null;`);
+  }
+  async down() {
+    this.addSql(`alter table "shipment_tracking_events" drop column if exists "region_name_pl";`);
+    this.addSql(`alter table "shipment_tracking_events" drop column if exists "region_name_en";`);
+  }
+}
+export {
+  Migration20260529120000_shipment_tracking_poi_region_names
+};
+//# sourceMappingURL=Migration20260529120000_shipment_tracking_poi_region_names.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_tracking/migrations/Migration20260529120000_shipment_tracking_poi_region_names.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\n/**\n * Additive: human-friendly region names for AIS POI events.\n *\n * The poi-proximity-detector now emits `regionNamePl` / `regionNameEn` alongside the raw\n * POI code so the Journey Timeline can show e.g. \"Morze P\u00F3\u0142nocne\" instead of \"N053W001-03738\".\n * Both columns are nullable (carrier/DCSA events and unnamed POIs leave them null).\n */\nexport class Migration20260529120000_shipment_tracking_poi_region_names extends Migration {\n\n  override async up(): Promise<void> {\n    this.addSql(`alter table \"shipment_tracking_events\" add column if not exists \"region_name_pl\" text null;`);\n    this.addSql(`alter table \"shipment_tracking_events\" add column if not exists \"region_name_en\" text null;`);\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"shipment_tracking_events\" drop column if exists \"region_name_pl\";`);\n    this.addSql(`alter table \"shipment_tracking_events\" drop column if exists \"region_name_en\";`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AASnB,MAAM,mEAAmE,UAAU;AAAA,EAExF,MAAe,KAAoB;AACjC,SAAK,OAAO,6FAA6F;AACzG,SAAK,OAAO,6FAA6F;AAAA,EAC3G;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,gFAAgF;AAC5F,SAAK,OAAO,gFAAgF;AAAA,EAC9F;AAEF;",
+  "names": []
+}