@harperfast/integration-testing 0.5.0 → 0.5.2

package/dist/harperLifecycle.js

@@ -0,0 +1,594 @@
+import { spawn, ChildProcess } from 'node:child_process';
+import { createWriteStream, existsSync } from 'node:fs';
+import { join, basename, dirname } from 'node:path';
+import { tmpdir } from 'node:os';
+import { mkdtemp, mkdir, rm, cp } from 'node:fs/promises';
+import {} from 'node:test';
+import { getNextAvailableLoopbackAddress, releaseLoopbackAddress } from "./loopbackAddressPool.js";
+import { waitForPortsFree } from "./portUtils.js";
+import { ok, equal } from 'node:assert';
+import { createRequire } from 'node:module';
+/**
+ * Creates a plain object satisfying HarperTestContext, for use outside node:test
+ * (e.g. as a Playwright worker fixture).
+ *
+ * @param name Optional name for log directory naming (e.g. Playwright worker index).
+ */
+export function createHarperContext(name) {
+    return { name };
+}
+// Constants
+const HTTP_PORT = 9926;
+const HTTPS_PORT = 9927;
+const MQTT_PORT = 1883;
+const MQTTS_PORT = 8883;
+export const OPERATIONS_API_PORT = 9925;
+export const DEFAULT_ADMIN_USERNAME = 'admin';
+export const DEFAULT_ADMIN_PASSWORD = 'Abc1234!';
+/** Every fixed port a Harper test instance may bind, all on its assigned loopback address. */
+const ALL_HARPER_PORTS = [OPERATIONS_API_PORT, HTTP_PORT, HTTPS_PORT, MQTT_PORT, MQTTS_PORT];
+/** Whether we appear to be running in CI (most CI providers set CI=true). */
+const IS_CI = !!process.env.CI;
+/**
+ * Maximum time to wait between chunks of Harper startup output before treating the process
+ * as hung. The startup watchdog resets this window on every chunk of output, so the limit is
+ * time-since-last-progress rather than total boot time: a slow-but-healthy boot that keeps
+ * logging never trips it — only true silence does.
+ *
+ * Override with `HARPER_INTEGRATION_TEST_STARTUP_TIMEOUT_MS`. Default 60s.
+ */
+export const DEFAULT_STARTUP_TIMEOUT_MS = parseInt(process.env.HARPER_INTEGRATION_TEST_STARTUP_TIMEOUT_MS || '', 10) || 60000;
+/**
+ * Absolute ceiling on total startup time, regardless of ongoing output — a generous backstop
+ * so a process that chatters forever without ever reporting ready still fails. Higher under CI,
+ * where shared/contended runners boot more slowly.
+ *
+ * Override with `HARPER_INTEGRATION_TEST_STARTUP_MAX_MS`. Default 120s (300s under CI).
+ */
+export const DEFAULT_STARTUP_MAX_MS = parseInt(process.env.HARPER_INTEGRATION_TEST_STARTUP_MAX_MS || '', 10) || (IS_CI ? 300000 : 120000);
+/**
+ * Grace period after SIGTERM before escalating to SIGKILL during teardown, giving Harper time
+ * to shut down cleanly (flush RocksDB, release ports, reap worker children).
+ *
+ * Override with `HARPER_INTEGRATION_TEST_TEARDOWN_GRACE_MS`. Default 5s.
+ */
+export const DEFAULT_TEARDOWN_GRACE_MS = parseInt(process.env.HARPER_INTEGRATION_TEST_TEARDOWN_GRACE_MS || '', 10) || 5000;
+/**
+ * Time teardown's safety assertion waits for Harper's fixed ports to be free before recycling the
+ * loopback address. Killing Harper's process tree (and waiting for exit) should free them
+ * immediately, so this normally returns on the first check; it only matters if a child process
+ * escaped the kill. If the ports are still in use at the deadline, the address is recycled anyway
+ * (no worse than not waiting) and a warning is logged.
+ *
+ * Override with `HARPER_INTEGRATION_TEST_PORT_RELEASE_TIMEOUT_MS`. Default 5s.
+ */
+export const DEFAULT_PORT_RELEASE_TIMEOUT_MS = parseInt(process.env.HARPER_INTEGRATION_TEST_PORT_RELEASE_TIMEOUT_MS || '', 10) || 5000;
+/** Short backstop wait for the process 'exit' event after sending SIGKILL during teardown. */
+const SIGKILL_EXIT_WAIT_MS = 1000;
+/**
+ * The runtime to use for running Harper during tests.
+ * Set via the HARPER_RUNTIME environment variable ('node' or 'bun').
+ * Defaults to 'node'.
+ */
+export const HARPER_RUNTIME = process.env.HARPER_RUNTIME || 'node';
+/**
+ * Marker emitted on stdout by startHarper() so the test runner (run.ts) can map
+ * a Harper instance's log directory to the currently executing test file via
+ * the node:test `test:stdout` event.
+ */
+export const LOG_DIR_MARKER_PREFIX = '[Harper] Logs for this instance will be stored in:';
+/**
+ * Gets the path to the Harper CLI script.
+ *
+ * Resolution order:
+ * 1. `harperBinPath` argument
+ * 2. `HARPER_INTEGRATION_TEST_INSTALL_SCRIPT` environment variable
+ * 3. Auto-resolved from 'harper' package in node_modules
+ * 4. Auto-resolved from current directory or ancestors ('dist/bin/harper.js')
+ *
+ * @returns The absolute path to the Harper CLI entry script
+ * @throws {AssertionError} If the script cannot be found
+ */
+function getHarperScript(harperBinPath) {
+    // 1. Explicit option
+    if (harperBinPath) {
+        ok(existsSync(harperBinPath), `Harper script not found at provided harperBinPath: ${harperBinPath}`);
+        return harperBinPath;
+    }
+    // 2. Environment variable
+    const envPath = process.env.HARPER_INTEGRATION_TEST_INSTALL_SCRIPT;
+    if (envPath) {
+        ok(existsSync(envPath), `Harper script not found at HARPER_INTEGRATION_TEST_INSTALL_SCRIPT path: ${envPath}`);
+        return envPath;
+    }
+    // 3. Auto-resolve from node_modules
+    try {
+        const require = createRequire(import.meta.url);
+        const resolved = require.resolve('harper/dist/bin/harper.js');
+        if (existsSync(resolved)) {
+            return resolved;
+        }
+    }
+    catch {
+        // harper package not found in node_modules
+    }
+    // 4. Auto-resolve from current directory or ancestors
+    let currentDir = process.cwd();
+    while (true) {
+        const potentialPath = join(currentDir, 'dist/bin/harper.js');
+        if (existsSync(potentialPath)) {
+            return potentialPath;
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    throw new Error(`Harper CLI script not found. Provide the path via:\n` +
+        `  - harperBinPath option: startHarper(ctx, { harperBinPath: '/path/to/dist/bin/harper.js' })\n` +
+        `  - HARPER_INTEGRATION_TEST_INSTALL_SCRIPT environment variable\n` +
+        `  - Install 'harper' as a dependency in your project\n` +
+        `  - Run tests within a directory containing 'dist/bin/harper.js'`);
+}
+/**
+ * Strips ANSI escape sequences (colors, bold, underline, cursor movement, etc.) from a string.
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nq-uy=><~]/g;
+function stripAnsi(str) {
+    return str.replace(ANSI_REGEX, '');
+}
+/**
+ * Sanitizes a string for use as a filesystem directory name.
+ */
+function sanitizeForFilesystem(name) {
+    return name
+        .replace(/[^a-zA-Z0-9_-]/g, '_')
+        .replace(/_+/g, '_')
+        .substring(0, 100);
+}
+/**
+ * Error thrown when a Harper process fails to start or times out.
+ * Includes captured stdout and stderr for diagnostics.
+ */
+export class HarperStartupError extends Error {
+    stdout;
+    stderr;
+    constructor(message, stdout, stderr) {
+        let fullMessage = message;
+        if (stdout) {
+            fullMessage += `\n\nstdout:\n${stdout}`;
+        }
+        if (stderr) {
+            fullMessage += `\n\nstderr:\n${stderr}`;
+        }
+        super(fullMessage);
+        this.name = 'HarperStartupError';
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
+/**
+ * Runs a Harper CLI command and captures output.
+ *
+ * When `logDir` is provided, stdout and stderr are also written to files
+ * (`stdout.log` and `stderr.log`) in that directory.
+ *
+ * @throws {HarperStartupError} If the command times out or exits with a non-zero status code
+ *
+ * Exported for unit testing; not part of the public API (not re-exported from `index.ts`).
+ */
+export function runHarperCommand({ args, env, completionMessage, logDir, harperBinPath, timeoutMs, maxMs, }) {
+    const harperScript = getHarperScript(harperBinPath);
+    const runtime = HARPER_RUNTIME;
+    const runtimeArgs = runtime === 'bun'
+        ? [harperScript, ...args]
+        : ['--trace-warnings', '--force-node-api-uncaught-exceptions-policy=true', harperScript, ...args];
+    const proc = spawn(runtime, runtimeArgs, {
+        env: { ...process.env, ...env },
+        // On POSIX, run Harper as its own process-group leader so teardown can signal the whole
+        // group (parent + any worker children), not just the direct child. Windows has no process
+        // groups; killHarper uses `taskkill /T` there instead. stdio stays piped (not detached),
+        // and we never unref, so output capture and lifetime management are unchanged.
+        detached: process.platform !== 'win32',
+    });
+    // Reap this process's tree if the runner exits/is interrupted before teardown (it's detached,
+    // so it would otherwise survive signals sent to the runner's group).
+    trackHarperProcess(proc);
+    let stdoutStream;
+    let stderrStream;
+    if (logDir) {
+        stdoutStream = createWriteStream(join(logDir, 'stdout.log'));
+        stderrStream = createWriteStream(join(logDir, 'stderr.log'));
+    }
+    const idleTimeoutMs = timeoutMs ?? DEFAULT_STARTUP_TIMEOUT_MS;
+    const maxTimeoutMs = maxMs ?? DEFAULT_STARTUP_MAX_MS;
+    return new Promise((resolve, reject) => {
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        let idleTimer;
+        let maxTimer;
+        const clearTimers = () => {
+            clearTimeout(idleTimer);
+            clearTimeout(maxTimer);
+        };
+        const failStartup = (message) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimers();
+            reject(new HarperStartupError(message, stdout, stderr));
+            // Harper is spawned detached (its own process group), so `proc.kill()` would only hit the
+            // direct child and orphan any worker children still holding ports. Reap the whole tree.
+            signalHarperTree(proc, 'SIGKILL');
+        };
+        const succeed = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimers();
+            resolve({ process: proc, stdout, stderr });
+        };
+        // Reset on every chunk of output so the limit is time-since-last-progress, not total boot
+        // time: a slow-but-healthy boot that keeps logging never trips it, only true silence does.
+        const resetIdleTimer = () => {
+            if (settled)
+                return;
+            clearTimeout(idleTimer);
+            idleTimer = setTimeout(() => failStartup(`Harper produced no startup output for ${idleTimeoutMs}ms before reporting ready (likely hung)`), idleTimeoutMs);
+        };
+        // Absolute backstop, regardless of ongoing output.
+        maxTimer = setTimeout(() => failStartup(`Harper did not report ready within the maximum startup time of ${maxTimeoutMs}ms`), maxTimeoutMs);
+        resetIdleTimer();
+        proc.stdout?.on('data', (data) => {
+            const dataString = stripAnsi(data.toString());
+            stdoutStream?.write(dataString);
+            // Once ready, keep streaming logs to disk but stop the watchdog and capture: the
+            // returned startupOutput is a snapshot taken at readiness, and the server may run
+            // (and log) for the rest of the suite.
+            if (settled)
+                return;
+            resetIdleTimer();
+            stdout += dataString;
+            // Match against the accumulated output, not just this chunk, so a marker split across
+            // two stream chunks is still detected.
+            if (completionMessage && stdout.includes(completionMessage)) {
+                succeed();
+            }
+        });
+        proc.stderr?.on('data', (data) => {
+            const dataString = stripAnsi(data.toString());
+            stderrStream?.write(dataString);
+            if (settled)
+                return;
+            resetIdleTimer();
+            stderr += dataString;
+        });
+        proc.on('error', (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimers();
+            // 'exit' won't fire for a failed spawn, so close the log streams here to avoid leaking FDs.
+            stdoutStream?.end();
+            stderrStream?.end();
+            reject(error);
+        });
+        proc.on('exit', (statusCode, signal) => {
+            clearTimers();
+            if (!settled) {
+                settled = true;
+                if (statusCode === 0) {
+                    resolve({ process: proc, stdout, stderr });
+                }
+                else {
+                    const errorMessage = `Harper process failed with exit code/signal ${statusCode ?? signal}`;
+                    stderrStream?.write(errorMessage);
+                    reject(new HarperStartupError(errorMessage, stdout, stderr));
+                }
+            }
+            stdoutStream?.end();
+            stderrStream?.end();
+        });
+    });
+}
+/**
+ * Sets up a Harper instance with a component pre-installed from a local directory.
+ *
+ * Copies `fixturePath` into `{dataRootDir}/components/{name}` before Harper starts,
+ * so the component is available on the first request without a post-startup deploy.
+ * Use this when tests need a known route available at startup (e.g. mTLS cert tests).
+ *
+ * @param ctx - The test context to populate with Harper instance details
+ * @param fixturePath - Absolute path to the component directory to pre-install
+ * @param options - Optional configuration for the setup process
+ */
+export async function setupHarperWithFixture(ctx, fixturePath, options) {
+    const dataRootDirPrefix = join(process.env.HARPER_INTEGRATION_TEST_INSTALL_PARENT_DIR || tmpdir(), 'harper-integration-test-');
+    const dataRootDir = await mkdtemp(dataRootDirPrefix);
+    await cp(fixturePath, join(dataRootDir, 'components', basename(fixturePath)), { recursive: true, dereference: true });
+    ctx.harper = { dataRootDir };
+    return startHarper(ctx, options);
+}
+/**
+ * Sets up and starts a Harper instance for testing.
+ *
+ * @param ctx - The test context to populate with Harper instance details
+ * @param options - Optional configuration for the setup process
+ * @returns The context with the `harper` property populated
+ *
+ * @example
+ * ```ts
+ * suite('My tests', (ctx: ContextWithHarper) => {
+ *   before(async () => {
+ *     await startHarper(ctx);
+ *   });
+ *
+ *   after(async () => {
+ *     await teardownHarper(ctx);
+ *   });
+ *
+ *   test('can connect', async () => {
+ *     const response = await fetch(ctx.harper.httpURL);
+ *     // ...
+ *   });
+ * });
+ * ```
+ */
+export async function startHarper(ctx, options) {
+    const dataRootDirPrefix = join(process.env.HARPER_INTEGRATION_TEST_INSTALL_PARENT_DIR || tmpdir(), `harper-integration-test-`);
+    const dataRootDir = ctx.harper?.dataRootDir ?? (await mkdtemp(dataRootDirPrefix));
+    const loopbackAddress = ctx.harper?.hostname ?? (await getNextAvailableLoopbackAddress());
+    // Set up per-suite log directory when HARPER_INTEGRATION_TEST_LOG_DIR is configured
+    const logDirEnv = process.env.HARPER_INTEGRATION_TEST_LOG_DIR;
+    let logDir;
+    if (logDirEnv) {
+        const suiteName = sanitizeForFilesystem(ctx.name || 'unknown');
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        logDir = join(logDirEnv, `${suiteName}-${sanitizeForFilesystem(loopbackAddress)}-${timestamp}`);
+        await mkdir(logDir, { recursive: true });
+        // Output for the test runner (e.g. run.ts) to map this log dir to the current test file
+        process.stdout.write(`${LOG_DIR_MARKER_PREFIX} ${logDir}\n`);
+    }
+    // Point Harper's log directory to the suite log dir so hdb.log is preserved for upload
+    const config = { ...options?.config };
+    if (logDir) {
+        config.logging = { ...config.logging, root: logDir };
+    }
+    const args = [
+        `--ROOTPATH=${dataRootDir}`,
+        `--AUTHENTICATION_AUTHORIZELOCAL=true`,
+        `--HDB_ADMIN_USERNAME=${DEFAULT_ADMIN_USERNAME}`,
+        `--HDB_ADMIN_PASSWORD=${DEFAULT_ADMIN_PASSWORD}`,
+        '--THREADS_COUNT=1',
+        '--THREADS_DEBUG=false',
+        `--NODE_HOSTNAME=${loopbackAddress}`,
+        `--HTTP_PORT=${loopbackAddress}:${HTTP_PORT}`,
+        `--OPERATIONSAPI_NETWORK_PORT=${loopbackAddress}:${OPERATIONS_API_PORT}`,
+        `--MQTT_NETWORK_PORT=${loopbackAddress}:${MQTT_PORT}`,
+        `--MQTT_NETWORK_SECUREPORT=${loopbackAddress}:${MQTTS_PORT}`,
+        '--LOGGING_LEVEL=debug',
+        '--LOGGING_STDSTREAMS=false',
+    ];
+    // Bind secure port if HTTPS is needed (mTLS or other TLS config present)
+    if (options?.config?.http?.mtls !== undefined || options?.config?.tls !== undefined) {
+        args.push(`--HTTP_SECUREPORT=${loopbackAddress}:${HTTPS_PORT}`);
+    }
+    // HARPER_SET_CONFIG must be passed as an environment variable, not a CLI arg,
+    // because applyRuntimeEnvVarConfig reads from process.env.HARPER_SET_CONFIG
+    const harperEnv = {
+        HARPER_SET_CONFIG: JSON.stringify(config),
+        ...options?.env,
+    };
+    const result = await runHarperCommand({
+        args,
+        env: harperEnv,
+        completionMessage: 'successfully started',
+        logDir,
+        harperBinPath: options?.harperBinPath,
+        timeoutMs: options?.startupTimeoutMs,
+        maxMs: options?.startupMaxMs,
+    });
+    ctx.harper = {
+        dataRootDir,
+        admin: {
+            username: DEFAULT_ADMIN_USERNAME,
+            password: DEFAULT_ADMIN_PASSWORD,
+        },
+        httpURL: `http://${loopbackAddress}:${HTTP_PORT}`,
+        operationsAPIURL: `http://${loopbackAddress}:${OPERATIONS_API_PORT}`,
+        hostname: loopbackAddress,
+        process: result.process,
+        logDir,
+        startupOutput: { stdout: result.stdout, stderr: result.stderr },
+    };
+    return ctx;
+}
+/**
+ * Signals Harper's entire process tree, not just the direct child.
+ *
+ * Harper runs its listeners in worker threads (in-process), but components can also spawn
+ * child processes, so we target the whole tree to be safe:
+ * - POSIX: Harper is spawned as its own process-group leader (`detached`), so a negative PID
+ *   signals the group (parent + descendants).
+ * - Windows: there are no process groups, so we shell out to `taskkill /T` (tree). `/F` (force)
+ *   is required to actually terminate console processes, so it is used for the SIGKILL step.
+ *
+ * Best-effort: errors (e.g. the process already exited) are swallowed; teardown's port assertion
+ * and the wait-for-exit are the safety nets.
+ */
+function signalHarperTree(proc, signal) {
+    const pid = proc.pid;
+    if (pid === undefined)
+        return;
+    if (process.platform === 'win32') {
+        const args = ['/pid', String(pid), '/T'];
+        if (signal === 'SIGKILL')
+            args.push('/F');
+        try {
+            spawn('taskkill', args, { stdio: 'ignore' }).on('error', () => { });
+        }
+        catch {
+            try {
+                proc.kill(signal);
+            }
+            catch {
+                // process already gone
+            }
+        }
+        return;
+    }
+    try {
+        // Negative PID => signal the whole process group (proc is the group leader via `detached`).
+        process.kill(-pid, signal);
+    }
+    catch {
+        // Group already gone, or (defensively) not a group leader — fall back to the direct child.
+        try {
+            proc.kill(signal);
+        }
+        catch {
+            // process already gone
+        }
+    }
+}
+/**
+ * Tracks live Harper processes so that if the test runner exits or is interrupted before teardown
+ * runs (Ctrl+C, or a CI job killing the runner), their process trees are reaped instead of left
+ * orphaned holding the fixed ports. This matters specifically because Harper is spawned `detached`
+ * (its own process group), so it would otherwise survive signals delivered to the runner's group.
+ *
+ * Best-effort: on POSIX the group SIGKILL is delivered synchronously (works even from the 'exit'
+ * handler); on Windows the `taskkill` shell-out may not complete before the runner exits.
+ */
+const liveHarperProcesses = new Set();
+let runnerCleanupRegistered = false;
+function trackHarperProcess(proc) {
+    liveHarperProcesses.add(proc);
+    proc.once('exit', () => liveHarperProcesses.delete(proc));
+    if (runnerCleanupRegistered)
+        return;
+    runnerCleanupRegistered = true;
+    const reapAll = () => {
+        for (const child of liveHarperProcesses)
+            signalHarperTree(child, 'SIGKILL');
+    };
+    process.once('exit', reapAll);
+    // SIGINT/SIGTERM don't fire 'exit'; reap, then re-raise so the runner still terminates normally.
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        process.once(signal, () => {
+            reapAll();
+            process.kill(process.pid, signal);
+        });
+    }
+}
+/**
+ * Kill harper process (can be used for teardown, or killing it before a restart).
+ *
+ * Sends SIGTERM to Harper's whole process tree first and gives it a grace period to shut down
+ * cleanly (flush RocksDB, release ports, reap worker children) before escalating to SIGKILL.
+ * After SIGKILL it waits briefly for the process to actually exit, so callers can rely on it
+ * being gone — and, since a dead process releases its listening sockets, on its ports being free.
+ *
+ * @param ctx
+ * @param options.graceMs Time to wait after SIGTERM before sending SIGKILL. Defaults to
+ *   {@link DEFAULT_TEARDOWN_GRACE_MS}.
+ */
+export async function killHarper(ctx, options) {
+    const proc = ctx.harper?.process;
+    if (!proc)
+        return;
+    // Already exited — nothing to do.
+    if (proc.exitCode !== null || proc.signalCode !== null)
+        return;
+    const graceMs = options?.graceMs ?? DEFAULT_TEARDOWN_GRACE_MS;
+    await new Promise((resolve) => {
+        let done = false;
+        let sigkillTimer;
+        let backstopTimer;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            proc.off('exit', finish);
+            clearTimeout(sigkillTimer);
+            clearTimeout(backstopTimer);
+            resolve();
+        };
+        proc.once('exit', finish);
+        // Ask the whole Harper tree to shut down cleanly first.
+        signalHarperTree(proc, 'SIGTERM');
+        // If it hasn't exited within the grace period, force-kill the tree and wait briefly for the
+        // 'exit' event before resolving (with a backstop in case it never fires).
+        sigkillTimer = setTimeout(() => {
+            signalHarperTree(proc, 'SIGKILL');
+            backstopTimer = setTimeout(finish, SIGKILL_EXIT_WAIT_MS);
+        }, graceMs);
+    });
+}
+/**
+ * Tears down a Harper instance and cleans up all resources.
+ *
+ * This function stops the Harper instance, releases the loopback address,
+ * and removes the installation directory.
+ * @param ctx - The test context with Harper instance details
+ *
+ * @example
+ * ```ts
+ * suite('My tests', (ctx: ContextWithHarper) => {
+ *   before(async () => {
+ *     await startHarper(ctx);
+ *   });
+ *
+ *   after(async () => {
+ *     await teardownHarper(ctx);
+ *   });
+ * });
+ * ```
+ */
+export async function teardownHarper(ctx) {
+    if (!ctx.harper)
+        return;
+    await killHarper(ctx);
+    // Safety assertion: killHarper waits for Harper's process tree to exit, which releases its
+    // listening sockets, so the fixed ports should already be free here. We still verify before
+    // recycling the address (the pool only guarantees the *address* is bindable, not that these
+    // specific ports are free) and warn if anything is somehow still holding them — that warning
+    // is a signal that a Harper child process escaped the tree kill, not normal operation. The
+    // address is recycled regardless.
+    if (ctx.harper.hostname) {
+        const portsFreed = await waitForPortsFree(ctx.harper.hostname, ALL_HARPER_PORTS, DEFAULT_PORT_RELEASE_TIMEOUT_MS);
+        if (portsFreed) {
+            await releaseLoopbackAddress(ctx.harper.hostname);
+        }
+        else {
+            // A Harper child escaped the tree kill and still holds this address's ports. Do NOT
+            // recycle the address — under SO_REUSEPORT a later suite could silently co-bind it
+            // (the exact failure the loopback pool exists to prevent). Leave the slot parked under
+            // this process's PID; it is reclaimed when this (per-file) process exits and its PID
+            // goes dead. The conflict canary in getNextAvailableLoopbackAddress is the backstop if
+            // the address is somehow handed out before then.
+            console.warn(`Harper ports on ${ctx.harper.hostname} still in use after teardown (${DEFAULT_PORT_RELEASE_TIMEOUT_MS}ms); NOT recycling the address (a Harper child outlived the kill). The slot will be reclaimed when this process exits.`);
+        }
+    }
+    // a few retries are typically necessary, might take a sec for a process to finish, especially since rocksdb may be flushing
+    try {
+        await rm(ctx.harper.dataRootDir, { recursive: true, force: true, maxRetries: 10 });
+    }
+    catch (error) {
+        console.error('Error removing directory', error);
+    }
+}
+export async function sendOperation(context, operation) {
+    const response = await fetch(context.operationsAPIURL, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(operation),
+    });
+    const responseData = await response.json();
+    equal(response.status, 200, JSON.stringify(responseData));
+    return responseData;
+}
+//# sourceMappingURL=harperLifecycle.js.map

package/dist/harperLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harperLifecycle.js","sourceRoot":"","sources":["../src/harperLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAoB,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAuC,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAuB5C;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAChD,OAAO,EAAE,IAAI,EAAE,CAAC;AACjB,CAAC;AAED,YAAY;AACZ,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEjD,8FAA8F;AAC9F,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAE7F,6EAA6E;AAC7E,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC;AAE9H;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1I;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yCAAyC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;AAE3H;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,+CAA+C,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;AAEvI,8FAA8F;AAC9F,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB,OAAO,CAAC,GAAG,CAAC,cAAsB,IAAI,MAAM,CAAC;AAE5F;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,oDAAoD,CAAC;AAwE1F;;;;;;;;;;;GAWG;AACH,SAAS,eAAe,CAAC,aAAsB;IAC9C,qBAAqB;IACrB,IAAI,aAAa,EAAE,CAAC;QACnB,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,sDAAsD,aAAa,EAAE,CAAC,CAAC;QACrG,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,0BAA0B;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC;IACnE,IAAI,OAAO,EAAE,CAAC;QACb,EAAE,CACD,UAAU,CAAC,OAAO,CAAC,EACnB,2EAA2E,OAAO,EAAE,CACpF,CAAC;QACF,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QAC9D,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC;QACjB,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,2CAA2C;IAC5C,CAAC;IAED,sDAAsD;IACtD,IAAI,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;QAC7D,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,OAAO,aAAa,CAAC;QACtB,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM;QACP,CAAC;QACD,UAAU,GAAG,SAAS,CAAC;IACxB,CAAC;IAED,MAAM,IAAI,KAAK,CACd,sDAAsD;QACrD,gGAAgG;QAChG,mEAAmE;QACnE,wDAAwD;QACxD,kEAAkE,CACnE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,4CAA4C;AAC5C,MAAM,UAAU,GAAG,+EAA+E,CAAC;AACnG,SAAS,SAAS,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,IAAY;IAC1C,OAAO,IAAI;SACT,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC5C,MAAM,CAAS;IACf,MAAM,CAAS;IAEf,YAAY,OAAe,EAAE,MAAc,EAAE,MAAc;QAC1D,IAAI,WAAW,GAAG,OAAO,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACZ,WAAW,IAAI,gBAAgB,MAAM,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACZ,WAAW,IAAI,gBAAgB,MAAM,EAAE,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD;AAuBD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAChC,IAAI,EACJ,GAAG,EACH,iBAAiB,EACjB,MAAM,EACN,aAAa,EACb,SAAS,EACT,KAAK,GACoB;IACzB,MAAM,YAAY,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,cAAc,CAAC;IAC/B,MAAM,WAAW,GAChB,OAAO,KAAK,KAAK;QAChB,CAAC,CAAC,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC,kBAAkB,EAAE,kDAAkD,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IACpG,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE;QACxC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE;QAC/B,wFAAwF;QACxF,0FAA0F;QAC1F,yFAAyF;QACzF,+EAA+E;QAC/E,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;KACtC,CAAC,CAAC;IAEH,8FAA8F;IAC9F,qEAAqE;IACrE,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEzB,IAAI,YAAqC,CAAC;IAC1C,IAAI,YAAqC,CAAC;IAC1C,IAAI,MAAM,EAAE,CAAC;QACZ,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QAC7D,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,aAAa,GAAG,SAAS,IAAI,0BAA0B,CAAC;IAC9D,MAAM,YAAY,GAAG,KAAK,IAAI,sBAAsB,CAAC;IAErD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,SAAyB,CAAC;QAC9B,IAAI,QAAwB,CAAC;QAE7B,MAAM,WAAW,GAAG,GAAG,EAAE;YACxB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,YAAY,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,EAAE;YACvC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,WAAW,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACxD,0FAA0F;YAC1F,wFAAwF;YACxF,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnC,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,WAAW,EAAE,CAAC;YACd,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,0FAA0F;QAC1F,2FAA2F;QAC3F,MAAM,cAAc,GAAG,GAAG,EAAE;YAC3B,IAAI,OAAO;gBAAE,OAAO;YACpB,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,UAAU,CACrB,GAAG,EAAE,CAAC,WAAW,CAAC,yCAAyC,aAAa,yCAAyC,CAAC,EAClH,aAAa,CACb,CAAC;QACH,CAAC,CAAC;QAEF,mDAAmD;QACnD,QAAQ,GAAG,UAAU,CACpB,GAAG,EAAE,CAAC,WAAW,CAAC,kEAAkE,YAAY,IAAI,CAAC,EACrG,YAAY,CACZ,CAAC;QACF,cAAc,EAAE,CAAC;QAEjB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACxC,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9C,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAChC,iFAAiF;YACjF,kFAAkF;YAClF,uCAAuC;YACvC,IAAI,OAAO;gBAAE,OAAO;YACpB,cAAc,EAAE,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC;YACrB,sFAAsF;YACtF,uCAAuC;YACvC,IAAI,iBAAiB,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAC7D,OAAO,EAAE,CAAC;YACX,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACxC,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9C,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAChC,IAAI,OAAO;gBAAE,OAAO;YACpB,cAAc,EAAE,CAAC;YACjB,MAAM,IAAI,UAAU,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,WAAW,EAAE,CAAC;YACd,4FAA4F;YAC5F,YAAY,EAAE,GAAG,EAAE,CAAC;YACpB,YAAY,EAAE,GAAG,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE;YACtC,WAAW,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,CAAC;gBACd,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;oBACtB,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC5C,CAAC;qBAAM,CAAC;oBACP,MAAM,YAAY,GAAG,+CAA+C,UAAU,IAAI,MAAM,EAAE,CAAC;oBAC3F,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;oBAClC,MAAM,CAAC,IAAI,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC9D,CAAC;YACF,CAAC;YACD,YAAY,EAAE,GAAG,EAAE,CAAC;YACpB,YAAY,EAAE,GAAG,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,GAAsB,EACtB,WAAmB,EACnB,OAA4B;IAE5B,MAAM,iBAAiB,GAAG,IAAI,CAC7B,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,MAAM,EAAE,EAClE,0BAA0B,CAC1B,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACtH,GAAG,CAAC,MAAM,GAAG,EAAE,WAAW,EAAE,CAAC;IAC7B,OAAO,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAsB,EAAE,OAA4B;IACrF,MAAM,iBAAiB,GAAG,IAAI,CAC7B,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,MAAM,EAAE,EAClE,0BAA0B,CAC1B,CAAC;IACF,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAElF,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,MAAM,+BAA+B,EAAE,CAAC,CAAC;IAE1F,oFAAoF;IACpF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC;IAC9D,IAAI,MAA0B,CAAC;IAC/B,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjE,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,IAAI,qBAAqB,CAAC,eAAe,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;QAChG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,wFAAwF;QACxF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,qBAAqB,IAAI,MAAM,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,uFAAuF;IACvF,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;IACtC,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,GAAG;QACZ,cAAc,WAAW,EAAE;QAC3B,sCAAsC;QACtC,wBAAwB,sBAAsB,EAAE;QAChD,wBAAwB,sBAAsB,EAAE;QAChD,mBAAmB;QACnB,uBAAuB;QACvB,mBAAmB,eAAe,EAAE;QACpC,eAAe,eAAe,IAAI,SAAS,EAAE;QAC7C,gCAAgC,eAAe,IAAI,mBAAmB,EAAE;QACxE,uBAAuB,eAAe,IAAI,SAAS,EAAE;QACrD,6BAA6B,eAAe,IAAI,UAAU,EAAE;QAC5D,uBAAuB;QACvB,4BAA4B;KAC5B,CAAC;IAEF,yEAAyE;IACzE,IAAI,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;QACrF,IAAI,CAAC,IAAI,CAAC,qBAAqB,eAAe,IAAI,UAAU,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,8EAA8E;IAC9E,4EAA4E;IAC5E,MAAM,SAAS,GAAG;QACjB,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACzC,GAAG,OAAO,EAAE,GAAG;KACf,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;QACrC,IAAI;QACJ,GAAG,EAAE,SAAS;QACd,iBAAiB,EAAE,sBAAsB;QACzC,MAAM;QACN,aAAa,EAAE,OAAO,EAAE,aAAa;QACrC,SAAS,EAAE,OAAO,EAAE,gBAAgB;QACpC,KAAK,EAAE,OAAO,EAAE,YAAY;KAC5B,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,GAAG;QACZ,WAAW;QACX,KAAK,EAAE;YACN,QAAQ,EAAE,sBAAsB;YAChC,QAAQ,EAAE,sBAAsB;SAChC;QACD,OAAO,EAAE,UAAU,eAAe,IAAI,SAAS,EAAE;QACjD,gBAAgB,EAAE,UAAU,eAAe,IAAI,mBAAmB,EAAE;QACpE,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM;QACN,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;KAC/D,CAAC;IAEF,OAAO,GAA+B,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,gBAAgB,CAAC,IAAkB,EAAE,MAA6B;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO;IAC9B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC;YACJ,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC;gBACJ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACR,uBAAuB;YACxB,CAAC;QACF,CAAC;QACD,OAAO;IACR,CAAC;IACD,IAAI,CAAC;QACJ,4FAA4F;QAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACR,2FAA2F;QAC3F,IAAI,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACR,uBAAuB;QACxB,CAAC;IACF,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAgB,CAAC;AACpD,IAAI,uBAAuB,GAAG,KAAK,CAAC;AAEpC,SAAS,kBAAkB,CAAC,IAAkB;IAC7C,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAE1D,IAAI,uBAAuB;QAAE,OAAO;IACpC,uBAAuB,GAAG,IAAI,CAAC;IAE/B,MAAM,OAAO,GAAG,GAAG,EAAE;QACpB,KAAK,MAAM,KAAK,IAAI,mBAAmB;YAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC7E,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,iGAAiG;IACjG,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACzB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAA6B,EAAE,OAA8B;IAC7F,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,kCAAkC;IAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO;IAE/D,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,yBAAyB,CAAC;IAE9D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,IAAI,YAA4B,CAAC;QACjC,IAAI,aAA6B,CAAC;QAElC,MAAM,MAAM,GAAG,GAAG,EAAE;YACnB,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACzB,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3B,YAAY,CAAC,aAAa,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC;QACX,CAAC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE1B,wDAAwD;QACxD,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAElC,4FAA4F;QAC5F,0EAA0E;QAC1E,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAClC,aAAa,GAAG,UAAU,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAC1D,CAAC,EAAE,OAAO,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAA6B;IACjE,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO;IACxB,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IAEtB,2FAA2F;IAC3F,4FAA4F;IAC5F,4FAA4F;IAC5F,6FAA6F;IAC7F,2FAA2F;IAC3F,kCAAkC;IAClC,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,+BAA+B,CAAC,CAAC;QAClH,IAAI,UAAU,EAAE,CAAC;YAChB,MAAM,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACP,oFAAoF;YACpF,mFAAmF;YACnF,uFAAuF;YACvF,qFAAqF;YACrF,uFAAuF;YACvF,iDAAiD;YACjD,OAAO,CAAC,IAAI,CACX,mBAAmB,GAAG,CAAC,MAAM,CAAC,QAAQ,iCAAiC,+BAA+B,wHAAwH,CAC9N,CAAC;QACH,CAAC;IACF,CAAC;IAED,4HAA4H;IAC5H,IAAI,CAAC;QACJ,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IAAC,OAAM,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAsB,EAAE,SAAc;IACzE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE;QACtD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;KAC/B,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC3C,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1D,OAAO,YAAY,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { startHarper, setupHarperWithFixture, killHarper, teardownHarper, sendOperation, createHarperContext, HarperStartupError, OPERATIONS_API_PORT, DEFAULT_ADMIN_USERNAME, DEFAULT_ADMIN_PASSWORD, DEFAULT_STARTUP_TIMEOUT_MS, HARPER_RUNTIME, type StartHarperOptions, type HarperContext, type HarperTestContext, type StartedHarperTestContext, type ContextWithHarper, } from './harperLifecycle.ts';
+export { validateLoopbackAddressPool, getNextAvailableLoopbackAddress, releaseLoopbackAddress, releaseAllLoopbackAddressesForCurrentProcess, } from './loopbackAddressPool.ts';
+export { targz } from './targz.ts';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { startHarper, setupHarperWithFixture, killHarper, teardownHarper, sendOperation, createHarperContext, HarperStartupError, OPERATIONS_API_PORT, DEFAULT_ADMIN_USERNAME, DEFAULT_ADMIN_PASSWORD, DEFAULT_STARTUP_TIMEOUT_MS, HARPER_RUNTIME, } from "./harperLifecycle.js";
+export { validateLoopbackAddressPool, getNextAvailableLoopbackAddress, releaseLoopbackAddress, releaseAllLoopbackAddressesForCurrentProcess, } from "./loopbackAddressPool.js";
+export { targz } from "./targz.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,EACX,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,GAMd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACN,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,4CAA4C,GAC5C,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}