signalk-backup 0.1.0

package/plugin/config/schema.js

@@ -0,0 +1,83 @@
+import { Type } from '@sinclair/typebox';
+/**
+ * Schema for the SignalK Admin UI plugin config form.
+ *
+ * Most user-facing settings (schedule, retention, cloud sync, exclusions)
+ * live inside the backup-server container's own UI — open it via the
+ * "Open Backup Console" link from /plugins/signalk-backup/. The fields
+ * below are only the per-deployment knobs the SignalK admin needs.
+ */
+export const ConfigSchema = Type.Object({
+    managedContainer: Type.Boolean({
+        default: true,
+        title: 'Manage backup container via signalk-container',
+        description: 'When enabled (default), the plugin pulls and runs ghcr.io/dirkwa/signalk-backup-server. ' +
+            'Disable to point at an external backup-server instance via "External URL".'
+    }),
+    imageTag: Type.String({
+        default: 'latest',
+        title: 'Container image tag',
+        description: 'Pin to a specific version (e.g. "0.1.0") or use a floating tag (e.g. "latest").'
+    }),
+    externalUrl: Type.String({
+        default: '',
+        title: 'External backup-server URL',
+        description: 'Used only when managedContainer is disabled. e.g. http://192.168.1.50:3010. ' +
+            'Leave blank when managing the container.'
+    }),
+    logLevel: Type.Union([
+        Type.Literal('trace'),
+        Type.Literal('debug'),
+        Type.Literal('info'),
+        Type.Literal('warn'),
+        Type.Literal('error'),
+        Type.Literal('fatal')
+    ], {
+        default: 'info',
+        title: 'Log level',
+        description: 'Forwarded to the backup-server container as LOG_LEVEL.'
+    }),
+    databaseExport: Type.Object({
+        questdb: Type.Boolean({
+            default: false,
+            title: 'Export QuestDB to backup',
+            description: 'When enabled, the plugin periodically writes QuestDB tables to Parquet files ' +
+                'inside the backup data dir. The next snapshot then captures them as part of ' +
+                'the regular backup. Filesystem-level QuestDB files are still excluded — only ' +
+                'the safe COPY-out exports travel.'
+        }),
+        intervalMinutes: Type.Number({
+            default: 60,
+            minimum: 5,
+            maximum: 1440,
+            title: 'Export interval (minutes)',
+            description: 'How often the plugin runs database exports. The freshness of DB data inside ' +
+                'a backup is bounded by max(this interval, the backup-server snapshot interval). ' +
+                'Default 60.'
+        })
+    }, {
+        default: { questdb: false, intervalMinutes: 60 },
+        title: 'Database export'
+    })
+});
+/**
+ * Materialised defaults — Signal K only uses the schema's `default` fields
+ * to seed the Admin UI form, NOT to inject defaults into the runtime config
+ * object passed to `plugin.start()`. When the plugin is auto-enabled
+ * (signalk-plugin-enabled-by-default) or enabled without saving the form,
+ * start() receives `{}`. Spread SCHEMA_DEFAULTS in start() so every field
+ * is present at runtime.
+ *
+ * See AGENTS.md §"Plugin-specific gotchas".
+ */
+export const SCHEMA_DEFAULTS = {
+    managedContainer: true,
+    imageTag: 'latest',
+    externalUrl: '',
+    logLevel: 'info',
+    databaseExport: {
+        questdb: false,
+        intervalMinutes: 60
+    }
+};
+//# sourceMappingURL=schema.js.map

package/plugin/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAU,MAAM,mBAAmB,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;IACtC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC;QAC7B,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,+CAA+C;QACtD,WAAW,EACT,0FAA0F;YAC1F,4EAA4E;KAC/E,CAAC;IACF,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,iFAAiF;KAC/F,CAAC;IACF,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,8EAA8E;YAC9E,0CAA0C;KAC7C,CAAC;IACF,QAAQ,EAAE,IAAI,CAAC,KAAK,CAClB;QACE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;KACtB,EACD;QACE,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,wDAAwD;KACtE,CACF;IACD,cAAc,EAAE,IAAI,CAAC,MAAM,CACzB;QACE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC;YACpB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,0BAA0B;YACjC,WAAW,EACT,+EAA+E;gBAC/E,8EAA8E;gBAC9E,+EAA+E;gBAC/E,mCAAmC;SACtC,CAAC;QACF,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC;YAC3B,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,2BAA2B;YAClC,WAAW,EACT,8EAA8E;gBAC9E,kFAAkF;gBAClF,aAAa;SAChB,CAAC;KACH,EACD;QACE,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE;QAChD,KAAK,EAAE,iBAAiB;KACzB,CACF;CACF,CAAC,CAAA;AAIF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,gBAAgB,EAAE,IAAI;IACtB,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,MAAM;IAChB,cAAc,EAAE;QACd,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,EAAE;KACpB;CACF,CAAA"}

package/plugin/database-export/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Database export orchestrator.
+ *
+ * Plugin-side counterpart to docs/v0.2-database-backup-design.md. The
+ * exporter pulls data via the source plugin's HTTP route on the SignalK
+ * server itself — no container exec or shared filesystems involved.
+ *
+ * Currently supports QuestDB only. InfluxDB is intentionally out of
+ * scope (see design doc).
+ */
+import type { ExportResult } from './types.js';
+export interface ExportOrchestratorOptions {
+    /** Host-visible path to the SignalK config root. */
+    signalkConfigRoot: string;
+    /** SignalK server base URL (loopback) — used to talk to source plugins. */
+    signalkBaseUrl: string;
+    /** Optional debug logger. */
+    log?: (msg: string) => void;
+}
+/**
+ * Run every supported exporter whose `detect()` returns true. Each
+ * exporter writes its parquet files under
+ *   <configRoot>/plugin-config-data/signalk-backup/database-exports/<pluginId>/
+ * which is the staging area kopia will pick up on the next snapshot.
+ *
+ * Errors in one exporter are logged but don't abort the rest — partial
+ * coverage is preferable to none. The returned array contains one
+ * ExportResult per exporter that ran (regardless of success).
+ */
+export declare function runAllExports(opts: ExportOrchestratorOptions): Promise<ExportResult[]>;
+export type { DatabaseExporter, ExportResult, TableExport } from './types.js';
+export { QuestDBExporter } from './questdb.js';
+//# sourceMappingURL=index.d.ts.map

package/plugin/database-export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database-export/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAoB,YAAY,EAAE,MAAM,YAAY,CAAA;AAKhE,MAAM,WAAW,yBAAyB;IACxC,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAA;IACzB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAA;IACtB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgC5F;AAED,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/plugin/database-export/index.js

@@ -0,0 +1,55 @@
+/**
+ * Database export orchestrator.
+ *
+ * Plugin-side counterpart to docs/v0.2-database-backup-design.md. The
+ * exporter pulls data via the source plugin's HTTP route on the SignalK
+ * server itself — no container exec or shared filesystems involved.
+ *
+ * Currently supports QuestDB only. InfluxDB is intentionally out of
+ * scope (see design doc).
+ */
+import { mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { QuestDBExporter } from './questdb.js';
+const PLUGIN_ID = 'signalk-backup';
+const STAGING_SUBDIR = 'database-exports';
+/**
+ * Run every supported exporter whose `detect()` returns true. Each
+ * exporter writes its parquet files under
+ *   <configRoot>/plugin-config-data/signalk-backup/database-exports/<pluginId>/
+ * which is the staging area kopia will pick up on the next snapshot.
+ *
+ * Errors in one exporter are logged but don't abort the rest — partial
+ * coverage is preferable to none. The returned array contains one
+ * ExportResult per exporter that ran (regardless of success).
+ */
+export async function runAllExports(opts) {
+    const stagingRoot = join(opts.signalkConfigRoot, 'plugin-config-data', PLUGIN_ID, STAGING_SUBDIR);
+    await mkdir(stagingRoot, { recursive: true });
+    const exporters = [
+        new QuestDBExporter({
+            signalkBaseUrl: opts.signalkBaseUrl,
+            log: opts.log
+        })
+    ];
+    const results = [];
+    for (const exporter of exporters) {
+        if (!(await exporter.detect())) {
+            opts.log?.(`[db-export] skipping ${exporter.pluginId} (detect failed)`);
+            continue;
+        }
+        const stagingDir = join(stagingRoot, exporter.pluginId);
+        try {
+            const r = await exporter.exportAll(stagingDir);
+            results.push(r);
+            opts.log?.(`[db-export] ${exporter.pluginId}: ${r.tables.length} tables, ` +
+                `${r.totalBytes} bytes, ${r.durationMs}ms`);
+        }
+        catch (err) {
+            opts.log?.(`[db-export] ${exporter.pluginId} failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return results;
+}
+export { QuestDBExporter } from './questdb.js';
+//# sourceMappingURL=index.js.map

package/plugin/database-export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database-export/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C,MAAM,SAAS,GAAG,gBAAgB,CAAA;AAClC,MAAM,cAAc,GAAG,kBAAkB,CAAA;AAWzC;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA+B;IACjE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,SAAS,EAAE,cAAc,CAAC,CAAA;IACjG,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE7C,MAAM,SAAS,GAAuB;QACpC,IAAI,eAAe,CAAC;YAClB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;KACH,CAAA;IAED,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,wBAAwB,QAAQ,CAAC,QAAQ,kBAAkB,CAAC,CAAA;YACvE,SAAQ;QACV,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACvD,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACf,IAAI,CAAC,GAAG,EAAE,CACR,eAAe,QAAQ,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,WAAW;gBAC7D,GAAG,CAAC,CAAC,UAAU,WAAW,CAAC,CAAC,UAAU,IAAI,CAC7C,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,EAAE,CACR,eAAe,QAAQ,CAAC,QAAQ,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC/F,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA"}

package/plugin/database-export/questdb.d.ts

@@ -0,0 +1,41 @@
+/**
+ * QuestDB exporter — pulls data via signalk-questdb's HTTP route.
+ *
+ * The signalk-questdb plugin exposes:
+ *   GET /plugins/signalk-questdb/api/full-export/tables → { tables: [...] }
+ *   GET /plugins/signalk-questdb/api/full-export/<table>  → parquet stream
+ *
+ * Both are served by SignalK in-process, so we reach them via plain HTTP
+ * over loopback. No container exec, no shared filesystem ownership
+ * issues, no copy-completion polling.
+ *
+ * Streams the response body directly to a temp file in the staging dir,
+ * then atomically renames into place — so a snapshot mid-export never
+ * sees a half-written parquet.
+ */
+import type { DatabaseExporter, ExportResult } from './types.js';
+export interface QuestDBExporterOptions {
+    /** SignalK server base URL — typically http://127.0.0.1:3000 */
+    signalkBaseUrl?: string;
+    /** Optional debug logger. */
+    log?: (msg: string) => void;
+    /** Override fetch (tests). */
+    fetch?: typeof fetch;
+}
+export declare class QuestDBExporter implements DatabaseExporter {
+    readonly pluginId = "signalk-questdb";
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(opts?: QuestDBExporterOptions);
+    private readonly log;
+    /**
+     * Detect: hit the tables endpoint. Returns true on HTTP 200 with at
+     * least one table; false on any error or 503/404 (plugin disabled or
+     * not loaded).
+     */
+    detect(): Promise<boolean>;
+    exportAll(stagingDir: string): Promise<ExportResult>;
+    private listTables;
+    private exportTable;
+}
+//# sourceMappingURL=questdb.d.ts.map

package/plugin/database-export/questdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questdb.d.ts","sourceRoot":"","sources":["../../src/database-export/questdb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAe,MAAM,YAAY,CAAA;AAW7E,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,QAAQ,CAAC,QAAQ,qBAAoB;IAErC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAE5B,IAAI,GAAE,sBAA2B;IAM7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAE3C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAU1B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAiC5C,UAAU;YAmBV,WAAW;CAuC1B"}

package/plugin/database-export/questdb.js

@@ -0,0 +1,143 @@
+/**
+ * QuestDB exporter — pulls data via signalk-questdb's HTTP route.
+ *
+ * The signalk-questdb plugin exposes:
+ *   GET /plugins/signalk-questdb/api/full-export/tables → { tables: [...] }
+ *   GET /plugins/signalk-questdb/api/full-export/<table>  → parquet stream
+ *
+ * Both are served by SignalK in-process, so we reach them via plain HTTP
+ * over loopback. No container exec, no shared filesystem ownership
+ * issues, no copy-completion polling.
+ *
+ * Streams the response body directly to a temp file in the staging dir,
+ * then atomically renames into place — so a snapshot mid-export never
+ * sees a half-written parquet.
+ */
+import { mkdir, rename, unlink } from 'node:fs/promises';
+import { createWriteStream } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+import { join } from 'node:path';
+const QUESTDB_PLUGIN_ID = 'signalk-questdb';
+/** Default base URL — overridable for tests. SignalK normally listens here. */
+const DEFAULT_SIGNALK_BASE = 'http://127.0.0.1:3000';
+/** Per-request timeout. A full-table export of ~500k rows runs in <1s on
+ *  a Pi over the loopback HTTP path, but pipe between pi-host-network +
+ *  pasta containers can stall — bound at 10 minutes. */
+const FETCH_TIMEOUT_MS = 600_000;
+const SAFE_TABLE_NAME = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+export class QuestDBExporter {
+    pluginId = QUESTDB_PLUGIN_ID;
+    baseUrl;
+    fetchImpl;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.signalkBaseUrl ?? DEFAULT_SIGNALK_BASE).replace(/\/$/, '');
+        this.fetchImpl = opts.fetch ?? fetch;
+        this.log = (msg) => opts.log?.(`[questdb-export] ${msg}`);
+    }
+    log;
+    /**
+     * Detect: hit the tables endpoint. Returns true on HTTP 200 with at
+     * least one table; false on any error or 503/404 (plugin disabled or
+     * not loaded).
+     */
+    async detect() {
+        try {
+            const tables = await this.listTables();
+            return tables.length > 0;
+        }
+        catch (err) {
+            this.log(`detect failed: ${errMsg(err)}`);
+            return false;
+        }
+    }
+    async exportAll(stagingDir) {
+        const startedAt = Date.now();
+        await mkdir(stagingDir, { recursive: true });
+        const tables = await this.listTables();
+        const exports = [];
+        for (const table of tables) {
+            // Defence in depth — the route should reject these too, but a
+            // malformed name in the request URL is worth catching here.
+            if (!SAFE_TABLE_NAME.test(table)) {
+                this.log(`refusing unsafe table identifier: ${table}`);
+                continue;
+            }
+            try {
+                exports.push(await this.exportTable(table, stagingDir));
+            }
+            catch (err) {
+                // Partial coverage > none. Log and keep going.
+                this.log(`export failed for ${table}: ${errMsg(err)}`);
+            }
+        }
+        return {
+            pluginId: this.pluginId,
+            tables: exports,
+            totalBytes: exports.reduce((acc, t) => acc + t.bytes, 0),
+            durationMs: Date.now() - startedAt
+        };
+    }
+    // ---------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------
+    async listTables() {
+        const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/tables`;
+        const res = await this.fetchImpl(url, {
+            signal: AbortSignal.timeout(10_000)
+        });
+        if (!res.ok) {
+            throw new Error(`tables HTTP ${res.status}: ${(await res.text()).slice(0, 200)}`);
+        }
+        const body = (await res.json());
+        if (!Array.isArray(body.tables)) {
+            throw new Error(`tables response missing 'tables' array`);
+        }
+        const out = [];
+        for (const t of body.tables) {
+            if (typeof t === 'string')
+                out.push(t);
+        }
+        return out;
+    }
+    async exportTable(table, stagingDir) {
+        const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/${table}`;
+        const finalPath = join(stagingDir, `${table}.parquet`);
+        const tempPath = `${finalPath}.partial`;
+        this.log(`exporting ${table}`);
+        const res = await this.fetchImpl(url, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+        });
+        if (!res.ok || !res.body) {
+            throw new Error(`HTTP ${res.status}: ${(await res.text().catch(() => '')).slice(0, 200)}`);
+        }
+        // Stream the response body to a temp file, then atomic-rename. This
+        // means a kopia snapshot that races us mid-export sees either the
+        // previous .parquet or no entry — never a torn write.
+        const out = createWriteStream(tempPath);
+        let bytes = 0;
+        out.on('drain', () => undefined);
+        // Count bytes via a tap — pipeline doesn't expose them otherwise.
+        const reader = Readable.fromWeb(res.body);
+        reader.on('data', (chunk) => {
+            bytes += chunk.length;
+        });
+        try {
+            await pipeline(reader, out);
+        }
+        catch (err) {
+            // Best-effort cleanup of partial file.
+            await unlink(tempPath).catch(() => undefined);
+            throw err;
+        }
+        await rename(tempPath, finalPath);
+        // rowCount is unknown without a separate query; leaving 0 keeps the
+        // shape stable. Bytes carries the meaningful "what got captured".
+        this.log(`exported ${table}: ${bytes} bytes`);
+        return { table, parquetPath: finalPath, rowCount: 0, bytes };
+    }
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=questdb.js.map

package/plugin/database-export/questdb.js.map

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

package/plugin/database-export/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Common types for database exporters.
+ *
+ * Each exporter targets ONE database plugin (signalk-questdb, etc.) and
+ * produces one parquet file per table. Files land in a staging directory
+ * inside the SignalK config root so kopia picks them up automatically as
+ * part of the next snapshot — there's no separate "upload" step.
+ */
+export interface TableExport {
+    table: string;
+    /** Host-visible absolute path to the exported parquet file. */
+    parquetPath: string;
+    rowCount: number;
+    bytes: number;
+}
+export interface ExportResult {
+    /** The signalk plugin id whose data this represents (e.g. 'signalk-questdb'). */
+    pluginId: string;
+    tables: TableExport[];
+    totalBytes: number;
+    durationMs: number;
+}
+export interface DatabaseExporter {
+    readonly pluginId: string;
+    /** Probe — returns true if this exporter can run against the live system. */
+    detect(): Promise<boolean>;
+    /** Run a full export of every user table. Caller has already created stagingDir. */
+    exportAll(stagingDir: string): Promise<ExportResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/plugin/database-export/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/database-export/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6EAA6E;IAC7E,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1B,oFAAoF;IACpF,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACrD"}

package/plugin/database-export/types.js

@@ -0,0 +1,10 @@
+/**
+ * Common types for database exporters.
+ *
+ * Each exporter targets ONE database plugin (signalk-questdb, etc.) and
+ * produces one parquet file per table. Files land in a staging directory
+ * inside the SignalK config root so kopia picks them up automatically as
+ * part of the next snapshot — there's no separate "upload" step.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/plugin/database-export/types.js.map

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

package/plugin/index.d.ts

@@ -0,0 +1,4 @@
+import { Plugin } from '@signalk/server-api';
+import { BackupServerAPI } from './types.js';
+export default function (app: BackupServerAPI): 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":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAI5C,OAAO,EACL,eAAe,EAIhB,MAAM,YAAY,CAAA;AAqGnB,MAAM,CAAC,OAAO,WAAW,GAAG,EAAE,eAAe,GAAG,MAAM,CAqZrD"}