@freighttech/shipment-tracking 0.6.0

package/dist/modules/shipment_tracking/api/dashboard/ships-map/route.js

@@ -0,0 +1,177 @@
+import { NextResponse } from "next/server.js";
+import { z } from "zod";
+import { createRequestContainer } from "@open-mercato/shared/lib/di/container";
+import { getAuthFromRequest } from "@open-mercato/shared/lib/auth/server";
+import { resolveOrganizationScopeForRequest } from "@open-mercato/core/modules/directory/utils/organizationScope";
+import { Shipment } from "../../../data/entities.js";
+import { shipsMapQuerySchema, shipsMapResponseSchema } from "../../../data/validators.js";
+import { getCurrentVessel } from "../../../lib/current-vessel.js";
+import { getVesselCached, mapWithConcurrency } from "../../../lib/vessel-cache.js";
+const metadata = {
+  GET: { requireAuth: true, requireFeatures: ["shipment_tracking.dashboard.ships_map.view"] }
+};
+function resolveAtPortPosition(routeStops, currentPort, shipment) {
+  const stop = (routeStops ?? []).find(
+    (s) => s.location === currentPort && s.ata && !s.atd && s.coords
+  ) ?? (routeStops ?? []).find((s) => s.ata && !s.atd && s.coords);
+  if (stop?.coords) {
+    return {
+      lat: stop.coords.latitude,
+      lng: stop.coords.longitude,
+      portName: stop.location ?? currentPort ?? null,
+      unlocode: stop.unlocode ?? null
+    };
+  }
+  const dest = shipment.destinationLocation;
+  if (dest?.coords) {
+    return {
+      lat: dest.coords.latitude,
+      lng: dest.coords.longitude,
+      portName: dest.name ?? currentPort ?? null,
+      unlocode: dest.unlocode ?? null
+    };
+  }
+  return null;
+}
+function toShipmentSummary(shipment) {
+  const eta = shipment.etaTimestamps?.length ? shipment.etaTimestamps[shipment.etaTimestamps.length - 1]?.value ?? null : null;
+  return {
+    id: shipment.id,
+    containerNumber: shipment.containerNumber ?? null,
+    status: shipment.status,
+    eta,
+    destinationLocation: shipment.destinationLocation?.name ?? null
+  };
+}
+async function GET(request) {
+  const auth = await getAuthFromRequest(request);
+  if (!auth?.orgId || !auth?.tenantId) {
+    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+  }
+  const url = new URL(request.url);
+  const parsedQuery = shipsMapQuerySchema.safeParse({
+    scope: url.searchParams.get("scope") ?? void 0
+  });
+  if (!parsedQuery.success) {
+    return NextResponse.json({ error: "Invalid query parameters" }, { status: 400 });
+  }
+  const { scope: scopeFilter } = parsedQuery.data;
+  const container = await createRequestContainer();
+  const scope = await resolveOrganizationScopeForRequest({ container, auth, request });
+  const em = container.resolve("em");
+  const organizationId = scope?.selectedId ?? auth.orgId;
+  const tenantId = auth.tenantId;
+  const where = {
+    organizationId,
+    tenantId,
+    deletedAt: null,
+    status: { $ne: "DELIVERED" }
+  };
+  const shipments = await em.find(Shipment, where, {
+    fields: [
+      "id",
+      "status",
+      "containerNumber",
+      "routeStops",
+      "cargoEvents",
+      "vesselName",
+      "vesselImo",
+      "destinationLocation",
+      "etaTimestamps"
+    ]
+  });
+  const byImo = /* @__PURE__ */ new Map();
+  const portGroups = /* @__PURE__ */ new Map();
+  let unresolvedCount = 0;
+  for (const shipment of shipments) {
+    const current = getCurrentVessel(shipment.routeStops, shipment.cargoEvents, {
+      vesselName: shipment.vesselName,
+      vesselImo: shipment.vesselImo
+    });
+    if (current.status === "in_transit") {
+      if (scopeFilter === "at_port") continue;
+      const imo = current.vesselImo;
+      if (!imo) {
+        unresolvedCount += 1;
+        continue;
+      }
+      const list = byImo.get(imo) ?? [];
+      list.push(shipment);
+      byImo.set(imo, list);
+    } else if (current.status === "at_port") {
+      if (scopeFilter === "in_transit") continue;
+      const pos = resolveAtPortPosition(shipment.routeStops, current.currentPort, shipment);
+      if (!pos) {
+        unresolvedCount += 1;
+        continue;
+      }
+      const key = pos.unlocode ?? `${pos.portName ?? ""}:${pos.lat.toFixed(3)},${pos.lng.toFixed(3)}`;
+      const group = portGroups.get(key);
+      if (group) {
+        group.shipments.push(shipment);
+      } else {
+        portGroups.set(key, { ...pos, shipments: [shipment] });
+      }
+    }
+  }
+  const markers = [];
+  const imos = Array.from(byImo.keys());
+  const vesselResults = await mapWithConcurrency(imos, (imo) => getVesselCached(imo));
+  imos.forEach((imo, i) => {
+    const result = vesselResults[i];
+    const group = byImo.get(imo) ?? [];
+    const vessel = result.status === "fulfilled" ? result.value : null;
+    if (!vessel || !vessel.lastPosition) {
+      unresolvedCount += group.length;
+      return;
+    }
+    markers.push({
+      kind: "vessel",
+      imo,
+      name: vessel.name ?? null,
+      position: { lat: vessel.lastPosition.lat, lng: vessel.lastPosition.lng },
+      heading: vessel.lastHeading ?? null,
+      destination: vessel.lastDestinationPort?.name ?? vessel.lastDestination ?? null,
+      updatedAt: vessel.updatedAt ?? null,
+      shipments: group.map(toShipmentSummary)
+    });
+  });
+  for (const group of portGroups.values()) {
+    markers.push({
+      kind: "port",
+      portName: group.portName,
+      unlocode: group.unlocode,
+      position: { lat: group.lat, lng: group.lng },
+      shipments: group.shipments.map(toShipmentSummary)
+    });
+  }
+  return NextResponse.json({
+    markers,
+    unresolvedCount,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+const openApi = {
+  tag: "Shipment Tracking",
+  summary: "Ships map dashboard widget",
+  methods: {
+    GET: {
+      summary: "Aggregate live vessel and at-port positions for active shipments",
+      description: "Returns one marker per distinct in-transit vessel (live AIS position) plus one port marker per port where at-rest cargo waits, scoped to the authenticated organization. Read-only projection over existing Shipment data + the external vessel-api.",
+      query: shipsMapQuerySchema,
+      responses: [
+        { status: 200, description: "Ships map payload", schema: shipsMapResponseSchema }
+      ],
+      errors: [
+        { status: 400, description: "Invalid query parameters", schema: z.object({ error: z.string() }) },
+        { status: 401, description: "Unauthorized", schema: z.object({ error: z.string() }) }
+      ]
+    }
+  }
+};
+export {
+  GET,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/shipment_tracking/api/dashboard/ships-map/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/shipment_tracking/api/dashboard/ships-map/route.ts"],
+  "sourcesContent": ["import { NextRequest, NextResponse } from 'next/server'\nimport { z } from 'zod'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type { FilterQuery } from '@mikro-orm/core'\nimport { createRequestContainer } from '@open-mercato/shared/lib/di/container'\nimport { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'\nimport { resolveOrganizationScopeForRequest } from '@open-mercato/core/modules/directory/utils/organizationScope'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { Shipment } from '../../../data/entities'\nimport { shipsMapQuerySchema, shipsMapResponseSchema } from '../../../data/validators'\nimport type { ShipsMapMarker, ShipsMapShipment } from '../../../data/validators'\nimport { getCurrentVessel } from '../../../lib/current-vessel'\nimport type { RouteStopEntry } from '../../../lib/route-extraction'\nimport { getVesselCached, mapWithConcurrency } from '../../../lib/vessel-cache'\n\n// \u2500\u2500\u2500 Metadata \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const metadata = {\n  GET: { requireAuth: true, requireFeatures: ['shipment_tracking.dashboard.ships_map.view'] },\n}\n\n// \u2500\u2500\u2500 Helpers \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/** The subset of Shipment fields this route projects from the DB. */\ntype ShipmentLite = Pick<\n  Shipment,\n  | 'id'\n  | 'status'\n  | 'containerNumber'\n  | 'routeStops'\n  | 'cargoEvents'\n  | 'vesselName'\n  | 'vesselImo'\n  | 'destinationLocation'\n  | 'etaTimestamps'\n>\n\n/**\n * Resolve the port coordinates for an `at_port` shipment. `getCurrentVessel` reports the\n * port as a location name (`currentPort`); we look up the matching route stop (the one the\n * cargo has arrived at but not departed) for its coords, then fall back to the shipment's\n * destination coords. Returns `null` when nothing is plottable.\n */\nfunction resolveAtPortPosition(\n  routeStops: RouteStopEntry[] | null | undefined,\n  currentPort: string | undefined,\n  shipment: ShipmentLite,\n): { lat: number; lng: number; portName: string | null; unlocode: string | null } | null {\n  // Prefer the stop the cargo is resting at (arrived, not yet departed) that matches currentPort.\n  const stop = (routeStops ?? []).find(\n    (s) => s.location === currentPort && s.ata && !s.atd && s.coords,\n  )\n    ?? (routeStops ?? []).find((s) => s.ata && !s.atd && s.coords)\n\n  if (stop?.coords) {\n    return {\n      lat: stop.coords.latitude,\n      lng: stop.coords.longitude,\n      portName: stop.location ?? currentPort ?? null,\n      unlocode: stop.unlocode ?? null,\n    }\n  }\n\n  // Fallback: destination coords.\n  const dest = shipment.destinationLocation\n  if (dest?.coords) {\n    return {\n      lat: dest.coords.latitude,\n      lng: dest.coords.longitude,\n      portName: dest.name ?? currentPort ?? null,\n      unlocode: dest.unlocode ?? null,\n    }\n  }\n\n  return null\n}\n\nfunction toShipmentSummary(shipment: ShipmentLite): ShipsMapShipment {\n  const eta = shipment.etaTimestamps?.length\n    ? shipment.etaTimestamps[shipment.etaTimestamps.length - 1]?.value ?? null\n    : null\n  return {\n    id: shipment.id,\n    containerNumber: shipment.containerNumber ?? null,\n    status: shipment.status,\n    eta,\n    destinationLocation: shipment.destinationLocation?.name ?? null,\n  }\n}\n\n// \u2500\u2500\u2500 GET \u2014 Ships map aggregation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport async function GET(request: NextRequest) {\n  const auth = await getAuthFromRequest(request)\n  if (!auth?.orgId || !auth?.tenantId) {\n    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })\n  }\n\n  const url = new URL(request.url)\n  const parsedQuery = shipsMapQuerySchema.safeParse({\n    scope: url.searchParams.get('scope') ?? undefined,\n  })\n  if (!parsedQuery.success) {\n    return NextResponse.json({ error: 'Invalid query parameters' }, { status: 400 })\n  }\n  const { scope: scopeFilter } = parsedQuery.data\n\n  const container = await createRequestContainer()\n  const scope = await resolveOrganizationScopeForRequest({ container, auth, request })\n  const em = container.resolve('em') as EntityManager\n\n  const organizationId = scope?.selectedId ?? auth.orgId\n  const tenantId = auth.tenantId\n\n  // Coarse prefilter only: exclude DELIVERED. getCurrentVessel is the authoritative\n  // classifier \u2014 the denormalized `status` column can lag route-stop reality, so we must\n  // NOT narrow to a status allow-list here or we'd drop genuinely in-transit shipments.\n  const where: FilterQuery<Shipment> = {\n    organizationId,\n    tenantId,\n    deletedAt: null,\n    status: { $ne: 'DELIVERED' },\n  }\n\n  const shipments = await em.find(Shipment, where, {\n    fields: [\n      'id',\n      'status',\n      'containerNumber',\n      'routeStops',\n      'cargoEvents',\n      'vesselName',\n      'vesselImo',\n      'destinationLocation',\n      'etaTimestamps',\n    ],\n  })\n\n  // Group in_transit shipments by the IMO of the vessel actually carrying them.\n  const byImo = new Map<string, ShipmentLite[]>()\n  // Group at_port shipments by a port key (unlocode|name + rounded coords).\n  const portGroups = new Map<\n    string,\n    { lat: number; lng: number; portName: string | null; unlocode: string | null; shipments: ShipmentLite[] }\n  >()\n  let unresolvedCount = 0\n\n  for (const shipment of shipments) {\n    const current = getCurrentVessel(shipment.routeStops, shipment.cargoEvents, {\n      vesselName: shipment.vesselName,\n      vesselImo: shipment.vesselImo,\n    })\n\n    if (current.status === 'in_transit') {\n      if (scopeFilter === 'at_port') continue\n      const imo = current.vesselImo\n      if (!imo) {\n        unresolvedCount += 1\n        continue\n      }\n      const list = byImo.get(imo) ?? []\n      list.push(shipment)\n      byImo.set(imo, list)\n    } else if (current.status === 'at_port') {\n      if (scopeFilter === 'in_transit') continue\n      const pos = resolveAtPortPosition(shipment.routeStops, current.currentPort, shipment)\n      if (!pos) {\n        unresolvedCount += 1\n        continue\n      }\n      const key = pos.unlocode ?? `${pos.portName ?? ''}:${pos.lat.toFixed(3)},${pos.lng.toFixed(3)}`\n      const group = portGroups.get(key)\n      if (group) {\n        group.shipments.push(shipment)\n      } else {\n        portGroups.set(key, { ...pos, shipments: [shipment] })\n      }\n    }\n    // not_departed / delivered \u2192 not plotted (no meaningful \"where is it now\").\n  }\n\n  const markers: ShipsMapMarker[] = []\n\n  // Fan out distinct IMOs through the bounded cache, concurrency-capped, fault-tolerant.\n  const imos = Array.from(byImo.keys())\n  const vesselResults = await mapWithConcurrency(imos, (imo) => getVesselCached(imo))\n\n  imos.forEach((imo, i) => {\n    const result = vesselResults[i]\n    const group = byImo.get(imo) ?? []\n    const vessel = result.status === 'fulfilled' ? result.value : null\n    if (!vessel || !vessel.lastPosition) {\n      // vessel-api miss / failure / positionless \u2192 fold its shipments into unresolved.\n      unresolvedCount += group.length\n      return\n    }\n    markers.push({\n      kind: 'vessel',\n      imo,\n      name: vessel.name ?? null,\n      position: { lat: vessel.lastPosition.lat, lng: vessel.lastPosition.lng },\n      heading: vessel.lastHeading ?? null,\n      destination: vessel.lastDestinationPort?.name ?? vessel.lastDestination ?? null,\n      updatedAt: vessel.updatedAt ?? null,\n      shipments: group.map(toShipmentSummary),\n    })\n  })\n\n  for (const group of portGroups.values()) {\n    markers.push({\n      kind: 'port',\n      portName: group.portName,\n      unlocode: group.unlocode,\n      position: { lat: group.lat, lng: group.lng },\n      shipments: group.shipments.map(toShipmentSummary),\n    })\n  }\n\n  return NextResponse.json({\n    markers,\n    unresolvedCount,\n    generatedAt: new Date().toISOString(),\n  })\n}\n\n// \u2500\u2500\u2500 OpenAPI \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'Shipment Tracking',\n  summary: 'Ships map dashboard widget',\n  methods: {\n    GET: {\n      summary: 'Aggregate live vessel and at-port positions for active shipments',\n      description:\n        'Returns one marker per distinct in-transit vessel (live AIS position) plus one port marker per port where at-rest cargo waits, scoped to the authenticated organization. Read-only projection over existing Shipment data + the external vessel-api.',\n      query: shipsMapQuerySchema,\n      responses: [\n        { status: 200, description: 'Ships map payload', schema: shipsMapResponseSchema },\n      ],\n      errors: [\n        { status: 400, description: 'Invalid query parameters', schema: z.object({ error: z.string() }) },\n        { status: 401, description: 'Unauthorized', schema: z.object({ error: z.string() }) },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/shipment_tracking/api/location-overrides/route.js

@@ -0,0 +1,179 @@
+import { makeCrudRoute } from "@open-mercato/shared/lib/crud/factory";
+import { z } from "zod";
+import { LocationOverride } from "../../data/entities.js";
+import {
+  locationOverrideListSchema,
+  locationOverrideCreateSchema,
+  locationOverrideUpdateSchema
+} from "../../data/validators.js";
+import { parseBooleanToken } from "@open-mercato/shared/lib/boolean";
+import {
+  createShipmentTrackingCrudOpenApi,
+  createPagedListResponseSchema,
+  defaultOkResponseSchema
+} from "../openapi.js";
+import { withScopedPayload } from "../utils.js";
+import { resolveTranslations } from "@open-mercato/shared/lib/i18n/server";
+const rawBodySchema = z.object({}).passthrough();
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ["shipment_tracking.location_overrides.view"] },
+  POST: { requireAuth: true, requireFeatures: ["shipment_tracking.location_overrides.manage"] },
+  PUT: { requireAuth: true, requireFeatures: ["shipment_tracking.location_overrides.manage"] },
+  DELETE: { requireAuth: true, requireFeatures: ["shipment_tracking.location_overrides.manage"] }
+};
+const listFields = [
+  "id",
+  "carrierCode",
+  "unlocode",
+  "facilityCode",
+  "facilityCodeListProvider",
+  "overrideData",
+  "description",
+  "isActive",
+  "createdAt",
+  "updatedAt",
+  "createdByUserId",
+  "updatedByUserId"
+];
+const buildFilters = (query) => {
+  const filters = {
+    deletedAt: null
+  };
+  if (query.carrierCode) {
+    filters.carrierCode = { $eq: query.carrierCode };
+  }
+  if (query.unlocode) {
+    filters.unlocode = { $eq: query.unlocode.toUpperCase() };
+  }
+  if (query.facilityCode) {
+    filters.facilityCode = { $eq: query.facilityCode };
+  }
+  if (query.isActive !== void 0) {
+    const parsed = parseBooleanToken(query.isActive);
+    if (parsed !== null) {
+      filters.isActive = parsed;
+    }
+  }
+  if (query.search) {
+    const searchTerm = query.search.trim();
+    if (searchTerm) {
+      filters.$or = [
+        { carrierCode: { $ilike: `%${searchTerm}%` } },
+        { unlocode: { $ilike: `%${searchTerm}%` } },
+        { facilityCode: { $ilike: `%${searchTerm}%` } },
+        { description: { $ilike: `%${searchTerm}%` } }
+      ];
+    }
+  }
+  return filters;
+};
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: LocationOverride,
+    idField: "id",
+    orgField: "organizationId",
+    tenantField: "tenantId"
+  },
+  list: {
+    schema: locationOverrideListSchema,
+    fields: listFields,
+    sortFieldMap: {
+      id: "id",
+      carrierCode: "carrier_code",
+      unlocode: "unlocode",
+      facilityCode: "facility_code",
+      isActive: "is_active",
+      createdAt: "created_at"
+    },
+    buildFilters: async (query) => buildFilters(query)
+  },
+  actions: {
+    create: {
+      commandId: "shipment_tracking.location_override.create",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return locationOverrideCreateSchema.parse(scoped);
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 201
+    },
+    update: {
+      commandId: "shipment_tracking.location_override.update",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return locationOverrideUpdateSchema.parse(scoped);
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 200
+    },
+    delete: {
+      commandId: "shipment_tracking.location_override.delete",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return { id: raw?.id, ...scoped };
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 200
+    }
+  }
+});
+const openApi = createShipmentTrackingCrudOpenApi({
+  resourceName: "LocationOverride",
+  pluralName: "LocationOverrides",
+  querySchema: locationOverrideListSchema,
+  listResponseSchema: createPagedListResponseSchema(z.object({
+    id: z.string().uuid(),
+    carrierCode: z.string().nullable(),
+    unlocode: z.string(),
+    facilityCode: z.string(),
+    facilityCodeListProvider: z.enum(["BIC", "SMDG"]),
+    overrideData: z.object({
+      name: z.string(),
+      address: z.string().nullable().optional(),
+      operatorName: z.string().nullable().optional(),
+      countryCode: z.string().nullable().optional(),
+      facilityTypeCode: z.string().nullable().optional(),
+      coords: z.object({
+        latitude: z.number(),
+        longitude: z.number()
+      }).nullable().optional()
+    }),
+    description: z.string().nullable(),
+    isActive: z.boolean()
+  })),
+  create: {
+    schema: rawBodySchema,
+    description: "Creates a new location override for BIC/SMDG facility data correction."
+  },
+  update: {
+    schema: rawBodySchema,
+    responseSchema: defaultOkResponseSchema,
+    description: "Updates an existing location override."
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: defaultOkResponseSchema,
+    description: "Deletes a location override (soft delete)."
+  }
+});
+const metadata = crud.metadata;
+const GET = crud.GET;
+const POST = crud.POST;
+const PUT = crud.PUT;
+const DELETE = crud.DELETE;
+export {
+  DELETE,
+  GET,
+  POST,
+  PUT,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/shipment_tracking/api/location-overrides/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/shipment_tracking/api/location-overrides/route.ts"],
+  "sourcesContent": ["import { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'\nimport { z } from 'zod'\nimport { LocationOverride } from '../../data/entities'\nimport {\n  locationOverrideListSchema,\n  locationOverrideCreateSchema,\n  locationOverrideUpdateSchema,\n} from '../../data/validators'\nimport { parseBooleanToken } from '@open-mercato/shared/lib/boolean'\nimport {\n  createShipmentTrackingCrudOpenApi,\n  createPagedListResponseSchema,\n  defaultOkResponseSchema,\n} from '../openapi'\nimport { withScopedPayload } from '../utils'\nimport { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'\n\nconst rawBodySchema = z.object({}).passthrough()\n\ntype LocationOverrideListQuery = z.infer<typeof locationOverrideListSchema>\n\nconst routeMetadata = {\n  GET: { requireAuth: true, requireFeatures: ['shipment_tracking.location_overrides.view'] },\n  POST: { requireAuth: true, requireFeatures: ['shipment_tracking.location_overrides.manage'] },\n  PUT: { requireAuth: true, requireFeatures: ['shipment_tracking.location_overrides.manage'] },\n  DELETE: { requireAuth: true, requireFeatures: ['shipment_tracking.location_overrides.manage'] },\n}\n\nconst listFields = [\n  'id',\n  'carrierCode',\n  'unlocode',\n  'facilityCode',\n  'facilityCodeListProvider',\n  'overrideData',\n  'description',\n  'isActive',\n  'createdAt',\n  'updatedAt',\n  'createdByUserId',\n  'updatedByUserId',\n]\n\nconst buildFilters = (query: LocationOverrideListQuery): Record<string, unknown> => {\n  const filters: Record<string, unknown> = {\n    deletedAt: null,\n  }\n\n  if (query.carrierCode) {\n    filters.carrierCode = { $eq: query.carrierCode }\n  }\n\n  if (query.unlocode) {\n    filters.unlocode = { $eq: query.unlocode.toUpperCase() }\n  }\n\n  if (query.facilityCode) {\n    filters.facilityCode = { $eq: query.facilityCode }\n  }\n\n  if (query.isActive !== undefined) {\n    const parsed = parseBooleanToken(query.isActive)\n    if (parsed !== null) {\n      filters.isActive = parsed\n    }\n  }\n\n  if (query.search) {\n    const searchTerm = query.search.trim()\n    if (searchTerm) {\n      filters.$or = [\n        { carrierCode: { $ilike: `%${searchTerm}%` } },\n        { unlocode: { $ilike: `%${searchTerm}%` } },\n        { facilityCode: { $ilike: `%${searchTerm}%` } },\n        { description: { $ilike: `%${searchTerm}%` } },\n      ]\n    }\n  }\n\n  return filters\n}\n\nconst crud = makeCrudRoute({\n  metadata: routeMetadata,\n  orm: {\n    entity: LocationOverride,\n    idField: 'id',\n    orgField: 'organizationId',\n    tenantField: 'tenantId',\n  },\n  list: {\n    schema: locationOverrideListSchema,\n    fields: listFields,\n    sortFieldMap: {\n      id: 'id',\n      carrierCode: 'carrier_code',\n      unlocode: 'unlocode',\n      facilityCode: 'facility_code',\n      isActive: 'is_active',\n      createdAt: 'created_at',\n    },\n    buildFilters: async (query) => buildFilters(query),\n  },\n  actions: {\n    create: {\n      commandId: 'shipment_tracking.location_override.create',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return locationOverrideCreateSchema.parse(scoped)\n      },\n      response: ({ result }) => ({ id: result?.id ?? null }),\n      status: 201,\n    },\n    update: {\n      commandId: 'shipment_tracking.location_override.update',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return locationOverrideUpdateSchema.parse(scoped)\n      },\n      response: ({ result }) => ({ id: result?.id ?? null }),\n      status: 200,\n    },\n    delete: {\n      commandId: 'shipment_tracking.location_override.delete',\n      schema: rawBodySchema,\n      mapInput: async ({ raw, ctx }) => {\n        const { translate } = await resolveTranslations()\n        const scoped = withScopedPayload(raw ?? {}, ctx, translate)\n        return { id: (raw as Record<string, unknown>)?.id, ...scoped }\n      },\n      response: ({ result }) => ({ id: result?.id ?? null }),\n      status: 200,\n    },\n  },\n})\n\nexport const openApi = createShipmentTrackingCrudOpenApi({\n  resourceName: 'LocationOverride',\n  pluralName: 'LocationOverrides',\n  querySchema: locationOverrideListSchema,\n  listResponseSchema: createPagedListResponseSchema(z.object({\n    id: z.string().uuid(),\n    carrierCode: z.string().nullable(),\n    unlocode: z.string(),\n    facilityCode: z.string(),\n    facilityCodeListProvider: z.enum(['BIC', 'SMDG']),\n    overrideData: z.object({\n      name: z.string(),\n      address: z.string().nullable().optional(),\n      operatorName: z.string().nullable().optional(),\n      countryCode: z.string().nullable().optional(),\n      facilityTypeCode: z.string().nullable().optional(),\n      coords: z.object({\n        latitude: z.number(),\n        longitude: z.number(),\n      }).nullable().optional(),\n    }),\n    description: z.string().nullable(),\n    isActive: z.boolean(),\n  })),\n  create: {\n    schema: rawBodySchema,\n    description: 'Creates a new location override for BIC/SMDG facility data correction.',\n  },\n  update: {\n    schema: rawBodySchema,\n    responseSchema: defaultOkResponseSchema,\n    description: 'Updates an existing location override.',\n  },\n  del: {\n    schema: z.object({ id: z.string().uuid() }),\n    responseSchema: defaultOkResponseSchema,\n    description: 'Deletes a location override (soft delete).',\n  },\n})\n\nexport const metadata = crud.metadata\nexport const GET = crud.GET\nexport const POST = crud.POST\nexport const PUT = crud.PUT\nexport const DELETE = crud.DELETE\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/shipment_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 buildShipmentTrackingCrudOpenApi = createCrudOpenApiFactory({
+  defaultTag: "Shipment Tracking",
+  defaultCreateResponseSchema,
+  defaultOkResponseSchema,
+  makeListDescription: ({ pluralLower }) => `Returns a paginated collection of ${pluralLower} scoped to the authenticated organization.`
+});
+function createShipmentTrackingCrudOpenApi(options) {
+  return buildShipmentTrackingCrudOpenApi(options);
+}
+export {
+  createPagedListResponseSchema,
+  createShipmentTrackingCrudOpenApi,
+  defaultCreateResponseSchema,
+  defaultOkResponseSchema
+};
+//# sourceMappingURL=openapi.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/shipment_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 buildShipmentTrackingCrudOpenApi = createCrudOpenApiFactory({\n  defaultTag: 'Shipment Tracking',\n  defaultCreateResponseSchema,\n  defaultOkResponseSchema,\n  makeListDescription: ({ pluralLower }) =>\n    `Returns a paginated collection of ${pluralLower} scoped to the authenticated organization.`,\n})\n\nexport function createShipmentTrackingCrudOpenApi(options: CrudOpenApiOptions): OpenApiRouteDoc {\n  return buildShipmentTrackingCrudOpenApi(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": []
+}

package/dist/modules/shipment_tracking/api/shipments/route.js

@@ -0,0 +1,192 @@
+import { makeCrudRoute } from "@open-mercato/shared/lib/crud/factory";
+import { z } from "zod";
+import { Shipment } from "../../data/entities.js";
+import { shipmentListSchema, shipmentCreateSchema, shipmentUpdateSchema } from "../../data/validators.js";
+import { escapeLikePattern } from "@open-mercato/shared/lib/db/escapeLikePattern";
+import {
+  createShipmentTrackingCrudOpenApi,
+  createPagedListResponseSchema,
+  defaultOkResponseSchema
+} from "../openapi.js";
+import { withScopedPayload } from "../utils.js";
+import { resolveTranslations } from "@open-mercato/shared/lib/i18n/server";
+const rawBodySchema = z.object({}).passthrough();
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ["shipment_tracking.shipments.view"] },
+  POST: { requireAuth: true, requireFeatures: ["shipment_tracking.shipments.manage"] },
+  PUT: { requireAuth: true, requireFeatures: ["shipment_tracking.shipments.manage"] },
+  DELETE: { requireAuth: true, requireFeatures: ["shipment_tracking.shipments.manage"] }
+};
+const listFields = [
+  "id",
+  "status",
+  "carrierCode",
+  "containerNumber",
+  "bookingNumber",
+  "isoEquipmentCode",
+  "bolNumber",
+  // Multi-source timestamp arrays
+  "etdTimestamps",
+  "etaTimestamps",
+  "atdTimestamps",
+  "ataTimestamps",
+  // Location data (JSONB)
+  "originLocation",
+  "destinationLocation",
+  // Vessel info
+  "vesselName",
+  "vesselImo",
+  "voyageNumber",
+  "eventCount",
+  // Denormalized route & events (JSONB)
+  "routeStops",
+  "cargoEvents",
+  // Aggregated seals (JSONB)
+  "seals",
+  // Tracking job relation (for fetching events - kept for backward compatibility)
+  "trackingJob",
+  "createdAt",
+  "updatedAt"
+];
+const buildFilters = (query) => {
+  const filters = { deletedAt: null };
+  if (query.id) {
+    filters.id = query.id;
+  }
+  const search = query.search?.trim();
+  if (search && search.length > 0) {
+    const escaped = escapeLikePattern(search);
+    const pattern = `%${escaped}%`;
+    filters.$or = [
+      { containerNumber: { $ilike: pattern } },
+      { bookingNumber: { $ilike: pattern } },
+      { bolNumber: { $ilike: pattern } },
+      { carrierCode: { $ilike: pattern } },
+      { vesselName: { $ilike: pattern } },
+      // HEDGE-101 — JSONB nested property search, as NESTED OBJECTS.
+      //
+      // `origin_location` / `destination_location` are `jsonb` columns, not
+      // relations. A dotted string key (`'originLocation.name'`) is read by
+      // MikroORM as a RELATION PATH, so it emitted a condition against a table
+      // that was never joined and the query died with
+      // `missing FROM-clause entry for table "originLocation"` — a hard 500 on
+      // every keystroke. The nested-object form is what compiles to
+      // `"origin_location"->>'name'`.
+      //
+      // The condition is only added when `q` is non-empty, which is why the
+      // route looked healthy until the first search: this path had never worked.
+      { originLocation: { name: { $ilike: pattern } } },
+      { originLocation: { unlocode: { $ilike: pattern } } },
+      { destinationLocation: { name: { $ilike: pattern } } },
+      { destinationLocation: { unlocode: { $ilike: pattern } } }
+    ];
+  }
+  if (query.status) {
+    filters.status = query.status;
+  }
+  if (query.carrierCode) {
+    filters.carrierCode = query.carrierCode;
+  }
+  return filters;
+};
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: Shipment,
+    idField: "id",
+    orgField: "organizationId",
+    tenantField: "tenantId",
+    softDeleteField: "deletedAt"
+  },
+  list: {
+    schema: shipmentListSchema,
+    fields: listFields,
+    sortFieldMap: {
+      id: "id",
+      status: "status",
+      carrierCode: "carrier_code",
+      containerNumber: "container_number",
+      bookingNumber: "booking_number",
+      createdAt: "created_at",
+      updatedAt: "updated_at"
+    },
+    buildFilters: async (query) => buildFilters(query)
+  },
+  actions: {
+    create: {
+      commandId: "shipment_tracking.shipment.create",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return shipmentCreateSchema.parse(scoped);
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 201
+    },
+    update: {
+      commandId: "shipment_tracking.shipment.update",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const scoped = withScopedPayload(raw ?? {}, ctx, translate);
+        return shipmentUpdateSchema.parse(scoped);
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 200
+    },
+    delete: {
+      commandId: "shipment_tracking.shipment.delete",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        const body = raw?.body ?? raw ?? {};
+        const scoped = withScopedPayload(body, ctx, translate);
+        return { id: body.id, ...scoped };
+      },
+      response: ({ result }) => ({ id: result?.id ?? null }),
+      status: 200
+    }
+  }
+});
+const openApi = createShipmentTrackingCrudOpenApi({
+  resourceName: "Shipment",
+  pluralName: "Shipments",
+  querySchema: shipmentListSchema,
+  listResponseSchema: createPagedListResponseSchema(z.object({
+    id: z.string().uuid(),
+    status: z.string(),
+    carrierCode: z.string().nullable(),
+    containerNumber: z.string().nullable(),
+    bookingNumber: z.string().nullable(),
+    bolNumber: z.string().nullable()
+  })),
+  create: {
+    schema: rawBodySchema,
+    description: "Creates a new shipment."
+  },
+  update: {
+    schema: rawBodySchema,
+    responseSchema: defaultOkResponseSchema,
+    description: "Updates an existing shipment by id."
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: defaultOkResponseSchema,
+    description: "Soft-deletes a shipment by id."
+  }
+});
+const metadata = crud.metadata;
+const GET = crud.GET;
+const POST = crud.POST;
+const PUT = crud.PUT;
+const DELETE = crud.DELETE;
+export {
+  DELETE,
+  GET,
+  POST,
+  PUT,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map