@ac-kit/integration-test-util 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# @ac-kit/integration-test-util
+
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [a5c4d66]
+- Updated dependencies [a5c4d66]
+- Updated dependencies [a5c4d66]
+  - @ac-kit/node@0.3.0
+  - @ac-kit/core@0.3.0
+  - @ac-kit/cmd-docker@0.2.1
+
+## 0.2.0
+
+### Minor Changes
+
+- a493b4a: **Breaking:** `initDockerSuite` no longer switches the machine's docker context,
+  and names everything it creates uniquely.
+  
+  - `contextName` is now `context`, and it is passed to every docker command
+    instead of being installed with `docker context use`. The old behaviour raced
+    between concurrent suites and left the developer's own context switched when a
+    run crashed.
+  - The image tag and the container names now carry a random per-suite id, so two
+    suites — including two runs of the same file — can no longer share a tag, and
+    one suite's teardown can no longer remove another's image.
+  - Teardown runs every step even when an earlier one throws, reporting the
+    failures together, so a container that refuses to die no longer strands the
+    image. The image is marked for removal before the build rather than after, so
+    a build that tags and then fails still gets cleaned up.
+  - Containers are started detached. Without it a foreground container never
+    returned control to the test.
+  - New `onContainerStarting` and `onContainerStopping` hooks fire before the run
+    and while the container is still reachable, beside the existing
+    `onContainerStarted` and `onContainerStopped`.
+  - `containerRunOptions` may no longer set `name`, `context` or `detach`, which
+    the suite owns.
+
+### Patch Changes
+
+- Updated dependencies [732a70b]
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [2ab5593]
+- Updated dependencies [a493b4a]
+- Updated dependencies [a493b4a]
+- Updated dependencies [70c1269]
+  - @ac-kit/cmd-docker@0.2.0
+  - @ac-kit/node@0.2.0
+  - @ac-kit/core@0.2.0

package/README.md

@@ -7,13 +7,22 @@ speaking the protocol you expect.
 ```ts
 import { initDockerSuite, isTcpPortOpen } from "@ac-kit/integration-test-util";
 
-// Registers beforeAll/afterAll/afterEach hooks covering the whole container
-// lifecycle: build the image, stop and remove the container between tests.
-const suite = initDockerSuite("./fixtures/postfix");
+// Registers beforeAll/beforeEach/afterEach/afterAll hooks covering the whole
+// container lifecycle: build the image once, run a detached container per test,
+// remove both afterwards. Every name it generates carries a random per-suite
+// id, so concurrent suites never collide.
+const suite = initDockerSuite("./fixtures/postfix", {
+  containerRunOptions: () => ({ publish: ["25:25"] }),
+});
 
 await isTcpPortOpen(25, "127.0.0.1");
 ```
 
+Pass `context` to run every command against one docker context; the suite never
+switches the machine's active one. `onContainerStarting`/`onContainerStarted`
+and `onContainerStopping`/`onContainerStopped` bracket each container, the
+"stopping" hook firing while it is still reachable.
+
 Also exposes `tryTcpConnectAndReadBanner` and `tryTlsConnectAndReadBanner`, for
 waiting until a server is not merely listening but actually answering.
 

package/dist/docker/init-docker-suite.d.ts

@@ -1,27 +1,48 @@
+import { type DockerContainerName, type DockerContainerRunOptions } from "@ac-kit/cmd-docker";
+import type { Except } from "type-fest";
 export type InitDockerSuiteOptions = {
+    /** Called with the name a container is about to be started under. */
+    onContainerStarting?: (name: DockerContainerName) => void | Promise<void>;
+    /** Called after a container is started. */
+    onContainerStarted?: (name: DockerContainerName) => void | Promise<void>;
+    /** Called before a container is removed, while it is still reachable. */
+    onContainerStopping?: (name: DockerContainerName) => void | Promise<void>;
+    /** Called after a container is removed. */
+    onContainerStopped?: (name: DockerContainerName) => void | Promise<void>;
     /**
-     * Prefix for the container name.
+     * Options to use when starting a container.
      *
-     * Defaults to "test-".
+     * The suite owns the name, the context and the detach flag: it has to know
+     * the name to remove the container, it runs every command against one
+     * context, and a container started in the foreground would never hand control
+     * back to the test.
      */
-    containerNamePrefix?: string;
+    containerRunOptions?: (name: DockerContainerName) => Except<DockerContainerRunOptions, "name" | "context" | "detach">;
     /**
-     * Docker context to switch to for all suite operations.
+     * Prefix for the image and container names.
      *
-     * Defaults to "default".
+     * Defaults to "test-".
      */
-    contextName?: string;
+    containerNamePrefix?: string;
+    /** Docker context to run every command of this suite against. */
+    context?: string;
+    /** Whether to reuse the same container instance across tests. */
+    reuseContainerInstance?: boolean;
 };
 export type DockerSuiteContext = {
-    containerName: string;
     containerImageName: string;
-    stopContainer: () => Promise<void>;
 };
 /**
- * Registers beforeAll / afterAll / afterEach hooks that handle the full Docker
- * lifecycle for a container test suite: - saves and restores the active Docker
- * context - builds the image from srcPath before all tests - removes the image
- * after all tests - stops and removes the container after each test
+ * Initializes a Docker test suite: builds the image at `srcPath` once, runs a
+ * container per test, and removes both afterwards.
+ *
+ * Every name it generates carries a random per-suite id, so two suites running
+ * concurrently — including two runs of the same file — never share an image tag
+ * or a container name, and neither one's cleanup can remove the other's.
+ *
+ * @param srcPath The build context to build the suite's image from.
+ * @param options Options for the suite.
+ * @returns The names the suite generated, for tests that need to address them.
  */
 export declare function initDockerSuite(srcPath: string, options?: InitDockerSuiteOptions): DockerSuiteContext;
 //# sourceMappingURL=init-docker-suite.d.ts.map

package/dist/docker/init-docker-suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-docker-suite.d.ts","sourceRoot":"","sources":["../../src/docker/init-docker-suite.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,sBAAsB,GAAG;IACpC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,sBAAsB,GAC9B,kBAAkB,CAqCpB"}
+{"version":3,"file":"init-docker-suite.d.ts","sourceRoot":"","sources":["../../src/docker/init-docker-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,mBAAmB,EAGxB,KAAK,yBAAyB,EAE9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,MAAM,sBAAsB,GAAG;IACpC,qEAAqE;IACrE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzE,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1E,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzE;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,CACrB,IAAI,EAAE,mBAAmB,KACrB,MAAM,CAAC,yBAAyB,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IAEtE;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAChC,kBAAkB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,sBAAsB,GAC9B,kBAAkB,CAgHpB"}

package/dist/docker/init-docker-suite.js

@@ -1,47 +1,110 @@
-import { dockerBuildxBuild, dockerContainerRm, dockerContextShow, dockerContextUse, dockerImageRm, } from "@ac-kit/cmd-docker";
+import { dockerBuildxBuild, dockerContainerRm, dockerContainerRun, dockerImageRm, } from "@ac-kit/cmd-docker";
 import { getRandomBytes } from "@ac-kit/crypto-random";
-import { afterAll, afterEach, beforeAll } from "vitest";
+import { afterAll, afterEach, beforeAll, beforeEach } from "vitest";
+function randomId(byteLength) {
+    return Buffer.from(getRandomBytes(byteLength)).toString("hex");
+}
 /**
- * Registers beforeAll / afterAll / afterEach hooks that handle the full Docker
- * lifecycle for a container test suite: - saves and restores the active Docker
- * context - builds the image from srcPath before all tests - removes the image
- * after all tests - stops and removes the container after each test
+ * Initializes a Docker test suite: builds the image at `srcPath` once, runs a
+ * container per test, and removes both afterwards.
+ *
+ * Every name it generates carries a random per-suite id, so two suites running
+ * concurrently — including two runs of the same file — never share an image tag
+ * or a container name, and neither one's cleanup can remove the other's.
+ *
+ * @param srcPath The build context to build the suite's image from.
+ * @param options Options for the suite.
+ * @returns The names the suite generated, for tests that need to address them.
  */
 export function initDockerSuite(srcPath, options) {
-    const prefix = options?.containerNamePrefix ?? "test-";
-    const contextName = options?.contextName ?? "default";
-    const containerName = `${prefix}${Buffer.from(getRandomBytes(20)).toString("hex")}`;
-    const containerImageName = `${containerName}-img`;
-    let initialContext;
-    async function stopContainer() {
-        try {
-            await dockerContainerRm([containerName], { force: true });
-        }
-        catch { }
+    const containerNamePrefix = options?.containerNamePrefix ?? "test-";
+    const suiteId = randomId(8);
+    const containerImageName = `${containerNamePrefix}${suiteId}-img`;
+    const commonOptions = { context: options?.context };
+    const startedContainerNames = [];
+    let imageBuildAttempted = false;
+    async function stopContainer(containerName) {
+        const index = startedContainerNames.indexOf(containerName);
+        if (index === -1) {
+            return;
+        }
+        // Untracked before the removal, so a removal that fails is reported once
+        // rather than retried until the drain loop gives up.
+        startedContainerNames.splice(index, 1);
+        await options?.onContainerStopping?.(containerName);
+        await dockerContainerRm([containerName], {
+            ...commonOptions,
+            force: true,
+        });
+        await options?.onContainerStopped?.(containerName);
+    }
+    async function stopAllContainers() {
+        while (startedContainerNames.length > 0) {
+            await stopContainer(startedContainerNames[0]);
+        }
+    }
+    async function removeImage() {
+        if (!imageBuildAttempted) {
+            return;
+        }
+        await dockerImageRm([containerImageName], {
+            ...commonOptions,
+            force: true,
+        });
     }
     beforeAll(async () => {
-        initialContext = await dockerContextShow();
-        await dockerContextUse(contextName);
-        await stopContainer();
-        try {
-            await dockerImageRm([containerImageName], { force: true });
-        }
-        catch { }
-        await dockerBuildxBuild(srcPath, { tags: [containerImageName] });
+        // Set before the build, not after: a build that tags the image and then
+        // fails still leaves one to remove.
+        imageBuildAttempted = true;
+        await dockerBuildxBuild(srcPath, {
+            ...commonOptions,
+            tags: [containerImageName],
+        });
     });
     afterAll(async () => {
-        try {
-            await dockerImageRm([containerImageName], { force: true });
+        // Every step runs even when an earlier one throws, or a container that
+        // refuses to die would strand the image for the rest of the machine.
+        const failures = [];
+        for (const step of [stopAllContainers, removeImage]) {
+            try {
+                await step();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        if (failures.length === 1) {
+            throw failures[0];
         }
-        catch { }
-        try {
-            await dockerContextUse(initialContext);
+        if (failures.length > 1) {
+            throw new AggregateError(failures, "Docker suite cleanup failed");
         }
-        catch { }
+    });
+    beforeEach(async () => {
+        if (options?.reuseContainerInstance && startedContainerNames.length > 0) {
+            return;
+        }
+        const containerName = `${containerNamePrefix}${suiteId}-${randomId(4)}`;
+        await options?.onContainerStarting?.(containerName);
+        await dockerContainerRun(containerImageName, {
+            ...options?.containerRunOptions?.(containerName),
+            ...commonOptions,
+            name: containerName,
+            detach: true,
+        });
+        // Tracked before the "started" hook so a hook that throws still leaves a
+        // container the teardown knows about.
+        startedContainerNames.push(containerName);
+        await options?.onContainerStarted?.(containerName);
     });
     afterEach(async () => {
-        await stopContainer();
+        if (options?.reuseContainerInstance) {
+            return;
+        }
+        await stopAllContainers();
     });
-    return { containerName, containerImageName, stopContainer };
+    return {
+        containerImageName,
+    };
 }
 //# sourceMappingURL=init-docker-suite.js.map

package/dist/docker/init-docker-suite.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-docker-suite.js","sourceRoot":"","sources":["../../src/docker/init-docker-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAwBxD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC9B,OAAe,EACf,OAAgC;IAEhC,MAAM,MAAM,GAAG,OAAO,EAAE,mBAAmB,IAAI,OAAO,CAAC;IACvD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,SAAS,CAAC;IACtD,MAAM,aAAa,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACpF,MAAM,kBAAkB,GAAG,GAAG,aAAa,MAAM,CAAC;IAClD,IAAI,cAAsB,CAAC;IAE3B,KAAK,UAAU,aAAa;QAC3B,IAAI,CAAC;YACJ,MAAM,iBAAiB,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC;IAED,SAAS,CAAC,KAAK,IAAI,EAAE;QACpB,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAC3C,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,aAAa,EAAE,CAAC;QACtB,IAAI,CAAC;YACJ,MAAM,aAAa,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,MAAM,iBAAiB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,CAAC;YACJ,MAAM,aAAa,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,IAAI,CAAC;YACJ,MAAM,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"init-docker-suite.js","sourceRoot":"","sources":["../../src/docker/init-docker-suite.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ac-kit/integration-test-util",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Test helpers that drive and probe external services — Docker containers, TCP and TLS banner checks — from a package's integration tests.",
   "keywords": [
     "docker",
@@ -38,15 +38,16 @@
     "prepack": "yarn build"
   },
   "dependencies": {
-    "@ac-kit/cmd-docker": "^0.1.0",
-    "@ac-kit/core": "^0.1.0",
+    "@ac-kit/cmd-docker": "^0.2.1",
+    "@ac-kit/core": "^0.3.0",
     "@ac-kit/crypto-random": "^0.1.0",
-    "@ac-kit/node": "^0.1.0"
+    "@ac-kit/node": "^0.3.0",
+    "type-fest": "^5.8.0"
   },
   "devDependencies": {
     "@ac-kit/tsconfig": "0.1.0",
     "@ac-kit/typedoc-config": "0.1.0",
-    "@ac-kit/vitest-config": "0.1.0",
+    "@ac-kit/vitest-config": "0.1.1",
     "@types/node": "26.5.1",
     "@typescript/native": "typescript@7.0.2",
     "rimraf": "6.1.3",