@ac-kit/integration-test-util 0.1.0

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,28 @@
+# @ac-kit/integration-test-util
+
+Test helpers that drive and probe **external** services: starting a Docker
+container for a suite, and checking that a TCP or TLS endpoint is up and
+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");
+
+await isTcpPortOpen(25, "127.0.0.1");
+```
+
+Also exposes `tryTcpConnectAndReadBanner` and `tryTlsConnectAndReadBanner`, for
+waiting until a server is not merely listening but actually answering.
+
+Separate from `@ac-kit/test-util` on purpose: this package is free to take
+heavier dependencies because only a handful of suites need it, while
+`test-util` must stay light enough for every suite in the tree.
+
+Node only.
+
+See the
+[generated API docs](https://anthochamp.github.io/node-essentials/api/integration-test-util/)
+for the full reference.

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

@@ -0,0 +1,27 @@
+export type InitDockerSuiteOptions = {
+    /**
+     * Prefix for the container name.
+     *
+     * Defaults to "test-".
+     */
+    containerNamePrefix?: string;
+    /**
+     * Docker context to switch to for all suite operations.
+     *
+     * Defaults to "default".
+     */
+    contextName?: string;
+};
+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
+ */
+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

@@ -0,0 +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"}

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

@@ -0,0 +1,47 @@
+import { dockerBuildxBuild, dockerContainerRm, dockerContextShow, dockerContextUse, dockerImageRm, } from "@ac-kit/cmd-docker";
+import { getRandomBytes } from "@ac-kit/crypto-random";
+import { afterAll, afterEach, beforeAll } from "vitest";
+/**
+ * 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
+ */
+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 { }
+    }
+    beforeAll(async () => {
+        initialContext = await dockerContextShow();
+        await dockerContextUse(contextName);
+        await stopContainer();
+        try {
+            await dockerImageRm([containerImageName], { force: true });
+        }
+        catch { }
+        await dockerBuildxBuild(srcPath, { tags: [containerImageName] });
+    });
+    afterAll(async () => {
+        try {
+            await dockerImageRm([containerImageName], { force: true });
+        }
+        catch { }
+        try {
+            await dockerContextUse(initialContext);
+        }
+        catch { }
+    });
+    afterEach(async () => {
+        await stopContainer();
+    });
+    return { containerName, containerImageName, stopContainer };
+}
+//# sourceMappingURL=init-docker-suite.js.map

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

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./docker/init-docker-suite.js";
+export * from "./net/is-tcp-port-open.js";
+export * from "./net/try-tcp-connect-n-read-banner.js";
+export * from "./net/try-tls-connect-n-read-banner.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,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./docker/init-docker-suite.js";
+export * from "./net/is-tcp-port-open.js";
+export * from "./net/try-tcp-connect-n-read-banner.js";
+export * from "./net/try-tls-connect-n-read-banner.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,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC"}

package/dist/net/is-tcp-port-open.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Test if a TCP port is open on a given host.
+ *
+ * @param port - The TCP port to test.
+ * @param host - The host to test the port on. Defaults to `localhost`.
+ * @returns A promise that resolves to `true` if the port is open, or `false` if
+ *   it is closed or unreachable.
+ */
+export declare function isTcpPortOpen(port: number, host?: string): Promise<boolean>;
+//# sourceMappingURL=is-tcp-port-open.d.ts.map

package/dist/net/is-tcp-port-open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-tcp-port-open.d.ts","sourceRoot":"","sources":["../../src/net/is-tcp-port-open.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3E"}

package/dist/net/is-tcp-port-open.js

@@ -0,0 +1,20 @@
+import { createConnection } from "node:net";
+/**
+ * Test if a TCP port is open on a given host.
+ *
+ * @param port - The TCP port to test.
+ * @param host - The host to test the port on. Defaults to `localhost`.
+ * @returns A promise that resolves to `true` if the port is open, or `false` if
+ *   it is closed or unreachable.
+ */
+export function isTcpPortOpen(port, host) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host, port });
+        socket.once("connect", () => {
+            socket.destroy();
+            resolve(true);
+        });
+        socket.once("error", () => resolve(false));
+    });
+}
+//# sourceMappingURL=is-tcp-port-open.js.map

package/dist/net/is-tcp-port-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-tcp-port-open.js","sourceRoot":"","sources":["../../src/net/is-tcp-port-open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAa;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/net/try-tcp-connect-n-read-banner.d.ts

@@ -0,0 +1,17 @@
+import { TcpSocketConnectOptions } from "@ac-kit/node";
+/**
+ * Connects to port, reads the first line, and returns whether it starts with
+ * bannerPrefix. Returns false on any connection or read error, or on abort.
+ *
+ * Note: This function does not support reading multi-line banners. It only
+ * reads the first line.
+ *
+ * @param port The TCP port to connect to.
+ * @param bannerPrefix The expected prefix of the banner.
+ * @param options Optional parameters including connection options and an abort
+ *   signal.
+ * @returns A promise that resolves to true if the banner starts with the
+ *   specified prefix, false otherwise.
+ */
+export declare function tryTcpConnectAndReadBanner(port: number, bannerPrefix: string, connectOptions?: TcpSocketConnectOptions): Promise<boolean>;
+//# sourceMappingURL=try-tcp-connect-n-read-banner.d.ts.map

package/dist/net/try-tcp-connect-n-read-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-tcp-connect-n-read-banner.d.ts","sourceRoot":"","sources":["../../src/net/try-tcp-connect-n-read-banner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,0BAA0B,CAC/C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,uBAAuB,GACtC,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/net/try-tcp-connect-n-read-banner.js

@@ -0,0 +1,43 @@
+import { createInterface } from "node:readline";
+import { TcpSocket } from "@ac-kit/node";
+/**
+ * Connects to port, reads the first line, and returns whether it starts with
+ * bannerPrefix. Returns false on any connection or read error, or on abort.
+ *
+ * Note: This function does not support reading multi-line banners. It only
+ * reads the first line.
+ *
+ * @param port The TCP port to connect to.
+ * @param bannerPrefix The expected prefix of the banner.
+ * @param options Optional parameters including connection options and an abort
+ *   signal.
+ * @returns A promise that resolves to true if the banner starts with the
+ *   specified prefix, false otherwise.
+ */
+export async function tryTcpConnectAndReadBanner(port, bannerPrefix, connectOptions) {
+    const socket = TcpSocket.from();
+    try {
+        await socket.connect(port, connectOptions);
+        const rl = createInterface({
+            input: socket.stream,
+            crlfDelay: Infinity,
+            signal: connectOptions?.signal,
+        });
+        try {
+            for await (const line of rl) {
+                return line.startsWith(bannerPrefix);
+            }
+            return false;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    catch {
+        return false;
+    }
+    finally {
+        socket.destroy();
+    }
+}
+//# sourceMappingURL=try-tcp-connect-n-read-banner.js.map

package/dist/net/try-tcp-connect-n-read-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-tcp-connect-n-read-banner.js","sourceRoot":"","sources":["../../src/net/try-tcp-connect-n-read-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,SAAS,EAA2B,MAAM,cAAc,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC/C,IAAY,EACZ,YAAoB,EACpB,cAAwC;IAExC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC;QACJ,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,eAAe,CAAC;YAC1B,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,cAAc,EAAE,MAAM;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC;YACJ,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACV,EAAE,CAAC,KAAK,EAAE,CAAC;QACZ,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/net/try-tls-connect-n-read-banner.d.ts

@@ -0,0 +1,16 @@
+import { type TlsSocketConnectOptions } from "@ac-kit/node";
+/**
+ * Connects to port over TLS, reads the first line, and returns whether it
+ * starts with bannerPrefix. Returns false on any connection or read error, or
+ * on abort.
+ *
+ * Use with {@link waitFor} from `@ac-kit/core` to poll until ready:
+ *
+ * ```ts
+ * await waitFor(() => tryReadTlsBanner(port, banner), {
+ * 	signal: AbortSignal.timeout(30_000),
+ * });
+ * ```
+ */
+export declare function tryTlsConnectAndReadBanner(port: number, bannerPrefix: string, options?: TlsSocketConnectOptions): Promise<boolean>;
+//# sourceMappingURL=try-tls-connect-n-read-banner.d.ts.map

package/dist/net/try-tls-connect-n-read-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-tls-connect-n-read-banner.d.ts","sourceRoot":"","sources":["../../src/net/try-tls-connect-n-read-banner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAC/C,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/net/try-tls-connect-n-read-banner.js

@@ -0,0 +1,42 @@
+import { createInterface } from "node:readline";
+import { TlsSocket } from "@ac-kit/node";
+/**
+ * Connects to port over TLS, reads the first line, and returns whether it
+ * starts with bannerPrefix. Returns false on any connection or read error, or
+ * on abort.
+ *
+ * Use with {@link waitFor} from `@ac-kit/core` to poll until ready:
+ *
+ * ```ts
+ * await waitFor(() => tryReadTlsBanner(port, banner), {
+ * 	signal: AbortSignal.timeout(30_000),
+ * });
+ * ```
+ */
+export async function tryTlsConnectAndReadBanner(port, bannerPrefix, options) {
+    let socket;
+    try {
+        socket = await TlsSocket.connect(port, options);
+        const rl = createInterface({
+            input: socket.stream,
+            crlfDelay: Infinity,
+            signal: options?.signal,
+        });
+        try {
+            for await (const line of rl) {
+                return line.startsWith(bannerPrefix);
+            }
+            return false;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    catch {
+        return false;
+    }
+    finally {
+        socket?.destroy();
+    }
+}
+//# sourceMappingURL=try-tls-connect-n-read-banner.js.map

package/dist/net/try-tls-connect-n-read-banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-tls-connect-n-read-banner.js","sourceRoot":"","sources":["../../src/net/try-tls-connect-n-read-banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAgC,MAAM,cAAc,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC/C,IAAY,EACZ,YAAoB,EACpB,OAAiC;IAEjC,IAAI,MAA6B,CAAC;IAClC,IAAI,CAAC;QACJ,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,eAAe,CAAC;YAC1B,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,SAAS,EAAE,QAAQ;YACnB,MAAM,EAAE,OAAO,EAAE,MAAM;SACvB,CAAC,CAAC;QACH,IAAI,CAAC;YACJ,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACV,EAAE,CAAC,KAAK,EAAE,CAAC;QACZ,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACV,MAAM,EAAE,OAAO,EAAE,CAAC;IACnB,CAAC;AACF,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ac-kit/integration-test-util",
+  "version": "0.1.0",
+  "description": "Test helpers that drive and probe external services — Docker containers, TCP and TLS banner checks — from a package's integration tests.",
+  "keywords": [
+    "docker",
+    "integration",
+    "tcp",
+    "testing"
+  ],
+  "homepage": "https://anthochamp.github.io/node-essentials/api/integration-test-util/",
+  "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/integration-test-util"
+  },
+  "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/cmd-docker": "^0.1.0",
+    "@ac-kit/core": "^0.1.0",
+    "@ac-kit/crypto-random": "^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",
+    "vite": "8.3.0",
+    "vitest": "5.0.0"
+  },
+  "peerDependencies": {
+    "vitest": ">=4.0.0"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}