signalk-backup 0.3.0 → 0.5.0

package/README.md

@@ -10,6 +10,7 @@ The plugin is a thin shell: it asks [signalk-container](https://github.com/dirkw
 - **Cloud sync to Google Drive** — optional, opt-in. Uses rclone with `drive.file` scope (the app only sees files it created)
 - **Scheduled backups** — hourly / daily / weekly / on-startup tiers, each with independent retention
 - **Restore with safety backup** — every restore creates a snapshot of the current state first, so a botched restore can be rolled back automatically
+- **Database export pipeline** — opt-in exporters for [signalk-questdb](https://github.com/dirkwa/signalk-questdb), [signalk-grafana](https://github.com/dirkwa/signalk-grafana), and [signalk-database](https://github.com/dirkwa/signalk-database) periodically write consistent snapshots (parquet, SQLite checkpoint, provisioning YAML) to a staging dir that kopia includes in every snapshot. Live DB files are excluded from filesystem-level backup to avoid torn-write hazards; the export side is how DB state actually gets backed up. Manual backups run pending exports synchronously first.
 - **First-run safe default** — installs with a daily local-only schedule already seeded; no surprise data egress
 - **Update detection** — checks ghcr.io for new container images via signalk-container's centralized update service
 
@@ -50,6 +51,7 @@ Most configuration lives in the **Backup Console** (open it from the redirect, o
 - Repository password (Kopia encryption key)
 - Cloud sync mode (off / manual / daily / weekly)
 - Google Drive connection (one-click OAuth via `rclone authorize drive`)
+- Database export toggles (QuestDB, Grafana, signalk-database) and export interval
 - Snapshot browser, restore wizard
 
 The SignalK Admin UI plugin panel (small) handles only deployment-level settings:

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "signalk-backup",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Scheduled deduplicated backups of SignalK config to local storage and Google Drive (via Kopia + rclone)",
   "main": "plugin/index.js",
   "type": "module",
   "signalk-plugin-enabled-by-default": true,
   "scripts": {
-    "format": "prettier --write 'src/**/*.ts' 'test/**/*.ts' 'webapp/**/*.{ts,tsx,html}' && eslint --fix 'src/**/*.ts' 'test/**/*.ts' 'webapp/**/*.{ts,tsx}'",
-    "lint": "eslint 'src/**/*.ts' 'test/**/*.ts' 'webapp/**/*.{ts,tsx}'",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"webapp/**/*.{ts,tsx,html}\" && eslint --fix \"src/**/*.ts\" \"test/**/*.ts\" \"webapp/**/*.{ts,tsx}\"",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\" \"webapp/**/*.{ts,tsx}\"",
     "typecheck:webapp": "tsc -p tsconfig.webapp.json",
     "build:plugin": "tsc",
     "build:webapp": "vite build",

package/plugin/config/image-tag.d.ts

@@ -0,0 +1,3 @@
+export declare const PLUGIN_VERSION: string;
+export declare function resolveImageTag(tag: string): string;
+//# sourceMappingURL=image-tag.d.ts.map

package/plugin/config/image-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-tag.d.ts","sourceRoot":"","sources":["../../src/config/image-tag.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc,QAOvB,CAAA;AAGJ,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/plugin/config/image-tag.js

@@ -0,0 +1,16 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+// CI publishes signalk-backup-server:X.Y.Z in lockstep with this plugin's package.json version.
+export const PLUGIN_VERSION = (() => {
+    const pkgPath = fileURLToPath(new URL('../../package.json', import.meta.url));
+    const raw = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    if (typeof raw.version !== 'string') {
+        throw new Error('signalk-backup package.json has no version field');
+    }
+    return raw.version;
+})();
+// 'auto' resolves to PLUGIN_VERSION so the container tracks plugin upgrades; other tags pass through.
+export function resolveImageTag(tag) {
+    return tag === 'auto' ? PLUGIN_VERSION : tag;
+}
+//# sourceMappingURL=image-tag.js.map

package/plugin/config/image-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-tag.js","sourceRoot":"","sources":["../../src/config/image-tag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,gGAAgG;AAChG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE;IAClC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAA0B,CAAA;IAC/E,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAA;AACpB,CAAC,CAAC,EAAE,CAAA;AAEJ,sGAAsG;AACtG,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAA;AAC9C,CAAC"}

package/plugin/config/schema.d.ts

@@ -15,6 +15,8 @@ export declare const ConfigSchema: import("@sinclair/typebox").TObject<{
     externalUrl: import("@sinclair/typebox").TString;
     databaseExport: import("@sinclair/typebox").TObject<{
         questdb: import("@sinclair/typebox").TBoolean;
+        grafana: import("@sinclair/typebox").TBoolean;
+        signalkDatabase: import("@sinclair/typebox").TBoolean;
         intervalMinutes: import("@sinclair/typebox").TNumber;
     }>;
 }>;

package/plugin/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;;;;;;;EA6BvB,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAA;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,MAQ7B,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;EAwCvB,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,YAAY,CAAC,CAAA;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,MAU7B,CAAA"}

package/plugin/config/schema.js

@@ -17,9 +17,10 @@ export const ConfigSchema = Type.Object({
             'Disable to point at an external backup-server instance via "External URL".'
     }),
     imageTag: Type.String({
-        default: 'latest',
+        default: 'auto',
         title: 'Container image tag',
-        description: 'Pin to a specific version (e.g. "0.1.0") or use a floating tag (e.g. "latest").'
+        description: '"auto" (default) tracks the plugin version, so upgrading the plugin upgrades the container. ' +
+            'Pin to a specific version (e.g. "0.4.0") or use a floating tag (e.g. "latest") to override.'
     }),
     externalUrl: Type.String({
         default: '',
@@ -31,8 +32,17 @@ export const ConfigSchema = Type.Object({
     // form hides it via uiSchema in src/index.ts (webapp owns the UI).
     databaseExport: Type.Object({
         questdb: Type.Boolean({ default: false }),
+        grafana: Type.Boolean({ default: false }),
+        signalkDatabase: Type.Boolean({ default: false }),
         intervalMinutes: Type.Number({ default: 60, minimum: 5, maximum: 1440 })
-    }, { default: { questdb: false, intervalMinutes: 60 } })
+    }, {
+        default: {
+            questdb: false,
+            grafana: false,
+            signalkDatabase: false,
+            intervalMinutes: 60
+        }
+    })
 });
 /**
  * Materialised defaults — Signal K only uses the schema's `default` fields
@@ -46,10 +56,12 @@ export const ConfigSchema = Type.Object({
  */
 export const SCHEMA_DEFAULTS = {
     managedContainer: true,
-    imageTag: 'latest',
+    imageTag: 'auto',
     externalUrl: '',
     databaseExport: {
         questdb: false,
+        grafana: false,
+        signalkDatabase: false,
         intervalMinutes: 60
     }
 };

package/plugin/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAU,MAAM,mBAAmB,CAAA;AAEhD;;;;;;;;;GASG;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,oEAAoE;IACpE,mEAAmE;IACnE,cAAc,EAAE,IAAI,CAAC,MAAM,CACzB;QACE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACzE,EACD,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE,CACrD;CACF,CAAC,CAAA;AAIF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,gBAAgB,EAAE,IAAI;IACtB,QAAQ,EAAE,QAAQ;IAClB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE;QACd,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,EAAE;KACpB;CACF,CAAA"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAU,MAAM,mBAAmB,CAAA;AAEhD;;;;;;;;;GASG;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,MAAM;QACf,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,8FAA8F;YAC9F,6FAA6F;KAChG,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,oEAAoE;IACpE,mEAAmE;IACnE,cAAc,EAAE,IAAI,CAAC,MAAM,CACzB;QACE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACjD,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACzE,EACD;QACE,OAAO,EAAE;YACP,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,eAAe,EAAE,KAAK;YACtB,eAAe,EAAE,EAAE;SACpB;KACF,CACF;CACF,CAAC,CAAA;AAIF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW;IACrC,gBAAgB,EAAE,IAAI;IACtB,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,EAAE;IACf,cAAc,EAAE;QACd,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,KAAK;QACd,eAAe,EAAE,KAAK;QACtB,eAAe,EAAE,EAAE;KACpB;CACF,CAAA"}

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

@@ -0,0 +1,25 @@
+import type { DatabaseExporter, ExportResult } from './types.js';
+export interface GrafanaExporterOptions {
+    signalkBaseUrl?: string;
+    log?: (msg: string) => void;
+    /** Override fetch (tests). */
+    fetch?: typeof fetch;
+}
+export declare class GrafanaExporter implements DatabaseExporter {
+    readonly pluginId = "signalk-grafana";
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly log;
+    constructor(opts?: GrafanaExporterOptions);
+    detect(): Promise<boolean>;
+    exportAll(stagingDir: string): Promise<ExportResult>;
+    private exportDb;
+    private exportDashboards;
+    private parseDashboardEntry;
+    private fetchDashboardFile;
+    private exportProvisioning;
+    private parseProvisioningEntry;
+    private fetchProvisioningFile;
+    private resetStagingDir;
+}
+//# sourceMappingURL=grafana.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grafana.d.ts","sourceRoot":"","sources":["../../src/database-export/grafana.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAe,MAAM,YAAY,CAAA;AAS7E,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,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;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;gBAE/B,IAAI,GAAE,sBAA2B;IAMvC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAc1B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YA8D5C,QAAQ;YAkBR,gBAAgB;IAuC9B,OAAO,CAAC,mBAAmB;YAYb,kBAAkB;YASlB,kBAAkB;IAuChC,OAAO,CAAC,sBAAsB;YAiBhB,qBAAqB;YAerB,eAAe;CAI9B"}

package/plugin/database-export/grafana.js

@@ -0,0 +1,262 @@
+// Mirrors the QuestDB exporter: pulls signalk-grafana's /api/full-export/{db,dashboards,provisioning} over loopback and stages into kopia's snapshot tree.
+import { mkdir, rename, rm, unlink } from 'node:fs/promises';
+import { createWriteStream, existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+const GRAFANA_PLUGIN_ID = 'signalk-grafana';
+const DEFAULT_SIGNALK_BASE = 'http://127.0.0.1:3000';
+const FETCH_TIMEOUT_MS = 600_000;
+// Engine-side validation rejects names outside this set; reject early
+// here too so we never even try a fetch that the server would 400.
+const SAFE_FILENAME = /^[a-zA-Z0-9._-]+$/;
+export class GrafanaExporter {
+    pluginId = GRAFANA_PLUGIN_ID;
+    baseUrl;
+    fetchImpl;
+    log;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.signalkBaseUrl ?? DEFAULT_SIGNALK_BASE).replace(/\/$/, '');
+        this.fetchImpl = opts.fetch ?? fetch;
+        this.log = (msg) => opts.log?.(`[grafana-export] ${msg}`);
+    }
+    async detect() {
+        // Dashboards manifest is the cheapest probe — GET, no container exec, 200 even when /var/lib/grafana is empty.
+        try {
+            const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/dashboards`;
+            const res = await this.fetchImpl(url, { signal: AbortSignal.timeout(5_000) });
+            if (!res.ok)
+                return false;
+            const body = (await res.json());
+            return Array.isArray(body.dashboards);
+        }
+        catch (err) {
+            this.log(`detect failed: ${errMsg(err)}`);
+            return false;
+        }
+    }
+    async exportAll(stagingDir) {
+        const startedAt = Date.now();
+        await mkdir(stagingDir, { recursive: true });
+        const exports = [];
+        let totalBytes = 0;
+        // Use TableExport-as-single-shard so totals line up with QuestDB reports.
+        try {
+            const dbBytes = await this.exportDb(stagingDir);
+            exports.push({
+                table: 'grafana.db',
+                tableDir: stagingDir,
+                shardsWritten: 1,
+                shardsSkipped: 0,
+                bytes: dbBytes
+            });
+            totalBytes += dbBytes;
+        }
+        catch (err) {
+            this.log(`db export failed: ${errMsg(err)}`);
+        }
+        try {
+            const bytes = await this.exportDashboards(stagingDir);
+            exports.push({
+                table: 'dashboards',
+                tableDir: join(stagingDir, 'dashboards'),
+                shardsWritten: bytes.count,
+                shardsSkipped: bytes.skipped,
+                bytes: bytes.totalBytes
+            });
+            totalBytes += bytes.totalBytes;
+        }
+        catch (err) {
+            this.log(`dashboards export failed: ${errMsg(err)}`);
+        }
+        try {
+            const bytes = await this.exportProvisioning(stagingDir);
+            exports.push({
+                table: 'provisioning',
+                tableDir: join(stagingDir, 'provisioning'),
+                shardsWritten: bytes.count,
+                shardsSkipped: bytes.skipped,
+                bytes: bytes.totalBytes
+            });
+            totalBytes += bytes.totalBytes;
+        }
+        catch (err) {
+            this.log(`provisioning export failed: ${errMsg(err)}`);
+        }
+        return {
+            pluginId: this.pluginId,
+            tables: exports,
+            totalBytes,
+            durationMs: Date.now() - startedAt
+        };
+    }
+    // -------------------------------------------------------------------
+    // Internal
+    // -------------------------------------------------------------------
+    async exportDb(stagingDir) {
+        const finalPath = join(stagingDir, 'grafana.db');
+        // Drop the prior-cycle file first so a mid-cycle failure leaves no stale grafana.db beside fresh dashboards.
+        if (existsSync(finalPath))
+            await unlink(finalPath).catch(() => undefined);
+        const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/db`;
+        const res = await this.fetchImpl(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+        if (!res.ok) {
+            throw new Error(`db HTTP ${res.status}: ${(await res.text()).slice(0, 200)}`);
+        }
+        if (!res.body) {
+            throw new Error('db response body is empty');
+        }
+        const bytes = await atomicWrite(res.body, finalPath);
+        this.log(`wrote grafana.db (${bytes} bytes)`);
+        return bytes;
+    }
+    async exportDashboards(stagingDir) {
+        const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/dashboards`;
+        const res = await this.fetchImpl(url, { signal: AbortSignal.timeout(10_000) });
+        if (!res.ok) {
+            throw new Error(`dashboards manifest HTTP ${res.status}`);
+        }
+        const body = (await res.json());
+        if (!Array.isArray(body.dashboards)) {
+            throw new Error(`dashboards manifest missing 'dashboards' array`);
+        }
+        const dashboardsDir = join(stagingDir, 'dashboards');
+        // Reset so dashboards deleted in Grafana don't linger in kopia forever.
+        await this.resetStagingDir(dashboardsDir);
+        let totalBytes = 0;
+        let count = 0;
+        let skipped = 0;
+        for (const raw of body.dashboards) {
+            const entry = this.parseDashboardEntry(raw);
+            if (!entry) {
+                skipped++;
+                continue;
+            }
+            try {
+                totalBytes += await this.fetchDashboardFile(entry, dashboardsDir);
+                count++;
+            }
+            catch (err) {
+                skipped++;
+                this.log(`dashboard ${entry.name} failed: ${errMsg(err)}`);
+            }
+        }
+        return { count, skipped, totalBytes };
+    }
+    parseDashboardEntry(raw) {
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const o = raw;
+        if (typeof o.name !== 'string' || !SAFE_FILENAME.test(o.name))
+            return null;
+        // SAFE_FILENAME matches "." and "..", which would resolve to the dir
+        // itself or its parent under join(). Server rejects these too, but
+        // belt-and-braces is cheap.
+        if (o.name === '.' || o.name === '..')
+            return null;
+        if (typeof o.sha256 !== 'string' || typeof o.bytes !== 'number')
+            return null;
+        return { name: o.name, sha256: o.sha256, bytes: o.bytes };
+    }
+    async fetchDashboardFile(entry, dashboardsDir) {
+        const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/dashboards/${encodeURIComponent(entry.name)}`;
+        const res = await this.fetchImpl(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+        if (!res.ok || !res.body) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        return atomicWrite(res.body, join(dashboardsDir, entry.name));
+    }
+    async exportProvisioning(stagingDir) {
+        const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/provisioning`;
+        const res = await this.fetchImpl(url, { signal: AbortSignal.timeout(10_000) });
+        if (!res.ok) {
+            throw new Error(`provisioning manifest HTTP ${res.status}`);
+        }
+        const body = (await res.json());
+        if (!Array.isArray(body.files)) {
+            throw new Error(`provisioning manifest missing 'files' array`);
+        }
+        const provisioningDir = join(stagingDir, 'provisioning');
+        // Reset so removed YAMLs don't linger in kopia forever.
+        await this.resetStagingDir(provisioningDir);
+        let totalBytes = 0;
+        let count = 0;
+        let skipped = 0;
+        for (const raw of body.files) {
+            const entry = this.parseProvisioningEntry(raw);
+            if (!entry) {
+                skipped++;
+                continue;
+            }
+            try {
+                totalBytes += await this.fetchProvisioningFile(entry, provisioningDir);
+                count++;
+            }
+            catch (err) {
+                skipped++;
+                this.log(`provisioning ${entry.relPath} failed: ${errMsg(err)}`);
+            }
+        }
+        return { count, skipped, totalBytes };
+    }
+    parseProvisioningEntry(raw) {
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const o = raw;
+        if (typeof o.name !== 'string' || !SAFE_FILENAME.test(o.name))
+            return null;
+        if (typeof o.relPath !== 'string')
+            return null;
+        // Reject relPaths that try to escape via `..` or absolute paths
+        // before we use them in a host filesystem write. The server-side
+        // endpoint also rejects these, but defending in depth is cheap.
+        const segments = o.relPath.split('/').filter(Boolean);
+        if (segments.length === 0)
+            return null;
+        for (const seg of segments) {
+            if (seg === '..' || seg === '.' || !SAFE_FILENAME.test(seg))
+                return null;
+        }
+        if (typeof o.sha256 !== 'string' || typeof o.bytes !== 'number')
+            return null;
+        return { name: o.name, relPath: o.relPath, sha256: o.sha256, bytes: o.bytes };
+    }
+    async fetchProvisioningFile(entry, provisioningDir) {
+        const url = `${this.baseUrl}/plugins/${this.pluginId}/api/full-export/provisioning/${encodeURIComponent(entry.relPath)}`;
+        const res = await this.fetchImpl(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+        if (!res.ok || !res.body) {
+            throw new Error(`HTTP ${res.status}`);
+        }
+        const finalPath = join(provisioningDir, entry.relPath);
+        await mkdir(dirname(finalPath), { recursive: true });
+        return atomicWrite(res.body, finalPath);
+    }
+    // Errors propagate so a failed reset reports as failed-section instead of emitting a half-fresh half-stale tree.
+    async resetStagingDir(root) {
+        await rm(root, { recursive: true, force: true });
+        await mkdir(root, { recursive: true });
+    }
+}
+// Failed writes unlink the partial so half-written data can't slip into the next snapshot.
+async function atomicWrite(body, finalPath) {
+    const partialPath = `${finalPath}.partial`;
+    const nodeStream = Readable.fromWeb(body);
+    const sink = createWriteStream(partialPath);
+    let bytes = 0;
+    nodeStream.on('data', (chunk) => {
+        bytes += chunk.length;
+    });
+    try {
+        await pipeline(nodeStream, sink);
+        await rename(partialPath, finalPath);
+        return bytes;
+    }
+    catch (err) {
+        await unlink(partialPath).catch(() => undefined);
+        throw err;
+    }
+}
+function errMsg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=grafana.js.map

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

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

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

@@ -5,8 +5,8 @@
  * 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).
+ * Supports QuestDB and Grafana. InfluxDB is intentionally out of scope
+ * (see design doc).
  */
 import type { ExportResult } from './types.js';
 export interface ExportOrchestratorOptions {
@@ -16,6 +16,11 @@ export interface ExportOrchestratorOptions {
     signalkBaseUrl: string;
     /** Optional debug logger. */
     log?: (msg: string) => void;
+    enabled?: {
+        questdb?: boolean;
+        grafana?: boolean;
+        signalkDatabase?: boolean;
+    };
 }
 /**
  * Run every supported exporter whose `detect()` returns true. Each
@@ -29,5 +34,7 @@ export interface ExportOrchestratorOptions {
  */
 export declare function runAllExports(opts: ExportOrchestratorOptions): Promise<ExportResult[]>;
 export type { DatabaseExporter, ExportResult, TableExport } from './types.js';
+export { GrafanaExporter } from './grafana.js';
 export { QuestDBExporter } from './questdb.js';
+export { SignalKDatabaseExporter } from './signalk-database.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database-export/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,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;IAE3B,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAC9E;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAoD5F;AAED,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA"}

package/plugin/database-export/index.js

@@ -5,12 +5,14 @@
  * 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).
+ * Supports QuestDB and Grafana. InfluxDB is intentionally out of scope
+ * (see design doc).
  */
 import { mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
+import { GrafanaExporter } from './grafana.js';
 import { QuestDBExporter } from './questdb.js';
+import { SignalKDatabaseExporter } from './signalk-database.js';
 const PLUGIN_ID = 'signalk-backup';
 const STAGING_SUBDIR = 'database-exports';
 /**
@@ -26,12 +28,26 @@ const STAGING_SUBDIR = 'database-exports';
 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({
+    const enabled = opts.enabled ?? {};
+    const exporters = [];
+    if (enabled.questdb === true) {
+        exporters.push(new QuestDBExporter({
             signalkBaseUrl: opts.signalkBaseUrl,
             log: opts.log
-        })
-    ];
+        }));
+    }
+    if (enabled.grafana === true) {
+        exporters.push(new GrafanaExporter({
+            signalkBaseUrl: opts.signalkBaseUrl,
+            log: opts.log
+        }));
+    }
+    if (enabled.signalkDatabase === true) {
+        exporters.push(new SignalKDatabaseExporter({
+            signalkBaseUrl: opts.signalkBaseUrl,
+            log: opts.log
+        }));
+    }
     const results = [];
     for (const exporter of exporters) {
         if (!(await exporter.detect())) {
@@ -51,5 +67,7 @@ export async function runAllExports(opts) {
     }
     return results;
 }
+export { GrafanaExporter } from './grafana.js';
 export { QuestDBExporter } from './questdb.js';
+export { SignalKDatabaseExporter } from './signalk-database.js';
 //# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { DatabaseExporter, ExportResult } from './types.js';
+export interface SignalKDatabaseExporterOptions {
+    signalkBaseUrl?: string;
+    log?: (msg: string) => void;
+    /** Override fetch (tests). */
+    fetch?: typeof fetch;
+}
+export declare class SignalKDatabaseExporter implements DatabaseExporter {
+    readonly pluginId = "signalk-database";
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly log;
+    constructor(opts?: SignalKDatabaseExporterOptions);
+    detect(): Promise<boolean>;
+    exportAll(stagingDir: string): Promise<ExportResult>;
+    private fetchManifest;
+    private parseEntry;
+    private exportOne;
+    private resetStagingDir;
+}
+//# sourceMappingURL=signalk-database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signalk-database.d.ts","sourceRoot":"","sources":["../../src/database-export/signalk-database.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAe,MAAM,YAAY,CAAA;AAS7E,MAAM,WAAW,8BAA8B;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAQD,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,QAAQ,CAAC,QAAQ,sBAA6B;IAE9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;gBAE/B,IAAI,GAAE,8BAAmC;IAM/C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAY1B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;YAgD5C,aAAa;IAkB3B,OAAO,CAAC,UAAU;YAQJ,SAAS;YAmBT,eAAe;CAG9B"}