signalk-masterbus 0.1.0

package/plugin/config.d.ts

@@ -0,0 +1,146 @@
+/**
+ * The plugin's configuration: the JSON Schema the admin UI renders, the
+ * matching TypeScript type, and the defaults.
+ *
+ * Signal K does not seed schema defaults into the runtime config: when the
+ * plugin is enabled without the form being saved, `start()` receives `{}`.
+ * `withDefaults` fills the gaps so the rest of the plugin can rely on every
+ * field being present.
+ */
+export type Mode = 'bundled' | 'external';
+export type Transport = 'auto' | 'can' | 'usb';
+export interface BundledConfig {
+    /** `auto` lets the daemon detect a USB link or the lone CAN interface. */
+    transport: Transport;
+    /** CAN interface name, or USB-link serial (blank = first). */
+    deviceName: string;
+    /** 24-bit hex id to announce as bus master, or blank to stay passive. */
+    heartbeatMaster: string;
+    apiPort: number;
+    streamPort: number;
+    /** A `masterbus-signalk` binary to run instead of the bundled one. */
+    binaryPath: string;
+}
+export interface ExternalConfig {
+    host: string;
+    apiPort: number;
+    streamPort: number;
+    token: string;
+}
+export interface Config {
+    mode: Mode;
+    bundled: BundledConfig;
+    external: ExternalConfig;
+    /** Mastervolt installer code, for writes to fields that need a login. */
+    installerCode: number | null;
+}
+export declare const DEFAULTS: Config;
+/** The configuration with every missing field filled from `DEFAULTS`. */
+export declare function withDefaults(config: unknown): Config;
+export declare const SCHEMA: {
+    type: string;
+    properties: {
+        mode: {
+            type: string;
+            title: string;
+            description: string;
+            enum: string[];
+            enumNames: string[];
+            default: string;
+        };
+        bundled: {
+            type: string;
+            title: string;
+            properties: {
+                transport: {
+                    type: string;
+                    title: string;
+                    description: string;
+                    enum: string[];
+                    enumNames: string[];
+                    default: string;
+                };
+                deviceName: {
+                    type: string;
+                    title: string;
+                    description: string;
+                    default: string;
+                };
+                heartbeatMaster: {
+                    type: string;
+                    title: string;
+                    description: string;
+                    default: string;
+                };
+                apiPort: {
+                    type: string;
+                    title: string;
+                    default: number;
+                    minimum: number;
+                    maximum: number;
+                };
+                streamPort: {
+                    type: string;
+                    title: string;
+                    default: number;
+                    minimum: number;
+                    maximum: number;
+                };
+                binaryPath: {
+                    type: string;
+                    title: string;
+                    description: string;
+                    default: string;
+                };
+            };
+        };
+        external: {
+            type: string;
+            title: string;
+            properties: {
+                host: {
+                    type: string;
+                    title: string;
+                    default: string;
+                };
+                apiPort: {
+                    type: string;
+                    title: string;
+                    default: number;
+                    minimum: number;
+                    maximum: number;
+                };
+                streamPort: {
+                    type: string;
+                    title: string;
+                    default: number;
+                    minimum: number;
+                    maximum: number;
+                };
+                token: {
+                    type: string;
+                    title: string;
+                    description: string;
+                    default: string;
+                };
+            };
+        };
+        installerCode: {
+            type: string[];
+            title: string;
+            description: string;
+            default: null;
+        };
+    };
+};
+export declare const UI_SCHEMA: {
+    external: {
+        token: {
+            'ui:widget': string;
+        };
+    };
+    installerCode: {
+        'ui:widget': string;
+    };
+};
+//# sourceMappingURL=config.d.ts.map

package/plugin/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,UAAU,CAAA;AACzC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,SAAS,EAAE,SAAS,CAAA;IACpB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,aAAa,CAAA;IACtB,QAAQ,EAAE,cAAc,CAAA;IACxB,yEAAyE;IACzE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,eAAO,MAAM,QAAQ,EAAE,MAiBtB,CAAA;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAWpD;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGlB,CAAA;AAED,eAAO,MAAM,SAAS;;;;;;;;;CAGrB,CAAA"}

package/plugin/config.js

@@ -0,0 +1,143 @@
+/**
+ * The plugin's configuration: the JSON Schema the admin UI renders, the
+ * matching TypeScript type, and the defaults.
+ *
+ * Signal K does not seed schema defaults into the runtime config: when the
+ * plugin is enabled without the form being saved, `start()` receives `{}`.
+ * `withDefaults` fills the gaps so the rest of the plugin can rely on every
+ * field being present.
+ */
+export const DEFAULTS = {
+    mode: 'bundled',
+    bundled: {
+        transport: 'auto',
+        deviceName: '',
+        heartbeatMaster: '',
+        apiPort: 3010,
+        streamPort: 3009,
+        binaryPath: ''
+    },
+    external: {
+        host: 'localhost',
+        apiPort: 3010,
+        streamPort: 3009,
+        token: ''
+    },
+    installerCode: null
+};
+/** The configuration with every missing field filled from `DEFAULTS`. */
+export function withDefaults(config) {
+    const c = (config ?? {});
+    return {
+        mode: c.mode === 'external' ? 'external' : 'bundled',
+        bundled: { ...DEFAULTS.bundled, ...(c.bundled ?? {}) },
+        external: { ...DEFAULTS.external, ...(c.external ?? {}) },
+        installerCode: typeof c.installerCode === 'number' && Number.isFinite(c.installerCode)
+            ? c.installerCode
+            : null
+    };
+}
+export const SCHEMA = {
+    type: 'object',
+    properties: {
+        mode: {
+            type: 'string',
+            title: 'Where the MasterBus daemon runs',
+            description: 'Bundled: this plugin starts masterbus-signalk on this machine, which must be the one ' +
+                'wired to the bus (CAN adapter or Mastervolt USB link). External: connect to a ' +
+                'masterbus-signalk already running elsewhere, with its API enabled.',
+            enum: ['bundled', 'external'],
+            enumNames: ['Bundled (run it here)', 'External (connect to one)'],
+            default: 'bundled'
+        },
+        bundled: {
+            type: 'object',
+            title: 'Bundled daemon',
+            properties: {
+                transport: {
+                    type: 'string',
+                    title: 'Transport',
+                    description: 'Auto picks a plugged-in Mastervolt USB link, else the only CAN interface. Set it ' +
+                        'explicitly when the machine has several.',
+                    enum: ['auto', 'can', 'usb'],
+                    enumNames: ['Auto-detect', 'SocketCAN (Linux)', 'Mastervolt USB link'],
+                    default: 'auto'
+                },
+                deviceName: {
+                    type: 'string',
+                    title: 'Device',
+                    description: 'CAN interface (e.g. can0), or the USB link serial number (blank = first).',
+                    default: ''
+                },
+                heartbeatMaster: {
+                    type: 'string',
+                    title: 'Act as bus master (hex id)',
+                    description: 'A 24-bit hex id, e.g. 000001, makes the daemon send master heartbeats so devices ' +
+                        'stay responsive on a bus without an EasyView or other master. Leave blank to stay ' +
+                        'passive.',
+                    default: ''
+                },
+                apiPort: {
+                    type: 'integer',
+                    title: 'API port (loopback)',
+                    default: 3010,
+                    minimum: 1,
+                    maximum: 65535
+                },
+                streamPort: {
+                    type: 'integer',
+                    title: 'Stream port (loopback)',
+                    default: 3009,
+                    minimum: 1,
+                    maximum: 65535
+                },
+                binaryPath: {
+                    type: 'string',
+                    title: 'masterbus-signalk binary (advanced)',
+                    description: 'Leave blank to use the binary bundled with this plugin. A path here runs that ' +
+                        'instead, e.g. a development build.',
+                    default: ''
+                }
+            }
+        },
+        external: {
+            type: 'object',
+            title: 'External daemon',
+            properties: {
+                host: { type: 'string', title: 'Host', default: 'localhost' },
+                apiPort: {
+                    type: 'integer',
+                    title: 'API port',
+                    default: 3010,
+                    minimum: 1,
+                    maximum: 65535
+                },
+                streamPort: {
+                    type: 'integer',
+                    title: 'Stream port',
+                    default: 3009,
+                    minimum: 1,
+                    maximum: 65535
+                },
+                token: {
+                    type: 'string',
+                    title: 'API token',
+                    description: "The daemon's api_token from its config.ini.",
+                    default: ''
+                }
+            }
+        },
+        installerCode: {
+            type: ['number', 'null'],
+            title: 'Installer code',
+            description: 'The Mastervolt installer access code. Only needed for writes to fields that are ' +
+                'read-only at user level; leave blank otherwise.',
+            default: null
+        }
+    }
+};
+export const UI_SCHEMA = {
+    external: { token: { 'ui:widget': 'password' } },
+    installerCode: { 'ui:widget': 'password' }
+};
+//# sourceMappingURL=config.js.map

package/plugin/config.js.map

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

package/plugin/daemon.d.ts

@@ -0,0 +1,63 @@
+import type { BundledConfig } from './config.js';
+/** The directory under `bin/` that carries this platform's daemon. */
+export declare function platformDir(platform?: string, arch?: string): string;
+/**
+ * Where the daemon binary is: the configured path if any, else the bundled
+ * one under `bin/<os>-<arch>/` next to `plugin/` (put there by
+ * `scripts/fetch-daemons.mjs` before publishing). Throws with a message fit
+ * for the plugin status when neither exists.
+ */
+export declare function resolveBinary(binaryPath: string, from?: string): string;
+/**
+ * The `config.ini` the daemon reads, rendered from the plugin's settings.
+ * With transport `auto` and a file already present, the file is left alone:
+ * the daemon auto-detected it on first run and the user may have edited it.
+ * Ports and the API address are always ours, so those keys are rewritten.
+ */
+export declare function renderConfigIni(cfg: BundledConfig, existing: string | null): string | null;
+export interface DaemonEvents {
+    /** A line of the daemon's stderr. */
+    log(line: string): void;
+    /** The daemon exited; `restartIn` is null when it will not be restarted. */
+    exited(code: number | null, signal: string | null, restartIn: number | null): void;
+    /** The daemon is up again after a restart. */
+    ready(): void;
+}
+export interface DaemonOptions {
+    binary: string;
+    /** Where config.ini, mapping.json and the schema cache live. */
+    dataDir: string;
+    config: BundledConfig;
+    events: DaemonEvents;
+    /** Extra arguments, e.g. `['--fake-bus']` in tests. */
+    extraArgs?: string[];
+    /** How long to wait for READY before giving up, ms. */
+    readyTimeoutMs?: number;
+}
+/**
+ * Runs `masterbus-signalk` as a child process: renders its config and token,
+ * spawns it with `--config-dir`, waits for the `READY` line, and restarts
+ * it with backoff if it exits. `stop()` ends it for good.
+ */
+export declare class DaemonManager {
+    readonly token: string;
+    private readonly opts;
+    private child;
+    private stopping;
+    private restartTimer;
+    private backoffMs;
+    private readonly recent;
+    private generation;
+    constructor(opts: DaemonOptions);
+    /** The last lines the daemon wrote to stderr, for an error status. */
+    get recentLog(): string[];
+    get running(): boolean;
+    /** Start the daemon and resolve once it reports READY. */
+    start(): Promise<void>;
+    private spawnOnce;
+    private readyTimeout;
+    /** Stop the daemon: SIGTERM, then SIGKILL after a grace period. */
+    stop(graceMs?: number): Promise<void>;
+}
+export declare function errMsg(err: unknown): string;
+//# sourceMappingURL=daemon.d.ts.map

package/plugin/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,sEAAsE;AACtE,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAyB,EACnC,IAAI,GAAE,MAAqB,GAC1B,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAwB,GAAG,MAAM,CAgBxF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA6B1F;AAED,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAClF,8CAA8C;IAC9C,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,YAAY,CAAA;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAID;;;;GAIG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,UAAU,CAAI;gBAEV,IAAI,EAAE,aAAa;IAK/B,sEAAsE;IACtE,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,0DAA0D;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,OAAO,CAAC,SAAS;IAsFjB,OAAO,CAAC,YAAY;IAIpB,mEAAmE;IAC7D,IAAI,CAAC,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAqB1C;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE3C"}

package/plugin/daemon.js

@@ -0,0 +1,223 @@
+import { spawn } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+/** The directory under `bin/` that carries this platform's daemon. */
+export function platformDir(platform = process.platform, arch = process.arch) {
+    return `${platform}-${arch}`;
+}
+/**
+ * Where the daemon binary is: the configured path if any, else the bundled
+ * one under `bin/<os>-<arch>/` next to `plugin/` (put there by
+ * `scripts/fetch-daemons.mjs` before publishing). Throws with a message fit
+ * for the plugin status when neither exists.
+ */
+export function resolveBinary(binaryPath, from = import.meta.url) {
+    if (binaryPath.trim()) {
+        const p = binaryPath.trim();
+        if (!fs.existsSync(p))
+            throw new Error(`the configured binary ${p} does not exist`);
+        return p;
+    }
+    const exe = process.platform === 'win32' ? 'masterbus-signalk.exe' : 'masterbus-signalk';
+    const root = path.resolve(path.dirname(fileURLToPath(from)), '..');
+    const bin = path.join(root, 'bin', platformDir(), exe);
+    if (!fs.existsSync(bin)) {
+        throw new Error(`no bundled daemon for ${platformDir()} (${bin} is missing; in a development checkout ` +
+            'run `npm run fetch-daemons`); set a binary path, or use external mode');
+    }
+    return bin;
+}
+/**
+ * The `config.ini` the daemon reads, rendered from the plugin's settings.
+ * With transport `auto` and a file already present, the file is left alone:
+ * the daemon auto-detected it on first run and the user may have edited it.
+ * Ports and the API address are always ours, so those keys are rewritten.
+ */
+export function renderConfigIni(cfg, existing) {
+    const ownKeys = ['listen', 'api_listen', 'api_token'];
+    const managed = (body) => body
+        .split('\n')
+        .filter((line) => {
+        const key = line.split('=')[0]?.trim().replace(/^#\s*/, '');
+        return !(key && ownKeys.includes(key));
+    })
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trimEnd();
+    const ours = `\n# Managed by the Signal K plugin (signalk-masterbus); edit ports there.\n` +
+        `listen = 127.0.0.1:${cfg.streamPort}\n` +
+        `api_listen = 127.0.0.1:${cfg.apiPort}\n`;
+    if (cfg.transport === 'auto') {
+        if (existing === null)
+            return null; // let the daemon auto-detect and write it
+        return `${managed(existing)}\n${ours}`;
+    }
+    const hb = cfg.heartbeatMaster.trim();
+    return ('# masterbus configuration, written by the Signal K plugin (signalk-masterbus).\n' +
+        '# Transport, device and master role are edited in the plugin settings.\n' +
+        (hb ? `heartbeat_master = ${hb}\n` : '# heartbeat_master = 000001\n') +
+        `device_type = ${cfg.transport}\n` +
+        `device_name = ${cfg.deviceName.trim()}\n` +
+        ours);
+}
+const KEEP_LINES = 40;
+/**
+ * Runs `masterbus-signalk` as a child process: renders its config and token,
+ * spawns it with `--config-dir`, waits for the `READY` line, and restarts
+ * it with backoff if it exits. `stop()` ends it for good.
+ */
+export class DaemonManager {
+    token;
+    opts;
+    child = null;
+    stopping = false;
+    restartTimer = null;
+    backoffMs = 1000;
+    recent = [];
+    generation = 0;
+    constructor(opts) {
+        this.opts = opts;
+        this.token = randomBytes(24).toString('hex');
+    }
+    /** The last lines the daemon wrote to stderr, for an error status. */
+    get recentLog() {
+        return [...this.recent];
+    }
+    get running() {
+        return this.child !== null && this.child.exitCode === null && !this.child.killed;
+    }
+    /** Start the daemon and resolve once it reports READY. */
+    async start() {
+        this.stopping = false;
+        fs.mkdirSync(this.opts.dataDir, { recursive: true });
+        const ini = path.join(this.opts.dataDir, 'config.ini');
+        const existing = fs.existsSync(ini) ? fs.readFileSync(ini, 'utf8') : null;
+        const rendered = renderConfigIni(this.opts.config, existing);
+        if (rendered !== null && rendered !== existing)
+            fs.writeFileSync(ini, rendered);
+        const tokenFile = path.join(this.opts.dataDir, 'api-token');
+        fs.writeFileSync(tokenFile, this.token, { mode: 0o600 });
+        await this.spawnOnce(tokenFile);
+    }
+    spawnOnce(tokenFile) {
+        const generation = ++this.generation;
+        const { config } = this.opts;
+        const args = [
+            '--config-dir',
+            this.opts.dataDir,
+            '--stream',
+            `127.0.0.1:${config.streamPort}`,
+            '--api',
+            `127.0.0.1:${config.apiPort}`,
+            '--api-token-file',
+            tokenFile,
+            ...(this.opts.extraArgs ?? [])
+        ];
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const child = spawn(this.opts.binary, args, {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                env: { ...process.env, RUST_LOG: process.env.RUST_LOG ?? 'warn' }
+            });
+            this.child = child;
+            const timeout = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(new Error(`the daemon did not report READY within ${this.readyTimeout() / 1000} s`));
+            }, this.readyTimeout());
+            // Both pipes exist: stdio is ['ignore', 'pipe', 'pipe'] above.
+            readline
+                .createInterface({ input: child.stdout })
+                .on('line', (line) => {
+                if (line.startsWith('READY')) {
+                    this.backoffMs = 1000;
+                    if (!settled) {
+                        settled = true;
+                        clearTimeout(timeout);
+                        resolve();
+                    }
+                    else {
+                        this.opts.events.ready();
+                    }
+                }
+            });
+            readline
+                .createInterface({ input: child.stderr })
+                .on('line', (line) => {
+                this.recent.push(line);
+                if (this.recent.length > KEEP_LINES)
+                    this.recent.shift();
+                this.opts.events.log(line);
+            });
+            child.on('error', (err) => {
+                this.recent.push(`spawn: ${err.message}`);
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    reject(err);
+                }
+            });
+            child.on('exit', (code, signal) => {
+                if (generation !== this.generation) {
+                    // Superseded by stop() or a later start(): report, never restart.
+                    this.opts.events.exited(code, signal, null);
+                    return;
+                }
+                this.child = null;
+                const restartIn = this.stopping ? null : this.backoffMs;
+                this.opts.events.exited(code, signal, restartIn);
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timeout);
+                    reject(new Error(`the daemon exited with ${code ?? signal ?? 'no status'} before READY`));
+                    return;
+                }
+                if (restartIn !== null) {
+                    this.restartTimer = setTimeout(() => {
+                        this.restartTimer = null;
+                        if (this.stopping)
+                            return;
+                        this.spawnOnce(tokenFile).catch((err) => {
+                            this.opts.events.log(`restart failed: ${errMsg(err)}`);
+                        });
+                    }, restartIn);
+                    this.backoffMs = Math.min(this.backoffMs * 2, 60_000);
+                }
+            });
+        });
+    }
+    readyTimeout() {
+        return this.opts.readyTimeoutMs ?? 30_000;
+    }
+    /** Stop the daemon: SIGTERM, then SIGKILL after a grace period. */
+    async stop(graceMs = 5000) {
+        this.stopping = true;
+        this.generation++;
+        if (this.restartTimer) {
+            clearTimeout(this.restartTimer);
+            this.restartTimer = null;
+        }
+        const child = this.child;
+        this.child = null;
+        if (!child || child.exitCode !== null)
+            return;
+        await new Promise((resolve) => {
+            const killer = setTimeout(() => {
+                child.kill('SIGKILL');
+            }, graceMs);
+            child.once('exit', () => {
+                clearTimeout(killer);
+                resolve();
+            });
+            child.kill('SIGTERM');
+        });
+    }
+}
+export function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=daemon.js.map

package/plugin/daemon.js.map

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

package/plugin/index.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin, ServerAPI } from '@signalk/server-api';
+export declare const PLUGIN_ID = "signalk-masterbus";
+/**
+ * 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: ServerAPI): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAgB,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAU1E,eAAO,MAAM,SAAS,sBAAsB,CAAA;AAK5C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CA2LrD"}