@stacks/api-test-toolkit 1.12.2

package/README.md

@@ -0,0 +1,99 @@
+# @stacks/api-test-toolkit
+
+Test utilities for integration tests that need Docker-managed dependencies (for example Postgres).
+
+## Installation
+
+```bash
+npm install -D @stacks/api-test-toolkit
+```
+
+This package expects Docker to be available on the machine running tests.
+
+## Quick Start
+
+Use the toolkit in your test global setup/teardown hooks.
+
+```ts
+import type { DockerTestContainerConfig } from '@stacks/api-test-toolkit';
+import { dockerTestDown, dockerTestUp } from '@stacks/api-test-toolkit';
+
+const postgres: DockerTestContainerConfig = {
+  image: 'postgres:17',
+  name: 'my-api-test-postgres',
+  ports: [{ host: 5432, container: 5432 }],
+  env: ['POSTGRES_USER=postgres', 'POSTGRES_PASSWORD=postgres', 'POSTGRES_DB=postgres'],
+};
+
+export async function globalSetup() {
+  await dockerTestUp({ config: postgres });
+}
+
+export async function globalTeardown() {
+  await dockerTestDown({ config: postgres });
+}
+```
+
+## API
+
+### `dockerTestUp({ config })`
+
+Creates (or starts) the container and waits until it is reachable on TCP by default.
+
+- Pulls image if missing
+- Reuses an existing container with the same name
+- Waits for readiness unless `waitForReady` is set to `false`
+
+### `dockerTestDown({ config })`
+
+Stops and removes the container if it exists.
+
+- No-op if the container is already absent
+
+### `dockerTestLogs({ config, argv })`
+
+Streams or prints recent container logs.
+
+- Follows logs by default
+- Use `argv: ['--once']` to print once and exit
+- `-f` / `--follow` force streaming mode
+
+## `DockerTestContainerConfig`
+
+Required fields:
+
+- `image`: Docker image name (example: `postgres:17`)
+- `name`: Docker container name
+- `ports`: host/container port mapping array
+
+Common optional fields:
+
+- `host`: bind address (default: `127.0.0.1`)
+- `waitPort`: host-side port to probe for readiness
+- `waitForReady`: disable readiness check when set to `false`
+- `env`: environment variables (`KEY=value`)
+- `entrypoint`, `command`
+- `volumes`: mount strings in `host:container` format
+- `extraHosts`: `hostname:ip` entries
+- `healthcheck`: shell command passed as Docker `CMD-SHELL`
+- `restartPolicy`: `no | always | on-failure | unless-stopped`
+- `labels`
+- `timeoutMs`: readiness timeout (default: `120000`)
+
+## Docker client environment
+
+By default, Docker is accessed through:
+
+- `DOCKER_SOCKET_PATH` (defaults to `/var/run/docker.sock`)
+
+If `DOCKER_HOST` is set, it is used instead.
+
+## Notes
+
+- Prefer `import type` for TypeScript-only symbols:
+  - `import type { DockerTestContainerConfig } from '@stacks/api-test-toolkit'`
+- Container names should be unique per test suite to avoid clashes.
+
+## License
+
+Apache 2.0

package/dist/docker-container.d.ts

@@ -0,0 +1,46 @@
+export interface DockerTestPortMapping {
+    host: number;
+    container: number;
+}
+export interface DockerTestContainerConfig {
+    /** Docker image (e.g. "postgres:17") */
+    image: string;
+    /** Container name */
+    name: string;
+    /** Host to bind to (default: "127.0.0.1") */
+    host?: string;
+    /** Port mappings (host → container) */
+    ports: DockerTestPortMapping[];
+    /** Port to wait on before declaring the container ready (default: first port's host side) */
+    waitPort?: number;
+    /** Set to false to skip the port-readiness check (e.g. for one-shot sidecars) */
+    waitForReady?: boolean;
+    /** Environment variables */
+    env?: string[];
+    /** Override the image entrypoint */
+    entrypoint?: string[];
+    /** Override the image command */
+    command?: string[];
+    /** Bind-mount volumes ("host:container") */
+    volumes?: string[];
+    /** Extra /etc/hosts entries ("hostname:ip") */
+    extraHosts?: string[];
+    /** Docker healthcheck command (passed after CMD-SHELL) */
+    healthcheck?: string;
+    /** Restart policy (default: no) */
+    restartPolicy?: 'no' | 'always' | 'on-failure' | 'unless-stopped';
+    /** Labels to attach to the container */
+    labels?: Record<string, string>;
+    /** Startup timeout in ms (default: 120_000) */
+    timeoutMs?: number;
+}
+export declare function dockerTestUp(args: {
+    config: DockerTestContainerConfig;
+}): Promise<void>;
+export declare function dockerTestDown(args: {
+    config: DockerTestContainerConfig;
+}): Promise<void>;
+export declare function dockerTestLogs(args: {
+    config: DockerTestContainerConfig;
+    argv: string[];
+}): Promise<void>;

package/dist/docker-container.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerTestUp = dockerTestUp;
+exports.dockerTestDown = dockerTestDown;
+exports.dockerTestLogs = dockerTestLogs;
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+const node_assert_1 = require("node:assert");
+const net = require("node:net");
+const Docker = require("dockerode");
+const DEFAULTS = {
+    host: '127.0.0.1',
+    timeoutMs: 120_000,
+};
+function createDockerClient() {
+    if (process.env.DOCKER_HOST) {
+        const dockerHost = new URL(process.env.DOCKER_HOST);
+        return new Docker({
+            host: dockerHost.hostname,
+            port: Number(dockerHost.port),
+            protocol: dockerHost.protocol.replace(':', ''),
+        });
+    }
+    return new Docker({ socketPath: process.env.DOCKER_SOCKET_PATH ?? '/var/run/docker.sock' });
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function streamToPromise(stream) {
+    return new Promise((resolve, reject) => {
+        stream.on('end', () => resolve());
+        stream.on('error', reject);
+    });
+}
+async function pullImageIfMissing(docker, image) {
+    const images = (await docker.listImages());
+    const hasImage = images.some(img => img.RepoTags?.includes(image));
+    if (hasImage)
+        return;
+    process.stdout.write(`[testenv] pulling image ${image}\n`);
+    const stream = await docker.pull(image);
+    await new Promise((resolve, reject) => {
+        docker.modem.followProgress(stream, err => {
+            if (err) {
+                reject(err instanceof Error ? err : new Error(String(err)));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+async function getContainer(docker, name) {
+    const containers = await docker.listContainers({
+        all: true,
+        filters: { name: [name] },
+    });
+    // Docker's name filter does substring matching, so we need an exact match.
+    // Container names are stored with a leading slash (e.g. "/my-container").
+    const exact = containers.find(c => c.Names.some(n => n === `/${name}` || n === name));
+    if (!exact)
+        return undefined;
+    node_assert_1.strict.ok(exact.Id);
+    return docker.getContainer(exact.Id);
+}
+async function ensureContainerRunning(docker, config) {
+    const host = config.host ?? DEFAULTS.host;
+    const { name, image, ports, env, entrypoint, command, volumes, extraHosts, healthcheck, restartPolicy, labels, } = config;
+    const existing = await getContainer(docker, name);
+    if (existing) {
+        const inspect = await existing.inspect();
+        if (!inspect.State.Running) {
+            process.stdout.write(`[testenv] starting existing container ${name}\n`);
+            await existing.start();
+        }
+        else {
+            process.stdout.write(`[testenv] container ${name} already running\n`);
+        }
+        return existing;
+    }
+    const exposedPorts = {};
+    const portBindings = {};
+    for (const { host: hostPort, container: containerPort } of ports) {
+        const key = `${containerPort}/tcp`;
+        exposedPorts[key] = {};
+        portBindings[key] = [{ HostPort: String(hostPort), HostIp: host }];
+    }
+    const binds = volumes?.map(v => {
+        // Resolve relative paths from the project root
+        if (!v.startsWith('/')) {
+            const [hostPath, ...rest] = v.split(':');
+            const resolved = `${process.cwd()}/${hostPath}`;
+            return [resolved, ...rest].join(':');
+        }
+        return v;
+    });
+    process.stdout.write(`[testenv] creating container ${name}\n`);
+    const container = await docker.createContainer({
+        name,
+        Image: image,
+        Env: env,
+        ...(entrypoint && { Entrypoint: entrypoint }),
+        ...(command && { Cmd: command }),
+        ExposedPorts: exposedPorts,
+        HostConfig: {
+            PortBindings: portBindings,
+            AutoRemove: false,
+            ...(binds && { Binds: binds }),
+            ...(extraHosts && { ExtraHosts: extraHosts }),
+            RestartPolicy: { Name: restartPolicy ?? 'no' },
+        },
+        Labels: labels,
+        ...(healthcheck && {
+            Healthcheck: {
+                Test: ['CMD-SHELL', healthcheck],
+                Interval: 2_000_000_000,
+                Timeout: 2_000_000_000,
+                Retries: 30,
+                StartPeriod: 2_000_000_000,
+            },
+        }),
+    });
+    await container.start();
+    return container;
+}
+async function waitForPort(host, port, timeoutMs) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < timeoutMs) {
+        const ok = await new Promise(resolve => {
+            const socket = net.createConnection(port, host);
+            socket.setTimeout(1_000);
+            socket.on('connect', () => {
+                socket.end();
+                resolve(true);
+            });
+            socket.on('timeout', () => {
+                socket.destroy();
+                resolve(false);
+            });
+            socket.on('error', () => resolve(false));
+        });
+        if (ok)
+            return;
+        await sleep(500);
+    }
+    throw new Error(`timed out waiting for ${host}:${port}`);
+}
+async function dockerTestUp(args) {
+    const { config } = args;
+    const host = config.host ?? DEFAULTS.host;
+    const timeoutMs = config.timeoutMs ?? DEFAULTS.timeoutMs;
+    const docker = createDockerClient();
+    await pullImageIfMissing(docker, config.image);
+    await ensureContainerRunning(docker, config);
+    if (config.waitForReady !== false && config.ports.length > 0) {
+        const port = config.waitPort ?? config.ports[0].host;
+        await waitForPort(host, port, timeoutMs);
+        process.stdout.write(`[testenv] ${config.name} ready on ${host}:${port}\n`);
+    }
+    else {
+        process.stdout.write(`[testenv] ${config.name} started (no readiness check)\n`);
+    }
+}
+async function dockerTestDown(args) {
+    const { config } = args;
+    const docker = createDockerClient();
+    const container = await getContainer(docker, config.name);
+    if (!container) {
+        process.stdout.write(`[testenv] container ${config.name} is already absent\n`);
+        return;
+    }
+    const inspect = await container.inspect();
+    if (inspect.State.Running) {
+        process.stdout.write(`[testenv] stopping ${config.name}\n`);
+        await container.stop({ t: 0 });
+    }
+    process.stdout.write(`[testenv] removing ${config.name}\n`);
+    await container.remove({ force: true, v: true });
+}
+async function dockerTestLogs(args) {
+    const { config, argv } = args;
+    const follow = argv.includes('-f') || argv.includes('--follow') || !argv.includes('--once');
+    const docker = createDockerClient();
+    const container = await getContainer(docker, config.name);
+    if (!container) {
+        throw new Error(`container ${config.name} not found`);
+    }
+    if (follow) {
+        const logStream = await container.logs({
+            stdout: true,
+            stderr: true,
+            follow: true,
+            timestamps: true,
+            tail: 200,
+        });
+        container.modem.demuxStream(logStream, process.stdout, process.stderr);
+        await streamToPromise(logStream);
+        return;
+    }
+    const output = await container.logs({
+        stdout: true,
+        stderr: true,
+        follow: false,
+        timestamps: true,
+        tail: 200,
+    });
+    process.stdout.write(output.toString('utf8'));
+}
+//# sourceMappingURL=docker-container.js.map

package/dist/docker-container.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { type DockerTestContainerConfig, type DockerTestPortMapping, dockerTestDown, dockerTestLogs, dockerTestUp, } from './docker-container';

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerTestUp = exports.dockerTestLogs = exports.dockerTestDown = void 0;
+var docker_container_1 = require("./docker-container");
+Object.defineProperty(exports, "dockerTestDown", { enumerable: true, get: function () { return docker_container_1.dockerTestDown; } });
+Object.defineProperty(exports, "dockerTestLogs", { enumerable: true, get: function () { return docker_container_1.dockerTestLogs; } });
+Object.defineProperty(exports, "dockerTestUp", { enumerable: true, get: function () { return docker_container_1.dockerTestUp; } });
+//# 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,uDAM4B;AAH1B,kHAAA,cAAc,OAAA;AACd,kHAAA,cAAc,OAAA;AACd,gHAAA,YAAY,OAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@stacks/api-test-toolkit",
+  "version": "1.12.2",
+  "description": "Test utilities for @stacks/api-toolkit",
+  "main": "./dist/index.js",
+  "typings": "./dist/index.d.ts",
+  "scripts": {
+    "build": "rimraf dist && tsc --project tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stx-labs/api-toolkit.git",
+    "directory": "packages/api-test-toolkit"
+  },
+  "keywords": [
+    "api",
+    "testing"
+  ],
+  "files": [
+    "dist"
+  ],
+  "author": "Stacks Labs",
+  "license": "Apache 2.0",
+  "bugs": {
+    "url": "https://github.com/stx-labs/api-toolkit/issues"
+  },
+  "homepage": "https://github.com/stx-labs/api-toolkit#readme",
+  "engines": {
+    "node": ">=22"
+  },
+  "peerDependencies": {
+    "@stacks/api-toolkit": "^1.12.2"
+  },
+  "devDependencies": {
+    "@types/dockerode": "^4.0.1",
+    "@types/node": "^24.12.2"
+  },
+  "dependencies": {
+    "dockerode": "^4.0.10"
+  }
+}