signalk-container-helper 0.1.0

package/dist/manager.d.ts

@@ -0,0 +1,44 @@
+import type { ContainerManagerApi, ContainerRuntimeInfo } from "./types.js";
+/**
+ * Read the cross-plugin manager global. signalk-container publishes its API
+ * on `globalThis` (each plugin only gets a shallow copy of `app`, so `app`
+ * properties don't cross plugin boundaries). Returns undefined until
+ * signalk-container's start() has run, or when it is disabled/uninstalled.
+ */
+export declare function getContainerManager(): ContainerManagerApi | undefined;
+export interface WaitForManagerOptions {
+    /** Overall deadline for both phases. Default 60_000. */
+    timeoutMs?: number;
+    /** Poll interval while the global is absent. Default 500. */
+    intervalMs?: number;
+    /** Progress callback, e.g. to update the plugin status line per phase. */
+    onWaiting?: (phase: "manager" | "runtime") => void;
+}
+export interface ManagerWaitResult {
+    /**
+     * The manager global, or undefined if signalk-container never appeared
+     * within the deadline (not installed / not enabled).
+     */
+    manager: ContainerManagerApi | undefined;
+    /**
+     * Detected runtime, or null when detection failed or hasn't settled —
+     * `manager && !runtime` means "signalk-container is present but found no
+     * usable podman/docker", which deserves a different error message than a
+     * missing manager.
+     */
+    runtime: ContainerRuntimeInfo | null;
+}
+/**
+ * Two-phase wait for a usable container manager:
+ *
+ *  1. Poll `globalThis.__signalk_containerManager` — plugins start in
+ *     alphabetical order, so consumers loading before signalk-container see
+ *     undefined for a while.
+ *  2. Wait for runtime detection to settle: `whenReady()` when available
+ *     (signalk-container 1.6.0+), otherwise poll `getRuntime()`. whenReady
+ *     resolves on success OR failure, so the runtime is re-checked after.
+ *
+ * Never throws; inspect the result to pick the right error message.
+ */
+export declare function waitForContainerManager(options?: WaitForManagerOptions): Promise<ManagerWaitResult>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG5E;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,GAAG,SAAS,CAErE;AAED,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACzC;;;;;OAKG;IACH,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}

package/dist/manager.js

@@ -0,0 +1,50 @@
+import { sleep } from "./util.js";
+/**
+ * Read the cross-plugin manager global. signalk-container publishes its API
+ * on `globalThis` (each plugin only gets a shallow copy of `app`, so `app`
+ * properties don't cross plugin boundaries). Returns undefined until
+ * signalk-container's start() has run, or when it is disabled/uninstalled.
+ */
+export function getContainerManager() {
+    return globalThis.__signalk_containerManager;
+}
+/**
+ * Two-phase wait for a usable container manager:
+ *
+ *  1. Poll `globalThis.__signalk_containerManager` — plugins start in
+ *     alphabetical order, so consumers loading before signalk-container see
+ *     undefined for a while.
+ *  2. Wait for runtime detection to settle: `whenReady()` when available
+ *     (signalk-container 1.6.0+), otherwise poll `getRuntime()`. whenReady
+ *     resolves on success OR failure, so the runtime is re-checked after.
+ *
+ * Never throws; inspect the result to pick the right error message.
+ */
+export async function waitForContainerManager(options = {}) {
+    const { timeoutMs = 60_000, intervalMs = 500, onWaiting } = options;
+    const deadline = Date.now() + timeoutMs;
+    let manager = getContainerManager();
+    while (!manager && Date.now() < deadline) {
+        onWaiting?.("manager");
+        await sleep(intervalMs);
+        manager = getContainerManager();
+    }
+    if (!manager) {
+        return { manager: undefined, runtime: null };
+    }
+    if (!manager.getRuntime()) {
+        onWaiting?.("runtime");
+        if (typeof manager.whenReady === "function") {
+            const remaining = Math.max(0, deadline - Date.now());
+            await Promise.race([manager.whenReady(), sleep(remaining)]);
+        }
+        else {
+            // Pre-1.6.0 fallback: poll until detection settles or the deadline hits.
+            while (!manager.getRuntime() && Date.now() < deadline) {
+                await sleep(intervalMs);
+            }
+        }
+    }
+    return { manager, runtime: manager.getRuntime() };
+}
+//# sourceMappingURL=manager.js.map

package/dist/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,0BAA0B,CAAC;AAC/C,CAAC;AA0BD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAiC,EAAE;IAEnC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,UAAU,GAAG,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,IAAI,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACpC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QACzC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;QACvB,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAC1B,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;QACvB,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACrD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,yEAAyE;YACzE,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBACtD,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;AACpD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,493 @@
+/**
+ * Canonical TypeScript mirror of signalk-container's public API surface.
+ *
+ * signalk-container is a runtime-only dependency: consumer plugins must NOT
+ * import it at compile time or declare it in npm dependencies/peerDependencies
+ * (its prerelease versioning breaks npm semver ranges). The coupling happens
+ * exclusively through `globalThis.__signalk_containerManager`, declared at the
+ * bottom of this file. Declare the relationship in package.json instead:
+ *
+ *   "signalk": { "requires": ["signalk-container"] }
+ *
+ * Source of truth: https://github.com/dirkwa/signalk-container
+ *   (src/types.ts and src/updates/types.ts)
+ * Last synced against signalk-container: v1.22.0
+ * Supported baseline: v1.6.0 — members newer than the baseline are optional
+ * here so call sites are forced to feature-detect. Version floors are noted
+ * on each member.
+ */
+export type RuntimeName = "podman" | "docker";
+export interface ContainerRuntimeInfo {
+    runtime: RuntimeName;
+    version: string;
+    /** @deprecated Always `false` since the move to the socket client. */
+    isPodmanDockerShim?: boolean;
+    /** cgroup v2 controllers available to this runtime; `null` = not probed. */
+    cgroupControllers?: string[] | null;
+    /** Whether the runtime operates rootless; `null` = not probed. */
+    isRootless?: boolean | null;
+    /** Effective host uid/gid of the Signal K process; `null` on Windows. */
+    hostUser?: {
+        uid: number;
+        gid: number;
+    } | null;
+    /** Unix socket the runtime client resolved to (diagnostic). */
+    socketPath?: string;
+}
+export type ContainerState = "running" | "stopped" | "missing" | "no-runtime";
+/**
+ * Per-volume policy when the host source path is missing at create time.
+ * Named volumes (no leading `/` or `.`) always pass through.
+ */
+export interface VolumeSpec {
+    /** Host path or named-volume string — same shape as the bare-string form. */
+    source: string;
+    /**
+     * - `'create'` (default): runtime creates the host dir. Plugin state dirs.
+     * - `'skip'`: drop the mount when missing. Optional USB/NFS mounts.
+     * - `'abort'`: throw from ensureRunning. Required mounts (certs, secrets).
+     */
+    ifMissing?: "create" | "skip" | "abort";
+}
+/** Event delivered to `EnsureRunningOptions.onVolumeIssue`. */
+export interface VolumeIssue {
+    containerPath: string;
+    source: string;
+    action: "skipped" | "aborted" | "recovered";
+    reason: string;
+}
+/** Event delivered to `EnsureRunningOptions.onUlimitClamped` (1.17.0+). */
+export interface UlimitClamp {
+    ulimit: string;
+    requested: number;
+    granted: number;
+    reason: string;
+}
+/**
+ * Explicit healthcheck for a managed container (config field is 1.14.0+;
+ * silently ignored by older versions). `false` emits `--no-healthcheck`.
+ */
+export type HealthcheckOverride = false | {
+    /** Docker HEALTHCHECK array form: ["CMD", ...] or ["CMD-SHELL", "<shell>"]. */
+    test: string[];
+    /** e.g. "30s" — durations are passed to the runtime verbatim. */
+    interval?: string;
+    timeout?: string;
+    /** Grace period before failures count, e.g. "15s". */
+    startPeriod?: string;
+    retries?: number;
+};
+/**
+ * Resource limits applied via podman/docker run flags. Omitted = no limit;
+ * `null` in a user override explicitly removes a plugin-set limit.
+ */
+export interface ContainerResourceLimits {
+    /** Hard CPU cap (CFS quota), e.g. 1.5 = 1.5 cores. */
+    cpus?: number | null;
+    /** Soft CPU weight under contention (default 1024). */
+    cpuShares?: number | null;
+    /** Pin to specific cores, e.g. "0,1" or "1-3". */
+    cpusetCpus?: string | null;
+    /** Hard memory cap, e.g. "512m", "2g". */
+    memory?: string | null;
+    /** Total memory + swap; set equal to `memory` to disable swap. */
+    memorySwap?: string | null;
+    /** Soft floor — kernel reclaims from containers above this first. */
+    memoryReservation?: string | null;
+    /** Process/thread cap. */
+    pidsLimit?: number | null;
+    /** OOM score adjustment, -1000..1000. Higher = killed first. */
+    oomScoreAdj?: number | null;
+}
+/**
+ * Declarative desired state for a managed container. Pass the same config to
+ * `ensureRunning` on every plugin start — signalk-container diffs it against
+ * the live container and removes + recreates when `image`, `tag`, `command`,
+ * `networkMode`, `env`, `volumes`, or `ports` differ. `restart`, `labels`,
+ * `healthcheck`, and `ulimits` are NOT part of drift detection.
+ */
+export interface ContainerConfig {
+    /** Image repo without tag, e.g. "ghcr.io/questdb/questdb". */
+    image: string;
+    tag: string;
+    /** Manifest digest ("sha256:<64-hex>"); pulls `image@digest` when set. */
+    digest?: string;
+    /** Update channel: "tag:<pattern>" | "tag:latest" | "digest:explicit". */
+    updateChannel?: string;
+    /**
+     * When true and `tag` is floating (latest/main/edge/…), every
+     * ensureRunning pulls and recreates on digest drift. Offline pull
+     * failures are silently skipped. 1.9.0+.
+     */
+    autoUpdateOnFloatingTag?: boolean;
+    /** "containerPort/proto" → "hostIp:hostPort". Ignored with networkMode. */
+    ports?: Record<string, string>;
+    /** container path → host path | named volume | VolumeSpec. */
+    volumes?: Record<string, string | VolumeSpec>;
+    /**
+     * Mount the plugin's Signal K data dir (app.getDataDirPath()) at this
+     * container path; the host-side source is resolved automatically for
+     * bare-metal and containerized Signal K deployments.
+     */
+    signalkDataMount?: string;
+    /** Mount the whole Signal K config root (~/.signalk) here. 1.5.0+. */
+    signalkConfigRootMount?: string;
+    /**
+     * Container ports the Signal K process must reach back into; networking
+     * strategy is chosen automatically. Read the result with
+     * `resolveContainerAddress()` after `ensureRunning()`.
+     */
+    signalkAccessiblePorts?: number[];
+    env?: Record<string, string>;
+    /** Defaults to "unless-stopped" when omitted. */
+    restart?: "no" | "unless-stopped" | "always";
+    /**
+     * Set consistently across calls: toggling between an explicit command and
+     * undefined looks like drift on every ensureRunning.
+     */
+    command?: string[];
+    networkMode?: string;
+    /** hostname → IP (or "host-gateway") entries for /etc/hosts. */
+    extraHosts?: Record<string, string>;
+    /**
+     * Host-UID ownership mapping. Omit for the default (image runs as root,
+     * files on bind mounts owned by the Signal K user). Set
+     * `{ inImageUid, inImageGid }` when the image declares a non-root USER.
+     * `false` opts out entirely.
+     */
+    user?: {
+        inImageUid?: number;
+        inImageGid?: number;
+    } | false;
+    /** Plugin-default resource limits; users override per-field. */
+    resources?: ContainerResourceLimits;
+    /**
+     * Per-process ulimits, e.g. `{ nofile: 1048576 }`. `nofile` is clamped
+     * to the host ceiling (see onUlimitClamped). 1.17.0+ (ignored earlier).
+     */
+    ulimits?: Record<string, number | {
+        soft: number;
+        hard: number;
+    }>;
+    /** Informational labels (not drift-detected). */
+    labels?: Record<string, string>;
+    /** Explicit healthcheck override. 1.14.0+ (ignored earlier). */
+    healthcheck?: HealthcheckOverride;
+}
+export interface ContainerInfo {
+    /** Full name as the runtime sees it, e.g. "sk-questdb". */
+    name: string;
+    /**
+     * `name` with the namespace prefix removed, e.g. "questdb" — the form
+     * consumer plugins pass to ensureRunning. The namespace is "sk" only by
+     * default (configurable via SIGNALK_CONTAINER_NAMESPACE), so this is the
+     * only reliable key for matching a container by its unprefixed name.
+     * Present in every signalk-container that supports namespacing; when
+     * absent (a very old version), fall back to a namespace-agnostic
+     * name-suffix match rather than assuming an "sk-" prefix.
+     */
+    unprefixedName?: string;
+    image: string;
+    state: ContainerState;
+    created?: string;
+    /** e.g. ["127.0.0.1:3010->3010/tcp"] */
+    ports?: string[];
+    managedBy?: string;
+}
+/** Options bag accepted by `ensureRunning` / `recreate`. */
+export interface EnsureRunningOptions {
+    /** Custom app-level health probe (legacy HealthCheckOptions). */
+    healthCheck?: () => Promise<boolean>;
+    onUnhealthy?: (name: string, error: string) => void;
+    /** Fires for volume skip/abort/recovery events. Never awaited. */
+    onVolumeIssue?: (event: VolumeIssue) => void | Promise<void>;
+    /** Stream the container's stdout/stderr lines (1.7.0+). Never awaited. */
+    onContainerLog?: (line: string) => void | Promise<void>;
+    /** Backfill the last N lines when (re)attaching the log stream. */
+    onContainerLogStartTail?: number;
+    /** Fired when a requested ulimit was lowered to the host ceiling (1.17.0+). */
+    onUlimitClamped?: (event: UlimitClamp) => void;
+    /** npm package name — opt-in to digest pinning manifests. */
+    pluginId?: string;
+    pluginVersion?: string;
+}
+export interface ContainerJobConfig {
+    image: string;
+    command: string[];
+    /** Override the image's baked ENTRYPOINT. */
+    entrypoint?: string[];
+    /** container path → host path, mounted read-only. */
+    inputs?: Record<string, string>;
+    /** container path → host path, mounted read-write. */
+    outputs?: Record<string, string>;
+    env?: Record<string, string>;
+    /** Seconds. */
+    timeout?: number;
+    onProgress?: (msg: string) => void;
+    onStdoutLine?: (line: string) => void;
+    onStderrLine?: (line: string) => void;
+    resources?: ContainerResourceLimits;
+    label?: string;
+    /** Strongly recommended: enables cleanupOrphanedJobs reaping (1.3.0+). */
+    ownerPluginId?: string;
+    user?: {
+        inImageUid?: number;
+        inImageGid?: number;
+    } | false;
+    /** Cancel mid-run; resolves with status "cancelled" (1.16.0+). */
+    signal?: AbortSignal;
+}
+export type ContainerJobStatus = "pending" | "pulling" | "running" | "completed" | "failed" | "cancelled";
+export interface ContainerJobResult {
+    id: string;
+    status: ContainerJobStatus;
+    image: string;
+    command: string[];
+    label?: string;
+    exitCode?: number;
+    log: string[];
+    error?: string;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    runtime?: RuntimeName;
+}
+export interface PruneResult {
+    imagesRemoved: number;
+    spaceReclaimed: string;
+}
+export interface OrphanJobInfo {
+    name: string;
+    image: string;
+    ownerPluginId: string;
+    label?: string;
+}
+export interface CleanupOrphansResult {
+    reaped: OrphanJobInfo[];
+}
+export interface UpdateResourcesResult {
+    method: "live" | "recreated";
+    warnings?: string[];
+}
+export type VersionSourceResult = {
+    kind: "version";
+    latest: string;
+    metadata?: Record<string, unknown>;
+} | {
+    kind: "digest";
+    remoteDigest: string;
+} | {
+    kind: "error";
+    error: string;
+};
+/** Pluggable "latest available version" strategy. Built via `updates.sources`. */
+export interface VersionSource {
+    fetch(runtime: ContainerRuntimeInfo): Promise<VersionSourceResult>;
+}
+export interface UpdateRegistration {
+    /** Registration key — your plugin id. */
+    pluginId: string;
+    /** Container name as passed to ensureRunning (unprefixed). */
+    containerName: string;
+    /** Image repo without tag. */
+    image: string;
+    /**
+     * MUST be a function (not a captured value) so live config edits are
+     * picked up without re-registering.
+     */
+    currentTag: () => string;
+    versionSource: VersionSource;
+    /**
+     * Query the running container for its version directly; when non-null it
+     * takes precedence over currentTag() for the comparison.
+     */
+    currentVersion?: () => Promise<string | null>;
+    /** e.g. "24h" (default), "1h" minimum. */
+    checkInterval?: string;
+}
+export type UpdateReason = "newer-version" | "digest-drift" | "older-than-pinned" | "up-to-date" | "offline" | "unknown" | "error";
+export type TagKind = "semver" | "floating" | "unknown";
+export interface UpdateCheckResult {
+    pluginId: string;
+    containerName: string;
+    runningTag: string;
+    tagKind: TagKind;
+    currentVersion: string | null;
+    latestVersion: string | null;
+    updateAvailable: boolean;
+    reason: UpdateReason;
+    error?: string;
+    checkedAt: string;
+    lastSuccessfulCheckAt: string | null;
+    /** True when reason === "offline" and cached data was returned. */
+    fromCache: boolean;
+}
+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;
+            token?: string;
+        }): VersionSource;
+        dockerHubTags(image: string, options?: {
+            filter?: (tag: string) => boolean;
+        }): VersionSource;
+    };
+}
+export interface HistoryEntry {
+    ts: string;
+    from: string | null;
+    to: string;
+    reason: "plugin-install" | "plugin-update" | "user-pull" | "auto-update" | "manual-check";
+    triggeredBy?: string;
+}
+export interface ConsumerManifest {
+    schemaVersion: 1;
+    pluginId: string;
+    pluginVersion: string;
+    registeredAt: string;
+    containers: Record<string, {
+        image: string;
+        declaredTag: string;
+        declaredDigest: string | null;
+        resolvedDigest: string;
+        resolvedAt: string;
+        updateChannel: string;
+        history: HistoryEntry[];
+    }>;
+}
+export interface ManifestApi {
+    get(pluginId: string): Promise<ConsumerManifest | null>;
+    list(): Promise<ConsumerManifest[]>;
+    getContainerHistory(containerName: string): Promise<HistoryEntry[]>;
+}
+export type SelfDeploymentStatus = "ok" | "no-runtime" | "socket-unreachable" | "permission-denied" | "self-id-unresolved";
+export interface SelfDeploymentResult {
+    status: SelfDeploymentStatus;
+    /** Copy-pasteable remediation lines for failure statuses. */
+    remediation?: string[];
+    [key: string]: unknown;
+}
+export interface SetupSnippetResult {
+    snippet: string;
+    dockerfile?: string;
+    notes?: string[];
+}
+export interface DoctorApi {
+    /** Probe an image under the host-UID mapping. Never throws (1.8.0+). */
+    imageRunsAsUser(image: string, user?: {
+        inImageUid?: number;
+        inImageGid?: number;
+    } | false): Promise<{
+        ok: boolean;
+        output: string;
+        error?: string;
+    }>;
+    /** Diagnose the Signal K deployment itself. Never throws (1.9.0+). */
+    selfDeployment(): Promise<SelfDeploymentResult>;
+    /** Templated compose/run snippet for socket wiring (1.10.0+). */
+    generateSetupSnippet(format?: "compose" | "run", result?: SelfDeploymentResult): Promise<SetupSnippetResult>;
+}
+export interface ContainerManagerApi {
+    /** Detected runtime, or null while detection is in flight / failed. */
+    getRuntime(): ContainerRuntimeInfo | null;
+    /**
+     * Resolves once runtime detection settles (success OR failure) — re-check
+     * `getRuntime()` afterwards to tell the two apart. 1.6.0+.
+     */
+    whenReady(): Promise<void>;
+    /** `image` is the joined "repo:tag" form here (unlike ContainerConfig). */
+    pullImage(image: string, onProgress?: (msg: string) => void): Promise<void>;
+    imageExists(image: string): Promise<boolean>;
+    /** Local sha256 image id for an image ref or container name. 1.6.0+. */
+    getImageDigest(imageOrContainer: string): Promise<string | null>;
+    /**
+     * Idempotent declarative reconcile: create+start if missing, start if
+     * stopped, remove+recreate on config drift.
+     */
+    ensureRunning(name: string, config: ContainerConfig, options?: EnsureRunningOptions): Promise<void>;
+    /**
+     * Force-recreate regardless of drift detection ("update now", startup
+     * self-heal). 1.12.0+ — feature-detect.
+     */
+    recreate?(name: string, config: ContainerConfig, options?: EnsureRunningOptions): Promise<void>;
+    start(name: string): Promise<void>;
+    /** Idempotent. */
+    stop(name: string): Promise<void>;
+    /** Stops and removes. Idempotent. */
+    remove(name: string): Promise<void>;
+    /**
+     * Remove a container AND its bind-mount data dir, handling the
+     * rootless-Podman subuid ownership trap. 1.18.0+ — feature-detect.
+     */
+    removeManagedData?(name: string, hostPath: string, options?: {
+        ownerPluginId?: string;
+    }): Promise<void>;
+    getState(name: string): Promise<ContainerState>;
+    /** Lists managed (namespace-prefixed) containers. */
+    listContainers(): Promise<ContainerInfo[]>;
+    /** Live-update resource limits, falling back to recreate. */
+    updateResources(name: string, limits: ContainerResourceLimits): Promise<UpdateResourcesResult>;
+    /** Effective merged limits ({} when untracked). */
+    getResources(name: string): ContainerResourceLimits;
+    /**
+     * host:port (or container-name:port) for a port declared via
+     * `signalkAccessiblePorts`, after ensureRunning.
+     */
+    resolveContainerAddress(containerName: string, containerPort: number): Promise<string | null>;
+    /** Host source backing app.getDataDirPath() in this deployment. */
+    resolveSignalkDataMount?(): Promise<string | null>;
+    /**
+     * Translate an absolute path to the (source, subPath) mountable by the
+     * host runtime. Null when unreachable. 1.7.0+ — feature-detect.
+     */
+    resolveHostPath?(absPath: string): Promise<{
+        source: string;
+        subPath: string;
+    } | null>;
+    /** Run a one-shot helper container to completion. */
+    runJob(config: ContainerJobConfig): Promise<ContainerJobResult>;
+    /** Last N lines of combined stdout/stderr. 1.7.0+ — feature-detect. */
+    getLogs?(name: string, options?: {
+        tail?: number;
+        since?: number;
+    }): Promise<string[]>;
+    /** Reap sk-job-* containers leaked by a crash. 1.3.0+. */
+    cleanupOrphanedJobs(filter: {
+        ownerPluginId: string;
+    }): Promise<CleanupOrphansResult>;
+    prune(): Promise<PruneResult>;
+    execInContainer?(name: string, command: string[]): Promise<{
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+    }>;
+    ensureNetwork?(name: string): Promise<void>;
+    removeNetwork?(name: string): Promise<void>;
+    connectToNetwork?(containerName: string, networkName: string): Promise<void>;
+    disconnectFromNetwork?(containerName: string, networkName: string): Promise<void>;
+    updates: UpdateServiceApi;
+    /** 1.13.0+ — feature-detect. */
+    manifest?: ManifestApi;
+    /** 1.8.0+ — feature-detect. */
+    doctor?: DoctorApi;
+}
+declare global {
+    var __signalk_containerManager: ContainerManagerApi | undefined;
+}
+/**
+ * Minimal slice of the Signal K plugin `app` object the helpers need.
+ * Status/error setters take ONE argument — the server pre-binds the plugin id.
+ */
+export interface AppLike {
+    debug: (msg: string) => void;
+    error?: (msg: string) => void;
+    setPluginStatus: (msg: string) => void;
+    setPluginError: (msg: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/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/dist/types.js

@@ -0,0 +1,20 @@
+/**
+ * Canonical TypeScript mirror of signalk-container's public API surface.
+ *
+ * signalk-container is a runtime-only dependency: consumer plugins must NOT
+ * import it at compile time or declare it in npm dependencies/peerDependencies
+ * (its prerelease versioning breaks npm semver ranges). The coupling happens
+ * exclusively through `globalThis.__signalk_containerManager`, declared at the
+ * bottom of this file. Declare the relationship in package.json instead:
+ *
+ *   "signalk": { "requires": ["signalk-container"] }
+ *
+ * Source of truth: https://github.com/dirkwa/signalk-container
+ *   (src/types.ts and src/updates/types.ts)
+ * Last synced against signalk-container: v1.22.0
+ * Supported baseline: v1.6.0 — members newer than the baseline are optional
+ * here so call sites are forced to feature-detect. Version floors are noted
+ * on each member.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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