@freighttech/terminal-tracking 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FreightTech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# @freighttech/terminal-tracking
+
+Container-terminal tracking for the FreightTech FMS. Polls container terminal
+APIs (Navis **N4** family; Baltic Hub / BCT Gdańsk first), normalizes the
+results into events, and emits them — with per-terminal runtime configuration,
+periodic polling, and terminal matching.
+
+## Features
+
+- **Per-terminal config** (`TerminalConfig`) — base URL, OAuth, encrypted
+  credentials, rate limits, and matching identifiers (UN/LOCODE, BIC, SMDG,
+  name aliases). One row per tenant per terminal. Optional `proxyUrl` routes
+  that terminal's API calls through an HTTP forward proxy (to egress from a
+  whitelisted IP); empty = direct.
+- **Config-driven N4 adapter** — a single `N4TerminalAdapter` serves all N4
+  terminals; endpoint paths default from the adapter. Auth via Azure B2C ROPC
+  (password grant) or client-credentials.
+- **GCT adapter** (`adapterType: 'gct'`) — Gdynia Container Terminal's bespoke
+  FastAPI. Path-minted token replayed in the `Authorization` header; a container
+  *snapshot* mapped to gate-in (`GTIN`) / departed (`DEPA`) milestones.
+- **BCT adapter** (`adapterType: 'bct'`) — Bałtycki Terminal Kontenerowy (Gdynia)
+  via the **INCOS** platform (`https://incos.pl`). Plain HTTP **Basic** auth
+  (`authType: 'basic'`, `auth_config: { username, password }`). Read-only Phase 1:
+  the `GET /rest-container/container/{nbr}` snapshot is mapped to the container's
+  **current** milestone (mirroring N4's `/unit` current-state row). The arrival is
+  refined by `in_yard_type` to match N4's vocabulary: a vessel arrival is a
+  discharge (`in_yard_date` → `DISC` / `equipment.discharged`), a truck/rail
+  arrival is a gate-in (→ `GTIN` / `equipment.gate_in`); once the box leaves,
+  `out_yard_date` → `DEPA`. Emitting only the current milestone (not both arrival
+  and departure every poll) lets a departed job reach `completed` and drop from
+  the poll set — otherwise `isFullyDeparted` never trips and the box is polled
+  forever, burning the daily budget. Each event carries an explicit import/export
+  direction (`category`) and a real mode of transport (`in/out_yard_type`: T/V/R →
+  TRUCK/VESSEL/RAIL). **Holds:** INCOS flags customs status binarily, so a
+  customs `HOLD` is mapped by direction to the shared `lib/holds` catalogue code
+  (`CUSTOMS IMPORT HOLD` / `CUSTOMS EXPORT HOLD` — both `critical`) instead of an
+  unclassified raw string; the `;`-separated `constraint` codes (e.g. `STOPUC`)
+  pass through and stay unclassified until INCOS documents them. This is coarser
+  than N4 (which distinguishes ~20 impediment codes incl. permission-vs-hold),
+  but flows through the same `impediments[]` field, availability logic, and hold
+  badges.
+  **Data parity with N4:** TimeIn (`in_yard_date`), TimeOut (`out_yard_date`),
+  seals (`seal1..4`), holds (`customs_status`+`constraint`), and VGM are all
+  present. The one gap is a separate **Loaded** timestamp — the INCOS container
+  lookup has no dedicated load-onto-transport time (N4's "Loaded" column), so no
+  `LOAD` event / `loadedAt` is emitted (it lives only in the rail endpoint).
+  **Vessel ETA/ATA (Phase 2, done):** INCOS keys a visit by (vessel, voyage), so
+  the mapping packs both into the visit ref (`CODE/VOY`) and `fetchVesselVisit`
+  resolves it via `GET /rest-vesselvisit/vesselvisit/{code}/{voyage}` (dates there
+  are `YYYY-MM-DD HH:MM:SS`, unlike the container endpoint). Enable it by setting
+  `endpoints.vessel: /rest-vesselvisit/vesselvisit` on the config; the shared
+  `TerminalVesselVisit` TTL cache then serves ETA/ETD/ATA/ATD per leg. Still
+  deferred: the **rail** endpoints (and the Loaded time they carry). The dedup key
+  is the container number (the lookup carries no per-visit gkey).
+  **Rate limit:** INCOS caps BCT at **10 000 requests/day**. Set the config's
+  `rateLimitRequests: 10000` + `rateLimitWindowSeconds: 86400` (the token bucket
+  refills the full allowance over the window) — the entity defaults (200/60 s)
+  do not model a daily cap. Because BCT has no batch endpoint, **each container
+  poll costs one request**, so the daily budget bounds `containers × polls/day`
+  (e.g. 100 containers every 15 min ≈ 9 600/day — near the ceiling).
+  **⚠ TLS deployment prerequisite:** `incos.pl` serves an **incomplete
+  certificate chain** — only the leaf, omitting its intermediate
+  (`RapidSSL TLS RSA CA G1`, issued by the already-trusted DigiCert Global Root
+  G2). Browsers (and Bruno) fetch the missing intermediate via AIA, but
+  **Node/undici does not**, so the adapter fails with `fetch failed`
+  (TLS "unable to get local issuer certificate") unless the intermediate is
+  supplied via `NODE_EXTRA_CA_CERTS`. **This is already handled in production:**
+  `apps/web/Dockerfile` fetches `RapidSSL TLS RSA CA G1` (and the GeoTrust
+  intermediate for the Raiffeisen API) fresh at build time and bundles them into
+  `/app/certs/extra-ca-bundle.pem`. For local dev outside Docker, build the same
+  bundle yourself (see `apps/web/.env.example`). Verified live: with the
+  intermediate present the adapter validates the chain and polls containers. The
+  durable fix is for BCT/INCOS to serve the full chain.
+- **Module-owned jobs** (`TerminalTrackingJob`) — track a container at a
+  terminal; poll on a configurable schedule (`@open-mercato/scheduler`) or on
+  demand. The scheduler **batches** due jobs per terminal into a single
+  comma-separated `/unit` request (up to 100 containers) to minimise API calls.
+  A job whose every current leg has **departed** moves to a terminal
+  `completed` status (dropped from the poll set); `/VESSEL` is also skipped for
+  departed legs (their visit is historic). A container that returns later is
+  tracked as a **new** job with clean history.
+- **Vessel visits** (`TerminalVesselVisit`) — resolves the leg's vessel via
+  `/VESSEL` (Import → I/B visit, Export → O/B visit) and stores ETA/ETD/ATA/ATD,
+  phase, voyages, and the receive/cutoff window. The table doubles as a
+  TTL cache (default 1h, per-config override) so containers sharing a vessel
+  cost one lookup. Exposed at `GET /api/terminal_tracking/vessel-visits` and
+  shown per leg in the container details drawer.
+- **Events** — emits `terminal_tracking.terminal_event.created` (and
+  `…​.updated` when an existing event's container or vessel data changes on a
+  re-poll) plus semantic `equipment.*` / `transport.*` events. Dedup keyed on
+  `{terminalCode}:{Ufv_Gkey}:{eventCode}` so multiple Unit Facility Visits
+  (import/export legs) per container stay distinct. The payload carries the
+  nested `vesselVisit` (ETA/ATA/…) when resolved.
+- **Terminal matching** — `TerminalMatcherService` resolves a facility to a
+  configured terminal by exact BIC / SMDG / UN/LOCODE, or fuzzy name (fuse.js).
+- **Admin UI** — Settings → Terminal Tracking: Terminals (CRUD + Test
+  connection) and Tracked Containers (with a container details drawer showing
+  milestones, holds, and vessel ETA/ATA).
+
+## Module id
+
+`terminal_tracking` — enable in the host app's `src/modules.ts`:
+
+```ts
+{ id: 'terminal_tracking', from: '@freighttech/terminal-tracking' }
+```
+
+## Timeline bridge
+
+A subscriber in `@freighttech/shipment-tracking` consumes
+`terminal_tracking.terminal_event.created` and surfaces terminal events on the
+existing shipment Journey Timeline as `source:'port'` events (event-string
+coupling only — no cross-module imports).
+
+## Notes
+
+- IP-whitelisted terminals must be reached from a whitelisted egress IP
+  (deployment prerequisite; for local dev, route through a SOCKS tunnel).
+- The OAuth token endpoint is public and stays direct.
+
+See the spec: `.ai/specs/2026-06-08-n4-terminal-tracking-adapter.md`.

package/dist/generated/entities/terminal_config/index.js

@@ -0,0 +1,53 @@
+const id = "id";
+const organization_id = "organization_id";
+const tenant_id = "tenant_id";
+const terminal_code = "terminal_code";
+const adapter_type = "adapter_type";
+const display_name = "display_name";
+const base_url = "base_url";
+const proxy_url = "proxy_url";
+const endpoints = "endpoints";
+const auth_type = "auth_type";
+const token_url = "token_url";
+const scope = "scope";
+const client_id = "client_id";
+const auth_config = "auth_config";
+const rate_limit_requests = "rate_limit_requests";
+const rate_limit_window_seconds = "rate_limit_window_seconds";
+const vessel_cache_ttl_seconds = "vessel_cache_ttl_seconds";
+const unlocode = "unlocode";
+const bic_codes = "bic_codes";
+const smdg_codes = "smdg_codes";
+const name_aliases = "name_aliases";
+const is_active = "is_active";
+const created_at = "created_at";
+const updated_at = "updated_at";
+const deleted_at = "deleted_at";
+export {
+  adapter_type,
+  auth_config,
+  auth_type,
+  base_url,
+  bic_codes,
+  client_id,
+  created_at,
+  deleted_at,
+  display_name,
+  endpoints,
+  id,
+  is_active,
+  name_aliases,
+  organization_id,
+  proxy_url,
+  rate_limit_requests,
+  rate_limit_window_seconds,
+  scope,
+  smdg_codes,
+  tenant_id,
+  terminal_code,
+  token_url,
+  unlocode,
+  updated_at,
+  vessel_cache_ttl_seconds
+};
+//# sourceMappingURL=index.js.map

package/dist/generated/entities/terminal_config/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../generated/entities/terminal_config/index.ts"],
+  "sourcesContent": ["// AUTO-GENERATED by scripts/generate-entity-fields.mjs (HEDGE-168). Do not edit.\n//\n// One file per entity, named `toSnake(ClassName)` \u2014 NOT the table name. Each\n// export is a database column name, mirroring what `mercato generate` writes\n// for `@open-mercato/*` packages. `loadStandaloneGeneratedPackageEntities()`\n// reads these back to build the host app's `entity-fields-registry.ts`, which\n// is what the Encryption and Translation managers list fields from.\n//\n// Regenerate with `node scripts/generate-entity-fields.mjs --all`; the package\n// build does it for you. Guarded by\n// `apps/web/src/__tests__/entity-fields-registry-contract.test.ts`.\nexport const id = \"id\";\nexport const organization_id = \"organization_id\";\nexport const tenant_id = \"tenant_id\";\nexport const terminal_code = \"terminal_code\";\nexport const adapter_type = \"adapter_type\";\nexport const display_name = \"display_name\";\nexport const base_url = \"base_url\";\nexport const proxy_url = \"proxy_url\";\nexport const endpoints = \"endpoints\";\nexport const auth_type = \"auth_type\";\nexport const token_url = \"token_url\";\nexport const scope = \"scope\";\nexport const client_id = \"client_id\";\nexport const auth_config = \"auth_config\";\nexport const rate_limit_requests = \"rate_limit_requests\";\nexport const rate_limit_window_seconds = \"rate_limit_window_seconds\";\nexport const vessel_cache_ttl_seconds = \"vessel_cache_ttl_seconds\";\nexport const unlocode = \"unlocode\";\nexport const bic_codes = \"bic_codes\";\nexport const smdg_codes = \"smdg_codes\";\nexport const name_aliases = \"name_aliases\";\nexport const is_active = \"is_active\";\nexport const created_at = \"created_at\";\nexport const updated_at = \"updated_at\";\nexport const deleted_at = \"deleted_at\";\n"],
+  "mappings": "AAWO,MAAM,KAAK;AACX,MAAM,kBAAkB;AACxB,MAAM,YAAY;AAClB,MAAM,gBAAgB;AACtB,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,YAAY;AAClB,MAAM,YAAY;AAClB,MAAM,YAAY;AAClB,MAAM,QAAQ;AACd,MAAM,YAAY;AAClB,MAAM,cAAc;AACpB,MAAM,sBAAsB;AAC5B,MAAM,4BAA4B;AAClC,MAAM,2BAA2B;AACjC,MAAM,WAAW;AACjB,MAAM,YAAY;AAClB,MAAM,aAAa;AACnB,MAAM,eAAe;AACrB,MAAM,YAAY;AAClB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,aAAa;",
+  "names": []
+}

package/dist/generated/entities/terminal_event/index.js

@@ -0,0 +1,59 @@
+const id = "id";
+const organization_id = "organization_id";
+const tenant_id = "tenant_id";
+const job = "job";
+const source = "source";
+const source_event_id = "source_event_id";
+const event_type = "event_type";
+const event_code = "event_code";
+const event_classifier_code = "event_classifier_code";
+const event_date_time = "event_date_time";
+const container_number = "container_number";
+const ufv_gkey = "ufv_gkey";
+const transit_state = "transit_state";
+const visit_state = "visit_state";
+const facility_code = "facility_code";
+const facility_code_list_provider = "facility_code_list_provider";
+const unlocode = "unlocode";
+const visit_ref_in = "visit_ref_in";
+const visit_ref_out = "visit_ref_out";
+const vessel_name = "vessel_name";
+const voyage_number = "voyage_number";
+const mode_of_transport = "mode_of_transport";
+const seals = "seals";
+const vgm_weight_kg = "vgm_weight_kg";
+const impediments = "impediments";
+const loaded_at = "loaded_at";
+const raw_data = "raw_data";
+const created_at = "created_at";
+export {
+  container_number,
+  created_at,
+  event_classifier_code,
+  event_code,
+  event_date_time,
+  event_type,
+  facility_code,
+  facility_code_list_provider,
+  id,
+  impediments,
+  job,
+  loaded_at,
+  mode_of_transport,
+  organization_id,
+  raw_data,
+  seals,
+  source,
+  source_event_id,
+  tenant_id,
+  transit_state,
+  ufv_gkey,
+  unlocode,
+  vessel_name,
+  vgm_weight_kg,
+  visit_ref_in,
+  visit_ref_out,
+  visit_state,
+  voyage_number
+};
+//# sourceMappingURL=index.js.map

package/dist/generated/entities/terminal_event/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../generated/entities/terminal_event/index.ts"],
+  "sourcesContent": ["// AUTO-GENERATED by scripts/generate-entity-fields.mjs (HEDGE-168). Do not edit.\n//\n// One file per entity, named `toSnake(ClassName)` \u2014 NOT the table name. Each\n// export is a database column name, mirroring what `mercato generate` writes\n// for `@open-mercato/*` packages. `loadStandaloneGeneratedPackageEntities()`\n// reads these back to build the host app's `entity-fields-registry.ts`, which\n// is what the Encryption and Translation managers list fields from.\n//\n// Regenerate with `node scripts/generate-entity-fields.mjs --all`; the package\n// build does it for you. Guarded by\n// `apps/web/src/__tests__/entity-fields-registry-contract.test.ts`.\nexport const id = \"id\";\nexport const organization_id = \"organization_id\";\nexport const tenant_id = \"tenant_id\";\nexport const job = \"job\";\nexport const source = \"source\";\nexport const source_event_id = \"source_event_id\";\nexport const event_type = \"event_type\";\nexport const event_code = \"event_code\";\nexport const event_classifier_code = \"event_classifier_code\";\nexport const event_date_time = \"event_date_time\";\nexport const container_number = \"container_number\";\nexport const ufv_gkey = \"ufv_gkey\";\nexport const transit_state = \"transit_state\";\nexport const visit_state = \"visit_state\";\nexport const facility_code = \"facility_code\";\nexport const facility_code_list_provider = \"facility_code_list_provider\";\nexport const unlocode = \"unlocode\";\nexport const visit_ref_in = \"visit_ref_in\";\nexport const visit_ref_out = \"visit_ref_out\";\nexport const vessel_name = \"vessel_name\";\nexport const voyage_number = \"voyage_number\";\nexport const mode_of_transport = \"mode_of_transport\";\nexport const seals = \"seals\";\nexport const vgm_weight_kg = \"vgm_weight_kg\";\nexport const impediments = \"impediments\";\nexport const loaded_at = \"loaded_at\";\nexport const raw_data = \"raw_data\";\nexport const created_at = \"created_at\";\n"],
+  "mappings": "AAWO,MAAM,KAAK;AACX,MAAM,kBAAkB;AACxB,MAAM,YAAY;AAClB,MAAM,MAAM;AACZ,MAAM,SAAS;AACf,MAAM,kBAAkB;AACxB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,wBAAwB;AAC9B,MAAM,kBAAkB;AACxB,MAAM,mBAAmB;AACzB,MAAM,WAAW;AACjB,MAAM,gBAAgB;AACtB,MAAM,cAAc;AACpB,MAAM,gBAAgB;AACtB,MAAM,8BAA8B;AACpC,MAAM,WAAW;AACjB,MAAM,eAAe;AACrB,MAAM,gBAAgB;AACtB,MAAM,cAAc;AACpB,MAAM,gBAAgB;AACtB,MAAM,oBAAoB;AAC1B,MAAM,QAAQ;AACd,MAAM,gBAAgB;AACtB,MAAM,cAAc;AACpB,MAAM,YAAY;AAClB,MAAM,WAAW;AACjB,MAAM,aAAa;",
+  "names": []
+}

package/dist/generated/entities/terminal_tracking_job/index.js

@@ -0,0 +1,37 @@
+const id = "id";
+const organization_id = "organization_id";
+const tenant_id = "tenant_id";
+const terminal_code = "terminal_code";
+const container_number = "container_number";
+const status = "status";
+const schedule = "schedule";
+const next_poll_at = "next_poll_at";
+const last_poll_at = "last_poll_at";
+const retry_count = "retry_count";
+const error_history = "error_history";
+const empty_ready_at = "empty_ready_at";
+const holds_cleared_at = "holds_cleared_at";
+const created_at = "created_at";
+const updated_at = "updated_at";
+const deleted_at = "deleted_at";
+const events = "events";
+export {
+  container_number,
+  created_at,
+  deleted_at,
+  empty_ready_at,
+  error_history,
+  events,
+  holds_cleared_at,
+  id,
+  last_poll_at,
+  next_poll_at,
+  organization_id,
+  retry_count,
+  schedule,
+  status,
+  tenant_id,
+  terminal_code,
+  updated_at
+};
+//# sourceMappingURL=index.js.map

package/dist/generated/entities/terminal_tracking_job/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../generated/entities/terminal_tracking_job/index.ts"],
+  "sourcesContent": ["// AUTO-GENERATED by scripts/generate-entity-fields.mjs (HEDGE-168). Do not edit.\n//\n// One file per entity, named `toSnake(ClassName)` \u2014 NOT the table name. Each\n// export is a database column name, mirroring what `mercato generate` writes\n// for `@open-mercato/*` packages. `loadStandaloneGeneratedPackageEntities()`\n// reads these back to build the host app's `entity-fields-registry.ts`, which\n// is what the Encryption and Translation managers list fields from.\n//\n// Regenerate with `node scripts/generate-entity-fields.mjs --all`; the package\n// build does it for you. Guarded by\n// `apps/web/src/__tests__/entity-fields-registry-contract.test.ts`.\nexport const id = \"id\";\nexport const organization_id = \"organization_id\";\nexport const tenant_id = \"tenant_id\";\nexport const terminal_code = \"terminal_code\";\nexport const container_number = \"container_number\";\nexport const status = \"status\";\nexport const schedule = \"schedule\";\nexport const next_poll_at = \"next_poll_at\";\nexport const last_poll_at = \"last_poll_at\";\nexport const retry_count = \"retry_count\";\nexport const error_history = \"error_history\";\nexport const empty_ready_at = \"empty_ready_at\";\nexport const holds_cleared_at = \"holds_cleared_at\";\nexport const created_at = \"created_at\";\nexport const updated_at = \"updated_at\";\nexport const deleted_at = \"deleted_at\";\nexport const events = \"events\";\n"],
+  "mappings": "AAWO,MAAM,KAAK;AACX,MAAM,kBAAkB;AACxB,MAAM,YAAY;AAClB,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AACzB,MAAM,SAAS;AACf,MAAM,WAAW;AACjB,MAAM,eAAe;AACrB,MAAM,eAAe;AACrB,MAAM,cAAc;AACpB,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AACvB,MAAM,mBAAmB;AACzB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,aAAa;AACnB,MAAM,SAAS;",
+  "names": []
+}

package/dist/generated/entities/terminal_vessel_visit/index.js

@@ -0,0 +1,41 @@
+const id = "id";
+const organization_id = "organization_id";
+const tenant_id = "tenant_id";
+const terminal_code = "terminal_code";
+const visit_ref = "visit_ref";
+const vessel_name = "vessel_name";
+const ib_voyage = "ib_voyage";
+const ob_voyage = "ob_voyage";
+const line = "line";
+const phase = "phase";
+const eta = "eta";
+const etd = "etd";
+const ata = "ata";
+const atd = "atd";
+const begin_receive = "begin_receive";
+const dry_cutoff = "dry_cutoff";
+const raw_data = "raw_data";
+const created_at = "created_at";
+const updated_at = "updated_at";
+export {
+  ata,
+  atd,
+  begin_receive,
+  created_at,
+  dry_cutoff,
+  eta,
+  etd,
+  ib_voyage,
+  id,
+  line,
+  ob_voyage,
+  organization_id,
+  phase,
+  raw_data,
+  tenant_id,
+  terminal_code,
+  updated_at,
+  vessel_name,
+  visit_ref
+};
+//# sourceMappingURL=index.js.map

package/dist/generated/entities/terminal_vessel_visit/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../generated/entities/terminal_vessel_visit/index.ts"],
+  "sourcesContent": ["// AUTO-GENERATED by scripts/generate-entity-fields.mjs (HEDGE-168). Do not edit.\n//\n// One file per entity, named `toSnake(ClassName)` \u2014 NOT the table name. Each\n// export is a database column name, mirroring what `mercato generate` writes\n// for `@open-mercato/*` packages. `loadStandaloneGeneratedPackageEntities()`\n// reads these back to build the host app's `entity-fields-registry.ts`, which\n// is what the Encryption and Translation managers list fields from.\n//\n// Regenerate with `node scripts/generate-entity-fields.mjs --all`; the package\n// build does it for you. Guarded by\n// `apps/web/src/__tests__/entity-fields-registry-contract.test.ts`.\nexport const id = \"id\";\nexport const organization_id = \"organization_id\";\nexport const tenant_id = \"tenant_id\";\nexport const terminal_code = \"terminal_code\";\nexport const visit_ref = \"visit_ref\";\nexport const vessel_name = \"vessel_name\";\nexport const ib_voyage = \"ib_voyage\";\nexport const ob_voyage = \"ob_voyage\";\nexport const line = \"line\";\nexport const phase = \"phase\";\nexport const eta = \"eta\";\nexport const etd = \"etd\";\nexport const ata = \"ata\";\nexport const atd = \"atd\";\nexport const begin_receive = \"begin_receive\";\nexport const dry_cutoff = \"dry_cutoff\";\nexport const raw_data = \"raw_data\";\nexport const created_at = \"created_at\";\nexport const updated_at = \"updated_at\";\n"],
+  "mappings": "AAWO,MAAM,KAAK;AACX,MAAM,kBAAkB;AACxB,MAAM,YAAY;AAClB,MAAM,gBAAgB;AACtB,MAAM,YAAY;AAClB,MAAM,cAAc;AACpB,MAAM,YAAY;AAClB,MAAM,YAAY;AAClB,MAAM,OAAO;AACb,MAAM,QAAQ;AACd,MAAM,MAAM;AACZ,MAAM,MAAM;AACZ,MAAM,MAAM;AACZ,MAAM,MAAM;AACZ,MAAM,gBAAgB;AACtB,MAAM,aAAa;AACnB,MAAM,WAAW;AACjB,MAAM,aAAa;AACnB,MAAM,aAAa;",
+  "names": []
+}

package/dist/generated/entities.ids.generated.js

@@ -0,0 +1,26 @@
+const M = {
+  terminal_tracking: "terminal_tracking"
+};
+const E = {
+  terminal_tracking: {
+    terminal_config: "terminal_tracking:terminal_config",
+    // HEDGE-164: `tracking_job` matches NO class in `data/entities.ts`. The
+    // real entity is `TerminalTrackingJob` -> `terminal_tracking_job`, added
+    // below; this key is a hand-written guess that has been reaching the host
+    // registry as a phantom id ever since. It is left in place rather than
+    // deleted because `ce.ts` registers a custom-entity record against
+    // `terminal_tracking:tracking_job`, and removing the id could orphan
+    // custom-field definitions already configured against it in a customer
+    // database. Removal needs a production check of `custom_field_def` /
+    // `custom_field_value` first and is tracked separately from this fix.
+    tracking_job: "terminal_tracking:tracking_job",
+    terminal_event: "terminal_tracking:terminal_event",
+    terminal_tracking_job: "terminal_tracking:terminal_tracking_job",
+    terminal_vessel_visit: "terminal_tracking:terminal_vessel_visit"
+  }
+};
+export {
+  E,
+  M
+};
+//# sourceMappingURL=entities.ids.generated.js.map

package/dist/generated/entities.ids.generated.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../generated/entities.ids.generated.ts"],
+  "sourcesContent": ["// Entity ids for `@freighttech/terminal-tracking` \u2014 HAND-MAINTAINED and AUTHORITATIVE.\n//\n// This header used to say \"local typecheck stub\", owned at runtime by apps/web.\n// Both halves were false, and HEDGE-164 is what that cost. Nothing regenerates\n// this file \u2014 `yarn generate` rewrites `generated/` only for modules declared\n// `from: '@app'`. And it is not merely a typecheck aid: because\n// `@open-mercato/core` installs as a real directory rather than a workspace\n// symlink, `@open-mercato/cli` runs in STANDALONE mode, where\n// `loadStandaloneGeneratedPackageEntities()` reads THIS file as the package's\n// entity list and uses it INSTEAD of parsing `data/entities.ts`.\n//\n// An entity missing here is therefore missing from the host app's `E`, and `E`\n// is a runtime registry rather than a bag of types: it backs the custom-field\n// entity picker, query-index coverage and reindex, attachment assignment,\n// dashboard widget sources and encryption field resolution. The entity's table,\n// migrations and repositories keep working the whole time, which is why the\n// failure reads as \"the feature was never built\" instead of as an error.\n//\n// One key per exported class in `data/entities.ts`, keyed `toSnake(ClassName)`\n// with NO pluralisation \u2014 `InvoiceOrderLine` is `invoice_order_line`, never the\n// `tableName`. Namespaces for OTHER modules are typecheck-only; the generator\n// reads `E['<this module id>']` and ignores the rest.\n//\n// The mechanism in full, and the guard that fails the gate when this file and\n// `data/entities.ts` drift apart:\n// `apps/web/src/__tests__/entity-ids-registry-contract.test.ts`.\n\nexport const M = {\n  terminal_tracking: 'terminal_tracking',\n} as const\n\nexport const E = {\n  terminal_tracking: {\n    terminal_config: 'terminal_tracking:terminal_config',\n    // HEDGE-164: `tracking_job` matches NO class in `data/entities.ts`. The\n    // real entity is `TerminalTrackingJob` -> `terminal_tracking_job`, added\n    // below; this key is a hand-written guess that has been reaching the host\n    // registry as a phantom id ever since. It is left in place rather than\n    // deleted because `ce.ts` registers a custom-entity record against\n    // `terminal_tracking:tracking_job`, and removing the id could orphan\n    // custom-field definitions already configured against it in a customer\n    // database. Removal needs a production check of `custom_field_def` /\n    // `custom_field_value` first and is tracked separately from this fix.\n    tracking_job: 'terminal_tracking:tracking_job',\n    terminal_event: 'terminal_tracking:terminal_event',\n    terminal_tracking_job: 'terminal_tracking:terminal_tracking_job',\n    terminal_vessel_visit: 'terminal_tracking:terminal_vessel_visit',\n  },\n} as const\n\nexport type KnownModuleId = keyof typeof M\nexport type KnownEntities = typeof E\n"],
+  "mappings": "AA2BO,MAAM,IAAI;AAAA,EACf,mBAAmB;AACrB;AAEO,MAAM,IAAI;AAAA,EACf,mBAAmB;AAAA,IACjB,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUjB,cAAc;AAAA,IACd,gBAAgB;AAAA,IAChB,uBAAuB;AAAA,IACvB,uBAAuB;AAAA,EACzB;AACF;",
+  "names": []
+}

package/dist/index.js

@@ -0,0 +1,20 @@
+import {
+  TerminalConfig,
+  TerminalTrackingJob,
+  TerminalEvent
+} from "./modules/terminal_tracking/data/entities.js";
+import { TerminalRegistry } from "./modules/terminal_tracking/services/terminalRegistry.js";
+import { TerminalTrackingService } from "./modules/terminal_tracking/services/terminalTrackingService.js";
+import { TerminalMatcherService } from "./modules/terminal_tracking/services/terminalMatcherService.js";
+import { eventsConfig, emitTerminalTrackingEvent } from "./modules/terminal_tracking/events.js";
+export {
+  TerminalConfig,
+  TerminalEvent,
+  TerminalMatcherService,
+  TerminalRegistry,
+  TerminalTrackingJob,
+  TerminalTrackingService,
+  emitTerminalTrackingEvent,
+  eventsConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["/**\n * @freighttech/terminal-tracking\n *\n * Container terminal (Navis N4) tracking: per-terminal config, periodic\n * polling, container event emission, and terminal matching.\n */\n\n// Entities\nexport {\n  TerminalConfig,\n  TerminalTrackingJob,\n  TerminalEvent,\n} from './modules/terminal_tracking/data/entities'\n\n// Types\nexport type {\n  TerminalEventType,\n  TerminalEventClassifierCode,\n  TerminalEventSource,\n  FacilityCodeProvider,\n  TerminalModeOfTransport,\n  TerminalAuthType,\n  TerminalTrackingJobStatus,\n  TerminalEndpoints,\n  TerminalSealInfo,\n} from './modules/terminal_tracking/data/entities'\n\n// Adapter contract\nexport type {\n  TerminalAdapter,\n  TerminalFetchedEvent,\n  TerminalFetchResult,\n  TerminalAdapterTestResult,\n  ResolvedTerminalConfig,\n} from './modules/terminal_tracking/lib/terminal-adapter'\n\n// Services\nexport { TerminalRegistry } from './modules/terminal_tracking/services/terminalRegistry'\nexport { TerminalTrackingService } from './modules/terminal_tracking/services/terminalTrackingService'\nexport { TerminalMatcherService } from './modules/terminal_tracking/services/terminalMatcherService'\n\n// Events\nexport { eventsConfig, emitTerminalTrackingEvent } from './modules/terminal_tracking/events'\nexport type { TerminalTrackingEventId } from './modules/terminal_tracking/events'\n"],
+  "mappings": "AAQA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAyBP,SAAS,wBAAwB;AACjC,SAAS,+BAA+B;AACxC,SAAS,8BAA8B;AAGvC,SAAS,cAAc,iCAAiC;",
+  "names": []
+}

package/dist/modules/terminal_tracking/acl.js

@@ -0,0 +1,14 @@
+const features = [
+  { id: "terminal_tracking.terminal_configs.view", title: "View Terminal Configs", module: "terminal_tracking" },
+  { id: "terminal_tracking.terminal_configs.manage", title: "Manage Terminal Configs", module: "terminal_tracking" },
+  { id: "terminal_tracking.tracking_jobs.view", title: "View Terminal Tracking Jobs", module: "terminal_tracking" },
+  { id: "terminal_tracking.tracking_jobs.manage", title: "Manage Terminal Tracking Jobs", module: "terminal_tracking" },
+  { id: "terminal_tracking.events.view", title: "View Terminal Events", module: "terminal_tracking" },
+  { id: "terminal_tracking.settings.manage", title: "Manage Terminal Tracking Settings", module: "terminal_tracking" }
+];
+var acl_default = features;
+export {
+  acl_default as default,
+  features
+};
+//# sourceMappingURL=acl.js.map

package/dist/modules/terminal_tracking/acl.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/terminal_tracking/acl.ts"],
+  "sourcesContent": ["export const features = [\n  { id: 'terminal_tracking.terminal_configs.view', title: 'View Terminal Configs', module: 'terminal_tracking' },\n  { id: 'terminal_tracking.terminal_configs.manage', title: 'Manage Terminal Configs', module: 'terminal_tracking' },\n  { id: 'terminal_tracking.tracking_jobs.view', title: 'View Terminal Tracking Jobs', module: 'terminal_tracking' },\n  { id: 'terminal_tracking.tracking_jobs.manage', title: 'Manage Terminal Tracking Jobs', module: 'terminal_tracking' },\n  { id: 'terminal_tracking.events.view', title: 'View Terminal Events', module: 'terminal_tracking' },\n  { id: 'terminal_tracking.settings.manage', title: 'Manage Terminal Tracking Settings', module: 'terminal_tracking' },\n]\n\nexport default features\n"],
+  "mappings": "AAAO,MAAM,WAAW;AAAA,EACtB,EAAE,IAAI,2CAA2C,OAAO,yBAAyB,QAAQ,oBAAoB;AAAA,EAC7G,EAAE,IAAI,6CAA6C,OAAO,2BAA2B,QAAQ,oBAAoB;AAAA,EACjH,EAAE,IAAI,wCAAwC,OAAO,+BAA+B,QAAQ,oBAAoB;AAAA,EAChH,EAAE,IAAI,0CAA0C,OAAO,iCAAiC,QAAQ,oBAAoB;AAAA,EACpH,EAAE,IAAI,iCAAiC,OAAO,wBAAwB,QAAQ,oBAAoB;AAAA,EAClG,EAAE,IAAI,qCAAqC,OAAO,qCAAqC,QAAQ,oBAAoB;AACrH;AAEA,IAAO,cAAQ;",
+  "names": []
+}

package/dist/modules/terminal_tracking/api/openapi.js

@@ -0,0 +1,27 @@
+import {
+  createCrudOpenApiFactory,
+  createPagedListResponseSchema as createSharedPagedListResponseSchema,
+  defaultCreateResponseSchema as sharedDefaultCreateResponseSchema,
+  defaultOkResponseSchema as sharedDefaultOkResponseSchema
+} from "@open-mercato/shared/lib/openapi/crud";
+const defaultCreateResponseSchema = sharedDefaultCreateResponseSchema;
+const defaultOkResponseSchema = sharedDefaultOkResponseSchema;
+function createPagedListResponseSchema(itemSchema) {
+  return createSharedPagedListResponseSchema(itemSchema, { paginationMetaOptional: true });
+}
+const buildTerminalTrackingCrudOpenApi = createCrudOpenApiFactory({
+  defaultTag: "Terminal Tracking",
+  defaultCreateResponseSchema,
+  defaultOkResponseSchema,
+  makeListDescription: ({ pluralLower }) => `Returns a paginated collection of ${pluralLower} scoped to the authenticated organization.`
+});
+function createTerminalTrackingCrudOpenApi(options) {
+  return buildTerminalTrackingCrudOpenApi(options);
+}
+export {
+  createPagedListResponseSchema,
+  createTerminalTrackingCrudOpenApi,
+  defaultCreateResponseSchema,
+  defaultOkResponseSchema
+};
+//# sourceMappingURL=openapi.js.map

package/dist/modules/terminal_tracking/api/openapi.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/api/openapi.ts"],
+  "sourcesContent": ["import { type ZodTypeAny } from 'zod'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport {\n  createCrudOpenApiFactory,\n  createPagedListResponseSchema as createSharedPagedListResponseSchema,\n  defaultCreateResponseSchema as sharedDefaultCreateResponseSchema,\n  defaultOkResponseSchema as sharedDefaultOkResponseSchema,\n  type CrudOpenApiOptions,\n} from '@open-mercato/shared/lib/openapi/crud'\n\nexport const defaultCreateResponseSchema = sharedDefaultCreateResponseSchema\nexport const defaultOkResponseSchema = sharedDefaultOkResponseSchema\n\nexport function createPagedListResponseSchema(itemSchema: ZodTypeAny) {\n  return createSharedPagedListResponseSchema(itemSchema, { paginationMetaOptional: true })\n}\n\nconst buildTerminalTrackingCrudOpenApi = createCrudOpenApiFactory({\n  defaultTag: 'Terminal Tracking',\n  defaultCreateResponseSchema,\n  defaultOkResponseSchema,\n  makeListDescription: ({ pluralLower }) =>\n    `Returns a paginated collection of ${pluralLower} scoped to the authenticated organization.`,\n})\n\nexport function createTerminalTrackingCrudOpenApi(options: CrudOpenApiOptions): OpenApiRouteDoc {\n  return buildTerminalTrackingCrudOpenApi(options)\n}\n"],
+  "mappings": "AAEA;AAAA,EACE;AAAA,EACA,iCAAiC;AAAA,EACjC,+BAA+B;AAAA,EAC/B,2BAA2B;AAAA,OAEtB;AAEA,MAAM,8BAA8B;AACpC,MAAM,0BAA0B;AAEhC,SAAS,8BAA8B,YAAwB;AACpE,SAAO,oCAAoC,YAAY,EAAE,wBAAwB,KAAK,CAAC;AACzF;AAEA,MAAM,mCAAmC,yBAAyB;AAAA,EAChE,YAAY;AAAA,EACZ;AAAA,EACA;AAAA,EACA,qBAAqB,CAAC,EAAE,YAAY,MAClC,qCAAqC,WAAW;AACpD,CAAC;AAEM,SAAS,kCAAkC,SAA8C;AAC9F,SAAO,iCAAiC,OAAO;AACjD;",
+  "names": []
+}