@zukhruf/testing 0.0.0-stage → 0.3.2

package/dist/docker/test-run.d.ts

@@ -0,0 +1,32 @@
+/** Set by the supervisor for the test processes it starts: the run's id. */
+export declare const TEST_RUN_ID = "ZUKHRUF_TESTING_RUN_ID";
+/** Set by the supervisor for the test processes it starts: the run's records. */
+export declare const TEST_RUN_DIRECTORY = "ZUKHRUF_TESTING_RUN_DIR";
+/** The label that ties a container or volume to the run that created it. */
+export declare const TEST_RUN_LABEL = "dev.zukhruf.testing.run";
+/**
+ * One supervised `node --test` invocation. What its test processes create
+ * carries the run's label or a record in the run's directory, so the
+ * supervisor removes it after a process that was killed before it could.
+ */
+export declare class TestRun {
+    readonly id: string;
+    readonly directory: string;
+    constructor(id: string, directory: string);
+    /**
+     * The run the supervisor started this process in, read from the environment
+     * the host passes (`process.env`). Undefined outside a supervisor.
+     */
+    static fromEnvironment(environment: Readonly<Record<string, string | undefined>>): TestRun | undefined;
+    get labels(): Record<string, string>;
+    /**
+     * Records a path that the supervisor removes if this process dies first.
+     * Disposing the record forgets the path once the process removed it itself.
+     */
+    record(kind: 'forward' | 'directory', path: string): Promise<AsyncDisposable>;
+}
+/** The name prefix of a host directory that a run's test process created. */
+export declare const directoryPrefix: (run: TestRun | undefined) => string;
+/** The path prefix of the private directory behind an SSH port forward. */
+export declare const forwardPrefix: (run: TestRun | undefined) => string;
+//# sourceMappingURL=test-run.d.ts.map

package/dist/docker/test-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-run.d.ts","sourceRoot":"","sources":["../../src/docker/test-run.ts"],"names":[],"mappings":"AAIA,4EAA4E;AAC5E,eAAO,MAAM,WAAW,2BAA2B,CAAC;AACpD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,4EAA4E;AAC5E,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAExD;;;;GAIG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAKzC;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GACxD,OAAO,GAAG,SAAS;IAWtB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnC;IAED;;;OAGG;IACG,MAAM,CACV,IAAI,EAAE,SAAS,GAAG,WAAW,EAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC;CAK5B;AAED,6EAA6E;AAC7E,eAAO,MAAM,eAAe,GAAI,KAAK,OAAO,GAAG,SAAS,KAAG,MACZ,CAAC;AAEhD,2EAA2E;AAC3E,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,GAAG,SAAS,KAAG,MACG,CAAC"}

package/dist/docker/test-run.js

@@ -0,0 +1,52 @@
+import { randomUUID } from 'node:crypto';
+import { rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Set by the supervisor for the test processes it starts: the run's id. */
+export const TEST_RUN_ID = 'ZUKHRUF_TESTING_RUN_ID';
+/** Set by the supervisor for the test processes it starts: the run's records. */
+export const TEST_RUN_DIRECTORY = 'ZUKHRUF_TESTING_RUN_DIR';
+/** The label that ties a container or volume to the run that created it. */
+export const TEST_RUN_LABEL = 'dev.zukhruf.testing.run';
+/**
+ * One supervised `node --test` invocation. What its test processes create
+ * carries the run's label or a record in the run's directory, so the
+ * supervisor removes it after a process that was killed before it could.
+ */
+export class TestRun {
+    id;
+    directory;
+    constructor(id, directory) {
+        this.id = id;
+        this.directory = directory;
+    }
+    /**
+     * The run the supervisor started this process in, read from the environment
+     * the host passes (`process.env`). Undefined outside a supervisor.
+     */
+    static fromEnvironment(environment) {
+        const id = environment[TEST_RUN_ID];
+        const directory = environment[TEST_RUN_DIRECTORY];
+        if (id === undefined && directory === undefined)
+            return undefined;
+        if (!id || !directory)
+            throw new Error(`The supervisor sets ${TEST_RUN_ID} and ${TEST_RUN_DIRECTORY} together, but only one of them is set`);
+        return new TestRun(id, directory);
+    }
+    get labels() {
+        return { [TEST_RUN_LABEL]: this.id };
+    }
+    /**
+     * Records a path that the supervisor removes if this process dies first.
+     * Disposing the record forgets the path once the process removed it itself.
+     */
+    async record(kind, path) {
+        const file = join(this.directory, `${kind}-${randomUUID()}.json`);
+        await writeFile(file, JSON.stringify({ path }));
+        return { [Symbol.asyncDispose]: () => rm(file, { force: true }) };
+    }
+}
+/** The name prefix of a host directory that a run's test process created. */
+export const directoryPrefix = (run) => `zukhruf-testing-${run?.id ?? 'standalone'}-`;
+/** The path prefix of the private directory behind an SSH port forward. */
+export const forwardPrefix = (run) => `/tmp/zukhruf-testing-forward-${run?.id ?? 'standalone'}-`;
+//# sourceMappingURL=test-run.js.map

package/dist/docker/test-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-run.js","sourceRoot":"","sources":["../../src/docker/test-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,wBAAwB,CAAC;AACpD,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAC5D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAExD;;;;GAIG;AACH,MAAM,OAAO,OAAO;IACT,EAAE,CAAS;IACX,SAAS,CAAS;IAE3B,YAAY,EAAU,EAAE,SAAiB;QACvC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,WAAyD;QAEzD,MAAM,EAAE,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,WAAW,CAAC,kBAAkB,CAAC,CAAC;QAClD,IAAI,EAAE,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAClE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS;YACnB,MAAM,IAAI,KAAK,CACb,uBAAuB,WAAW,QAAQ,kBAAkB,wCAAwC,CACrG,CAAC;QACJ,OAAO,IAAI,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,IAA6B,EAC7B,IAAY;QAEZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,UAAU,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAwB,EAAU,EAAE,CAClE,mBAAmB,GAAG,EAAE,EAAE,IAAI,YAAY,GAAG,CAAC;AAEhD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAwB,EAAU,EAAE,CAChE,gCAAgC,GAAG,EAAE,EAAE,IAAI,YAAY,GAAG,CAAC"}

package/dist/docker/volume.d.ts

@@ -0,0 +1,9 @@
+import type { DockerCommand } from './container.ts';
+/** A named volume this process created. Disposal removes it. */
+export declare class DockerVolume implements AsyncDisposable {
+    #private;
+    readonly name: string;
+    constructor(name: string, command: DockerCommand);
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=volume.d.ts.map

package/dist/docker/volume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/docker/volume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,gEAAgE;AAChE,qBAAa,YAAa,YAAW,eAAe;;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;IAK1C,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/docker/volume.js

@@ -0,0 +1,13 @@
+/** A named volume this process created. Disposal removes it. */
+export class DockerVolume {
+    name;
+    #command;
+    constructor(name, command) {
+        this.name = name;
+        this.#command = command;
+    }
+    async [Symbol.asyncDispose]() {
+        await this.#command(['volume', 'rm', '--force', this.name]);
+    }
+}
+//# sourceMappingURL=volume.js.map

package/dist/docker/volume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volume.js","sourceRoot":"","sources":["../../src/docker/volume.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,OAAO,YAAY;IACd,IAAI,CAAS;IACb,QAAQ,CAAgB;IAEjC,YAAY,IAAY,EAAE,OAAsB;QAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACzB,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/http/http-server.d.ts

@@ -0,0 +1,12 @@
+import { type RequestListener, type Server } from 'node:http';
+export interface HttpServerHandle extends AsyncDisposable {
+    origin: string;
+    server: Server;
+    /** Stop accepting requests and close active HTTP connections. */
+    cleanup: () => Promise<void>;
+}
+/** Each acquisition owns a loopback HTTP server on an available port. */
+export declare class HttpServer {
+    start(handler: RequestListener): Promise<HttpServerHandle>;
+}
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/http/http-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,MAAM,EAAgB,MAAM,WAAW,CAAC;AAE5E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,yEAAyE;AACzE,qBAAa,UAAU;IACf,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAwBjE"}

package/dist/http/http-server.js

@@ -0,0 +1,29 @@
+import assert from 'node:assert/strict';
+import { once } from 'node:events';
+import { createServer } from 'node:http';
+/** Each acquisition owns a loopback HTTP server on an available port. */
+export class HttpServer {
+    async start(handler) {
+        await using resources = new AsyncDisposableStack();
+        const server = createServer(handler);
+        const listening = once(server, 'listening');
+        server.listen(0, '127.0.0.1');
+        await listening;
+        resources.defer(async () => {
+            const closed = server[Symbol.asyncDispose]();
+            server.closeAllConnections();
+            await closed;
+        });
+        const address = server.address();
+        assert(address && typeof address === 'object');
+        const owned = resources.move();
+        const cleanup = () => owned.disposeAsync();
+        return {
+            origin: `http://127.0.0.1:${address.port}`,
+            server,
+            cleanup,
+            [Symbol.asyncDispose]: cleanup,
+        };
+    }
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../../src/http/http-server.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAqC,YAAY,EAAE,MAAM,WAAW,CAAC;AAS5E,yEAAyE;AACzE,MAAM,OAAO,UAAU;IACrB,KAAK,CAAC,KAAK,CAAC,OAAwB;QAClC,YAAY,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC9B,MAAM,SAAS,CAAC;QAEhB,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC7B,MAAM,MAAM,CAAC;QACf,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAE3C,OAAO;YACL,MAAM,EAAE,oBAAoB,OAAO,CAAC,IAAI,EAAE;YAC1C,MAAM;YACN,OAAO;YACP,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO;SAC/B,CAAC;IACJ,CAAC;CACF"}

package/dist/scripts/run-docker-tests.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=run-docker-tests.d.ts.map

package/dist/scripts/run-docker-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-docker-tests.d.ts","sourceRoot":"","sources":["../../src/scripts/run-docker-tests.ts"],"names":[],"mappings":""}

package/dist/scripts/run-docker-tests.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+/**
+ * zukhruf-docker-tests: runs `node --test` with this command's arguments as one
+ * supervised run. Its test processes tie what they create to the run (see
+ * TestRun.fromEnvironment), and this process removes it after they exit. A
+ * run that was killed before it could is removed by the next run on the same
+ * engine, from any project of this user.
+ */
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, rm, writeFile, } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { SubprocessError } from 'nano-spawn';
+import { SHARED_SERVER_LABEL } from "../docker/docker.js";
+import { DockerHost, quote } from "../docker/host.js";
+import { TEST_RUN_DIRECTORY, TEST_RUN_ID, TEST_RUN_LABEL, TestRun, directoryPrefix, forwardPrefix, } from "../docker/test-run.js";
+if (process.platform === 'win32')
+    throw new Error('zukhruf-docker-tests stops a run as one process group, which Windows does not have');
+const root = join(process.env.XDG_STATE_HOME || join(homedir(), '.local', 'state'), 'zukhruf-testing', 'docker-runs');
+const codeOf = (error) => error instanceof Error && 'code' in error ? error.code : undefined;
+function alive(pid) {
+    if (!pid)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return codeOf(error) !== 'ESRCH';
+    }
+}
+/** Ignores Docker's answer that `missing` names something already gone. */
+const unlessMissing = (missing) => (error) => {
+    if (!(error instanceof SubprocessError) || !missing.test(error.stderr))
+        throw error;
+};
+async function readRecordedPath(file) {
+    const { path } = JSON.parse(await readFile(file, 'utf8'));
+    return path;
+}
+async function cleanup(host, run, directory, release) {
+    const owner = new TestRun(run.id, directory);
+    // Labels are attached atomically at creation. Never prune a daemon, remove
+    // shared servers, or trust names alone as proof of ownership.
+    const filter = ['--filter', `label=${TEST_RUN_LABEL}=${run.id}`];
+    const { stdout: containers } = await host.command(['ps', '-aq', ...filter]);
+    for (const id of containers.split('\n').filter(Boolean)) {
+        await host
+            .command([
+            'inspect',
+            '--format',
+            `{{index .Config.Labels "${SHARED_SERVER_LABEL}"}}`,
+            id,
+        ])
+            .then(async ({ stdout: shared }) => {
+            if (shared !== '1')
+                await host.command(['rm', '--force', '--volumes', id]);
+        })
+            .catch(unlessMissing(/No such (object|container)/i));
+    }
+    const { stdout: volumes } = await host.command([
+        'volume',
+        'ls',
+        '-q',
+        ...filter,
+    ]);
+    for (const name of volumes.split('\n').filter(Boolean)) {
+        await host
+            .command(['volume', 'rm', name])
+            .catch(unlessMissing(/no such volume|volume \S+ not found/i));
+    }
+    for (const file of await readdir(directory)) {
+        if (file.startsWith('forward-')) {
+            const path = await readRecordedPath(join(directory, file));
+            if (!path.startsWith(forwardPrefix(owner)) || path.slice(5).includes('/'))
+                throw new Error(`Invalid SSH forwarding cleanup record: ${path}`);
+            await rm(path, { recursive: true, force: true });
+        }
+        else if (file.startsWith('directory-')) {
+            const path = await readRecordedPath(join(directory, file));
+            if (!path.includes(`/${directoryPrefix(owner)}`) || path.includes('/../'))
+                throw new Error(`Invalid fixture cleanup record: ${path}`);
+            if (host.remote)
+                await host.shell(`rm -rf -- ${quote(path)}`);
+            else
+                await rm(path, { recursive: true, force: true });
+        }
+    }
+    if (release)
+        await rm(directory, { recursive: true, force: true });
+}
+async function readRun(directory) {
+    try {
+        return JSON.parse(await readFile(join(directory, 'run.json'), 'utf8'));
+    }
+    catch {
+        // Its supervisor may still be writing it, or another one just claimed it.
+        return undefined;
+    }
+}
+/** Removes what dead runs on this engine left behind. */
+async function recover(host) {
+    for (const name of await readdir(root)) {
+        // A claim names its supervisor: while it lives, the run is being recovered.
+        const claimant = /^recovering-(\d+)-/.exec(name)?.[1];
+        if (claimant !== undefined && alive(Number(claimant)))
+            continue;
+        const directory = join(root, name);
+        const previous = await readRun(directory);
+        if (!previous ||
+            previous.endpoint !== host.endpoint ||
+            alive(previous.pid) ||
+            alive(previous.childPid) ||
+            (previous.childPid !== undefined && alive(-previous.childPid)))
+            continue;
+        // Supervisors start in parallel; the rename lets exactly one recover a run.
+        const claimed = join(root, `recovering-${process.pid}-${randomUUID()}`);
+        try {
+            await rename(directory, claimed);
+        }
+        catch (error) {
+            if (codeOf(error) === 'ENOENT')
+                continue;
+            throw error;
+        }
+        try {
+            await cleanup(host, previous, claimed, true);
+        }
+        catch (error) {
+            throw new Error(`Could not recover Docker test resources. Retained ownership record: ${claimed}`, { cause: error });
+        }
+    }
+}
+await mkdir(root, { recursive: true });
+const host = await DockerHost.resolve();
+await recover(host);
+const run = {
+    id: randomUUID(),
+    endpoint: host.endpoint,
+    pid: process.pid,
+};
+const directory = join(root, run.id);
+await mkdir(directory);
+const record = async (current) => {
+    const pending = join(directory, 'run.pending.json');
+    await writeFile(pending, JSON.stringify(current));
+    await rename(pending, join(directory, 'run.json'));
+};
+await record(run);
+const args = process.argv.slice(2);
+const concurrency = host.remote && !args.some((arg) => arg.startsWith('--test-concurrency'))
+    ? ['--test-concurrency=1']
+    : [];
+const child = spawn(process.execPath, ['--test', ...concurrency, ...args], {
+    stdio: 'inherit',
+    detached: true,
+    env: {
+        ...process.env,
+        DOCKER_CONTEXT: undefined,
+        DOCKER_HOST: host.endpoint,
+        [TEST_RUN_ID]: run.id,
+        [TEST_RUN_DIRECTORY]: directory,
+    },
+});
+const exited = new Promise((resolve, reject) => {
+    child.once('error', reject);
+    child.once('exit', (code) => resolve(code ?? 1));
+});
+/** Signals the run's process group; false when the group could not be stopped. */
+async function kill(signal, attempt = 0) {
+    if (!child.pid)
+        return true;
+    try {
+        process.kill(-child.pid, signal);
+        return true;
+    }
+    catch (error) {
+        if (codeOf(error) === 'ESRCH')
+            return true;
+        // macOS can briefly report EPERM while an empty group is being reaped.
+        // Retry that transition; a persistent denial must retain ownership.
+        if (codeOf(error) === 'EPERM' && attempt < 3) {
+            await delay(25);
+            return kill(signal, attempt + 1);
+        }
+        console.error(`Could not signal Docker test process group ${child.pid}:`, error);
+        child.kill(signal);
+        return false;
+    }
+}
+const finished = new AbortController();
+const interruption = new AbortController();
+const interrupt = () => {
+    if (interruption.signal.aborted)
+        return;
+    interruption.abort();
+    void kill('SIGTERM');
+    void delay(5_000, undefined, { signal: finished.signal }).then(() => kill('SIGKILL'), () => { });
+};
+process.on('SIGINT', interrupt);
+process.on('SIGTERM', interrupt);
+try {
+    await record({ ...run, childPid: child.pid });
+    const code = await exited;
+    process.exitCode = interruption.signal.aborted ? 130 : code;
+}
+finally {
+    finished.abort();
+    // Includes SSH channels in workers killed by node --test or --test-force-exit.
+    const stopped = await kill('SIGKILL');
+    try {
+        await cleanup(host, run, directory, stopped);
+        if (!stopped) {
+            process.exitCode = 1;
+            console.error(`Docker test termination failed; retained ownership record for retry: ${directory}`);
+        }
+    }
+    catch (error) {
+        process.exitCode = 1;
+        console.error(`Docker test cleanup failed; retained ownership record for retry: ${directory}`, error);
+    }
+    process.off('SIGINT', interrupt);
+    process.off('SIGTERM', interrupt);
+}
+//# sourceMappingURL=run-docker-tests.js.map

package/dist/scripts/run-docker-tests.js.map

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

package/dist/streams/stream-harness.d.ts

@@ -0,0 +1,29 @@
+import type { ReadableStreamReadResult } from 'node:stream/web';
+export interface StreamSource<T> extends Disposable {
+    readonly stream: ReadableStream<T>;
+    /** Last producer signal or consumer cancellation; closed chunks may still drain. */
+    readonly state: 'open' | 'closed' | 'errored' | 'cancelled';
+    enqueue(chunk: T): void;
+    close(): void;
+    error(reason: unknown): void;
+}
+export type StreamResult<T> = {
+    status: 'completed';
+    chunks: T[];
+} | {
+    status: 'errored';
+    chunks: T[];
+    error: unknown;
+};
+export interface StreamReader<T> extends AsyncDisposable {
+    read(): Promise<ReadableStreamReadResult<T>>;
+    /** Collects the remaining chunks, preserving those read before a failure. */
+    collectUntilError(): Promise<StreamResult<T>>;
+}
+export declare class StreamHarness {
+    /** Creates an externally controlled producer. Disposal closes it if still open. */
+    source<T>(): StreamSource<T>;
+    /** Locks a stream without draining it. Disposal cancels and releases the lock. */
+    reader<T>(stream: ReadableStream<T>): StreamReader<T>;
+}
+//# sourceMappingURL=stream-harness.d.ts.map

package/dist/streams/stream-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-harness.d.ts","sourceRoot":"","sources":["../../src/streams/stream-harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,UAAU;IACjD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5D,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IACtB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,eAAe;IACtD,IAAI,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,6EAA6E;IAC7E,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C;AAED,qBAAa,aAAa;IACxB,mFAAmF;IACnF,MAAM,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC;IAmC5B,kFAAkF;IAClF,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAmCtD"}

package/dist/streams/stream-harness.js

@@ -0,0 +1,75 @@
+export class StreamHarness {
+    /** Creates an externally controlled producer. Disposal closes it if still open. */
+    source() {
+        let controller;
+        let state = 'open';
+        const stream = new ReadableStream({
+            start(value) {
+                controller = value;
+            },
+            cancel() {
+                state = 'cancelled';
+            },
+        });
+        return {
+            stream,
+            get state() {
+                return state;
+            },
+            enqueue(chunk) {
+                controller.enqueue(chunk);
+            },
+            close() {
+                controller.close();
+                state = 'closed';
+            },
+            error(reason) {
+                controller.error(reason);
+                // Native error() can also discard chunks queued before close().
+                if (controller.desiredSize === null)
+                    state = 'errored';
+            },
+            [Symbol.dispose]() {
+                if (state === 'open')
+                    this.close();
+            },
+        };
+    }
+    /** Locks a stream without draining it. Disposal cancels and releases the lock. */
+    reader(stream) {
+        const reader = stream.getReader();
+        const closed = reader.closed.then(() => true, () => false);
+        const cleanup = new AsyncDisposableStack();
+        cleanup.defer(() => reader.releaseLock());
+        cleanup.defer(async () => {
+            try {
+                await reader.cancel();
+            }
+            catch (error) {
+                // An already-errored stream rejects cancel(). Its error belongs to read();
+                // a failing cancellation hook closes the stream and must still surface.
+                if (await closed)
+                    throw error;
+            }
+        });
+        return {
+            read: () => reader.read(),
+            async collectUntilError() {
+                const chunks = [];
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            return { status: 'completed', chunks };
+                        chunks.push(value);
+                    }
+                }
+                catch (error) {
+                    return { status: 'errored', chunks, error };
+                }
+            },
+            [Symbol.asyncDispose]: () => cleanup.disposeAsync(),
+        };
+    }
+}
+//# sourceMappingURL=stream-harness.js.map

package/dist/streams/stream-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-harness.js","sourceRoot":"","sources":["../../src/streams/stream-harness.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,aAAa;IACxB,mFAAmF;IACnF,MAAM;QACJ,IAAI,UAA+C,CAAC;QACpD,IAAI,KAAK,GAA6B,MAAM,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,cAAc,CAAI;YACnC,KAAK,CAAC,KAAK;gBACT,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;YACD,MAAM;gBACJ,KAAK,GAAG,WAAW,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;QAEH,OAAO;YACL,MAAM;YACN,IAAI,KAAK;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,CAAC,KAAK;gBACX,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YACD,KAAK;gBACH,UAAU,CAAC,KAAK,EAAE,CAAC;gBACnB,KAAK,GAAG,QAAQ,CAAC;YACnB,CAAC;YACD,KAAK,CAAC,MAAM;gBACV,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACzB,gEAAgE;gBAChE,IAAI,UAAU,CAAC,WAAW,KAAK,IAAI;oBAAE,KAAK,GAAG,SAAS,CAAC;YACzD,CAAC;YACD,CAAC,MAAM,CAAC,OAAO,CAAC;gBACd,IAAI,KAAK,KAAK,MAAM;oBAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,kFAAkF;IAClF,MAAM,CAAI,MAAyB;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC/B,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC3C,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,2EAA2E;gBAC3E,wEAAwE;gBACxE,IAAI,MAAM,MAAM;oBAAE,MAAM,KAAK,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;YACzB,KAAK,CAAC,iBAAiB;gBACrB,MAAM,MAAM,GAAQ,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,OAAO,IAAI,EAAE,CAAC;wBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;wBAC5C,IAAI,IAAI;4BAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;wBACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;gBAC9C,CAAC;YACH,CAAC;YACD,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE;SACpD,CAAC;IACJ,CAAC;CACF"}