signalk-backup 0.1.0

package/plugin/types.d.ts

@@ -0,0 +1,121 @@
+import { ServerAPI } from '@signalk/server-api';
+export type BackupServerAPI = ServerAPI;
+export type ContainerState = 'running' | 'stopped' | 'missing' | 'no-runtime';
+export interface ContainerRuntimeInfo {
+    runtime: 'podman' | 'docker';
+    version: string;
+    isPodmanDockerShim: boolean;
+}
+export interface ContainerResourceLimits {
+    cpus?: number | null;
+    cpuShares?: number | null;
+    cpusetCpus?: string | null;
+    memory?: string | null;
+    memorySwap?: string | null;
+    memoryReservation?: string | null;
+    pidsLimit?: number | null;
+    oomScoreAdj?: number | null;
+}
+export interface ContainerConfig {
+    image: string;
+    tag: string;
+    ports?: Record<string, string>;
+    volumes?: Record<string, string>;
+    env?: Record<string, string>;
+    restart?: 'no' | 'unless-stopped' | 'always';
+    command?: string[];
+    networkMode?: string;
+    resources?: ContainerResourceLimits;
+    /**
+     * Mount the SignalK data dir at this path inside the container, regardless
+     * of how SignalK is deployed (bare-metal, named volume, bind mount).
+     */
+    signalkDataMount?: string;
+    /**
+     * Mount the SignalK *config root* (the entire `~/.signalk/` tree) at this
+     * path inside the container. Distinct from `signalkDataMount`, which
+     * resolves to the plugin-private subdir. Use this when the container
+     * needs settings.json, security.json, or the whole plugin-config-data tree
+     * (e.g. backup tools). Requires signalk-container >= 1.5.0.
+     */
+    signalkConfigRootMount?: string;
+    /**
+     * Ports inside the container that the SignalK process must be able to
+     * reach back to. signalk-container picks the right networking strategy
+     * automatically and exposes the chosen address via resolveContainerAddress.
+     */
+    signalkAccessiblePorts?: number[];
+}
+export interface ContainerInfo {
+    name: string;
+    image: string;
+    state: ContainerState;
+}
+export interface UpdateResourcesResult {
+    method: 'live' | 'recreated';
+    warnings?: string[];
+}
+export type UpdateReason = 'newer-version' | 'digest-drift' | 'older-than-pinned' | 'up-to-date' | 'offline' | 'unknown' | 'error';
+export type UpdateTagKind = 'semver' | 'floating' | 'unknown';
+export interface UpdateCheckResult {
+    pluginId: string;
+    containerName: string;
+    runningTag: string;
+    tagKind: UpdateTagKind;
+    currentVersion: string | null;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    reason: UpdateReason;
+    error?: string;
+    checkedAt: string;
+    lastSuccessfulCheckAt: string | null;
+    fromCache: boolean;
+}
+export interface VersionSource {
+    fetch: (...args: unknown[]) => Promise<unknown>;
+}
+export interface UpdateRegistration {
+    pluginId: string;
+    containerName: string;
+    image: string;
+    currentTag: () => string;
+    versionSource: VersionSource;
+    currentVersion?: () => Promise<string | null>;
+    checkInterval?: string;
+}
+export interface UpdateServiceApi {
+    register: (reg: UpdateRegistration) => void;
+    unregister: (pluginId: string) => void;
+    checkOne: (pluginId: string) => Promise<UpdateCheckResult>;
+    checkAll: () => Promise<UpdateCheckResult[]>;
+    getLastResult: (pluginId: string) => UpdateCheckResult | null;
+    sources: {
+        githubReleases: (repo: string, options?: {
+            allowPrerelease?: boolean;
+            tagPrefix?: string;
+        }) => VersionSource;
+        dockerHubTags: (image: string, options?: {
+            filter?: (tag: string) => boolean;
+        }) => VersionSource;
+    };
+}
+export interface ContainerManagerApi {
+    getRuntime: () => ContainerRuntimeInfo | null;
+    pullImage: (image: string, onProgress?: (msg: string) => void) => Promise<void>;
+    imageExists: (image: string) => Promise<boolean>;
+    getImageDigest: (imageOrContainer: string) => Promise<string | null>;
+    ensureRunning: (name: string, config: ContainerConfig) => Promise<void>;
+    start: (name: string) => Promise<void>;
+    stop: (name: string) => Promise<void>;
+    remove: (name: string) => Promise<void>;
+    getState: (name: string) => Promise<ContainerState>;
+    listContainers: () => Promise<ContainerInfo[]>;
+    updateResources: (name: string, limits: ContainerResourceLimits) => Promise<UpdateResourcesResult>;
+    getResources: (name: string) => ContainerResourceLimits;
+    resolveContainerAddress: (name: string, port: number) => Promise<string | null>;
+    updates: UpdateServiceApi;
+}
+declare global {
+    var __signalk_containerManager: ContainerManagerApi | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/plugin/types.d.ts.map

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

package/plugin/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/plugin/types.js.map

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

package/public/assets/index-B7P78qlq.js

@@ -0,0 +1,2 @@
+(function(){let e=document.createElement(`link`).relList;if(e&&e.supports&&e.supports(`modulepreload`))return;for(let e of document.querySelectorAll(`link[rel="modulepreload"]`))n(e);new MutationObserver(e=>{for(let t of e)if(t.type===`childList`)for(let e of t.addedNodes)e.tagName===`LINK`&&e.rel===`modulepreload`&&n(e)}).observe(document,{childList:!0,subtree:!0});function t(e){let t={};return e.integrity&&(t.integrity=e.integrity),e.referrerPolicy&&(t.referrerPolicy=e.referrerPolicy),e.crossOrigin===`use-credentials`?t.credentials=`include`:e.crossOrigin===`anonymous`?t.credentials=`omit`:t.credentials=`same-origin`,t}function n(e){if(e.ep)return;e.ep=!0;let n=t(e);fetch(e.href,n)}})();var e=`modulepreload`,t=function(e){return`/signalk-backup/`+e},n={},r=function(r,i,a){let o=Promise.resolve();if(i&&i.length>0){let r=document.getElementsByTagName(`link`),s=document.querySelector(`meta[property=csp-nonce]`),c=s?.nonce||s?.getAttribute(`nonce`);function l(e){return Promise.all(e.map(e=>Promise.resolve(e).then(e=>({status:`fulfilled`,value:e}),e=>({status:`rejected`,reason:e}))))}o=l(i.map(i=>{if(i=t(i,a),i in n)return;n[i]=!0;let o=i.endsWith(`.css`),s=o?`[rel="stylesheet"]`:``;if(a)for(let e=r.length-1;e>=0;e--){let t=r[e];if(t.href===i&&(!o||t.rel===`stylesheet`))return}else if(document.querySelector(`link[href="${i}"]${s}`))return;let l=document.createElement(`link`);if(l.rel=o?`stylesheet`:e,o||(l.as=`script`),l.crossOrigin=``,l.href=i,c&&l.setAttribute(`nonce`,c),document.head.appendChild(l),o)return new Promise((e,t)=>{l.addEventListener(`load`,e),l.addEventListener(`error`,()=>t(Error(`Unable to preload CSS for ${i}`)))})}))}function s(e){let t=new Event(`vite:preloadError`,{cancelable:!0});if(t.payload=e,window.dispatchEvent(t),!t.defaultPrevented)throw e}return o.then(e=>{for(let t of e||[])t.status===`rejected`&&s(t.reason);return r().catch(s)})};async function i(){let e=await fetch(`/admin/.vite/manifest.json`);if(!e.ok)return;let t=await e.json(),n=new Set;for(let e of Object.values(t))if(e){for(let t of e.css??[])n.add(t);typeof e.file==`string`&&e.file.endsWith(`.css`)&&n.add(e.file)}await Promise.all([...n].map(e=>new Promise(t=>{let n=document.createElement(`link`);n.rel=`stylesheet`,n.href=`/admin/`+e,n.onload=t,n.onerror=t,document.head.appendChild(n)})))}try{await i()}catch(e){console.warn(`signalk-backup: admin CSS not available`,e)}finally{await r(()=>import(`./main-DQRPJ7oa.js`),[])}
+//# sourceMappingURL=index-B7P78qlq.js.map

package/public/assets/index-B7P78qlq.js.map

@@ -0,0 +1 @@
+{"version":3,"mappings":"m2DACM,eAAe,GAAiB,CAC9B,IAAM,EAAM,MAAM,MAAM,6BAA6B,CACrD,GAAI,CAAC,EAAI,GAAI,OACb,IAAM,EAAW,MAAM,EAAI,MAAM,CAC3B,EAAW,IAAI,IAMrB,IAAK,IAAM,KAAS,OAAO,OAAO,EAAS,CACpC,KACL,KAAK,IAAM,KAAO,EAAM,KAAO,EAAE,CAAE,EAAS,IAAI,EAAI,CAChD,OAAO,EAAM,MAAS,UAAY,EAAM,KAAK,SAAS,OAAO,EAC/D,EAAS,IAAI,EAAM,KAAK,CAG5B,MAAM,QAAQ,IACZ,CAAC,GAAG,EAAS,CAAC,IACX,GACC,IAAI,QAAS,GAAY,CACvB,IAAM,EAAO,SAAS,cAAc,OAAO,CAC3C,EAAK,IAAM,aACX,EAAK,KAAO,UAAY,EACxB,EAAK,OAAS,EACd,EAAK,QAAU,EACf,SAAS,KAAK,YAAY,EAAK,EAC/B,CACL,CACF,CAGH,GAAI,CACF,MAAM,GAAgB,OACf,EAAK,CACZ,QAAQ,KAAK,0CAA2C,EAAI,QACpD,CACR,YAAM,OAAO","names":[],"ignoreList":[],"sources":["../../webapp/index.html?html-proxy&index=0.js"],"sourcesContent":["\n      async function injectAdminCss() {\n        const res = await fetch('/admin/.vite/manifest.json')\n        if (!res.ok) return\n        const manifest = await res.json()\n        const cssFiles = new Set()\n        // Two shapes are common: an entry whose `css` array lists its\n        // stylesheet imports, OR a top-level entry whose `file` itself\n        // ends in `.css` (when Vite extracts a global stylesheet). The\n        // current SignalK admin uses the second shape; older builds and\n        // the docs example use the first. Cover both.\n        for (const entry of Object.values(manifest)) {\n          if (!entry) continue\n          for (const css of entry.css ?? []) cssFiles.add(css)\n          if (typeof entry.file === 'string' && entry.file.endsWith('.css')) {\n            cssFiles.add(entry.file)\n          }\n        }\n        await Promise.all(\n          [...cssFiles].map(\n            (css) =>\n              new Promise((resolve) => {\n                const link = document.createElement('link')\n                link.rel = 'stylesheet'\n                link.href = '/admin/' + css\n                link.onload = resolve\n                link.onerror = resolve\n                document.head.appendChild(link)\n              })\n          )\n        )\n      }\n\n      try {\n        await injectAdminCss()\n      } catch (err) {\n        console.warn('signalk-backup: admin CSS not available', err)\n      } finally {\n        await import('./src/main.tsx')\n      }\n    "],"file":"index-B7P78qlq.js"}