@freighttech/terminal-tracking 0.7.0

package/dist/modules/terminal_tracking/lib/totp.js

@@ -0,0 +1,41 @@
+import crypto from "crypto";
+const BASE32_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+function base32Decode(input) {
+  const clean = input.replace(/=+$/g, "").replace(/\s+/g, "").toUpperCase();
+  let bits = 0;
+  let value = 0;
+  const bytes = [];
+  for (const ch of clean) {
+    const idx = BASE32_ALPHABET.indexOf(ch);
+    if (idx === -1) throw new Error("totp: invalid base32 character in secret");
+    value = value << 5 | idx;
+    bits += 5;
+    if (bits >= 8) {
+      bytes.push(value >>> bits - 8 & 255);
+      bits -= 8;
+    }
+  }
+  return Buffer.from(bytes);
+}
+const TOTP_PERIOD_SECONDS = 30;
+const TOTP_DIGITS = 6;
+function hotp(secret, counter) {
+  const buf = Buffer.alloc(8);
+  buf.writeUInt32BE(Math.floor(counter / 4294967296), 0);
+  buf.writeUInt32BE(counter >>> 0, 4);
+  const hmac = crypto.createHmac("sha1", secret).update(buf).digest();
+  const offset = hmac[hmac.length - 1] & 15;
+  const binary = (hmac[offset] & 127) << 24 | (hmac[offset + 1] & 255) << 16 | (hmac[offset + 2] & 255) << 8 | hmac[offset + 3] & 255;
+  return (binary % 10 ** TOTP_DIGITS).toString().padStart(TOTP_DIGITS, "0");
+}
+function generateTotp(base32Secret, nowMs = Date.now()) {
+  const counter = Math.floor(nowMs / 1e3 / TOTP_PERIOD_SECONDS);
+  return hotp(base32Decode(base32Secret), counter);
+}
+export {
+  TOTP_DIGITS,
+  TOTP_PERIOD_SECONDS,
+  base32Decode,
+  generateTotp
+};
+//# sourceMappingURL=totp.js.map

package/dist/modules/terminal_tracking/lib/totp.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/lib/totp.ts"],
+  "sourcesContent": ["/**\n * TOTP (RFC 6238) code generation for terminal adapters whose login expects an\n * authenticator one-time code in place of a static password (e.g. GCT).\n *\n * This is a deliberate, self-contained COPY of the generation half of\n * `packages/two-factor/src/modules/two_factor/lib/totp.ts` \u2014 kept in sync by\n * hand. We copy rather than depend on `@freighttech/two-factor` so this backend\n * tracking module stays dependency-light (only `fuse.js` + `undici`) and free of\n * that package's Next/React/mikro-orm peer deps. The algorithm is pure Node\n * `crypto`; only the consume-side pieces are copied (base32 decode + HOTP +\n * `generateTotp`) \u2014 enrollment helpers (secret/QR generation, verification) live\n * in the two-factor package and are not needed here.\n *\n * Parameters match a standard authenticator app: SHA1, 6 digits, 30s period.\n */\nimport crypto from 'crypto'\n\n// \u2500\u2500 Base32 (RFC 4648, no padding) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nconst BASE32_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567'\n\n/** Decode a base32 authenticator secret into its raw key bytes. */\nexport function base32Decode(input: string): Buffer {\n  const clean = input.replace(/=+$/g, '').replace(/\\s+/g, '').toUpperCase()\n  let bits = 0\n  let value = 0\n  const bytes: number[] = []\n  for (const ch of clean) {\n    const idx = BASE32_ALPHABET.indexOf(ch)\n    if (idx === -1) throw new Error('totp: invalid base32 character in secret')\n    value = (value << 5) | idx\n    bits += 5\n    if (bits >= 8) {\n      bytes.push((value >>> (bits - 8)) & 0xff)\n      bits -= 8\n    }\n  }\n  return Buffer.from(bytes)\n}\n\n// \u2500\u2500 TOTP (RFC 6238) over HOTP (RFC 4226) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\nexport const TOTP_PERIOD_SECONDS = 30\nexport const TOTP_DIGITS = 6\n\nfunction hotp(secret: Buffer, counter: number): string {\n  const buf = Buffer.alloc(8)\n  // 64-bit big-endian counter (JS bitops are 32-bit, so split hi/lo).\n  buf.writeUInt32BE(Math.floor(counter / 0x100000000), 0)\n  buf.writeUInt32BE(counter >>> 0, 4)\n  const hmac = crypto.createHmac('sha1', secret).update(buf).digest()\n  const offset = hmac[hmac.length - 1] & 0xf\n  const binary =\n    ((hmac[offset] & 0x7f) << 24) |\n    ((hmac[offset + 1] & 0xff) << 16) |\n    ((hmac[offset + 2] & 0xff) << 8) |\n    (hmac[offset + 3] & 0xff)\n  return (binary % 10 ** TOTP_DIGITS).toString().padStart(TOTP_DIGITS, '0')\n}\n\n/** Compute the current TOTP code for a base32 secret (default time: now). */\nexport function generateTotp(base32Secret: string, nowMs: number = Date.now()): string {\n  const counter = Math.floor(nowMs / 1000 / TOTP_PERIOD_SECONDS)\n  return hotp(base32Decode(base32Secret), counter)\n}\n"],
+  "mappings": "AAeA,OAAO,YAAY;AAGnB,MAAM,kBAAkB;AAGjB,SAAS,aAAa,OAAuB;AAClD,QAAM,QAAQ,MAAM,QAAQ,QAAQ,EAAE,EAAE,QAAQ,QAAQ,EAAE,EAAE,YAAY;AACxE,MAAI,OAAO;AACX,MAAI,QAAQ;AACZ,QAAM,QAAkB,CAAC;AACzB,aAAW,MAAM,OAAO;AACtB,UAAM,MAAM,gBAAgB,QAAQ,EAAE;AACtC,QAAI,QAAQ,GAAI,OAAM,IAAI,MAAM,0CAA0C;AAC1E,YAAS,SAAS,IAAK;AACvB,YAAQ;AACR,QAAI,QAAQ,GAAG;AACb,YAAM,KAAM,UAAW,OAAO,IAAM,GAAI;AACxC,cAAQ;AAAA,IACV;AAAA,EACF;AACA,SAAO,OAAO,KAAK,KAAK;AAC1B;AAGO,MAAM,sBAAsB;AAC5B,MAAM,cAAc;AAE3B,SAAS,KAAK,QAAgB,SAAyB;AACrD,QAAM,MAAM,OAAO,MAAM,CAAC;AAE1B,MAAI,cAAc,KAAK,MAAM,UAAU,UAAW,GAAG,CAAC;AACtD,MAAI,cAAc,YAAY,GAAG,CAAC;AAClC,QAAM,OAAO,OAAO,WAAW,QAAQ,MAAM,EAAE,OAAO,GAAG,EAAE,OAAO;AAClE,QAAM,SAAS,KAAK,KAAK,SAAS,CAAC,IAAI;AACvC,QAAM,UACF,KAAK,MAAM,IAAI,QAAS,MACxB,KAAK,SAAS,CAAC,IAAI,QAAS,MAC5B,KAAK,SAAS,CAAC,IAAI,QAAS,IAC7B,KAAK,SAAS,CAAC,IAAI;AACtB,UAAQ,SAAS,MAAM,aAAa,SAAS,EAAE,SAAS,aAAa,GAAG;AAC1E;AAGO,SAAS,aAAa,cAAsB,QAAgB,KAAK,IAAI,GAAW;AACrF,QAAM,UAAU,KAAK,MAAM,QAAQ,MAAO,mBAAmB;AAC7D,SAAO,KAAK,aAAa,YAAY,GAAG,OAAO;AACjD;",
+  "names": []
+}

package/dist/modules/terminal_tracking/migrations/Migration20260609120000_terminal_tracking.js

@@ -0,0 +1,101 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260609120000_terminal_tracking extends Migration {
+  async up() {
+    this.addSql(`create table if not exists "terminal_tracking_terminal_configs" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "terminal_code" text not null,
+      "adapter_type" text not null,
+      "display_name" text not null,
+      "base_url" text not null,
+      "endpoints" jsonb not null,
+      "auth_type" text not null,
+      "token_url" text null,
+      "scope" text null,
+      "client_id" text null,
+      "auth_config" jsonb null,
+      "rate_limit_requests" integer not null default 200,
+      "rate_limit_window_seconds" integer not null default 60,
+      "unlocode" varchar(5) null,
+      "bic_codes" jsonb null,
+      "smdg_codes" jsonb null,
+      "name_aliases" 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,
+      constraint "terminal_tracking_terminal_configs_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index if not exists "tt_terminal_configs_org_tenant_idx" on "terminal_tracking_terminal_configs" ("organization_id", "tenant_id");`);
+    this.addSql(`create unique index if not exists "tt_terminal_configs_code_uniq" on "terminal_tracking_terminal_configs" ("organization_id", "tenant_id", "terminal_code");`);
+    this.addSql(`create table if not exists "terminal_tracking_jobs" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "terminal_code" text not null,
+      "container_number" text not null,
+      "status" text not null default 'active',
+      "schedule" jsonb null,
+      "next_poll_at" timestamptz null,
+      "last_poll_at" timestamptz null,
+      "retry_count" integer 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 "terminal_tracking_jobs_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index if not exists "tt_jobs_org_tenant_idx" on "terminal_tracking_jobs" ("organization_id", "tenant_id");`);
+    this.addSql(`create index if not exists "tt_jobs_status_idx" on "terminal_tracking_jobs" ("status");`);
+    this.addSql(`create index if not exists "tt_jobs_next_poll_idx" on "terminal_tracking_jobs" ("next_poll_at");`);
+    this.addSql(`create index if not exists "tt_jobs_container_idx" on "terminal_tracking_jobs" ("container_number");`);
+    this.addSql(`create table if not exists "terminal_tracking_events" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "job_id" uuid not null,
+      "source" text not null default 'terminal',
+      "source_event_id" text not null,
+      "event_type" text not null,
+      "event_code" text not null,
+      "event_classifier_code" text null,
+      "event_date_time" timestamptz not null,
+      "container_number" text not null,
+      "ufv_gkey" text not null,
+      "transit_state" text null,
+      "visit_state" text null,
+      "facility_code" text null,
+      "facility_code_list_provider" text null,
+      "unlocode" varchar(5) null,
+      "visit_ref_in" text null,
+      "visit_ref_out" text null,
+      "vessel_name" text null,
+      "voyage_number" text null,
+      "mode_of_transport" text null,
+      "seals" jsonb null,
+      "vgm_weight_kg" double precision null,
+      "impediments" jsonb null,
+      "raw_data" jsonb null,
+      "created_at" timestamptz not null default now(),
+      constraint "terminal_tracking_events_pkey" primary key ("id")
+    );`);
+    this.addSql(`do $$ begin alter table "terminal_tracking_events"
+      add constraint "terminal_tracking_events_job_id_foreign"
+      foreign key ("job_id") references "terminal_tracking_jobs" ("id") on update cascade on delete cascade; exception when duplicate_object then null; when duplicate_table then null; end $$;`);
+    this.addSql(`create index if not exists "tt_events_org_tenant_idx" on "terminal_tracking_events" ("organization_id", "tenant_id");`);
+    this.addSql(`create index if not exists "tt_events_job_idx" on "terminal_tracking_events" ("job_id");`);
+    this.addSql(`create index if not exists "tt_events_container_idx" on "terminal_tracking_events" ("container_number");`);
+    this.addSql(`create index if not exists "tt_events_event_date_idx" on "terminal_tracking_events" ("event_date_time");`);
+    this.addSql(`create unique index if not exists "tt_events_source_event_uniq" on "terminal_tracking_events" ("job_id", "source", "source_event_id");`);
+  }
+  async down() {
+    this.addSql(`drop table if exists "terminal_tracking_events" cascade;`);
+    this.addSql(`drop table if exists "terminal_tracking_jobs" cascade;`);
+    this.addSql(`drop table if exists "terminal_tracking_terminal_configs" cascade;`);
+  }
+}
+export {
+  Migration20260609120000_terminal_tracking
+};
+//# sourceMappingURL=Migration20260609120000_terminal_tracking.js.map

package/dist/modules/terminal_tracking/migrations/Migration20260609120000_terminal_tracking.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/migrations/Migration20260609120000_terminal_tracking.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations'\n\nexport class Migration20260609120000_terminal_tracking extends Migration {\n  override async up(): Promise<void> {\n    // \u2500\u2500\u2500 terminal_tracking_terminal_configs \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table if not exists \"terminal_tracking_terminal_configs\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"terminal_code\" text not null,\n      \"adapter_type\" text not null,\n      \"display_name\" text not null,\n      \"base_url\" text not null,\n      \"endpoints\" jsonb not null,\n      \"auth_type\" text not null,\n      \"token_url\" text null,\n      \"scope\" text null,\n      \"client_id\" text null,\n      \"auth_config\" jsonb null,\n      \"rate_limit_requests\" integer not null default 200,\n      \"rate_limit_window_seconds\" integer not null default 60,\n      \"unlocode\" varchar(5) null,\n      \"bic_codes\" jsonb null,\n      \"smdg_codes\" jsonb null,\n      \"name_aliases\" jsonb null,\n      \"is_active\" boolean not null default true,\n      \"created_at\" timestamptz not null default now(),\n      \"updated_at\" timestamptz not null default now(),\n      \"deleted_at\" timestamptz null,\n      constraint \"terminal_tracking_terminal_configs_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`create index if not exists \"tt_terminal_configs_org_tenant_idx\" on \"terminal_tracking_terminal_configs\" (\"organization_id\", \"tenant_id\");`)\n    this.addSql(`create unique index if not exists \"tt_terminal_configs_code_uniq\" on \"terminal_tracking_terminal_configs\" (\"organization_id\", \"tenant_id\", \"terminal_code\");`)\n\n    // \u2500\u2500\u2500 terminal_tracking_jobs \u2500\u2500\u2500\u2500\u2500\u2500\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    this.addSql(`create table if not exists \"terminal_tracking_jobs\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"terminal_code\" text not null,\n      \"container_number\" text not null,\n      \"status\" text not null default 'active',\n      \"schedule\" jsonb null,\n      \"next_poll_at\" timestamptz null,\n      \"last_poll_at\" timestamptz null,\n      \"retry_count\" integer not null default 0,\n      \"error_history\" jsonb null,\n      \"created_at\" timestamptz not null default now(),\n      \"updated_at\" timestamptz not null default now(),\n      \"deleted_at\" timestamptz null,\n      constraint \"terminal_tracking_jobs_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`create index if not exists \"tt_jobs_org_tenant_idx\" on \"terminal_tracking_jobs\" (\"organization_id\", \"tenant_id\");`)\n    this.addSql(`create index if not exists \"tt_jobs_status_idx\" on \"terminal_tracking_jobs\" (\"status\");`)\n    this.addSql(`create index if not exists \"tt_jobs_next_poll_idx\" on \"terminal_tracking_jobs\" (\"next_poll_at\");`)\n    this.addSql(`create index if not exists \"tt_jobs_container_idx\" on \"terminal_tracking_jobs\" (\"container_number\");`)\n\n    // \u2500\u2500\u2500 terminal_tracking_events \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table if not exists \"terminal_tracking_events\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"job_id\" uuid not null,\n      \"source\" text not null default 'terminal',\n      \"source_event_id\" text not null,\n      \"event_type\" text not null,\n      \"event_code\" text not null,\n      \"event_classifier_code\" text null,\n      \"event_date_time\" timestamptz not null,\n      \"container_number\" text not null,\n      \"ufv_gkey\" text not null,\n      \"transit_state\" text null,\n      \"visit_state\" text null,\n      \"facility_code\" text null,\n      \"facility_code_list_provider\" text null,\n      \"unlocode\" varchar(5) null,\n      \"visit_ref_in\" text null,\n      \"visit_ref_out\" text null,\n      \"vessel_name\" text null,\n      \"voyage_number\" text null,\n      \"mode_of_transport\" text null,\n      \"seals\" jsonb null,\n      \"vgm_weight_kg\" double precision null,\n      \"impediments\" jsonb null,\n      \"raw_data\" jsonb null,\n      \"created_at\" timestamptz not null default now(),\n      constraint \"terminal_tracking_events_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`do $$ begin alter table \"terminal_tracking_events\"\n      add constraint \"terminal_tracking_events_job_id_foreign\"\n      foreign key (\"job_id\") references \"terminal_tracking_jobs\" (\"id\") on update cascade on delete cascade; exception when duplicate_object then null; when duplicate_table then null; end $$;`)\n    this.addSql(`create index if not exists \"tt_events_org_tenant_idx\" on \"terminal_tracking_events\" (\"organization_id\", \"tenant_id\");`)\n    this.addSql(`create index if not exists \"tt_events_job_idx\" on \"terminal_tracking_events\" (\"job_id\");`)\n    this.addSql(`create index if not exists \"tt_events_container_idx\" on \"terminal_tracking_events\" (\"container_number\");`)\n    this.addSql(`create index if not exists \"tt_events_event_date_idx\" on \"terminal_tracking_events\" (\"event_date_time\");`)\n    this.addSql(`create unique index if not exists \"tt_events_source_event_uniq\" on \"terminal_tracking_events\" (\"job_id\", \"source\", \"source_event_id\");`)\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`drop table if exists \"terminal_tracking_events\" cascade;`)\n    this.addSql(`drop table if exists \"terminal_tracking_jobs\" cascade;`)\n    this.addSql(`drop table if exists \"terminal_tracking_terminal_configs\" cascade;`)\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,kDAAkD,UAAU;AAAA,EACvE,MAAe,KAAoB;AAEjC,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAyBT;AACH,SAAK,OAAO,2IAA2I;AACvJ,SAAK,OAAO,8JAA8J;AAG1K,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAgBT;AACH,SAAK,OAAO,mHAAmH;AAC/H,SAAK,OAAO,yFAAyF;AACrG,SAAK,OAAO,kGAAkG;AAC9G,SAAK,OAAO,sGAAsG;AAGlH,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OA6BT;AACH,SAAK,OAAO;AAAA;AAAA,gMAEgL;AAC5L,SAAK,OAAO,uHAAuH;AACnI,SAAK,OAAO,0FAA0F;AACtG,SAAK,OAAO,0GAA0G;AACtH,SAAK,OAAO,0GAA0G;AACtH,SAAK,OAAO,wIAAwI;AAAA,EACtJ;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,0DAA0D;AACtE,SAAK,OAAO,wDAAwD;AACpE,SAAK,OAAO,oEAAoE;AAAA,EAClF;AACF;",
+  "names": []
+}

package/dist/modules/terminal_tracking/migrations/Migration20260610120000_terminal_vessel_visits.js

@@ -0,0 +1,39 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260610120000_terminal_vessel_visits extends Migration {
+  async up() {
+    this.addSql(`create table if not exists "terminal_tracking_vessel_visits" (
+      "id" uuid not null default gen_random_uuid(),
+      "organization_id" uuid not null,
+      "tenant_id" uuid not null,
+      "terminal_code" text not null,
+      "visit_ref" text not null,
+      "vessel_name" text null,
+      "ib_voyage" text null,
+      "ob_voyage" text null,
+      "line" text null,
+      "phase" text null,
+      "eta" timestamptz null,
+      "etd" timestamptz null,
+      "ata" timestamptz null,
+      "atd" timestamptz null,
+      "begin_receive" timestamptz null,
+      "dry_cutoff" timestamptz null,
+      "raw_data" jsonb null,
+      "created_at" timestamptz not null default now(),
+      "updated_at" timestamptz not null default now(),
+      constraint "terminal_tracking_vessel_visits_pkey" primary key ("id")
+    );`);
+    this.addSql(`create index if not exists "tt_vessel_visits_org_tenant_idx" on "terminal_tracking_vessel_visits" ("organization_id", "tenant_id");`);
+    this.addSql(`create index if not exists "tt_vessel_visits_visit_ref_idx" on "terminal_tracking_vessel_visits" ("visit_ref");`);
+    this.addSql(`create unique index if not exists "tt_vessel_visits_uniq" on "terminal_tracking_vessel_visits" ("organization_id", "tenant_id", "terminal_code", "visit_ref");`);
+    this.addSql(`alter table "terminal_tracking_terminal_configs" add column if not exists "vessel_cache_ttl_seconds" integer null;`);
+  }
+  async down() {
+    this.addSql(`alter table "terminal_tracking_terminal_configs" drop column if exists "vessel_cache_ttl_seconds";`);
+    this.addSql(`drop table if exists "terminal_tracking_vessel_visits" cascade;`);
+  }
+}
+export {
+  Migration20260610120000_terminal_vessel_visits
+};
+//# sourceMappingURL=Migration20260610120000_terminal_vessel_visits.js.map

package/dist/modules/terminal_tracking/migrations/Migration20260610120000_terminal_vessel_visits.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/migrations/Migration20260610120000_terminal_vessel_visits.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations'\n\nexport class Migration20260610120000_terminal_vessel_visits extends Migration {\n  override async up(): Promise<void> {\n    // \u2500\u2500\u2500 terminal_tracking_vessel_visits \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n    this.addSql(`create table if not exists \"terminal_tracking_vessel_visits\" (\n      \"id\" uuid not null default gen_random_uuid(),\n      \"organization_id\" uuid not null,\n      \"tenant_id\" uuid not null,\n      \"terminal_code\" text not null,\n      \"visit_ref\" text not null,\n      \"vessel_name\" text null,\n      \"ib_voyage\" text null,\n      \"ob_voyage\" text null,\n      \"line\" text null,\n      \"phase\" text null,\n      \"eta\" timestamptz null,\n      \"etd\" timestamptz null,\n      \"ata\" timestamptz null,\n      \"atd\" timestamptz null,\n      \"begin_receive\" timestamptz null,\n      \"dry_cutoff\" timestamptz null,\n      \"raw_data\" jsonb null,\n      \"created_at\" timestamptz not null default now(),\n      \"updated_at\" timestamptz not null default now(),\n      constraint \"terminal_tracking_vessel_visits_pkey\" primary key (\"id\")\n    );`)\n    this.addSql(`create index if not exists \"tt_vessel_visits_org_tenant_idx\" on \"terminal_tracking_vessel_visits\" (\"organization_id\", \"tenant_id\");`)\n    this.addSql(`create index if not exists \"tt_vessel_visits_visit_ref_idx\" on \"terminal_tracking_vessel_visits\" (\"visit_ref\");`)\n    this.addSql(`create unique index if not exists \"tt_vessel_visits_uniq\" on \"terminal_tracking_vessel_visits\" (\"organization_id\", \"tenant_id\", \"terminal_code\", \"visit_ref\");`)\n\n    // \u2500\u2500\u2500 terminal_tracking_terminal_configs: vessel cache TTL \u2500\n    this.addSql(`alter table \"terminal_tracking_terminal_configs\" add column if not exists \"vessel_cache_ttl_seconds\" integer null;`)\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"terminal_tracking_terminal_configs\" drop column if exists \"vessel_cache_ttl_seconds\";`)\n    this.addSql(`drop table if exists \"terminal_tracking_vessel_visits\" cascade;`)\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,uDAAuD,UAAU;AAAA,EAC5E,MAAe,KAAoB;AAEjC,SAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAqBT;AACH,SAAK,OAAO,qIAAqI;AACjJ,SAAK,OAAO,iHAAiH;AAC7H,SAAK,OAAO,gKAAgK;AAG5K,SAAK,OAAO,oHAAoH;AAAA,EAClI;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,oGAAoG;AAChH,SAAK,OAAO,iEAAiE;AAAA,EAC/E;AACF;",
+  "names": []
+}

package/dist/modules/terminal_tracking/migrations/Migration20260611120000_terminal_config_proxy.js

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

package/dist/modules/terminal_tracking/migrations/Migration20260611120000_terminal_config_proxy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/migrations/Migration20260611120000_terminal_config_proxy.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations'\n\nexport class Migration20260611120000_terminal_config_proxy extends Migration {\n  override async up(): Promise<void> {\n    this.addSql(`alter table \"terminal_tracking_terminal_configs\" add column if not exists \"proxy_url\" text null;`)\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"terminal_tracking_terminal_configs\" drop column if exists \"proxy_url\";`)\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,sDAAsD,UAAU;AAAA,EAC3E,MAAe,KAAoB;AACjC,SAAK,OAAO,kGAAkG;AAAA,EAChH;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,qFAAqF;AAAA,EACnG;AACF;",
+  "names": []
+}

package/dist/modules/terminal_tracking/migrations/Migration20260707120000_terminal_job_availability_markers.js

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

package/dist/modules/terminal_tracking/migrations/Migration20260707120000_terminal_job_availability_markers.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/migrations/Migration20260707120000_terminal_job_availability_markers.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations'\n\nexport class Migration20260707120000_terminal_job_availability_markers extends Migration {\n  override async up(): Promise<void> {\n    this.addSql(`alter table \"terminal_tracking_jobs\" add column if not exists \"empty_ready_at\" timestamptz null;`)\n    this.addSql(`alter table \"terminal_tracking_jobs\" add column if not exists \"holds_cleared_at\" timestamptz null;`)\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"terminal_tracking_jobs\" drop column if exists \"empty_ready_at\";`)\n    this.addSql(`alter table \"terminal_tracking_jobs\" drop column if exists \"holds_cleared_at\";`)\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,kEAAkE,UAAU;AAAA,EACvF,MAAe,KAAoB;AACjC,SAAK,OAAO,kGAAkG;AAC9G,SAAK,OAAO,oGAAoG;AAAA,EAClH;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,8EAA8E;AAC1F,SAAK,OAAO,gFAAgF;AAAA,EAC9F;AACF;",
+  "names": []
+}

package/dist/modules/terminal_tracking/migrations/Migration20260805120000_terminal_event_loaded_at.js

@@ -0,0 +1,13 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260805120000_terminal_event_loaded_at extends Migration {
+  async up() {
+    this.addSql(`alter table "terminal_tracking_events" add column if not exists "loaded_at" timestamptz null;`);
+  }
+  async down() {
+    this.addSql(`alter table "terminal_tracking_events" drop column if exists "loaded_at";`);
+  }
+}
+export {
+  Migration20260805120000_terminal_event_loaded_at
+};
+//# sourceMappingURL=Migration20260805120000_terminal_event_loaded_at.js.map

package/dist/modules/terminal_tracking/migrations/Migration20260805120000_terminal_event_loaded_at.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/migrations/Migration20260805120000_terminal_event_loaded_at.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations'\n\n/**\n * Additive-only: a nullable `loaded_at` timestamp on terminal_tracking_events.\n * The N4 `Loaded` column parsed into a typed datetime, captured on every event\n * regardless of the container's current transit state.\n */\nexport class Migration20260805120000_terminal_event_loaded_at extends Migration {\n  override async up(): Promise<void> {\n    this.addSql(`alter table \"terminal_tracking_events\" add column if not exists \"loaded_at\" timestamptz null;`)\n  }\n\n  override async down(): Promise<void> {\n    this.addSql(`alter table \"terminal_tracking_events\" drop column if exists \"loaded_at\";`)\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAOnB,MAAM,yDAAyD,UAAU;AAAA,EAC9E,MAAe,KAAoB;AACjC,SAAK,OAAO,+FAA+F;AAAA,EAC7G;AAAA,EAEA,MAAe,OAAsB;AACnC,SAAK,OAAO,2EAA2E;AAAA,EACzF;AACF;",
+  "names": []
+}

package/dist/modules/terminal_tracking/services/terminalMatcherService.js

@@ -0,0 +1,61 @@
+import Fuse from "fuse.js";
+import { TerminalConfig } from "../data/entities.js";
+class TerminalMatcherService {
+  constructor(deps) {
+    this.deps = deps;
+  }
+  async candidates(scope) {
+    const em = this.deps.em().fork();
+    return em.find(TerminalConfig, {
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      isActive: true,
+      deletedAt: null
+    });
+  }
+  async resolveFacility(input, scope) {
+    const configs = await this.candidates(scope);
+    if (configs.length === 0) return null;
+    const norm = (s) => s.trim().toUpperCase();
+    if (input.bic) {
+      const bic = norm(input.bic);
+      const hit = configs.find((c) => (c.bicCodes ?? []).some((x) => norm(x) === bic));
+      if (hit) return { terminalCode: hit.terminalCode, displayName: hit.displayName, matchedBy: "bic" };
+    }
+    if (input.smdg) {
+      const smdg = norm(input.smdg);
+      const hit = configs.find((c) => (c.smdgCodes ?? []).some((x) => norm(x) === smdg));
+      if (hit) return { terminalCode: hit.terminalCode, displayName: hit.displayName, matchedBy: "smdg" };
+    }
+    if (input.unlocode) {
+      const unlocode = norm(input.unlocode);
+      const hit = configs.find((c) => c.unlocode && norm(c.unlocode) === unlocode);
+      if (hit) return { terminalCode: hit.terminalCode, displayName: hit.displayName, matchedBy: "unlocode" };
+    }
+    if (input.name && input.name.trim()) {
+      const docs = configs.flatMap(
+        (c) => [c.displayName, ...c.nameAliases ?? []].map((alias) => ({ config: c, alias }))
+      );
+      const fuse = new Fuse(docs, {
+        keys: ["alias"],
+        includeScore: true,
+        threshold: 0.3,
+        ignoreLocation: true
+      });
+      const [best] = fuse.search(input.name.trim());
+      if (best) {
+        return {
+          terminalCode: best.item.config.terminalCode,
+          displayName: best.item.config.displayName,
+          matchedBy: "name",
+          score: best.score
+        };
+      }
+    }
+    return null;
+  }
+}
+export {
+  TerminalMatcherService
+};
+//# sourceMappingURL=terminalMatcherService.js.map

package/dist/modules/terminal_tracking/services/terminalMatcherService.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/services/terminalMatcherService.ts"],
+  "sourcesContent": ["import Fuse from 'fuse.js'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { TerminalConfig } from '../data/entities'\n\nexport type FacilityMatchInput = {\n  name?: string | null\n  bic?: string | null\n  smdg?: string | null\n  unlocode?: string | null\n}\n\nexport type MatchScope = {\n  organizationId: string\n  tenantId: string\n}\n\nexport type TerminalMatch = {\n  terminalCode: string\n  displayName: string\n  matchedBy: 'bic' | 'smdg' | 'unlocode' | 'name'\n  score?: number\n}\n\ntype Deps = {\n  em: () => EntityManager\n}\n\n/**\n * Resolves a facility (by exact BIC / SMDG / UNLOCODE or fuzzy name) to one of\n * the tenant's configured terminals. Matching fields are not encrypted, so a\n * plain `em.find` is sufficient.\n */\nexport class TerminalMatcherService {\n  constructor(private readonly deps: Deps) {}\n\n  private async candidates(scope: MatchScope): Promise<TerminalConfig[]> {\n    const em = this.deps.em().fork()\n    return em.find(TerminalConfig, {\n      organizationId: scope.organizationId,\n      tenantId: scope.tenantId,\n      isActive: true,\n      deletedAt: null,\n    })\n  }\n\n  async resolveFacility(input: FacilityMatchInput, scope: MatchScope): Promise<TerminalMatch | null> {\n    const configs = await this.candidates(scope)\n    if (configs.length === 0) return null\n\n    const norm = (s: string) => s.trim().toUpperCase()\n\n    // 1) Exact BIC\n    if (input.bic) {\n      const bic = norm(input.bic)\n      const hit = configs.find((c) => (c.bicCodes ?? []).some((x) => norm(x) === bic))\n      if (hit) return { terminalCode: hit.terminalCode, displayName: hit.displayName, matchedBy: 'bic' }\n    }\n\n    // 2) Exact SMDG\n    if (input.smdg) {\n      const smdg = norm(input.smdg)\n      const hit = configs.find((c) => (c.smdgCodes ?? []).some((x) => norm(x) === smdg))\n      if (hit) return { terminalCode: hit.terminalCode, displayName: hit.displayName, matchedBy: 'smdg' }\n    }\n\n    // 3) Exact UNLOCODE\n    if (input.unlocode) {\n      const unlocode = norm(input.unlocode)\n      const hit = configs.find((c) => c.unlocode && norm(c.unlocode) === unlocode)\n      if (hit) return { terminalCode: hit.terminalCode, displayName: hit.displayName, matchedBy: 'unlocode' }\n    }\n\n    // 4) Fuzzy name (fuse.js)\n    if (input.name && input.name.trim()) {\n      const docs = configs.flatMap((c) =>\n        [c.displayName, ...(c.nameAliases ?? [])].map((alias) => ({ config: c, alias })),\n      )\n      const fuse = new Fuse(docs, {\n        keys: ['alias'],\n        includeScore: true,\n        threshold: 0.3,\n        ignoreLocation: true,\n      })\n      const [best] = fuse.search(input.name.trim())\n      if (best) {\n        return {\n          terminalCode: best.item.config.terminalCode,\n          displayName: best.item.config.displayName,\n          matchedBy: 'name',\n          score: best.score,\n        }\n      }\n    }\n\n    return null\n  }\n}\n"],
+  "mappings": "AAAA,OAAO,UAAU;AAEjB,SAAS,sBAAsB;AA8BxB,MAAM,uBAAuB;AAAA,EAClC,YAA6B,MAAY;AAAZ;AAAA,EAAa;AAAA,EAE1C,MAAc,WAAW,OAA8C;AACrE,UAAM,KAAK,KAAK,KAAK,GAAG,EAAE,KAAK;AAC/B,WAAO,GAAG,KAAK,gBAAgB;AAAA,MAC7B,gBAAgB,MAAM;AAAA,MACtB,UAAU,MAAM;AAAA,MAChB,UAAU;AAAA,MACV,WAAW;AAAA,IACb,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,gBAAgB,OAA2B,OAAkD;AACjG,UAAM,UAAU,MAAM,KAAK,WAAW,KAAK;AAC3C,QAAI,QAAQ,WAAW,EAAG,QAAO;AAEjC,UAAM,OAAO,CAAC,MAAc,EAAE,KAAK,EAAE,YAAY;AAGjD,QAAI,MAAM,KAAK;AACb,YAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,YAAM,MAAM,QAAQ,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,MAAM,GAAG,CAAC;AAC/E,UAAI,IAAK,QAAO,EAAE,cAAc,IAAI,cAAc,aAAa,IAAI,aAAa,WAAW,MAAM;AAAA,IACnG;AAGA,QAAI,MAAM,MAAM;AACd,YAAM,OAAO,KAAK,MAAM,IAAI;AAC5B,YAAM,MAAM,QAAQ,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,MAAM,IAAI,CAAC;AACjF,UAAI,IAAK,QAAO,EAAE,cAAc,IAAI,cAAc,aAAa,IAAI,aAAa,WAAW,OAAO;AAAA,IACpG;AAGA,QAAI,MAAM,UAAU;AAClB,YAAM,WAAW,KAAK,MAAM,QAAQ;AACpC,YAAM,MAAM,QAAQ,KAAK,CAAC,MAAM,EAAE,YAAY,KAAK,EAAE,QAAQ,MAAM,QAAQ;AAC3E,UAAI,IAAK,QAAO,EAAE,cAAc,IAAI,cAAc,aAAa,IAAI,aAAa,WAAW,WAAW;AAAA,IACxG;AAGA,QAAI,MAAM,QAAQ,MAAM,KAAK,KAAK,GAAG;AACnC,YAAM,OAAO,QAAQ;AAAA,QAAQ,CAAC,MAC5B,CAAC,EAAE,aAAa,GAAI,EAAE,eAAe,CAAC,CAAE,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,EAAE;AAAA,MACjF;AACA,YAAM,OAAO,IAAI,KAAK,MAAM;AAAA,QAC1B,MAAM,CAAC,OAAO;AAAA,QACd,cAAc;AAAA,QACd,WAAW;AAAA,QACX,gBAAgB;AAAA,MAClB,CAAC;AACD,YAAM,CAAC,IAAI,IAAI,KAAK,OAAO,MAAM,KAAK,KAAK,CAAC;AAC5C,UAAI,MAAM;AACR,eAAO;AAAA,UACL,cAAc,KAAK,KAAK,OAAO;AAAA,UAC/B,aAAa,KAAK,KAAK,OAAO;AAAA,UAC9B,WAAW;AAAA,UACX,OAAO,KAAK;AAAA,QACd;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/dist/modules/terminal_tracking/services/terminalRegistry.js

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

package/dist/modules/terminal_tracking/services/terminalRegistry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/terminal_tracking/services/terminalRegistry.ts"],
+  "sourcesContent": ["import type { TerminalAdapter } from '../lib/terminal-adapter'\n\n/**\n * Singleton registry for terminal adapters, keyed by `adapterType` (e.g. 'n4').\n * One adapter serves all terminals of that type; per-terminal config lives in\n * TerminalConfig rows.\n */\nexport class TerminalRegistry {\n  private adapters = new Map<string, TerminalAdapter>()\n\n  register(adapter: TerminalAdapter): void {\n    this.adapters.set(adapter.adapterType.toLowerCase(), adapter)\n  }\n\n  get(adapterType: string): TerminalAdapter | undefined {\n    return this.adapters.get(adapterType.toLowerCase())\n  }\n\n  has(adapterType: string): boolean {\n    return this.adapters.has(adapterType.toLowerCase())\n  }\n\n  list(): TerminalAdapter[] {\n    return Array.from(this.adapters.values())\n  }\n\n  types(): string[] {\n    return Array.from(this.adapters.keys())\n  }\n}\n"],
+  "mappings": "AAOO,MAAM,iBAAiB;AAAA,EAAvB;AACL,SAAQ,WAAW,oBAAI,IAA6B;AAAA;AAAA,EAEpD,SAAS,SAAgC;AACvC,SAAK,SAAS,IAAI,QAAQ,YAAY,YAAY,GAAG,OAAO;AAAA,EAC9D;AAAA,EAEA,IAAI,aAAkD;AACpD,WAAO,KAAK,SAAS,IAAI,YAAY,YAAY,CAAC;AAAA,EACpD;AAAA,EAEA,IAAI,aAA8B;AAChC,WAAO,KAAK,SAAS,IAAI,YAAY,YAAY,CAAC;AAAA,EACpD;AAAA,EAEA,OAA0B;AACxB,WAAO,MAAM,KAAK,KAAK,SAAS,OAAO,CAAC;AAAA,EAC1C;AAAA,EAEA,QAAkB;AAChB,WAAO,MAAM,KAAK,KAAK,SAAS,KAAK,CAAC;AAAA,EACxC;AACF;",
+  "names": []
+}