signalk-wakelogger 0.2.0-beta.0

package/dist/index.js

@@ -0,0 +1,338 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const schema_1 = require("./config/schema");
+const defaults_1 = require("./config/defaults");
+const factory_1 = require("./outbox/factory");
+const association_client_1 = require("./pairing/association-client");
+const credentials_1 = require("./pairing/credentials");
+const pairing_client_1 = require("./pairing/pairing-client");
+const normaliser_1 = require("./signalk/normaliser");
+const subscriber_1 = require("./signalk/subscriber");
+const profile_1 = require("./telemetry/profile");
+const profile_store_1 = require("./telemetry/profile-store");
+const sampler_1 = require("./telemetry/sampler");
+const mqtt_client_1 = require("./transport/mqtt-client");
+const state_machine_1 = require("./trips/state-machine");
+const constructor = (app) => {
+    const pluginVersion = '0.2.0-beta.0';
+    let generation = 0;
+    let stopSubscription;
+    let sampleTimer;
+    let statusTimer;
+    let outbox;
+    let transport;
+    let tripState;
+    let connectionState = 'unpaired';
+    let activeProfile;
+    let storageBackend = 'file';
+    let initialization;
+    let pairingAbortController;
+    let associationAbortController;
+    let associationCheck;
+    const plugin = {
+        id: 'signalk-wakelogger',
+        name: 'Wake Logger',
+        description: 'Secure, resilient live vessel telemetry for Wake Logger',
+        schema: schema_1.configSchema,
+        start(configuration) {
+            const previous = initialization;
+            const thisGeneration = ++generation;
+            initialization = (async () => {
+                await previous?.catch(() => undefined);
+                await cleanupResources();
+                if (thisGeneration === generation)
+                    await initialise((0, defaults_1.parseConfig)(configuration), thisGeneration);
+            })().catch((error) => {
+                if (thisGeneration !== generation)
+                    return;
+                const message = safeError(error);
+                app.setPluginError(`Wake Logger initialization failed: ${message}`);
+                app.error(`Wake Logger initialization failed: ${message}`);
+            });
+        },
+        async stop() {
+            const running = initialization;
+            generation += 1;
+            pairingAbortController?.abort();
+            associationAbortController?.abort();
+            await running?.catch(() => undefined);
+            await cleanupResources();
+            initialization = undefined;
+            app.setPluginStatus('Wake Logger: Stopped');
+        },
+        registerWithRouter(router) {
+            // Signal K protects routes registered directly on the plugin router with
+            // administrator authentication. Do not downgrade this action via access().
+            const adminRouter = router;
+            adminRouter.post('/forget-credentials', async (_request, response, next) => {
+                try {
+                    generation += 1;
+                    pairingAbortController?.abort();
+                    associationAbortController?.abort();
+                    await initialization?.catch(() => undefined);
+                    await cleanupResources();
+                    const store = new credentials_1.CredentialStore(node_path_1.default.join(app.getDataDirPath(), 'identity'));
+                    const result = await store.forget();
+                    initialization = undefined;
+                    connectionState = 'unpaired';
+                    app.setPluginStatus('Wake Logger: Not paired — credentials forgotten; retired outboxes preserved');
+                    response.status(200).json({
+                        forgotten: result.forgotten,
+                        retiredDeviceId: result.deviceId,
+                        outboxesPreserved: true,
+                        next: 'Enter and save a fresh Wake Logger pairing code.'
+                    });
+                }
+                catch (error) {
+                    next(error);
+                }
+            });
+        },
+        getOpenApi: () => ({
+            openapi: '3.0.3',
+            info: { title: 'Wake Logger Signal K plugin', version: pluginVersion },
+            paths: {
+                '/forget-credentials': {
+                    post: {
+                        summary: 'Forget Wake Logger credentials while preserving all device outboxes',
+                        responses: { '200': { description: 'Credentials forgotten or already absent' } }
+                    }
+                }
+            }
+        })
+    };
+    async function cleanupResources() {
+        stopSubscription?.();
+        stopSubscription = undefined;
+        if (sampleTimer)
+            clearTimeout(sampleTimer);
+        if (statusTimer)
+            clearInterval(statusTimer);
+        sampleTimer = undefined;
+        statusTimer = undefined;
+        await transport?.stop();
+        transport = undefined;
+        await outbox?.close();
+        outbox = undefined;
+        tripState = undefined;
+        pairingAbortController = undefined;
+        associationAbortController = undefined;
+        associationCheck = undefined;
+    }
+    async function initialise(config, thisGeneration) {
+        const dataDirectory = app.getDataDirPath();
+        const credentialStore = new credentials_1.CredentialStore(node_path_1.default.join(dataDirectory, 'identity'));
+        let credentials = await credentialStore.load();
+        const lastPairingCodeFingerprint = await credentialStore.lastPairingCodeFingerprint();
+        if ((0, credentials_1.shouldExchangePairingCode)(credentials, config.pairingCode, lastPairingCodeFingerprint)) {
+            const controller = new AbortController();
+            pairingAbortController = controller;
+            try {
+                const replacement = await (0, pairing_client_1.pairDeviceWithRetry)(config.pairingApiUrl, config.pairingCode, await credentialStore.installationId(), {
+                    signal: controller.signal,
+                    onAttempt: (attempt, maximum) => {
+                        if (generation === thisGeneration)
+                            app.setPluginStatus(`Wake Logger: Pairing attempt ${attempt}/${maximum}`);
+                    },
+                    onRetry: (attempt, maximum, delayMs) => {
+                        if (generation === thisGeneration)
+                            app.setPluginStatus(`Wake Logger: Retry pairing ${attempt}/${maximum} in ${Math.ceil(delayMs / 1000)} seconds`);
+                    }
+                });
+                if (generation !== thisGeneration)
+                    return;
+                replacement.pairingCodeFingerprint = (0, credentials_1.fingerprintPairingCode)(config.pairingCode);
+                await credentialStore.save(replacement);
+                credentials = replacement;
+            }
+            catch (error) {
+                if (generation !== thisGeneration || controller.signal.aborted)
+                    return;
+                if (!credentials) {
+                    connectionState = 'unpaired';
+                    const expired = error instanceof pairing_client_1.PairingError && error.status === 400;
+                    const retryExhausted = error instanceof pairing_client_1.PairingError && error.retryable;
+                    app.setPluginStatus(expired
+                        ? 'Wake Logger: Pairing code invalid or expired — enter a new pairing code'
+                        : retryExhausted
+                            ? 'Wake Logger: Retry pairing stopped after 6 attempts — save configuration to retry or enter a new code'
+                            : `Wake Logger: Pairing rejected — ${safeError(error)}; enter a new pairing code`);
+                    return;
+                }
+                app.error(`Wake Logger replacement pairing failed; continuing with the existing device: ${safeError(error)}`);
+            }
+            finally {
+                if (pairingAbortController === controller)
+                    pairingAbortController = undefined;
+            }
+        }
+        if (!credentials) {
+            connectionState = 'unpaired';
+            app.setPluginStatus('Wake Logger: Not paired');
+            return;
+        }
+        if (generation !== thisGeneration)
+            return;
+        await startTelemetry(config, credentials, credentialStore, dataDirectory, thisGeneration);
+    }
+    async function startTelemetry(config, credentials, credentialStore, dataDirectory, thisGeneration) {
+        const normaliser = new normaliser_1.TelemetryNormaliser();
+        const tripFile = node_path_1.default.join(dataDirectory, 'trip-state.json');
+        const trip = new state_machine_1.TripStateMachine(await readTripSnapshot(tripFile));
+        tripState = trip;
+        let tripSnapshotJson = JSON.stringify(trip.currentState());
+        // Each provisioned device owns an independent sequence space. A replacement
+        // device must never replay the retired device's records under new credentials.
+        const profileStore = new profile_store_1.TelemetryProfileStore(node_path_1.default.join(dataDirectory, 'profiles', credentials.deviceId));
+        const credentialProfile = (0, profile_1.parseTelemetryProfile)(credentials.telemetryProfile);
+        const legacy = credentials.telemetryProfile;
+        const profile = await profileStore.load() ?? credentialProfile ?? (0, profile_1.legacyProfile)(legacy?.sample_period_ms ?? config.samplePeriodMs, legacy?.batch_size);
+        activeProfile = profile;
+        const sampler = new sampler_1.PathSampler(profile);
+        const selected = await (0, factory_1.createOutbox)(app, dataDirectory, credentials.deviceId, {
+            maxBytes: config.maxOutboxMb * 1024 * 1024,
+            maxAgeMs: config.maxOutboxDays * 24 * 60 * 60 * 1000,
+            segmentBytes: defaults_1.DEFAULTS.segmentBytes
+        }, credentials.outboxBinding?.backend);
+        outbox = selected.store;
+        storageBackend = selected.backend;
+        if (!credentials.outboxBinding) {
+            credentials.outboxBinding = { version: 1, backend: selected.backend, initializedAt: Date.now() };
+            await credentialStore.save(credentials);
+        }
+        if (generation !== thisGeneration)
+            return;
+        transport = new mqtt_client_1.WakeLoggerTransport(credentials, outbox, {
+            profile,
+            onState: (state, detail) => {
+                if (connectionState === 'device_revoked')
+                    return;
+                connectionState = state;
+                void updateStatus(detail);
+                if (state === 'authentication_failed')
+                    void confirmAssociation(credentials, thisGeneration);
+            },
+            onMode: (mode) => sampler.updateMode(mode),
+            onProfile: async (replacement) => {
+                await profileStore.save(replacement);
+                activeProfile = replacement;
+                sampler.updateProfile(replacement);
+            },
+            debug: config.debugTelemetry ? (message) => app.debug(message) : undefined
+        });
+        stopSubscription = (0, subscriber_1.subscribeToTelemetry)(app, (delta) => normaliser.ingest(delta));
+        const sample = () => {
+            const now = Date.now();
+            const draft = normaliser.takeSample(now, sampler.dueFields(now));
+            if (!draft || !outbox || !transport)
+                return;
+            const evidence = trip.process(draft);
+            draft.trackingSessionId = evidence?.trackingSessionId ?? trip.trackingSessionId();
+            if (evidence)
+                draft.evidence = evidence;
+            const nextSnapshotJson = JSON.stringify(trip.currentState());
+            if (nextSnapshotJson !== tripSnapshotJson) {
+                tripSnapshotJson = nextSnapshotJson;
+                void atomicWrite(tripFile, `${tripSnapshotJson}\n`).catch((error) => app.error(`Unable to persist Wake Logger trip state: ${safeError(error)}`));
+            }
+            void outbox.append(credentials.deviceId, draft).then((sample) => {
+                transport?.updateCurrent(sample);
+                if (config.debugTelemetry)
+                    app.debug(`Queued Wake Logger sequence ${sample.sequence}`);
+            }).catch((error) => app.error(`Unable to queue Wake Logger telemetry: ${safeError(error)}`));
+        };
+        const scheduleSample = () => {
+            if (generation !== thisGeneration)
+                return;
+            sampleTimer = setTimeout(() => {
+                sample();
+                scheduleSample();
+            }, sampler.samplePeriodMs());
+        };
+        scheduleSample();
+        statusTimer = setInterval(() => void updateStatus(), 10_000);
+        transport.start();
+        await updateStatus();
+    }
+    async function updateStatus(detail) {
+        if (connectionState === 'unpaired' || !outbox) {
+            app.setPluginStatus('Wake Logger: Not paired');
+            return;
+        }
+        const stats = await outbox.stats();
+        const queue = `${stats.messageCount} queued, ${(stats.diskBytes / 1024 / 1024).toFixed(1)} MB`;
+        const dropped = stats.droppedCount ? `, ${stats.droppedCount} dropped` : '';
+        const sequence = `, seq ${stats.acknowledgedSequence}/${stats.currentSequence}`;
+        const trip = tripState ? `, trip ${tripState.currentState().state}` : '';
+        const extra = detail ? ` — ${detail}` : '';
+        transport?.updateStatus({
+            pluginVersion,
+            connectionState,
+            queueMessageCount: stats.messageCount,
+            queueDiskBytes: stats.diskBytes,
+            queueOldestCapturedAt: stats.oldestCapturedAt,
+            queueDroppedCount: stats.droppedCount,
+            acknowledgedSequence: stats.acknowledgedSequence,
+            currentSequence: stats.currentSequence,
+            trackingState: tripState?.currentState().state,
+            storageBackend,
+            profileId: activeProfile?.profileId,
+            profileRevision: activeProfile?.revision,
+            ...transport?.transportMetrics()
+        });
+        if (connectionState === 'device_revoked') {
+            app.setPluginStatus(`Wake Logger: Device revoked — enter a new pairing code; ${queue}${dropped}${sequence}`);
+            return;
+        }
+        app.setPluginStatus(`Wake Logger: ${connectionState} — ${queue}${dropped}${sequence}${trip}${extra}`);
+    }
+    function confirmAssociation(credentials, thisGeneration) {
+        if (associationCheck)
+            return associationCheck;
+        const controller = new AbortController();
+        associationAbortController = controller;
+        associationCheck = (async () => {
+            const status = await (0, association_client_1.checkAssociationStatus)(credentials, controller.signal);
+            if (status !== 'revoked' || generation !== thisGeneration || controller.signal.aborted)
+                return;
+            connectionState = 'device_revoked';
+            stopSubscription?.();
+            stopSubscription = undefined;
+            if (sampleTimer)
+                clearTimeout(sampleTimer);
+            sampleTimer = undefined;
+            await transport?.stop();
+            await updateStatus();
+        })().finally(() => {
+            if (associationAbortController === controller)
+                associationAbortController = undefined;
+            associationCheck = undefined;
+        });
+        return associationCheck;
+    }
+    return plugin;
+};
+async function readTripSnapshot(target) {
+    try {
+        return JSON.parse(await node_fs_1.promises.readFile(target, 'utf8'));
+    }
+    catch (error) {
+        if (error?.code === 'ENOENT' || error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+}
+async function atomicWrite(target, contents) {
+    const temporary = `${target}.tmp`;
+    await node_fs_1.promises.writeFile(temporary, contents, { mode: 0o600 });
+    await node_fs_1.promises.rename(temporary, target);
+}
+function safeError(error) {
+    return (error instanceof Error ? error.message : String(error)).replace(/(password|token|secret)=\S+/gi, '$1=[redacted]').slice(0, 500);
+}
+module.exports = constructor;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AACA,qCAAwC;AACxC,0DAA4B;AAC5B,4CAA8C;AAC9C,gDAA4E;AAC5E,8CAA+C;AAE/C,qEAAqE;AACrE,uDAAkI;AAClI,6DAA4E;AAC5E,qDAA0D;AAC1D,qDAA2D;AAC3D,iDAAiG;AACjG,6DAAiE;AACjE,iDAAiD;AACjD,yDAAmF;AACnF,yDAA2E;AAE3E,MAAM,WAAW,GAAsB,CAAC,GAAc,EAAU,EAAE;IAChE,MAAM,aAAa,GAAG,cAAc,CAAA;IACpC,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,gBAA0C,CAAA;IAC9C,IAAI,WAAuC,CAAA;IAC3C,IAAI,WAAuC,CAAA;IAC3C,IAAI,MAA+B,CAAA;IACnC,IAAI,SAA0C,CAAA;IAC9C,IAAI,SAAuC,CAAA;IAC3C,IAAI,eAAe,GAAoD,UAAU,CAAA;IACjF,IAAI,aAA2C,CAAA;IAC/C,IAAI,cAAc,GAAwB,MAAM,CAAA;IAChD,IAAI,cAAyC,CAAA;IAC7C,IAAI,sBAAmD,CAAA;IACvD,IAAI,0BAAuD,CAAA;IAC3D,IAAI,gBAA2C,CAAA;IAE/C,MAAM,MAAM,GAAW;QACrB,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,yDAAyD;QACtE,MAAM,EAAE,qBAAY;QACpB,KAAK,CAAC,aAAqB;YACzB,MAAM,QAAQ,GAAG,cAAc,CAAA;YAC/B,MAAM,cAAc,GAAG,EAAE,UAAU,CAAA;YACnC,cAAc,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC3B,MAAM,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;gBACtC,MAAM,gBAAgB,EAAE,CAAA;gBACxB,IAAI,cAAc,KAAK,UAAU;oBAAE,MAAM,UAAU,CAAC,IAAA,sBAAW,EAAC,aAAa,CAAC,EAAE,cAAc,CAAC,CAAA;YACjG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC5B,IAAI,cAAc,KAAK,UAAU;oBAAE,OAAM;gBACzC,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;gBAChC,GAAG,CAAC,cAAc,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAA;gBACnE,GAAG,CAAC,KAAK,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAA;YAC5D,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,IAAI;YACR,MAAM,OAAO,GAAG,cAAc,CAAA;YAC9B,UAAU,IAAI,CAAC,CAAA;YACf,sBAAsB,EAAE,KAAK,EAAE,CAAA;YAC/B,0BAA0B,EAAE,KAAK,EAAE,CAAA;YACnC,MAAM,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACrC,MAAM,gBAAgB,EAAE,CAAA;YACxB,cAAc,GAAG,SAAS,CAAA;YAC1B,GAAG,CAAC,eAAe,CAAC,sBAAsB,CAAC,CAAA;QAC7C,CAAC;QACD,kBAAkB,CAAC,MAAM;YACvB,yEAAyE;YACzE,2EAA2E;YAC3E,MAAM,WAAW,GAAG,MAMnB,CAAA;YACD,WAAW,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;gBACzE,IAAI,CAAC;oBACH,UAAU,IAAI,CAAC,CAAA;oBACf,sBAAsB,EAAE,KAAK,EAAE,CAAA;oBAC/B,0BAA0B,EAAE,KAAK,EAAE,CAAA;oBACnC,MAAM,cAAc,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;oBAC5C,MAAM,gBAAgB,EAAE,CAAA;oBACxB,MAAM,KAAK,GAAG,IAAI,6BAAe,CAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,UAAU,CAAC,CAAC,CAAA;oBAC9E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAA;oBACnC,cAAc,GAAG,SAAS,CAAA;oBAC1B,eAAe,GAAG,UAAU,CAAA;oBAC5B,GAAG,CAAC,eAAe,CAAC,6EAA6E,CAAC,CAAA;oBAClG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;wBACxB,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,eAAe,EAAE,MAAM,CAAC,QAAQ;wBAChC,iBAAiB,EAAE,IAAI;wBACvB,IAAI,EAAE,kDAAkD;qBACzD,CAAC,CAAA;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAAC,CAAC;YACjC,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;YACjB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,EAAE,KAAK,EAAE,6BAA6B,EAAE,OAAO,EAAE,aAAa,EAAE;YACtE,KAAK,EAAE;gBACL,qBAAqB,EAAE;oBACrB,IAAI,EAAE;wBACJ,OAAO,EAAE,qEAAqE;wBAC9E,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,yCAAyC,EAAE,EAAE;qBACjF;iBACF;aACF;SACF,CAAC;KACH,CAAA;IAED,KAAK,UAAU,gBAAgB;QAC7B,gBAAgB,EAAE,EAAE,CAAA;QACpB,gBAAgB,GAAG,SAAS,CAAA;QAC5B,IAAI,WAAW;YAAE,YAAY,CAAC,WAAW,CAAC,CAAA;QAC1C,IAAI,WAAW;YAAE,aAAa,CAAC,WAAW,CAAC,CAAA;QAC3C,WAAW,GAAG,SAAS,CAAA;QACvB,WAAW,GAAG,SAAS,CAAA;QACvB,MAAM,SAAS,EAAE,IAAI,EAAE,CAAA;QACvB,SAAS,GAAG,SAAS,CAAA;QACrB,MAAM,MAAM,EAAE,KAAK,EAAE,CAAA;QACrB,MAAM,GAAG,SAAS,CAAA;QAClB,SAAS,GAAG,SAAS,CAAA;QACrB,sBAAsB,GAAG,SAAS,CAAA;QAClC,0BAA0B,GAAG,SAAS,CAAA;QACtC,gBAAgB,GAAG,SAAS,CAAA;IAC9B,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,MAAoB,EAAE,cAAsB;QACpE,MAAM,aAAa,GAAG,GAAG,CAAC,cAAc,EAAE,CAAA;QAC1C,MAAM,eAAe,GAAG,IAAI,6BAAe,CAAC,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAA;QACjF,IAAI,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,CAAA;QAC9C,MAAM,0BAA0B,GAAG,MAAM,eAAe,CAAC,0BAA0B,EAAE,CAAA;QACrF,IAAI,IAAA,uCAAyB,EAAC,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC,EAAE,CAAC;YAC3F,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACxC,sBAAsB,GAAG,UAAU,CAAA;YACnC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,IAAA,oCAAmB,EAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,eAAe,CAAC,cAAc,EAAE,EAAE;oBAC9H,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;wBAC9B,IAAI,UAAU,KAAK,cAAc;4BAAE,GAAG,CAAC,eAAe,CAAC,gCAAgC,OAAO,IAAI,OAAO,EAAE,CAAC,CAAA;oBAC9G,CAAC;oBACD,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;wBACrC,IAAI,UAAU,KAAK,cAAc;4BAAE,GAAG,CAAC,eAAe,CAAC,8BAA8B,OAAO,IAAI,OAAO,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;oBACpJ,CAAC;iBACF,CAAC,CAAA;gBACF,IAAI,UAAU,KAAK,cAAc;oBAAE,OAAM;gBACzC,WAAW,CAAC,sBAAsB,GAAG,IAAA,oCAAsB,EAAC,MAAM,CAAC,WAAW,CAAC,CAAA;gBAC/E,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBACvC,WAAW,GAAG,WAAW,CAAA;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,UAAU,KAAK,cAAc,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;oBAAE,OAAM;gBACtE,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,eAAe,GAAG,UAAU,CAAA;oBAC5B,MAAM,OAAO,GAAG,KAAK,YAAY,6BAAY,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAA;oBACrE,MAAM,cAAc,GAAG,KAAK,YAAY,6BAAY,IAAI,KAAK,CAAC,SAAS,CAAA;oBACvE,GAAG,CAAC,eAAe,CACjB,OAAO;wBACL,CAAC,CAAC,yEAAyE;wBAC3E,CAAC,CAAC,cAAc;4BACd,CAAC,CAAC,uGAAuG;4BACzG,CAAC,CAAC,mCAAmC,SAAS,CAAC,KAAK,CAAC,4BAA4B,CACtF,CAAA;oBACD,OAAM;gBACR,CAAC;gBACD,GAAG,CAAC,KAAK,CAAC,gFAAgF,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAC/G,CAAC;oBAAS,CAAC;gBACT,IAAI,sBAAsB,KAAK,UAAU;oBAAE,sBAAsB,GAAG,SAAS,CAAA;YAC/E,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,eAAe,GAAG,UAAU,CAAA;YAC5B,GAAG,CAAC,eAAe,CAAC,yBAAyB,CAAC,CAAA;YAC9C,OAAM;QACR,CAAC;QACD,IAAI,UAAU,KAAK,cAAc;YAAE,OAAM;QACzC,MAAM,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,CAAC,CAAA;IAC3F,CAAC;IAED,KAAK,UAAU,cAAc,CAAC,MAAoB,EAAE,WAA8B,EAAE,eAAgC,EAAE,aAAqB,EAAE,cAAsB;QACjK,MAAM,UAAU,GAAG,IAAI,gCAAmB,EAAE,CAAA;QAC5C,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAA;QAC5D,MAAM,IAAI,GAAG,IAAI,gCAAgB,CAAC,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnE,SAAS,GAAG,IAAI,CAAA;QAChB,IAAI,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;QAC1D,4EAA4E;QAC5E,+EAA+E;QAC/E,MAAM,YAAY,GAAG,IAAI,qCAAqB,CAAC,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC1G,MAAM,iBAAiB,GAAG,IAAA,+BAAqB,EAAC,WAAW,CAAC,gBAAgB,CAAC,CAAA;QAC7E,MAAM,MAAM,GAAG,WAAW,CAAC,gBAAkF,CAAA;QAC7G,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,iBAAiB,IAAI,IAAA,uBAAa,EAAC,MAAM,EAAE,gBAAgB,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;QACtJ,aAAa,GAAG,OAAO,CAAA;QACvB,MAAM,OAAO,GAAG,IAAI,qBAAW,CAAC,OAAO,CAAC,CAAA;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAA,sBAAY,EAAC,GAAG,EAAE,aAAa,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC5E,QAAQ,EAAE,MAAM,CAAC,WAAW,GAAG,IAAI,GAAG,IAAI;YAC1C,QAAQ,EAAE,MAAM,CAAC,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;YACpD,YAAY,EAAE,mBAAQ,CAAC,YAAY;SACpC,EAAE,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QACtC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAA;QACvB,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAA;QACjC,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAC/B,WAAW,CAAC,aAAa,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;YAChG,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QACzC,CAAC;QACD,IAAI,UAAU,KAAK,cAAc;YAAE,OAAM;QACzC,SAAS,GAAG,IAAI,iCAAmB,CAAC,WAAW,EAAE,MAAM,EAAE;YACvD,OAAO;YACP,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;gBACzB,IAAI,eAAe,KAAK,gBAAgB;oBAAE,OAAM;gBAChD,eAAe,GAAG,KAAK,CAAA;gBACvB,KAAK,YAAY,CAAC,MAAM,CAAC,CAAA;gBACzB,IAAI,KAAK,KAAK,uBAAuB;oBAAE,KAAK,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;YAC7F,CAAC;YACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC1C,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;gBAC/B,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBACpC,aAAa,GAAG,WAAW,CAAA;gBAC3B,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;YACpC,CAAC;YACD,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;SAC3E,CAAC,CAAA;QACF,gBAAgB,GAAG,IAAA,iCAAoB,EAAC,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACjF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACtB,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;YAChE,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS;gBAAE,OAAM;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACpC,KAAK,CAAC,iBAAiB,GAAG,QAAQ,EAAE,iBAAiB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACjF,IAAI,QAAQ;gBAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAA;YACvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAA;YAC5D,IAAI,gBAAgB,KAAK,gBAAgB,EAAE,CAAC;gBAC1C,gBAAgB,GAAG,gBAAgB,CAAA;gBACnC,KAAK,WAAW,CAAC,QAAQ,EAAE,GAAG,gBAAgB,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,6CAA6C,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;YAClJ,CAAC;YACD,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC9D,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;gBAChC,IAAI,MAAM,CAAC,cAAc;oBAAE,GAAG,CAAC,KAAK,CAAC,+BAA+B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;YACxF,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,0CAA0C,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;QAC9F,CAAC,CAAA;QACD,MAAM,cAAc,GAAG,GAAG,EAAE;YAC1B,IAAI,UAAU,KAAK,cAAc;gBAAE,OAAM;YACzC,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,MAAM,EAAE,CAAA;gBACR,cAAc,EAAE,CAAA;YAClB,CAAC,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;QAC9B,CAAC,CAAA;QACD,cAAc,EAAE,CAAA;QAChB,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,YAAY,EAAE,EAAE,MAAM,CAAC,CAAA;QAC5D,SAAS,CAAC,KAAK,EAAE,CAAA;QACjB,MAAM,YAAY,EAAE,CAAA;IACtB,CAAC;IAED,KAAK,UAAU,YAAY,CAAC,MAAe;QACzC,IAAI,eAAe,KAAK,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,GAAG,CAAC,eAAe,CAAC,yBAAyB,CAAC,CAAA;YAC9C,OAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QAClC,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC,YAAY,YAAY,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;QAC9F,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,YAAY,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;QAC3E,MAAM,QAAQ,GAAG,SAAS,KAAK,CAAC,oBAAoB,IAAI,KAAK,CAAC,eAAe,EAAE,CAAA;QAC/E,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,SAAS,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1C,SAAS,EAAE,YAAY,CAAC;YACtB,aAAa;YACb,eAAe;YACf,iBAAiB,EAAE,KAAK,CAAC,YAAY;YACrC,cAAc,EAAE,KAAK,CAAC,SAAS;YAC/B,qBAAqB,EAAE,KAAK,CAAC,gBAAgB;YAC7C,iBAAiB,EAAE,KAAK,CAAC,YAAY;YACrC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAChD,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,KAAK;YAC9C,cAAc;YACd,SAAS,EAAE,aAAa,EAAE,SAAS;YACnC,eAAe,EAAE,aAAa,EAAE,QAAQ;YACxC,GAAG,SAAS,EAAE,gBAAgB,EAAE;SACjC,CAAC,CAAA;QACF,IAAI,eAAe,KAAK,gBAAgB,EAAE,CAAC;YACzC,GAAG,CAAC,eAAe,CAAC,2DAA2D,KAAK,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC,CAAA;YAC5G,OAAM;QACR,CAAC;QACD,GAAG,CAAC,eAAe,CAAC,gBAAgB,eAAe,MAAM,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,CAAA;IACvG,CAAC;IAED,SAAS,kBAAkB,CAAC,WAA8B,EAAE,cAAsB;QAChF,IAAI,gBAAgB;YAAE,OAAO,gBAAgB,CAAA;QAC7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,0BAA0B,GAAG,UAAU,CAAA;QACvC,gBAAgB,GAAG,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAA,2CAAsB,EAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;YAC3E,IAAI,MAAM,KAAK,SAAS,IAAI,UAAU,KAAK,cAAc,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAM;YAC9F,eAAe,GAAG,gBAAgB,CAAA;YAClC,gBAAgB,EAAE,EAAE,CAAA;YACpB,gBAAgB,GAAG,SAAS,CAAA;YAC5B,IAAI,WAAW;gBAAE,YAAY,CAAC,WAAW,CAAC,CAAA;YAC1C,WAAW,GAAG,SAAS,CAAA;YACvB,MAAM,SAAS,EAAE,IAAI,EAAE,CAAA;YACvB,MAAM,YAAY,EAAE,CAAA;QACtB,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,0BAA0B,KAAK,UAAU;gBAAE,0BAA0B,GAAG,SAAS,CAAA;YACrF,gBAAgB,GAAG,SAAS,CAAA;QAC9B,CAAC,CAAC,CAAA;QACF,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,KAAK,UAAU,gBAAgB,CAAC,MAAc;IAC5C,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAiB,CAAA;IAAC,CAAC;IAC5E,OAAO,KAAK,EAAE,CAAC;QACb,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ,IAAI,KAAK,YAAY,WAAW;YAAE,OAAO,SAAS,CAAA;QACzG,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,QAAgB;IACzD,MAAM,SAAS,GAAG,GAAG,MAAM,MAAM,CAAA;IACjC,MAAM,kBAAE,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACxD,MAAM,kBAAE,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AACpC,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACzI,CAAC;AAED,iBAAS,WAAW,CAAA"}

package/dist/outbox/database-outbox.d.ts

@@ -0,0 +1,25 @@
+import type { TelemetryDraft, TelemetrySample } from '../telemetry/types';
+import type { PluginDatabase } from './database-types';
+import type { OutboxOptions, OutboxSeed, OutboxStats, OutboxStore } from './interface';
+export declare class DatabaseOutbox implements OutboxStore {
+    private readonly database;
+    private readonly deviceId;
+    private readonly options;
+    private readonly seed?;
+    private opened;
+    private operation;
+    constructor(database: PluginDatabase, deviceId: string, options: OutboxOptions, seed?: OutboxSeed | undefined);
+    open(): Promise<void>;
+    append(deviceId: string, draft: TelemetryDraft): Promise<TelemetrySample>;
+    pending(limit: number, maxBytes: number): Promise<TelemetrySample[]>;
+    pendingAfter(sequence: number, limit: number, maxBytes: number): Promise<TelemetrySample[]>;
+    acknowledge(sequence: number): Promise<void>;
+    latest(): Promise<TelemetrySample | undefined>;
+    stats(): Promise<OutboxStats>;
+    close(): Promise<void>;
+    private enforceLimits;
+    private enforceLimitsUnlocked;
+    private readState;
+    private assertOpen;
+    private exclusive;
+}

package/dist/outbox/database-outbox.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseOutbox = void 0;
+const MIGRATIONS = [{
+        version: 1,
+        sql: `
+    CREATE TABLE IF NOT EXISTS outbox_state (
+      device_id TEXT PRIMARY KEY,
+      next_sequence INTEGER NOT NULL,
+      acknowledged_sequence INTEGER NOT NULL,
+      dropped_count INTEGER NOT NULL,
+      dropped_through INTEGER NOT NULL
+    );
+    CREATE TABLE IF NOT EXISTS outbox_records (
+      device_id TEXT NOT NULL,
+      sequence INTEGER NOT NULL,
+      captured_at INTEGER NOT NULL,
+      received_at INTEGER NOT NULL,
+      payload TEXT NOT NULL,
+      payload_bytes INTEGER NOT NULL,
+      PRIMARY KEY (device_id, sequence)
+    );
+    CREATE INDEX IF NOT EXISTS ix_outbox_records_device_sequence ON outbox_records (device_id, sequence);
+    CREATE INDEX IF NOT EXISTS ix_outbox_records_device_captured ON outbox_records (device_id, captured_at);
+  `
+    }];
+class DatabaseOutbox {
+    database;
+    deviceId;
+    options;
+    seed;
+    opened = false;
+    operation = Promise.resolve();
+    constructor(database, deviceId, options, seed) {
+        this.database = database;
+        this.deviceId = deviceId;
+        this.options = options;
+        this.seed = seed;
+    }
+    async open() {
+        await this.database.migrate(MIGRATIONS);
+        const seed = this.seed ?? { currentSequence: 0, acknowledgedSequence: 0, droppedCount: 0, droppedThrough: 0 };
+        await this.database.run(`INSERT INTO outbox_state (device_id, next_sequence, acknowledged_sequence, dropped_count, dropped_through)
+       SELECT ?, ?, ?, ?, ? WHERE NOT EXISTS (SELECT 1 FROM outbox_state WHERE device_id = ?)`, [this.deviceId, seed.currentSequence + 1, seed.acknowledgedSequence, seed.droppedCount, seed.droppedThrough, this.deviceId]);
+        if (this.seed) {
+            const state = await this.readState(this.database);
+            await this.database.run(`UPDATE outbox_state SET next_sequence = ?, acknowledged_sequence = ?, dropped_count = ?, dropped_through = ?
+         WHERE device_id = ?`, [
+                Math.max(Number(state.next_sequence), seed.currentSequence + 1),
+                Math.max(Number(state.acknowledged_sequence), seed.acknowledgedSequence),
+                Math.max(Number(state.dropped_count), seed.droppedCount),
+                Math.max(Number(state.dropped_through), seed.droppedThrough),
+                this.deviceId
+            ]);
+        }
+        this.opened = true;
+        await this.enforceLimits();
+    }
+    append(deviceId, draft) {
+        return this.exclusive(async () => {
+            this.assertOpen();
+            if (deviceId !== this.deviceId)
+                throw new Error('Outbox device identity does not match');
+            const sample = await this.database.transaction(async (database) => {
+                const state = await this.readState(database);
+                const value = { v: 1, deviceId, sequence: state.next_sequence, ...draft };
+                const payload = JSON.stringify(value);
+                await database.run('INSERT INTO outbox_records (device_id, sequence, captured_at, received_at, payload, payload_bytes) VALUES (?, ?, ?, ?, ?, ?)', [deviceId, value.sequence, value.capturedAt, value.receivedAt, payload, Buffer.byteLength(payload)]);
+                await database.run('UPDATE outbox_state SET next_sequence = ? WHERE device_id = ?', [value.sequence + 1, deviceId]);
+                return value;
+            });
+            await this.enforceLimitsUnlocked();
+            return sample;
+        });
+    }
+    pending(limit, maxBytes) {
+        return this.pendingAfter(0, limit, maxBytes);
+    }
+    pendingAfter(sequence, limit, maxBytes) {
+        return this.exclusive(async () => {
+            this.assertOpen();
+            const rows = await this.database.query('SELECT payload FROM outbox_records WHERE device_id = ? AND sequence > ? ORDER BY sequence ASC LIMIT ?', [this.deviceId, sequence, Math.max(1, limit)]);
+            const result = [];
+            let bytes = 0;
+            for (const row of rows) {
+                const size = Buffer.byteLength(row.payload);
+                if (result.length && bytes + size > maxBytes)
+                    break;
+                result.push(JSON.parse(row.payload));
+                bytes += size;
+            }
+            return result;
+        });
+    }
+    acknowledge(sequence) {
+        return this.exclusive(async () => {
+            this.assertOpen();
+            await this.database.transaction(async (database) => {
+                const state = await this.readState(database);
+                const maximum = state.next_sequence - 1;
+                if (!Number.isSafeInteger(sequence) || sequence <= state.acknowledged_sequence || sequence > maximum)
+                    return;
+                await database.run('UPDATE outbox_state SET acknowledged_sequence = ? WHERE device_id = ?', [sequence, this.deviceId]);
+                await database.run('DELETE FROM outbox_records WHERE device_id = ? AND sequence <= ?', [this.deviceId, sequence]);
+            });
+        });
+    }
+    latest() {
+        return this.exclusive(async () => {
+            this.assertOpen();
+            const rows = await this.database.query('SELECT payload FROM outbox_records WHERE device_id = ? ORDER BY sequence DESC LIMIT 1', [this.deviceId]);
+            return rows[0] ? JSON.parse(rows[0].payload) : undefined;
+        });
+    }
+    stats() {
+        return this.exclusive(async () => {
+            this.assertOpen();
+            const state = await this.readState(this.database);
+            const rows = await this.database.query(`SELECT COUNT(*) AS message_count, COALESCE(SUM(payload_bytes), 0) AS storage_bytes,
+                MIN(captured_at) AS oldest_captured_at FROM outbox_records WHERE device_id = ?`, [this.deviceId]);
+            const aggregate = rows[0] ?? { message_count: 0, storage_bytes: 0, oldest_captured_at: null };
+            return {
+                storageBackend: 'database',
+                messageCount: Number(aggregate.message_count),
+                diskBytes: Number(aggregate.storage_bytes),
+                oldestCapturedAt: aggregate.oldest_captured_at === null ? undefined : Number(aggregate.oldest_captured_at),
+                acknowledgedSequence: Number(state.acknowledged_sequence),
+                currentSequence: Number(state.next_sequence) - 1,
+                droppedCount: Number(state.dropped_count),
+                droppedThrough: Number(state.dropped_through)
+            };
+        });
+    }
+    async close() {
+        await this.operation;
+        this.opened = false;
+    }
+    async enforceLimits() {
+        await this.exclusive(() => this.enforceLimitsUnlocked());
+    }
+    async enforceLimitsUnlocked() {
+        const now = this.options.now?.() ?? Date.now();
+        const rows = await this.database.query('SELECT sequence, payload_bytes FROM outbox_records WHERE device_id = ? ORDER BY sequence ASC', [this.deviceId]);
+        let total = rows.reduce((sum, row) => sum + Number(row.payload_bytes), 0);
+        const cutoff = now - this.options.maxAgeMs;
+        const capturedRows = await this.database.query('SELECT sequence, captured_at FROM outbox_records WHERE device_id = ? ORDER BY sequence ASC', [this.deviceId]);
+        let dropThrough = 0;
+        let dropCount = 0;
+        for (let index = 0; index < rows.length - 1; index += 1) {
+            const row = rows[index];
+            const captured = capturedRows[index];
+            if (!row || !captured)
+                continue;
+            const tooOld = Number(captured.captured_at) < cutoff;
+            if (!tooOld && total <= this.options.maxBytes)
+                break;
+            total -= Number(row.payload_bytes);
+            dropThrough = Number(row.sequence);
+            dropCount += 1;
+        }
+        if (!dropCount)
+            return;
+        await this.database.transaction(async (database) => {
+            await database.run('DELETE FROM outbox_records WHERE device_id = ? AND sequence <= ?', [this.deviceId, dropThrough]);
+            await database.run(`UPDATE outbox_state SET dropped_count = dropped_count + ?,
+         dropped_through = CASE WHEN dropped_through > ? THEN dropped_through ELSE ? END WHERE device_id = ?`, [dropCount, dropThrough, dropThrough, this.deviceId]);
+        });
+    }
+    async readState(database) {
+        const rows = await database.query('SELECT next_sequence, acknowledged_sequence, dropped_count, dropped_through FROM outbox_state WHERE device_id = ?', [this.deviceId]);
+        if (!rows[0])
+            throw new Error('Outbox state is unavailable');
+        return rows[0];
+    }
+    assertOpen() {
+        if (!this.opened)
+            throw new Error('Outbox is not open');
+    }
+    exclusive(action) {
+        const result = this.operation.then(action, action);
+        this.operation = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+exports.DatabaseOutbox = DatabaseOutbox;
+//# sourceMappingURL=database-outbox.js.map

package/dist/outbox/database-outbox.js.map

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

package/dist/outbox/database-types.d.ts

@@ -0,0 +1,19 @@
+export interface DatabaseRunResult {
+    changes: number;
+    lastInsertRowid: number | bigint;
+}
+export interface PluginDatabase {
+    migrate(migrations: Array<{
+        version: number;
+        sql: string;
+    }>): Promise<void>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<T[]>;
+    run(sql: string, params?: unknown[]): Promise<DatabaseRunResult>;
+    transaction<T>(action: (database: PluginDatabase) => Promise<T>): Promise<T>;
+}
+export interface SignalKDatabaseApi {
+    getPluginDb(pluginId: string): Promise<PluginDatabase>;
+}
+export interface WithSignalKDatabaseApi {
+    getDatabaseApi?: () => SignalKDatabaseApi;
+}

package/dist/outbox/database-types.js

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

package/dist/outbox/database-types.js.map

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

package/dist/outbox/factory.d.ts

@@ -0,0 +1,12 @@
+import type { ServerAPI } from '@signalk/server-api';
+import type { OutboxOptions, OutboxStore } from './interface';
+interface BackendMarker {
+    version: 1;
+    backend: 'file' | 'database';
+}
+export interface SelectedOutbox {
+    store: OutboxStore;
+    backend: BackendMarker['backend'];
+}
+export declare function createOutbox(app: ServerAPI, dataDirectory: string, deviceId: string, options: OutboxOptions, expectedBackend?: BackendMarker['backend']): Promise<SelectedOutbox>;
+export {};