@zukhruf/docker 0.0.0-stage → 0.3.34

package/dist/host.js

@@ -0,0 +1,22 @@
+import { UnsupportedHostError } from "./errors.js";
+/** Parses a unix://, npipe:// or ssh:// host. Each other host is an UnsupportedHostError. */
+export function parseHost(host) {
+    if (host.startsWith('unix://')) {
+        const socketPath = host.slice('unix://'.length);
+        if (socketPath)
+            return { kind: 'unix', host, socketPath };
+    }
+    else if (host.startsWith('npipe://')) {
+        // npipe:////./pipe/docker_engine is the pipe \\.\pipe\docker_engine.
+        const socketPath = host.slice('npipe://'.length).replaceAll('/', '\\');
+        if (socketPath)
+            return { kind: 'npipe', host, socketPath };
+    }
+    else if (host.startsWith('ssh://') && URL.canParse(host)) {
+        const url = new URL(host);
+        if (url.hostname)
+            return { kind: 'ssh', host, url };
+    }
+    throw new UnsupportedHostError(host);
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOnD,6FAA6F;AAC7F,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,UAAU;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC5D,CAAC;SAAM,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,qEAAqE;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACvE,IAAI,UAAU;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC7D,CAAC;SAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/images.d.ts

@@ -0,0 +1,40 @@
+import type * as EngineApi from './engine-api.ts';
+import { type EngineClient } from './engine-client.ts';
+import type { CancelOptions, Filters } from './options.ts';
+/** The images of one engine. Images have no owner, so no handle removes one on disposal. */
+export declare class Images {
+    #private;
+    constructor(client: EngineClient);
+    /** undefined for 404. */
+    inspect(reference: string, options?: CancelOptions): Promise<EngineApi.ImageInspect | undefined>;
+    /** Pulls the image and reads the progress of the engine to its end. */
+    pull(reference: string, options?: CancelOptions & {
+        platform?: string;
+        auth?: EngineApi.AuthConfig;
+    }): Promise<void>;
+    list(options?: CancelOptions & {
+        all?: boolean;
+        filters?: Filters;
+    }): Promise<EngineApi.ImageSummary[]>;
+    /** Gives the image a second name, such as a registry name before a push. target: 'repository:tag'; with no tag, the tag is 'latest', as the Docker CLI does. */
+    tag(reference: string, target: string, options?: CancelOptions): Promise<void>;
+    /**
+     * Pushes the image and reads the progress of the engine to its end. The
+     * engine answers a push of an image that it does not have with 200, and
+     * then reports the error in the progress: an inspect of the reference tells
+     * a missing image from another error.
+     */
+    push(reference: string, options: CancelOptions & {
+        auth: EngineApi.AuthConfig;
+    }): Promise<void>;
+    /** A tar archive of the images, as `docker save` writes it. */
+    save(references: string[], options?: CancelOptions): Promise<ReadableStream<Uint8Array>>;
+    /** Loads the images of a tar archive and reads the progress of the engine to its end. */
+    load(archive: ReadableStream<Uint8Array> | Uint8Array, options?: CancelOptions): Promise<void>;
+    /** Resolves for 404. A 409 is an ImageInUseError: a container uses the image, or, by ID, several names refer to it. */
+    remove(reference: string, options?: CancelOptions & {
+        force?: boolean;
+        noprune?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAM7E,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA+B3D,4FAA4F;AAC5F,qBAAa,MAAM;;gBAGL,MAAM,EAAE,YAAY;IAIhC,yBAAyB;IACnB,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC;IAS9C,uEAAuE;IACjE,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAa,GAAG;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC;KACxB,GACL,OAAO,CAAC,IAAI,CAAC;IAkChB,IAAI,CACF,OAAO,GAAE,aAAa,GAAG;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GACjE,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;IAOpC,gKAAgK;IAC1J,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;OAKG;IACG,IAAI,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GAAG;QAAE,IAAI,EAAE,SAAS,CAAC,UAAU,CAAA;KAAE,GACtD,OAAO,CAAC,IAAI,CAAC;IAgChB,+DAA+D;IACzD,IAAI,CACR,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAQtC,yFAAyF;IACnF,IAAI,CACR,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,UAAU,EAChD,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAUhB,uHAAuH;IACjH,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,aAAa,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GACnE,OAAO,CAAC,IAAI,CAAC;CAgBjB"}

package/dist/images.js

@@ -0,0 +1,173 @@
+import { Readable } from 'node:stream';
+import { isSuccess, parseBody } from "./engine-client.js";
+import { DockerEngineError, ImageInUseError, ImageNotFoundError, } from "./errors.js";
+import { readProgress } from "./progress.js";
+/**
+ * The repository and the tag of a reference. A reference with a digest has no
+ * tag, and its repository is the whole reference.
+ */
+function splitReference(reference) {
+    const colon = reference.lastIndexOf(':');
+    if (reference.includes('@') || colon <= reference.lastIndexOf('/')) {
+        return { repository: reference, tag: undefined };
+    }
+    return {
+        repository: reference.slice(0, colon),
+        tag: reference.slice(colon + 1),
+    };
+}
+/**
+ * A reference with no tag and no digest pulls each tag of the repository, so
+ * the pull names the tag 'latest', as the Docker CLI does.
+ */
+function pullQuery(reference, platform) {
+    const bare = !reference.includes('@') && splitReference(reference).tag === undefined;
+    return { fromImage: reference, tag: bare ? 'latest' : undefined, platform };
+}
+/** The images of one engine. Images have no owner, so no handle removes one on disposal. */
+export class Images {
+    #client;
+    constructor(client) {
+        this.#client = client;
+    }
+    /** undefined for 404. */
+    async inspect(reference, options = {}) {
+        const method = 'GET';
+        const path = `/images/${encodeURIComponent(reference)}/json`;
+        const response = await this.#client.exchange(method, path, options);
+        if (response.status === 404)
+            return undefined;
+        if (!isSuccess(response))
+            throw this.#client.error(response, method, path);
+        return parseBody(response);
+    }
+    /** Pulls the image and reads the progress of the engine to its end. */
+    async pull(reference, options = {}) {
+        const { platform, auth, signal } = options;
+        const method = 'POST';
+        const path = '/images/create';
+        const progress = await this.#client
+            .stream(method, path, {
+            query: pullQuery(reference, platform),
+            // The same X-Registry-Auth encoding is in push(): mirror a fix in both.
+            // Moby decodes it with the padded URLEncoding of Go, so the '=' stays.
+            headers: auth === undefined
+                ? undefined
+                : {
+                    'X-Registry-Auth': Buffer.from(JSON.stringify(auth))
+                        .toString('base64')
+                        .replaceAll('+', '-')
+                        .replaceAll('/', '_'),
+                },
+            signal,
+        })
+            .catch((error) => {
+            if (error instanceof DockerEngineError && error.status === 404) {
+                throw new ImageNotFoundError(error.message, { status: 404, request: { method, path } }, reference, { cause: error });
+            }
+            throw error;
+        });
+        await readProgress(progress, { method, path });
+    }
+    list(options = {}) {
+        return this.#client.json('GET', '/images/json', {
+            query: { all: options.all, filters: options.filters },
+            signal: options.signal,
+        });
+    }
+    /** Gives the image a second name, such as a registry name before a push. target: 'repository:tag'; with no tag, the tag is 'latest', as the Docker CLI does. */
+    async tag(reference, target, options = {}) {
+        const method = 'POST';
+        const path = `/images/${encodeURIComponent(reference)}/tag`;
+        const { repository, tag = 'latest' } = splitReference(target);
+        const response = await this.#client.exchange(method, path, {
+            query: { repo: repository, tag },
+            signal: options.signal,
+        });
+        if (isSuccess(response))
+            return;
+        const error = this.#client.error(response, method, path);
+        if (response.status === 404) {
+            throw new ImageNotFoundError(error.message, error, reference, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+    /**
+     * Pushes the image and reads the progress of the engine to its end. The
+     * engine answers a push of an image that it does not have with 200, and
+     * then reports the error in the progress: an inspect of the reference tells
+     * a missing image from another error.
+     */
+    async push(reference, options) {
+        const { auth, signal } = options;
+        const { repository, tag = 'latest' } = splitReference(reference);
+        const method = 'POST';
+        const path = `/images/${encodeURIComponent(repository)}/push`;
+        try {
+            const progress = await this.#client.stream(method, path, {
+                query: { tag },
+                // The same X-Registry-Auth encoding is in pull(): mirror a fix in both.
+                // Moby decodes it with the padded URLEncoding of Go, so the '=' stays.
+                headers: {
+                    'X-Registry-Auth': Buffer.from(JSON.stringify(auth))
+                        .toString('base64')
+                        .replaceAll('+', '-')
+                        .replaceAll('/', '_'),
+                },
+                signal,
+            });
+            await readProgress(progress, { method, path });
+        }
+        catch (error) {
+            if (!(error instanceof DockerEngineError))
+                throw error;
+            const missing = error.status === 404 ||
+                (error.status === undefined &&
+                    (await this.inspect(reference, options)) === undefined);
+            if (!missing)
+                throw error;
+            throw new ImageNotFoundError(error.message, error, reference, {
+                cause: error,
+            });
+        }
+    }
+    /** A tar archive of the images, as `docker save` writes it. */
+    async save(references, options = {}) {
+        const response = await this.#client.stream('GET', '/images/get', {
+            query: { names: references },
+            signal: options.signal,
+        });
+        return Readable.toWeb(response);
+    }
+    /** Loads the images of a tar archive and reads the progress of the engine to its end. */
+    async load(archive, options = {}) {
+        const method = 'POST';
+        const path = '/images/load';
+        const progress = await this.#client.stream(method, path, {
+            content: { type: 'application/x-tar', data: archive },
+            signal: options.signal,
+        });
+        await readProgress(progress, { method, path });
+    }
+    /** Resolves for 404. A 409 is an ImageInUseError: a container uses the image, or, by ID, several names refer to it. */
+    async remove(reference, options = {}) {
+        const method = 'DELETE';
+        const path = `/images/${encodeURIComponent(reference)}`;
+        const response = await this.#client.exchange(method, path, {
+            query: { force: options.force, noprune: options.noprune },
+            signal: options.signal,
+        });
+        if (isSuccess(response) || response.status === 404)
+            return;
+        const error = this.#client.error(response, method, path);
+        if (response.status === 409) {
+            throw new ImageInUseError(error.message, error, reference, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=images.js.map

package/dist/images.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export type { ContainerProcess } from './container-process.ts';
+export { Container, type ContainerFile, type Containers, type Created, type LogQuery, OwnedContainer, } from './containers.ts';
+export type { DockerContext, Environment } from './context-store.ts';
+export { type ConnectOptions, Docker } from './docker.ts';
+export { BindSourceNotFoundError, ConnectionFailedError, ContainerNotFoundError, ContainerNotRunningError, ContainerRunningError, ContextNotFoundError, DockerEngineError, DockerError, ImageInUseError, ImageNotFoundError, NameConflictError, NetworkInUseError, NetworkNotFoundError, NotAFileError, PathNotFoundError, ReadOnlyPathError, UnsupportedEngineError, UnsupportedHostError, VolumeInUseError, VolumeNotFoundError, } from './errors.ts';
+export type { Images } from './images.ts';
+export { Network, type Networks, OwnedNetwork } from './networks.ts';
+export type { OutputChunk } from './multiplexed-stream.ts';
+export type { CancelOptions, Filters } from './options.ts';
+export type { ExecResult, Output } from './output.ts';
+export { OwnedVolume, Volume, type Volumes } from './volumes.ts';
+/** The bodies and answers of the Engine API, with the names of its reference. Types only. */
+export type * as EngineApi from './engine-api.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACL,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,KAAK,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAEjE,6FAA6F;AAC7F,YAAY,KAAK,SAAS,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Container, OwnedContainer, } from "./containers.js";
+export { Docker } from "./docker.js";
+export { BindSourceNotFoundError, ConnectionFailedError, ContainerNotFoundError, ContainerNotRunningError, ContainerRunningError, ContextNotFoundError, DockerEngineError, DockerError, ImageInUseError, ImageNotFoundError, NameConflictError, NetworkInUseError, NetworkNotFoundError, NotAFileError, PathNotFoundError, ReadOnlyPathError, UnsupportedEngineError, UnsupportedHostError, VolumeInUseError, VolumeNotFoundError, } from "./errors.js";
+export { Network, OwnedNetwork } from "./networks.js";
+export { OwnedVolume, Volume } from "./volumes.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EAKT,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAuB,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAiB,YAAY,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAgB,MAAM,cAAc,CAAC"}

package/dist/multiplexed-stream.d.ts

@@ -0,0 +1,11 @@
+/** One piece of output of a container process: its stream and its bytes. */
+export interface OutputChunk {
+    stream: 'stdout' | 'stderr';
+    data: Uint8Array;
+}
+/**
+ * The output chunks of a multiplexed stream or of a raw stream, as the
+ * Content-Type of the answer names it.
+ */
+export declare function outputChunks(bytes: AsyncIterable<Uint8Array>, contentType: string): AsyncGenerator<OutputChunk>;
+//# sourceMappingURL=multiplexed-stream.d.ts.map

package/dist/multiplexed-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplexed-stream.d.ts","sourceRoot":"","sources":["../src/multiplexed-stream.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,UAAU,CAAC;CAClB;AA6ED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,WAAW,EAAE,MAAM,GAClB,cAAc,CAAC,WAAW,CAAC,CAG7B"}

package/dist/multiplexed-stream.js

@@ -0,0 +1,81 @@
+import { DockerError } from "./errors.js";
+/** The media type of the output of a container that has no TTY. */
+const MULTIPLEXED_STREAM = 'application/vnd.docker.multiplexed-stream';
+/** The length of the header of a frame: the stream, three zero bytes, and the length, big-endian. */
+const HEADER_LENGTH = 8;
+/**
+ * The stream of a frame. The engine marks the input of a TTY as stdin (0),
+ * and stdcopy of Moby writes it to standard output; 3 is an error of the
+ * engine in the stream.
+ */
+function streamOf(marker) {
+    if (marker === 0 || marker === 1)
+        return 'stdout';
+    if (marker === 2)
+        return 'stderr';
+    return 'error';
+}
+/**
+ * The frames of a multiplexed stream as output chunks. A frame can span chunk
+ * borders: the part of a frame that a chunk has comes as its own output chunk,
+ * so a large frame never waits in memory. The bytes are read at the pace of
+ * the caller.
+ */
+async function* frames(bytes) {
+    let header = new Uint8Array(0);
+    let stream = 'stdout';
+    let remaining = 0;
+    let error = '';
+    const decoder = new TextDecoder();
+    for await (const chunk of bytes) {
+        let offset = 0;
+        while (offset < chunk.byteLength) {
+            if (remaining === 0) {
+                const needed = HEADER_LENGTH - header.byteLength;
+                const part = chunk.subarray(offset, offset + needed);
+                header = concat(header, part);
+                offset += part.byteLength;
+                if (header.byteLength < HEADER_LENGTH)
+                    break;
+                const view = new DataView(header.buffer, header.byteOffset);
+                stream = streamOf(view.getUint8(0));
+                remaining = view.getUint32(4);
+                header = new Uint8Array(0);
+                continue;
+            }
+            const data = chunk.subarray(offset, offset + remaining);
+            offset += data.byteLength;
+            remaining -= data.byteLength;
+            if (stream === 'error') {
+                error += decoder.decode(data, { stream: remaining > 0 });
+                if (remaining === 0)
+                    throw new DockerError(error);
+            }
+            else {
+                yield { stream, data };
+            }
+        }
+    }
+}
+function concat(left, right) {
+    const joined = new Uint8Array(left.byteLength + right.byteLength);
+    joined.set(left);
+    joined.set(right, left.byteLength);
+    return joined;
+}
+/** A raw stream has no frames: each chunk is standard output. */
+async function* raw(bytes) {
+    for await (const data of bytes) {
+        if (data.byteLength > 0)
+            yield { stream: 'stdout', data };
+    }
+}
+/**
+ * The output chunks of a multiplexed stream or of a raw stream, as the
+ * Content-Type of the answer names it.
+ */
+export function outputChunks(bytes, contentType) {
+    const mediaType = contentType.split(';')[0]?.trim();
+    return mediaType === MULTIPLEXED_STREAM ? frames(bytes) : raw(bytes);
+}
+//# sourceMappingURL=multiplexed-stream.js.map

package/dist/multiplexed-stream.js.map

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

package/dist/ndjson.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The values of a stream of newline-delimited JSON. A chunk can end inside a
+ * line, or inside a UTF-8 character: the line waits for the next chunk. An
+ * empty line has no value.
+ */
+export declare function ndjson(chunks: AsyncIterable<Uint8Array>): AsyncGenerator<unknown>;
+//# sourceMappingURL=ndjson.d.ts.map

package/dist/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../src/ndjson.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAuB,MAAM,CAC3B,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAChC,cAAc,CAAC,OAAO,CAAC,CAWzB"}

package/dist/ndjson.js

@@ -0,0 +1,21 @@
+/**
+ * The values of a stream of newline-delimited JSON. A chunk can end inside a
+ * line, or inside a UTF-8 character: the line waits for the next chunk. An
+ * empty line has no value.
+ */
+export async function* ndjson(chunks) {
+    const decoder = new TextDecoder();
+    let rest = '';
+    for await (const chunk of chunks) {
+        rest += decoder.decode(chunk, { stream: true });
+        const lines = rest.split('\n');
+        rest = lines.pop() ?? '';
+        for (const line of lines)
+            if (line.trim())
+                yield JSON.parse(line);
+    }
+    rest += decoder.decode();
+    if (rest.trim())
+        yield JSON.parse(rest);
+}
+//# sourceMappingURL=ndjson.js.map

package/dist/ndjson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.js","sourceRoot":"","sources":["../src/ndjson.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,MAAM,CAC3B,MAAiC;IAEjC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/networks.d.ts

@@ -0,0 +1,46 @@
+import type { Container, Created } from './containers.ts';
+import type * as EngineApi from './engine-api.ts';
+import { type EngineClient } from './engine-client.ts';
+import type { CancelOptions, Filters } from './options.ts';
+/** A network, by the ID that the engine gave it. It has no disposal. */
+export declare class Network {
+    #private;
+    readonly id: string;
+    constructor(client: EngineClient, id: string);
+    inspect(options?: CancelOptions): Promise<EngineApi.NetworkInspect>;
+    connect(container: Container, endpoint?: EngineApi.NetworkConnectRequest['EndpointConfig'], options?: CancelOptions): Promise<void>;
+    disconnect(container: Container, options?: CancelOptions & {
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Resolves for 404. A 403 is a pre-defined network or a network with
+     * connected containers: an inspect tells which. A pre-defined network can
+     * have connected containers too, so its name decides first. Only a running
+     * container has an endpoint, so only a running one keeps the network.
+     */
+    remove(options?: CancelOptions): Promise<void>;
+}
+/** A network that this handle created. Disposal removes it. */
+export declare class OwnedNetwork extends Network implements AsyncDisposable {
+    /** remove() */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/** The networks of one engine. */
+export declare class Networks {
+    #private;
+    constructor(client: EngineClient);
+    /** From API 1.44, the engine refuses a taken name with 409: it rejects with NameConflictError. */
+    create(body: EngineApi.NetworkCreateRequest, options?: CancelOptions): Promise<OwnedNetwork>;
+    /**
+     * Creates the network, or gives the one that has the name. The network that
+     * exists wins. When that network is removed between the 409 and the
+     * inspect, the create runs again.
+     */
+    createOrGet(body: EngineApi.NetworkCreateRequest, options?: CancelOptions): Promise<Created<'network', OwnedNetwork, Network>>;
+    /** One inspect: a handle with the ID of the engine, or undefined for 404. */
+    find(nameOrId: string, options?: CancelOptions): Promise<Network | undefined>;
+    list(options?: CancelOptions & {
+        filters?: Filters;
+    }): Promise<EngineApi.NetworkSummary[]>;
+}
+//# sourceMappingURL=networks.d.ts.map

package/dist/networks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"networks.d.ts","sourceRoot":"","sources":["../src/networks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,KAAK,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAO7E,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAK3D,wEAAwE;AACxE,qBAAa,OAAO;;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAGR,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM;IAStC,OAAO,CACX,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC;IAc9B,OAAO,CACX,SAAS,EAAE,SAAS,EACpB,QAAQ,CAAC,EAAE,SAAS,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,EAC5D,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAKV,UAAU,CACd,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,aAAa,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAChD,OAAO,CAAC,IAAI,CAAC;IAKhB;;;;;OAKG;IACG,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAmDzD;AAED,+DAA+D;AAC/D,qBAAa,YAAa,SAAQ,OAAQ,YAAW,eAAe;IAClE,eAAe;IACT,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C;AAED,kCAAkC;AAClC,qBAAa,QAAQ;;gBAGP,MAAM,EAAE,YAAY;IAIhC,kGAAkG;IAC5F,MAAM,CACV,IAAI,EAAE,SAAS,CAAC,oBAAoB,EACpC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC;IAoBxB;;;;OAIG;IACG,WAAW,CACf,IAAI,EAAE,SAAS,CAAC,oBAAoB,EACpC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAYrD,6EAA6E;IACvE,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAUzB,IAAI,CACR,OAAO,GAAE,aAAa,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAClD,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;CAMvC"}