@ostanin/podman 0.1.0

package/esm/types/openapi.js

@@ -0,0 +1,5 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export {};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@ostanin/podman",
+  "version": "0.1.0",
+  "description": "Typed Podman client for Node.js. Full libpod API — containers, images, pods, networks, volumes, secrets, exec, manifests, kube, artifacts, quadlets.",
+  "keywords": [
+    "podman",
+    "containers",
+    "libpod",
+    "docker",
+    "api",
+    "client",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/podman-deno/podman.git"
+  },
+  "license": "MIT",
+  "main": "./script/mod.js",
+  "module": "./esm/mod.js",
+  "exports": {
+    ".": {
+      "import": "./esm/mod.js",
+      "require": "./script/mod.js"
+    }
+  },
+  "scripts": {},
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.0"
+  },
+  "_generatedBy": "dnt@dev",
+  "types": "./esm/mod.d.ts"
+}

package/script/_dnt.polyfills.d.ts

@@ -0,0 +1,7 @@
+declare global {
+    interface Error {
+        cause?: unknown;
+    }
+}
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/script/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CACF;AAED,OAAO,EAAE,CAAC"}

package/script/_dnt.polyfills.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/api/artifacts.d.ts

@@ -0,0 +1,25 @@
+import type { Transport } from "../transport.js";
+import type { ArtifactAddQuery, ArtifactAddReport, ArtifactRemoveAllQuery, ArtifactExtractQuery, ArtifactInspectReport, ArtifactListReport, ArtifactLocalQuery, ArtifactPullQuery, ArtifactPullReport, ArtifactPushQuery, ArtifactPushReport, ArtifactRemoveReport } from "../types/api.js";
+export declare class ArtifactsApi {
+    #private;
+    constructor(transport: Transport);
+    /** Remove a single artifact by name or ID. */
+    remove(nameOrId: string): Promise<ArtifactRemoveReport>;
+    /** Extract an artifact's contents as a tar archive stream. */
+    extract(nameOrId: string, query?: ArtifactExtractQuery): Promise<ReadableStream<Uint8Array>>;
+    /** Inspect an artifact. Returns `null` if not found. */
+    inspect(nameOrId: string): Promise<ArtifactInspectReport | null>;
+    /** Push an artifact to a remote registry. */
+    push(nameOrId: string, query?: ArtifactPushQuery): Promise<ArtifactPushReport>;
+    /** Add a file as a new artifact. */
+    add(body: ReadableStream<Uint8Array>, query: ArtifactAddQuery): Promise<ArtifactAddReport>;
+    /** List all artifacts. */
+    list(): Promise<ArtifactListReport[]>;
+    /** Add a local file as an artifact. */
+    addLocal(query: ArtifactLocalQuery): Promise<ArtifactAddReport>;
+    /** Pull an artifact from a remote registry. */
+    pull(query: ArtifactPullQuery): Promise<ArtifactPullReport>;
+    /** Remove one or more artifacts. */
+    removeAll(query?: ArtifactRemoveAllQuery): Promise<ArtifactRemoveReport>;
+}
+//# sourceMappingURL=artifacts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/api/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAGzB,qBAAa,YAAY;;gBAEX,SAAS,EAAE,SAAS;IAIhC,8CAA8C;IACxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAO7D,8DAA8D;IACxD,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,oBAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAMtC,wDAAwD;IAClD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAQtE,6CAA6C;IACvC,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,iBAAiB,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAW9B,oCAAoC;IAC9B,GAAG,CACP,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,EAChC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAS7B,0BAA0B;IACpB,IAAI,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAO3C,uCAAuC;IACjC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOrE,+CAA+C;IACzC,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAUjE,oCAAoC;IAC9B,SAAS,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAM/E"}

package/script/api/artifacts.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArtifactsApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+class ArtifactsApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Remove a single artifact by name or ID. */
+    async remove(nameOrId) {
+        const path = `/artifacts/${encodeURIComponent(nameOrId)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "DELETE", path);
+        return json;
+    }
+    /** Extract an artifact's contents as a tar archive stream. */
+    async extract(nameOrId, query) {
+        const path = `/artifacts/${encodeURIComponent(nameOrId)}/extract${(0, query_js_1.buildQuery)(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Inspect an artifact. Returns `null` if not found. */
+    async inspect(nameOrId) {
+        const path = `/artifacts/${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;
+    }
+    /** Push an artifact to a remote registry. */
+    async push(nameOrId, query) {
+        const path = `/artifacts/${encodeURIComponent(nameOrId)}/push${(0, query_js_1.buildQuery)(query)}`;
+        const headers = {};
+        const authHeader = this.#t.getAuthHeader();
+        if (authHeader)
+            headers["X-Registry-Auth"] = authHeader;
+        const res = await this.#t.requestRaw("POST", path, undefined, headers);
+        if (res.status !== 200)
+            await (0, errors_js_1.throwRawError)(res, "POST", path);
+        return (await res.json());
+    }
+    /** Add a file as a new artifact. */
+    async add(body, query) {
+        const path = `/artifacts/add${(0, query_js_1.buildQuery)(query)}`;
+        const res = await this.#t.requestRaw("POST", path, body, {
+            "Content-Type": "application/octet-stream",
+        });
+        if (res.status !== 201)
+            await (0, errors_js_1.throwRawError)(res, "POST", path);
+        return (await res.json());
+    }
+    /** List all artifacts. */
+    async list() {
+        const path = "/artifacts/json";
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Add a local file as an artifact. */
+    async addLocal(query) {
+        const path = `/artifacts/local/add${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 201)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Pull an artifact from a remote registry. */
+    async pull(query) {
+        const path = `/artifacts/pull${(0, query_js_1.buildQuery)(query)}`;
+        const headers = {};
+        const authHeader = this.#t.getAuthHeader();
+        if (authHeader)
+            headers["X-Registry-Auth"] = authHeader;
+        const res = await this.#t.requestRaw("POST", path, undefined, headers);
+        if (res.status !== 200)
+            await (0, errors_js_1.throwRawError)(res, "POST", path);
+        return (await res.json());
+    }
+    /** Remove one or more artifacts. */
+    async removeAll(query) {
+        const path = `/artifacts/remove${(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;
+    }
+}
+exports.ArtifactsApi = ArtifactsApi;

package/script/api/containers.d.ts

@@ -0,0 +1,71 @@
+import type { Transport } from "../transport.js";
+import type { ContainerArchiveQuery, ContainerArchivePutQuery, ContainerAttachQuery, ContainerChange, ContainerChangesQuery, ContainerCheckpointQuery, ContainerCreateResponse, ContainerStatsAllQuery, ContainerKillQuery, ContainerListQuery, ContainerLogsQuery, ContainerPruneQuery, ContainerRemoveQuery, ContainerResizeQuery, ContainerRestartQuery, ContainerRestoreQuery, ContainersPruneReport, ContainerStatsQuery, ContainerStopQuery, ContainerTopQuery, ContainerTopResponse, ContainerUpdateQuery, ContainerWaitQuery, HealthCheckResults, InspectContainerData, ListContainer, SpecGenerator, UpdateEntities } from "../types/api.js";
+export declare class ContainersApi {
+    #private;
+    constructor(transport: Transport);
+    /** Create a new container from the given spec. */
+    create(spec: SpecGenerator): Promise<ContainerCreateResponse>;
+    /** Inspect a container. Returns `null` if the container is not found. */
+    inspect(nameOrId: string): Promise<InspectContainerData | null>;
+    /** List containers, optionally filtered by the given query. */
+    list(query?: ContainerListQuery): Promise<ListContainer[]>;
+    /** Start a container. */
+    start(nameOrId: string): Promise<void>;
+    /** Stop a container with an optional timeout. */
+    stop(nameOrId: string, query?: ContainerStopQuery): Promise<void>;
+    /** Restart a container with an optional timeout. */
+    restart(nameOrId: string, query?: ContainerRestartQuery): Promise<void>;
+    /** Send a signal to a container (default SIGTERM). */
+    kill(nameOrId: string, query?: ContainerKillQuery): Promise<void>;
+    /** Pause all processes in a container. */
+    pause(nameOrId: string): Promise<void>;
+    /** Unpause all processes in a container. */
+    unpause(nameOrId: string): Promise<void>;
+    /** Remove a container. Use query options to force-remove or remove volumes. */
+    remove(nameOrId: string, query?: ContainerRemoveQuery): Promise<void>;
+    /** Stream container logs as raw bytes. */
+    logs(nameOrId: string, query?: ContainerLogsQuery): Promise<ReadableStream<Uint8Array>>;
+    /** List processes running inside a container. */
+    top(nameOrId: string, query?: ContainerTopQuery): Promise<ContainerTopResponse>;
+    /** Wait for a container to meet a given condition. Returns the exit code. */
+    wait(nameOrId: string, query?: ContainerWaitQuery): Promise<number>;
+    /** Rename a container. */
+    rename(nameOrId: string, newName: string): Promise<void>;
+    /** Resize a container's TTY dimensions. */
+    resize(nameOrId: string, query: ContainerResizeQuery): Promise<void>;
+    /** Export a container's filesystem as a tar stream. */
+    export(nameOrId: string): Promise<ReadableStream<Uint8Array>>;
+    /** Checkpoint a running container using CRIU. */
+    checkpoint(nameOrId: string, query?: ContainerCheckpointQuery): Promise<void>;
+    /** Restore a previously checkpointed container. */
+    restore(nameOrId: string, query?: ContainerRestoreQuery): Promise<void>;
+    /** Check if a container exists. Returns `true` on 204, `false` otherwise. */
+    exists(nameOrId: string): Promise<boolean>;
+    /** Remove stopped containers. Returns a list of pruned containers. */
+    prune(query?: ContainerPruneQuery): Promise<ContainersPruneReport[]>;
+    /** Stream resource usage statistics for a container. */
+    stats(nameOrId: string, query?: ContainerStatsQuery): Promise<ReadableStream<Uint8Array>>;
+    /** Attach to a container and stream its output. */
+    attach(nameOrId: string, query?: ContainerAttachQuery): Promise<ReadableStream<Uint8Array>>;
+    /** Download a file or directory from a container as a tar archive stream. */
+    getArchive(nameOrId: string, query: ContainerArchiveQuery): Promise<ReadableStream<Uint8Array>>;
+    /** Upload a tar archive stream into a container at the specified path. */
+    putArchive(nameOrId: string, body: ReadableStream<Uint8Array>, query: ContainerArchivePutQuery): Promise<void>;
+    /** Run a container health check and return the results. */
+    healthcheck(nameOrId: string): Promise<HealthCheckResults>;
+    /** Initialize a container, preparing it to be started. */
+    init(nameOrId: string): Promise<void>;
+    /** Update a container's resource limits. */
+    update(nameOrId: string, resources: UpdateEntities, query?: ContainerUpdateQuery): Promise<void>;
+    /** List filesystem changes made inside a container. */
+    changes(nameOrId: string, query?: ContainerChangesQuery): Promise<ContainerChange[]>;
+    /** Mount a container's filesystem. Returns the mount path. */
+    mount(nameOrId: string): Promise<string>;
+    /** Unmount a container's filesystem. */
+    unmount(nameOrId: string): Promise<void>;
+    /** List all mounted containers and their mount points. */
+    showMounted(): Promise<Record<string, string>>;
+    /** Stream resource usage statistics for all containers. */
+    statsAll(query?: ContainerStatsAllQuery): Promise<ReadableStream<Uint8Array>>;
+}
+//# sourceMappingURL=containers.d.ts.map

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

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

package/script/api/containers.js

@@ -0,0 +1,238 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContainersApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+class ContainersApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Create a new container from the given spec. */
+    async create(spec) {
+        const path = "/containers/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 container. Returns `null` if the container is not found. */
+    async inspect(nameOrId) {
+        const path = `/containers/${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 containers, optionally filtered by the given query. */
+    async list(query) {
+        const path = `/containers/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 ?? []);
+    }
+    /** Start a container. */
+    async start(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/start`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204 && status !== 304)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Stop a container with an optional timeout. */
+    async stop(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/stop${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204 && status !== 304)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Restart a container with an optional timeout. */
+    async restart(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/restart${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Send a signal to a container (default SIGTERM). */
+    async kill(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/kill${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Pause all processes in a container. */
+    async pause(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/pause`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Unpause all processes in a container. */
+    async unpause(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/unpause`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Remove a container. Use query options to force-remove or remove volumes. */
+    async remove(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200 && status !== 204) {
+            throw (0, errors_js_1.createPodmanError)(status, json, "DELETE", path);
+        }
+    }
+    /** Stream container logs as raw bytes. */
+    async logs(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/logs${(0, query_js_1.buildQuery)(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** List processes running inside a container. */
+    async top(nameOrId, query) {
+        const path = `/containers/${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;
+    }
+    /** Wait for a container to meet a given condition. Returns the exit code. */
+    async wait(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/wait${(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;
+    }
+    /** Rename a container. */
+    async rename(nameOrId, newName) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/rename${(0, query_js_1.buildQuery)({ name: newName })}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Resize a container's TTY dimensions. */
+    async resize(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/resize${(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);
+    }
+    /** Export a container's filesystem as a tar stream. */
+    async export(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/export`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Checkpoint a running container using CRIU. */
+    async checkpoint(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/checkpoint${(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);
+    }
+    /** Restore a previously checkpointed container. */
+    async restore(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/restore${(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);
+    }
+    /** Check if a container exists. Returns `true` on 204, `false` otherwise. */
+    async exists(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/exists`;
+        const { status } = await this.#t.request("GET", path);
+        return status === 204;
+    }
+    /** Remove stopped containers. Returns a list of pruned containers. */
+    async prune(query) {
+        const path = `/containers/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 ?? []);
+    }
+    /** Stream resource usage statistics for a container. */
+    async stats(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/stats${(0, query_js_1.buildQuery)(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Attach to a container and stream its output. */
+    async attach(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/attach${(0, query_js_1.buildQuery)(query)}`;
+        return await this.#t.requestStream("POST", path);
+    }
+    /** Download a file or directory from a container as a tar archive stream. */
+    async getArchive(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/archive${(0, query_js_1.buildQuery)(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Upload a tar archive stream into a container at the specified path. */
+    async putArchive(nameOrId, body, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/archive${(0, query_js_1.buildQuery)(query)}`;
+        const res = await this.#t.requestRaw("PUT", path, body, {
+            "Content-Type": "application/x-tar",
+        });
+        if (res.status !== 200)
+            await (0, errors_js_1.throwRawError)(res, "PUT", path);
+    }
+    /** Run a container health check and return the results. */
+    async healthcheck(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/healthcheck`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return json;
+    }
+    /** Initialize a container, preparing it to be started. */
+    async init(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/init`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204 && status !== 304)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** Update a container's resource limits. */
+    async update(nameOrId, resources, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/update${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path, resources);
+        if (status !== 201)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** List filesystem changes made inside a container. */
+    async changes(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/changes${(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 ?? []);
+    }
+    /** Mount a container's filesystem. Returns the mount path. */
+    async mount(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/mount`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+        return json;
+    }
+    /** Unmount a container's filesystem. */
+    async unmount(nameOrId) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/unmount`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+    /** List all mounted containers and their mount points. */
+    async showMounted() {
+        const path = "/containers/showmounted";
+        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 resource usage statistics for all containers. */
+    async statsAll(query) {
+        const path = `/containers/stats${(0, query_js_1.buildQuery)(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+}
+exports.ContainersApi = ContainersApi;

package/script/api/exec.d.ts

@@ -0,0 +1,15 @@
+import type { Transport } from "../transport.js";
+import type { ExecCreateConfig, ExecResizeQuery, ExecStartConfig, InspectExecSession } from "../types/api.js";
+export declare class ExecApi {
+    #private;
+    constructor(transport: Transport);
+    /** Create an exec session inside a container. Returns the exec session ID. */
+    create(nameOrId: string, config: ExecCreateConfig): Promise<string>;
+    /** Start an exec session and stream its output. */
+    start(id: string, config?: ExecStartConfig): Promise<ReadableStream<Uint8Array>>;
+    /** Inspect an exec session. */
+    inspect(id: string): Promise<InspectExecSession>;
+    /** Resize an exec session's TTY dimensions. */
+    resize(id: string, query: ExecResizeQuery): Promise<void>;
+}
+//# sourceMappingURL=exec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/api/exec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,OAAO;;gBAEN,SAAS,EAAE,SAAS;IAIhC,8EAA8E;IACxE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUzE,mDAAmD;IAC7C,KAAK,CACT,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAetC,+BAA+B;IACzB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOtD,+CAA+C;IACzC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAMhE"}

package/script/api/exec.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+class ExecApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Create an exec session inside a container. Returns the exec session ID. */
+    async create(nameOrId, config) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/exec`;
+        const res = await this.#t.requestRaw("POST", path, JSON.stringify(config), {
+            "Content-Type": "application/json",
+        });
+        if (res.status !== 201)
+            await (0, errors_js_1.throwRawError)(res, "POST", path);
+        const result = await res.json();
+        return result.Id;
+    }
+    /** Start an exec session and stream its output. */
+    async start(id, config) {
+        const path = `/exec/${encodeURIComponent(id)}/start`;
+        const res = await this.#t.requestRaw("POST", path, JSON.stringify(config ?? {}), { "Content-Type": "application/json" });
+        if (res.status >= 400)
+            await (0, errors_js_1.throwRawError)(res, "POST", path);
+        if (!res.body) {
+            throw new Error(`No response body for POST ${path}`);
+        }
+        return res.body;
+    }
+    /** Inspect an exec session. */
+    async inspect(id) {
+        const path = `/exec/${encodeURIComponent(id)}/json`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw (0, errors_js_1.createPodmanError)(status, json, "GET", path);
+        return json;
+    }
+    /** Resize an exec session's TTY dimensions. */
+    async resize(id, query) {
+        const path = `/exec/${encodeURIComponent(id)}/resize${(0, query_js_1.buildQuery)(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 201)
+            throw (0, errors_js_1.createPodmanError)(status, json, "POST", path);
+    }
+}
+exports.ExecApi = ExecApi;

package/script/api/generate.d.ts

@@ -0,0 +1,11 @@
+import type { Transport } from "../transport.js";
+import type { GenerateKubeQuery, GenerateSystemdQuery } from "../types/api.js";
+export declare class GenerateApi {
+    #private;
+    constructor(transport: Transport);
+    /** Generate systemd unit files for a container or pod. Returns a map of unit name to content. */
+    systemd(nameOrId: string, query?: GenerateSystemdQuery): Promise<Record<string, string>>;
+    /** Generate a Kubernetes YAML manifest for a container or pod. */
+    kube(query: GenerateKubeQuery): Promise<string>;
+}
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/api/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,WAAW;;gBAEV,SAAS,EAAE,SAAS;IAIhC,iGAAiG;IAC3F,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,oBAAoB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAQlC,kEAAkE;IAC5D,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAMtD"}

package/script/api/generate.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateApi = void 0;
+const errors_js_1 = require("../types/errors.js");
+const query_js_1 = require("../internal/query.js");
+class GenerateApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** Generate systemd unit files for a container or pod. Returns a map of unit name to content. */
+    async systemd(nameOrId, query) {
+        const path = `/generate/${encodeURIComponent(nameOrId)}/systemd${(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;
+    }
+    /** Generate a Kubernetes YAML manifest for a container or pod. */
+    async kube(query) {
+        const path = `/generate/kube${(0, query_js_1.buildQuery)(query)}`;
+        const res = await this.#t.requestRaw("GET", path);
+        if (res.status >= 400)
+            await (0, errors_js_1.throwRawError)(res, "GET", path);
+        return await res.text();
+    }
+}
+exports.GenerateApi = GenerateApi;