@freighttech/terminal-tracking 0.7.0

package/dist/modules/terminal_tracking/lib/adapters/bct/incos-semantics.js

@@ -0,0 +1,146 @@
+import { DEFAULT_TERMINAL_TIMEZONE, zonedNaiveToUtc } from "../zoned-time.js";
+const GATE_IN = { eventType: "EQUIPMENT", eventCode: "GTIN", classifier: "ACT" };
+const DISCHARGED = { eventType: "EQUIPMENT", eventCode: "DISC", classifier: "ACT" };
+const DEPARTED = { eventType: "TRANSPORT", eventCode: "DEPA", classifier: "ACT" };
+function directionFromCategory(category) {
+  const c = (category ?? "").trim().toUpperCase();
+  if (!c) return null;
+  if (c === "E") return "export";
+  if (c === "I" || c === "X") return "import";
+  return null;
+}
+function modeFromYardType(type) {
+  const t = (type ?? "").trim().toUpperCase();
+  if (t === "T") return "TRUCK";
+  if (t === "V") return "VESSEL";
+  if (t === "R") return "RAIL";
+  return null;
+}
+function parseIncosDateTime(value, timeZone = DEFAULT_TERMINAL_TIMEZONE) {
+  if (!value) return null;
+  const m = /^(\d{2})-(\d{2})-(\d{4})[ T](\d{2}):(\d{2})(?::(\d{2}))?$/.exec(value.trim());
+  if (!m) return null;
+  const [, dd, mm, yyyy, hh, mi, ss] = m;
+  return zonedNaiveToUtc(+yyyy, +mm, +dd, +hh, +mi, ss ? +ss : 0, timeZone);
+}
+function parseIncosVesselDateTime(value, timeZone = DEFAULT_TERMINAL_TIMEZONE) {
+  if (!value) return null;
+  const m = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?$/.exec(value.trim());
+  if (!m) return null;
+  const [, yyyy, mm, dd, hh, mi, ss] = m;
+  return zonedNaiveToUtc(+yyyy, +mm, +dd, +hh, +mi, ss ? +ss : 0, timeZone);
+}
+function combinedVisitRef(code, voyage) {
+  const c = (code ?? "").trim();
+  const v = (voyage ?? "").trim();
+  return c && v ? `${c}/${v}` : null;
+}
+function splitVisitRef(visitRef) {
+  const i = visitRef.indexOf("/");
+  if (i <= 0 || i >= visitRef.length - 1) return null;
+  return { vesselCode: visitRef.slice(0, i), voyage: visitRef.slice(i + 1) };
+}
+function normalizeIncosVesselVisit(data, visitRef) {
+  return {
+    visitRef,
+    vesselName: data.vessel_name ?? null,
+    ibVoyage: data.in_voy ?? null,
+    obVoyage: data.out_voy ?? null,
+    line: data.line_code ?? null,
+    phase: null,
+    eta: parseIncosVesselDateTime(data.eta),
+    etd: parseIncosVesselDateTime(data.etd),
+    ata: parseIncosVesselDateTime(data.ata),
+    atd: parseIncosVesselDateTime(data.atd),
+    beginReceive: null,
+    dryCutoff: null,
+    rawData: { ...data }
+  };
+}
+function splitList(value) {
+  if (!value) return [];
+  return value.split(";").map((s) => s.trim()).filter((s) => s !== "");
+}
+function buildSourceEventId(terminalCode, ufvGkey, eventCode) {
+  return `${terminalCode}:${ufvGkey}:${eventCode}`;
+}
+function baseEvent(container, config, ufvGkey, spec, eventDateTime, ctx) {
+  const seals = [container.seal1, container.seal2, container.seal3, container.seal4].filter((n) => typeof n === "string" && n.trim() !== "").map((number) => ({ number, source: config.terminalCode }));
+  const direction = directionFromCategory(container.category);
+  const customsHold = String(container.customs_status ?? "").trim().toUpperCase() === "HOLD" ? [direction === "export" ? "CUSTOMS EXPORT HOLD" : "CUSTOMS IMPORT HOLD"] : [];
+  const impediments = [...customsHold, ...splitList(container.constraint)];
+  const vgm = typeof container.vgm_weight === "number" ? container.vgm_weight : null;
+  return {
+    source: "terminal",
+    sourceEventId: buildSourceEventId(config.terminalCode, ufvGkey, spec.eventCode),
+    eventType: spec.eventType,
+    eventCode: spec.eventCode,
+    eventClassifierCode: spec.classifier,
+    eventDateTime,
+    // `ufvGkey` is the trimmed container number — reuse it so `containerNumber`
+    // and the dedup key can never disagree (and to avoid a raw-field cast).
+    containerNumber: ufvGkey,
+    ufvGkey,
+    // No S-code state on INCOS; the location is the closest transit signal.
+    transitState: container.actual_location ?? null,
+    visitState: null,
+    facilityCode: config.facilityCode ?? null,
+    facilityCodeListProvider: config.facilityCodeListProvider ?? null,
+    unlocode: config.unlocode ?? null,
+    // INCOS keys a vessel visit by (vesselCode, voyage), so encode both into the
+    // visit ref (`CODE/VOY`); the adapter's fetchVesselVisit splits it back apart.
+    visitRefIn: combinedVisitRef(container.vessel_code_in, container.vessel_visit_invoy),
+    visitRefOut: combinedVisitRef(container.vessel_code_out, container.vessel_visit_outvoy),
+    // Vessel name/voyage here are the container-snapshot values; when the config
+    // enables the vessel endpoint the service overwrites them (and adds ETA/ATA)
+    // from the resolved vessel visit.
+    vesselName: ctx.vesselName ?? null,
+    voyageNumber: ctx.voyage ?? null,
+    modeOfTransport: modeFromYardType(ctx.yardType),
+    seals: seals.length ? seals : null,
+    vgmWeightKg: vgm,
+    impediments: impediments.length ? impediments : null,
+    loadedAt: null,
+    // Preserve the full snapshot. `Category` (import/export) is the field
+    // `parseCargoCategory` reads to pick the vessel-visit side for enrichment.
+    rawData: { ...container, Category: direction ?? null }
+  };
+}
+function mapContainerToEvents(container, config) {
+  const containerNbr = (container.container_nbr ?? "").trim();
+  if (!containerNbr) return [];
+  const ufvGkey = containerNbr;
+  const departed = parseIncosDateTime(container.out_yard_date);
+  if (departed) {
+    return [
+      baseEvent(container, config, ufvGkey, DEPARTED, departed, {
+        yardType: container.out_yard_type,
+        vesselName: container.vessel_name_out,
+        voyage: container.vessel_visit_outvoy
+      })
+    ];
+  }
+  const grounded = parseIncosDateTime(container.in_yard_date);
+  if (grounded) {
+    const arrivalSpec = modeFromYardType(container.in_yard_type) === "VESSEL" ? DISCHARGED : GATE_IN;
+    return [
+      baseEvent(container, config, ufvGkey, arrivalSpec, grounded, {
+        yardType: container.in_yard_type,
+        vesselName: container.vessel_name_in,
+        voyage: container.vessel_visit_invoy
+      })
+    ];
+  }
+  return [];
+}
+export {
+  combinedVisitRef,
+  directionFromCategory,
+  mapContainerToEvents,
+  modeFromYardType,
+  normalizeIncosVesselVisit,
+  parseIncosDateTime,
+  parseIncosVesselDateTime,
+  splitVisitRef
+};
+//# sourceMappingURL=incos-semantics.js.map

package/dist/modules/terminal_tracking/lib/adapters/bct/incos-semantics.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/terminal_tracking/lib/adapters/bct/incos-semantics.ts"],
+  "sourcesContent": ["import type { IncosContainer, IncosVesselVisit } from './types'\nimport { DEFAULT_TERMINAL_TIMEZONE, zonedNaiveToUtc } from '../zoned-time'\nimport type {\n  TerminalFetchedEvent,\n  ResolvedTerminalConfig,\n  NormalizedVesselVisit,\n} from '../../terminal-adapter'\nimport type {\n  TerminalEventType,\n  TerminalEventClassifierCode,\n  TerminalModeOfTransport,\n} from '../../../data/entities'\n\n/**\n * INCOS returns a container *state snapshot*, not a timestamped milestone stream\n * (much like GCT). We emit only the container's CURRENT milestone \u2014 its arrival\n * (`in_yard_date`) while it is on the terminal, or its departure\n * (`out_yard_date`) once it has left \u2014 mirroring N4's `/unit` current-state row,\n * rather than synthesizing extra states we cannot timestamp. INCOS has no\n * separate loaded-onto-transport timestamp (N4's \"Loaded\" column), so no `LOAD`\n * event.\n *\n * The arrival is refined by `in_yard_type` to match N4's vocabulary: a vessel\n * arrival is a discharge (`DISC` \u2192 `equipment.discharged`), a truck/rail arrival\n * is a gate-in (`GTIN` \u2192 `equipment.gate_in`). The departure is `DEPA`\n * (`transport.departed`). All three `eventCode`s are the ones the service maps\n * via n4-semantics `semanticEventIdFor`, so no adapter-specific downstream\n * wiring is needed.\n */\n\ntype MilestoneSpec = {\n  eventType: TerminalEventType\n  eventCode: string\n  classifier: TerminalEventClassifierCode\n}\n\nconst GATE_IN: MilestoneSpec = { eventType: 'EQUIPMENT', eventCode: 'GTIN', classifier: 'ACT' }\nconst DISCHARGED: MilestoneSpec = { eventType: 'EQUIPMENT', eventCode: 'DISC', classifier: 'ACT' }\nconst DEPARTED: MilestoneSpec = { eventType: 'TRANSPORT', eventCode: 'DEPA', classifier: 'ACT' }\n\n/** The container's direction of travel. */\nexport type IncosCargoDirection = 'import' | 'export'\n\n/**\n * Map INCOS `category` to a direction. Unlike GCT (which infers from a status\n * prefix), INCOS states it explicitly: `E` = export, `I`/`X` = import. Blank or\n * unknown yields null.\n */\nexport function directionFromCategory(category: string | null | undefined): IncosCargoDirection | null {\n  const c = (category ?? '').trim().toUpperCase()\n  if (!c) return null\n  if (c === 'E') return 'export'\n  if (c === 'I' || c === 'X') return 'import'\n  return null\n}\n\n/**\n * Map an INCOS yard-move type (`in_yard_type` / `out_yard_type`) to a mode of\n * transport: `T` truck, `V` vessel, `R` rail. Blank/unknown yields null.\n */\nexport function modeFromYardType(type: string | null | undefined): TerminalModeOfTransport | null {\n  const t = (type ?? '').trim().toUpperCase()\n  if (t === 'T') return 'TRUCK'\n  if (t === 'V') return 'VESSEL'\n  if (t === 'R') return 'RAIL'\n  return null\n}\n\n/**\n * Parse an INCOS datetime \u2014 `DD-MM-YYYY HH:MI` (optionally with seconds), e.g.\n * `03-05-2020 03:28`. INCOS returns terminal-local time without an offset, so we\n * interpret it in the terminal's timezone (Europe/Warsaw by default) and return\n * the corresponding UTC instant. Returns null when empty or the shape does not\n * match (a strict match avoids `Date.parse` misreading the day-first order as\n * month-first).\n */\nexport function parseIncosDateTime(\n  value: string | null | undefined,\n  timeZone: string = DEFAULT_TERMINAL_TIMEZONE,\n): Date | null {\n  if (!value) return null\n  const m = /^(\\d{2})-(\\d{2})-(\\d{4})[ T](\\d{2}):(\\d{2})(?::(\\d{2}))?$/.exec(value.trim())\n  if (!m) return null\n  const [, dd, mm, yyyy, hh, mi, ss] = m\n  return zonedNaiveToUtc(+yyyy, +mm, +dd, +hh, +mi, ss ? +ss : 0, timeZone)\n}\n\n/**\n * Parse an INCOS **vessel-visit** datetime \u2014 `YYYY-MM-DD HH:MM[:SS]`, e.g.\n * `2026-08-13 18:00:00`. This is a DIFFERENT format from the container endpoint's\n * day-first `DD-MM-YYYY HH:MI` (confirmed against the live API). Terminal-local,\n * no offset \u2192 interpreted in the terminal's timezone, consistent with\n * `parseIncosDateTime`.\n */\nexport function parseIncosVesselDateTime(\n  value: string | null | undefined,\n  timeZone: string = DEFAULT_TERMINAL_TIMEZONE,\n): Date | null {\n  if (!value) return null\n  const m = /^(\\d{4})-(\\d{2})-(\\d{2})[ T](\\d{2}):(\\d{2})(?::(\\d{2}))?$/.exec(value.trim())\n  if (!m) return null\n  const [, yyyy, mm, dd, hh, mi, ss] = m\n  return zonedNaiveToUtc(+yyyy, +mm, +dd, +hh, +mi, ss ? +ss : 0, timeZone)\n}\n\n/**\n * Encode an INCOS vessel visit key. INCOS looks a visit up by (vesselCode,\n * voyage), so both are packed into one visit ref as `CODE/VOY` (vessel codes and\n * voyages contain no `/`). Returns null unless both parts are present.\n */\nexport function combinedVisitRef(\n  code: string | null | undefined,\n  voyage: string | null | undefined,\n): string | null {\n  const c = (code ?? '').trim()\n  const v = (voyage ?? '').trim()\n  return c && v ? `${c}/${v}` : null\n}\n\n/** Split a `CODE/VOY` visit ref back into its parts (on the first `/`). */\nexport function splitVisitRef(visitRef: string): { vesselCode: string; voyage: string } | null {\n  const i = visitRef.indexOf('/')\n  if (i <= 0 || i >= visitRef.length - 1) return null\n  return { vesselCode: visitRef.slice(0, i), voyage: visitRef.slice(i + 1) }\n}\n\n/**\n * Normalize an INCOS vessel-visit payload into the shared `NormalizedVesselVisit`.\n * INCOS has no `phase`, `beginReceive`, or `dryCutoff`, so those are null.\n */\nexport function normalizeIncosVesselVisit(\n  data: IncosVesselVisit,\n  visitRef: string,\n): NormalizedVesselVisit {\n  return {\n    visitRef,\n    vesselName: data.vessel_name ?? null,\n    ibVoyage: data.in_voy ?? null,\n    obVoyage: data.out_voy ?? null,\n    line: data.line_code ?? null,\n    phase: null,\n    eta: parseIncosVesselDateTime(data.eta),\n    etd: parseIncosVesselDateTime(data.etd),\n    ata: parseIncosVesselDateTime(data.ata),\n    atd: parseIncosVesselDateTime(data.atd),\n    beginReceive: null,\n    dryCutoff: null,\n    rawData: { ...data },\n  }\n}\n\n/** Split a `;`-separated INCOS list, dropping blanks. */\nfunction splitList(value: string | null | undefined): string[] {\n  if (!value) return []\n  return value\n    .split(';')\n    .map((s) => s.trim())\n    .filter((s) => s !== '')\n}\n\nfunction buildSourceEventId(terminalCode: string, ufvGkey: string, eventCode: string): string {\n  return `${terminalCode}:${ufvGkey}:${eventCode}`\n}\n\n/** Per-milestone view of the snapshot: which yard-type + vessel fields apply. */\ntype MilestoneContext = {\n  yardType: string | null | undefined\n  vesselName: string | null | undefined\n  voyage: string | null | undefined\n}\n\nfunction baseEvent(\n  container: IncosContainer,\n  config: ResolvedTerminalConfig,\n  ufvGkey: string,\n  spec: MilestoneSpec,\n  eventDateTime: Date,\n  ctx: MilestoneContext,\n): TerminalFetchedEvent {\n  const seals = [container.seal1, container.seal2, container.seal3, container.seal4]\n    .filter((n): n is string => typeof n === 'string' && n.trim() !== '')\n    .map((number) => ({ number, source: config.terminalCode }))\n\n  const direction = directionFromCategory(container.category)\n\n  // Impediments (\"stopki\"). A customs HOLD is mapped to the direction-specific\n  // catalogue code (`CUSTOMS IMPORT/EXPORT HOLD`) so `lib/holds.ts` classifies it\n  // as a critical customs hold instead of the \"unknown\" fallback. Per the INCOS\n  // docs `customs_status` is binary \u2014 empty, or `HOLD` when a customs hold is\n  // placed (\"za\u0142o\u017Cony\") \u2014 so this is the full fidelity INCOS offers: it is a real\n  // placed hold (not N4's routine auto-clearing \"permission\"), hence `critical`.\n  // Direction unknown \u2192 the import code (the dominant BCT flow). Raw `constraint`\n  // codes pass through and stay unclassified until INCOS documents them.\n  const customsHold =\n    String(container.customs_status ?? '').trim().toUpperCase() === 'HOLD'\n      ? [direction === 'export' ? 'CUSTOMS EXPORT HOLD' : 'CUSTOMS IMPORT HOLD']\n      : []\n  const impediments = [...customsHold, ...splitList(container.constraint)]\n\n  const vgm = typeof container.vgm_weight === 'number' ? container.vgm_weight : null\n\n  return {\n    source: 'terminal',\n    sourceEventId: buildSourceEventId(config.terminalCode, ufvGkey, spec.eventCode),\n    eventType: spec.eventType,\n    eventCode: spec.eventCode,\n    eventClassifierCode: spec.classifier,\n    eventDateTime,\n    // `ufvGkey` is the trimmed container number \u2014 reuse it so `containerNumber`\n    // and the dedup key can never disagree (and to avoid a raw-field cast).\n    containerNumber: ufvGkey,\n    ufvGkey,\n    // No S-code state on INCOS; the location is the closest transit signal.\n    transitState: container.actual_location ?? null,\n    visitState: null,\n    facilityCode: config.facilityCode ?? null,\n    facilityCodeListProvider: config.facilityCodeListProvider ?? null,\n    unlocode: config.unlocode ?? null,\n    // INCOS keys a vessel visit by (vesselCode, voyage), so encode both into the\n    // visit ref (`CODE/VOY`); the adapter's fetchVesselVisit splits it back apart.\n    visitRefIn: combinedVisitRef(container.vessel_code_in, container.vessel_visit_invoy),\n    visitRefOut: combinedVisitRef(container.vessel_code_out, container.vessel_visit_outvoy),\n    // Vessel name/voyage here are the container-snapshot values; when the config\n    // enables the vessel endpoint the service overwrites them (and adds ETA/ATA)\n    // from the resolved vessel visit.\n    vesselName: ctx.vesselName ?? null,\n    voyageNumber: ctx.voyage ?? null,\n    modeOfTransport: modeFromYardType(ctx.yardType),\n    seals: seals.length ? seals : null,\n    vgmWeightKg: vgm,\n    impediments: impediments.length ? impediments : null,\n    loadedAt: null,\n    // Preserve the full snapshot. `Category` (import/export) is the field\n    // `parseCargoCategory` reads to pick the vessel-visit side for enrichment.\n    rawData: { ...container, Category: direction ?? null },\n  }\n}\n\n/**\n * Turn one INCOS container snapshot into zero, one, or two normalized events:\n * a gate-in when `in_yard_date` is set, and a departed when `out_yard_date` is\n * set. A snapshot with neither timestamp yields no events (nothing has provably\n * happened yet). The dedup key is the container number \u2014 the container lookup\n * carries no per-visit gkey, so (unlike GCT's `VisitNo`) a container that\n * returns for a later visit reuses the same key.\n */\nexport function mapContainerToEvents(\n  container: IncosContainer,\n  config: ResolvedTerminalConfig,\n): TerminalFetchedEvent[] {\n  const containerNbr = (container.container_nbr ?? '').trim()\n  if (!containerNbr) return []\n  const ufvGkey = containerNbr\n\n  // Emit only the container's CURRENT milestone, mirroring N4's `/unit` (which\n  // returns a single row for the current transit state):\n  //  - departed (out_yard_date set) \u2192 just DEPA;\n  //  - still on terminal (in_yard_date set, no out) \u2192 its arrival (DISC/GTIN).\n  // Emitting BOTH the historical arrival and the departure on every poll would\n  // keep the job from ever completing \u2014 the service's `isFullyDeparted` requires\n  // *every* event in a poll to be DEPA \u2014 so a departed container would be polled\n  // forever, wasting requests against BCT's 10k/day cap. The arrival was already\n  // persisted (deduped by sourceEventId) while the box sat in the yard, so it\n  // stays on the timeline; only its redundant re-emission is dropped here.\n  const departed = parseIncosDateTime(container.out_yard_date)\n  if (departed) {\n    return [\n      baseEvent(container, config, ufvGkey, DEPARTED, departed, {\n        yardType: container.out_yard_type,\n        vesselName: container.vessel_name_out,\n        voyage: container.vessel_visit_outvoy,\n      }),\n    ]\n  }\n\n  const grounded = parseIncosDateTime(container.in_yard_date)\n  if (grounded) {\n    // A vessel arrival is a discharge; a truck/rail (or unspecified) arrival is a\n    // gate-in \u2014 matching how N4 splits DISC vs GTIN.\n    const arrivalSpec = modeFromYardType(container.in_yard_type) === 'VESSEL' ? DISCHARGED : GATE_IN\n    return [\n      baseEvent(container, config, ufvGkey, arrivalSpec, grounded, {\n        yardType: container.in_yard_type,\n        vesselName: container.vessel_name_in,\n        voyage: container.vessel_visit_invoy,\n      }),\n    ]\n  }\n\n  return []\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/terminal_tracking/lib/adapters/bct/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/modules/terminal_tracking/lib/adapters/bct/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/modules/terminal_tracking/lib/adapters/gct/adapter.js

@@ -0,0 +1,106 @@
+import { acquireGctToken, invalidateGctToken, GctAuthError } from "./auth/token.js";
+import { mapContainerToEvents } from "./gct-semantics.js";
+import { n4Request } from "../n4/http.js";
+import { terminalLogger } from "../../logger.js";
+function joinUrl(base, path) {
+  return `${base.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+}
+class GctTerminalAdapter {
+  constructor() {
+    this.adapterType = "gct";
+    this.defaultEndpoints = {
+      // GCT's container-details endpoint occupies the generic `unit` slot.
+      unit: "/gctapi/GetContainerDetails"
+    };
+  }
+  detailsUrl(config) {
+    const path = config.endpoints?.unit?.trim() || this.defaultEndpoints.unit;
+    return joinUrl(config.baseUrl, path);
+  }
+  async getContainerDetails(containerNumber, config, token) {
+    const { status, ok, text } = await n4Request(
+      this.detailsUrl(config),
+      {
+        method: "POST",
+        headers: {
+          Authorization: token,
+          Accept: "application/json",
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({ CntrID: containerNumber, pageno: 1, pagesize: 100 })
+      },
+      { proxyUrl: config.proxyUrl, label: `${config.terminalCode} GetContainerDetails` }
+    );
+    if (status === 401) {
+      invalidateGctToken(config);
+      throw new GctAuthError(`GetContainerDetails unauthorized (401) for ${config.terminalCode}`);
+    }
+    if (!ok) {
+      throw new Error(`GetContainerDetails failed (${status}) for ${config.terminalCode}`);
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(text);
+    } catch {
+      throw new Error(`GetContainerDetails response was not valid JSON for ${config.terminalCode}`);
+    }
+    return Array.isArray(parsed.Containers) ? parsed.Containers : [];
+  }
+  async fetchEvents(input) {
+    const { containerNumber, config } = input;
+    const token = await acquireGctToken(config);
+    const containers = await this.getContainerDetails(containerNumber, config, token);
+    const events = [];
+    for (const container of containers) {
+      events.push(...mapContainerToEvents(container, config));
+    }
+    terminalLogger.debug("gct fetchEvents", {
+      terminalCode: config.terminalCode,
+      container: containerNumber,
+      rows: containers.length,
+      events: events.length
+    });
+    return { events, containerNumber };
+  }
+  /**
+   * GCT has no batch-by-container-number call, so fetch each container in turn.
+   * Kept as a distinct method (rather than falling through to per-container in
+   * the service) so the scheduler's batch path stays a single call site; the
+   * per-terminal rate limiter still throttles the underlying requests. A single
+   * container's failure is isolated so one bad number can't sink the whole poll.
+   */
+  async fetchEventsBatch(input) {
+    const { containerNumbers, config } = input;
+    if (containerNumbers.length === 0) return { events: [] };
+    await acquireGctToken(config);
+    const events = [];
+    for (const containerNumber of containerNumbers) {
+      try {
+        const result = await this.fetchEvents({ containerNumber, config });
+        events.push(...result.events);
+      } catch (err) {
+        if (err instanceof GctAuthError) throw err;
+        terminalLogger.warn("gct fetchEventsBatch: container failed", {
+          terminalCode: config.terminalCode,
+          container: containerNumber,
+          message: err instanceof Error ? err.message : String(err)
+        });
+      }
+    }
+    return { events };
+  }
+  async testConnection(config) {
+    const started = Date.now();
+    try {
+      await acquireGctToken(config);
+      return { success: true, message: "Token acquired", latencyMs: Date.now() - started };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return { success: false, message, latencyMs: Date.now() - started };
+    }
+  }
+}
+export {
+  GctTerminalAdapter
+};
+//# sourceMappingURL=adapter.js.map

package/dist/modules/terminal_tracking/lib/adapters/gct/adapter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/terminal_tracking/lib/adapters/gct/adapter.ts"],
+  "sourcesContent": ["import type {\n  TerminalAdapter,\n  TerminalFetchResult,\n  TerminalFetchedEvent,\n  TerminalAdapterTestResult,\n  ResolvedTerminalConfig,\n} from '../../terminal-adapter'\nimport type { GctContainer, GctContainerDetailsResponse } from './types'\nimport { acquireGctToken, invalidateGctToken, GctAuthError } from './auth/token'\nimport { mapContainerToEvents } from './gct-semantics'\nimport { n4Request } from '../n4/http'\nimport { terminalLogger } from '../../logger'\n\nfunction joinUrl(base: string, path: string): string {\n  return `${base.replace(/\\/$/, '')}/${path.replace(/^\\//, '')}`\n}\n\n/**\n * Config-driven adapter for the GCT (Gdynia Container Terminal) API. One\n * instance serves every GCT terminal; per-terminal differences live in the\n * TerminalConfig.\n *\n * Differences from the N4 adapter that shape this code:\n *  - Auth is a path-minted token replayed in the `Authorization` header\n *    (see ./auth/token.ts), not an OAuth2 Bearer grant.\n *  - There is no fetch-many-by-container-number endpoint, so `fetchEventsBatch`\n *    simply loops `fetchEvents` (bounded upstream by the per-terminal limiter).\n *  - There is no vessel endpoint, so `fetchVesselVisit` is intentionally omitted\n *    \u2014 the service feature-detects it and skips vessel resolution for GCT.\n */\nexport class GctTerminalAdapter implements TerminalAdapter {\n  readonly adapterType = 'gct'\n\n  readonly defaultEndpoints = {\n    // GCT's container-details endpoint occupies the generic `unit` slot.\n    unit: '/gctapi/GetContainerDetails',\n  }\n\n  private detailsUrl(config: ResolvedTerminalConfig): string {\n    const path = config.endpoints?.unit?.trim() || this.defaultEndpoints.unit\n    return joinUrl(config.baseUrl, path)\n  }\n\n  private async getContainerDetails(\n    containerNumber: string,\n    config: ResolvedTerminalConfig,\n    token: string,\n  ): Promise<GctContainer[]> {\n    const { status, ok, text } = await n4Request(\n      this.detailsUrl(config),\n      {\n        method: 'POST',\n        headers: {\n          Authorization: token,\n          Accept: 'application/json',\n          'Content-Type': 'application/json',\n        },\n        body: JSON.stringify({ CntrID: containerNumber, pageno: 1, pagesize: 100 }),\n      },\n      { proxyUrl: config.proxyUrl, label: `${config.terminalCode} GetContainerDetails` },\n    )\n\n    if (status === 401) {\n      invalidateGctToken(config)\n      throw new GctAuthError(`GetContainerDetails unauthorized (401) for ${config.terminalCode}`)\n    }\n    if (!ok) {\n      throw new Error(`GetContainerDetails failed (${status}) for ${config.terminalCode}`)\n    }\n\n    let parsed: GctContainerDetailsResponse\n    try {\n      parsed = JSON.parse(text) as GctContainerDetailsResponse\n    } catch {\n      throw new Error(`GetContainerDetails response was not valid JSON for ${config.terminalCode}`)\n    }\n    return Array.isArray(parsed.Containers) ? parsed.Containers : []\n  }\n\n  async fetchEvents(input: {\n    containerNumber: string\n    config: ResolvedTerminalConfig\n  }): Promise<TerminalFetchResult> {\n    const { containerNumber, config } = input\n    const token = await acquireGctToken(config)\n    const containers = await this.getContainerDetails(containerNumber, config, token)\n\n    const events: TerminalFetchedEvent[] = []\n    for (const container of containers) {\n      events.push(...mapContainerToEvents(container, config))\n    }\n\n    terminalLogger.debug('gct fetchEvents', {\n      terminalCode: config.terminalCode,\n      container: containerNumber,\n      rows: containers.length,\n      events: events.length,\n    })\n\n    return { events, containerNumber }\n  }\n\n  /**\n   * GCT has no batch-by-container-number call, so fetch each container in turn.\n   * Kept as a distinct method (rather than falling through to per-container in\n   * the service) so the scheduler's batch path stays a single call site; the\n   * per-terminal rate limiter still throttles the underlying requests. A single\n   * container's failure is isolated so one bad number can't sink the whole poll.\n   */\n  async fetchEventsBatch(input: {\n    containerNumbers: string[]\n    config: ResolvedTerminalConfig\n  }): Promise<{ events: TerminalFetchedEvent[] }> {\n    const { containerNumbers, config } = input\n    if (containerNumbers.length === 0) return { events: [] }\n\n    // Acquire once up front so a genuine auth failure fails the whole batch\n    // (marking the job failed) instead of being swallowed 100\u00D7 as per-container\n    // data errors below.\n    await acquireGctToken(config)\n\n    const events: TerminalFetchedEvent[] = []\n    for (const containerNumber of containerNumbers) {\n      try {\n        const result = await this.fetchEvents({ containerNumber, config })\n        events.push(...result.events)\n      } catch (err) {\n        // An auth error is fatal to the batch (token revoked/expired mid-run);\n        // let it propagate. Data/transport errors are isolated so one bad\n        // container can't sink the poll for the rest.\n        if (err instanceof GctAuthError) throw err\n        terminalLogger.warn('gct fetchEventsBatch: container failed', {\n          terminalCode: config.terminalCode,\n          container: containerNumber,\n          message: err instanceof Error ? err.message : String(err),\n        })\n      }\n    }\n    return { events }\n  }\n\n  async testConnection(config: ResolvedTerminalConfig): Promise<TerminalAdapterTestResult> {\n    const started = Date.now()\n    try {\n      await acquireGctToken(config)\n      return { success: true, message: 'Token acquired', latencyMs: Date.now() - started }\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err)\n      return { success: false, message, latencyMs: Date.now() - started }\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/terminal_tracking/lib/adapters/gct/auth/token.js

@@ -0,0 +1,120 @@
+import { n4Request } from "../../n4/http.js";
+import { generateTotp } from "../../../totp.js";
+const tokenCache = /* @__PURE__ */ new Map();
+class GctAuthError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "GctAuthError";
+  }
+}
+function credentials(config) {
+  const auth = config.authConfig ?? {};
+  const companyCode = String(auth.companyCode ?? "");
+  const loginName = String(auth.loginName ?? "");
+  const totpSecret = String(auth.totpSecret ?? "");
+  const legacyPassword = String(auth.loginPassword ?? "");
+  if (!companyCode || !loginName || !totpSecret && !legacyPassword) {
+    throw new GctAuthError(
+      `GCT config ${config.terminalCode} is missing companyCode/loginName/totpSecret in auth_config`
+    );
+  }
+  return { companyCode, loginName, totpSecret, legacyPassword };
+}
+function loginCode(creds) {
+  return creds.totpSecret ? generateTotp(creds.totpSecret) : creds.legacyPassword;
+}
+function cacheKey(config, creds) {
+  return `${config.terminalCode}:${creds.companyCode}:${creds.loginName}`;
+}
+function joinUrl(base, path) {
+  return `${base.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+}
+const DEFAULT_AUTH_PATH = "/gctapi/Auth";
+const DEFAULT_REFRESH_PATH = "/gctapi/ping";
+function authUrl(config, creds, code) {
+  const authPath = config.endpoints?.auth?.trim() || DEFAULT_AUTH_PATH;
+  const segments = [creds.companyCode, creds.loginName, code].map((s) => encodeURIComponent(s)).join("/");
+  return joinUrl(config.baseUrl, `${authPath}/${segments}`);
+}
+function refreshUrl(config) {
+  const refreshPath = config.endpoints?.refresh?.trim() || DEFAULT_REFRESH_PATH;
+  return joinUrl(config.baseUrl, refreshPath);
+}
+function parseExpires(value) {
+  if (!value) return null;
+  const ms = Date.parse(value);
+  return Number.isNaN(ms) ? null : ms;
+}
+function tokenTtl(parsed, now) {
+  return parseExpires(parsed.expires) ?? now + 15 * 60 * 1e3;
+}
+async function mintGctToken(config, creds, key, now) {
+  const { status, ok, text } = await n4Request(
+    authUrl(config, creds, loginCode(creds)),
+    { method: "GET", headers: { Accept: "application/json" } },
+    { proxyUrl: config.proxyUrl, label: `${config.terminalCode} auth` }
+  );
+  if (!ok) {
+    throw new GctAuthError(`GCT token request failed (${status}) for ${config.terminalCode}`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new GctAuthError(`GCT token response was not JSON for ${config.terminalCode}`);
+  }
+  if (!parsed.token) {
+    throw new GctAuthError(`No token in GCT auth response for ${config.terminalCode}`);
+  }
+  const entry = { token: parsed.token, expiresAt: tokenTtl(parsed, now) };
+  tokenCache.set(key, entry);
+  return entry.token;
+}
+async function refreshGctToken(config, token, now) {
+  let res;
+  try {
+    res = await n4Request(
+      refreshUrl(config),
+      { method: "GET", headers: { Accept: "application/json", Authorization: token } },
+      { proxyUrl: config.proxyUrl, label: `${config.terminalCode} refresh` }
+    );
+  } catch {
+    return null;
+  }
+  if (!res.ok) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(res.text);
+  } catch {
+    return null;
+  }
+  if (!parsed.token) return null;
+  return { token: parsed.token, expiresAt: tokenTtl(parsed, now) };
+}
+async function acquireGctToken(config) {
+  const creds = credentials(config);
+  const key = cacheKey(config, creds);
+  const now = Date.now();
+  const cached = tokenCache.get(key);
+  if (cached && cached.expiresAt > now + 3e4) return cached.token;
+  if (cached) {
+    const refreshed = await refreshGctToken(config, cached.token, now);
+    if (refreshed) {
+      tokenCache.set(key, refreshed);
+      return refreshed.token;
+    }
+  }
+  return mintGctToken(config, creds, key, now);
+}
+function invalidateGctToken(config) {
+  try {
+    tokenCache.delete(cacheKey(config, credentials(config)));
+  } catch {
+  }
+}
+export {
+  GctAuthError,
+  acquireGctToken,
+  invalidateGctToken
+};
+//# sourceMappingURL=token.js.map

package/dist/modules/terminal_tracking/lib/adapters/gct/auth/token.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/terminal_tracking/lib/adapters/gct/auth/token.ts"],
+  "sourcesContent": ["import type { ResolvedTerminalConfig } from '../../../terminal-adapter'\nimport type { GctToken } from '../types'\nimport { n4Request } from '../../n4/http'\nimport { generateTotp } from '../../../totp'\n\n/**\n * GCT token acquisition + process-level cache.\n *\n * GCT mints a token from a plain `GET /gctapi/Auth/{company}/{login}/{password}`\n * (credentials in the path \u2014 see the security note below), returning an ISO\n * `expires` instant. The token is then replayed in the `Authorization` header on\n * every data call. This mirrors `../../n4/auth/ropc.ts` in shape (cache keyed by\n * principal, 30s safety margin, invalidate-on-401) but not in wire protocol.\n *\n * LIFECYCLE: a cached token is reused until 30s before `expires`. Once it lapses\n * we first try to REFRESH it via the keep-alive endpoint (`GET /gctapi/ping`,\n * current token in the header) \u2014 cheap, no 2FA code \u2014 and only RE-AUTHENTICATE\n * (mint a new token with a fresh authenticator code) when the refresh fails.\n *\n * AUTH: GCT's login expects an authenticator one-time code where a password would\n * normally go. We store the base32 authenticator *secret* (the seed behind the\n * enrollment QR) in `auth_config` and derive the current 6-digit TOTP code at\n * mint time \u2014 never a static password. A legacy static `loginPassword` is still\n * honoured as a fallback so pre-existing configs don't hard-break.\n *\n * SECURITY: the credential (the derived code) is in the request URL, and the\n * secret must never appear anywhere. We NEVER log the URL \u2014 the shared\n * `n4Request` helper only logs the caller-supplied `label`, so we always pass an\n * opaque label and never the URL, and errors below never echo it. Only the\n * short-lived derived code ever reaches the URL; the seed does not.\n */\n\ntype CachedToken = { token: string; expiresAt: number }\n\nconst tokenCache = new Map<string, CachedToken>()\n\nexport class GctAuthError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'GctAuthError'\n  }\n}\n\ntype GctCredentials = { companyCode: string; loginName: string; totpSecret: string; legacyPassword: string }\n\nfunction credentials(config: ResolvedTerminalConfig): GctCredentials {\n  const auth = (config.authConfig ?? {}) as Record<string, unknown>\n  const companyCode = String(auth.companyCode ?? '')\n  const loginName = String(auth.loginName ?? '')\n  const totpSecret = String(auth.totpSecret ?? '')\n  // Legacy fallback: pre-TOTP configs stored a static `loginPassword`.\n  const legacyPassword = String(auth.loginPassword ?? '')\n  if (!companyCode || !loginName || (!totpSecret && !legacyPassword)) {\n    throw new GctAuthError(\n      `GCT config ${config.terminalCode} is missing companyCode/loginName/totpSecret in auth_config`,\n    )\n  }\n  return { companyCode, loginName, totpSecret, legacyPassword }\n}\n\n/**\n * The value GCT expects in the password path segment: the current TOTP code\n * derived from the authenticator secret, or a legacy static password when no\n * secret is configured.\n */\nfunction loginCode(creds: GctCredentials): string {\n  return creds.totpSecret ? generateTotp(creds.totpSecret) : creds.legacyPassword\n}\n\nfunction cacheKey(config: ResolvedTerminalConfig, creds: GctCredentials): string {\n  // Keyed by principal, NOT org/tenant: identical credentials mint the same\n  // token, so sharing one cache entry is correct. Persisted rows stay\n  // org-scoped independently of this cache.\n  return `${config.terminalCode}:${creds.companyCode}:${creds.loginName}`\n}\n\nfunction joinUrl(base: string, path: string): string {\n  return `${base.replace(/\\/$/, '')}/${path.replace(/^\\//, '')}`\n}\n\n/** Default GCT auth path; a config may override via `endpoints.auth`. */\nconst DEFAULT_AUTH_PATH = '/gctapi/Auth'\n\n/** Default GCT token-refresh (keep-alive) path; override via `endpoints.refresh`. */\nconst DEFAULT_REFRESH_PATH = '/gctapi/ping'\n\nfunction authUrl(config: ResolvedTerminalConfig, creds: GctCredentials, code: string): string {\n  const authPath =\n    (config.endpoints as { auth?: string } | undefined)?.auth?.trim() || DEFAULT_AUTH_PATH\n  const segments = [creds.companyCode, creds.loginName, code]\n    .map((s) => encodeURIComponent(s))\n    .join('/')\n  return joinUrl(config.baseUrl, `${authPath}/${segments}`)\n}\n\nfunction refreshUrl(config: ResolvedTerminalConfig): string {\n  const refreshPath =\n    (config.endpoints as { refresh?: string } | undefined)?.refresh?.trim() || DEFAULT_REFRESH_PATH\n  return joinUrl(config.baseUrl, refreshPath)\n}\n\n/** Parse GCT's ISO `expires` into epoch ms; null when unparseable. */\nfunction parseExpires(value: string | undefined): number | null {\n  if (!value) return null\n  const ms = Date.parse(value)\n  return Number.isNaN(ms) ? null : ms\n}\n\n/** Fall back to a conservative 15-minute TTL when `expires` is missing/bad. */\nfunction tokenTtl(parsed: GctToken, now: number): number {\n  return parseExpires(parsed.expires) ?? now + 15 * 60 * 1000\n}\n\n/**\n * Full (re-)authentication: derive a fresh authenticator code (it rotates every\n * 30s) and mint a new token from the path-GET Auth endpoint. Caches and returns\n * the raw token. This spends one 2FA code, so it is the fallback path \u2014 callers\n * try {@link refreshGctToken} first when they still hold a token.\n */\nasync function mintGctToken(\n  config: ResolvedTerminalConfig,\n  creds: GctCredentials,\n  key: string,\n  now: number,\n): Promise<string> {\n  const { status, ok, text } = await n4Request(\n    authUrl(config, creds, loginCode(creds)),\n    { method: 'GET', headers: { Accept: 'application/json' } },\n    { proxyUrl: config.proxyUrl, label: `${config.terminalCode} auth` },\n  )\n\n  if (!ok) {\n    // Do not include the URL (it carries the derived auth code); status only.\n    throw new GctAuthError(`GCT token request failed (${status}) for ${config.terminalCode}`)\n  }\n\n  let parsed: GctToken\n  try {\n    parsed = JSON.parse(text) as GctToken\n  } catch {\n    throw new GctAuthError(`GCT token response was not JSON for ${config.terminalCode}`)\n  }\n  if (!parsed.token) {\n    throw new GctAuthError(`No token in GCT auth response for ${config.terminalCode}`)\n  }\n\n  const entry: CachedToken = { token: parsed.token, expiresAt: tokenTtl(parsed, now) }\n  tokenCache.set(key, entry)\n  return entry.token\n}\n\n/**\n * Extend the current token via GCT's keep-alive endpoint\n * (`GET /gctapi/ping`, current token replayed in the `Authorization` header).\n * Returns the refreshed cache entry on success, or `null` on ANY failure \u2014\n * non-2xx, non-JSON, no token in the body, or a network error \u2014 so the caller\n * falls back to a full re-authentication. Never throws (no 2FA code is spent).\n */\nasync function refreshGctToken(\n  config: ResolvedTerminalConfig,\n  token: string,\n  now: number,\n): Promise<CachedToken | null> {\n  let res\n  try {\n    res = await n4Request(\n      refreshUrl(config),\n      { method: 'GET', headers: { Accept: 'application/json', Authorization: token } },\n      { proxyUrl: config.proxyUrl, label: `${config.terminalCode} refresh` },\n    )\n  } catch {\n    // Transient network failure exhausted its retries \u2192 re-authenticate.\n    return null\n  }\n  if (!res.ok) return null\n  let parsed: GctToken\n  try {\n    parsed = JSON.parse(res.text) as GctToken\n  } catch {\n    return null\n  }\n  if (!parsed.token) return null\n  return { token: parsed.token, expiresAt: tokenTtl(parsed, now) }\n}\n\n/**\n * Acquire (and cache) a GCT token for the `Authorization` header. A cached token\n * is reused until 30s before `expires`. Once it lapses, we first try to REFRESH\n * it via the keep-alive endpoint (cheap \u2014 no 2FA code); only if that fails do we\n * fully RE-AUTHENTICATE by minting a new token with a fresh authenticator code.\n */\nexport async function acquireGctToken(config: ResolvedTerminalConfig): Promise<string> {\n  const creds = credentials(config)\n  const key = cacheKey(config, creds)\n  const now = Date.now()\n  const cached = tokenCache.get(key)\n  if (cached && cached.expiresAt > now + 30_000) return cached.token\n\n  // (Near-)expired but a token is still in hand: try the keep-alive refresh\n  // before spending a fresh 2FA code. Any refresh failure \u2192 full re-auth.\n  if (cached) {\n    const refreshed = await refreshGctToken(config, cached.token, now)\n    if (refreshed) {\n      tokenCache.set(key, refreshed)\n      return refreshed.token\n    }\n  }\n\n  return mintGctToken(config, creds, key, now)\n}\n\n/** Clear the cached token for a terminal (used after a 401). */\nexport function invalidateGctToken(config: ResolvedTerminalConfig): void {\n  try {\n    tokenCache.delete(cacheKey(config, credentials(config)))\n  } catch {\n    // Missing creds \u2192 nothing cached; ignore.\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/terminal_tracking/lib/adapters/gct/gct-semantics.js

@@ -0,0 +1,77 @@
+import { DEFAULT_TERMINAL_TIMEZONE, zonedNaiveToUtc } from "../zoned-time.js";
+const GATE_IN = { eventType: "EQUIPMENT", eventCode: "GTIN", classifier: "ACT" };
+const DEPARTED = { eventType: "TRANSPORT", eventCode: "DEPA", classifier: "ACT" };
+function directionFromStatus(status) {
+  const s = (status ?? "").trim().toUpperCase();
+  if (!s) return null;
+  if (s.startsWith("X")) return "export";
+  if (s.startsWith("I")) return "import";
+  return null;
+}
+function parseGctDateTime(value, timeZone = DEFAULT_TERMINAL_TIMEZONE) {
+  if (!value) return null;
+  const raw = value.trim();
+  if (!raw) return null;
+  if (/[zZ]$|[+-]\d{2}:?\d{2}$/.test(raw)) {
+    const ms = Date.parse(raw.replace(" ", "T"));
+    return Number.isNaN(ms) ? null : new Date(ms);
+  }
+  const m = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?$/.exec(raw);
+  if (!m) return null;
+  const [, yyyy, mm, dd, hh, mi, ss] = m;
+  return zonedNaiveToUtc(+yyyy, +mm, +dd, +hh, +mi, ss ? +ss : 0, timeZone);
+}
+function buildSourceEventId(terminalCode, ufvGkey, eventCode) {
+  return `${terminalCode}:${ufvGkey}:${eventCode}`;
+}
+function baseEvent(container, config, ufvGkey, spec, eventDateTime) {
+  const seals = (container.SealList ?? []).filter((n) => typeof n === "string" && n.trim() !== "").map((number) => ({ number, source: config.terminalCode }));
+  const holds = (container.HoldCodesList ?? []).filter(
+    (c) => typeof c === "string" && c.trim() !== ""
+  );
+  const direction = directionFromStatus(container.CntrStatus);
+  return {
+    source: "terminal",
+    sourceEventId: buildSourceEventId(config.terminalCode, ufvGkey, spec.eventCode),
+    eventType: spec.eventType,
+    eventCode: spec.eventCode,
+    eventClassifierCode: spec.classifier,
+    eventDateTime,
+    containerNumber: container.CntrID,
+    ufvGkey,
+    transitState: container.CntrStatus ?? null,
+    visitState: null,
+    facilityCode: config.facilityCode ?? null,
+    facilityCodeListProvider: config.facilityCodeListProvider ?? null,
+    unlocode: config.unlocode ?? null,
+    visitRefIn: null,
+    visitRefOut: null,
+    // Vessel name/voyage are metadata only — GCT has no vessel-visit endpoint, so
+    // no schedule (ETA/ATA) enrichment is possible.
+    vesselName: container.VesselName ?? null,
+    voyageNumber: container.GCTVoyage ?? container.OwnerVoyage ?? null,
+    modeOfTransport: "VESSEL",
+    seals: seals.length ? seals : null,
+    vgmWeightKg: typeof container.VGMWeight === "number" ? container.VGMWeight : null,
+    impediments: holds.length ? holds : null,
+    loadedAt: null,
+    // Preserve the full snapshot plus a normalized direction for downstream use.
+    rawData: { ...container, Category: direction ?? null }
+  };
+}
+function mapContainerToEvents(container, config) {
+  if (!container.CntrID) return [];
+  const ufvGkey = container.VisitNo && container.VisitNo.trim() || container.CntrID;
+  const events = [];
+  const grounded = parseGctDateTime(container.GroundingDateTime);
+  if (grounded) events.push(baseEvent(container, config, ufvGkey, GATE_IN, grounded));
+  const pickedUp = parseGctDateTime(container.PickupDateTime);
+  if (pickedUp) events.push(baseEvent(container, config, ufvGkey, DEPARTED, pickedUp));
+  return events;
+}
+export {
+  directionFromStatus,
+  mapContainerToEvents,
+  parseGctDateTime
+};
+//# sourceMappingURL=gct-semantics.js.map

package/dist/modules/terminal_tracking/lib/adapters/gct/gct-semantics.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/terminal_tracking/lib/adapters/gct/gct-semantics.ts"],
+  "sourcesContent": ["import type { GctContainer } from './types'\nimport { DEFAULT_TERMINAL_TIMEZONE, zonedNaiveToUtc } from '../zoned-time'\nimport type { TerminalFetchedEvent, ResolvedTerminalConfig } from '../../terminal-adapter'\nimport type { TerminalEventType, TerminalEventClassifierCode } from '../../../data/entities'\n\n/**\n * GCT returns a container *state snapshot*, not a timestamped milestone stream.\n * We emit only the two milestones GCT actually timestamps \u2014 grounding (gate-in)\n * and pickup (gate-out/departed) \u2014 rather than synthesizing discharge/load from\n * a status code we cannot timestamp. The `eventCode`s (`GTIN`/`DEPA`) are the\n * same the service maps to `equipment.gate_in` / `transport.departed`, so no\n * adapter-specific wiring is needed downstream.\n */\n\ntype MilestoneSpec = {\n  eventType: TerminalEventType\n  eventCode: string\n  classifier: TerminalEventClassifierCode\n}\n\nconst GATE_IN: MilestoneSpec = { eventType: 'EQUIPMENT', eventCode: 'GTIN', classifier: 'ACT' }\nconst DEPARTED: MilestoneSpec = { eventType: 'TRANSPORT', eventCode: 'DEPA', classifier: 'ACT' }\n\n/** The container's direction of travel, inferred from the GCT status prefix. */\nexport type GctCargoDirection = 'import' | 'export'\n\n/**\n * Map `CntrStatus` (XF/EM/XM/IF/XI) to a direction: `X*` = export, `I*` = import.\n * `EM` (empty, no purpose) and any unknown value yield null. Kept deliberately\n * lenient \u2014 the vendor docs contradict on `IF` (full vs empty) and list an\n * undocumented `XI`, but Phase 1 does not branch on the full/empty nuance.\n */\nexport function directionFromStatus(status: string | null | undefined): GctCargoDirection | null {\n  const s = (status ?? '').trim().toUpperCase()\n  if (!s) return null\n  if (s.startsWith('X')) return 'export'\n  if (s.startsWith('I')) return 'import'\n  return null\n}\n\n/**\n * Parse a GCT datetime string. GCT is inconsistent \u2014 some fields are ISO-8601\n * with an explicit offset, others look like N4's \"yyyy-mm-dd hh:mm\"\n * (terminal-local, no offset). A field that carries its own timezone is parsed\n * as-is; a naive one is interpreted in the terminal's timezone (Europe/Warsaw\n * by default). Returns null when unparseable or empty.\n */\nexport function parseGctDateTime(\n  value: string | null | undefined,\n  timeZone: string = DEFAULT_TERMINAL_TIMEZONE,\n): Date | null {\n  if (!value) return null\n  const raw = value.trim()\n  if (!raw) return null\n  // An explicit timezone (`Z` or `\u00B1hh:mm`) is authoritative \u2014 parse directly.\n  if (/[zZ]$|[+-]\\d{2}:?\\d{2}$/.test(raw)) {\n    const ms = Date.parse(raw.replace(' ', 'T'))\n    return Number.isNaN(ms) ? null : new Date(ms)\n  }\n  // Otherwise it is terminal-local-without-offset: interpret it in `timeZone`.\n  const m = /^(\\d{4})-(\\d{2})-(\\d{2})[ T](\\d{2}):(\\d{2})(?::(\\d{2}))?$/.exec(raw)\n  if (!m) return null\n  const [, yyyy, mm, dd, hh, mi, ss] = m\n  return zonedNaiveToUtc(+yyyy, +mm, +dd, +hh, +mi, ss ? +ss : 0, timeZone)\n}\n\nfunction buildSourceEventId(terminalCode: string, ufvGkey: string, eventCode: string): string {\n  return `${terminalCode}:${ufvGkey}:${eventCode}`\n}\n\nfunction baseEvent(\n  container: GctContainer,\n  config: ResolvedTerminalConfig,\n  ufvGkey: string,\n  spec: MilestoneSpec,\n  eventDateTime: Date,\n): TerminalFetchedEvent {\n  const seals = (container.SealList ?? [])\n    .filter((n): n is string => typeof n === 'string' && n.trim() !== '')\n    .map((number) => ({ number, source: config.terminalCode }))\n  const holds = (container.HoldCodesList ?? []).filter(\n    (c): c is string => typeof c === 'string' && c.trim() !== '',\n  )\n  const direction = directionFromStatus(container.CntrStatus)\n\n  return {\n    source: 'terminal',\n    sourceEventId: buildSourceEventId(config.terminalCode, ufvGkey, spec.eventCode),\n    eventType: spec.eventType,\n    eventCode: spec.eventCode,\n    eventClassifierCode: spec.classifier,\n    eventDateTime,\n    containerNumber: container.CntrID,\n    ufvGkey,\n    transitState: container.CntrStatus ?? null,\n    visitState: null,\n    facilityCode: config.facilityCode ?? null,\n    facilityCodeListProvider: config.facilityCodeListProvider ?? null,\n    unlocode: config.unlocode ?? null,\n    visitRefIn: null,\n    visitRefOut: null,\n    // Vessel name/voyage are metadata only \u2014 GCT has no vessel-visit endpoint, so\n    // no schedule (ETA/ATA) enrichment is possible.\n    vesselName: container.VesselName ?? null,\n    voyageNumber: container.GCTVoyage ?? container.OwnerVoyage ?? null,\n    modeOfTransport: 'VESSEL',\n    seals: seals.length ? seals : null,\n    vgmWeightKg: typeof container.VGMWeight === 'number' ? container.VGMWeight : null,\n    impediments: holds.length ? holds : null,\n    loadedAt: null,\n    // Preserve the full snapshot plus a normalized direction for downstream use.\n    rawData: { ...container, Category: direction ?? null },\n  }\n}\n\n/**\n * Turn one GCT container snapshot into zero, one, or two normalized events:\n * a gate-in when `GroundingDateTime` is set, and a departed when\n * `PickupDateTime` is set. A snapshot with neither timestamp yields no events\n * (nothing has provably happened yet).\n */\nexport function mapContainerToEvents(\n  container: GctContainer,\n  config: ResolvedTerminalConfig,\n): TerminalFetchedEvent[] {\n  if (!container.CntrID) return []\n  const ufvGkey = (container.VisitNo && container.VisitNo.trim()) || container.CntrID\n\n  const events: TerminalFetchedEvent[] = []\n  const grounded = parseGctDateTime(container.GroundingDateTime)\n  if (grounded) events.push(baseEvent(container, config, ufvGkey, GATE_IN, grounded))\n  const pickedUp = parseGctDateTime(container.PickupDateTime)\n  if (pickedUp) events.push(baseEvent(container, config, ufvGkey, DEPARTED, pickedUp))\n\n  return events\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/terminal_tracking/lib/adapters/gct/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/modules/terminal_tracking/lib/adapters/gct/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/modules/terminal_tracking/lib/adapters/index.js

@@ -0,0 +1,12 @@
+import { N4TerminalAdapter } from "./n4/adapter.js";
+import { GctTerminalAdapter } from "./gct/adapter.js";
+import { BctTerminalAdapter } from "./bct/adapter.js";
+function registerAllAdapters(registry) {
+  registry.register(new N4TerminalAdapter());
+  registry.register(new GctTerminalAdapter());
+  registry.register(new BctTerminalAdapter());
+}
+export {
+  registerAllAdapters
+};
+//# sourceMappingURL=index.js.map

package/dist/modules/terminal_tracking/lib/adapters/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/terminal_tracking/lib/adapters/index.ts"],
+  "sourcesContent": ["import type { TerminalRegistry } from '../../services/terminalRegistry'\nimport { N4TerminalAdapter } from './n4/adapter'\nimport { GctTerminalAdapter } from './gct/adapter'\nimport { BctTerminalAdapter } from './bct/adapter'\n\n/**\n * Register all built-in terminal adapters. Adapters are keyed by `adapterType`;\n * a single adapter serves every terminal of that type (N4 \u2192 Baltic Hub etc.,\n * GCT \u2192 Gdynia Container Terminal, BCT \u2192 Ba\u0142tycki Terminal Kontenerowy via\n * INCOS), which are configured as `TerminalConfig` rows, not hardcoded here.\n */\nexport function registerAllAdapters(registry: TerminalRegistry): void {\n  registry.register(new N4TerminalAdapter())\n  registry.register(new GctTerminalAdapter())\n  registry.register(new BctTerminalAdapter())\n}\n"],
+  "mappings": "AACA,SAAS,yBAAyB;AAClC,SAAS,0BAA0B;AACnC,SAAS,0BAA0B;AAQ5B,SAAS,oBAAoB,UAAkC;AACpE,WAAS,SAAS,IAAI,kBAAkB,CAAC;AACzC,WAAS,SAAS,IAAI,mBAAmB,CAAC;AAC1C,WAAS,SAAS,IAAI,mBAAmB,CAAC;AAC5C;",
+  "names": []
+}