signalk-wakelogger 0.2.0-beta.0

package/dist/telemetry/profile.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TELEMETRY_PROFILE = void 0;
+exports.parseTelemetryProfile = parseTelemetryProfile;
+exports.legacyProfile = legacyProfile;
+exports.periodFor = periodFor;
+const navRate = { enabled: true, normalMs: 1000, constrainedMs: 1000, offlineMs: 1000 };
+const secondaryRate = { enabled: true, normalMs: 1000, constrainedMs: 5000, offlineMs: 10_000 };
+exports.DEFAULT_TELEMETRY_PROFILE = {
+    v: 1,
+    profileId: 'standard',
+    revision: 1,
+    issuedAt: 0,
+    paths: {
+        position: { ...navRate }, sog: { ...navRate }, cog: { ...navRate }, heading: { ...navRate },
+        depth: { ...secondaryRate }, apparentWind: { ...secondaryRate }
+    },
+    transport: {
+        batchSize: 60,
+        maxPayloadBytes: 64 * 1024,
+        normalBacklogBytesPerSecond: 64 * 1024,
+        constrainedBacklogBytesPerSecond: 8 * 1024
+    }
+};
+function parseTelemetryProfile(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const input = value;
+    if (input.v !== 1 || !validId(input.profileId) || !positiveInteger(input.revision) || !nonNegativeNumber(input.issuedAt))
+        return undefined;
+    if (!input.paths || typeof input.paths !== 'object' || !input.transport || typeof input.transport !== 'object')
+        return undefined;
+    const paths = input.paths;
+    const parsedPaths = {};
+    for (const field of fields()) {
+        const parsed = parsePathRate(paths[field], field === 'position');
+        if (!parsed)
+            return undefined;
+        parsedPaths[field] = parsed;
+    }
+    if (Object.keys(paths).some((key) => !fields().includes(key)))
+        return undefined;
+    const transport = input.transport;
+    if (!integerBetween(transport.batchSize, 1, 120) || !integerBetween(transport.maxPayloadBytes, 8192, 65_536) ||
+        !integerBetween(transport.normalBacklogBytesPerSecond, 1024, 262_144) ||
+        !integerBetween(transport.constrainedBacklogBytesPerSecond, 512, 65_536) ||
+        transport.constrainedBacklogBytesPerSecond > transport.normalBacklogBytesPerSecond)
+        return undefined;
+    return {
+        v: 1, profileId: input.profileId, revision: input.revision, issuedAt: input.issuedAt,
+        paths: parsedPaths,
+        transport: {
+            batchSize: transport.batchSize,
+            maxPayloadBytes: transport.maxPayloadBytes,
+            normalBacklogBytesPerSecond: transport.normalBacklogBytesPerSecond,
+            constrainedBacklogBytesPerSecond: transport.constrainedBacklogBytesPerSecond
+        }
+    };
+}
+function legacyProfile(samplePeriodMs, batchSize) {
+    const period = integerBetween(samplePeriodMs, 250, 60_000) ? samplePeriodMs : 1000;
+    return {
+        ...structuredClone(exports.DEFAULT_TELEMETRY_PROFILE),
+        paths: Object.fromEntries(fields().map((field) => [field, {
+                ...exports.DEFAULT_TELEMETRY_PROFILE.paths[field],
+                normalMs: period,
+                constrainedMs: field === 'depth' || field === 'apparentWind' ? Math.max(period, 5000) : period,
+                offlineMs: field === 'depth' || field === 'apparentWind' ? Math.max(period, 10_000) : period
+            }])),
+        transport: { ...exports.DEFAULT_TELEMETRY_PROFILE.transport, batchSize: integerBetween(batchSize, 1, 60) ? batchSize : 60 }
+    };
+}
+function periodFor(profile, field, mode) {
+    const rate = profile.paths[field];
+    return mode === 'NORMAL' ? rate.normalMs : mode === 'CONSTRAINED' ? rate.constrainedMs : rate.offlineMs;
+}
+function parsePathRate(value, required) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const input = value;
+    if (typeof input.enabled !== 'boolean' || (required && !input.enabled))
+        return undefined;
+    if (!integerBetween(input.normalMs, 250, 600_000) || !integerBetween(input.constrainedMs, 250, 600_000) || !integerBetween(input.offlineMs, 250, 600_000))
+        return undefined;
+    if (!(input.normalMs <= input.constrainedMs && input.constrainedMs <= input.offlineMs))
+        return undefined;
+    return { enabled: input.enabled, normalMs: input.normalMs, constrainedMs: input.constrainedMs, offlineMs: input.offlineMs };
+}
+function fields() { return ['position', 'sog', 'cog', 'heading', 'depth', 'apparentWind']; }
+function validId(value) { return typeof value === 'string' && /^[A-Za-z0-9_-]{1,80}$/.test(value); }
+function positiveInteger(value) { return Number.isSafeInteger(value) && Number(value) > 0; }
+function nonNegativeNumber(value) { return typeof value === 'number' && Number.isFinite(value) && value >= 0; }
+function integerBetween(value, min, max) { return Number.isInteger(value) && Number(value) >= min && Number(value) <= max; }
+//# sourceMappingURL=profile.js.map

package/dist/telemetry/profile.js.map

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

package/dist/telemetry/sampler.d.ts

@@ -0,0 +1,14 @@
+import { type TelemetryProfile } from './profile';
+import type { NetworkMode, TelemetryField } from './types';
+export declare class PathSampler {
+    private profile;
+    private mode;
+    private lastIncluded;
+    constructor(profile: TelemetryProfile, mode?: NetworkMode);
+    updateProfile(profile: TelemetryProfile): void;
+    updateMode(mode: NetworkMode): void;
+    currentMode(): NetworkMode;
+    currentProfile(): TelemetryProfile;
+    samplePeriodMs(): number;
+    dueFields(now: number): Set<TelemetryField>;
+}

package/dist/telemetry/sampler.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathSampler = void 0;
+const profile_1 = require("./profile");
+class PathSampler {
+    profile;
+    mode;
+    lastIncluded = new Map();
+    constructor(profile, mode = 'OFFLINE') {
+        this.profile = profile;
+        this.mode = mode;
+    }
+    updateProfile(profile) {
+        this.profile = profile;
+        this.lastIncluded.clear();
+    }
+    updateMode(mode) {
+        if (this.mode !== mode)
+            this.lastIncluded.clear();
+        this.mode = mode;
+    }
+    currentMode() { return this.mode; }
+    currentProfile() { return this.profile; }
+    samplePeriodMs() {
+        return (0, profile_1.periodFor)(this.profile, 'position', this.mode);
+    }
+    dueFields(now) {
+        const due = new Set(['position']);
+        this.lastIncluded.set('position', now);
+        for (const field of ['sog', 'cog', 'heading', 'depth', 'apparentWind']) {
+            const config = this.profile.paths[field];
+            if (!config.enabled)
+                continue;
+            const last = this.lastIncluded.get(field) ?? Number.NEGATIVE_INFINITY;
+            if (now - last >= (0, profile_1.periodFor)(this.profile, field, this.mode)) {
+                due.add(field);
+                this.lastIncluded.set(field, now);
+            }
+        }
+        return due;
+    }
+}
+exports.PathSampler = PathSampler;
+//# sourceMappingURL=sampler.js.map

package/dist/telemetry/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../../src/telemetry/sampler.ts"],"names":[],"mappings":";;;AAAA,uCAA4D;AAG5D,MAAa,WAAW;IAGF;IAAmC;IAF/C,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAA;IAExD,YAAoB,OAAyB,EAAU,OAAoB,SAAS;QAAhE,YAAO,GAAP,OAAO,CAAkB;QAAU,SAAI,GAAJ,IAAI,CAAyB;IAAG,CAAC;IAExF,aAAa,CAAC,OAAyB;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IAC3B,CAAC;IAED,UAAU,CAAC,IAAiB;QAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;QACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,WAAW,KAAkB,OAAO,IAAI,CAAC,IAAI,CAAA,CAAC,CAAC;IAC/C,cAAc,KAAuB,OAAO,IAAI,CAAC,OAAO,CAAA,CAAC,CAAC;IAE1D,cAAc;QACZ,OAAO,IAAA,mBAAS,EAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;IACvD,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAiB,CAAC,UAAU,CAAC,CAAC,CAAA;QACjD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;QACtC,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAU,EAAE,CAAC;YAChF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YACxC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,SAAQ;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAA;YACrE,IAAI,GAAG,GAAG,IAAI,IAAI,IAAA,mBAAS,EAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5D,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;gBACd,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;CACF;AApCD,kCAoCC"}

package/dist/telemetry/types.d.ts

@@ -0,0 +1,73 @@
+export type HeadingReference = 'true' | 'magnetic';
+export type NetworkMode = 'NORMAL' | 'CONSTRAINED' | 'OFFLINE';
+export type TelemetryField = 'position' | 'sog' | 'cog' | 'heading' | 'depth' | 'apparentWind';
+export interface TelemetryQuality {
+    timestamp: 'source' | 'receipt';
+}
+export interface TelemetryValues {
+    lat: number;
+    lon: number;
+    sog_kn?: number;
+    cog_deg?: number;
+    heading_deg?: number;
+    heading_reference?: HeadingReference;
+    depth_m?: number;
+    aws_kn?: number;
+    awa_deg?: number;
+}
+export interface TripEvidence {
+    event: 'trip_start_candidate' | 'trip_started' | 'trip_stop_candidate' | 'trip_stopped';
+    effectiveAt: number;
+    trackingSessionId?: string;
+    reason: {
+        sogKn?: number;
+        distanceMovedMetres?: number;
+        movementDurationSeconds?: number;
+    };
+}
+export interface TelemetryDraft {
+    capturedAt: number;
+    receivedAt: number;
+    trackingSessionId?: string;
+    values: TelemetryValues;
+    quality: TelemetryQuality;
+    cleared?: Exclude<TelemetryField, 'position'>[];
+    evidence?: TripEvidence;
+}
+export interface TelemetrySample extends TelemetryDraft {
+    v: 1;
+    deviceId: string;
+    sequence: number;
+}
+export interface TelemetryBatch {
+    v: 1;
+    deviceId: string;
+    droppedThrough?: number;
+    samples: TelemetrySample[];
+}
+export interface ApplicationAck {
+    v: 1;
+    deviceId: string;
+    ackSequence: number;
+    acknowledgedAt?: number;
+}
+export interface PluginStatusMetrics {
+    pluginVersion: string;
+    connectionState: string;
+    queueMessageCount: number;
+    queueDiskBytes: number;
+    queueOldestCapturedAt?: number;
+    queueDroppedCount: number;
+    acknowledgedSequence: number;
+    currentSequence: number;
+    trackingState?: string;
+    storageBackend?: 'file' | 'database';
+    networkMode?: NetworkMode;
+    modeReason?: string;
+    profileId?: string;
+    profileRevision?: number;
+    lastAcknowledgedAt?: number;
+    acknowledgementLatencyMs?: number;
+    reconnectCount?: number;
+    publishedBytes?: number;
+}

package/dist/telemetry/types.js

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

package/dist/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":""}

package/dist/transport/adaptive-mode.d.ts

@@ -0,0 +1,23 @@
+import type { NetworkMode } from '../telemetry/types';
+export declare class AdaptiveModeMonitor {
+    private readonly now;
+    private mode;
+    private reason;
+    private reconnects;
+    private slowAcknowledgements;
+    private healthySince?;
+    constructor(now?: () => number);
+    connected(): void;
+    disconnected(reason?: string): void;
+    reconnect(): void;
+    acknowledgement(latencyMs: number): void;
+    failure(reason?: string): void;
+    tick(): void;
+    current(): {
+        mode: NetworkMode;
+        reason: string;
+        reconnectCount: number;
+    };
+    private constrain;
+    private set;
+}

package/dist/transport/adaptive-mode.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptiveModeMonitor = void 0;
+class AdaptiveModeMonitor {
+    now;
+    mode = 'OFFLINE';
+    reason = 'mqtt_disconnected';
+    reconnects = [];
+    slowAcknowledgements = 0;
+    healthySince;
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    connected() {
+        this.healthySince = this.now();
+        if (this.mode === 'OFFLINE')
+            this.set('NORMAL', 'mqtt_connected');
+    }
+    disconnected(reason = 'mqtt_disconnected') {
+        this.healthySince = undefined;
+        this.set('OFFLINE', reason);
+    }
+    reconnect() {
+        const now = this.now();
+        this.reconnects = this.reconnects.filter((at) => now - at <= 5 * 60_000);
+        this.reconnects.push(now);
+        if (this.reconnects.length >= 2)
+            this.constrain('frequent_reconnects');
+    }
+    acknowledgement(latencyMs) {
+        if (latencyMs > 5000)
+            this.slowAcknowledgements += 1;
+        else
+            this.slowAcknowledgements = 0;
+        if (this.slowAcknowledgements >= 3)
+            this.constrain('slow_acknowledgements');
+        if (this.mode === 'CONSTRAINED' && latencyMs < 3000) {
+            this.healthySince ??= this.now();
+        }
+        else if (latencyMs >= 3000)
+            this.healthySince = undefined;
+    }
+    failure(reason = 'publish_failure') { this.constrain(reason); }
+    tick() {
+        if (this.mode === 'CONSTRAINED' && this.healthySince !== undefined && this.now() - this.healthySince >= 120_000) {
+            this.slowAcknowledgements = 0;
+            this.reconnects = [];
+            this.set('NORMAL', 'healthy_transport');
+        }
+    }
+    current() {
+        return { mode: this.mode, reason: this.reason, reconnectCount: this.reconnects.length };
+    }
+    constrain(reason) {
+        if (this.mode === 'OFFLINE')
+            return;
+        this.healthySince = undefined;
+        this.set('CONSTRAINED', reason);
+    }
+    set(mode, reason) { this.mode = mode; this.reason = reason; }
+}
+exports.AdaptiveModeMonitor = AdaptiveModeMonitor;
+//# sourceMappingURL=adaptive-mode.js.map

package/dist/transport/adaptive-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-mode.js","sourceRoot":"","sources":["../../src/transport/adaptive-mode.ts"],"names":[],"mappings":"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"}

package/dist/transport/mqtt-client.d.ts

@@ -0,0 +1,69 @@
+import type { DeviceCredentials } from '../pairing/credentials';
+import { type TelemetryProfile } from '../telemetry/profile';
+import type { NetworkMode, PluginStatusMetrics, TelemetrySample } from '../telemetry/types';
+import type { OutboxStore } from '../outbox/interface';
+export type ConnectionState = 'offline' | 'connecting' | 'online' | 'degraded' | 'authentication_failed';
+interface TransportOptions {
+    profile: TelemetryProfile;
+    onState: (state: ConnectionState, detail?: string) => void;
+    onMode?: (mode: NetworkMode, reason: string) => void;
+    onProfile?: (profile: TelemetryProfile) => Promise<void>;
+    debug?: (message: string) => void;
+    random?: () => number;
+    now?: () => number;
+}
+export declare class WakeLoggerTransport {
+    private readonly credentials;
+    private readonly outbox;
+    private readonly options;
+    private client?;
+    private stopped;
+    private reconnectAttempt;
+    private reconnectTimer?;
+    private pumpTimer?;
+    private healthTimer?;
+    private pumpRunning;
+    private current?;
+    private statePublishInFlight;
+    private statePublishPending;
+    private authenticationFailed;
+    private statusMetrics?;
+    private profile;
+    private readonly monitor;
+    private readonly topics;
+    private inFlight;
+    private nextPublishAfter;
+    private lastLivePublishedAt;
+    private lastLivePublishedSequence;
+    private lastAcknowledgedAt?;
+    private acknowledgementLatencyMs?;
+    private publishedBytes;
+    private lastMode?;
+    private backlogMessageCount;
+    private backlogTokens;
+    private backlogTokenAt?;
+    constructor(credentials: DeviceCredentials, outbox: OutboxStore, options: TransportOptions);
+    start(): void;
+    stop(): Promise<void>;
+    updateCurrent(sample: TelemetrySample): void;
+    updateProfile(profile: TelemetryProfile): void;
+    updateStatus(metrics: PluginStatusMetrics): void;
+    transportMetrics(): Pick<PluginStatusMetrics, 'networkMode' | 'modeReason' | 'lastAcknowledgedAt' | 'acknowledgementLatencyMs' | 'reconnectCount' | 'publishedBytes'>;
+    private connect;
+    private onConnect;
+    private drainCurrentState;
+    private publishLiveSample;
+    private pump;
+    private onMessage;
+    private handleAcknowledgement;
+    private handleProfile;
+    private checkAcknowledgementTimeout;
+    private scheduleReconnect;
+    private syncMode;
+    private effectiveStatusMetrics;
+    private transportFailure;
+    private publish;
+    private now;
+    private refillBacklogBudget;
+}
+export {};