signalk-backup 0.4.0 → 0.6.0

package/README.md

@@ -1,15 +1,18 @@
 # signalk-backup
 
-Scheduled deduplicated backups of your SignalK config (and optionally history) to local storage and Google Drive.
+Scheduled deduplicated backups of your SignalK config (and optionally history) to local storage, USB / NAS, or Google Drive — with a tree-browser that lets you restore individual files from any snapshot, anywhere your user can write.
 
-The plugin is a thin shell: it asks [signalk-container](https://github.com/dirkwa/signalk-container) to run the backup engine in a container ([signalk-backup-server](https://github.com/dirkwa/signalk-backup-server)) and presents a redirect to the engine's UI as a SignalK webapp. All backup work — Kopia snapshots, rclone Google Drive sync, scheduling, restore-with-rollback — happens inside the container.
+The plugin runs a React webapp inside the SignalK Admin UI and orchestrates a separate backup-engine container ([signalk-backup-server](https://github.com/dirkwa/signalk-backup-server)). All Kopia snapshot work happens in the container; the plugin handles the UI, the database-export tick, and host-side file writes for restores that target paths the container can't see.
 
 ## Features
 
 - **Content-addressable deduplication** — Kopia stores file blobs once across all snapshots; identical config files between hourly/daily/weekly retention tiers cost nothing
-- **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
+- **Cloud + local destinations** — Google Drive (rclone, `drive.file` scope, opt-in OAuth), USB / NAS via local-fs, or SMB share. Snapshots stay in the local Kopia repo even when cloud sync is configured
+- **Selective restore** — browse any backup's file tree, download a single file or whole subdirectory, or restore in-place. The trailing slash on a custom path means "land inside as a directory", so `tmp/` plus a file source writes `tmp/<filename>` instead of overwriting `tmp` as a file
+- **Restore-anywhere** — custom-path restores stream through the plugin and write under the SignalK user's permissions, so you can land restored bytes in `/tmp`, `/media/usb/...`, or your home directory — anywhere your user can write
+- **Restore with safety backup** — every full restore creates a snapshot of the current state first; partial restores stash the existing target as a sibling before overwriting. Both flows can be rolled back automatically on failure
+- **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 backup to avoid torn-write hazards. The dedicated "Database exports" tab also extracts the export subtree from any historical backup without pulling the whole snapshot — a direct answer to "QuestDB shards bloat the full zip"
 - **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
 
@@ -17,7 +20,7 @@ The plugin is a thin shell: it asks [signalk-container](https://github.com/dirkw
 
 - SignalK Server ≥ 2.24.0
 - Node 22 or newer (24 recommended)
-- [signalk-container](https://github.com/dirkwa/signalk-container) ≥ 0.1.6 (provides the container runtime)
+- [signalk-container](https://github.com/dirkwa/signalk-container) ≥ 1.6.0 (provides the container runtime)
 - Podman or Docker on the host
 
 ## Install
@@ -27,37 +30,44 @@ The plugin is a thin shell: it asks [signalk-container](https://github.com/dirkw
 # (auto-enables on install — first-run schedules a daily local backup)
 ```
 
-The plugin pulls `ghcr.io/dirkwa/signalk-backup-server:latest` on first run. The container is small (~80 MB compressed). Subsequent updates are detected and surfaced in the signalk-container config panel.
+The plugin pulls `ghcr.io/dirkwa/signalk-backup-server` at a server version it pins itself (see [src/config/image-tag.ts](src/config/image-tag.ts)). Plugin releases and server releases are decoupled — you can pin or float either independently via the plugin's `imageTag` setting.
 
 ## How it works
 
-```
-Your browser
-  └── /plugins/signalk-backup/                 ← redirect HTML
-       └── plugin proxies /api/gui-url
-            └── backup-server container UI
-                 (snapshots, restore wizard, cloud sync, settings)
+```text
+Browser
+  └── /signalk-backup/                                  ← plugin webapp (React)
+       └── /plugins/signalk-backup/api/*                ← plugin's reverse proxy
+            ├── /api/db-export/staging                  ← plugin-local (file lister)
+            ├── /api/restore-partial-host               ← plugin-local (writes to host fs)
+            └── /api/backups/*, /api/cloud/*, …         ← proxied to backup-server container
+                 └── http://127.0.0.1:<port>/api/*
+                      (Kopia snapshots, restore-with-rollback,
+                       partial-restore state machine, cloud sync)
 ```
 
-When you visit `/plugins/signalk-backup/` in the SignalK Admin UI, the plugin's redirect HTML asks `/plugins/signalk-backup/api/gui-url` for the current backup-server location and bounces your browser there. This means the UI version is always in sync with the running container.
+The plugin is most of the user experience:
 
-## Configuration
+- The **webapp** at `/signalk-backup/` is a React SPA bundled by Vite. It runs in the SignalK admin origin and reads/writes via `fetch('/plugins/signalk-backup/api/*')`. No CORS dance, no separate auth — it inherits SignalK's.
+- The **plugin process** owns three things directly: the database-export scheduler tick, an HTTP route that lists / streams files from the staging tree (so the webapp can show "live" exports), and an HTTP route that performs host-side file writes for custom-path restores.
+- Everything else — Kopia snapshots, restore-with-rollback, cloud sync, scheduling — runs in the [signalk-backup-server](https://github.com/dirkwa/signalk-backup-server) container. The plugin reverse-proxies `/api/*` through to it, and adds a small set of explicit overrides above the catch-all proxy.
 
-Most configuration lives in the **Backup Console** (open it from the redirect, or from the SignalK Admin UI plugin config: "Open Backup Console"). The Console handles:
+The webapp has four tabs:
 
-- Backup schedule (hourly / daily / weekly / startup) and retention tiers
-- Backup excludes (paths to skip — default: `node_modules/`, `charts*/`)
-- Repository password (Kopia encryption key)
-- Cloud sync mode (off / manual / daily / weekly)
-- Google Drive connection (one-click OAuth via `rclone authorize drive`)
-- Snapshot browser, restore wizard
+- **Dashboard** — status, recent backups, scheduler next-run times
+- **Backups** — create, list, download, restore (full or selective), upload a ZIP, delete
+- **Database exports** — live staging table (one row per exporter file currently on disk) plus a "pick a backup → browse the database-exports subtree" extractor for grabbing historical shards without pulling the whole snapshot
+- **Cloud sync** — provider chooser (Google Drive / local / SMB), credentials, sync mode, on-demand sync
+
+## Configuration
 
-The SignalK Admin UI plugin panel (small) handles only deployment-level settings:
+Most settings live in the **webapp** under Settings. The plugin's SignalK Admin UI config panel is intentionally small and handles only deployment-level options (the schema in [src/config/schema.ts](src/config/schema.ts) is the source of truth — update this list if you bump it):
 
-- `managedContainer` — whether to manage the container yourself or point at an external backup-server
-- `imageTag` — pin a specific version or use a floating tag like `latest`
+- `managedContainer` — let the plugin manage the backup-server container (default), or point at an external instance
+- `imageTag` — pin a specific version or use `auto` (default — resolves to the BACKUP_SERVER_VERSION constant)
 - `externalUrl` — only used when `managedContainer: false`
-- `logLevel` — forwarded to the container
+- `databaseExport.{questdb, grafana, signalkDatabase}` — enable per-exporter (default off; users opt in once their DB plugin is producing data)
+- `databaseExport.intervalMinutes` — how often the export tick runs (5–1440)
 
 ## License
 

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "signalk-backup",
-  "version": "0.4.0",
+  "version": "0.6.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",
@@ -49,7 +49,8 @@
   },
   "dependencies": {
     "@sinclair/typebox": "^0.34.0",
-    "bonjour-service": "^1.3.0"
+    "bonjour-service": "^1.3.0",
+    "unzipper": "^0.12.3"
   },
   "peerDependencies": {
     "signalk-container": ">=1.6.0"
@@ -68,6 +69,7 @@
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@types/supertest": "^7.2.0",
+    "@types/unzipper": "^0.10.11",
     "@vitejs/plugin-react": "^6.0.1",
     "bootstrap": "^5.3.8",
     "eslint": "^10.3.0",

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

@@ -0,0 +1,3 @@
+export declare const BACKUP_SERVER_VERSION = "0.5.0";
+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,qBAAqB,UAAU,CAAA;AAE5C,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/plugin/config/image-tag.js

@@ -0,0 +1,9 @@
+// The signalk-backup-server image version that "auto" resolves to.
+// Bump this when a new signalk-backup-server release is published to ghcr.io.
+// Independent of signalk-backup's own package.json version — the two repos
+// release on independent cadences. See AGENTS.md "Gotchas" for rationale.
+export const BACKUP_SERVER_VERSION = '0.5.0';
+export function resolveImageTag(tag) {
+    return tag === 'auto' ? BACKUP_SERVER_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,mEAAmE;AACnE,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAA;AAE5C,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,GAAG,CAAA;AACrD,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 signalk-backup-server version this plugin release was tested against. ' +
+            '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,oGAAoG;YACpG,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"}