@ostanin/podman 0.1.0

package/script/api/pods.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodsApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+class PodsApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Create a new pod from the given spec. */
+    async create(spec) {
+        const path = "/pods/create";
+        const { status, json } = await this.#t.request("POST", path, spec);
+        if (status !== 201)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Inspect a pod. Returns `null` if the pod is not found. */
+    async inspect(nameOrId) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/json`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status === 404)
+            return null;
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return json;
+    }
+    /** List pods, optionally filtered by the given query. */
+    async list(query) {
+        const path = `/pods/json${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Remove a pod and optionally its containers. */
+    async remove(nameOrId, query) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "DELETE", path);
+        return json;
+    }
+    /** Start all containers in a pod. */
+    async start(nameOrId) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/start`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200 && status !== 304)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Stop all containers in a pod with an optional timeout. */
+    async stop(nameOrId, query) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/stop${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200 && status !== 304)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Restart all containers in a pod. */
+    async restart(nameOrId) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/restart`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Send a signal to all containers in a pod. */
+    async kill(nameOrId, query) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/kill${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Pause all containers in a pod. */
+    async pause(nameOrId) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/pause`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Unpause all containers in a pod. */
+    async unpause(nameOrId) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/unpause`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** List processes running in the pod's containers. */
+    async top(nameOrId, query) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/top${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return json;
+    }
+    /** Check if a pod exists. Returns `true` on 204, `false` otherwise. */
+    async exists(nameOrId) {
+        const path = `/pods/${encodeURIComponent(nameOrId)}/exists`;
+        const { status } = await this.#t.request("GET", path);
+        return status === 204;
+    }
+    /** Get resource usage statistics for the pod's containers. */
+    async stats(query) {
+        const path = `/pods/stats${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Remove all stopped pods. */
+    async prune() {
+        const path = "/pods/prune";
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+}
+exports.PodsApi = PodsApi;

package/script/api/quadlets.d.ts

@@ -0,0 +1,23 @@
+import type { Transport } from "../transport.js";
+import type { ListQuadlet, QuadletRemoveAllQuery, QuadletRemoveQuery, QuadletInstallQuery, QuadletListQuery, QuadletRemoveReport } from "../types/api.js";
+export type QuadletInstallReport = {
+    InstalledQuadlets?: Record<string, string>;
+    QuadletErrors?: Record<string, string>;
+};
+export declare class QuadletsApi {
+    #private;
+    constructor(transport: Transport);
+    /** Install quadlet files from a tar archive. */
+    install(body: ReadableStream<Uint8Array>, query?: QuadletInstallQuery): Promise<QuadletInstallReport>;
+    /** Remove one or more quadlets. */
+    removeAll(query?: QuadletRemoveAllQuery): Promise<QuadletRemoveReport>;
+    /** Remove a quadlet by name. */
+    remove(name: string, query?: QuadletRemoveQuery): Promise<QuadletRemoveReport>;
+    /** Check if a quadlet exists. Returns `true` on 204, `false` otherwise. */
+    exists(name: string): Promise<boolean>;
+    /** Get the contents of a quadlet file. */
+    file(name: string): Promise<string>;
+    /** List all quadlets. */
+    list(query?: QuadletListQuery): Promise<ListQuadlet[]>;
+}
+//# sourceMappingURL=quadlets.d.ts.map

package/script/api/quadlets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quadlets.d.ts","sourceRoot":"","sources":["../../src/api/quadlets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,oBAAoB,GAAG;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAGF,qBAAa,WAAW;;gBAEV,SAAS,EAAE,SAAS;IAIhC,gDAAgD;IAC1C,OAAO,CACX,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,KAAK,CAAC,EAAE,mBAAmB,GAC1B,OAAO,CAAC,oBAAoB,CAAC;IAShC,mCAAmC;IAC7B,SAAS,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAO5E,gCAAgC;IAC1B,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,mBAAmB,CAAC;IAQ/B,2EAA2E;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM5C,0CAA0C;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOzC,yBAAyB;IACnB,IAAI,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAM7D"}

package/script/api/quadlets.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuadletsApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+class QuadletsApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Install quadlet files from a tar archive. */
+    async install(body, query) {
+        const path = `/quadlets${(0, query_js_1.buildQuery)(query)}`;
+        const res = await this.#t.requestRaw("POST", path, body, {
+            "Content-Type": "application/x-tar",
+        });
+        if (res.status !== 200)
+            await (0, errors_js_1.throwRawError)(res, "POST", path);
+        return (await res.json());
+    }
+    /** Remove one or more quadlets. */
+    async removeAll(query) {
+        const path = `/quadlets${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "DELETE", path);
+        return json;
+    }
+    /** Remove a quadlet by name. */
+    async remove(name, query) {
+        const path = `/quadlets/${encodeURIComponent(name)}${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "DELETE", path);
+        return json;
+    }
+    /** Check if a quadlet exists. Returns `true` on 204, `false` otherwise. */
+    async exists(name) {
+        const path = `/quadlets/${encodeURIComponent(name)}/exists`;
+        const { status } = await this.#t.request("GET", path);
+        return status === 204;
+    }
+    /** Get the contents of a quadlet file. */
+    async file(name) {
+        const path = `/quadlets/${encodeURIComponent(name)}/file`;
+        const res = await this.#t.requestRaw("GET", path);
+        if (res.status !== 200)
+            await (0, errors_js_1.throwRawError)(res, "GET", path);
+        return await res.text();
+    }
+    /** List all quadlets. */
+    async list(query) {
+        const path = `/quadlets/json${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return (json ?? []);
+    }
+}
+exports.QuadletsApi = QuadletsApi;

package/script/api/secrets.d.ts

@@ -0,0 +1,17 @@
+import type { Transport } from "../transport.js";
+import type { SecretCreateQuery, SecretCreateReport, SecretRemoveQuery, SecretInfoReport, SecretInspectQuery, SecretListQuery } from "../types/api.js";
+export declare class SecretsApi {
+    #private;
+    constructor(transport: Transport);
+    /** Create a new secret from the given data string. */
+    create(data: string, query: SecretCreateQuery): Promise<SecretCreateReport>;
+    /** Inspect a secret. Returns `null` if the secret is not found. */
+    inspect(nameOrId: string, query?: SecretInspectQuery): Promise<SecretInfoReport | null>;
+    /** List secrets, optionally filtered by the given query. */
+    list(query?: SecretListQuery): Promise<SecretInfoReport[]>;
+    /** Remove a secret. */
+    remove(nameOrId: string, query?: SecretRemoveQuery): Promise<void>;
+    /** Check if a secret exists. Returns `true` on 204, `false` otherwise. */
+    exists(nameOrId: string): Promise<boolean>;
+}
+//# sourceMappingURL=secrets.d.ts.map

package/script/api/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/api/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,UAAU;;gBAET,SAAS,EAAE,SAAS;IAIhC,sDAAsD;IAChD,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAS9B,mEAAmE;IAC7D,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IASnC,4DAA4D;IACtD,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAOhE,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;CAKjD"}

package/script/api/secrets.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecretsApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+class SecretsApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Create a new secret from the given data string. */
+    async create(data, query) {
+        const path = `/secrets/create${(0, query_js_1.buildQuery)(query)}`;
+        const res = await this.#t.requestRaw("POST", path, data, {
+            "Content-Type": "application/json",
+        });
+        if (res.status !== 200 && res.status !== 201)
+            await (0, errors_js_1.throwRawError)(res, "POST", path);
+        return (await res.json());
+    }
+    /** Inspect a secret. Returns `null` if the secret is not found. */
+    async inspect(nameOrId, query) {
+        const path = `/secrets/${encodeURIComponent(nameOrId)}/json${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status === 404)
+            return null;
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return json;
+    }
+    /** List secrets, optionally filtered by the given query. */
+    async list(query) {
+        const path = `/secrets/json${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Remove a secret. */
+    async remove(nameOrId, query) {
+        const path = `/secrets/${encodeURIComponent(nameOrId)}${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 204)
+            throw (0, errors_js_1.createPodmanError)(status, json, "DELETE", path);
+    }
+    /** Check if a secret exists. Returns `true` on 204, `false` otherwise. */
+    async exists(nameOrId) {
+        const path = `/secrets/${encodeURIComponent(nameOrId)}/exists`;
+        const { status } = await this.#t.request("GET", path);
+        return status === 204;
+    }
+}
+exports.SecretsApi = SecretsApi;

package/script/api/system.d.ts

@@ -0,0 +1,23 @@
+import type { Transport } from "../transport.js";
+import type { LibpodInfo, SystemComponentVersion, SystemDfReport, SystemCheckQuery, SystemCheckReport, SystemEventsQuery, SystemPruneReport } from "../types/api.js";
+export declare class SystemApi {
+    #private;
+    constructor(transport: Transport);
+    /** Return information about the Podman host. */
+    info(): Promise<LibpodInfo>;
+    /** Return component version information for the Podman service. */
+    version(): Promise<SystemComponentVersion>;
+    /** Ping the Podman service. Returns `true` if reachable. */
+    ping(): Promise<boolean>;
+    /** Prune unused data (containers, images, volumes, networks). */
+    prune(): Promise<SystemPruneReport>;
+    /** Return disk usage information (containers, images, volumes). */
+    df(): Promise<SystemDfReport>;
+    /** Stream system events as raw bytes. */
+    events(query?: SystemEventsQuery): Promise<ReadableStream<Uint8Array>>;
+    /** Stream system events as parsed JSON objects. */
+    parsedEvents(query?: SystemEventsQuery): AsyncGenerator<Record<string, unknown>>;
+    /** Run a consistency check on container storage. */
+    check(query?: SystemCheckQuery): Promise<SystemCheckReport>;
+}
+//# sourceMappingURL=system.d.ts.map

package/script/api/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/api/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAGzB,qBAAa,SAAS;;gBAER,SAAS,EAAE,SAAS;IAIhC,gDAAgD;IAC1C,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAOjC,mEAAmE;IAC7D,OAAO,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAOhD,4DAA4D;IACtD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAO9B,iEAAiE;IAC3D,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAOzC,mEAAmE;IAC7D,EAAE,IAAI,OAAO,CAAC,cAAc,CAAC;IAOnC,yCAAyC;IACnC,MAAM,CACV,KAAK,CAAC,EAAE,iBAAiB,GACxB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAKtC,mDAAmD;IAC5C,YAAY,CACjB,KAAK,CAAC,EAAE,iBAAiB,GACxB,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkC1C,oDAAoD;IAC9C,KAAK,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAMlE"}

package/script/api/system.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+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 (0, errors_js_1.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 (0, errors_js_1.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 (0, errors_js_1.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 (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return json;
+    }
+    /** Stream system events as raw bytes. */
+    async events(query) {
+        const path = `/events${(0, query_js_1.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${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+}
+exports.SystemApi = SystemApi;

package/script/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/script/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/script/api/volumes.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumesApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+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 (0, errors_js_1.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 (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return json;
+    }
+    /** List volumes, optionally filtered by the given query. */
+    async list(query) {
+        const path = `/volumes/json${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Remove a volume. */
+    async remove(nameOrId, query) {
+        const path = `/volumes/${encodeURIComponent(nameOrId)}${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 204)
+            throw (0, errors_js_1.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${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.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 (0, errors_js_1.throwRawError)(res, "POST", path);
+    }
+}
+exports.VolumesApi = VolumesApi;

package/script/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/script/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/script/client.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = createClient;
+exports.createSshClient = createSshClient;
+const transport_js_1 = require("./transport.js");
+const ssh_transport_js_1 = require("./ssh_transport.js");
+const containers_js_1 = require("./api/containers.js");
+const images_js_1 = require("./api/images.js");
+const networks_js_1 = require("./api/networks.js");
+const volumes_js_1 = require("./api/volumes.js");
+const pods_js_1 = require("./api/pods.js");
+const secrets_js_1 = require("./api/secrets.js");
+const system_js_1 = require("./api/system.js");
+const exec_js_1 = require("./api/exec.js");
+const generate_js_1 = require("./api/generate.js");
+const manifests_js_1 = require("./api/manifests.js");
+const kube_js_1 = require("./api/kube.js");
+const artifacts_js_1 = require("./api/artifacts.js");
+const quadlets_js_1 = require("./api/quadlets.js");
+function buildPodmanClient(transport) {
+    return {
+        containers: new containers_js_1.ContainersApi(transport),
+        images: new images_js_1.ImagesApi(transport),
+        networks: new networks_js_1.NetworksApi(transport),
+        volumes: new volumes_js_1.VolumesApi(transport),
+        pods: new pods_js_1.PodsApi(transport),
+        secrets: new secrets_js_1.SecretsApi(transport),
+        system: new system_js_1.SystemApi(transport),
+        exec: new exec_js_1.ExecApi(transport),
+        generate: new generate_js_1.GenerateApi(transport),
+        manifests: new manifests_js_1.ManifestsApi(transport),
+        kube: new kube_js_1.KubeApi(transport),
+        artifacts: new artifacts_js_1.ArtifactsApi(transport),
+        quadlets: new quadlets_js_1.QuadletsApi(transport),
+        close() {
+            transport.close();
+        },
+    };
+}
+/** Create a Podman client using a Unix socket or TCP/TLS connection. */
+function createClient(opts) {
+    let transport;
+    if ("socketPath" in opts) {
+        const transportOpts = {
+            socketPath: opts.socketPath,
+            apiVersion: opts.apiVersion,
+            timeout: opts.timeout,
+            auth: opts.auth,
+        };
+        transport = (0, transport_js_1.createTransport)(transportOpts);
+    }
+    else {
+        transport = (0, transport_js_1.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. */
+async function createSshClient(opts) {
+    const transport = await (0, ssh_transport_js_1.createSshTransport)(opts);
+    return buildPodmanClient(transport);
+}

package/script/internal/query.d.ts

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