signalk-container-helper 0.1.0

package/dist/managed-container.d.ts

@@ -0,0 +1,203 @@
+import type { AppLike, ContainerConfig, ContainerManagerApi, ContainerState, EnsureRunningOptions, UpdateCheckResult } from "./types.js";
+import { type VersionSourceSpec } from "./version-source.js";
+import { type FetchLike } from "./http.js";
+export interface ReadinessOptions {
+    /**
+     * Container port to reach the app on — must also be declared in the
+     * config's `signalkAccessiblePorts` so signalk-container wires networking.
+     */
+    port: number;
+    /** Health path polled on the resolved address. Default "/". */
+    path?: string;
+    /** Overall readiness deadline. Default 60_000. */
+    maxMs?: number;
+    /** Poll interval. Default 1_000. */
+    intervalMs?: number;
+    /** Per-request timeout. Default 2_000. */
+    requestTimeoutMs?: number;
+}
+export interface ManagedUpdateOptions {
+    versionSource: VersionSourceSpec;
+    /**
+     * Live getter for the currently-configured tag. Defaults to a getter of
+     * the tag most recently passed to start()/applyUpdate() (falling back to
+     * `defaultTag`). Provide your own when the user can edit the tag in the
+     * plugin options without restarting.
+     */
+    currentTag?: () => string;
+    /** Query the running app for its version; preferred over currentTag. */
+    currentVersion?: () => Promise<string | null>;
+    /** e.g. "24h" (default), "1h" minimum. */
+    checkInterval?: string;
+}
+export interface ManagedContainerOptions {
+    app: AppLike;
+    /** Your plugin id (package.json name) — update-service registration key. */
+    pluginId: string;
+    /** Container name, unprefixed (signalk-container adds its namespace). */
+    name: string;
+    /** Image repo without tag, e.g. "ghcr.io/questdb/questdb". */
+    image: string;
+    /**
+     * Build the full declarative ContainerConfig for a resolved tag. Called on
+     * every start/update — keep it pure so drift detection sees stable input.
+     */
+    buildConfig: (tag: string) => ContainerConfig;
+    /** Tag used when start() is called without one. Default "latest". */
+    defaultTag?: string;
+    /**
+     * Map a user-facing tag to the tag actually run, e.g. "auto" → a pinned
+     * tested version. Applied to start(), applyUpdate(), and route input.
+     */
+    resolveTag?: (requested: string) => string;
+    /** Budget for waiting on signalk-container + runtime. Default 120_000. */
+    managerTimeoutMs?: number;
+    /** Poll interval while waiting for the manager global. Default 500. */
+    managerPollIntervalMs?: number;
+    /** HTTP readiness of the app inside the container (optional). */
+    readiness?: ReadinessOptions;
+    /** Register with signalk-container's update-detection service (optional). */
+    updates?: ManagedUpdateOptions;
+    /** Passed through to ensureRunning/recreate (onVolumeIssue, logs, …). */
+    ensureOptions?: EnsureRunningOptions;
+    /** Suppress setPluginStatus progress lines. Default false. */
+    quiet?: boolean;
+    /** Injectable fetch for tests. */
+    fetchImpl?: FetchLike;
+}
+export interface StartResult {
+    manager: ContainerManagerApi;
+    /** The resolved tag that was started. */
+    tag: string;
+    /** "http://host:port" when readiness was configured, else null. */
+    address: string | null;
+}
+/** Minimal router shape (Express-compatible) for registerUpdateRoutes. */
+export interface RouterLike {
+    get(path: string, handler: (req: unknown, res: ResponseLike) => unknown): unknown;
+    post(path: string, handler: (req: unknown, res: ResponseLike) => unknown): unknown;
+}
+export interface ResponseLike {
+    status(code: number): ResponseLike;
+    json(body: unknown): unknown;
+}
+export interface UpdateRoutesOptions {
+    /** Route prefix. Default "/api/update" (→ GET …/check, POST …/apply). */
+    basePath?: string;
+    /**
+     * Called after a successful apply with the tag as requested by the client
+     * (before resolveTag) and the tag actually run. Persist the REQUESTED tag
+     * (e.g. "auto") via app.savePluginOptions here so auto-tracking survives.
+     */
+    onApplied?: (requestedTag: string, resolvedTag: string) => void | Promise<void>;
+}
+/**
+ * Full lifecycle wrapper for a plugin-owned ("managed") container — the
+ * signalk-backup / mayara archetype. One instance per container.
+ */
+export declare class ManagedContainer {
+    readonly options: ManagedContainerOptions;
+    /** Resolved after start(); also lazily re-read from the global. */
+    manager: ContainerManagerApi | undefined;
+    /** Tag most recently started or applied (resolved form). */
+    lastStartedTag: string | undefined;
+    /** "http://host:port" once readiness resolved an address. */
+    address: string | null;
+    private updatesRegistered;
+    constructor(options: ManagedContainerOptions);
+    private get app();
+    private status;
+    private fail;
+    private requireManager;
+    /** Validate a requested tag and apply the resolveTag mapping. */
+    private resolveTag;
+    /**
+     * Match this container in a listContainers() result.
+     *
+     * `unprefixedName` (supplied by signalk-container since the configurable
+     * namespace landed) is the correct, namespace-agnostic key — a container
+     * is `<namespace>-<name>`, and the namespace is `sk` only by default
+     * (a devcontainer runs `devpod-`, and operators can set any value via
+     * SIGNALK_CONTAINER_NAMESPACE). We must NOT hard-code `sk-`, or the helper
+     * would fail to find its own container under a non-default namespace.
+     *
+     * The fallback covers only a signalk-container old enough to predate
+     * `unprefixedName`. signalk-container validates the namespace as
+     * `[a-z0-9]+` (no hyphen), so the fallback matches `<namespace>-<name>`
+     * with a hyphen-free prefix rather than any `-<name>` suffix — otherwise
+     * a foreign container like `otherns-app-<name>` would false-match.
+     */
+    private matchInfo;
+    /**
+     * True when `liveName` is this container under a legacy (pre-
+     * `unprefixedName`) signalk-container: either the bare name, or
+     * `<namespace>-<name>` where namespace is a single `[a-z0-9]+` token.
+     */
+    private matchesLegacyName;
+    /**
+     * Full bring-up: wait for the manager and runtime, validate the tag,
+     * self-heal when the live image disagrees with the desired one, reconcile
+     * via ensureRunning, register for update detection, then (when configured)
+     * resolve the address and wait for the app's HTTP readiness.
+     *
+     * Emits progress via setPluginStatus but never sets a final "Running"
+     * status — that message belongs to the plugin. Throws ContainerHelperError
+     * (already reported via setPluginError) on fatal conditions; pair with
+     * `startSafely` in a synchronous plugin.start().
+     */
+    start(tag?: string): Promise<StartResult>;
+    private registerUpdates;
+    private awaitReadiness;
+    /**
+     * host:port to reach a container port from the Signal K process.
+     * Tries resolveContainerAddress first, then falls back to parsing
+     * listContainers() port bindings — the resolver's process-local cache can
+     * return a stale port after recreates (seen in production by
+     * signalk-backup). Returns null when both fail; never throws.
+     */
+    resolveAddress(port: number): Promise<string | null>;
+    /**
+     * Teardown for plugin.stop(): unregister from update detection, then stop
+     * (NOT remove) the container so re-enabling the plugin restarts it
+     * instantly without a pull. Never throws.
+     */
+    stop(): Promise<void>;
+    /**
+     * Apply a new tag now ("Update now" UX): recreate when available
+     * (signalk-container 1.12.0+), otherwise the legacy
+     * pull → remove → ensureRunning triplet. The legacy path can strand the
+     * plugin between remove and recreate — that failure surfaces as
+     * code "recreate-limbo" with a retry-able message.
+     *
+     * Returns the resolved tag. When readiness is configured the address is
+     * re-resolved afterwards (non-fatal on failure).
+     */
+    applyUpdate(tag: string): Promise<{
+        tag: string;
+    }>;
+    /** updates.checkOne — null when the manager is unavailable. */
+    checkForUpdate(): Promise<UpdateCheckResult | null>;
+    /** Container state; 'no-runtime' when the manager is unavailable. Never throws. */
+    getState(): Promise<ContainerState>;
+    /** State + live image for /status routes. Never throws. */
+    getInfo(): Promise<{
+        state: ContainerState | "unknown";
+        image: string;
+    }>;
+    /** Last N log lines (signalk-container 1.7.0+); null when unsupported. */
+    getLogs(options?: {
+        tail?: number;
+        since?: number;
+    }): Promise<string[] | null>;
+    /**
+     * Mount the standard update endpoints on the plugin router:
+     *
+     *   GET  <basePath>/check → UpdateCheckResult (503 without a manager)
+     *   POST <basePath>/apply → { success: true, tag } — body { tag?: string }
+     *
+     * Persist the requested tag from `onApplied` (e.g. via
+     * app.savePluginOptions) so the user's choice survives restarts.
+     */
+    registerUpdateRoutes(router: RouterLike, options?: UpdateRoutesOptions): void;
+}
+//# sourceMappingURL=managed-container.d.ts.map

package/dist/managed-container.d.ts.map

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

package/dist/managed-container.js

@@ -0,0 +1,397 @@
+import { getContainerManager, waitForContainerManager } from "./manager.js";
+import { buildVersionSource, } from "./version-source.js";
+import { waitForHttpReady } from "./http.js";
+import { ContainerHelperError, errMsg, isValidImageTag } from "./util.js";
+/**
+ * Full lifecycle wrapper for a plugin-owned ("managed") container — the
+ * signalk-backup / mayara archetype. One instance per container.
+ */
+export class ManagedContainer {
+    options;
+    /** Resolved after start(); also lazily re-read from the global. */
+    manager;
+    /** Tag most recently started or applied (resolved form). */
+    lastStartedTag;
+    /** "http://host:port" once readiness resolved an address. */
+    address = null;
+    updatesRegistered = false;
+    constructor(options) {
+        this.options = options;
+    }
+    get app() {
+        return this.options.app;
+    }
+    status(msg) {
+        if (!this.options.quiet)
+            this.app.setPluginStatus(msg);
+    }
+    fail(code, message) {
+        this.app.setPluginError(message);
+        throw new ContainerHelperError(code, message, true);
+    }
+    requireManager() {
+        const manager = this.manager ?? getContainerManager();
+        if (!manager) {
+            this.fail("manager-unavailable", "signalk-container plugin not available. Install and enable it, then restart this plugin.");
+        }
+        this.manager = manager;
+        return manager;
+    }
+    /** Validate a requested tag and apply the resolveTag mapping. */
+    resolveTag(requested) {
+        if (!isValidImageTag(requested)) {
+            this.fail("invalid-tag", `Invalid image tag: ${JSON.stringify(requested)}`);
+        }
+        const resolved = this.options.resolveTag?.(requested) ?? requested;
+        if (!isValidImageTag(resolved)) {
+            this.fail("invalid-tag", `Invalid resolved image tag: ${JSON.stringify(resolved)}`);
+        }
+        return resolved;
+    }
+    /**
+     * Match this container in a listContainers() result.
+     *
+     * `unprefixedName` (supplied by signalk-container since the configurable
+     * namespace landed) is the correct, namespace-agnostic key — a container
+     * is `<namespace>-<name>`, and the namespace is `sk` only by default
+     * (a devcontainer runs `devpod-`, and operators can set any value via
+     * SIGNALK_CONTAINER_NAMESPACE). We must NOT hard-code `sk-`, or the helper
+     * would fail to find its own container under a non-default namespace.
+     *
+     * The fallback covers only a signalk-container old enough to predate
+     * `unprefixedName`. signalk-container validates the namespace as
+     * `[a-z0-9]+` (no hyphen), so the fallback matches `<namespace>-<name>`
+     * with a hyphen-free prefix rather than any `-<name>` suffix — otherwise
+     * a foreign container like `otherns-app-<name>` would false-match.
+     */
+    matchInfo(list) {
+        const { name } = this.options;
+        // Two passes so the reliable key wins regardless of list order: an
+        // exact unprefixedName match anywhere beats a legacy prefix match.
+        return (list.find((c) => c.unprefixedName === name) ??
+            list.find((c) => c.unprefixedName === undefined && this.matchesLegacyName(c.name)));
+    }
+    /**
+     * True when `liveName` is this container under a legacy (pre-
+     * `unprefixedName`) signalk-container: either the bare name, or
+     * `<namespace>-<name>` where namespace is a single `[a-z0-9]+` token.
+     */
+    matchesLegacyName(liveName) {
+        const { name } = this.options;
+        if (liveName === name)
+            return true;
+        const suffix = `-${name}`;
+        if (!liveName.endsWith(suffix))
+            return false;
+        const prefix = liveName.slice(0, -suffix.length);
+        return /^[a-z0-9]+$/.test(prefix);
+    }
+    /**
+     * Full bring-up: wait for the manager and runtime, validate the tag,
+     * self-heal when the live image disagrees with the desired one, reconcile
+     * via ensureRunning, register for update detection, then (when configured)
+     * resolve the address and wait for the app's HTTP readiness.
+     *
+     * Emits progress via setPluginStatus but never sets a final "Running"
+     * status — that message belongs to the plugin. Throws ContainerHelperError
+     * (already reported via setPluginError) on fatal conditions; pair with
+     * `startSafely` in a synchronous plugin.start().
+     */
+    async start(tag) {
+        const { name, image, buildConfig, ensureOptions, managerTimeoutMs = 120_000, managerPollIntervalMs = 500, } = this.options;
+        this.status("Waiting for signalk-container plugin...");
+        const { manager, runtime } = await waitForContainerManager({
+            timeoutMs: managerTimeoutMs,
+            intervalMs: managerPollIntervalMs,
+            onWaiting: (phase) => {
+                if (phase === "runtime")
+                    this.status("Waiting for container runtime detection...");
+            },
+        });
+        if (!manager) {
+            this.fail("manager-unavailable", `signalk-container plugin not available after ${Math.round(managerTimeoutMs / 1000)}s. Install and enable it, then restart this plugin.`);
+        }
+        if (!runtime) {
+            this.fail("no-runtime", "No container runtime detected (Podman or Docker). Install one and restart Signal K.");
+        }
+        this.manager = manager;
+        const resolved = this.resolveTag(tag ?? this.options.defaultTag ?? "latest");
+        const desiredImage = `${image}:${resolved}`;
+        const config = buildConfig(resolved);
+        // Startup self-heal: when the plugin bumped its pinned tag, the live
+        // container's image disagrees with the desired one. recreate (1.12.0+)
+        // applies it immediately instead of trusting drift detection.
+        let reconciled = false;
+        if (typeof manager.recreate === "function") {
+            try {
+                const found = this.matchInfo(await manager.listContainers());
+                if (found && found.image !== desiredImage) {
+                    this.status(`Recreating ${found.image} → ${desiredImage}...`);
+                    await manager.recreate(name, config, ensureOptions);
+                    reconciled = true;
+                }
+            }
+            catch (probeErr) {
+                this.app.debug(`self-heal probe failed (non-fatal): ${errMsg(probeErr)}`);
+            }
+        }
+        if (!reconciled) {
+            this.status(`Starting ${desiredImage}...`);
+            await manager.ensureRunning(name, config, ensureOptions);
+        }
+        this.lastStartedTag = resolved;
+        this.registerUpdates(manager);
+        this.address = null;
+        if (this.options.readiness) {
+            this.address = await this.awaitReadiness(resolved);
+        }
+        return { manager, tag: resolved, address: this.address };
+    }
+    registerUpdates(manager) {
+        const updates = this.options.updates;
+        if (!updates)
+            return;
+        try {
+            manager.updates.register({
+                pluginId: this.options.pluginId,
+                containerName: this.options.name,
+                image: this.options.image,
+                currentTag: updates.currentTag ??
+                    (() => this.lastStartedTag ?? this.options.defaultTag ?? "latest"),
+                currentVersion: updates.currentVersion,
+                checkInterval: updates.checkInterval,
+                versionSource: buildVersionSource(manager.updates, updates.versionSource),
+            });
+            this.updatesRegistered = true;
+        }
+        catch (err) {
+            // Non-fatal: the container is up; only update detection is missing.
+            this.app.debug(`updates.register failed (non-fatal): ${errMsg(err)}`);
+        }
+    }
+    async awaitReadiness(tag) {
+        const readiness = this.options.readiness;
+        const addr = await this.resolveAddress(readiness.port);
+        if (!addr) {
+            this.fail("address-unresolved", `Could not resolve address for ${this.options.name} port ${readiness.port}. Declare the port in signalkAccessiblePorts.`);
+        }
+        const base = `http://${addr}`;
+        const url = `${base}${readiness.path ?? "/"}`;
+        this.status(`Waiting for ${this.options.name} to become ready...`);
+        try {
+            await waitForHttpReady(url, {
+                maxMs: readiness.maxMs,
+                intervalMs: readiness.intervalMs,
+                requestTimeoutMs: readiness.requestTimeoutMs,
+                fetchImpl: this.options.fetchImpl,
+            });
+        }
+        catch (err) {
+            this.fail("not-ready", `${this.options.image}:${tag} started but ${url} never became ready: ${errMsg(err)}`);
+        }
+        return base;
+    }
+    /**
+     * host:port to reach a container port from the Signal K process.
+     * Tries resolveContainerAddress first, then falls back to parsing
+     * listContainers() port bindings — the resolver's process-local cache can
+     * return a stale port after recreates (seen in production by
+     * signalk-backup). Returns null when both fail; never throws.
+     */
+    async resolveAddress(port) {
+        const manager = this.manager ?? getContainerManager();
+        if (!manager)
+            return null;
+        try {
+            const answer = await manager.resolveContainerAddress(this.options.name, port);
+            if (answer)
+                return answer;
+        }
+        catch (err) {
+            this.app.debug(`resolveContainerAddress failed: ${errMsg(err)}`);
+        }
+        try {
+            const found = this.matchInfo(await manager.listContainers());
+            const wanted = `->${port}/tcp`;
+            for (const entry of found?.ports ?? []) {
+                if (!entry.endsWith(wanted))
+                    continue;
+                const hostPart = entry.slice(0, -wanted.length);
+                if (hostPart.includes(":"))
+                    return hostPart;
+            }
+        }
+        catch (err) {
+            this.app.debug(`listContainers port fallback failed: ${errMsg(err)}`);
+        }
+        return null;
+    }
+    /**
+     * Teardown for plugin.stop(): unregister from update detection, then stop
+     * (NOT remove) the container so re-enabling the plugin restarts it
+     * instantly without a pull. Never throws.
+     */
+    async stop() {
+        this.address = null;
+        const manager = this.manager ?? getContainerManager();
+        if (!manager)
+            return;
+        if (this.updatesRegistered) {
+            try {
+                manager.updates.unregister(this.options.pluginId);
+            }
+            catch (err) {
+                this.app.debug(`updates.unregister failed: ${errMsg(err)}`);
+            }
+            this.updatesRegistered = false;
+        }
+        try {
+            await manager.stop(this.options.name);
+        }
+        catch (err) {
+            this.app.debug(`container stop failed (may already be stopped): ${errMsg(err)}`);
+        }
+    }
+    /**
+     * Apply a new tag now ("Update now" UX): recreate when available
+     * (signalk-container 1.12.0+), otherwise the legacy
+     * pull → remove → ensureRunning triplet. The legacy path can strand the
+     * plugin between remove and recreate — that failure surfaces as
+     * code "recreate-limbo" with a retry-able message.
+     *
+     * Returns the resolved tag. When readiness is configured the address is
+     * re-resolved afterwards (non-fatal on failure).
+     */
+    async applyUpdate(tag) {
+        const manager = this.requireManager();
+        const resolved = this.resolveTag(tag);
+        const { name, image, buildConfig, ensureOptions } = this.options;
+        const config = buildConfig(resolved);
+        this.status(`Recreating ${name} with ${image}:${resolved}...`);
+        if (typeof manager.recreate === "function") {
+            await manager.recreate(name, config, ensureOptions);
+        }
+        else {
+            await manager.pullImage(`${image}:${resolved}`);
+            await manager.remove(name);
+            try {
+                await manager.ensureRunning(name, config, ensureOptions);
+            }
+            catch (recreateErr) {
+                this.fail("recreate-limbo", `Container removed but recreation failed: ${errMsg(recreateErr)}. Apply the update again to retry.`);
+            }
+        }
+        this.lastStartedTag = resolved;
+        if (this.options.readiness) {
+            const addr = await this.resolveAddress(this.options.readiness.port);
+            this.address = addr ? `http://${addr}` : this.address;
+        }
+        this.status(`Updated to ${image}:${resolved}`);
+        return { tag: resolved };
+    }
+    /** updates.checkOne — null when the manager is unavailable. */
+    async checkForUpdate() {
+        const manager = this.manager ?? getContainerManager();
+        if (!manager)
+            return null;
+        return manager.updates.checkOne(this.options.pluginId);
+    }
+    /** Container state; 'no-runtime' when the manager is unavailable. Never throws. */
+    async getState() {
+        const manager = this.manager ?? getContainerManager();
+        if (!manager)
+            return "no-runtime";
+        try {
+            return await manager.getState(this.options.name);
+        }
+        catch (err) {
+            this.app.debug(`getState failed: ${errMsg(err)}`);
+            return "no-runtime";
+        }
+    }
+    /** State + live image for /status routes. Never throws. */
+    async getInfo() {
+        const manager = this.manager ?? getContainerManager();
+        let state = "unknown";
+        let image = "";
+        if (manager) {
+            try {
+                state = await manager.getState(this.options.name);
+            }
+            catch (err) {
+                this.app.debug(`status: getState failed: ${errMsg(err)}`);
+            }
+            if (manager.getRuntime()) {
+                try {
+                    const found = this.matchInfo(await manager.listContainers());
+                    if (found)
+                        image = found.image;
+                }
+                catch (err) {
+                    this.app.debug(`status: listContainers failed: ${errMsg(err)}`);
+                }
+            }
+        }
+        return { state, image };
+    }
+    /** Last N log lines (signalk-container 1.7.0+); null when unsupported. */
+    async getLogs(options) {
+        const manager = this.manager ?? getContainerManager();
+        if (!manager || typeof manager.getLogs !== "function")
+            return null;
+        return manager.getLogs(this.options.name, options);
+    }
+    /**
+     * Mount the standard update endpoints on the plugin router:
+     *
+     *   GET  <basePath>/check → UpdateCheckResult (503 without a manager)
+     *   POST <basePath>/apply → { success: true, tag } — body { tag?: string }
+     *
+     * Persist the requested tag from `onApplied` (e.g. via
+     * app.savePluginOptions) so the user's choice survives restarts.
+     */
+    registerUpdateRoutes(router, options = {}) {
+        const { basePath = "/api/update", onApplied } = options;
+        router.get(`${basePath}/check`, async (_req, res) => {
+            const manager = this.manager ?? getContainerManager();
+            if (!manager) {
+                res.status(503).json({ error: "signalk-container not available" });
+                return;
+            }
+            try {
+                res.json(await manager.updates.checkOne(this.options.pluginId));
+            }
+            catch (err) {
+                res.status(500).json({ error: errMsg(err) });
+            }
+        });
+        router.post(`${basePath}/apply`, async (req, res) => {
+            const manager = this.manager ?? getContainerManager();
+            if (!manager) {
+                res.status(503).json({ error: "signalk-container not available" });
+                return;
+            }
+            const body = req.body;
+            const requested = typeof body?.tag === "string" && body.tag.length > 0
+                ? body.tag
+                : (this.lastStartedTag ?? this.options.defaultTag ?? "latest");
+            if (!isValidImageTag(requested)) {
+                res
+                    .status(400)
+                    .json({ error: `Invalid tag: ${JSON.stringify(requested)}` });
+                return;
+            }
+            try {
+                const { tag } = await this.applyUpdate(requested);
+                await onApplied?.(requested, tag);
+                res.json({ success: true, tag });
+            }
+            catch (err) {
+                const msg = errMsg(err);
+                this.app.setPluginError(`Update failed: ${msg}`);
+                res.status(500).json({ error: msg });
+            }
+        });
+    }
+}
+//# sourceMappingURL=managed-container.js.map

package/dist/managed-container.js.map

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