@ostanin/podman 0.1.0

package/esm/api/containers.js

@@ -0,0 +1,234 @@
+import { createPodmanError, throwRawError } from "../types/errors.js";
+import { buildQuery } from "../internal/query.js";
+export 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 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 createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** List containers, optionally filtered by the given query. */
+    async list(query) {
+        const path = `/containers/json${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw 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 createPodmanError(status, json, "POST", path);
+    }
+    /** Stop a container with an optional timeout. */
+    async stop(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/stop${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204 && status !== 304)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** Restart a container with an optional timeout. */
+    async restart(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/restart${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** Send a signal to a container (default SIGTERM). */
+    async kill(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/kill${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw 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 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 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)}${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200 && status !== 204) {
+            throw createPodmanError(status, json, "DELETE", path);
+        }
+    }
+    /** Stream container logs as raw bytes. */
+    async logs(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/logs${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${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw 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${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return json;
+    }
+    /** Rename a container. */
+    async rename(nameOrId, newName) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/rename${buildQuery({ name: newName })}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 204)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** Resize a container's TTY dimensions. */
+    async resize(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/resize${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw 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${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** Restore a previously checkpointed container. */
+    async restore(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/restore${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw 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${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return (json ?? []);
+    }
+    /** Stream resource usage statistics for a container. */
+    async stats(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/stats${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${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${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${buildQuery(query)}`;
+        const res = await this.#t.requestRaw("PUT", path, body, {
+            "Content-Type": "application/x-tar",
+        });
+        if (res.status !== 200)
+            await 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 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 createPodmanError(status, json, "POST", path);
+    }
+    /** Update a container's resource limits. */
+    async update(nameOrId, resources, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/update${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path, resources);
+        if (status !== 201)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** List filesystem changes made inside a container. */
+    async changes(nameOrId, query) {
+        const path = `/containers/${encodeURIComponent(nameOrId)}/changes${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw 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 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 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 createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** Stream resource usage statistics for all containers. */
+    async statsAll(query) {
+        const path = `/containers/stats${buildQuery(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+}

package/esm/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/esm/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/esm/api/exec.js

@@ -0,0 +1,45 @@
+import { createPodmanError, throwRawError } from "../types/errors.js";
+import { buildQuery } from "../internal/query.js";
+export 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 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 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 createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** Resize an exec session's TTY dimensions. */
+    async resize(id, query) {
+        const path = `/exec/${encodeURIComponent(id)}/resize${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 201)
+            throw createPodmanError(status, json, "POST", path);
+    }
+}

package/esm/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/esm/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/esm/api/generate.js

@@ -0,0 +1,24 @@
+import { createPodmanError, throwRawError } from "../types/errors.js";
+import { buildQuery } from "../internal/query.js";
+export 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${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** Generate a Kubernetes YAML manifest for a container or pod. */
+    async kube(query) {
+        const path = `/generate/kube${buildQuery(query)}`;
+        const res = await this.#t.requestRaw("GET", path);
+        if (res.status >= 400)
+            await throwRawError(res, "GET", path);
+        return await res.text();
+    }
+}

package/esm/api/images.d.ts

@@ -0,0 +1,55 @@
+import type { Transport } from "../transport.js";
+import type { ContainerChange, ImageBuildQuery, ImageRemoveAllQuery, ImageCommitQuery, ImageChangesQuery, ImageExportQuery, ImageHistory, ImageImportQuery, ImageInspect, ImageListQuery, ImageLoadReport, ImagePruneQuery, ImagePruneReport, ImagePullQuery, ImagePushQuery, ImageRemoveQuery, ImageRemoveReport, ImageScpQuery, ImageSearchQuery, ImageSearchResult, ImageSummary, ImageTreeQuery, ScpReport, ImageTreeReport, LibpodImagesPullReport, LocalBuildQuery, LocalImagesQuery } from "../types/api.js";
+export declare class ImagesApi {
+    #private;
+    constructor(transport: Transport);
+    /** List images, optionally filtered by the given query. */
+    list(query?: ImageListQuery): Promise<ImageSummary[]>;
+    /** Inspect an image. Returns `null` if the image is not found. */
+    inspect(nameOrId: string): Promise<ImageInspect | null>;
+    /** Pull an image from a registry. */
+    pull(query: ImagePullQuery): Promise<LibpodImagesPullReport>;
+    /** Remove an image. Returns a report of untagged and deleted layers. */
+    remove(nameOrId: string, query?: ImageRemoveQuery): Promise<ImageRemoveReport>;
+    /** Add a repository tag to an image. */
+    tag(nameOrId: string, repo: string, tag?: string): Promise<void>;
+    /** Remove a repository tag from an image. */
+    untag(nameOrId: string, repo: string, tag?: string): Promise<void>;
+    /** Search registries for images matching the given query. */
+    search(query: ImageSearchQuery): Promise<ImageSearchResult[]>;
+    /** Return the history of an image's layers. */
+    history(nameOrId: string): Promise<ImageHistory[]>;
+    /** Push an image to a registry. */
+    push(nameOrId: string, query?: ImagePushQuery): Promise<void>;
+    /** Import an image from a tar archive stream. Returns the new image ID. */
+    import(body: ReadableStream<Uint8Array>, query?: ImageImportQuery): Promise<string>;
+    /** Export an image as a tar archive stream. */
+    export(nameOrId: string): Promise<ReadableStream<Uint8Array>>;
+    /** Remove unused images. Returns a list of pruned images. */
+    prune(query?: ImagePruneQuery): Promise<ImagePruneReport[]>;
+    /** Build an image from a build context tar stream. Returns the build output stream. */
+    build(body: ReadableStream<Uint8Array>, query?: ImageBuildQuery): Promise<ReadableStream<Uint8Array>>;
+    /** Check if an image exists. Returns `true` on 204, `false` otherwise. */
+    exists(nameOrId: string): Promise<boolean>;
+    /** Create a new image from a container's changes. */
+    commit(query: ImageCommitQuery): Promise<void>;
+    /** Load images from a tar archive. */
+    load(body: ReadableStream<Uint8Array>): Promise<ImageLoadReport>;
+    /** Get a tree representation of an image's layers. */
+    tree(nameOrId: string, query?: ImageTreeQuery): Promise<ImageTreeReport>;
+    /** List filesystem changes in an image. */
+    changes(nameOrId: string, query?: ImageChangesQuery): Promise<ContainerChange[]>;
+    /** Resolve a short image name to a full reference. */
+    resolve(nameOrId: string): Promise<string>;
+    /** Export multiple images as a single tar archive stream. */
+    exportMultiple(query?: ImageExportQuery): Promise<ReadableStream<Uint8Array>>;
+    /** Remove one or more images. */
+    removeAll(query?: ImageRemoveAllQuery): Promise<ImageRemoveReport>;
+    /** Copy an image between hosts via SCP. */
+    scp(nameOrId: string, query?: ImageScpQuery): Promise<ScpReport>;
+    /** Load an image from a file path on the Podman server's filesystem. */
+    loadLocal(query: LocalImagesQuery): Promise<ImageLoadReport>;
+    /** Build an image from a local directory on the Podman server's filesystem. Returns the build output stream. */
+    buildLocal(query: LocalBuildQuery): Promise<ReadableStream<Uint8Array>>;
+}
+//# sourceMappingURL=images.d.ts.map

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

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

package/esm/api/images.js

@@ -0,0 +1,212 @@
+import { createPodmanError, throwRawError } from "../types/errors.js";
+import { buildQuery } from "../internal/query.js";
+export class ImagesApi {
+    #t;
+    constructor(transport) {
+        this.#t = transport;
+    }
+    /** List images, optionally filtered by the given query. */
+    async list(query) {
+        const path = `/images/json${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Inspect an image. Returns `null` if the image is not found. */
+    async inspect(nameOrId) {
+        const path = `/images/${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;
+    }
+    /** Pull an image from a registry. */
+    async pull(query) {
+        const path = `/images/pull${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 throwRawError(res, "POST", path);
+        return (await res.json());
+    }
+    /** Remove an image. Returns a report of untagged and deleted layers. */
+    async remove(nameOrId, query) {
+        const path = `/images/${encodeURIComponent(nameOrId)}${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "DELETE", path);
+        return json;
+    }
+    /** Add a repository tag to an image. */
+    async tag(nameOrId, repo, tag) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/tag${buildQuery({ repo, tag })}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 201)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** Remove a repository tag from an image. */
+    async untag(nameOrId, repo, tag) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/untag${buildQuery({ repo, tag })}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 201)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** Search registries for images matching the given query. */
+    async search(query) {
+        const path = `/images/search${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Return the history of an image's layers. */
+    async history(nameOrId) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/history`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Push an image to a registry. */
+    async push(nameOrId, query) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/push${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 throwRawError(res, "POST", path);
+        await res.body?.cancel();
+    }
+    /** Import an image from a tar archive stream. Returns the new image ID. */
+    async import(body, query) {
+        const path = `/images/import${buildQuery(query)}`;
+        const res = await this.#t.requestRaw("POST", path, body, {
+            "Content-Type": "application/x-tar",
+        });
+        if (res.status !== 200)
+            await throwRawError(res, "POST", path);
+        const result = await res.json();
+        return result.Id;
+    }
+    /** Export an image as a tar archive stream. */
+    async export(nameOrId) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/get`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Remove unused images. Returns a list of pruned images. */
+    async prune(query) {
+        const path = `/images/prune${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return (json ?? []);
+    }
+    /** Build an image from a build context tar stream. Returns the build output stream. */
+    async build(body, query) {
+        const path = `/build${buildQuery(query)}`;
+        const res = await this.#t.requestRaw("POST", path, body, {
+            "Content-Type": "application/x-tar",
+        });
+        if (res.status >= 400)
+            await throwRawError(res, "POST", path);
+        if (!res.body) {
+            throw new Error("No response body for build");
+        }
+        return res.body;
+    }
+    /** Check if an image exists. Returns `true` on 204, `false` otherwise. */
+    async exists(nameOrId) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/exists`;
+        const { status } = await this.#t.request("GET", path);
+        return status === 204;
+    }
+    /** Create a new image from a container's changes. */
+    async commit(query) {
+        const path = `/commit${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 201)
+            throw createPodmanError(status, json, "POST", path);
+    }
+    /** Load images from a tar archive. */
+    async load(body) {
+        const path = "/images/load";
+        const res = await this.#t.requestRaw("POST", path, body, {
+            "Content-Type": "application/x-tar",
+        });
+        if (res.status !== 200)
+            await throwRawError(res, "POST", path);
+        return (await res.json());
+    }
+    /** Get a tree representation of an image's layers. */
+    async tree(nameOrId, query) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/tree${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** List filesystem changes in an image. */
+    async changes(nameOrId, query) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/changes${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return (json ?? []);
+    }
+    /** Resolve a short image name to a full reference. */
+    async resolve(nameOrId) {
+        const path = `/images/${encodeURIComponent(nameOrId)}/resolve`;
+        const { status, json } = await this.#t.request("GET", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "GET", path);
+        return json;
+    }
+    /** Export multiple images as a single tar archive stream. */
+    async exportMultiple(query) {
+        const path = `/images/export${buildQuery(query)}`;
+        return await this.#t.requestStream("GET", path);
+    }
+    /** Remove one or more images. */
+    async removeAll(query) {
+        const path = `/images${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("DELETE", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "DELETE", path);
+        return json;
+    }
+    /** Copy an image between hosts via SCP. */
+    async scp(nameOrId, query) {
+        const path = `/images/scp/${encodeURIComponent(nameOrId)}${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return json;
+    }
+    /** Load an image from a file path on the Podman server's filesystem. */
+    async loadLocal(query) {
+        const path = `/local/images/load${buildQuery(query)}`;
+        const { status, json } = await this.#t.request("POST", path);
+        if (status !== 200)
+            throw createPodmanError(status, json, "POST", path);
+        return json;
+    }
+    /** Build an image from a local directory on the Podman server's filesystem. Returns the build output stream. */
+    async buildLocal(query) {
+        const path = `/local/build${buildQuery(query)}`;
+        const res = await this.#t.requestRaw("POST", path);
+        if (res.status >= 400)
+            await throwRawError(res, "POST", path);
+        if (!res.body) {
+            throw new Error("No response body for build");
+        }
+        return res.body;
+    }
+}

package/esm/api/kube.d.ts

@@ -0,0 +1,13 @@
+import type { Transport } from "../transport.js";
+import type { KubeApplyQuery, PlayKubeDownQuery, PlayKubeQuery, PlayKubeReport } from "../types/api.js";
+export declare class KubeApi {
+    #private;
+    constructor(transport: Transport);
+    /** Play a Kubernetes YAML file. Body can be YAML string or tar stream. */
+    play(body: ReadableStream<Uint8Array> | string, query?: PlayKubeQuery): Promise<PlayKubeReport>;
+    /** Tear down pods/resources created by play kube. */
+    down(query?: PlayKubeDownQuery): Promise<PlayKubeReport>;
+    /** Apply Kubernetes YAML to the Podman system. */
+    apply(body: ReadableStream<Uint8Array> | string, query?: KubeApplyQuery): Promise<string>;
+}
+//# sourceMappingURL=kube.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kube.d.ts","sourceRoot":"","sources":["../../src/api/kube.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,OAAO;;gBAEN,SAAS,EAAE,SAAS;IAIhC,0EAA0E;IACpE,IAAI,CACR,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,EACzC,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,cAAc,CAAC;IAW1B,qDAAqD;IAC/C,IAAI,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAO9D,kDAAkD;IAC5C,KAAK,CACT,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,MAAM,EACzC,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC;CAUnB"}