signalk-masterbus 0.1.0

package/plugin/index.js

@@ -0,0 +1,199 @@
+import path from 'node:path';
+import { DaemonClient } from './client.js';
+import { SCHEMA, UI_SCHEMA, withDefaults } from './config.js';
+import { DaemonManager, errMsg, resolveBinary } from './daemon.js';
+import { PutBridge } from './put-bridge.js';
+import { registerRoutes } from './router.js';
+import { StreamForwarder } from './stream-forwarder.js';
+export const PLUGIN_ID = 'signalk-masterbus';
+/** How often the daemon is asked for its status and the mapping re-synced. */
+const POLL_MS = 10_000;
+/**
+ * Mastervolt MasterBus for Signal K.
+ *
+ * The plugin is a thin layer over `masterbus-signalk`, the daemon from the
+ * masterbus project. In *bundled* mode the plugin starts the daemon on this
+ * machine and keeps its config, mapping and schema cache under the plugin's
+ * data directory; in *external* mode it connects to one running elsewhere.
+ * Either way it speaks the same two things to it: the delta stream, which is
+ * republished through `handleMessage`, and the control API, which the
+ * mapping editor (the webapp under `public/`) reaches through this plugin's
+ * router and which turns Signal K PUTs into field writes.
+ */
+export default function plugin(app) {
+    let config = null;
+    let daemon = null;
+    let client = null;
+    let forwarder = null;
+    let bridge = null;
+    let poller = null;
+    let lastStatus = null;
+    let lastError = null;
+    let mappingSeen = '';
+    // Bumped on every start/stop so a start still in flight when stop() runs
+    // notices and does not resurrect anything.
+    let generation = 0;
+    const summary = () => ({
+        mode: config?.mode ?? null,
+        connected: client !== null && lastStatus !== null,
+        daemon: daemon ? { running: daemon.running, recentLog: daemon.recentLog } : null,
+        status: lastStatus,
+        error: lastError,
+        stream: forwarder ? { connected: forwarder.connected, ...forwarder.counts } : null,
+        putPaths: bridge?.paths ?? []
+    });
+    const statusLine = (s) => {
+        const where = config?.mode === 'bundled' ? 'Bundled daemon' : `Daemon at ${client?.endpoint.host}`;
+        const problems = s.diagnostics.errors > 0
+            ? `; ${s.diagnostics.errors} mapping entr${s.diagnostics.errors === 1 ? 'y' : 'ies'} skipped, see the editor`
+            : '';
+        return (`${where}: streaming ${s.streaming} field${s.streaming === 1 ? '' : 's'} from ` +
+            `${s.mapped.devices} of ${s.devices} device${s.devices === 1 ? '' : 's'}` +
+            (s.devices === 0 ? ' (discovering)' : '') +
+            problems);
+    };
+    const setError = (msg) => {
+        lastError = msg;
+        app.setPluginError(msg);
+    };
+    /** Ask the daemon how it is doing and keep the PUT handlers in step. */
+    const poll = async () => {
+        if (!client || !bridge)
+            return;
+        try {
+            const status = await client.status();
+            lastStatus = status;
+            lastError = null;
+            const mapping = await client.mapping();
+            const putKey = JSON.stringify(Object.entries(mapping.devices).map(([s, d]) => [
+                s,
+                Object.entries(d.fields)
+                    .filter(([, f]) => f.put)
+                    .map(([k, f]) => [k, f.path])
+            ]));
+            if (putKey !== mappingSeen) {
+                mappingSeen = putKey;
+                const { added, removed } = bridge.sync(mapping);
+                if (added.length + removed.length > 0) {
+                    app.debug(`PUT targets: +${added.length} -${removed.length}: ${bridge.paths.join(' ')}`);
+                }
+            }
+            app.setPluginStatus(statusLine(status));
+        }
+        catch (err) {
+            lastStatus = null;
+            setError(`Daemon: ${errMsg(err)}`);
+        }
+    };
+    const asyncStart = async (cfg, gen) => {
+        let endpoint;
+        if (cfg.mode === 'bundled') {
+            const binary = resolveBinary(cfg.bundled.binaryPath);
+            const dataDir = path.join(app.getDataDirPath(), 'masterbus');
+            const d = new DaemonManager({
+                binary,
+                dataDir,
+                config: cfg.bundled,
+                events: {
+                    log: (line) => {
+                        app.debug(`daemon: ${line}`);
+                    },
+                    exited: (code, signal, restartIn) => {
+                        const why = `the daemon exited (${code ?? signal ?? '?'})`;
+                        if (restartIn === null) {
+                            app.debug(why);
+                        }
+                        else {
+                            setError(`${why}; restarting in ${restartIn / 1000} s. ${d.recentLog.slice(-3).join(' | ')}`);
+                        }
+                    },
+                    ready: () => {
+                        app.setPluginStatus('Daemon restarted; reconnecting');
+                        void poll();
+                    }
+                }
+            });
+            daemon = d;
+            app.setPluginStatus(`Starting ${path.basename(binary)}…`);
+            await d.start();
+            if (gen !== generation) {
+                await d.stop();
+                return;
+            }
+            endpoint = {
+                host: '127.0.0.1',
+                apiPort: cfg.bundled.apiPort,
+                streamPort: cfg.bundled.streamPort,
+                token: d.token
+            };
+        }
+        else {
+            endpoint = { ...cfg.external };
+            app.setPluginStatus(`Connecting to ${endpoint.host}:${endpoint.apiPort}…`);
+        }
+        const c = new DaemonClient(endpoint);
+        // A version check before anything else; a wrong daemon is refused loudly.
+        lastStatus = await c.status();
+        if (gen !== generation)
+            return;
+        client = c;
+        const b = new PutBridge(app, c, PLUGIN_ID);
+        b.setInstallerCode(cfg.installerCode);
+        bridge = b;
+        const f = new StreamForwarder(app, {
+            pluginId: PLUGIN_ID,
+            host: endpoint.host,
+            port: endpoint.streamPort,
+            debug: (m) => {
+                app.debug(m);
+            }
+        });
+        forwarder = f;
+        f.start();
+        await poll();
+        poller = setInterval(() => {
+            void poll();
+        }, POLL_MS);
+    };
+    return {
+        id: PLUGIN_ID,
+        name: 'MasterBus',
+        description: 'Mastervolt MasterBus: publish battery, charger and inverter values, edit the mapping ' +
+            'in the browser, and switch devices from Signal K.',
+        schema: SCHEMA,
+        uiSchema: UI_SCHEMA,
+        start(options) {
+            const gen = ++generation;
+            config = withDefaults(options);
+            lastError = null;
+            void asyncStart(config, gen).catch((err) => {
+                if (gen !== generation)
+                    return;
+                setError(errMsg(err));
+            });
+        },
+        async stop() {
+            generation++;
+            if (poller) {
+                clearInterval(poller);
+                poller = null;
+            }
+            forwarder?.stop();
+            forwarder = null;
+            bridge?.clear();
+            bridge = null;
+            client = null;
+            lastStatus = null;
+            if (daemon) {
+                const d = daemon;
+                daemon = null;
+                await d.stop();
+            }
+            app.setPluginStatus('Stopped');
+        },
+        registerWithRouter(router) {
+            registerRoutes(router, { client: () => client, summary });
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/plugin/index.js.map

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

package/plugin/put-bridge.d.ts

@@ -0,0 +1,47 @@
+import type { ActionResult } from '@signalk/server-api';
+import { type Login, type Mapping } from './types.js';
+/** The slice of the server the bridge needs. */
+export interface PutBridgeApp {
+    registerPutHandler(context: string, path: string, callback: (context: string, path: string, value: unknown, cb: (result: ActionResult) => void) => ActionResult, source?: string): void;
+    debug?(msg: string): void;
+}
+/** The slice of the client the bridge needs. */
+export interface PutBridgeClient {
+    writeValue(serial: string, field: string, value: unknown, login?: Login): Promise<{
+        applied: unknown;
+        published: unknown;
+    }>;
+}
+/**
+ * Turns the mapping's `"put": true` entries into Signal K PUT handlers.
+ *
+ * The server has no way to unregister a handler, so one is registered per
+ * path the first time it is seen and stays; what it does is looked up in a
+ * live table on every call. A path that is no longer a put target answers
+ * with a 404-style failure rather than writing to a stale field.
+ *
+ * A write refused for lack of access level is retried once with the
+ * installer code when one is configured.
+ */
+export declare class PutBridge {
+    private readonly app;
+    private readonly client;
+    private readonly pluginId;
+    private readonly targets;
+    private readonly registered;
+    private installerCode;
+    constructor(app: PutBridgeApp, client: PutBridgeClient, pluginId: string);
+    setInstallerCode(code: number | null): void;
+    /** The paths currently accepting PUTs. */
+    get paths(): string[];
+    /** Bring the live table in line with a mapping; returns what changed. */
+    sync(mapping: Mapping): {
+        added: string[];
+        removed: string[];
+    };
+    /** Drop every target (the plugin is stopping); registrations remain. */
+    clear(): void;
+    private readonly handler;
+    private write;
+}
+//# sourceMappingURL=put-bridge.d.ts.map

package/plugin/put-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-bridge.d.ts","sourceRoot":"","sources":["../src/put-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAA;AAElE,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,kBAAkB,CAChB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CACR,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,KAC/B,YAAY,EACjB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAA;IACP,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,UAAU,CACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACrD;AAOD;;;;;;;;;;GAUG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,aAAa,CAAsB;gBAE/B,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM;IAMxE,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAI3C,0CAA0C;IAC1C,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED,yEAAyE;IACzE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAuB9D,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,QAAQ,CAAC,OAAO,CAsBvB;YAEa,KAAK;CAsBpB"}

package/plugin/put-bridge.js

@@ -0,0 +1,116 @@
+import { DaemonError } from './types.js';
+/**
+ * Turns the mapping's `"put": true` entries into Signal K PUT handlers.
+ *
+ * The server has no way to unregister a handler, so one is registered per
+ * path the first time it is seen and stays; what it does is looked up in a
+ * live table on every call. A path that is no longer a put target answers
+ * with a 404-style failure rather than writing to a stale field.
+ *
+ * A write refused for lack of access level is retried once with the
+ * installer code when one is configured.
+ */
+export class PutBridge {
+    app;
+    client;
+    pluginId;
+    targets = new Map();
+    registered = new Set();
+    installerCode = null;
+    constructor(app, client, pluginId) {
+        this.app = app;
+        this.client = client;
+        this.pluginId = pluginId;
+    }
+    setInstallerCode(code) {
+        this.installerCode = code;
+    }
+    /** The paths currently accepting PUTs. */
+    get paths() {
+        return [...this.targets.keys()].sort();
+    }
+    /** Bring the live table in line with a mapping; returns what changed. */
+    sync(mapping) {
+        const next = new Map();
+        for (const [serial, dm] of Object.entries(mapping.devices)) {
+            for (const [field, fm] of Object.entries(dm.fields)) {
+                if (fm.put && fm.path)
+                    next.set(fm.path, { serial, field });
+            }
+        }
+        const added = [];
+        const removed = [];
+        for (const path of this.targets.keys())
+            if (!next.has(path))
+                removed.push(path);
+        for (const [path, target] of next) {
+            if (!this.targets.has(path))
+                added.push(path);
+            this.targets.set(path, target);
+        }
+        for (const path of removed)
+            this.targets.delete(path);
+        for (const path of added) {
+            if (this.registered.has(path))
+                continue;
+            this.registered.add(path);
+            this.app.registerPutHandler('vessels.self', path, this.handler, this.pluginId);
+        }
+        return { added: added.sort(), removed: removed.sort() };
+    }
+    /** Drop every target (the plugin is stopping); registrations remain. */
+    clear() {
+        this.targets.clear();
+    }
+    handler = (_context, path, value, cb) => {
+        const target = this.targets.get(path);
+        if (!target) {
+            return {
+                state: 'COMPLETED',
+                statusCode: 404,
+                message: `${path} is not a MasterBus PUT target`
+            };
+        }
+        void this.write(target, value)
+            .then((r) => {
+            cb(r);
+        })
+            .catch((err) => {
+            cb({ state: 'COMPLETED', statusCode: 500, message: errMsg(err) });
+        });
+        return { state: 'PENDING' };
+    };
+    async write(target, value) {
+        try {
+            await this.client.writeValue(target.serial, target.field, value);
+            return { state: 'COMPLETED', statusCode: 200 };
+        }
+        catch (err) {
+            if (err instanceof DaemonError && err.needs === 'login' && this.installerCode !== null) {
+                this.app.debug?.(`${target.serial} ${target.field}: read-only; retrying with installer login`);
+                try {
+                    await this.client.writeValue(target.serial, target.field, value, {
+                        level: 'installer',
+                        code: this.installerCode
+                    });
+                    return { state: 'COMPLETED', statusCode: 200 };
+                }
+                catch (again) {
+                    return failure(again);
+                }
+            }
+            return failure(err);
+        }
+    }
+}
+function failure(err) {
+    if (err instanceof DaemonError) {
+        const statusCode = err.status >= 400 && err.status < 600 ? err.status : 502;
+        return { state: 'COMPLETED', statusCode, message: err.message };
+    }
+    return { state: 'COMPLETED', statusCode: 502, message: errMsg(err) };
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=put-bridge.js.map

package/plugin/put-bridge.js.map

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

package/plugin/router.d.ts

@@ -0,0 +1,20 @@
+import type { PluginRouter } from '@signalk/server-api';
+import type { DaemonClient } from './client.js';
+/** What the router needs from the plugin: the client of the moment. */
+export interface RouterState {
+    client: () => DaemonClient | null;
+    /** A one-line summary for `/status`. */
+    summary: () => Record<string, unknown>;
+}
+/**
+ * Mounts the editor's routes under `/plugins/signalk-masterbus/`:
+ *
+ * - `/status` — what the plugin knows, for the editor's header.
+ * - `/api/*` — proxied to the daemon's control API with the token added, so
+ *   the browser never needs to reach the daemon (which in external mode may
+ *   be on another host) and Signal K's own login covers it. Reads are open
+ *   to read-only users; anything that changes the mapping or writes to the
+ *   bus is admin-only, which is the router's default.
+ */
+export declare function registerRoutes(router: PluginRouter, state: RouterState): void;
+//# sourceMappingURL=router.d.ts.map

package/plugin/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,YAAY,GAAG,IAAI,CAAA;IACjC,wCAAwC;IACxC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CA0B7E"}

package/plugin/router.js

@@ -0,0 +1,38 @@
+/**
+ * Mounts the editor's routes under `/plugins/signalk-masterbus/`:
+ *
+ * - `/status` — what the plugin knows, for the editor's header.
+ * - `/api/*` — proxied to the daemon's control API with the token added, so
+ *   the browser never needs to reach the daemon (which in external mode may
+ *   be on another host) and Signal K's own login covers it. Reads are open
+ *   to read-only users; anything that changes the mapping or writes to the
+ *   bus is admin-only, which is the router's default.
+ */
+export function registerRoutes(router, state) {
+    const proxy = (req, res) => {
+        const client = state.client();
+        if (!client) {
+            res.status(503).json({ error: 'the MasterBus daemon is not connected' });
+            return;
+        }
+        // Everything after `/api` on this router, query string included.
+        const tail = req.originalUrl.replace(/^.*?\/api(?=\/|\?|$)/, '');
+        const body = req.method === 'GET' ? undefined : req.body;
+        client
+            .raw(req.method, `/api${tail}`, body)
+            .then(({ status, body }) => {
+            res.status(status).json(body);
+        })
+            .catch((err) => {
+            res.status(502).json({ error: err instanceof Error ? err.message : String(err) });
+        });
+    };
+    router.access('readonly').get('/status', (_req, res) => {
+        res.json(state.summary());
+    });
+    // Express 4 wildcards (the server's Express): `*` rather than `{*path}`.
+    router.access('readonly').get('/api/*', proxy);
+    router.put('/api/*', proxy);
+    router.post('/api/*', proxy);
+}
+//# sourceMappingURL=router.js.map

package/plugin/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB,EAAE,KAAkB;IACrE,MAAM,KAAK,GAAG,CAAC,GAAY,EAAE,GAAa,EAAQ,EAAE;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAA;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAA;YACxE,OAAM;QACR,CAAC;QACD,iEAAiE;QACjE,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAA;QAChE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,GAAG,CAAC,IAAgB,CAAA;QACrE,MAAM;aACH,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,EAAE,IAAI,CAAC;aACpC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;YACzB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnF,CAAC,CAAC,CAAA;IACN,CAAC,CAAA;IACD,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACrD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3B,CAAC,CAAC,CAAA;IACF,yEAAyE;IACzE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC9C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC3B,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AAC9B,CAAC"}

package/plugin/stream-forwarder.d.ts

@@ -0,0 +1,54 @@
+import type { Delta } from '@signalk/server-api';
+/** The slice of the server the forwarder needs, so tests can pass a stub. */
+export interface ForwarderApp {
+    handleMessage(id: string, msg: Partial<Delta>): void;
+}
+export interface ForwarderOptions {
+    pluginId: string;
+    host: string;
+    port: number;
+    debug?: (msg: string) => void;
+    reconnectMs?: number;
+}
+/**
+ * Reads the daemon's delta stream (newline-delimited Signal K deltas over
+ * TCP) and republishes every update through `app.handleMessage`, so the
+ * values, unit `meta` and notifications land on the server's own model,
+ * attributed to this plugin.
+ *
+ * `$source` and `timestamp` are dropped from each update: the server stamps
+ * both, and keeping the daemon's `$source` would make the data look like it
+ * came from a provider the admin UI cannot find.
+ *
+ * Reconnects with a fixed interval; the daemon replays the static metadata
+ * and notification states on every new connection, so nothing is lost.
+ */
+export declare class StreamForwarder {
+    private readonly app;
+    private readonly opts;
+    private socket;
+    private timer;
+    private closed;
+    private _connected;
+    private _deltas;
+    private _values;
+    constructor(app: ForwarderApp, opts: ForwarderOptions);
+    get connected(): boolean;
+    /** Deltas and value entries forwarded so far. */
+    get counts(): {
+        deltas: number;
+        values: number;
+    };
+    start(): void;
+    stop(): void;
+    private connect;
+    private schedule;
+    /** One line of the stream. Exposed for tests. */
+    forward(line: string): void;
+}
+/**
+ * The delta with `$source` and `timestamp` removed from every update, or
+ * null when it is not a delta with updates.
+ */
+export declare function strip(parsed: unknown): Partial<Delta> | null;
+//# sourceMappingURL=stream-forwarder.d.ts.map

package/plugin/stream-forwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-forwarder.d.ts","sourceRoot":"","sources":["../src/stream-forwarder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,OAAO,CAAI;gBAEP,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB;IASrD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,iDAAiD;IACjD,IAAI,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAE/C;IAED,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,OAAO;IAwBf,OAAO,CAAC,QAAQ;IAQhB,iDAAiD;IACjD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAsB5B;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAa5D"}

package/plugin/stream-forwarder.js

@@ -0,0 +1,139 @@
+import net from 'node:net';
+import readline from 'node:readline';
+/**
+ * Reads the daemon's delta stream (newline-delimited Signal K deltas over
+ * TCP) and republishes every update through `app.handleMessage`, so the
+ * values, unit `meta` and notifications land on the server's own model,
+ * attributed to this plugin.
+ *
+ * `$source` and `timestamp` are dropped from each update: the server stamps
+ * both, and keeping the daemon's `$source` would make the data look like it
+ * came from a provider the admin UI cannot find.
+ *
+ * Reconnects with a fixed interval; the daemon replays the static metadata
+ * and notification states on every new connection, so nothing is lost.
+ */
+export class StreamForwarder {
+    app;
+    opts;
+    socket = null;
+    timer = null;
+    closed = false;
+    _connected = false;
+    _deltas = 0;
+    _values = 0;
+    constructor(app, opts) {
+        this.app = app;
+        this.opts = {
+            debug: () => { },
+            reconnectMs: 3000,
+            ...opts
+        };
+    }
+    get connected() {
+        return this._connected;
+    }
+    /** Deltas and value entries forwarded so far. */
+    get counts() {
+        return { deltas: this._deltas, values: this._values };
+    }
+    start() {
+        this.closed = false;
+        this.connect();
+    }
+    stop() {
+        this.closed = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.socket?.destroy();
+        this.socket = null;
+        this._connected = false;
+    }
+    connect() {
+        if (this.closed)
+            return;
+        const { host, port } = this.opts;
+        this.opts.debug(`connecting to the stream at ${host}:${port}`);
+        const socket = net.connect({ host, port });
+        this.socket = socket;
+        socket.setKeepAlive(true, 10_000);
+        socket.on('connect', () => {
+            this._connected = true;
+            this.opts.debug('stream connected');
+        });
+        readline.createInterface({ input: socket }).on('line', (line) => {
+            this.forward(line);
+        });
+        socket.on('error', (err) => {
+            this.opts.debug(`stream error: ${err.message}`);
+        });
+        socket.on('close', () => {
+            this._connected = false;
+            if (this.socket === socket)
+                this.socket = null;
+            if (!this.closed)
+                this.schedule();
+        });
+    }
+    schedule() {
+        if (this.timer || this.closed)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.connect();
+        }, this.opts.reconnectMs);
+    }
+    /** One line of the stream. Exposed for tests. */
+    forward(line) {
+        const text = line.trim();
+        if (!text)
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            this.opts.debug(`stream: not JSON: ${text.slice(0, 80)}`);
+            return;
+        }
+        const delta = strip(parsed);
+        if (!delta)
+            return;
+        try {
+            this.app.handleMessage(this.opts.pluginId, delta);
+            this._deltas++;
+            for (const u of delta.updates ?? []) {
+                this._values += ('values' in u ? u.values.length : 0) + ('meta' in u ? u.meta.length : 0);
+            }
+        }
+        catch (err) {
+            this.opts.debug(`handleMessage failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+/**
+ * The delta with `$source` and `timestamp` removed from every update, or
+ * null when it is not a delta with updates.
+ */
+export function strip(parsed) {
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const root = parsed;
+    if (!Array.isArray(root.updates))
+        return null;
+    const updates = [];
+    for (const u of root.updates) {
+        if (!u || typeof u !== 'object')
+            continue;
+        const { $source: _s, timestamp: _t, ...rest } = u;
+        if (!Array.isArray(rest.values) && !Array.isArray(rest.meta))
+            continue;
+        updates.push(rest);
+    }
+    if (updates.length === 0)
+        return null;
+    return { updates };
+}
+//# sourceMappingURL=stream-forwarder.js.map