grm-shared-library 1.1.188 → 1.1.190

package/dist/esm/kafka/topics.js

@@ -53,5 +53,18 @@ export const KAFKA_TOPICS = {
     NEWSFEED_COMMENT_CREATED: 'newsfeed.comment.created',
     NEWSFEED_COMMENT_UPDATED: 'newsfeed.comment.updated',
     NEWSFEED_COMMENT_DELETED: 'newsfeed.comment.deleted',
+    // Response-unit tracking (clarion-response-tracking) — versioned
+    TRACKING_POSITION: 'tracking.response-unit.position.v1',
+    TRACKING_STATUS: 'tracking.response-unit.status.v1',
+    TRACKING_PROVIDER_HEALTH: 'tracking.provider.health.v1',
+    TRACKING_DEVICE_UNMAPPED: 'tracking.device.unmapped.v1',
+    TRACKING_INGESTION_ERROR: 'tracking.ingestion.error.v1',
+    // Organization response-unit lifecycle (producer: clarion-organization;
+    // consumer: clarion-response-tracking projection) — versioned.
+    ORG_RESPONSE_UNIT_CREATED: 'organization.response-unit.created.v1',
+    ORG_RESPONSE_UNIT_UPDATED: 'organization.response-unit.updated.v1',
+    ORG_RESPONSE_UNIT_DELETED: 'organization.response-unit.deleted.v1',
+    ORG_RESPONSE_UNIT_CONTROL_CENTRE_CHANGED: 'organization.response-unit.control-centre-changed.v1',
+    ORG_RESPONSE_UNIT_STATUS_CHANGED: 'organization.response-unit.status-changed.v1',
 };
 //# sourceMappingURL=topics.js.map

package/dist/esm/kafka/topics.js.map

@@ -1 +1 @@
-{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../../src/kafka/topics.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,OAAO;IACP,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,6BAA6B,EAAE,+BAA+B;IAC9D,6BAA6B,EAAE,+BAA+B;IAC9D,OAAO;IACP,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,MAAM;IACN,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,MAAM;IACN,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,eAAe;IAC9B,WAAW;IACX,cAAc,EAAE,gBAAgB;IAChC,WAAW;IACX,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;IAClD,sBAAsB,EAAE,wBAAwB;IAChD,yBAAyB,EAAE,2BAA2B;IACtD,wBAAwB,EAAE,0BAA0B;IACpD,0BAA0B,EAAE,4BAA4B;IACxD,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB,EAAE,mBAAmB;IACtC,2BAA2B,EAAE,6BAA6B;IAC1D,yCAAyC,EAAE,2CAA2C;IACtF,OAAO;IACP,oBAAoB,EAAE,sBAAsB;IAC5C,yBAAyB,EAAE,2BAA2B;IACtD,qBAAqB,EAAE,uBAAuB;IAC9C,OAAO;IACP,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,OAAO;IACP,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAC5C,WAAW;IACX,qBAAqB,EAAE,uBAAuB;IAC9C,uBAAuB,EAAE,yBAAyB;IAClD,qBAAqB,EAAE,uBAAuB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,sBAAsB;IAC5C,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;CACvD,CAAC"}
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../../src/kafka/topics.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,OAAO;IACP,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,6BAA6B,EAAE,+BAA+B;IAC9D,6BAA6B,EAAE,+BAA+B;IAC9D,OAAO;IACP,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,MAAM;IACN,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,MAAM;IACN,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,eAAe;IAC9B,WAAW;IACX,cAAc,EAAE,gBAAgB;IAChC,WAAW;IACX,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;IAClD,sBAAsB,EAAE,wBAAwB;IAChD,yBAAyB,EAAE,2BAA2B;IACtD,wBAAwB,EAAE,0BAA0B;IACpD,0BAA0B,EAAE,4BAA4B;IACxD,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB,EAAE,mBAAmB;IACtC,2BAA2B,EAAE,6BAA6B;IAC1D,yCAAyC,EAAE,2CAA2C;IACtF,OAAO;IACP,oBAAoB,EAAE,sBAAsB;IAC5C,yBAAyB,EAAE,2BAA2B;IACtD,qBAAqB,EAAE,uBAAuB;IAC9C,OAAO;IACP,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,OAAO;IACP,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAC5C,WAAW;IACX,qBAAqB,EAAE,uBAAuB;IAC9C,uBAAuB,EAAE,yBAAyB;IAClD,qBAAqB,EAAE,uBAAuB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,oBAAoB,EAAE,sBAAsB;IAC5C,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;IACpD,iEAAiE;IACjE,iBAAiB,EAAE,oCAAoC;IACvD,eAAe,EAAE,kCAAkC;IACnD,wBAAwB,EAAE,6BAA6B;IACvD,wBAAwB,EAAE,6BAA6B;IACvD,wBAAwB,EAAE,6BAA6B;IACvD,wEAAwE;IACxE,+DAA+D;IAC/D,yBAAyB,EAAE,uCAAuC;IAClE,yBAAyB,EAAE,uCAAuC;IAClE,yBAAyB,EAAE,uCAAuC;IAClE,wCAAwC,EACpC,sDAAsD;IAC1D,gCAAgC,EAAE,8CAA8C;CACnF,CAAC"}

package/dist/esm/modules/common/constants/service.const.js

@@ -13,5 +13,6 @@ export const SERVICE_CONSTS = {
     CALL_SERVICE: { name: 'call-service', port: 3011 },
     BILLING_SERVICE: { name: 'billing-service', port: 3012 },
     NEWSFEED_SERVICE: { name: 'newsfeed-service', port: 3015 },
+    RESPONSE_TRACKING_SERVICE: { name: 'response-tracking-service', port: 3016 },
 };
 //# sourceMappingURL=service.const.js.map

package/dist/esm/modules/common/constants/service.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.const.js","sourceRoot":"","sources":["../../../../../src/modules/common/constants/service.const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;IAClD,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE;IAClE,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE;IAC1D,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE;IAClE,wBAAwB,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE;IAC1E,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,eAAe,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE;IACxD,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE;IACtD,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;IAClD,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;IAClD,eAAe,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE;IACxD,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE;CAC7D,CAAC"}
+{"version":3,"file":"service.const.js","sourceRoot":"","sources":["../../../../../src/modules/common/constants/service.const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;IAClD,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE;IAClE,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE;IAC1D,oBAAoB,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE;IAClE,wBAAwB,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE;IAC1E,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,eAAe,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE;IACxD,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE;IACtD,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;IAClD,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE;IAClD,eAAe,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE;IACxD,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE;IAC1D,yBAAyB,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,IAAI,EAAE,IAAI,EAAE;CAC/E,CAAC"}

package/dist/esm/modules/socket/enums/redis-channel-name.enum.js

@@ -5,5 +5,6 @@ export var RedisChannelName;
     RedisChannelName["PUSH_NOTIFICATIONS"] = "realtime:push-notifications";
     RedisChannelName["TASKS"] = "realtime:tasks";
     RedisChannelName["NEWSFEED"] = "realtime:newsfeed";
+    RedisChannelName["TRACKING"] = "realtime:tracking";
 })(RedisChannelName || (RedisChannelName = {}));
 //# sourceMappingURL=redis-channel-name.enum.js.map

package/dist/esm/modules/socket/enums/redis-channel-name.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"redis-channel-name.enum.js","sourceRoot":"","sources":["../../../../../src/modules/socket/enums/redis-channel-name.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IACxB,oDAAgC,CAAA;IAChC,oEAAgD,CAAA;IAChD,sEAAkD,CAAA;IAClD,4CAAwB,CAAA;IACxB,kDAA8B,CAAA;AAClC,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B"}
+{"version":3,"file":"redis-channel-name.enum.js","sourceRoot":"","sources":["../../../../../src/modules/socket/enums/redis-channel-name.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IACxB,oDAAgC,CAAA;IAChC,oEAAgD,CAAA;IAChD,sEAAkD,CAAA;IAClD,4CAAwB,CAAA;IACxB,kDAA8B,CAAA;IAC9B,kDAA8B,CAAA;AAClC,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B"}

package/dist/esm/modules/socket/enums/socket-event-name.enum.js

@@ -6,5 +6,10 @@ export var SocketEventName;
     SocketEventName["TASK_EVENT"] = "task.event";
     SocketEventName["TRIP_EVENT"] = "trip.event";
     SocketEventName["NEWSFEED_EVENT"] = "newsfeed.event";
+    // Response-unit tracking (clarion-response-tracking → clarion-socket)
+    SocketEventName["TRACKING_POSITION"] = "tracking:position";
+    SocketEventName["TRACKING_STATUS"] = "tracking:status";
+    SocketEventName["TRACKING_REMOVED"] = "tracking:removed";
+    SocketEventName["TRACKING_PROVIDER_HEALTH"] = "tracking:provider-health";
 })(SocketEventName || (SocketEventName = {}));
 //# sourceMappingURL=socket-event-name.enum.js.map

package/dist/esm/modules/socket/enums/socket-event-name.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"socket-event-name.enum.js","sourceRoot":"","sources":["../../../../../src/modules/socket/enums/socket-event-name.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACvB,oDAAiC,CAAA;IACjC,mEAAgD,CAAA;IAChD,qEAAkD,CAAA;IAClD,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,oDAAiC,CAAA;AACrC,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B"}
+{"version":3,"file":"socket-event-name.enum.js","sourceRoot":"","sources":["../../../../../src/modules/socket/enums/socket-event-name.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,eAYX;AAZD,WAAY,eAAe;IACvB,oDAAiC,CAAA;IACjC,mEAAgD,CAAA;IAChD,qEAAkD,CAAA;IAClD,4CAAyB,CAAA;IACzB,4CAAyB,CAAA;IACzB,oDAAiC,CAAA;IACjC,sEAAsE;IACtE,0DAAuC,CAAA;IACvC,sDAAmC,CAAA;IACnC,wDAAqC,CAAA;IACrC,wEAAqD,CAAA;AACzD,CAAC,EAZW,eAAe,KAAf,eAAe,QAY1B"}

package/dist/esm/modules/tracking/constants/tracking-kafka.const.js

@@ -0,0 +1,45 @@
+import { KAFKA_TOPICS } from '../../../kafka/topics';
+/**
+ * Grouped, typed view of the tracking Kafka topics. The canonical string values
+ * live in {@link KAFKA_TOPICS} (alongside every other domain's topics); this
+ * object references them so there is a single source of truth and no drift.
+ *
+ * Producer:  clarion-response-tracking (connector-worker → POSITION, DEVICE_UNMAPPED,
+ *            PROVIDER_HEALTH, INGESTION_ERROR; projector → STATUS).
+ * Consumers: clarion-response-tracking (projector) for POSITION/STATUS.
+ */
+export const TRACKING_KAFKA_TOPICS = {
+    POSITION: KAFKA_TOPICS.TRACKING_POSITION,
+    STATUS: KAFKA_TOPICS.TRACKING_STATUS,
+    PROVIDER_HEALTH: KAFKA_TOPICS.TRACKING_PROVIDER_HEALTH,
+    DEVICE_UNMAPPED: KAFKA_TOPICS.TRACKING_DEVICE_UNMAPPED,
+    INGESTION_ERROR: KAFKA_TOPICS.TRACKING_INGESTION_ERROR,
+};
+/**
+ * Response-unit lifecycle topics. Producer: clarion-organization. Consumer:
+ * clarion-response-tracking projection. Single source of truth = {@link KAFKA_TOPICS}.
+ */
+export const ORG_RESPONSE_UNIT_TOPICS = {
+    CREATED: KAFKA_TOPICS.ORG_RESPONSE_UNIT_CREATED,
+    UPDATED: KAFKA_TOPICS.ORG_RESPONSE_UNIT_UPDATED,
+    DELETED: KAFKA_TOPICS.ORG_RESPONSE_UNIT_DELETED,
+    CONTROL_CENTRE_CHANGED: KAFKA_TOPICS.ORG_RESPONSE_UNIT_CONTROL_CENTRE_CHANGED,
+    STATUS_CHANGED: KAFKA_TOPICS.ORG_RESPONSE_UNIT_STATUS_CHANGED,
+};
+/**
+ * Consumer group ids for tracking consumers. Distinct groups keep each concern's
+ * offsets independent and let projector replicas share partitions safely.
+ */
+export const TRACKING_CONSUMER_GROUPS = {
+    /** clarion-response-tracking projector: history + current-state + status. */
+    PROJECTOR: 'response-tracking-projector-consumer',
+};
+/**
+ * Redis pub/sub channel clarion-response-tracking publishes client-safe tracking
+ * envelopes to, and clarion-socket subscribes to for fan-out. Mirrors the
+ * `realtime:*` channel convention in {@link RedisChannelName}.
+ */
+export const TRACKING_REALTIME_CHANNEL = 'realtime:tracking';
+/** Current schema version for all Tracking*EventV1 contracts. */
+export const TRACKING_SCHEMA_VERSION = 1;
+//# sourceMappingURL=tracking-kafka.const.js.map

package/dist/esm/modules/tracking/constants/tracking-kafka.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-kafka.const.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/constants/tracking-kafka.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,QAAQ,EAAE,YAAY,CAAC,iBAAiB;IACxC,MAAM,EAAE,YAAY,CAAC,eAAe;IACpC,eAAe,EAAE,YAAY,CAAC,wBAAwB;IACtD,eAAe,EAAE,YAAY,CAAC,wBAAwB;IACtD,eAAe,EAAE,YAAY,CAAC,wBAAwB;CAChD,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,OAAO,EAAE,YAAY,CAAC,yBAAyB;IAC/C,OAAO,EAAE,YAAY,CAAC,yBAAyB;IAC/C,OAAO,EAAE,YAAY,CAAC,yBAAyB;IAC/C,sBAAsB,EAAE,YAAY,CAAC,wCAAwC;IAC7E,cAAc,EAAE,YAAY,CAAC,gCAAgC;CACvD,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,6EAA6E;IAC7E,SAAS,EAAE,sCAAsC;CAC3C,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAE7D,iEAAiE;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAC"}

package/dist/esm/modules/tracking/enums/tracking-connection-status.enum.js

@@ -0,0 +1,24 @@
+/**
+ * Lifecycle state of a provider connection as observed by the connector worker.
+ * Surfaced in provider-health events and the provider-connection REST resource.
+ */
+export var TrackingConnectionStatus;
+(function (TrackingConnectionStatus) {
+    /** Administratively disabled — the worker will not attempt to connect. */
+    TrackingConnectionStatus["DISABLED"] = "DISABLED";
+    /** Not currently connected (idle, or between reconnect attempts). */
+    TrackingConnectionStatus["DISCONNECTED"] = "DISCONNECTED";
+    /** Transport handshake in progress. */
+    TrackingConnectionStatus["CONNECTING"] = "CONNECTING";
+    /** Transport is up; provider authentication / subscription in progress. */
+    TrackingConnectionStatus["AUTHENTICATING"] = "AUTHENTICATING";
+    /** Authenticated, subscribed and receiving (or ready to receive) telemetry. */
+    TrackingConnectionStatus["CONNECTED"] = "CONNECTED";
+    /** Connected but unhealthy (e.g. no telemetry for longer than expected). */
+    TrackingConnectionStatus["DEGRADED"] = "DEGRADED";
+    /** Provider rejected the credentials — a config problem, not a network blip. */
+    TrackingConnectionStatus["AUTHENTICATION_FAILED"] = "AUTHENTICATION_FAILED";
+    /** Non-auth error state (transport failure, protocol error, etc.). */
+    TrackingConnectionStatus["ERROR"] = "ERROR";
+})(TrackingConnectionStatus || (TrackingConnectionStatus = {}));
+//# sourceMappingURL=tracking-connection-status.enum.js.map

package/dist/esm/modules/tracking/enums/tracking-connection-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-connection-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-connection-status.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,wBAiBX;AAjBD,WAAY,wBAAwB;IAChC,0EAA0E;IAC1E,iDAAqB,CAAA;IACrB,qEAAqE;IACrE,yDAA6B,CAAA;IAC7B,uCAAuC;IACvC,qDAAyB,CAAA;IACzB,2EAA2E;IAC3E,6DAAiC,CAAA;IACjC,+EAA+E;IAC/E,mDAAuB,CAAA;IACvB,4EAA4E;IAC5E,iDAAqB,CAAA;IACrB,gFAAgF;IAChF,2EAA+C,CAAA;IAC/C,sEAAsE;IACtE,2CAAe,CAAA;AACnB,CAAC,EAjBW,wBAAwB,KAAxB,wBAAwB,QAiBnC"}

package/dist/esm/modules/tracking/enums/tracking-event-quality.enum.js

@@ -0,0 +1,19 @@
+/**
+ * Coarse classification of an ingested location, used for diagnostics and to
+ * decide whether an event updates current state (only fresh, in-order, valid
+ * events do). Fine-grained booleans live in {@link TrackingPositionQualityFlags}.
+ */
+export var TrackingEventQuality;
+(function (TrackingEventQuality) {
+    /** Valid, fresh and in order. */
+    TrackingEventQuality["GOOD"] = "GOOD";
+    /** Already seen (same deterministic eventId). */
+    TrackingEventQuality["DUPLICATE"] = "DUPLICATE";
+    /** Older than the current state for this unit. */
+    TrackingEventQuality["OUT_OF_ORDER"] = "OUT_OF_ORDER";
+    /** Coordinates outside the valid WGS84 range. */
+    TrackingEventQuality["INVALID_COORDINATES"] = "INVALID_COORDINATES";
+    /** Timestamp missing, unparseable, or outside the accepted tolerance. */
+    TrackingEventQuality["INVALID_TIMESTAMP"] = "INVALID_TIMESTAMP";
+})(TrackingEventQuality || (TrackingEventQuality = {}));
+//# sourceMappingURL=tracking-event-quality.enum.js.map

package/dist/esm/modules/tracking/enums/tracking-event-quality.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-event-quality.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-event-quality.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,oBAWX;AAXD,WAAY,oBAAoB;IAC5B,iCAAiC;IACjC,qCAAa,CAAA;IACb,iDAAiD;IACjD,+CAAuB,CAAA;IACvB,kDAAkD;IAClD,qDAA6B,CAAA;IAC7B,iDAAiD;IACjD,mEAA2C,CAAA;IAC3C,yEAAyE;IACzE,+DAAuC,CAAA;AAC3C,CAAC,EAXW,oBAAoB,KAApB,oBAAoB,QAW/B"}

package/dist/esm/modules/tracking/enums/tracking-provider-code.enum.js

@@ -0,0 +1,25 @@
+/**
+ * Identifies the third-party tracking platform a provider connection integrates
+ * with. Provider-neutral: the core ingestion pipeline, tenant model, device
+ * bindings and canonical events never branch on a specific provider — only the
+ * per-provider adapter inside clarion-response-tracking understands the raw
+ * wire format.
+ *
+ * Only {@link TrackingProviderCode.TELOX} has a working adapter in Phase 1. The
+ * remaining values are reserved so future adapters can be added without changing
+ * the shared contracts, database columns or Kafka events.
+ */
+export var TrackingProviderCode;
+(function (TrackingProviderCode) {
+    /** Telox WebSocket platform (G4S Phase 1 integration). */
+    TrackingProviderCode["TELOX"] = "TELOX";
+    /** Wialon (reserved — not implemented in Phase 1). */
+    TrackingProviderCode["WIALON"] = "WIALON";
+    /** Teltonika direct device ingestion (reserved — not implemented in Phase 1). */
+    TrackingProviderCode["TELTONIKA"] = "TELTONIKA";
+    /** Generic WebSocket adapter (reserved). */
+    TrackingProviderCode["GENERIC_WEBSOCKET"] = "GENERIC_WEBSOCKET";
+    /** Generic HTTP polling adapter (reserved). */
+    TrackingProviderCode["GENERIC_HTTP_POLLING"] = "GENERIC_HTTP_POLLING";
+})(TrackingProviderCode || (TrackingProviderCode = {}));
+//# sourceMappingURL=tracking-provider-code.enum.js.map

package/dist/esm/modules/tracking/enums/tracking-provider-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-provider-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-provider-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,oBAWX;AAXD,WAAY,oBAAoB;IAC5B,0DAA0D;IAC1D,uCAAe,CAAA;IACf,sDAAsD;IACtD,yCAAiB,CAAA;IACjB,iFAAiF;IACjF,+CAAuB,CAAA;IACvB,4CAA4C;IAC5C,+DAAuC,CAAA;IACvC,+CAA+C;IAC/C,qEAA6C,CAAA;AACjD,CAAC,EAXW,oBAAoB,KAApB,oBAAoB,QAW/B"}

package/dist/esm/modules/tracking/enums/tracking-transport-type.enum.js

@@ -0,0 +1,19 @@
+/**
+ * How a provider connection physically transports telemetry into
+ * clarion-response-tracking. Phase 1 implements only {@link WEBSOCKET} (Telox);
+ * the remaining values are reserved for future adapters.
+ */
+export var TrackingTransportType;
+(function (TrackingTransportType) {
+    /** Outbound WebSocket client maintained by the connector worker (Telox). */
+    TrackingTransportType["WEBSOCKET"] = "WEBSOCKET";
+    /** Outbound HTTP polling loop. */
+    TrackingTransportType["HTTP_POLLING"] = "HTTP_POLLING";
+    /** Inbound TCP listener (direct device ingestion). */
+    TrackingTransportType["TCP"] = "TCP";
+    /** Inbound UDP listener (direct device ingestion). */
+    TrackingTransportType["UDP"] = "UDP";
+    /** MQTT subscription. */
+    TrackingTransportType["MQTT"] = "MQTT";
+})(TrackingTransportType || (TrackingTransportType = {}));
+//# sourceMappingURL=tracking-transport-type.enum.js.map

package/dist/esm/modules/tracking/enums/tracking-transport-type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-transport-type.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-transport-type.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,qBAWX;AAXD,WAAY,qBAAqB;IAC7B,4EAA4E;IAC5E,gDAAuB,CAAA;IACvB,kCAAkC;IAClC,sDAA6B,CAAA;IAC7B,sDAAsD;IACtD,oCAAW,CAAA;IACX,sDAAsD;IACtD,oCAAW,CAAA;IACX,yBAAyB;IACzB,sCAAa,CAAA;AACjB,CAAC,EAXW,qBAAqB,KAArB,qBAAqB,QAWhC"}

package/dist/esm/modules/tracking/enums/tracking-unit-online-status.enum.js

@@ -0,0 +1,15 @@
+/**
+ * Freshness of a response unit's last known position, derived by the projector's
+ * scheduled status evaluator from the gap between "now" and the last event time,
+ * using per-connection stale/offline thresholds.
+ */
+export var TrackingUnitOnlineStatus;
+(function (TrackingUnitOnlineStatus) {
+    /** Reporting within the configured stale threshold. */
+    TrackingUnitOnlineStatus["ONLINE"] = "ONLINE";
+    /** No update within the stale threshold but within the offline threshold. */
+    TrackingUnitOnlineStatus["STALE"] = "STALE";
+    /** No update within the offline threshold. */
+    TrackingUnitOnlineStatus["OFFLINE"] = "OFFLINE";
+})(TrackingUnitOnlineStatus || (TrackingUnitOnlineStatus = {}));
+//# sourceMappingURL=tracking-unit-online-status.enum.js.map

package/dist/esm/modules/tracking/enums/tracking-unit-online-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-unit-online-status.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-unit-online-status.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,wBAOX;AAPD,WAAY,wBAAwB;IAChC,uDAAuD;IACvD,6CAAiB,CAAA;IACjB,6EAA6E;IAC7E,2CAAe,CAAA;IACf,8CAA8C;IAC9C,+CAAmB,CAAA;AACvB,CAAC,EAPW,wBAAwB,KAAxB,wBAAwB,QAOnC"}

package/dist/esm/modules/tracking/index.js

@@ -0,0 +1,24 @@
+// Enums
+export * from './enums/tracking-provider-code.enum';
+export * from './enums/tracking-transport-type.enum';
+export * from './enums/tracking-connection-status.enum';
+export * from './enums/tracking-unit-online-status.enum';
+export * from './enums/tracking-event-quality.enum';
+// Interfaces — canonical Kafka event contracts
+export * from './interfaces/tracking-position-quality-flags';
+export * from './interfaces/response-unit-position-event-v1';
+export * from './interfaces/response-unit-status-event-v1';
+export * from './interfaces/tracking-provider-health-event-v1';
+export * from './interfaces/tracking-device-unmapped-event-v1';
+export * from './interfaces/tracking-ingestion-error-event-v1';
+export * from './interfaces/response-unit-lifecycle-events';
+// Interfaces — projections & realtime delivery
+export * from './interfaces/tracking-unit-current-state';
+export * from './interfaces/tracking-socket-payloads';
+export * from './interfaces/tracking-realtime-envelope';
+// Constants
+export * from './constants/tracking-kafka.const';
+// Utilities
+export * from './utils/tracking-event-id.util';
+export * from './utils/tracking-validation.util';
+//# sourceMappingURL=index.js.map

package/dist/esm/modules/tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/tracking/index.ts"],"names":[],"mappings":"AAAA,QAAQ;AACR,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AAEpD,+CAA+C;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,6CAA6C,CAAC;AAE5D,+CAA+C;AAC/C,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AAExD,YAAY;AACZ,cAAc,kCAAkC,CAAC;AAEjD,YAAY;AACZ,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC"}

package/dist/esm/modules/tracking/interfaces/response-unit-lifecycle-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=response-unit-lifecycle-events.js.map

package/dist/esm/modules/tracking/interfaces/response-unit-lifecycle-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-lifecycle-events.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/response-unit-lifecycle-events.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/response-unit-position-event-v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=response-unit-position-event-v1.js.map

package/dist/esm/modules/tracking/interfaces/response-unit-position-event-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-position-event-v1.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/response-unit-position-event-v1.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/response-unit-status-event-v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=response-unit-status-event-v1.js.map

package/dist/esm/modules/tracking/interfaces/response-unit-status-event-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-unit-status-event-v1.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/response-unit-status-event-v1.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/tracking-device-unmapped-event-v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracking-device-unmapped-event-v1.js.map

package/dist/esm/modules/tracking/interfaces/tracking-device-unmapped-event-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-device-unmapped-event-v1.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/tracking-device-unmapped-event-v1.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/tracking-ingestion-error-event-v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracking-ingestion-error-event-v1.js.map

package/dist/esm/modules/tracking/interfaces/tracking-ingestion-error-event-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-ingestion-error-event-v1.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/tracking-ingestion-error-event-v1.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/tracking-position-quality-flags.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracking-position-quality-flags.js.map

package/dist/esm/modules/tracking/interfaces/tracking-position-quality-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-position-quality-flags.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/tracking-position-quality-flags.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/tracking-provider-health-event-v1.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracking-provider-health-event-v1.js.map

package/dist/esm/modules/tracking/interfaces/tracking-provider-health-event-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-provider-health-event-v1.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/tracking-provider-health-event-v1.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/tracking-realtime-envelope.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracking-realtime-envelope.js.map

package/dist/esm/modules/tracking/interfaces/tracking-realtime-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-realtime-envelope.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/tracking-realtime-envelope.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/tracking-socket-payloads.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracking-socket-payloads.js.map

package/dist/esm/modules/tracking/interfaces/tracking-socket-payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-socket-payloads.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/tracking-socket-payloads.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/interfaces/tracking-unit-current-state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracking-unit-current-state.js.map

package/dist/esm/modules/tracking/interfaces/tracking-unit-current-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-unit-current-state.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/interfaces/tracking-unit-current-state.ts"],"names":[],"mappings":""}

package/dist/esm/modules/tracking/utils/tracking-event-id.util.js

@@ -0,0 +1,27 @@
+import { createHash } from 'node:crypto';
+/**
+ * Build a deterministic tracking event id (sha256 hex) from stable fix inputs.
+ *
+ * Coordinates are quantized to 6 decimal places (~0.11 m) so floating-point
+ * representation differences across services never split one physical fix into
+ * two ids. Epoch seconds are truncated to whole seconds.
+ */
+export function buildTrackingEventId(parts) {
+    const canonical = [
+        parts.providerConnectionId,
+        parts.externalUnitId,
+        Math.trunc(parts.eventEpochSeconds),
+        parts.latitude.toFixed(6),
+        parts.longitude.toFixed(6),
+    ].join('|');
+    return createHash('sha256').update(canonical).digest('hex');
+}
+/**
+ * Kafka partition key for position/status events. Keying by
+ * `{organizationId}:{controlCentreId}:{responseUnitId}` guarantees per-unit
+ * ordering within a partition. Never use a random key for these events.
+ */
+export function buildTrackingPartitionKey(organizationId, controlCentreId, responseUnitId) {
+    return `${organizationId}:${controlCentreId}:${responseUnitId}`;
+}
+//# sourceMappingURL=tracking-event-id.util.js.map

package/dist/esm/modules/tracking/utils/tracking-event-id.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-event-id.util.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/utils/tracking-event-id.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgBzC;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC5D,MAAM,SAAS,GAAG;QACd,KAAK,CAAC,oBAAoB;QAC1B,KAAK,CAAC,cAAc;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACzB,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;KAC7B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACZ,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACrC,cAAsB,EACtB,eAAuB,EACvB,cAAsB;IAEtB,OAAO,GAAG,cAAc,IAAI,eAAe,IAAI,cAAc,EAAE,CAAC;AACpE,CAAC"}

package/dist/esm/modules/tracking/utils/tracking-validation.util.js

@@ -0,0 +1,93 @@
+/**
+ * Provider-neutral validation/normalization helpers shared by the ingestion
+ * pipeline (and reusable by tests). No provider-specific field names appear here.
+ */
+/** WGS84 latitude range check. */
+export function isValidLatitude(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= -90 && value <= 90;
+}
+/** WGS84 longitude range check. */
+export function isValidLongitude(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= -180 && value <= 180;
+}
+/** A valid course is a finite number in [0, 360). */
+export function isValidCourseDegrees(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 && value < 360;
+}
+/**
+ * Normalize a raw course/bearing value into degrees in [0, 360), or null when it
+ * cannot be trusted for rotation.
+ *
+ * - A raw value of exactly `unknownSentinel` (default -1) is treated as unknown.
+ * - When `divisor` > 1 the raw value is divided (e.g. 27306 / 100 = 273.06).
+ * - The result is wrapped into [0, 360); a non-finite result yields null.
+ *
+ * The divisor is NOT hardcoded to a provider's scale — callers pass the value
+ * they have configured/confirmed for that connection.
+ */
+export function normalizeCourseDegrees(raw, divisor = 1, unknownSentinel = -1) {
+    if (raw === null || raw === undefined || !Number.isFinite(raw)) {
+        return null;
+    }
+    if (unknownSentinel !== null && raw === unknownSentinel) {
+        return null;
+    }
+    const scaled = divisor && divisor !== 0 ? raw / divisor : raw;
+    if (!Number.isFinite(scaled)) {
+        return null;
+    }
+    // Wrap into [0, 360).
+    const wrapped = ((scaled % 360) + 360) % 360;
+    return isValidCourseDegrees(wrapped) ? wrapped : null;
+}
+/**
+ * Convert a raw speed into kilometres per hour given the source unit and an
+ * optional multiplier applied to the raw value first. Returns null for
+ * non-finite or negative inputs. `RAW` means "already km/h after the multiplier".
+ */
+export function normalizeSpeedToKph(raw, unit = 'RAW', multiplier = 1) {
+    if (raw === null || raw === undefined || !Number.isFinite(raw)) {
+        return null;
+    }
+    const value = raw * (Number.isFinite(multiplier) ? multiplier : 1);
+    if (value < 0) {
+        return null;
+    }
+    switch (unit) {
+        case 'KPH':
+        case 'RAW':
+            return value;
+        case 'MPS':
+            return value * 3.6;
+        case 'MPH':
+            return value * 1.609344;
+        default:
+            return value;
+    }
+}
+/**
+ * Validate a provider epoch-seconds timestamp against a tolerance window and
+ * convert to an ISO 8601 UTC string. Returns null when out of range/unparseable.
+ *
+ * @param epochSeconds provider timestamp in seconds
+ * @param nowMs        current time in ms (injectable for deterministic tests)
+ * @param futureToleranceSeconds max seconds a fix may be ahead of now
+ * @param maxAgeSeconds max seconds a fix may be behind now (0/undefined = no limit)
+ */
+export function epochSecondsToIsoUtc(epochSeconds, nowMs, futureToleranceSeconds = 300, maxAgeSeconds) {
+    if (epochSeconds === null ||
+        epochSeconds === undefined ||
+        !Number.isFinite(epochSeconds) ||
+        epochSeconds <= 0) {
+        return null;
+    }
+    const eventMs = Math.trunc(epochSeconds) * 1000;
+    if (eventMs > nowMs + futureToleranceSeconds * 1000) {
+        return null;
+    }
+    if (maxAgeSeconds && maxAgeSeconds > 0 && eventMs < nowMs - maxAgeSeconds * 1000) {
+        return null;
+    }
+    return new Date(eventMs).toISOString();
+}
+//# sourceMappingURL=tracking-validation.util.js.map

package/dist/esm/modules/tracking/utils/tracking-validation.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-validation.util.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/utils/tracking-validation.util.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -18,6 +18,7 @@ export * from './modules/notification/index';
 export * from './modules/chat/index';
 export * from './modules/country/index';
 export * from './modules/phone/index';
+export * from './modules/tracking/index';
 export * from './interfaces/server-message';
 export * from './interfaces/i-request-with-user';
 export * from './interfaces/validated-user';

package/dist/types/kafka/topics.d.ts

@@ -43,4 +43,14 @@ export declare const KAFKA_TOPICS: {
     NEWSFEED_COMMENT_CREATED: string;
     NEWSFEED_COMMENT_UPDATED: string;
     NEWSFEED_COMMENT_DELETED: string;
+    TRACKING_POSITION: string;
+    TRACKING_STATUS: string;
+    TRACKING_PROVIDER_HEALTH: string;
+    TRACKING_DEVICE_UNMAPPED: string;
+    TRACKING_INGESTION_ERROR: string;
+    ORG_RESPONSE_UNIT_CREATED: string;
+    ORG_RESPONSE_UNIT_UPDATED: string;
+    ORG_RESPONSE_UNIT_DELETED: string;
+    ORG_RESPONSE_UNIT_CONTROL_CENTRE_CHANGED: string;
+    ORG_RESPONSE_UNIT_STATUS_CHANGED: string;
 };

package/dist/types/modules/common/constants/service.const.d.ts

@@ -55,4 +55,8 @@ export declare const SERVICE_CONSTS: {
         name: string;
         port: number;
     };
+    RESPONSE_TRACKING_SERVICE: {
+        name: string;
+        port: number;
+    };
 };

package/dist/types/modules/socket/enums/redis-channel-name.enum.d.ts

@@ -3,5 +3,6 @@ export declare enum RedisChannelName {
     WEB_NOTIFICATIONS = "realtime:web-notifications",
     PUSH_NOTIFICATIONS = "realtime:push-notifications",
     TASKS = "realtime:tasks",
-    NEWSFEED = "realtime:newsfeed"
+    NEWSFEED = "realtime:newsfeed",
+    TRACKING = "realtime:tracking"
 }

package/dist/types/modules/socket/enums/socket-event-name.enum.d.ts

@@ -4,5 +4,9 @@ export declare enum SocketEventName {
     PUSH_NOTIFICATION_EVENT = "pushNotification.event",
     TASK_EVENT = "task.event",
     TRIP_EVENT = "trip.event",
-    NEWSFEED_EVENT = "newsfeed.event"
+    NEWSFEED_EVENT = "newsfeed.event",
+    TRACKING_POSITION = "tracking:position",
+    TRACKING_STATUS = "tracking:status",
+    TRACKING_REMOVED = "tracking:removed",
+    TRACKING_PROVIDER_HEALTH = "tracking:provider-health"
 }

package/dist/types/modules/tracking/constants/tracking-kafka.const.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Grouped, typed view of the tracking Kafka topics. The canonical string values
+ * live in {@link KAFKA_TOPICS} (alongside every other domain's topics); this
+ * object references them so there is a single source of truth and no drift.
+ *
+ * Producer:  clarion-response-tracking (connector-worker → POSITION, DEVICE_UNMAPPED,
+ *            PROVIDER_HEALTH, INGESTION_ERROR; projector → STATUS).
+ * Consumers: clarion-response-tracking (projector) for POSITION/STATUS.
+ */
+export declare const TRACKING_KAFKA_TOPICS: {
+    readonly POSITION: string;
+    readonly STATUS: string;
+    readonly PROVIDER_HEALTH: string;
+    readonly DEVICE_UNMAPPED: string;
+    readonly INGESTION_ERROR: string;
+};
+/**
+ * Response-unit lifecycle topics. Producer: clarion-organization. Consumer:
+ * clarion-response-tracking projection. Single source of truth = {@link KAFKA_TOPICS}.
+ */
+export declare const ORG_RESPONSE_UNIT_TOPICS: {
+    readonly CREATED: string;
+    readonly UPDATED: string;
+    readonly DELETED: string;
+    readonly CONTROL_CENTRE_CHANGED: string;
+    readonly STATUS_CHANGED: string;
+};
+/**
+ * Consumer group ids for tracking consumers. Distinct groups keep each concern's
+ * offsets independent and let projector replicas share partitions safely.
+ */
+export declare const TRACKING_CONSUMER_GROUPS: {
+    /** clarion-response-tracking projector: history + current-state + status. */
+    readonly PROJECTOR: "response-tracking-projector-consumer";
+};
+/**
+ * Redis pub/sub channel clarion-response-tracking publishes client-safe tracking
+ * envelopes to, and clarion-socket subscribes to for fan-out. Mirrors the
+ * `realtime:*` channel convention in {@link RedisChannelName}.
+ */
+export declare const TRACKING_REALTIME_CHANNEL = "realtime:tracking";
+/** Current schema version for all Tracking*EventV1 contracts. */
+export declare const TRACKING_SCHEMA_VERSION: 1;