@zukhruf/testing 0.0.0-stage → 0.3.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ezzabuzaid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,144 @@
-# Temporary Holding Version
+# @zukhruf/testing
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Disposable fixtures for integration tests on Node.js: Docker containers and database servers, SQLite and DuckDB databases, BigQuery datasets, HTTP servers and controlled streams. Each acquisition returns a handle that `await using` cleans up, also when the test fails. A supervisor removes what a killed test run left behind.
+
+The words in these documents have one meaning each. See the glossary in [CONTEXT.md](./CONTEXT.md).
+
+## Areas
+
+Each area has its own import path, so a test loads only the drivers it uses. The three drivers are optional peer dependencies: install the one an area names.
+
+| Import                        | Gives                                                                                                        | Needs                    |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------ |
+| `@zukhruf/testing/async`      | `timebox`, `settleWithin`                                                                                    |                          |
+| `@zukhruf/testing/docker`     | `Docker`, `Container`, `ServiceContainer`, `DockerVolume`, `DockerDirectory`, `TestRun`, `skipWithoutDocker` | Docker CLI               |
+| `@zukhruf/testing/postgres`   | `Postgres`                                                                                                   | Docker CLI               |
+| `@zukhruf/testing/mysql`      | `Mysql`                                                                                                      | Docker CLI               |
+| `@zukhruf/testing/sqlserver`  | `SqlServer`, `SQL_SERVER_FULL_IMAGE`, `SQL_SERVER_EDGE_IMAGE`                                                | Docker CLI, `mssql`      |
+| `@zukhruf/testing/clickhouse` | `ClickHouse`                                                                                                 | Docker CLI               |
+| `@zukhruf/testing/sqlite`     | `Sqlite`                                                                                                     |                          |
+| `@zukhruf/testing/duckdb`     | `DuckDB`                                                                                                     | `@duckdb/node-api`       |
+| `@zukhruf/testing/bigquery`   | `BigQuery`                                                                                                   | `@google-cloud/bigquery` |
+| `@zukhruf/testing/http`       | `HttpServer`                                                                                                 |                          |
+| `@zukhruf/testing/streams`    | `StreamHarness`                                                                                              |                          |
+
+## Docker
+
+A `Docker` is the engine the Docker CLI selects. It resolves the engine once, on first use, and every handle it returns keeps that engine. It supports local Unix sockets, Docker Desktop's named pipe on Windows (`npipe://`), and SSH engines (`ssh://`). On Windows, volumes and containers are tested; `directory()` is not.
+
+```ts
+import { Docker, TestRun, skipWithoutDocker } from '@zukhruf/testing/docker';
+
+const docker = new Docker({ testRun: TestRun.fromEnvironment(process.env) });
+const skip = await skipWithoutDocker(docker, process.env);
+
+test('a holder in another container', { skip }, async () => {
+  await using volume = await docker.volume();
+  await using holder = await docker.start({
+    image: 'node:lts-alpine',
+    hostname: 'app',
+    mounts: [{ source: volume.name, target: '/locks' }],
+    command: ['node', '--eval', 'setInterval(() => {}, 1000)'],
+  });
+  await holder.kill();
+  const output = await docker.run({
+    image: 'node:lts-alpine',
+    mounts: [{ source: volume.name, target: '/locks', readOnly: true }],
+    command: ['ls', '/locks'],
+  });
+});
+```
+
+| Method           | Starts                                                                                                                                         | Returns            |
+| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
+| `start(options)` | A container this process owns. It stays after it stops, so its logs remain, until disposal removes it.                                         | `Container`        |
+| `serve(options)` | A dedicated server whose `internalPort` answers on `127.0.0.1` of this machine. Failure or disposal stops it, and a stopped server is removed. | `ServiceContainer` |
+| `reuse(options)` | One server per configuration on the engine, shared across processes and runs.                                                                  | `ServiceContainer` |
+| `run(options)`   | A container that runs to completion. Returns its standard output and removes it.                                                               | `string`           |
+| `volume()`       | A named volume.                                                                                                                                | `DockerVolume`     |
+| `directory()`    | A directory on the engine's host, for bind mounts. It has `mkdir`, `writeFile`, `readFile`, `chmod` and `symlink`.                             | `DockerDirectory`  |
+
+Options: `image`, `command`, `name`, `hostname`, `env`, `labels`, `mounts`, `tmpfs`, `ipcHost`, `memory` (default `1g`), `cpus` (default `1`), `memorySwappiness`. `serve` and `reuse` also take `internalPort` and `healthy`, a function that throws until the server is ready; it runs on every acquisition. Use `timebox` for polling inside it.
+
+A `Container` has `containerId`, `exec(command)`, `logs()`, `kill(signal)` and `cleanup()`. Disposal removes it with its anonymous volumes. A `ServiceContainer` also has `host` and `port`; on an SSH engine the port is a local forward that belongs to the acquiring process. `disconnect()` closes that forward and leaves the container running for its other users.
+
+### Shared servers
+
+`reuse(options)` finds the server for this configuration, or creates it. Docker reserves the name atomically, so concurrent processes attach to the same container. Different images, passwords, environments or labels select separate servers. A readiness failure leaves the shared server running for diagnosis. Dispose a reused server only after all its users finish: disposal stops it for every caller.
+
+Shared servers remain until you stop them:
+
+```sh
+docker ps -a --filter label=dev.zukhruf.testing.shared=1
+docker stop <container-id>
+```
+
+They run with `--rm`, so stopping also removes them. The image tag is part of the configuration: stop the server to pick up a newer image behind the same tag.
+
+### Skipping without Docker
+
+`skipWithoutDocker(docker, process.env)` returns the `skip` option of a test that needs Docker. `ZUKHRUF_TESTING_DOCKER` decides:
+
+| Value      | Result                                                                                |
+| ---------- | ------------------------------------------------------------------------------------- |
+| `required` | Runs. Throws when Docker does not answer, so a machine that must run the tests fails. |
+| `skip`     | Skips.                                                                                |
+| unset      | Runs when Docker answers, skips with a reason when it does not.                       |
+
+## The supervisor
+
+Disposal cleans up after a test that ends. A test process that is killed (a timeout, Ctrl-C, `--test-force-exit`) never disposes its handles, and a running container does not stop by itself. The `zukhruf-docker-tests` command runs `node --test` as one supervised run:
+
+```sh
+zukhruf-docker-tests --test-force-exit "src/**/*.test.ts"
+```
+
+It passes its arguments to `node --test`, and sets `ZUKHRUF_TESTING_RUN_ID` and `ZUKHRUF_TESTING_RUN_DIR` for the test processes. A `Docker` built with `TestRun.fromEnvironment(process.env)` labels what it creates with the run, and records SSH forwards and host directories in the run's directory. When the test processes exit, the supervisor stops their process group and removes the labeled containers with their anonymous volumes, the labeled volumes and the recorded paths. It never removes shared servers.
+
+If cleanup fails, for example because the engine is unreachable, the supervisor exits with an error and keeps the run's record. The next run on the same engine removes what it left, from any project of this user. The records are in `$XDG_STATE_HOME/zukhruf-testing/docker-runs` (`~/.local/state/zukhruf-testing/docker-runs` by default). Never delete a record to hide a cleanup failure.
+
+On an SSH engine the supervisor runs one test file at a time, unless you pass `--test-concurrency`. It runs on Linux and macOS: it stops a run as a process group, which Windows does not have.
+
+To pass the run to another container API, spread `docker.defaults`: it holds the default `resources` and the run's `labels`.
+
+## Databases
+
+`Postgres`, `Mysql` and `SqlServer` take the `docker` to run on. Each `database()` call creates a fresh database on a shared server; disposal drops it. `start()` creates a dedicated server; disposal stops it.
+
+```ts
+import { Postgres } from '@zukhruf/testing/postgres';
+
+const postgres = new Postgres({ docker });
+
+test('stores a record', { skip }, async () => {
+  await using database = await postgres.database();
+  // database.connectionString. Close your clients before the scope ends.
+});
+```
+
+The handle has `connectionString`, `host`, `port`, `user`, `password`, `database`, `image` and `containerId`. `Mysql` handles also have `query(sql)`. Without an image, `SqlServer` picks Azure SQL Edge on an ARM engine and SQL Server 2022 elsewhere. `ClickHouse` takes an explicit `image` and starts a dedicated server, so a test can create server-wide users and functions.
+
+`Sqlite` creates a file-backed database in a temporary directory, with a native `DatabaseSync` connection. Disposal closes the connection and removes the directory, including WAL files. `writeLock(path, durationMs)` holds a write lock from another process, which releases it after `durationMs`, even while the caller blocks in a synchronous write.
+
+`DuckDB` creates an in-memory database. Disposal closes the connection before the instance.
+
+`BigQuery` creates a dataset in the project you name. Disposal deletes it with its tables and views. You provide the credentials.
+
+## HTTP servers and streams
+
+`new HttpServer().start(handler)` listens on `127.0.0.1` on a free port and resolves once it listens. The handle has `origin` and the native `server`. Disposal closes active connections and waits for the server to close.
+
+`StreamHarness` gives a controlled producer, `source<T>()`, with `enqueue`, `close`, `error` and a read-only `state`, and a disposable `reader(stream)` that locks a stream without reading ahead. `collectUntilError()` returns the remaining chunks and either `completed` or `errored` with the error.
+
+## Waiting
+
+`timebox(fn, options)` retries `fn` until it stops throwing, every 250 ms for at most 30 seconds by default. It takes every p-retry option. `settleWithin(promise, label, ms)` rejects when a promise that cannot be cancelled does not settle in time. When an operation accepts an `AbortSignal`, pass `AbortSignal.timeout(ms)` to it instead.
+
+## Development
+
+```sh
+npx nx run testing:test        # builds, then runs the tests
+npx nx run testing:typecheck   # formats, lints, then type checks
+```
+
+The Docker-backed tests follow `ZUKHRUF_TESTING_DOCKER`. CI skips them on every operating system, and `.github/workflows/docker.yml` runs them with `required` when this package changes: on Linux, and on Windows through Docker Desktop for the mutex's container tests.

package/dist/async/index.d.ts

@@ -0,0 +1,3 @@
+export { settleWithin } from './settle-within.ts';
+export { type TimeboxOptions, timebox } from './timebox.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/async/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/async/index.js

@@ -0,0 +1,3 @@
+export { settleWithin } from "./settle-within.js";
+export { timebox } from "./timebox.js";
+//# sourceMappingURL=index.js.map

package/dist/async/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/async/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAuB,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/async/settle-within.d.ts

@@ -0,0 +1,2 @@
+export declare function settleWithin<T>(promise: PromiseLike<T>, label: string, timeoutMs?: number): Promise<T>;
+//# sourceMappingURL=settle-within.d.ts.map

package/dist/async/settle-within.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-within.d.ts","sourceRoot":"","sources":["../../src/async/settle-within.ts"],"names":[],"mappings":"AAAA,wBAAsB,YAAY,CAAC,CAAC,EAClC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,SAAQ,GAChB,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/async/settle-within.js

@@ -0,0 +1,6 @@
+export async function settleWithin(promise, label, timeoutMs = 5_000) {
+    const timeout = Promise.withResolvers();
+    using _timer = globalThis.setTimeout(() => timeout.reject(new Error(`timed out waiting for: ${label}`)), timeoutMs);
+    return await Promise.race([promise, timeout.promise]);
+}
+//# sourceMappingURL=settle-within.js.map

package/dist/async/settle-within.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle-within.js","sourceRoot":"","sources":["../../src/async/settle-within.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,KAAa,EACb,SAAS,GAAG,KAAK;IAEjB,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAClC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC,EAClE,SAAS,CACV,CAAC;IACF,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/async/timebox.d.ts

@@ -0,0 +1,41 @@
+import { type Options } from 'p-retry';
+/**
+ * Options for {@link timebox} — p-retry's full option surface: `retries`
+ * (attempt-count bound), `maxRetryTime` (wall-clock budget, monotonic clock),
+ * `minTimeout` / `factor` / `maxTimeout` (interval & backoff), `randomize`,
+ * `signal` (external abort), `onFailedAttempt`, `shouldRetry`, `unref`.
+ */
+export type TimeboxOptions = Options;
+/**
+ * Retry `fn` until it stops throwing or the budget runs out — the readiness
+ * idiom on top of p-retry. The probe throws while the service is down; timebox
+ * keeps re-running it until it doesn't, then resolves with its value.
+ *
+ * Defaults are tuned for polling a service into existence: a fixed 250ms
+ * interval (no exponential backoff) and a 30s wall-clock budget. The retry
+ * timer is deliberately NOT unref'd — a readiness wait must keep the event loop
+ * alive until it resolves, or it would never settle in a standalone script. On timeout it rejects with the operation's last error (so
+ * the failure says *why* the service never came up). Note: p-retry does not
+ * retry a non-network `TypeError`, so a bug in the probe aborts immediately
+ * instead of looping out the budget.
+ *
+ * Override any p-retry option to reshape the budget:
+ * - `{ maxRetryTime: 60_000 }` — a longer wall-clock window
+ * - `{ retries: 120, maxRetryTime: Infinity }` — bound by attempt count instead
+ * - `{ minTimeout: 1000, factor: 2 }` — exponential backoff
+ * - `{ signal }` — cancel from outside (e.g. a test timeout)
+ *
+ * @example
+ * ```typescript
+ * // Wait up to 60s for Postgres to accept queries:
+ * await timebox(
+ *   async () => {
+ *     await exec(['pg_isready', '-U', user]);
+ *     await exec(['psql', '-U', user, '-c', 'SELECT 1']);
+ *   },
+ *   { maxRetryTime: 60_000 },
+ * );
+ * ```
+ */
+export declare function timebox<T>(fn: (attemptNumber: number) => PromiseLike<T> | T, options?: TimeboxOptions): Promise<T>;
+//# sourceMappingURL=timebox.d.ts.map

package/dist/async/timebox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timebox.d.ts","sourceRoot":"","sources":["../../src/async/timebox.ts"],"names":[],"mappings":"AAAA,OAAe,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC;AASrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,EAAE,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EACjD,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/async/timebox.js

@@ -0,0 +1,42 @@
+import pRetry, {} from 'p-retry';
+const READINESS_DEFAULTS = {
+    retries: Number.POSITIVE_INFINITY,
+    factor: 1,
+    minTimeout: 250,
+    maxRetryTime: 30_000,
+};
+/**
+ * Retry `fn` until it stops throwing or the budget runs out — the readiness
+ * idiom on top of p-retry. The probe throws while the service is down; timebox
+ * keeps re-running it until it doesn't, then resolves with its value.
+ *
+ * Defaults are tuned for polling a service into existence: a fixed 250ms
+ * interval (no exponential backoff) and a 30s wall-clock budget. The retry
+ * timer is deliberately NOT unref'd — a readiness wait must keep the event loop
+ * alive until it resolves, or it would never settle in a standalone script. On timeout it rejects with the operation's last error (so
+ * the failure says *why* the service never came up). Note: p-retry does not
+ * retry a non-network `TypeError`, so a bug in the probe aborts immediately
+ * instead of looping out the budget.
+ *
+ * Override any p-retry option to reshape the budget:
+ * - `{ maxRetryTime: 60_000 }` — a longer wall-clock window
+ * - `{ retries: 120, maxRetryTime: Infinity }` — bound by attempt count instead
+ * - `{ minTimeout: 1000, factor: 2 }` — exponential backoff
+ * - `{ signal }` — cancel from outside (e.g. a test timeout)
+ *
+ * @example
+ * ```typescript
+ * // Wait up to 60s for Postgres to accept queries:
+ * await timebox(
+ *   async () => {
+ *     await exec(['pg_isready', '-U', user]);
+ *     await exec(['psql', '-U', user, '-c', 'SELECT 1']);
+ *   },
+ *   { maxRetryTime: 60_000 },
+ * );
+ * ```
+ */
+export function timebox(fn, options = {}) {
+    return pRetry(fn, { ...READINESS_DEFAULTS, ...options });
+}
+//# sourceMappingURL=timebox.js.map

package/dist/async/timebox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timebox.js","sourceRoot":"","sources":["../../src/async/timebox.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,EAAE,EAAgB,MAAM,SAAS,CAAC;AAU/C,MAAM,kBAAkB,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC,iBAAiB;IACjC,MAAM,EAAE,CAAC;IACT,UAAU,EAAE,GAAG;IACf,YAAY,EAAE,MAAM;CACH,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,OAAO,CACrB,EAAiD,EACjD,UAA0B,EAAE;IAE5B,OAAO,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,kBAAkB,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/databases/bigquery.d.ts

@@ -0,0 +1,16 @@
+import { type Dataset } from '@google-cloud/bigquery';
+export interface BigQueryDataset extends AsyncDisposable {
+    dataset: Dataset;
+    /** Delete the owned dataset and its contents. */
+    cleanup: () => Promise<void>;
+}
+/** Each acquisition owns an isolated dataset in the configured cloud project. */
+export declare class BigQuery {
+    #private;
+    constructor({ projectId, location, }: {
+        projectId: string;
+        location: string;
+    });
+    dataset(): Promise<BigQueryDataset>;
+}
+//# sourceMappingURL=bigquery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bigquery.d.ts","sourceRoot":"","sources":["../../src/databases/bigquery.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,OAAO,EACb,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,iFAAiF;AACjF,qBAAa,QAAQ;;gBAIP,EACV,SAAS,EACT,QAAQ,GACT,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAKK,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;CAa1C"}

package/dist/databases/bigquery.js

@@ -0,0 +1,21 @@
+import { randomUUID } from 'node:crypto';
+import { BigQuery as BigQueryClient, } from '@google-cloud/bigquery';
+/** Each acquisition owns an isolated dataset in the configured cloud project. */
+export class BigQuery {
+    #client;
+    #location;
+    constructor({ projectId, location, }) {
+        this.#client = new BigQueryClient({ projectId });
+        this.#location = location;
+    }
+    async dataset() {
+        const [dataset] = await this.#client.createDataset(`test_${randomUUID().replaceAll('-', '')}`, { location: this.#location });
+        const resources = new AsyncDisposableStack();
+        resources.defer(async () => {
+            await dataset.delete({ force: true });
+        });
+        const cleanup = () => resources.disposeAsync();
+        return { dataset, cleanup, [Symbol.asyncDispose]: cleanup };
+    }
+}
+//# sourceMappingURL=bigquery.js.map

package/dist/databases/bigquery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigquery.js","sourceRoot":"","sources":["../../src/databases/bigquery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,QAAQ,IAAI,cAAc,GAE3B,MAAM,wBAAwB,CAAC;AAQhC,iFAAiF;AACjF,MAAM,OAAO,QAAQ;IACV,OAAO,CAAiB;IACxB,SAAS,CAAS;IAE3B,YAAY,EACV,SAAS,EACT,QAAQ,GAIT;QACC,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAChD,QAAQ,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAC1C,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAC7B,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,SAAS,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAE/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IAC9D,CAAC;CACF"}

package/dist/databases/clickhouse.d.ts

@@ -0,0 +1,12 @@
+import type { ServiceContainer } from '../docker/container.ts';
+import type { Docker } from '../docker/docker.ts';
+/** Each start owns a dedicated ClickHouse server and its disposable container. */
+export declare class ClickHouse {
+    #private;
+    constructor({ docker, image }: {
+        docker: Docker;
+        image: string;
+    });
+    start(): Promise<ServiceContainer>;
+}
+//# sourceMappingURL=clickhouse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../src/databases/clickhouse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,kFAAkF;AAClF,qBAAa,UAAU;;gBAIT,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAKhE,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAYnC"}

package/dist/databases/clickhouse.js

@@ -0,0 +1,22 @@
+import { timebox } from "../async/timebox.js";
+/** Each start owns a dedicated ClickHouse server and its disposable container. */
+export class ClickHouse {
+    #docker;
+    #image;
+    constructor({ docker, image }) {
+        this.#docker = docker;
+        this.#image = image;
+    }
+    start() {
+        return this.#docker.serve({
+            image: this.#image,
+            internalPort: 8123,
+            memory: '2g',
+            env: { CLICKHOUSE_SKIP_USER_SETUP: '1' },
+            healthy: ({ exec }) => timebox(() => exec(['clickhouse-client', '--query', 'SELECT 1']), {
+                maxRetryTime: 60_000,
+            }),
+        });
+    }
+}
+//# sourceMappingURL=clickhouse.js.map

package/dist/databases/clickhouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.js","sourceRoot":"","sources":["../../src/databases/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI9C,kFAAkF;AAClF,MAAM,OAAO,UAAU;IACZ,OAAO,CAAS;IAChB,MAAM,CAAS;IAExB,YAAY,EAAE,MAAM,EAAE,KAAK,EAAqC;QAC9D,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YACxB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,EAAE,0BAA0B,EAAE,GAAG,EAAE;YACxC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACpB,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,mBAAmB,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,EAAE;gBAChE,YAAY,EAAE,MAAM;aACrB,CAAC;SACL,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/databases/database.d.ts

@@ -0,0 +1,24 @@
+import type { Docker } from '../docker/docker.ts';
+/** Connection and disposal for one server-backed database. */
+export interface Database extends AsyncDisposable {
+    connectionString: string;
+    image: string;
+    containerId: string;
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    database: string;
+    /** A database() handle drops its database; a start() handle stops its container. */
+    cleanup: () => Promise<void>;
+}
+export interface DatabaseOptions {
+    /** The engine the server runs on, with the test run that owns it. */
+    docker: Docker;
+    labels?: Record<string, string>;
+    image?: string;
+    password?: string;
+    /** Used by start(); database() always creates an isolated name. */
+    database?: string;
+}
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/databases/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,8DAA8D;AAC9D,MAAM,WAAW,QAAS,SAAQ,eAAe;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/databases/database.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=database.js.map

package/dist/databases/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/databases/database.ts"],"names":[],"mappings":""}

package/dist/databases/duckdb.d.ts

@@ -0,0 +1,11 @@
+import { type DuckDBConnection } from '@duckdb/node-api';
+export interface DuckDBDatabase extends AsyncDisposable {
+    connection: DuckDBConnection;
+    /** Close the connection before releasing its in-memory database instance. */
+    cleanup: () => Promise<void>;
+}
+/** Each acquisition owns an independent, in-memory DuckDB database. */
+export declare class DuckDB {
+    database(): Promise<DuckDBDatabase>;
+}
+//# sourceMappingURL=duckdb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.d.ts","sourceRoot":"","sources":["../../src/databases/duckdb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAkB,MAAM,kBAAkB,CAAC;AAEzE,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,uEAAuE;AACvE,qBAAa,MAAM;IACX,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;CAc1C"}

package/dist/databases/duckdb.js

@@ -0,0 +1,13 @@
+import { DuckDBInstance } from '@duckdb/node-api';
+/** Each acquisition owns an independent, in-memory DuckDB database. */
+export class DuckDB {
+    async database() {
+        await using resources = new AsyncDisposableStack();
+        const instance = resources.adopt(await DuckDBInstance.create(), (instance) => instance.closeSync());
+        const connection = resources.adopt(await instance.connect(), (connection) => connection.closeSync());
+        const owned = resources.move();
+        const cleanup = () => owned.disposeAsync();
+        return { connection, cleanup, [Symbol.asyncDispose]: cleanup };
+    }
+}
+//# sourceMappingURL=duckdb.js.map

package/dist/databases/duckdb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.js","sourceRoot":"","sources":["../../src/databases/duckdb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQzE,uEAAuE;AACvE,MAAM,OAAO,MAAM;IACjB,KAAK,CAAC,QAAQ;QACZ,YAAY,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAC9B,MAAM,cAAc,CAAC,MAAM,EAAE,EAC7B,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,CACnC,CAAC;QACF,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,EAAE,EAAE,CAC1E,UAAU,CAAC,SAAS,EAAE,CACvB,CAAC;QACF,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAE3C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACjE,CAAC;CACF"}

package/dist/databases/mysql.d.ts

@@ -0,0 +1,17 @@
+import type { Database, DatabaseOptions } from './database.ts';
+export type { Database, DatabaseOptions } from './database.ts';
+export interface MysqlOptions extends DatabaseOptions {
+    user?: string;
+}
+export interface MysqlDatabase extends Database {
+    query: (sql: string) => Promise<Record<string, string | null>[]>;
+}
+export declare class Mysql {
+    #private;
+    constructor({ docker, image, password, database, user, labels, }: MysqlOptions);
+    /** Create an isolated database on the persistent shared server. */
+    database(): Promise<MysqlDatabase>;
+    /** Start a dedicated server; the returned handle owns its container. */
+    start(): Promise<MysqlDatabase>;
+}
+//# sourceMappingURL=mysql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/databases/mysql.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,YAAa,SAAQ,eAAe;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;CAClE;AAED,qBAAa,KAAK;;gBAIJ,EACV,MAAM,EACN,KAAmB,EACnB,QAAyB,EACzB,QAAgB,EAChB,IAAa,EACb,MAAM,GACP,EAAE,YAAY;IAKf,mEAAmE;IAC7D,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAoBxC,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;CA4GtC"}

package/dist/databases/mysql.js

@@ -0,0 +1,116 @@
+import { randomUUID } from 'node:crypto';
+import { timebox } from "../async/timebox.js";
+export class Mysql {
+    #docker;
+    #options;
+    constructor({ docker, image = 'mysql:8.4', password = 'testpassword', database = 'app', user = 'root', 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('app', '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}\``).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) {
+        const { user, password } = this.#options;
+        return container.exec([
+            'mysql',
+            `-u${user}`,
+            `-p${password}`,
+            '--execute',
+            sql,
+        ]);
+    }
+    async #query(container, database, sql) {
+        const { user, password } = this.#options;
+        const { stdout } = await container.exec([
+            'mysql',
+            `-u${user}`,
+            `-p${password}`,
+            '--database',
+            database,
+            '--batch',
+            '--raw',
+            '--execute',
+            sql,
+        ]);
+        return this.#parseBatch(stdout);
+    }
+    #parseBatch(stdout) {
+        const [headerLine, ...rows] = stdout.trimEnd().split('\n').filter(Boolean);
+        if (headerLine === undefined)
+            return [];
+        const headers = headerLine.split('\t');
+        return rows.map((line) => {
+            const values = line.split('\t');
+            return Object.fromEntries(headers.map((header, index) => {
+                const value = values[index];
+                return [
+                    header,
+                    value === undefined || value === 'NULL' ? null : value,
+                ];
+            }));
+        });
+    }
+    #acquire(database, mode) {
+        const { image, password, labels } = this.#options;
+        return this.#docker[mode]({
+            image,
+            labels,
+            internalPort: 3306,
+            env: { MYSQL_ROOT_PASSWORD: password, MYSQL_DATABASE: database },
+            tmpfs: ['/var/lib/mysql:rw,size=512m'],
+            memorySwappiness: 0,
+            healthy: (container) => this.#ready(container),
+        });
+    }
+    #ready(container) {
+        const { user, password } = this.#options;
+        return timebox(() => container.exec([
+            'mysqladmin',
+            'ping',
+            '-h',
+            '127.0.0.1',
+            `-u${user}`,
+            `-p${password}`,
+            '--silent',
+        ]), { maxRetryTime: 90_000 });
+    }
+    #handle(container, database, cleanup) {
+        const { image, user, password } = this.#options;
+        return {
+            connectionString: `mysql://${user}:${password}@${container.host}:${container.port}/${database}`,
+            image,
+            user,
+            password,
+            database,
+            containerId: container.containerId,
+            host: container.host,
+            port: container.port,
+            query: (sql) => this.#query(container, database, sql),
+            cleanup,
+            [Symbol.asyncDispose]: cleanup,
+        };
+    }
+}
+//# sourceMappingURL=mysql.js.map

package/dist/databases/mysql.js.map

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