@zukhruf/docker 0.0.0-stage → 0.3.33

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAEA,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAE5C,6FAA6F;AAC7F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAalD"}

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/index.d.ts

@@ -0,0 +1,7 @@
+export type { DockerContext, Environment } from './context-store.ts';
+export { type ConnectOptions, Docker } from './docker.ts';
+export { ConnectionFailedError, ContextNotFoundError, DockerEngineError, DockerError, UnsupportedEngineError, UnsupportedHostError, } from './errors.ts';
+export type { CancelOptions, Filters } from './options.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,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,6FAA6F;AAC7F,YAAY,KAAK,SAAS,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Docker } from "./docker.js";
+export { ConnectionFailedError, ContextNotFoundError, DockerEngineError, DockerError, UnsupportedEngineError, UnsupportedHostError, } from "./errors.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,EAAuB,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

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/ssh-connection.d.ts

@@ -0,0 +1,20 @@
+import { type ClientRequest, type RequestOptions } from 'node:http';
+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;
+    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;AAInB,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,CAa/C;AA4JD,4FAA4F;AAC5F,qBAAa,YAAa,YAAW,SAAS;;gBAGhC,GAAG,EAAE,GAAG;IAIpB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa;IAIzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/ssh-connection.js

@@ -0,0 +1,189 @@
+import { spawn } from 'node:child_process';
+import { Agent, request, } from 'node:http';
+import { Socket } from 'node:net';
+import { Duplex } from 'node:stream';
+/** 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] : []),
+        '--',
+        url.hostname,
+        '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);
+    }
+    /** 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. */
+    #fail(error, callback) {
+        void this.exited().then(() => callback(this.#exitError() ?? 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));
+        return connection;
+    }
+    keepSocketAlive(socket) {
+        if (socket instanceof SshConnection)
+            socket.unref();
+        return true;
+    }
+    reuseSocket(socket) {
+        if (socket instanceof SshConnection)
+            socket.ref();
+    }
+    /** 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 });
+    }
+    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/transport.d.ts

@@ -0,0 +1,19 @@
+import { type ClientRequest, type RequestOptions } from 'node:http';
+/** The connections of a client to its engine. */
+export interface Transport {
+    request(options: RequestOptions): ClientRequest;
+    /** Closes each connection, idle or in use, and resolves when each one is closed. */
+    close(): Promise<void>;
+}
+/**
+ * The connections to one engine through a Unix socket or a Windows named pipe.
+ * It keeps idle connections for the next request, and an idle connection does
+ * not keep the process running: the agent unrefs each free socket.
+ */
+export declare class SocketTransport implements Transport {
+    #private;
+    constructor(socketPath: string);
+    request(options: RequestOptions): ClientRequest;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,WAAW,CAAC;AAEnB,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC;IAChD,oFAAoF;IACpF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,SAAS;;gBAInC,UAAU,EAAE,MAAM;IAI9B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa;IAQzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/transport.js

@@ -0,0 +1,24 @@
+import { Agent, request, } from 'node:http';
+/**
+ * The connections to one engine through a Unix socket or a Windows named pipe.
+ * It keeps idle connections for the next request, and an idle connection does
+ * not keep the process running: the agent unrefs each free socket.
+ */
+export class SocketTransport {
+    #socketPath;
+    #agent = new Agent({ keepAlive: true });
+    constructor(socketPath) {
+        this.#socketPath = socketPath;
+    }
+    request(options) {
+        return request({
+            ...options,
+            agent: this.#agent,
+            socketPath: this.#socketPath,
+        });
+    }
+    async close() {
+        this.#agent.destroy();
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAGL,OAAO,GACR,MAAM,WAAW,CAAC;AASnB;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACjB,WAAW,CAAS;IACpB,MAAM,GAAG,IAAI,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjD,YAAY,UAAkB;QAC5B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,OAAuB;QAC7B,OAAO,OAAO,CAAC;YACb,GAAG,OAAO;YACV,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@zukhruf/docker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.33",
+  "description": "A client for the Docker Engine API on Node.js. It selects the engine that the Docker CLI selects, and it sends HTTP requests to that engine through a Unix socket, a Windows named pipe or SSH, with no Docker CLI and no dependencies.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JanuaryLabs/zukhruf",
+    "directory": "packages/docker"
+  },
+  "bugs": {
+    "url": "https://github.com/JanuaryLabs/zukhruf/issues"
+  },
+  "homepage": "https://github.com/JanuaryLabs/zukhruf/tree/main/packages/docker#readme",
+  "keywords": [
+    "docker",
+    "docker-engine",
+    "engine-api",
+    "container",
+    "docker-context",
+    "unix-socket"
+  ],
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@zukhruf/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/spec/**",
+    "!**/*.tsbuildinfo",
+    "!**/*.test.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}