clarion-shared-types 1.0.80 → 1.0.81

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

@@ -24,4 +24,6 @@ __exportStar(require("./interfaces/tracking-provider-connection.dto"), exports);
 __exportStar(require("./interfaces/tracking-device-binding.dto"), exports);
 __exportStar(require("./interfaces/tracking-position.dto"), exports);
 __exportStar(require("./interfaces/tracking-socket-events"), exports);
+__exportStar(require("./interfaces/tracking-operations.dto"), exports);
+__exportStar(require("./interfaces/tracking-playback.dto"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/tracking/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,sEAAoD;AACpD,uEAAqD;AACrD,0EAAwD;AACxD,2EAAyD;AAEzD,oBAAoB;AACpB,gFAA8D;AAC9D,2EAAyD;AACzD,qEAAmD;AACnD,sEAAoD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/tracking/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,sEAAoD;AACpD,uEAAqD;AACrD,0EAAwD;AACxD,2EAAyD;AAEzD,oBAAoB;AACpB,gFAA8D;AAC9D,2EAAyD;AACzD,qEAAmD;AACnD,sEAAoD;AACpD,uEAAqD;AACrD,qEAAmD"}

package/dist/cjs/modules/tracking/interfaces/tracking-operations.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tracking-operations.dto.js.map

package/dist/cjs/modules/tracking/interfaces/tracking-operations.dto.js.map

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

package/dist/cjs/modules/tracking/interfaces/tracking-playback.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tracking-playback.dto.js.map

package/dist/cjs/modules/tracking/interfaces/tracking-playback.dto.js.map

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

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

@@ -8,4 +8,6 @@ export * from './interfaces/tracking-provider-connection.dto';
 export * from './interfaces/tracking-device-binding.dto';
 export * from './interfaces/tracking-position.dto';
 export * from './interfaces/tracking-socket-events';
+export * from './interfaces/tracking-operations.dto';
+export * from './interfaces/tracking-playback.dto';
 //# sourceMappingURL=index.js.map

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

@@ -1 +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;AAEzD,oBAAoB;AACpB,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AACzD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC"}
+{"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;AAEzD,oBAAoB;AACpB,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AACzD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC"}

package/dist/esm/modules/tracking/interfaces/tracking-operations.dto.js

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

package/dist/esm/modules/tracking/interfaces/tracking-operations.dto.js.map

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

package/dist/esm/modules/tracking/interfaces/tracking-playback.dto.js

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

package/dist/esm/modules/tracking/interfaces/tracking-playback.dto.js.map

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

package/dist/types/modules/tracking/index.d.ts

@@ -6,3 +6,5 @@ export * from './interfaces/tracking-provider-connection.dto';
 export * from './interfaces/tracking-device-binding.dto';
 export * from './interfaces/tracking-position.dto';
 export * from './interfaces/tracking-socket-events';
+export * from './interfaces/tracking-operations.dto';
+export * from './interfaces/tracking-playback.dto';

package/dist/types/modules/tracking/interfaces/tracking-operations.dto.d.ts

@@ -0,0 +1,124 @@
+import { TrackingConnectionStatus } from '../enums/tracking-connection-status.enum';
+import { TrackingProviderCode } from '../enums/tracking-provider-code.enum';
+/**
+ * Frontend contracts for the tracking operations dashboard + reconciliation.
+ * Browser-safe: no secrets, no auth frames, no Node-only types. Shapes mirror
+ * clarion-response-tracking's OperationsService / ReconciliationService responses.
+ */
+export interface TrackingConnectionCountsDto {
+    total: number;
+    connected: number;
+    degraded: number;
+    authenticationFailed: number;
+    error: number;
+    disabled: number;
+}
+export interface TrackingUnitCountsDto {
+    mappedUnits: number;
+    unmappedUnits: number;
+    online: number;
+    stale: number;
+    offline: number;
+}
+export interface TrackingIngestionSummaryDto {
+    messagesReceived: number;
+    locationsReceived: number;
+    locationsNormalized: number;
+    locationsRejected: number;
+    duplicates: number;
+    outOfOrder: number;
+    unmappedSeen: number;
+    historyWriteFailures: number;
+    redisUpdateFailures: number;
+    kafkaPublishFailures: number;
+    leaseAcquireFailures: number;
+    leaseOwnershipChanges: number;
+    reconciliationDiscrepancies: number;
+}
+export interface TrackingOperationsSummaryDto {
+    connections: TrackingConnectionCountsDto;
+    units: TrackingUnitCountsDto;
+    ingestion: TrackingIngestionSummaryDto;
+}
+export interface TrackingProviderSummaryDto {
+    id: number;
+    name: string;
+    organizationId: number;
+    controlCentreId: number | null;
+    providerCode: TrackingProviderCode;
+    connectionStatus: TrackingConnectionStatus;
+    enabled: boolean;
+    lastConnectedAt: string | null;
+    lastEventAt: string | null;
+    lastErrorAt: string | null;
+    lastErrorCode: string | null;
+    /** Sanitized upstream — never contains credentials. */
+    lastErrorMessage: string | null;
+    /** Optional counts when the API augments provider rows. */
+    mappedUnits?: number;
+    unmappedUnits?: number;
+    reconnectCount?: number;
+}
+export interface TrackingUnitSummaryDto {
+    total: number;
+    online: number;
+    stale: number;
+    offline: number;
+}
+/**
+ * Per-connection readiness indicators, computed on the frontend from a provider
+ * connection + its health (or a future backend readiness endpoint).
+ */
+export interface TrackingConfigReadinessDto {
+    connectionId: number;
+    endpointConfigured: boolean;
+    secretReferenceConfigured: boolean;
+    normalizationValid: boolean;
+    thresholdsValid: boolean;
+    enabled: boolean;
+    hasSuccessfulConnection: boolean;
+    hasRecentEvent: boolean;
+}
+/** Optional per-connection metrics (future endpoint; shape reserved). */
+export interface TrackingProviderMetricsDto {
+    connectionId: number;
+    connectAttempts?: number;
+    successfulConnections?: number;
+    authenticationFailures?: number;
+    reconnects?: number;
+    lastEventAt?: string | null;
+    locationsReceived?: number;
+    locationsRejected?: number;
+    duplicates?: number;
+    outOfOrder?: number;
+}
+export type ReconciliationDiscrepancyType = 'missing-in-projection' | 'missing-in-source' | 'control-centre-mismatch' | 'invalid-binding';
+export interface ResponseUnitReconciliationDiscrepancyDto {
+    responseUnitId: number;
+    type: ReconciliationDiscrepancyType;
+    detail?: string;
+}
+export interface ResponseUnitReconciliationResultDto {
+    dryRun: boolean;
+    organizationId?: number;
+    scanned: number;
+    created: number;
+    updated: number;
+    moved: number;
+    unchanged: number;
+    orphansDetected: number;
+    orphansMarkedDeleted: number;
+    invalidBindingsSurfaced: number;
+    pages: number;
+    errors: string[];
+    discrepancies?: ResponseUnitReconciliationDiscrepancyDto[];
+}
+export interface ReconcileRequestDto {
+    organizationId?: number;
+}
+export interface UnmappedUnitResolutionDto {
+    resolved: true;
+}
+export interface ReopenUnmappedUnitDto {
+    reopened: true;
+}

package/dist/types/modules/tracking/interfaces/tracking-playback.dto.d.ts

@@ -0,0 +1,46 @@
+import { TrackingProviderCode } from '../enums/tracking-provider-code.enum';
+import { TrackingUnitOnlineStatus } from '../enums/tracking-unit-online-status.enum';
+/**
+ * Frontend playback contracts for tracking history. A "route" is the processed,
+ * client-side representation used by the playback UI — actual provider points
+ * plus detected long gaps. Interpolation is visual-only and NEVER sent back to
+ * the server / Kafka / Socket.IO.
+ */
+export interface TrackingPlaybackPointDto {
+    eventId: string;
+    responseUnitId: number;
+    /** ISO 8601 UTC (actual provider event time — playback is time-driven). */
+    eventTime: string;
+    receivedAt?: string;
+    latitude: number;
+    longitude: number;
+    speedKph?: number | null;
+    /** Degrees clockwise from north, [0,360); null/undefined ⇒ do not rotate. */
+    courseDegrees?: number | null;
+    moving?: boolean | null;
+    accuracyMetres?: number | null;
+    status?: TrackingUnitOnlineStatus;
+    providerCode?: TrackingProviderCode;
+    /** True when the segment leading INTO this point exceeds the gap threshold. */
+    gapBefore?: boolean;
+    /** Seconds since the previous point (undefined for the first point). */
+    secondsSincePrevious?: number;
+}
+export interface TrackingHistoryGapDto {
+    /** Index (in the points array) of the point BEFORE the gap. */
+    fromIndex: number;
+    /** Index of the point AFTER the gap. */
+    toIndex: number;
+    fromEventTime: string;
+    toEventTime: string;
+    gapSeconds: number;
+}
+export interface TrackingPlaybackRouteDto {
+    responseUnitId: number;
+    points: TrackingPlaybackPointDto[];
+    gaps: TrackingHistoryGapDto[];
+    startEventTime: string | null;
+    endEventTime: string | null;
+    /** Total actual points (before any downsampling). */
+    totalPoints: number;
+}

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "clarion-shared-types",
-  "version": "1.0.80",
-  "main": "dist/cjs/index.js",
-  "module": "dist/esm/index.js",
-  "types": "dist/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js"
-    },
-    "./dist/modules/*": {
-      "types": "./dist/types/modules/*.d.ts",
-      "import": "./dist/esm/modules/*.js",
-      "require": "./dist/cjs/modules/*.js"
-    }
-  },
-  "files": [
-    "dist/**/*"
-  ],
-  "scripts": {
-    "clean": "rimraf dist dist-test",
-    "build:cjs": "tsc -p tsconfig.cjs.json",
-    "build:esm": "tsc -p tsconfig.esm.json",
-    "build:types": "tsc -p tsconfig.types.json",
-    "build": "npm run clean && npm run build:types && npm run build:cjs && npm run build:esm",
-    "prepublishOnly": "npm run build",
-    "pretest": "rimraf dist-test",
-    "test": "tsc -p tsconfig.spec.json && node --test \"dist-test/**/*.spec.js\""
-  },
-  "keywords": [],
-  "author": "vince_lawino",
-  "license": "ISC",
-  "description": "",
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@types/geojson": "^7946.0.16",
-    "@types/node": "^20.11.2",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.7.3"
-  }
-}
+{
+  "name": "clarion-shared-types",
+  "version": "1.0.81",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./dist/modules/*": {
+      "types": "./dist/types/modules/*.d.ts",
+      "import": "./dist/esm/modules/*.js",
+      "require": "./dist/cjs/modules/*.js"
+    }
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "clean": "rimraf dist dist-test",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build": "npm run clean && npm run build:types && npm run build:cjs && npm run build:esm",
+    "prepublishOnly": "npm run build",
+    "pretest": "rimraf dist-test",
+    "test": "tsc -p tsconfig.spec.json && node --test \"dist-test/**/*.spec.js\""
+  },
+  "keywords": [],
+  "author": "vince_lawino",
+  "license": "ISC",
+  "description": "",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/geojson": "^7946.0.16",
+    "@types/node": "^20.11.2",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.7.3"
+  }
+}