@freighttech/shipment-tracking 0.6.0

package/src/modules/shipment_tracking/__tests__/fixtures/msc-transship.json

@@ -0,0 +1,409 @@
+[
+  {
+    "eventType": "TRANSPORT",
+    "transportEventTypeCode": "ARRI",
+    "transportCall": {
+      "transportCallID": "PLGDNGA602W",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": null,
+      "importVoyageNumber": "GA602W",
+      "unLocationCode": "PLGDN",
+      "facilityCode": "PLGDA",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "VESSEL",
+      "vessel": {
+        "vesselIMONumber": "8000004",
+        "vesselName": "EXAMPLE VESSEL 04",
+        "vesselFlag": "LR",
+        "vesselCallSignNumber": "0ZBC1"
+      }
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "description": "Estimated Time of Arrival",
+    "eventId": "EST2026-03-13T08:15:00:00+01:00",
+    "eventDateTime": "2026-03-13T08:15:00+01:00",
+    "eventClassifierCode": "EST",
+    "eventCreatedDateTime": "2026-02-17T13:06:26+00:00",
+    "references": []
+  },
+  {
+    "eventType": "TRANSPORT",
+    "transportEventTypeCode": "DEPA",
+    "transportCall": {
+      "transportCallID": "CNNGBGA602W",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": "GA602W",
+      "importVoyageNumber": null,
+      "unLocationCode": "CNNGB",
+      "facilityCode": "BLGAN",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "VESSEL",
+      "vessel": {
+        "vesselIMONumber": "8000004",
+        "vesselName": "EXAMPLE VESSEL 04",
+        "vesselFlag": "LR",
+        "vesselCallSignNumber": "0ZBC1"
+      }
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "description": "Vessel Departure",
+    "eventId": "ACT2026-01-25T14:06:00:00+08:00",
+    "eventDateTime": "2026-01-25T14:06:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-25T14:06:00+08:00",
+    "references": []
+  },
+  {
+    "eventType": "EQUIPMENT",
+    "equipmentEventTypeCode": "LOAD",
+    "equipmentReference": "MSCU1000036",
+    "ISOEquipmentCode": "4510",
+    "emptyIndicatorCode": "LADEN",
+    "transportCall": {
+      "transportCallID": "CNNGBGA602W",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": "GA602W",
+      "importVoyageNumber": null,
+      "unLocationCode": "CNNGB",
+      "facilityCode": "BLGAN",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "VESSEL",
+      "vessel": {
+        "vesselIMONumber": "8000004",
+        "vesselName": "EXAMPLE VESSEL 04",
+        "vesselFlag": "LR",
+        "vesselCallSignNumber": "0ZBC1"
+      }
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "eventLocation": {
+      "locationName": "NINGBO",
+      "unLocationCode": "CNNGB",
+      "facilityCode": "BLGAN",
+      "facilityCodeListProvider": "SMDG"
+    },
+    "seals": [
+      {
+        "sealNumber": "FX43937324",
+        "sealSource": "CAR"
+      }
+    ],
+    "description": "Full Transshipment Loaded",
+    "eventId": "1738307319",
+    "eventDateTime": "2026-01-25T11:00:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-25T11:00:00+08:00",
+    "references": []
+  },
+  {
+    "eventType": "EQUIPMENT",
+    "equipmentEventTypeCode": "DISC",
+    "equipmentReference": "MSCU1000036",
+    "ISOEquipmentCode": "4510",
+    "emptyIndicatorCode": "LADEN",
+    "transportCall": {
+      "transportCallID": "CNNGBQS550R",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": null,
+      "importVoyageNumber": "QS550R",
+      "unLocationCode": "CNNGB",
+      "facilityCode": "BLGAN",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "VESSEL",
+      "vessel": {
+        "vesselIMONumber": "8000003",
+        "vesselName": "EXAMPLE VESSEL 03",
+        "vesselFlag": "PA",
+        "vesselCallSignNumber": "7WXY8"
+      }
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "eventLocation": {
+      "locationName": "NINGBO",
+      "unLocationCode": "CNNGB",
+      "facilityCode": "BLGAN",
+      "facilityCodeListProvider": "SMDG"
+    },
+    "seals": [
+      {
+        "sealNumber": "FX43937324",
+        "sealSource": "CAR"
+      }
+    ],
+    "description": "Full Transshipment Discharged",
+    "eventId": "1733643968",
+    "eventDateTime": "2026-01-18T09:00:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-18T09:00:00+08:00",
+    "references": []
+  },
+  {
+    "eventType": "TRANSPORT",
+    "transportEventTypeCode": "ARRI",
+    "transportCall": {
+      "transportCallID": "CNNGBQS550R",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": null,
+      "importVoyageNumber": "QS550R",
+      "unLocationCode": "CNNGB",
+      "facilityCode": "BLGAN",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "VESSEL",
+      "vessel": {
+        "vesselIMONumber": "8000003",
+        "vesselName": "EXAMPLE VESSEL 03",
+        "vesselFlag": "PA",
+        "vesselCallSignNumber": "7WXY8"
+      }
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "description": "Vessel Arrival",
+    "eventId": "ACT2026-01-17T23:54:00:00+08:00",
+    "eventDateTime": "2026-01-17T23:54:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-17T23:54:00+08:00",
+    "references": []
+  },
+  {
+    "eventType": "TRANSPORT",
+    "transportEventTypeCode": "DEPA",
+    "transportCall": {
+      "transportCallID": "CNTAOGL602W",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": "GL602W",
+      "importVoyageNumber": null,
+      "unLocationCode": "CNTAO",
+      "facilityCode": "QQCTX",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "VESSEL",
+      "vessel": {
+        "vesselIMONumber": "8000003",
+        "vesselName": "EXAMPLE VESSEL 03",
+        "vesselFlag": "PA",
+        "vesselCallSignNumber": "7WXY8"
+      }
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "description": "Vessel Departure",
+    "eventId": "ACT2026-01-11T18:06:00:00+08:00",
+    "eventDateTime": "2026-01-11T18:06:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-11T18:06:00+08:00",
+    "references": []
+  },
+  {
+    "eventType": "EQUIPMENT",
+    "equipmentEventTypeCode": "LOAD",
+    "equipmentReference": "MSCU1000036",
+    "ISOEquipmentCode": "4510",
+    "emptyIndicatorCode": "LADEN",
+    "transportCall": {
+      "transportCallID": "CNTAOGL602W",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": "GL602W",
+      "importVoyageNumber": null,
+      "unLocationCode": "CNTAO",
+      "facilityCode": "QQCTX",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "VESSEL",
+      "vessel": {
+        "vesselIMONumber": "8000003",
+        "vesselName": "EXAMPLE VESSEL 03",
+        "vesselFlag": "PA",
+        "vesselCallSignNumber": "7WXY8"
+      }
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "eventLocation": {
+      "locationName": "QINGDAO",
+      "unLocationCode": "CNTAO",
+      "facilityCode": "QQCTX",
+      "facilityCodeListProvider": "SMDG"
+    },
+    "seals": [
+      {
+        "sealNumber": "FX43937324",
+        "sealSource": "TER"
+      }
+    ],
+    "description": "Export Loaded on Vessel",
+    "eventId": "1729122314",
+    "eventDateTime": "2026-01-11T14:12:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-11T14:12:00+08:00",
+    "references": []
+  },
+  {
+    "eventType": "EQUIPMENT",
+    "equipmentEventTypeCode": "GTIN",
+    "equipmentReference": "MSCU1000036",
+    "ISOEquipmentCode": "4510",
+    "emptyIndicatorCode": "LADEN",
+    "transportCall": {
+      "transportCallID": "CNTAOTRB",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": null,
+      "importVoyageNumber": null,
+      "unLocationCode": "CNTAO",
+      "facilityCode": "QQCTX",
+      "facilityCodeListProvider": "SMDG",
+      "facilityTypeCode": "POTE",
+      "otherFacility": null,
+      "modeOfTransport": "TRUCK",
+      "vessel": null
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "eventLocation": {
+      "locationName": "QINGDAO",
+      "unLocationCode": "CNTAO",
+      "facilityCode": "QQCTX",
+      "facilityCodeListProvider": "SMDG"
+    },
+    "seals": [
+      {
+        "sealNumber": "FX43937324",
+        "sealSource": "TER"
+      }
+    ],
+    "description": "Export received at CY",
+    "eventId": "1728267876",
+    "eventDateTime": "2026-01-09T21:02:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-09T21:02:00+08:00",
+    "references": []
+  },
+  {
+    "eventType": "EQUIPMENT",
+    "equipmentEventTypeCode": "GTOT",
+    "equipmentReference": "MSCU1000036",
+    "ISOEquipmentCode": "4510",
+    "emptyIndicatorCode": "EMPTY",
+    "transportCall": {
+      "transportCallID": "CNTAOTRB",
+      "carrierServiceCode": null,
+      "exportVoyageNumber": null,
+      "importVoyageNumber": null,
+      "unLocationCode": "CNTAO",
+      "facilityCode": "CNTAOZNML",
+      "facilityCodeListProvider": "BIC",
+      "facilityTypeCode": "DEPO",
+      "otherFacility": null,
+      "modeOfTransport": "TRUCK",
+      "vessel": null
+    },
+    "documentReferences": [
+      {
+        "documentReferenceType": "BKG",
+        "documentReferenceValue": "100AAAAAA0002V"
+      },
+      {
+        "documentReferenceType": "TRD",
+        "documentReferenceValue": "MEDUAA000001"
+      }
+    ],
+    "eventLocation": {
+      "locationName": "QINGDAO",
+      "unLocationCode": "CNTAO",
+      "facilityCode": "CNTAOZNML",
+      "facilityCodeListProvider": "BIC"
+    },
+    "seals": [
+      {
+        "sealNumber": "FX43937324",
+        "sealSource": "TER"
+      }
+    ],
+    "description": "Empty to Shipper",
+    "eventId": "1724974341",
+    "eventDateTime": "2026-01-05T08:04:00+08:00",
+    "eventClassifierCode": "ACT",
+    "eventCreatedDateTime": "2026-01-05T08:04:00+08:00",
+    "references": []
+  }
+]

package/src/modules/shipment_tracking/__tests__/fixtures/poi-events.json

@@ -0,0 +1,240 @@
+{
+  "waypointReached": [
+    {
+      "lat": 51.34605833333333,
+      "lng": 2.11783,
+      "mmsi": 111000001,
+      "shipId": 8100001,
+      "shipName": "EXAMPLE VESSEL 14",
+      "distanceToPoiMeters": 4926.73453333,
+      "arrivedPoiCode": "N051E002-00772",
+      "ata": "2026-02-23T15:18:19.741Z",
+      "type": "WAYPOINT_REACHED",
+      "sequenceOrder": 1
+    },
+    {
+      "lat": 1.2146016666666666,
+      "lng": 103.88558666666667,
+      "mmsi": 111000002,
+      "shipId": 8100002,
+      "shipName": "EXAMPLE VESSEL 15",
+      "distanceToPoiMeters": 1777.65145027,
+      "arrivedPoiCode": "N001E103-00217",
+      "ata": "2026-02-23T12:28:21.354Z",
+      "type": "WAYPOINT_REACHED",
+      "sequenceOrder": 1
+    },
+    {
+      "lat": 50.782403333333335,
+      "lng": -1.3177416666666666,
+      "mmsi": 111000003,
+      "shipId": 8100003,
+      "shipName": "EXAMPLE VESSEL 16",
+      "distanceToPoiMeters": 4369.82716578,
+      "arrivedPoiCode": "N050W002-01734",
+      "ata": "2026-02-23T12:28:37.306Z",
+      "type": "WAYPOINT_REACHED",
+      "sequenceOrder": 1
+    }
+  ],
+  "portArrival": [
+    {
+      "lat": 35.43613333333334,
+      "lng": 139.67835333333332,
+      "mmsi": 111000004,
+      "shipId": 8100004,
+      "shipName": "EXAMPLE VESSEL 17",
+      "distanceToPoiMeters": 151.456159,
+      "arrivedPoiCode": "N035E139-03434",
+      "ata": "2026-02-23T12:28:47.810Z",
+      "type": "PORT_ARRIVAL",
+      "sequenceOrder": 2
+    },
+    {
+      "lat": 44.405925,
+      "lng": 8.885033333333332,
+      "mmsi": 111000005,
+      "shipId": 8100005,
+      "shipName": "EXAMPLE VESSEL 18",
+      "distanceToPoiMeters": 27.24515084,
+      "arrivedPoiCode": "N044E008-03880",
+      "ata": "2026-02-23T12:30:16.729Z",
+      "type": "PORT_ARRIVAL",
+      "sequenceOrder": 1
+    }
+  ],
+  "terminalArrival": [
+    {
+      "lat": 35.43613333333334,
+      "lng": 139.67835333333332,
+      "mmsi": 111000004,
+      "shipId": 8100004,
+      "shipName": "EXAMPLE VESSEL 17",
+      "distanceToPoiMeters": 151.456159,
+      "arrivedPoiCode": "N035E139-03434",
+      "ata": "2026-02-23T12:28:47.810Z",
+      "type": "TERMINAL_ARRIVAL",
+      "sequenceOrder": 3
+    },
+    {
+      "lat": 44.405925,
+      "lng": 8.885033333333332,
+      "mmsi": 111000005,
+      "shipId": 8100005,
+      "shipName": "EXAMPLE VESSEL 18",
+      "distanceToPoiMeters": 27.24515084,
+      "arrivedPoiCode": "N044E008-03880",
+      "ata": "2026-02-23T12:30:16.729Z",
+      "type": "TERMINAL_ARRIVAL",
+      "sequenceOrder": 2
+    },
+    {
+      "lat": -33.970978333333335,
+      "lng": 151.21371499999998,
+      "mmsi": 111000006,
+      "shipId": 8100006,
+      "shipName": "EXAMPLE VESSEL 19",
+      "distanceToPoiMeters": 255.61396904,
+      "arrivedPoiCode": "S034E151-00941",
+      "ata": "2026-02-23T12:30:24.321Z",
+      "type": "TERMINAL_ARRIVAL",
+      "sequenceOrder": 2
+    }
+  ],
+  "portProximityArrival": [
+    {
+      "lat": 51.503283333333336,
+      "lng": 0.49595,
+      "mmsi": 111000007,
+      "shipId": 8100007,
+      "shipName": "EXAMPLE VESSEL 20",
+      "distanceToPoiMeters": 136.13051376,
+      "arrivedPoiCode": "N051E000-01159",
+      "ata": "2026-02-23T12:30:17.162Z",
+      "type": "PORT_PROXIMITY_ARRIVAL",
+      "sequenceOrder": 1
+    }
+  ],
+  "terminalProximityArrival": [
+    {
+      "lat": 33.72472833333333,
+      "lng": -118.27094000000001,
+      "mmsi": 111000008,
+      "shipId": 8100008,
+      "shipName": "EXAMPLE VESSEL 21",
+      "distanceToPoiMeters": 964.82109043,
+      "arrivedPoiCode": "N033W119-01930",
+      "ata": "2026-02-23T12:28:49.405Z",
+      "type": "TERMINAL_PROXIMITY_ARRIVAL",
+      "sequenceOrder": 2
+    },
+    {
+      "lat": 51.503283333333336,
+      "lng": 0.49595,
+      "mmsi": 111000007,
+      "shipId": 8100007,
+      "shipName": "EXAMPLE VESSEL 20",
+      "distanceToPoiMeters": 136.13051376,
+      "arrivedPoiCode": "N051E000-01159",
+      "ata": "2026-02-23T12:30:17.162Z",
+      "type": "TERMINAL_PROXIMITY_ARRIVAL",
+      "sequenceOrder": 2
+    },
+    {
+      "lat": 51.354971666666664,
+      "lng": 3.196975,
+      "mmsi": 111000009,
+      "shipId": 8100009,
+      "shipName": "EXAMPLE VESSEL 22",
+      "distanceToPoiMeters": 824.04055779,
+      "arrivedPoiCode": "N051E003-01869",
+      "ata": "2026-02-23T12:30:18.412Z",
+      "type": "TERMINAL_PROXIMITY_ARRIVAL",
+      "sequenceOrder": 1
+    }
+  ],
+  "portProximityDeparture": [
+    {
+      "lat": 37.58989,
+      "lng": -0.9855416666666666,
+      "mmsi": 111000010,
+      "shipId": 8100010,
+      "shipName": "EXAMPLE VESSEL 23",
+      "distanceToPoiMeters": 114.95865695,
+      "departedPoiCode": "N037W001-03965",
+      "atd": "2026-02-23T12:28:41.000Z",
+      "type": "PORT_PROXIMITY_DEPARTURE",
+      "sequenceOrder": 2
+    },
+    {
+      "lat": 49.776316666666666,
+      "lng": -3.0458,
+      "mmsi": 111000007,
+      "shipId": 8100007,
+      "shipName": "EXAMPLE VESSEL 20",
+      "distanceToPoiMeters": 1517.01210369,
+      "departedPoiCode": "N051E000-01159",
+      "atd": "2026-02-23T12:29:38.896Z",
+      "type": "PORT_PROXIMITY_DEPARTURE",
+      "sequenceOrder": 2
+    }
+  ],
+  "terminalProximityDeparture": [
+    {
+      "lat": 37.58989,
+      "lng": -0.9855416666666666,
+      "mmsi": 111000010,
+      "shipId": 8100010,
+      "shipName": "EXAMPLE VESSEL 23",
+      "distanceToPoiMeters": 114.95865695,
+      "departedPoiCode": "N037W001-03965",
+      "atd": "2026-02-23T12:28:41.000Z",
+      "type": "TERMINAL_PROXIMITY_DEPARTURE",
+      "sequenceOrder": 1
+    },
+    {
+      "lat": 35.43613333333334,
+      "lng": 139.67835333333332,
+      "mmsi": 111000004,
+      "shipId": 8100004,
+      "shipName": "EXAMPLE VESSEL 17",
+      "distanceToPoiMeters": 151.456159,
+      "departedPoiCode": "N035E139-01261",
+      "atd": "2026-02-23T12:28:47.810Z",
+      "type": "TERMINAL_PROXIMITY_DEPARTURE",
+      "sequenceOrder": 1
+    },
+    {
+      "lat": 51.84239166666667,
+      "lng": -8.310848333333333,
+      "mmsi": 111000011,
+      "shipId": 8100011,
+      "shipName": "EXAMPLE VESSEL 24",
+      "distanceToPoiMeters": 4802.97880325,
+      "departedPoiCode": "N051W009-03379",
+      "atd": "2026-02-23T12:30:05.652Z",
+      "type": "TERMINAL_PROXIMITY_DEPARTURE",
+      "sequenceOrder": 1
+    },
+    {
+      "lat": 33.720818333333334,
+      "lng": -118.26913333333333,
+      "mmsi": 111000008,
+      "shipId": 8100008,
+      "shipName": "EXAMPLE VESSEL 21",
+      "distanceToPoiMeters": 2775.94808608,
+      "departedPoiCode": "N033W119-01930",
+      "atd": "2026-02-23T12:30:49.211Z",
+      "type": "TERMINAL_PROXIMITY_DEPARTURE",
+      "sequenceOrder": 1
+    }
+  ],
+  "invalidMessages": [
+    { "test": "message" },
+    { "test": "from-container" },
+    { "test": "manual-test", "timestamp": "2026-02-23T11:56:15.949Z" },
+    {},
+    { "shipId": 1234, "lat": 50, "lng": 10 },
+    { "mmsi": 123456789, "shipName": "TEST" }
+  ]
+}