@zukhruf/testing 0.0.0-stage → 0.3.2

package/dist/databases/postgres.d.ts

@@ -0,0 +1,15 @@
+import type { Database, DatabaseOptions } from './database.ts';
+export type { Database, DatabaseOptions } from './database.ts';
+export interface PostgresOptions extends DatabaseOptions {
+    user?: string;
+}
+/** PostgreSQL test configuration. Each acquisition returns an independent handle. */
+export declare class Postgres {
+    #private;
+    constructor({ docker, image, password, database, user, labels, }: PostgresOptions);
+    /** Create an isolated database on the persistent shared server. */
+    database(): Promise<Database>;
+    /** Start a dedicated server; the returned handle owns its container. */
+    start(): Promise<Database>;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/databases/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/databases/postgres.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/D,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qFAAqF;AACrF,qBAAa,QAAQ;;gBAIP,EACV,MAAM,EACN,KAA4B,EAC5B,QAAyB,EACzB,QAAmB,EACnB,IAAiB,EACjB,MAAM,GACP,EAAE,eAAe;IAKlB,mEAAmE;IAC7D,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAoBnC,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;CA+EjC"}

package/dist/databases/postgres.js

@@ -0,0 +1,96 @@
+import { randomUUID } from 'node:crypto';
+import { timebox } from "../async/timebox.js";
+/** PostgreSQL test configuration. Each acquisition returns an independent handle. */
+export class Postgres {
+    #docker;
+    #options;
+    constructor({ docker, image = 'postgres:18-alpine', password = 'testpassword', database = 'testdb', user = 'postgres', labels, }) {
+        this.#docker = docker;
+        this.#options = { image, password, database, user, labels };
+    }
+    /** Create an isolated database on the persistent shared server. */
+    async database() {
+        const container = await this.#acquire('postgres', 'reuse');
+        const database = `test_${randomUUID().replaceAll('-', '')}`;
+        try {
+            await this.#sql(container, `CREATE DATABASE ${database}`);
+        }
+        catch (error) {
+            await container.disconnect();
+            throw error;
+        }
+        return this.#handle(container, database, async () => {
+            await this.#sql(container, `DROP DATABASE IF EXISTS ${database} WITH (FORCE)`).catch(() => {
+                /* Best-effort cleanup after external removal. */
+            });
+            await container.disconnect();
+        });
+    }
+    /** Start a dedicated server; the returned handle owns its container. */
+    async start() {
+        const { database } = this.#options;
+        const container = await this.#acquire(database, 'serve');
+        return this.#handle(container, database, () => container.cleanup());
+    }
+    #sql(container, sql) {
+        return container.exec([
+            'psql',
+            '-U',
+            this.#options.user,
+            '-d',
+            'postgres',
+            '-c',
+            sql,
+        ]);
+    }
+    #acquire(database, mode) {
+        const { image, password, user, labels } = this.#options;
+        return this.#docker[mode]({
+            image,
+            labels,
+            internalPort: 5432,
+            env: {
+                POSTGRES_PASSWORD: password,
+                POSTGRES_DB: database,
+                POSTGRES_USER: user,
+            },
+            tmpfs: ['/var/lib/postgresql:rw,size=512m'],
+            memorySwappiness: 0,
+            healthy: (container) => this.#ready(container, database),
+        });
+    }
+    #ready(container, database) {
+        const { user } = this.#options;
+        // TCP excludes PostgreSQL's temporary, socket-only initialization server.
+        return timebox(async () => {
+            await container.exec(['pg_isready', '-h', '127.0.0.1', '-U', user]);
+            await container.exec([
+                'psql',
+                '-h',
+                '127.0.0.1',
+                '-U',
+                user,
+                '-d',
+                database,
+                '-c',
+                'SELECT 1',
+            ]);
+        }, { maxRetryTime: 60_000 });
+    }
+    #handle(container, database, cleanup) {
+        const { image, user, password } = this.#options;
+        return {
+            connectionString: `postgresql://${user}:${password}@${container.host}:${container.port}/${database}`,
+            image,
+            user,
+            password,
+            database,
+            containerId: container.containerId,
+            host: container.host,
+            port: container.port,
+            cleanup,
+            [Symbol.asyncDispose]: cleanup,
+        };
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/databases/postgres.js.map

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

package/dist/databases/sqlite.d.ts

@@ -0,0 +1,14 @@
+import { DatabaseSync } from 'node:sqlite';
+export interface SqliteDatabase extends AsyncDisposable {
+    path: string;
+    connection: DatabaseSync;
+    /** Close the connection before removing its temporary directory. */
+    cleanup: () => Promise<void>;
+}
+/** Each acquisition owns an independent, temporary SQLite database. */
+export declare class Sqlite {
+    /** Holds a write lock in another process, which releases even while the caller blocks. */
+    writeLock(path: string, durationMs: number): Promise<AsyncDisposable>;
+    database(): Promise<SqliteDatabase>;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/databases/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/databases/sqlite.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,YAAY,CAAC;IACzB,oEAAoE;IACpE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,uEAAuE;AACvE,qBAAa,MAAM;IACjB,0FAA0F;IACpF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAoDrE,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;CAY1C"}

package/dist/databases/sqlite.js

@@ -0,0 +1,66 @@
+import { once } from 'node:events';
+import { mkdtempDisposable } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import spawn, { SubprocessError } from 'nano-spawn';
+/** Each acquisition owns an independent, temporary SQLite database. */
+export class Sqlite {
+    /** Holds a write lock in another process, which releases even while the caller blocks. */
+    async writeLock(path, durationMs) {
+        const holder = spawn(process.execPath, [
+            '--input-type=module',
+            '--eval',
+            `
+          import { DatabaseSync } from 'node:sqlite';
+          import { setTimeout } from 'node:timers/promises';
+
+          process.once('disconnect', () => process.exit(0));
+          using database = new DatabaseSync(process.argv[1]);
+          database.exec('BEGIN IMMEDIATE');
+          process.send('locked');
+          await setTimeout(Number(process.argv[2]));
+          database.exec('ROLLBACK');
+          process.disconnect();
+        `,
+            path,
+            String(durationMs),
+        ], { stdio: ['ignore', 'ignore', 'pipe', 'ipc'] });
+        const exited = holder.then(() => {
+            throw new Error('SQLite lock holder exited before acquiring the lock.');
+        });
+        const child = await Promise.race([holder.nodeChildProcess, exited]);
+        try {
+            await Promise.race([once(child, 'message'), exited]);
+        }
+        catch (error) {
+            child.kill();
+            await Promise.allSettled([holder]);
+            throw error;
+        }
+        const resources = new AsyncDisposableStack();
+        resources.defer(async () => {
+            const killed = child.kill();
+            try {
+                await holder;
+            }
+            catch (error) {
+                if (!killed ||
+                    !(error instanceof SubprocessError) ||
+                    error.signalName !== 'SIGTERM')
+                    throw error;
+            }
+        });
+        return resources;
+    }
+    async database() {
+        await using resources = new AsyncDisposableStack();
+        const directory = resources.use(await mkdtempDisposable(join(tmpdir(), 'zukhruf-testing-sqlite-')));
+        const path = join(directory.path, 'test.sqlite');
+        const connection = resources.use(new DatabaseSync(path));
+        const owned = resources.move();
+        const cleanup = () => owned.disposeAsync();
+        return { path, connection, cleanup, [Symbol.asyncDispose]: cleanup };
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/databases/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/databases/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AASpD,uEAAuE;AACvE,MAAM,OAAO,MAAM;IACjB,0FAA0F;IAC1F,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,UAAkB;QAC9C,MAAM,MAAM,GAAG,KAAK,CAClB,OAAO,CAAC,QAAQ,EAChB;YACE,qBAAqB;YACrB,QAAQ;YACR;;;;;;;;;;;SAWC;YACD,IAAI;YACJ,MAAM,CAAC,UAAU,CAAC;SACnB,EACD,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAC/C,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YAC9B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACnC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IACE,CAAC,MAAM;oBACP,CAAC,CAAC,KAAK,YAAY,eAAe,CAAC;oBACnC,KAAK,CAAC,UAAU,KAAK,SAAS;oBAE9B,MAAM,KAAK,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,YAAY,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAC7B,MAAM,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,yBAAyB,CAAC,CAAC,CACnE,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAE3C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACvE,CAAC;CACF"}

package/dist/databases/sqlserver.d.ts

@@ -0,0 +1,14 @@
+import type { Database, DatabaseOptions } from './database.ts';
+export type { Database, DatabaseOptions } from './database.ts';
+export declare const SQL_SERVER_FULL_IMAGE = "mcr.microsoft.com/mssql/server:2022-latest";
+export declare const SQL_SERVER_EDGE_IMAGE = "mcr.microsoft.com/azure-sql-edge:latest";
+/** SQL Server test configuration. Without an image, the engine's architecture picks one. */
+export declare class SqlServer {
+    #private;
+    constructor({ docker, image, password, database, labels, }: DatabaseOptions);
+    /** Create an isolated database on the persistent shared server. */
+    database(): Promise<Database>;
+    /** Start a dedicated server; the returned handle owns its container. */
+    start(): Promise<Database>;
+}
+//# sourceMappingURL=sqlserver.d.ts.map

package/dist/databases/sqlserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlserver.d.ts","sourceRoot":"","sources":["../../src/databases/sqlserver.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/D,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/D,eAAO,MAAM,qBAAqB,+CACY,CAAC;AAC/C,eAAO,MAAM,qBAAqB,4CAA4C,CAAC;AAE/E,4FAA4F;AAC5F,qBAAa,SAAS;;gBAaR,EACV,MAAM,EACN,KAAK,EACL,QAA+B,EAC/B,QAAmB,EACnB,MAAM,GACP,EAAE,eAAe;IAKlB,mEAAmE;IAC7D,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAmBnC,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;CA+GjC"}

package/dist/databases/sqlserver.js

@@ -0,0 +1,134 @@
+import { randomUUID } from 'node:crypto';
+import sql from 'mssql';
+import pMemoize from 'p-memoize';
+import { timebox } from "../async/timebox.js";
+export const SQL_SERVER_FULL_IMAGE = 'mcr.microsoft.com/mssql/server:2022-latest';
+export const SQL_SERVER_EDGE_IMAGE = 'mcr.microsoft.com/azure-sql-edge:latest';
+/** SQL Server test configuration. Without an image, the engine's architecture picks one. */
+export class SqlServer {
+    #docker;
+    #options;
+    #image = pMemoize(async () => {
+        if (this.#options.image)
+            return this.#options.image;
+        if (!(await this.#docker.isAvailable()))
+            throw new Error('Docker is required for container-backed tests');
+        const { architecture } = await this.#docker.info();
+        return ['arm64', 'aarch64'].includes(architecture)
+            ? SQL_SERVER_EDGE_IMAGE
+            : SQL_SERVER_FULL_IMAGE;
+    });
+    constructor({ docker, image, password = 'StrongP@ssw0rd123!', database = 'testdb', labels, }) {
+        this.#docker = docker;
+        this.#options = { image, password, database, labels };
+    }
+    /** Create an isolated database on the persistent shared server. */
+    async database() {
+        const image = await this.#image();
+        const container = await this.#acquire(image, 'reuse');
+        const database = `test_${randomUUID().replaceAll('-', '')}`;
+        try {
+            await this.#createDatabase(container, database);
+            return this.#handle(container, image, database, async () => {
+                try {
+                    await this.#dropDatabase(container, database);
+                }
+                finally {
+                    await container.disconnect();
+                }
+            });
+        }
+        catch (error) {
+            await container.disconnect();
+            throw error;
+        }
+    }
+    /** Start a dedicated server; the returned handle owns its container. */
+    async start() {
+        const image = await this.#image();
+        const container = await this.#acquire(image, 'serve');
+        const { database } = this.#options;
+        try {
+            await this.#createDatabase(container, database);
+            return this.#handle(container, image, database, () => container.cleanup());
+        }
+        catch (error) {
+            await container.cleanup();
+            throw error;
+        }
+    }
+    #connectionString(container, database) {
+        return `Server=${container.host},${container.port};Database=${database};User Id=sa;Password=${this.#options.password};TrustServerCertificate=true;Encrypt=false;`;
+    }
+    async #ping(container) {
+        const pool = new sql.ConnectionPool(`${this.#connectionString(container, 'master')}connectionTimeout=1000;requestTimeout=1000;`);
+        try {
+            await pool.connect();
+            await pool.request().query('SELECT 1');
+        }
+        finally {
+            await pool.close().catch(() => { });
+        }
+    }
+    async #createDatabase(container, database) {
+        const pool = new sql.ConnectionPool(this.#connectionString(container, 'master'));
+        await pool.connect();
+        try {
+            await pool
+                .request()
+                .query(`IF NOT EXISTS (SELECT * FROM sys.databases WHERE name = '${database}') CREATE DATABASE [${database}]`);
+        }
+        finally {
+            await pool.close();
+        }
+    }
+    async #dropDatabase(container, database) {
+        const pool = new sql.ConnectionPool(this.#connectionString(container, 'master'));
+        try {
+            await pool.connect();
+            await pool
+                .request()
+                .query(`IF DB_ID('${database}') IS NOT NULL BEGIN ALTER DATABASE [${database}] SET SINGLE_USER WITH ROLLBACK IMMEDIATE; DROP DATABASE [${database}]; END`);
+        }
+        catch {
+            // Best-effort cleanup; a leaked database lasts until container removal.
+        }
+        finally {
+            await pool.close().catch(() => { });
+        }
+    }
+    #acquire(image, mode) {
+        const { password, labels } = this.#options;
+        return this.#docker[mode]({
+            image,
+            labels,
+            env: {
+                ACCEPT_EULA: 'Y',
+                MSSQL_SA_PASSWORD: password,
+                MSSQL_MEMORY_LIMIT_MB: '2048',
+                ...(image.includes('azure-sql-edge') ? {} : { MSSQL_PID: 'Express' }),
+            },
+            internalPort: 1433,
+            tmpfs: ['/var/opt/mssql:rw,size=2g,mode=1777'],
+            memory: '3g',
+            memorySwappiness: 0,
+            healthy: (container) => timebox(() => this.#ping(container), { maxRetryTime: 180_000 }),
+        });
+    }
+    #handle(container, image, database, cleanup) {
+        const { password } = this.#options;
+        return {
+            connectionString: this.#connectionString(container, database),
+            image,
+            user: 'sa',
+            password,
+            database,
+            containerId: container.containerId,
+            host: container.host,
+            port: container.port,
+            cleanup,
+            [Symbol.asyncDispose]: cleanup,
+        };
+    }
+}
+//# sourceMappingURL=sqlserver.js.map

package/dist/databases/sqlserver.js.map

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

package/dist/docker/container.d.ts

@@ -0,0 +1,29 @@
+import { type Result } from 'nano-spawn';
+/** The Docker CLI, bound to the engine that a handle was created on. */
+export type DockerCommand = (args: string[]) => Promise<Result>;
+/** A container this process started. Disposal removes it with its anonymous volumes. */
+export declare class Container implements AsyncDisposable {
+    readonly containerId: string;
+    readonly command: DockerCommand;
+    constructor(containerId: string, command: DockerCommand);
+    readonly exec: (command: string[]) => Promise<Result>;
+    /** What the container printed so far, standard output and error interleaved. */
+    logs(): Promise<string>;
+    /** Sends `signal` to the container's main process, as `docker kill` does. */
+    kill(signal?: string): Promise<void>;
+    cleanup(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * A container whose port answers on 127.0.0.1 of this machine, through an SSH
+ * forward when the engine is remote. Disposal also closes the forward.
+ */
+export declare class ServiceContainer extends Container {
+    readonly host = "127.0.0.1";
+    readonly port: number;
+    /** Closes the forward and leaves the container running for its other users. */
+    readonly disconnect: () => Promise<void>;
+    constructor(containerId: string, port: number, command: DockerCommand, disconnect: () => Promise<void>);
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/docker/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,YAAY,CAAC;AAE1D,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhE,wFAAwF;AACxF,qBAAa,SAAU,YAAW,eAAe;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;IAMvD,QAAQ,CAAC,IAAI,GAAI,SAAS,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,CAAC,CACG;IAEvD,gFAAgF;IAC1E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,6EAA6E;IACvE,IAAI,CAAC,MAAM,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBAGvC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAOlB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAOxC"}

package/dist/docker/container.js

@@ -0,0 +1,55 @@
+import { SubprocessError } from 'nano-spawn';
+/** A container this process started. Disposal removes it with its anonymous volumes. */
+export class Container {
+    containerId;
+    command;
+    constructor(containerId, command) {
+        this.containerId = containerId;
+        this.command = command;
+    }
+    // Bound: readiness probes receive it destructured.
+    exec = (command) => this.command(['exec', this.containerId, ...command]);
+    /** What the container printed so far, standard output and error interleaved. */
+    async logs() {
+        const { output } = await this.command(['logs', this.containerId]);
+        return output;
+    }
+    /** Sends `signal` to the container's main process, as `docker kill` does. */
+    async kill(signal = 'SIGKILL') {
+        await this.command(['kill', '--signal', signal, this.containerId]);
+    }
+    async cleanup() {
+        await this.command(['rm', '--force', '--volumes', this.containerId]).catch((error) => {
+            if (!(error instanceof SubprocessError) ||
+                !/No such container/i.test(error.stderr))
+                throw error;
+        });
+    }
+    [Symbol.asyncDispose]() {
+        return this.cleanup();
+    }
+}
+/**
+ * A container whose port answers on 127.0.0.1 of this machine, through an SSH
+ * forward when the engine is remote. Disposal also closes the forward.
+ */
+export class ServiceContainer extends Container {
+    host = '127.0.0.1';
+    port;
+    /** Closes the forward and leaves the container running for its other users. */
+    disconnect;
+    constructor(containerId, port, command, disconnect) {
+        super(containerId, command);
+        this.port = port;
+        this.disconnect = disconnect;
+    }
+    async cleanup() {
+        try {
+            await super.cleanup();
+        }
+        finally {
+            await this.disconnect();
+        }
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/docker/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/docker/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,eAAe,EAAE,MAAM,YAAY,CAAC;AAK1D,wFAAwF;AACxF,MAAM,OAAO,SAAS;IACX,WAAW,CAAS;IACpB,OAAO,CAAgB;IAEhC,YAAY,WAAmB,EAAE,OAAsB;QACrD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,mDAAmD;IAC1C,IAAI,GAAG,CAAC,OAAiB,EAAmB,EAAE,CACrD,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAEvD,gFAAgF;IAChF,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS;QAC3B,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CACxE,CAAC,KAAc,EAAE,EAAE;YACjB,IACE,CAAC,CAAC,KAAK,YAAY,eAAe,CAAC;gBACnC,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;gBAExC,MAAM,KAAK,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC;IAED,CAAC,MAAM,CAAC,YAAY,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IACpC,IAAI,GAAG,WAAW,CAAC;IACnB,IAAI,CAAS;IACtB,+EAA+E;IACtE,UAAU,CAAsB;IAEzC,YACE,WAAmB,EACnB,IAAY,EACZ,OAAsB,EACtB,UAA+B;QAE/B,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAEQ,KAAK,CAAC,OAAO;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/dist/docker/directory.d.ts

@@ -0,0 +1,18 @@
+import { DockerHost } from './host.ts';
+import { type TestRun } from './test-run.ts';
+/** A disposable fixture directory on the selected daemon's host filesystem. */
+export declare class DockerDirectory implements AsyncDisposable {
+    #private;
+    readonly path: string;
+    readonly host: DockerHost;
+    private constructor();
+    static create(host: DockerHost, run: TestRun | undefined): Promise<DockerDirectory>;
+    private resolve;
+    mkdir(name: string): Promise<void>;
+    writeFile(name: string, content: string, mode?: number): Promise<void>;
+    readFile(name: string): Promise<string>;
+    chmod(name: string, mode: number): Promise<void>;
+    symlink(target: string, name: string): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=directory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/docker/directory.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,UAAU,EAAS,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,KAAK,OAAO,EAAmB,MAAM,eAAe,CAAC;AAE9D,+EAA+E;AAC/E,qBAAa,eAAgB,YAAW,eAAe;;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAG1B,OAAO;WAUM,MAAM,CACjB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,OAAO,GAAG,SAAS,GACvB,OAAO,CAAC,eAAe,CAAC;IAS3B,OAAO,CAAC,OAAO;IAMT,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWvC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7C"}

package/dist/docker/directory.js

@@ -0,0 +1,77 @@
+import { randomUUID } from 'node:crypto';
+import { chmod, mkdir, readFile, rm, symlink, writeFile, } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, posix } from 'node:path';
+import { DockerHost, quote } from "./host.js";
+import { directoryPrefix } from "./test-run.js";
+/** A disposable fixture directory on the selected daemon's host filesystem. */
+export class DockerDirectory {
+    path;
+    host;
+    #record;
+    constructor(path, host, record) {
+        this.path = path;
+        this.host = host;
+        this.#record = record;
+    }
+    static async create(host, run) {
+        const name = `${directoryPrefix(run)}${randomUUID()}`;
+        const path = host.remote ? `/tmp/${name}` : join(tmpdir(), name);
+        const record = await run?.record('directory', path);
+        if (host.remote)
+            await host.shell(`mkdir -m 700 -- ${quote(path)}`);
+        else
+            await mkdir(path, { mode: 0o700 });
+        return new DockerDirectory(path, host, record);
+    }
+    resolve(name) {
+        if (posix.isAbsolute(name) || name.split('/').includes('..'))
+            throw new Error('Fixture paths must stay inside their directory');
+        return posix.join(this.path, name);
+    }
+    async mkdir(name) {
+        const path = this.resolve(name);
+        if (this.host.remote)
+            await this.host.shell(`mkdir -p -- ${quote(path)}`);
+        else
+            await mkdir(path, { recursive: true });
+    }
+    async writeFile(name, content, mode = 0o644) {
+        const path = this.resolve(name);
+        if (this.host.remote)
+            await this.host.shell(`cat > ${quote(path)} && chmod ${mode.toString(8)} -- ${quote(path)}`, content);
+        else {
+            await writeFile(path, content);
+            await chmod(path, mode);
+        }
+    }
+    async readFile(name) {
+        const path = this.resolve(name);
+        // base64 prevents nano-spawn from stripping the fixture's trailing newline.
+        if (this.host.remote)
+            return Buffer.from((await this.host.shell(`base64 < ${quote(path)}`)).stdout, 'base64').toString('utf8');
+        return readFile(path, 'utf8');
+    }
+    async chmod(name, mode) {
+        const path = this.resolve(name);
+        if (this.host.remote)
+            await this.host.shell(`chmod ${mode.toString(8)} -- ${quote(path)}`);
+        else
+            await chmod(path, mode);
+    }
+    async symlink(target, name) {
+        const path = this.resolve(name);
+        if (this.host.remote)
+            await this.host.shell(`ln -s -- ${quote(target)} ${quote(path)}`);
+        else
+            await symlink(target, path);
+    }
+    async [Symbol.asyncDispose]() {
+        if (this.host.remote)
+            await this.host.shell(`rm -rf -- ${quote(this.path)}`);
+        else
+            await rm(this.path, { recursive: true, force: true });
+        await this.#record?.[Symbol.asyncDispose]();
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/docker/directory.js.map

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