@ac-kit/cmd-docker 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Changed
+
+- Adds `rm`, `network`, `addHost`, and `volume` options to `dockerContainerRun`
+
+### Added
+
+- `dockerContainerExec` mimics `docker exec` command to execute a command in a
+  running container.
+- `dockerContainerStop` mimics `docker stop` command to stop a running
+  container.
+- `dockerNetworkCreate` mimics `docker network create` command to create a new
+  network.
+- `dockerNetworkRemove` mimics `docker network rm` command to remove a network.
+
+## [0.1.5] - 2026-08-08
+
+### Changed
+
+- Upgrade `@ac-essentials/util` dependency to `^0.7.0`.
+
+## [0.1.4] - 2026-03-01
+
+### Changed
+
+- Upgrade `@ac-essentials/util` dependency to `^0.6.0`.
+
+## [0.1.3] - 2025-09-20
+
+### Fixed
+
+- Fix unchecked indexed access.
+
+### Changed
+
+- Bump `type-fest` dependency to `^5.0.1`.
+
+## [0.1.2] - 2025-09-20
+
+### Fixed
+
+- Fixed dependencies binding in `package.json`.
+
+## [0.1.1] - 2025-09-13
+
+### Added
+
+- Added `sideEffects: false` to package.json for better tree-shaking.

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2024-2026 Anthony Champagne and contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,26 @@
+# @ac-kit/cmd-docker
+
+This package provides a set of reusable utilities and wrappers for working with
+CLI commands and processes in Node.js and TypeScript projects. It's designed to
+help you build robust, scriptable command-line tools and automate system tasks,
+with a focus on composability and reliability.
+
+## Installation
+
+You can install the package via npm:
+
+```bash
+npm install @ac-kit/cmd-docker
+```
+
+Or via yarn:
+
+```bash
+yarn add @ac-kit/cmd-docker
+```
+
+## Usage
+
+See the
+[generated API docs](https://anthochamp.github.io/node-essentials/api/cmd-docker/)
+for the full reference.

package/dist/buildx/buildx-build.d.ts

@@ -0,0 +1,6 @@
+import type { Url } from "node:url";
+export type DockerBuildxBuildOptions = {
+    tags?: string[];
+};
+export declare function dockerBuildxBuild(pathOrUrl: string | Url, options?: DockerBuildxBuildOptions): Promise<void>;
+//# sourceMappingURL=buildx-build.d.ts.map

package/dist/buildx/buildx-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildx-build.d.ts","sourceRoot":"","sources":["../../src/buildx/buildx-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC,MAAM,MAAM,wBAAwB,GAAG;IACtC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAsB,iBAAiB,CACtC,SAAS,EAAE,MAAM,GAAG,GAAG,EACvB,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/buildx/buildx-build.js

@@ -0,0 +1,11 @@
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerBuildxBuild(pathOrUrl, options) {
+    const execArgs = [];
+    for (const tag of options?.tags ?? []) {
+        execArgs.push(`--tag ${escapeCommandArg(tag)}`);
+    }
+    // oxlint-disable-next-line typescript/no-base-to-string
+    execArgs.push(escapeCommandArg(pathOrUrl.toString()));
+    await execAsync(`docker buildx build ${execArgs.join(" ")}`);
+}
+//# sourceMappingURL=buildx-build.js.map

package/dist/buildx/buildx-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildx-build.js","sourceRoot":"","sources":["../../src/buildx/buildx-build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,SAAuB,EACvB,OAAkC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEtD,MAAM,SAAS,CAAC,uBAAuB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/container/container-exec.d.ts

@@ -0,0 +1,11 @@
+import type { DockerContainerId, DockerContainerName } from "../types.js";
+export type DockerContainerExecOptions = {
+    env?: Record<string, string | number | bigint | boolean | null>;
+    user?: string;
+    workdir?: string;
+};
+export declare function dockerContainerExec(container: DockerContainerId | DockerContainerName, command: string, commandArgs?: string[], options?: DockerContainerExecOptions): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+//# sourceMappingURL=container-exec.d.ts.map

package/dist/container/container-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-exec.d.ts","sourceRoot":"","sources":["../../src/container/container-exec.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,SAAS,EAAE,iBAAiB,GAAG,mBAAmB,EAClD,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B7C"}

package/dist/container/container-exec.js

@@ -0,0 +1,22 @@
+import { stringifyEnvVariable } from "@ac-kit/core";
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerContainerExec(container, command, commandArgs, options) {
+    const execArgs = [];
+    for (const [k, v] of Object.entries(options?.env ?? {})) {
+        execArgs.push(`--env ${escapeCommandArg(stringifyEnvVariable(k, v))}`);
+    }
+    if (options?.user && options.user.length > 0) {
+        execArgs.push(`--user ${escapeCommandArg(options.user)}`);
+    }
+    if (options?.workdir && options.workdir.length > 0) {
+        execArgs.push(`--workdir ${escapeCommandArg(options.workdir)}`);
+    }
+    execArgs.push(escapeCommandArg(container));
+    execArgs.push(escapeCommandArg(command));
+    for (const commandArg of commandArgs ?? []) {
+        execArgs.push(escapeCommandArg(commandArg));
+    }
+    const { stdout, stderr } = await execAsync(`docker container exec ${execArgs.join(" ")}`, { encoding: "utf8" });
+    return { stdout, stderr };
+}
+//# sourceMappingURL=container-exec.js.map

package/dist/container/container-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-exec.js","sourceRoot":"","sources":["../../src/container/container-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,SAAkD,EAClD,OAAe,EACf,WAAsB,EACtB,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,UAAU,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,aAAa,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzC,KAAK,MAAM,UAAU,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CACzC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAC7C,EAAE,QAAQ,EAAE,MAAM,EAAE,CACpB,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/container/container-rm.d.ts

@@ -0,0 +1,8 @@
+import type { DockerContainerId, DockerContainerName } from "../types.js";
+export type DockerContainerRmOptions = {
+    force?: boolean;
+    link?: boolean;
+    volumes?: boolean;
+};
+export declare function dockerContainerRm(containers: (DockerContainerId | DockerContainerName)[], options?: DockerContainerRmOptions): Promise<void>;
+//# sourceMappingURL=container-rm.d.ts.map

package/dist/container/container-rm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-rm.d.ts","sourceRoot":"","sources":["../../src/container/container-rm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,wBAAwB,GAAG;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,iBAAiB,CACtC,UAAU,EAAE,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/container/container-rm.js

@@ -0,0 +1,18 @@
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerContainerRm(containers, options) {
+    const execArgs = [];
+    if (options?.force) {
+        execArgs.push("--force");
+    }
+    if (options?.link) {
+        execArgs.push("--link");
+    }
+    if (options?.volumes) {
+        execArgs.push("--volumes");
+    }
+    for (const container of containers) {
+        execArgs.push(escapeCommandArg(container));
+    }
+    await execAsync(`docker container rm ${execArgs.join(" ")}`);
+}
+//# sourceMappingURL=container-rm.js.map

package/dist/container/container-rm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-rm.js","sourceRoot":"","sources":["../../src/container/container-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAU3D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,UAAuD,EACvD,OAAkC;IAElC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,CAAC,uBAAuB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/container/container-run.d.ts

@@ -0,0 +1,13 @@
+import type { DockerContainerName } from "../types.js";
+export type DockerContainerRunOptions = {
+    rm?: boolean;
+    detach?: boolean;
+    name?: DockerContainerName;
+    network?: string;
+    addHost?: string[];
+    env?: Record<string, string | number | bigint | boolean | null>;
+    publish?: string[];
+    volume?: string[];
+};
+export declare function dockerContainerRun(image: string, command?: string, commandArgs?: string[], options?: DockerContainerRunOptions): Promise<void>;
+//# sourceMappingURL=container-run.d.ts.map

package/dist/container/container-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-run.d.ts","sourceRoot":"","sources":["../../src/container/container-run.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,yBAAyB,GAAG;IACvC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/container/container-run.js

@@ -0,0 +1,38 @@
+import { stringifyEnvVariable } from "@ac-kit/core";
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerContainerRun(image, command, commandArgs, options) {
+    const execArgs = [];
+    if (options?.rm) {
+        execArgs.push("--rm");
+    }
+    if (options?.detach) {
+        execArgs.push("--detach");
+    }
+    if (options?.name && options.name.length > 0) {
+        execArgs.push(`--name ${escapeCommandArg(options.name)}`);
+    }
+    if (options?.network && options.network.length > 0) {
+        execArgs.push(`--network ${escapeCommandArg(options.network)}`);
+    }
+    for (const h of options?.addHost ?? []) {
+        execArgs.push(`--add-host ${escapeCommandArg(h)}`);
+    }
+    for (const [k, v] of Object.entries(options?.env ?? {})) {
+        execArgs.push(`--env ${escapeCommandArg(stringifyEnvVariable(k, v))}`);
+    }
+    for (const e of options?.publish ?? []) {
+        execArgs.push(`--publish ${escapeCommandArg(e)}`);
+    }
+    for (const v of options?.volume ?? []) {
+        execArgs.push(`--volume ${escapeCommandArg(v)}`);
+    }
+    execArgs.push(escapeCommandArg(image));
+    if (command) {
+        execArgs.push(escapeCommandArg(command));
+        for (const commandArg of commandArgs ?? []) {
+            execArgs.push(escapeCommandArg(commandArg));
+        }
+    }
+    await execAsync(`docker container run ${execArgs.join(" ")}`);
+}
+//# sourceMappingURL=container-run.js.map

package/dist/container/container-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-run.js","sourceRoot":"","sources":["../../src/container/container-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAe3D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,KAAa,EACb,OAAgB,EAChB,WAAsB,EACtB,OAAmC;IAEnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,EAAE,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,UAAU,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,IAAI,CAAC,aAAa,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,cAAc,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,SAAS,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;QACxC,QAAQ,CAAC,IAAI,CAAC,aAAa,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvC,IAAI,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;QAEzC,KAAK,MAAM,UAAU,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7C,CAAC;IACF,CAAC;IAED,MAAM,SAAS,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/container/container-stop.d.ts

@@ -0,0 +1,7 @@
+import type { DockerContainerId, DockerContainerName } from "../types.js";
+export type DockerContainerStopOptions = {
+    /** Seconds to wait before killing the container. */
+    time?: number;
+};
+export declare function dockerContainerStop(containers: (DockerContainerId | DockerContainerName)[], options?: DockerContainerStopOptions): Promise<void>;
+//# sourceMappingURL=container-stop.d.ts.map

package/dist/container/container-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-stop.d.ts","sourceRoot":"","sources":["../../src/container/container-stop.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,0BAA0B,GAAG;IACxC,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,UAAU,EAAE,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,EAAE,EACvD,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/container/container-stop.js

@@ -0,0 +1,12 @@
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerContainerStop(containers, options) {
+    const execArgs = [];
+    if (options?.time !== undefined) {
+        execArgs.push(`--time ${options.time}`);
+    }
+    for (const container of containers) {
+        execArgs.push(escapeCommandArg(container));
+    }
+    await execAsync(`docker container stop ${execArgs.join(" ")}`);
+}
+//# sourceMappingURL=container-stop.js.map

package/dist/container/container-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-stop.js","sourceRoot":"","sources":["../../src/container/container-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAS3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,UAAuD,EACvD,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,CAAC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/context/context-show.d.ts

@@ -0,0 +1,2 @@
+export declare function dockerContextShow(): Promise<string>;
+//# sourceMappingURL=context-show.d.ts.map

package/dist/context/context-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-show.d.ts","sourceRoot":"","sources":["../../src/context/context-show.ts"],"names":[],"mappings":"AAEA,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAMzD"}

package/dist/context/context-show.js

@@ -0,0 +1,8 @@
+import { execAsync } from "@ac-kit/node";
+export async function dockerContextShow() {
+    const { stdout } = await execAsync("docker context show", {
+        encoding: "utf8",
+    });
+    return stdout;
+}
+//# sourceMappingURL=context-show.js.map

package/dist/context/context-show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-show.js","sourceRoot":"","sources":["../../src/context/context-show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACzD,QAAQ,EAAE,MAAM;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/context/context-use.d.ts

@@ -0,0 +1,2 @@
+export declare function dockerContextUse(context: string): Promise<void>;
+//# sourceMappingURL=context-use.d.ts.map

package/dist/context/context-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-use.d.ts","sourceRoot":"","sources":["../../src/context/context-use.ts"],"names":[],"mappings":"AAEA,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE"}

package/dist/context/context-use.js

@@ -0,0 +1,5 @@
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerContextUse(context) {
+    await execAsync(`docker context use ${escapeCommandArg(context)}`);
+}
+//# sourceMappingURL=context-use.js.map

package/dist/context/context-use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-use.js","sourceRoot":"","sources":["../../src/context/context-use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACrD,MAAM,SAAS,CAAC,sBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/image/image-rm.d.ts

@@ -0,0 +1,8 @@
+type DockerImageId = string;
+export type DockerImageRmOptions = {
+    force?: boolean;
+    noPrune?: boolean;
+};
+export declare function dockerImageRm(images: DockerImageId[], options?: DockerImageRmOptions): Promise<void>;
+export {};
+//# sourceMappingURL=image-rm.d.ts.map

package/dist/image/image-rm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-rm.d.ts","sourceRoot":"","sources":["../../src/image/image-rm.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG,MAAM,CAAC;AAE5B,MAAM,MAAM,oBAAoB,GAAG;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,aAAa,CAClC,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/image/image-rm.js

@@ -0,0 +1,15 @@
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerImageRm(images, options) {
+    const execArgs = [];
+    if (options?.force) {
+        execArgs.push("--force");
+    }
+    if (options?.noPrune) {
+        execArgs.push("--no-prune");
+    }
+    for (const image of images) {
+        execArgs.push(escapeCommandArg(image));
+    }
+    await execAsync(`docker image rm ${execArgs.join(" ")}`);
+}
+//# sourceMappingURL=image-rm.js.map

package/dist/image/image-rm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-rm.js","sourceRoot":"","sources":["../../src/image/image-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAS3D,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAAuB,EACvB,OAA8B;IAE9B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,SAAS,CAAC,mBAAmB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./buildx/buildx-build.js";
+export * from "./container/container-exec.js";
+export * from "./container/container-rm.js";
+export * from "./container/container-run.js";
+export * from "./container/container-stop.js";
+export * from "./context/context-show.js";
+export * from "./context/context-use.js";
+export * from "./image/image-rm.js";
+export * from "./network/network-create.js";
+export * from "./network/network-rm.js";
+export * from "./types.js";
+//# 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,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from "./buildx/buildx-build.js";
+export * from "./container/container-exec.js";
+export * from "./container/container-rm.js";
+export * from "./container/container-run.js";
+export * from "./container/container-stop.js";
+export * from "./context/context-show.js";
+export * from "./context/context-use.js";
+export * from "./image/image-rm.js";
+export * from "./network/network-create.js";
+export * from "./network/network-rm.js";
+export * from "./types.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":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/dist/network/network-create.d.ts

@@ -0,0 +1,5 @@
+export type DockerNetworkCreateOptions = {
+    driver?: string;
+};
+export declare function dockerNetworkCreate(network: string, options?: DockerNetworkCreateOptions): Promise<void>;
+//# sourceMappingURL=network-create.d.ts.map

package/dist/network/network-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-create.d.ts","sourceRoot":"","sources":["../../src/network/network-create.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,0BAA0B,GAAG;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/network/network-create.js

@@ -0,0 +1,10 @@
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerNetworkCreate(network, options) {
+    const execArgs = [];
+    if (options?.driver && options.driver.length > 0) {
+        execArgs.push(`--driver ${escapeCommandArg(options.driver)}`);
+    }
+    execArgs.push(escapeCommandArg(network));
+    await execAsync(`docker network create ${execArgs.join(" ")}`);
+}
+//# sourceMappingURL=network-create.js.map

package/dist/network/network-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-create.js","sourceRoot":"","sources":["../../src/network/network-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM3D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAe,EACf,OAAoC;IAEpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,YAAY,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzC,MAAM,SAAS,CAAC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/network/network-rm.d.ts

@@ -0,0 +1,2 @@
+export declare function dockerNetworkRm(networks: string[]): Promise<void>;
+//# sourceMappingURL=network-rm.d.ts.map

package/dist/network/network-rm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-rm.d.ts","sourceRoot":"","sources":["../../src/network/network-rm.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/network/network-rm.js

@@ -0,0 +1,6 @@
+import { escapeCommandArg, execAsync } from "@ac-kit/node";
+export async function dockerNetworkRm(networks) {
+    const execArgs = networks.map((n) => escapeCommandArg(n));
+    await execAsync(`docker network rm ${execArgs.join(" ")}`);
+}
+//# sourceMappingURL=network-rm.js.map

package/dist/network/network-rm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-rm.js","sourceRoot":"","sources":["../../src/network/network-rm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAkB;IACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1D,MAAM,SAAS,CAAC,qBAAqB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+export type DockerContainerId = string;
+export type DockerContainerName = string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACvC,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@ac-kit/cmd-docker",
+  "version": "0.1.0",
+  "description": "Typed wrapper over the docker CLI: invocation plus output parsing.",
+  "keywords": [
+    "cli",
+    "container",
+    "docker",
+    "wrapper"
+  ],
+  "homepage": "https://anthochamp.github.io/node-essentials/api/cmd-docker/",
+  "bugs": {
+    "url": "https://github.com/anthochamp/node-essentials/issues"
+  },
+  "license": "BSD-3-Clause",
+  "author": "Anthony Champagne <dev@anthonychampagne.fr>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthochamp/node-essentials.git",
+    "directory": "packages/cmd-docker"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "publishConfig": {
+    "main": "./dist/index.js",
+    "access": "public"
+  },
+  "scripts": {
+    "compile": "tsc -p ./tsconfig.build.json -outDir dist",
+    "compile:check": "tsc -noEmit -p ./tsconfig.json",
+    "clean": "rimraf dist",
+    "build": "yarn clean && yarn compile",
+    "test": "yarn run -T vitest run",
+    "prepack": "yarn build"
+  },
+  "dependencies": {
+    "@ac-kit/core": "^0.1.0",
+    "@ac-kit/node": "^0.1.0"
+  },
+  "devDependencies": {
+    "@ac-kit/tsconfig": "0.1.0",
+    "@ac-kit/typedoc-config": "0.1.0",
+    "@ac-kit/vitest-config": "0.1.0",
+    "@types/node": "26.5.1",
+    "@typescript/native": "typescript@7.0.2",
+    "rimraf": "6.1.3",
+    "typedoc": "0.28.20",
+    "typescript": "@typescript/typescript6@6.0.2"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}