grm-shared-library 1.1.207 → 1.1.208

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

@@ -8,15 +8,18 @@ exports.TrackingProviderCode = void 0;
  * 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.
+ * {@link TrackingProviderCode.TELOX} and {@link TrackingProviderCode.WIALON} have
+ * working adapters. The remaining values are reserved so future adapters can be
+ * added without changing the shared contracts, database columns or Kafka events.
+ *
+ * A value here does NOT mean the provider can be connected — ask the service
+ * (`GET /tracking/providers`, see TrackingProviderDescriptor) which adapters exist.
  */
 var TrackingProviderCode;
 (function (TrackingProviderCode) {
     /** Telox WebSocket platform (G4S Phase 1 integration). */
     TrackingProviderCode["TELOX"] = "TELOX";
-    /** Wialon (reserved — not implemented in Phase 1). */
+    /** Wialon Hosting / Wialon Local, polled over the Remote API. */
     TrackingProviderCode["WIALON"] = "WIALON";
     /** Teltonika direct device ingestion (reserved — not implemented in Phase 1). */
     TrackingProviderCode["TELTONIKA"] = "TELTONIKA";

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

@@ -1 +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,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,oCAApB,oBAAoB,QAW/B"}
+{"version":3,"file":"tracking-provider-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-provider-code.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;GAaG;AACH,IAAY,oBAWX;AAXD,WAAY,oBAAoB;IAC5B,0DAA0D;IAC1D,uCAAe,CAAA;IACf,iEAAiE;IACjE,yCAAiB,CAAA;IACjB,iFAAiF;IACjF,+CAAuB,CAAA;IACvB,4CAA4C;IAC5C,+DAAuC,CAAA;IACvC,+CAA+C;IAC/C,qEAA6C,CAAA;AACjD,CAAC,EAXW,oBAAoB,oCAApB,oBAAoB,QAW/B"}

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

@@ -3,14 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TrackingTransportType = void 0;
 /**
  * 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.
+ * clarion-response-tracking. {@link WEBSOCKET} (Telox) and {@link HTTP_POLLING}
+ * (Wialon) are implemented; the remaining values are reserved for future adapters.
  */
 var TrackingTransportType;
 (function (TrackingTransportType) {
     /** Outbound WebSocket client maintained by the connector worker (Telox). */
     TrackingTransportType["WEBSOCKET"] = "WEBSOCKET";
-    /** Outbound HTTP polling loop. */
+    /** Outbound HTTP polling loop maintained by the connector worker (Wialon). */
     TrackingTransportType["HTTP_POLLING"] = "HTTP_POLLING";
     /** Inbound TCP listener (direct device ingestion). */
     TrackingTransportType["TCP"] = "TCP";

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

@@ -1 +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,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,qCAArB,qBAAqB,QAWhC"}
+{"version":3,"file":"tracking-transport-type.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-transport-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,qBAWX;AAXD,WAAY,qBAAqB;IAC7B,4EAA4E;IAC5E,gDAAuB,CAAA;IACvB,8EAA8E;IAC9E,sDAA6B,CAAA;IAC7B,sDAAsD;IACtD,oCAAW,CAAA;IACX,sDAAsD;IACtD,oCAAW,CAAA;IACX,yBAAyB;IACzB,sCAAa,CAAA;AACjB,CAAC,EAXW,qBAAqB,qCAArB,qBAAqB,QAWhC"}

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

@@ -32,6 +32,8 @@ __exportStar(require("./interfaces/response-unit-lifecycle-events"), exports);
 __exportStar(require("./interfaces/tracking-unit-current-state"), exports);
 __exportStar(require("./interfaces/tracking-socket-payloads"), exports);
 __exportStar(require("./interfaces/tracking-realtime-envelope"), exports);
+// Interfaces — provider catalog (what each adapter needs from an operator)
+__exportStar(require("./interfaces/tracking-provider-descriptor"), exports);
 // Constants
 __exportStar(require("./constants/tracking-kafka.const"), exports);
 // Utilities

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;AACzD,sEAAoD;AAEpD,+CAA+C;AAC/C,+EAA6D;AAC7D,+EAA6D;AAC7D,6EAA2D;AAC3D,iFAA+D;AAC/D,iFAA+D;AAC/D,iFAA+D;AAC/D,8EAA4D;AAE5D,+CAA+C;AAC/C,2EAAyD;AACzD,wEAAsD;AACtD,0EAAwD;AAExD,YAAY;AACZ,mEAAiD;AAEjD,YAAY;AACZ,iEAA+C;AAC/C,mEAAiD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/tracking/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,sEAAoD;AACpD,uEAAqD;AACrD,0EAAwD;AACxD,2EAAyD;AACzD,sEAAoD;AAEpD,+CAA+C;AAC/C,+EAA6D;AAC7D,+EAA6D;AAC7D,6EAA2D;AAC3D,iFAA+D;AAC/D,iFAA+D;AAC/D,iFAA+D;AAC/D,8EAA4D;AAE5D,+CAA+C;AAC/C,2EAAyD;AACzD,wEAAsD;AACtD,0EAAwD;AAExD,2EAA2E;AAC3E,4EAA0D;AAE1D,YAAY;AACZ,mEAAiD;AAEjD,YAAY;AACZ,iEAA+C;AAC/C,mEAAiD"}

package/dist/cjs/modules/tracking/interfaces/tracking-provider-descriptor.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDefaultTrackingProviderConfiguration = buildDefaultTrackingProviderConfiguration;
+exports.validateTrackingProviderSettings = validateTrackingProviderSettings;
+/**
+ * The `configuration` a connection gets when the operator supplies none: every
+ * setting at its default. Stored explicitly on the connection so that readers
+ * which know nothing about adapters (the status evaluator, ingestion guards) see
+ * the provider's thresholds rather than the service-wide fallbacks.
+ */
+function buildDefaultTrackingProviderConfiguration(descriptor) {
+    const configuration = {};
+    for (const setting of descriptor.settings) {
+        configuration[setting.key] = setting.defaultValue;
+    }
+    return configuration;
+}
+function isBlank(value) {
+    return value === undefined || value === null || value === '';
+}
+/**
+ * Validate a raw `configuration` blob against a provider's setting descriptors.
+ * Returns human-readable errors (empty ⇒ valid). Absent keys are valid — they
+ * take their default. Keys the descriptor does not know are ignored, not
+ * rejected: a connection saved before a setting was retired must stay editable.
+ *
+ * Cross-field rules (e.g. "offline must not precede stale") are the adapter's.
+ */
+function validateTrackingProviderSettings(settings, configuration) {
+    var _a;
+    const errors = [];
+    const config = configuration !== null && configuration !== void 0 ? configuration : {};
+    for (const setting of settings) {
+        const raw = config[setting.key];
+        if (isBlank(raw))
+            continue;
+        switch (setting.type) {
+            case 'number': {
+                const value = typeof raw === 'string' ? Number(raw) : raw;
+                if (typeof value !== 'number' || !Number.isFinite(value)) {
+                    errors.push(`${setting.key} must be a finite number`);
+                    break;
+                }
+                if (setting.integer && !Number.isInteger(value)) {
+                    errors.push(`${setting.key} must be a whole number`);
+                }
+                if (setting.min !== undefined && value < setting.min) {
+                    errors.push(`${setting.key} must be at least ${setting.min}`);
+                }
+                if (setting.max !== undefined && value > setting.max) {
+                    errors.push(`${setting.key} must be at most ${setting.max}`);
+                }
+                break;
+            }
+            case 'boolean':
+                if (typeof raw !== 'boolean' && raw !== 'true' && raw !== 'false') {
+                    errors.push(`${setting.key} must be a boolean`);
+                }
+                break;
+            case 'select': {
+                const allowed = ((_a = setting.options) !== null && _a !== void 0 ? _a : []).map((option) => option.value);
+                if (!allowed.includes(String(raw))) {
+                    errors.push(`${setting.key} must be one of ${allowed.join(', ')}`);
+                }
+                break;
+            }
+            case 'text':
+                if (typeof raw !== 'string') {
+                    errors.push(`${setting.key} must be text`);
+                }
+                else if (setting.maxLength !== undefined && raw.length > setting.maxLength) {
+                    errors.push(`${setting.key} must be at most ${setting.maxLength} characters`);
+                }
+                break;
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=tracking-provider-descriptor.js.map

package/dist/cjs/modules/tracking/interfaces/tracking-provider-descriptor.js.map

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

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

@@ -5,15 +5,18 @@
  * 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.
+ * {@link TrackingProviderCode.TELOX} and {@link TrackingProviderCode.WIALON} have
+ * working adapters. The remaining values are reserved so future adapters can be
+ * added without changing the shared contracts, database columns or Kafka events.
+ *
+ * A value here does NOT mean the provider can be connected — ask the service
+ * (`GET /tracking/providers`, see TrackingProviderDescriptor) which adapters exist.
  */
 export var TrackingProviderCode;
 (function (TrackingProviderCode) {
     /** Telox WebSocket platform (G4S Phase 1 integration). */
     TrackingProviderCode["TELOX"] = "TELOX";
-    /** Wialon (reserved — not implemented in Phase 1). */
+    /** Wialon Hosting / Wialon Local, polled over the Remote API. */
     TrackingProviderCode["WIALON"] = "WIALON";
     /** Teltonika direct device ingestion (reserved — not implemented in Phase 1). */
     TrackingProviderCode["TELTONIKA"] = "TELTONIKA";

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

@@ -1 +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"}
+{"version":3,"file":"tracking-provider-code.enum.js","sourceRoot":"","sources":["../../../../../src/modules/tracking/enums/tracking-provider-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,oBAWX;AAXD,WAAY,oBAAoB;IAC5B,0DAA0D;IAC1D,uCAAe,CAAA;IACf,iEAAiE;IACjE,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

@@ -1,13 +1,13 @@
 /**
  * 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.
+ * clarion-response-tracking. {@link WEBSOCKET} (Telox) and {@link HTTP_POLLING}
+ * (Wialon) are implemented; 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. */
+    /** Outbound HTTP polling loop maintained by the connector worker (Wialon). */
     TrackingTransportType["HTTP_POLLING"] = "HTTP_POLLING";
     /** Inbound TCP listener (direct device ingestion). */
     TrackingTransportType["TCP"] = "TCP";

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

@@ -1 +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"}
+{"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,8EAA8E;IAC9E,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/index.js

@@ -16,6 +16,8 @@ export * from './interfaces/response-unit-lifecycle-events';
 export * from './interfaces/tracking-unit-current-state';
 export * from './interfaces/tracking-socket-payloads';
 export * from './interfaces/tracking-realtime-envelope';
+// Interfaces — provider catalog (what each adapter needs from an operator)
+export * from './interfaces/tracking-provider-descriptor';
 // Constants
 export * from './constants/tracking-kafka.const';
 // Utilities

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;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"}
+{"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,2EAA2E;AAC3E,cAAc,2CAA2C,CAAC;AAE1D,YAAY;AACZ,cAAc,kCAAkC,CAAC;AAEjD,YAAY;AACZ,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC"}

package/dist/esm/modules/tracking/interfaces/tracking-provider-descriptor.js

@@ -0,0 +1,75 @@
+/**
+ * The `configuration` a connection gets when the operator supplies none: every
+ * setting at its default. Stored explicitly on the connection so that readers
+ * which know nothing about adapters (the status evaluator, ingestion guards) see
+ * the provider's thresholds rather than the service-wide fallbacks.
+ */
+export function buildDefaultTrackingProviderConfiguration(descriptor) {
+    const configuration = {};
+    for (const setting of descriptor.settings) {
+        configuration[setting.key] = setting.defaultValue;
+    }
+    return configuration;
+}
+function isBlank(value) {
+    return value === undefined || value === null || value === '';
+}
+/**
+ * Validate a raw `configuration` blob against a provider's setting descriptors.
+ * Returns human-readable errors (empty ⇒ valid). Absent keys are valid — they
+ * take their default. Keys the descriptor does not know are ignored, not
+ * rejected: a connection saved before a setting was retired must stay editable.
+ *
+ * Cross-field rules (e.g. "offline must not precede stale") are the adapter's.
+ */
+export function validateTrackingProviderSettings(settings, configuration) {
+    var _a;
+    const errors = [];
+    const config = configuration !== null && configuration !== void 0 ? configuration : {};
+    for (const setting of settings) {
+        const raw = config[setting.key];
+        if (isBlank(raw))
+            continue;
+        switch (setting.type) {
+            case 'number': {
+                const value = typeof raw === 'string' ? Number(raw) : raw;
+                if (typeof value !== 'number' || !Number.isFinite(value)) {
+                    errors.push(`${setting.key} must be a finite number`);
+                    break;
+                }
+                if (setting.integer && !Number.isInteger(value)) {
+                    errors.push(`${setting.key} must be a whole number`);
+                }
+                if (setting.min !== undefined && value < setting.min) {
+                    errors.push(`${setting.key} must be at least ${setting.min}`);
+                }
+                if (setting.max !== undefined && value > setting.max) {
+                    errors.push(`${setting.key} must be at most ${setting.max}`);
+                }
+                break;
+            }
+            case 'boolean':
+                if (typeof raw !== 'boolean' && raw !== 'true' && raw !== 'false') {
+                    errors.push(`${setting.key} must be a boolean`);
+                }
+                break;
+            case 'select': {
+                const allowed = ((_a = setting.options) !== null && _a !== void 0 ? _a : []).map((option) => option.value);
+                if (!allowed.includes(String(raw))) {
+                    errors.push(`${setting.key} must be one of ${allowed.join(', ')}`);
+                }
+                break;
+            }
+            case 'text':
+                if (typeof raw !== 'string') {
+                    errors.push(`${setting.key} must be text`);
+                }
+                else if (setting.maxLength !== undefined && raw.length > setting.maxLength) {
+                    errors.push(`${setting.key} must be at most ${setting.maxLength} characters`);
+                }
+                break;
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=tracking-provider-descriptor.js.map

package/dist/esm/modules/tracking/interfaces/tracking-provider-descriptor.js.map

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

package/dist/types/modules/tracking/enums/tracking-provider-code.enum.d.ts

@@ -5,14 +5,17 @@
  * 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.
+ * {@link TrackingProviderCode.TELOX} and {@link TrackingProviderCode.WIALON} have
+ * working adapters. The remaining values are reserved so future adapters can be
+ * added without changing the shared contracts, database columns or Kafka events.
+ *
+ * A value here does NOT mean the provider can be connected — ask the service
+ * (`GET /tracking/providers`, see TrackingProviderDescriptor) which adapters exist.
  */
 export declare enum TrackingProviderCode {
     /** Telox WebSocket platform (G4S Phase 1 integration). */
     TELOX = "TELOX",
-    /** Wialon (reserved — not implemented in Phase 1). */
+    /** Wialon Hosting / Wialon Local, polled over the Remote API. */
     WIALON = "WIALON",
     /** Teltonika direct device ingestion (reserved — not implemented in Phase 1). */
     TELTONIKA = "TELTONIKA",

package/dist/types/modules/tracking/enums/tracking-transport-type.enum.d.ts

@@ -1,12 +1,12 @@
 /**
  * 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.
+ * clarion-response-tracking. {@link WEBSOCKET} (Telox) and {@link HTTP_POLLING}
+ * (Wialon) are implemented; the remaining values are reserved for future adapters.
  */
 export declare enum TrackingTransportType {
     /** Outbound WebSocket client maintained by the connector worker (Telox). */
     WEBSOCKET = "WEBSOCKET",
-    /** Outbound HTTP polling loop. */
+    /** Outbound HTTP polling loop maintained by the connector worker (Wialon). */
     HTTP_POLLING = "HTTP_POLLING",
     /** Inbound TCP listener (direct device ingestion). */
     TCP = "TCP",

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

@@ -13,6 +13,7 @@ export * from './interfaces/response-unit-lifecycle-events';
 export * from './interfaces/tracking-unit-current-state';
 export * from './interfaces/tracking-socket-payloads';
 export * from './interfaces/tracking-realtime-envelope';
+export * from './interfaces/tracking-provider-descriptor';
 export * from './constants/tracking-kafka.const';
 export * from './utils/tracking-event-id.util';
 export * from './utils/tracking-validation.util';

package/dist/types/modules/tracking/interfaces/tracking-provider-descriptor.d.ts

@@ -0,0 +1,117 @@
+import { TrackingProviderCode } from '../enums/tracking-provider-code.enum';
+import { TrackingTransportType } from '../enums/tracking-transport-type.enum';
+/**
+ * Self-description of a tracking provider, published by clarion-response-tracking
+ * (`GET /tracking/providers`) and rendered by the admin client.
+ *
+ * Why it exists: every provider needs different things from an operator. Telox
+ * wants a WebSocket URL, a username, a domain and a password; Wialon wants an
+ * HTTPS host and an API token and has no domain at all; and each scales its raw
+ * telemetry differently. Encoding that in the client meant a form that only fit
+ * one provider and defaults that had to be kept in step with the service by hand.
+ * With a descriptor the service that owns the adapter is the single source of
+ * truth: adding a provider changes no client code, and a default can never drift.
+ *
+ * Only providers with a registered adapter are described, so the catalog also
+ * answers "which providers can I actually connect?" — the enum alone cannot,
+ * because it reserves codes for adapters that do not exist yet.
+ *
+ * SECURITY: a descriptor is static metadata. It never carries a secret, a secret
+ * reference, or anything tenant-specific.
+ */
+export type TrackingProviderSettingType = 'number' | 'boolean' | 'select' | 'text';
+export interface TrackingProviderSettingOption {
+    value: string;
+    label: string;
+}
+/** One key of a provider connection's `configuration` blob. */
+export interface TrackingProviderSettingDescriptor {
+    /** The `configuration` key this setting is stored under. */
+    key: string;
+    label: string;
+    type: TrackingProviderSettingType;
+    /** Key of the {@link TrackingProviderSettingGroupDescriptor} it is shown under. */
+    group: string;
+    /** Applied by the service when the key is absent, and pre-filled by the client. */
+    defaultValue: number | boolean | string;
+    description?: string;
+    /** Display unit, e.g. `s`, `m`, `km/h`. */
+    unit?: string;
+    /** `number` settings only. Bounds are inclusive and enforced by the service. */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** `number` settings only: reject fractional values. */
+    integer?: boolean;
+    /** `text` settings only. */
+    maxLength?: number;
+    /** `select` settings only: the closed set of accepted values. */
+    options?: TrackingProviderSettingOption[];
+}
+export interface TrackingProviderSettingGroupDescriptor {
+    key: string;
+    label: string;
+    description?: string;
+}
+/** An optional connection field whose meaning (or existence) depends on the provider. */
+export interface TrackingProviderFieldDescriptor {
+    /** false ⇒ the provider has no such concept: hide the field and send nothing. */
+    used: boolean;
+    required: boolean;
+    label: string;
+    placeholder?: string;
+    description?: string;
+}
+export interface TrackingProviderEndpointDescriptor {
+    label: string;
+    placeholder: string;
+    description?: string;
+    /** Pre-filled for providers with one well-known public endpoint. */
+    defaultValue?: string;
+    /** Accepted URL schemes, with the trailing colon: `wss:`, `https:`… */
+    protocols: string[];
+}
+/** What the referenced secret must contain. Describes the secret; never holds it. */
+export interface TrackingProviderSecretDescriptor {
+    label: string;
+    description: string;
+    placeholder?: string;
+}
+/** How the provider identifies a unit — what an operator binds to a response unit. */
+export interface TrackingProviderExternalUnitDescriptor {
+    label: string;
+    description: string;
+    placeholder?: string;
+}
+export interface TrackingProviderDescriptor {
+    providerCode: TrackingProviderCode;
+    displayName: string;
+    description: string;
+    /** Supported transports; the first is the default. */
+    transportTypes: TrackingTransportType[];
+    endpoint: TrackingProviderEndpointDescriptor;
+    externalUsername: TrackingProviderFieldDescriptor;
+    externalDomain: TrackingProviderFieldDescriptor;
+    secret: TrackingProviderSecretDescriptor;
+    externalUnitId: TrackingProviderExternalUnitDescriptor;
+    /** Display order of the setting groups. */
+    settingGroups: TrackingProviderSettingGroupDescriptor[];
+    settings: TrackingProviderSettingDescriptor[];
+    documentationUrl?: string;
+}
+/**
+ * The `configuration` a connection gets when the operator supplies none: every
+ * setting at its default. Stored explicitly on the connection so that readers
+ * which know nothing about adapters (the status evaluator, ingestion guards) see
+ * the provider's thresholds rather than the service-wide fallbacks.
+ */
+export declare function buildDefaultTrackingProviderConfiguration(descriptor: Pick<TrackingProviderDescriptor, 'settings'>): Record<string, number | boolean | string>;
+/**
+ * Validate a raw `configuration` blob against a provider's setting descriptors.
+ * Returns human-readable errors (empty ⇒ valid). Absent keys are valid — they
+ * take their default. Keys the descriptor does not know are ignored, not
+ * rejected: a connection saved before a setting was retired must stay editable.
+ *
+ * Cross-field rules (e.g. "offline must not precede stale") are the adapter's.
+ */
+export declare function validateTrackingProviderSettings(settings: readonly TrackingProviderSettingDescriptor[], configuration: Record<string, unknown> | null | undefined): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grm-shared-library",
-  "version": "1.1.207",
+  "version": "1.1.208",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",