@ostanin/podman 0.1.0

package/esm/api/system.js

@@ -0,0 +1,98 @@
+import { createPodmanError } from "../types/errors.js";
+import { buildQuery } from "../internal/query.js";
+export class SystemApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Return information about the Podman host. */
+    async info() {
+        const path = "/info";
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** Return component version information for the Podman service. */
+    async version() {
+        const path = "/version";
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** Ping the Podman service. Returns `true` if reachable. */
+    async ping() {
+        // /_ping returns plain text "OK", not JSON — use requestRaw
+        const res = await this.#t.requestRaw("GET", "/_ping");
+        await res.body?.cancel();
+        return res.status === 200;
+    }
+    /** Prune unused data (containers, images, volumes, networks). */
+    async prune() {
+        const path = "/system/prune";
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return json;
+    }
+    /** Return disk usage information (containers, images, volumes). */
+    async df() {
+        const path = "/system/df";
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** Stream system events as raw bytes. */
+    async events(query) {
+        const path = `/events${buildQuery(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Stream system events as parsed JSON objects. */
+    async *parsedEvents(query) {
+        const stream = await this.events(query);
+        const reader = stream.pipeThrough(new TextDecoderStream()).getReader();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += value;
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed) {
+                        try {
+                            yield JSON.parse(trimmed);
+                        }
+                        catch {
+                            // Skip malformed JSON lines (e.g. truncated stream)
+                        }
+                    }
+                }
+            }
+            if (buffer.trim()) {
+                try {
+                    yield JSON.parse(buffer.trim());
+                }
+                catch {
+                    // Skip malformed trailing data
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /** Run a consistency check on container storage. */
+    async check(query) {
+        const path = `/system/check${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return json;
+    }
+}

package/esm/api/volumes.d.ts

@@ -0,0 +1,23 @@
+import type { Transport } from "../transport.js";
+import type { VolumeConfigResponse, VolumeCreateOptions, VolumeRemoveQuery, VolumeListQuery, VolumePruneQuery, VolumePruneReport } from "../types/api.js";
+export declare class VolumesApi {
+    #private;
+    constructor(transport: Transport);
+    /** Create a new volume. */
+    create(opts: VolumeCreateOptions): Promise<VolumeConfigResponse>;
+    /** Inspect a volume. Returns `null` if the volume is not found. */
+    inspect(nameOrId: string): Promise<VolumeConfigResponse | null>;
+    /** List volumes, optionally filtered by the given query. */
+    list(query?: VolumeListQuery): Promise<VolumeConfigResponse[]>;
+    /** Remove a volume. */
+    remove(nameOrId: string, query?: VolumeRemoveQuery): Promise<void>;
+    /** Check if a volume exists. Returns `true` on 204, `false` otherwise. */
+    exists(nameOrId: string): Promise<boolean>;
+    /** Remove unused volumes. Returns a list of pruned volumes. */
+    prune(query?: VolumePruneQuery): Promise<VolumePruneReport[]>;
+    /** Export a volume as a tar archive stream. */
+    export(nameOrId: string): Promise<ReadableStream<Uint8Array>>;
+    /** Import a tar archive into a volume. */
+    import(nameOrId: string, body: ReadableStream<Uint8Array>): Promise<void>;
+}
+//# sourceMappingURL=volumes.d.ts.map

package/esm/api/volumes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volumes.d.ts","sourceRoot":"","sources":["../../src/api/volumes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,UAAU;;gBAET,SAAS,EAAE,SAAS;IAIhC,2BAA2B;IACrB,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAOtE,mEAAmE;IAC7D,OAAO,CACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAQvC,4DAA4D;IACtD,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOpE,uBAAuB;IACjB,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC;IAOhB,0EAA0E;IACpE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhD,+DAA+D;IACzD,KAAK,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAOnE,+CAA+C;IACzC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAKnE,0CAA0C;IACpC,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;CAOjB"}

package/esm/api/volumes.js

@@ -0,0 +1,69 @@
+import { createPodmanError, throwRawError } from "../types/errors.js";
+import { buildQuery } from "../internal/query.js";
+export class VolumesApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Create a new volume. */
+    async create(opts) {
+        const path = "/volumes/create";
+        const { status, json } = await this.#t.request("POST", path, opts);
+        if (status !== 201)
+            throw createPodmanError(status, json, "POST", path);
+        return json;
+    }
+    /** Inspect a volume. Returns `null` if the volume is not found. */
+    async inspect(nameOrId) {
+        const path = `/volumes/${encodeURIComponent(nameOrId)}/json`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status === 404)
+            return null;
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** List volumes, optionally filtered by the given query. */
+    async list(query) {
+        const path = `/volumes/json${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Remove a volume. */
+    async remove(nameOrId, query) {
+        const path = `/volumes/${encodeURIComponent(nameOrId)}${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 204)
+            throw createPodmanError(status, json, "DELETE", path);
+    }
+    /** Check if a volume exists. Returns `true` on 204, `false` otherwise. */
+    async exists(nameOrId) {
+        const path = `/volumes/${encodeURIComponent(nameOrId)}/exists`;
+        const { status } = await this.#t.request("GET", path);
+        return status === 204;
+    }
+    /** Remove unused volumes. Returns a list of pruned volumes. */
+    async prune(query) {
+        const path = `/volumes/prune${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return (json ?? []);
+    }
+    /** Export a volume as a tar archive stream. */
+    async export(nameOrId) {
+        const path = `/volumes/${encodeURIComponent(nameOrId)}/export`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Import a tar archive into a volume. */
+    async import(nameOrId, body) {
+        const path = `/volumes/${encodeURIComponent(nameOrId)}/import`;
+        const res = await this.#t.requestRaw("POST", path, body, {
+            "Content-Type": "application/x-tar",
+        });
+        if (res.status !== 204)
+            await throwRawError(res, "POST", path);
+    }
+}

package/esm/client.d.ts

@@ -0,0 +1,56 @@
+import { type TlsOptions } from "./transport.js";
+import { type SshTransportOptions } from "./ssh_transport.js";
+import type { AuthOption } from "./transport_core.js";
+import { ContainersApi } from "./api/containers.js";
+import { ImagesApi } from "./api/images.js";
+import { NetworksApi } from "./api/networks.js";
+import { VolumesApi } from "./api/volumes.js";
+import { PodsApi } from "./api/pods.js";
+import { SecretsApi } from "./api/secrets.js";
+import { SystemApi } from "./api/system.js";
+import { ExecApi } from "./api/exec.js";
+import { GenerateApi } from "./api/generate.js";
+import { ManifestsApi } from "./api/manifests.js";
+import { KubeApi } from "./api/kube.js";
+import { ArtifactsApi } from "./api/artifacts.js";
+import { QuadletsApi } from "./api/quadlets.js";
+/** Options for connecting to Podman via a Unix socket. */
+export interface UnixClientOptions {
+    socketPath: string;
+    apiVersion?: string;
+    timeout?: number;
+    auth?: AuthOption;
+}
+/** Options for connecting to Podman via TCP or TLS. */
+export interface TcpClientOptions {
+    uri: string;
+    apiVersion?: string;
+    timeout?: number;
+    auth?: AuthOption;
+    tls?: TlsOptions;
+}
+/** Union of all client connection options (Unix socket or TCP/TLS). */
+export type ClientOptions = UnixClientOptions | TcpClientOptions;
+export type SshClientOptions = SshTransportOptions;
+/** Client interface exposing all 13 Podman libpod API modules. */
+export interface PodmanClient {
+    containers: ContainersApi;
+    images: ImagesApi;
+    networks: NetworksApi;
+    volumes: VolumesApi;
+    pods: PodsApi;
+    secrets: SecretsApi;
+    system: SystemApi;
+    exec: ExecApi;
+    generate: GenerateApi;
+    manifests: ManifestsApi;
+    kube: KubeApi;
+    artifacts: ArtifactsApi;
+    quadlets: QuadletsApi;
+    close(): void;
+}
+/** Create a Podman client using a Unix socket or TCP/TLS connection. */
+export declare function createClient(opts: ClientOptions): PodmanClient;
+/** Create a Podman client tunneled over SSH. Requires `ssh` on the local machine. */
+export declare function createSshClient(opts: SshClientOptions): Promise<PodmanClient>;
+//# sourceMappingURL=client.d.ts.map

package/esm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAGhB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEnD,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,aAAa,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,YAAY,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAuBD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAsB9D;AAED,qFAAqF;AACrF,wBAAsB,eAAe,CACnC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,YAAY,CAAC,CAGvB"}

package/esm/client.js

@@ -0,0 +1,63 @@
+import { createTcpTransport, createTransport, } from "./transport.js";
+import { createSshTransport, } from "./ssh_transport.js";
+import { ContainersApi } from "./api/containers.js";
+import { ImagesApi } from "./api/images.js";
+import { NetworksApi } from "./api/networks.js";
+import { VolumesApi } from "./api/volumes.js";
+import { PodsApi } from "./api/pods.js";
+import { SecretsApi } from "./api/secrets.js";
+import { SystemApi } from "./api/system.js";
+import { ExecApi } from "./api/exec.js";
+import { GenerateApi } from "./api/generate.js";
+import { ManifestsApi } from "./api/manifests.js";
+import { KubeApi } from "./api/kube.js";
+import { ArtifactsApi } from "./api/artifacts.js";
+import { QuadletsApi } from "./api/quadlets.js";
+function buildPodmanClient(transport) {
+    return {
+        containers: new ContainersApi(transport),
+        images: new ImagesApi(transport),
+        networks: new NetworksApi(transport),
+        volumes: new VolumesApi(transport),
+        pods: new PodsApi(transport),
+        secrets: new SecretsApi(transport),
+        system: new SystemApi(transport),
+        exec: new ExecApi(transport),
+        generate: new GenerateApi(transport),
+        manifests: new ManifestsApi(transport),
+        kube: new KubeApi(transport),
+        artifacts: new ArtifactsApi(transport),
+        quadlets: new QuadletsApi(transport),
+        close() {
+            transport.close();
+        },
+    };
+}
+/** Create a Podman client using a Unix socket or TCP/TLS connection. */
+export function createClient(opts) {
+    let transport;
+    if ("socketPath" in opts) {
+        const transportOpts = {
+            socketPath: opts.socketPath,
+            apiVersion: opts.apiVersion,
+            timeout: opts.timeout,
+            auth: opts.auth,
+        };
+        transport = createTransport(transportOpts);
+    }
+    else {
+        transport = createTcpTransport({
+            uri: opts.uri,
+            apiVersion: opts.apiVersion,
+            timeout: opts.timeout,
+            auth: opts.auth,
+            tls: opts.tls,
+        });
+    }
+    return buildPodmanClient(transport);
+}
+/** Create a Podman client tunneled over SSH. Requires `ssh` on the local machine. */
+export async function createSshClient(opts) {
+    const transport = await createSshTransport(opts);
+    return buildPodmanClient(transport);
+}

package/esm/internal/query.d.ts

@@ -0,0 +1,2 @@
+export declare function buildQuery<T extends object>(params?: T): string;
+//# sourceMappingURL=query.d.ts.map

package/esm/internal/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/internal/query.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CA0B/D"}

package/esm/internal/query.js

@@ -0,0 +1,24 @@
+export function buildQuery(params) {
+    if (!params)
+        return "";
+    const entries = Object.entries(params).filter(([_, v]) => v !== undefined);
+    if (entries.length === 0)
+        return "";
+    const parts = [];
+    for (const [k, v] of entries) {
+        if (Array.isArray(v)) {
+            // Arrays → repeated query params: ?names=foo&names=bar
+            for (const item of v) {
+                parts.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(item))}`);
+            }
+        }
+        else if (typeof v === "object" && v !== null) {
+            // Objects (e.g. filters) → JSON-encoded
+            parts.push(`${encodeURIComponent(k)}=${encodeURIComponent(JSON.stringify(v))}`);
+        }
+        else {
+            parts.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
+        }
+    }
+    return parts.length > 0 ? `?${parts.join("&")}` : "";
+}

package/esm/mod.d.ts

@@ -0,0 +1,22 @@
+import "./_dnt.polyfills.js";
+export { type ClientOptions, createClient, createSshClient, type PodmanClient, type SshClientOptions, type TcpClientOptions, type UnixClientOptions, } from "./client.js";
+export { PodmanError, createPodmanError, throwRawError } from "./types/errors.js";
+export { createTcpTransport, createTransport, type TcpTransportOptions, type TlsOptions, type Transport, type TransportOptions, type TransportResponse, } from "./transport.js";
+export { createSshTransport, type SshTransportOptions, } from "./ssh_transport.js";
+export type { AuthOption } from "./transport_core.js";
+export type * from "./types/api.js";
+export { ContainersApi } from "./api/containers.js";
+export { ImagesApi } from "./api/images.js";
+export { NetworksApi } from "./api/networks.js";
+export { VolumesApi } from "./api/volumes.js";
+export { PodsApi } from "./api/pods.js";
+export { SecretsApi } from "./api/secrets.js";
+export { SystemApi } from "./api/system.js";
+export { ExecApi } from "./api/exec.js";
+export { GenerateApi } from "./api/generate.js";
+export { ManifestsApi } from "./api/manifests.js";
+export { KubeApi } from "./api/kube.js";
+export { ArtifactsApi } from "./api/artifacts.js";
+export { QuadletsApi } from "./api/quadlets.js";
+export type { QuadletInstallReport } from "./api/quadlets.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,mBAAmB,gBAAgB,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/esm/mod.js

@@ -0,0 +1,18 @@
+import "./_dnt.polyfills.js";
+export { createClient, createSshClient, } from "./client.js";
+export { PodmanError, createPodmanError, throwRawError } from "./types/errors.js";
+export { createTcpTransport, createTransport, } from "./transport.js";
+export { createSshTransport, } from "./ssh_transport.js";
+export { ContainersApi } from "./api/containers.js";
+export { ImagesApi } from "./api/images.js";
+export { NetworksApi } from "./api/networks.js";
+export { VolumesApi } from "./api/volumes.js";
+export { PodsApi } from "./api/pods.js";
+export { SecretsApi } from "./api/secrets.js";
+export { SystemApi } from "./api/system.js";
+export { ExecApi } from "./api/exec.js";
+export { GenerateApi } from "./api/generate.js";
+export { ManifestsApi } from "./api/manifests.js";
+export { KubeApi } from "./api/kube.js";
+export { ArtifactsApi } from "./api/artifacts.js";
+export { QuadletsApi } from "./api/quadlets.js";

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/ssh_transport.d.ts

@@ -0,0 +1,14 @@
+import { type Transport } from "./transport.js";
+import type { AuthOption } from "./transport_core.js";
+export interface SshTransportOptions {
+    host: string;
+    remoteSocketPath?: string;
+    port?: number;
+    identityFile?: string;
+    sshOptions?: string[];
+    apiVersion?: string;
+    timeout?: number;
+    auth?: AuthOption;
+}
+export declare function createSshTransport(opts: SshTransportOptions): Promise<Transport>;
+//# sourceMappingURL=ssh_transport.d.ts.map

package/esm/ssh_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh_transport.d.ts","sourceRoot":"","sources":["../src/ssh_transport.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAWD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,SAAS,CAAC,CAyFpB"}

package/esm/ssh_transport.js

@@ -0,0 +1,85 @@
+import { spawn } from "node:child_process";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { createTransport } from "./transport.js";
+async function drainStderr(child) {
+    if (!child.stderr)
+        return "";
+    const chunks = [];
+    for await (const chunk of child.stderr) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+export async function createSshTransport(opts) {
+    const { host, remoteSocketPath = "/run/podman/podman.sock", port = 22, identityFile, sshOptions = [], apiVersion, timeout, auth, } = opts;
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "podman-deno-"));
+    const localSocket = path.join(tempDir, "podman.sock");
+    const hasStrictHostKeyChecking = sshOptions.some((o) => o.includes("StrictHostKeyChecking"));
+    const args = [
+        "-N",
+        "-L", `${localSocket}:${remoteSocketPath}`,
+        "-p", String(port),
+        ...(hasStrictHostKeyChecking
+            ? []
+            : ["-o", "StrictHostKeyChecking=accept-new"]),
+        "-o", "ExitOnForwardFailure=yes",
+    ];
+    if (identityFile)
+        args.push("-i", identityFile);
+    args.push(...sshOptions, host);
+    const child = spawn("ssh", args, {
+        stdio: ["ignore", "ignore", "pipe"],
+    });
+    let processExited = false;
+    const exitPromise = new Promise((resolve) => {
+        child.on("exit", () => {
+            processExited = true;
+            resolve();
+        });
+    });
+    const deadline = Date.now() + 10_000;
+    let ready = false;
+    while (Date.now() < deadline && !processExited) {
+        try {
+            await fs.stat(localSocket);
+            ready = true;
+            break;
+        }
+        catch {
+            await new Promise((r) => setTimeout(r, 100));
+        }
+    }
+    if (!ready) {
+        child.kill("SIGTERM");
+        let timerId;
+        const errText = await Promise.race([
+            drainStderr(child),
+            new Promise((r) => {
+                timerId = setTimeout(() => r(""), 5_000);
+            }),
+        ]);
+        clearTimeout(timerId);
+        await exitPromise;
+        await fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+        throw new Error(`SSH tunnel to ${host} failed: ${errText.trim() || "socket not created within 10s"}`);
+    }
+    const inner = createTransport({
+        socketPath: localSocket,
+        apiVersion,
+        timeout,
+        auth,
+    });
+    return {
+        request: inner.request,
+        requestRaw: inner.requestRaw,
+        requestStream: inner.requestStream,
+        getAuthHeader: inner.getAuthHeader,
+        close() {
+            inner.close();
+            child.kill("SIGTERM");
+            fs.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+        },
+    };
+}

package/esm/transport.d.ts

@@ -0,0 +1,23 @@
+import { type AuthOption, type Transport } from "./transport_core.js";
+export type { DoFetchFn, DoFetchInit, Transport, TransportResponse, } from "./transport_core.js";
+export interface TransportOptions {
+    socketPath: string;
+    apiVersion?: string;
+    timeout?: number;
+    auth?: AuthOption;
+}
+export declare function createTransport(opts: TransportOptions): Transport;
+export interface TlsOptions {
+    caCerts?: string[];
+    cert?: string;
+    key?: string;
+}
+export interface TcpTransportOptions {
+    uri: string;
+    apiVersion?: string;
+    timeout?: number;
+    auth?: AuthOption;
+    tls?: TlsOptions;
+}
+export declare function createTcpTransport(opts: TcpTransportOptions): Transport;
+//# sourceMappingURL=transport.d.ts.map

package/esm/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,UAAU,EAGf,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AA4E7B,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,CAuBjE;AAID,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,SAAS,CAyCvE"}

package/esm/transport.js

@@ -0,0 +1,112 @@
+import * as http from "node:http";
+import * as https from "node:https";
+import { buildTransport, } from "./transport_core.js";
+// ─── Node http.request → web Response adapter ────────────────────────────────
+function nodeRequest(url, options, body) {
+    return new Promise((resolve, reject) => {
+        const isHttps = url.startsWith("https:");
+        const requester = isHttps ? https.request : http.request;
+        const req = requester(url, options, (res) => {
+            const readable = new ReadableStream({
+                start(controller) {
+                    res.on("data", (chunk) => controller.enqueue(new Uint8Array(chunk)));
+                    res.on("end", () => controller.close());
+                    res.on("error", (err) => controller.error(err));
+                },
+                cancel() {
+                    res.destroy();
+                },
+            });
+            const headers = new Headers();
+            for (const [key, value] of Object.entries(res.headers)) {
+                if (value !== undefined) {
+                    headers.set(key, Array.isArray(value) ? value.join(", ") : value);
+                }
+            }
+            resolve(new Response(readable, { status: res.statusCode ?? 0, headers }));
+        });
+        req.on("error", reject);
+        if (body !== undefined && body !== null) {
+            if (typeof body === "string") {
+                req.end(body);
+                return;
+            }
+            if (body instanceof ArrayBuffer) {
+                req.end(Buffer.from(body));
+                return;
+            }
+            if (body instanceof Uint8Array) {
+                req.end(Buffer.from(body.buffer, body.byteOffset, body.byteLength));
+                return;
+            }
+            if (body instanceof ReadableStream) {
+                const reader = body.getReader();
+                (function pump() {
+                    reader.read().then(({ done, value }) => {
+                        if (done) {
+                            req.end();
+                            return;
+                        }
+                        req.write(Buffer.from(value));
+                        pump();
+                    }).catch((err) => {
+                        req.destroy(err);
+                        reject(err);
+                    });
+                })();
+                return;
+            }
+        }
+        req.end();
+    });
+}
+export function createTransport(opts) {
+    const { socketPath, apiVersion = "4.0.0", timeout = 30_000 } = opts;
+    const authHeader = opts.auth ? btoa(JSON.stringify(opts.auth)) : undefined;
+    const base = `/v${apiVersion}/libpod`;
+    const doFetch = async (method, path, init) => {
+        const signal = init?.signal !== undefined
+            ? (init.signal ?? undefined)
+            : AbortSignal.timeout(timeout);
+        return await nodeRequest(`http://localhost${base}${path}`, {
+            socketPath,
+            method,
+            headers: init?.headers,
+            signal: signal ?? undefined,
+        }, init?.body);
+    };
+    return buildTransport(doFetch, authHeader, () => { });
+}
+export function createTcpTransport(opts) {
+    const { uri, apiVersion = "4.0.0", timeout = 30_000 } = opts;
+    const authHeader = opts.auth ? btoa(JSON.stringify(opts.auth)) : undefined;
+    const base = `${uri.replace(/\/+$/, "")}/v${apiVersion}/libpod`;
+    let agent;
+    if (opts.tls) {
+        agent = new https.Agent({
+            ca: opts.tls.caCerts?.join("\n"),
+            cert: opts.tls.cert,
+            key: opts.tls.key,
+        });
+    }
+    const doFetch = async (method, path, init) => {
+        const signal = init?.signal !== undefined
+            ? (init.signal ?? undefined)
+            : AbortSignal.timeout(timeout);
+        if (agent) {
+            return await nodeRequest(`${base}${path}`, {
+                method,
+                headers: init?.headers,
+                agent,
+                signal: signal ?? undefined,
+            }, init?.body);
+        }
+        return await fetch(`${base}${path}`, {
+            method,
+            headers: init?.headers,
+            body: init?.body,
+            signal,
+        });
+    };
+    return buildTransport(doFetch, authHeader, () => agent?.destroy());
+}