@zukhruf/docker 0.0.0-stage → 0.3.34

package/dist/networks.js

@@ -0,0 +1,170 @@
+import { isSuccess, parseBody } from "./engine-client.js";
+import { ContainerNotFoundError, NameConflictError, NetworkInUseError, NetworkNotFoundError, } from "./errors.js";
+/** The networks that the engine defines and never removes: runconfig.IsPreDefinedNetwork of Moby. */
+const PREDEFINED_NETWORKS = new Set(['bridge', 'host', 'none']);
+/** A network, by the ID that the engine gave it. It has no disposal. */
+export class Network {
+    id;
+    #client;
+    constructor(client, id) {
+        this.#client = client;
+        this.id = id;
+    }
+    get #path() {
+        return `/networks/${encodeURIComponent(this.id)}`;
+    }
+    async inspect(options = {}) {
+        const method = 'GET';
+        const path = this.#path;
+        const response = await this.#client.exchange(method, path, options);
+        if (isSuccess(response)) {
+            return parseBody(response);
+        }
+        const error = this.#client.error(response, method, path);
+        if (response.status !== 404)
+            throw error;
+        throw new NetworkNotFoundError(error.message, error, this.id, {
+            cause: error,
+        });
+    }
+    async connect(container, endpoint, options = {}) {
+        const body = { Container: container.id, EndpointConfig: endpoint };
+        await this.#endpoint('connect', container, body, options);
+    }
+    async disconnect(container, options = {}) {
+        const body = { Container: container.id, Force: options.force };
+        await this.#endpoint('disconnect', container, body, options);
+    }
+    /**
+     * 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.
+     */
+    async remove(options = {}) {
+        const method = 'DELETE';
+        const path = this.#path;
+        const response = await this.#client.exchange(method, path, options);
+        if (isSuccess(response) || response.status === 404)
+            return;
+        const error = this.#client.error(response, method, path);
+        if (response.status !== 403)
+            throw error;
+        const inspect = await this.#client.exchange('GET', path, options);
+        if (inspect.status === 404)
+            return;
+        if (!isSuccess(inspect))
+            throw error;
+        const network = parseBody(inspect);
+        if (PREDEFINED_NETWORKS.has(network.Name))
+            throw error;
+        const containers = Object.keys(network.Containers ?? {});
+        if (containers.length === 0)
+            throw error;
+        throw new NetworkInUseError(error.message, error, this.id, containers, {
+            cause: error,
+        });
+    }
+    /**
+     * A 404 of a connect or a disconnect is a missing network or a missing
+     * container: an inspect of the network tells which. An engine in swarm mode
+     * answers a missing network with 500 ("Could not attach to network", probed
+     * at API 1.51), so a 500 gets the same inspect.
+     */
+    async #endpoint(action, container, body, options) {
+        const method = 'POST';
+        const path = `${this.#path}/${action}`;
+        const response = await this.#client.exchange(method, path, {
+            body,
+            signal: options.signal,
+        });
+        if (isSuccess(response))
+            return;
+        const error = this.#client.error(response, method, path);
+        if (response.status !== 404 && response.status !== 500)
+            throw error;
+        const inspect = await this.#client.exchange('GET', this.#path, options);
+        if (inspect.status === 404) {
+            throw new NetworkNotFoundError(error.message, error, this.id, {
+                cause: error,
+            });
+        }
+        if (response.status === 500)
+            throw error;
+        throw new ContainerNotFoundError(error.message, error, container.id, {
+            cause: error,
+        });
+    }
+}
+/** A network that this handle created. Disposal removes it. */
+export class OwnedNetwork extends Network {
+    /** remove() */
+    async [Symbol.asyncDispose]() {
+        await this.remove();
+    }
+}
+/** The networks of one engine. */
+export class Networks {
+    #client;
+    constructor(client) {
+        this.#client = client;
+    }
+    /** From API 1.44, the engine refuses a taken name with 409: it rejects with NameConflictError. */
+    async create(body, options = {}) {
+        const method = 'POST';
+        const path = '/networks/create';
+        const response = await this.#client.exchange(method, path, {
+            body,
+            signal: options.signal,
+        });
+        if (isSuccess(response)) {
+            const { Id } = parseBody(response);
+            return new OwnedNetwork(this.#client, Id);
+        }
+        const error = this.#client.error(response, method, path);
+        if (response.status === 409) {
+            throw new NameConflictError(error.message, error, 'network', body.Name, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+    /**
+     * 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.
+     */
+    async createOrGet(body, options = {}) {
+        for (;;) {
+            try {
+                return { created: true, network: await this.create(body, options) };
+            }
+            catch (error) {
+                if (!(error instanceof NameConflictError))
+                    throw error;
+            }
+            const network = await this.find(body.Name, options);
+            if (network)
+                return { created: false, network };
+        }
+    }
+    /** One inspect: a handle with the ID of the engine, or undefined for 404. */
+    async find(nameOrId, options = {}) {
+        const method = 'GET';
+        const path = `/networks/${encodeURIComponent(nameOrId)}`;
+        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);
+        const { Id } = parseBody(response);
+        return new Network(this.#client, Id);
+    }
+    async list(options = {}) {
+        return this.#client.json('GET', '/networks', {
+            query: { filters: options.filters },
+            signal: options.signal,
+        });
+    }
+}
+//# sourceMappingURL=networks.js.map

package/dist/networks.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,7 @@
+export interface CancelOptions {
+    /** Cancels the wait for the engine. */
+    signal?: AbortSignal;
+}
+/** The filters of a list or of the events, as the Engine API takes them. */
+export type Filters = Record<string, string[]>;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,4EAA4E;AAC5E,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC"}

package/dist/options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":""}

package/dist/output.d.ts

@@ -0,0 +1,18 @@
+import type { OutputChunk } from './multiplexed-stream.ts';
+export interface Output {
+    stdout: string;
+    stderr: string;
+    /** Standard output and standard error, in the order of the engine. */
+    output: string;
+}
+export interface ExecResult extends Output {
+    exitCode: number;
+}
+/**
+ * Reads each chunk and decodes the text of each stream. A chunk can end inside
+ * a UTF-8 character: the character waits for the next chunk of the same
+ * stream, and `output` gets it then, so a chunk of the other stream between
+ * the two parts never breaks it. The text is not trimmed.
+ */
+export declare function readOutput(chunks: AsyncIterable<OutputChunk>): Promise<Output>;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/output.js

@@ -0,0 +1,21 @@
+/**
+ * Reads each chunk and decodes the text of each stream. A chunk can end inside
+ * a UTF-8 character: the character waits for the next chunk of the same
+ * stream, and `output` gets it then, so a chunk of the other stream between
+ * the two parts never breaks it. The text is not trimmed.
+ */
+export async function readOutput(chunks) {
+    const decoders = { stdout: new TextDecoder(), stderr: new TextDecoder() };
+    const text = { stdout: '', stderr: '', output: '' };
+    const append = (stream, piece) => {
+        text[stream] += piece;
+        text.output += piece;
+    };
+    for await (const { stream, data } of chunks) {
+        append(stream, decoders[stream].decode(data, { stream: true }));
+    }
+    append('stdout', decoders.stdout.decode());
+    append('stderr', decoders.stderr.decode());
+    return text;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAkC;IAElC,MAAM,QAAQ,GAAG,EAAE,MAAM,EAAE,IAAI,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,WAAW,EAAE,EAAE,CAAC;IAC1E,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,CAAC,MAA6B,EAAE,KAAa,EAAE,EAAE;QAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;QACtB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IACvB,CAAC,CAAC;IACF,IAAI,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/progress.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reads the progress of the engine to its end. The engine reports an error in
+ * the progress after the status 200, so the DockerEngineError has no status.
+ */
+export declare function readProgress(chunks: AsyncIterable<Uint8Array>, request: {
+    method: string;
+    path: string;
+}): Promise<void>;
+//# sourceMappingURL=progress.d.ts.map

package/dist/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/progress.js

@@ -0,0 +1,20 @@
+import { DockerEngineError } from "./errors.js";
+import { ndjson } from "./ndjson.js";
+function isProgressMessage(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Reads the progress of the engine to its end. The engine reports an error in
+ * the progress after the status 200, so the DockerEngineError has no status.
+ */
+export async function readProgress(chunks, request) {
+    for await (const message of ndjson(chunks)) {
+        if (!isProgressMessage(message))
+            continue;
+        const text = message.errorDetail?.message ?? message.error;
+        if (text !== undefined) {
+            throw new DockerEngineError(text, { status: undefined, request });
+        }
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAiC,EACjC,OAAyC;IAEzC,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;YAAE,SAAS;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAC3D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/ssh-connection.d.ts

@@ -0,0 +1,23 @@
+import { type ClientRequest, type RequestOptions } from 'node:http';
+import { Duplex } from 'node:stream';
+import type { Transport } from './transport.ts';
+/** `ssh` exited before the engine answered. It is the cause of a ConnectionFailedError. */
+export declare class SshExitError extends Error {
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    /** The last 4 KB of the standard error of `ssh`, such as "Permission denied (publickey)." */
+    readonly stderr: string;
+    constructor(exitCode: number | null, signal: NodeJS.Signals | null, stderr: string);
+}
+/** The arguments of the connection helper, as the connhelper of docker/cli gives them. */
+export declare function sshArguments(url: URL): string[];
+/** The connections to an engine at an ssh:// host. Each connection is one `ssh` process. */
+export declare class SshTransport implements Transport {
+    #private;
+    constructor(url: URL);
+    request(options: RequestOptions): ClientRequest;
+    /** Ends the standard input of `ssh`: `docker system dial-stdio` then closes the write side to the engine. */
+    endInput(socket: Duplex): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=ssh-connection.d.ts.map

package/dist/ssh-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-connection.d.ts","sourceRoot":"","sources":["../src/ssh-connection.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,2FAA2F;AAC3F,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvC,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGtB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,MAAM,EAAE,MAAM;CAUjB;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,CAc/C;AA4LD,4FAA4F;AAC5F,qBAAa,YAAa,YAAW,SAAS;;gBAGhC,GAAG,EAAE,GAAG;IAIpB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa;IAI/C,6GAA6G;IAC7G,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/ssh-connection.js

@@ -0,0 +1,225 @@
+import { spawn } from 'node:child_process';
+import { Agent, request, } from 'node:http';
+import { Socket } from 'node:net';
+import { Duplex } from 'node:stream';
+import { finished } from 'node:stream/promises';
+/** The part of the standard error of `ssh` that an SshExitError keeps: the last 4 KB. */
+const STDERR_LIMIT = 4096;
+/** `ssh` exited before the engine answered. It is the cause of a ConnectionFailedError. */
+export class SshExitError extends Error {
+    exitCode;
+    signal;
+    /** The last 4 KB of the standard error of `ssh`, such as "Permission denied (publickey)." */
+    stderr;
+    constructor(exitCode, signal, stderr) {
+        super(`ssh exited with ${exitCode === null ? `signal ${signal}` : `code ${exitCode}`}${stderr.trim() ? `: ${stderr.trim()}` : '.'}`);
+        this.name = 'SshExitError';
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.stderr = stderr;
+    }
+}
+/** The arguments of the connection helper, as the connhelper of docker/cli gives them. */
+export function sshArguments(url) {
+    return [
+        '-T',
+        '-o',
+        'BatchMode=yes',
+        ...(url.username ? ['-l', decodeURIComponent(url.username)] : []),
+        ...(url.port ? ['-p', url.port] : []),
+        '--',
+        // An IPv6 address keeps its brackets in a URL; ssh takes it without them, as URL.Hostname() of Go gives it.
+        url.hostname.replace(/^\[(.*)\]$/, '$1'),
+        'docker',
+        'system',
+        'dial-stdio',
+    ];
+}
+/**
+ * One connection to an SSH engine: one `ssh` process that runs
+ * `docker system dial-stdio`. Its readable side is the standard output of
+ * `ssh`, and its writable side is the standard input of `ssh`.
+ *
+ * The end of the writable side ends the standard input of `ssh`, and
+ * `docker system dial-stdio` then closes the write side of its connection to
+ * the engine. This is the end of the input of an attach or an exec.
+ */
+class SshConnection extends Duplex {
+    #child;
+    #stderr = '';
+    /** Resolves when `ssh` exited and its pipes are closed. */
+    exited;
+    constructor(url) {
+        super({ allowHalfOpen: true });
+        const child = spawn('ssh', sshArguments(url), {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        this.#child = child;
+        const closed = new Promise((resolve) => {
+            child.once('close', () => resolve());
+        });
+        this.exited = () => closed;
+        child.on('error', (error) => this.destroy(error));
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', (chunk) => {
+            this.#stderr = (this.#stderr + chunk).slice(-STDERR_LIMIT);
+        });
+        child.stdout.on('data', (chunk) => {
+            if (!this.push(chunk))
+                child.stdout.pause();
+        });
+        child.stdout.once('end', () => {
+            void closed.then(() => {
+                const error = this.#exitError();
+                if (error)
+                    this.destroy(error);
+                else
+                    this.push(null);
+            });
+        });
+        // A write to the standard input of an `ssh` that exited fails with EPIPE.
+        // The write callback reports it, after the exit of `ssh` gives the reason.
+        child.stdin.on('error', () => undefined);
+    }
+    /** True until `ssh` exits. */
+    get running() {
+        return this.#child.exitCode === null && this.#child.signalCode === null;
+    }
+    /** The exit of `ssh` as an error, or undefined while it runs or when it exited with 0. */
+    #exitError() {
+        const { exitCode, signalCode } = this.#child;
+        if (exitCode === 0 || (exitCode === null && signalCode === null)) {
+            return undefined;
+        }
+        return new SshExitError(exitCode, signalCode, this.#stderr);
+    }
+    /**
+     * Gives the exit of `ssh` in place of an error of its pipes, when `ssh`
+     * exited. When `ssh` exited with 0, its output is complete: the reader gets
+     * the end of the output before the error of the write, so a command that
+     * does not read all of its input still gives its output.
+     */
+    #fail(error, callback) {
+        void this.exited().then(async () => {
+            const exit = this.#exitError();
+            if (exit === undefined) {
+                await finished(this, { writable: false }).catch(() => undefined);
+            }
+            callback(exit ?? error);
+        });
+    }
+    _read() {
+        this.#child.stdout.resume();
+    }
+    _write(chunk, _encoding, callback) {
+        this.#child.stdin.write(chunk, (error) => {
+            if (error)
+                this.#fail(error, callback);
+            else
+                callback();
+        });
+    }
+    _final(callback) {
+        this.#child.stdin.end((error) => {
+            if (error)
+                this.#fail(error, callback);
+            else
+                callback();
+        });
+    }
+    _destroy(error, callback) {
+        const { exitCode, signalCode } = this.#child;
+        if (exitCode === null && signalCode === null) {
+            // The disposal waits for the exit, so the exit must keep the process running.
+            this.#child.ref();
+            this.#child.kill();
+        }
+        this.#child.stdin.destroy();
+        this.#child.stdout.destroy();
+        this.#child.stderr.destroy();
+        callback(error);
+    }
+    /** An idle connection does not keep the process running. */
+    unref() {
+        this.#child.unref();
+        for (const pipe of this.#pipes())
+            pipe.unref();
+    }
+    /** A connection in use keeps the process running. */
+    ref() {
+        this.#child.ref();
+        for (const pipe of this.#pipes())
+            pipe.ref();
+    }
+    #pipes() {
+        return [this.#child.stdin, this.#child.stdout, this.#child.stderr].filter((pipe) => pipe instanceof Socket);
+    }
+}
+/**
+ * Keeps the idle connections to an SSH engine for the next request, and
+ * starts a new `ssh` for each request that finds no idle connection.
+ */
+class SshAgent extends Agent {
+    #url;
+    #connections = new Set();
+    constructor(url) {
+        super({ keepAlive: true });
+        this.#url = url;
+    }
+    createConnection() {
+        const connection = new SshConnection(this.#url);
+        this.#connections.add(connection);
+        void connection.exited().then(() => {
+            this.#connections.delete(connection);
+            // An idle connection whose `ssh` exited, such as after a restart of the
+            // engine, cannot take the next request. Its close removes it from the
+            // free connections of the agent.
+            if (this.#isIdle(connection))
+                connection.destroy();
+        });
+        return connection;
+    }
+    #isIdle(connection) {
+        return Object.values(this.freeSockets).some((sockets) => sockets?.some((socket) => Object.is(socket, connection)));
+    }
+    /**
+     * The keepSocketAlive of Node sets a timeout and TCP keep-alive, which a
+     * connection through `ssh` does not have. The reuseSocket of Node stays: it
+     * removes the error listener of the idle connection and calls ref(). A
+     * connection whose `ssh` exited is not kept.
+     */
+    keepSocketAlive(socket) {
+        if (!(socket instanceof SshConnection))
+            return true;
+        if (!socket.running)
+            return false;
+        socket.unref();
+        return true;
+    }
+    /** Ends each `ssh` process and resolves when each one exited. */
+    async close() {
+        const connections = [...this.#connections];
+        this.destroy();
+        for (const connection of connections)
+            connection.destroy();
+        await Promise.all(connections.map((connection) => connection.exited()));
+    }
+}
+/** The connections to an engine at an ssh:// host. Each connection is one `ssh` process. */
+export class SshTransport {
+    #agent;
+    constructor(url) {
+        this.#agent = new SshAgent(url);
+    }
+    request(options) {
+        return request({ ...options, agent: this.#agent });
+    }
+    /** Ends the standard input of `ssh`: `docker system dial-stdio` then closes the write side to the engine. */
+    endInput(socket) {
+        socket.end();
+    }
+    async close() {
+        await this.#agent.close();
+    }
+}
+//# sourceMappingURL=ssh-connection.js.map

package/dist/ssh-connection.js.map

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

package/dist/tar-reader.d.ts

@@ -0,0 +1,22 @@
+/** One entry of a tar archive, with its bytes. */
+export interface TarEntry {
+    /** The name in the archive, without a trailing '/'. */
+    path: string;
+    /** 'link' is a hard link; 'other' is a device, a FIFO or another kind. */
+    type: 'file' | 'directory' | 'symlink' | 'link' | 'other';
+    mode: number;
+    uid: number;
+    gid: number;
+    /** Seconds since the Unix epoch. */
+    mtime: number;
+    /** The target of a symlink or of a hard link; '' for each other entry. */
+    linkTarget: string;
+    data: Uint8Array;
+}
+/**
+ * The entries of a tar archive, as the chunks come. It takes ustar, PAX
+ * headers for one entry ('x'), and the GNU long name ('L') and long link
+ * ('K'). It skips a global PAX header ('g'). Each entry comes with its bytes.
+ */
+export declare function tarEntries(chunks: AsyncIterable<Uint8Array>): AsyncGenerator<TarEntry>;
+//# sourceMappingURL=tar-reader.d.ts.map

package/dist/tar-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar-reader.d.ts","sourceRoot":"","sources":["../src/tar-reader.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB;AAwGD;;;;GAIG;AACH,wBAAuB,UAAU,CAC/B,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAChC,cAAc,CAAC,QAAQ,CAAC,CA4D1B"}