@alchemy.run/test 0.0.0 → 2.0.0-beta.86

package/lib/DevCli.js

@@ -0,0 +1,181 @@
+import { spawn, spawnSync } from "node:child_process";
+import * as path from "node:path";
+export const pollUntil = async (what, effect, options = {}) => {
+    const { tries = 30, delayMs = 1_000, diagnostics, abandonIf } = options;
+    for (let attempt = 0; attempt < tries; attempt++) {
+        const value = await effect();
+        if (value !== undefined)
+            return value;
+        const reason = abandonIf?.();
+        if (reason !== undefined) {
+            const detail = diagnostics?.();
+            throw new Error(`Gave up waiting for ${what}: ${reason}.${detail ? `\n${detail}` : ""}`);
+        }
+        await Bun.sleep(delayMs);
+    }
+    const detail = diagnostics?.();
+    throw new Error(`Timed out waiting for ${what}.${detail ? `\n${detail}` : ""}`);
+};
+export async function fetchOk(url, initOrOptions = {}, explicitOptions) {
+    const optionsOnly = explicitOptions === undefined && ("tries" in initOrOptions || "delayMs" in initOrOptions);
+    const init = optionsOnly ? undefined : initOrOptions;
+    const options = optionsOnly ? initOrOptions : (explicitOptions ?? {});
+    const { tries = 20, delayMs = 500 } = options;
+    let last;
+    for (let attempt = 0; attempt < tries; attempt++) {
+        try {
+            last = await fetch(url, init);
+            if (last.ok)
+                return last;
+        }
+        catch {
+            // The dev endpoint may not be listening yet.
+        }
+        await Bun.sleep(delayMs);
+    }
+    throw new Error(`${init?.method ?? "GET"} ${url} never returned 2xx (last status: ${last?.status})`);
+}
+export const parseOutputUrl = (output, key) => {
+    const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return output.match(new RegExp(`\\b${escaped}(?:\\s*:\\s*|\\s+)['"]?(http[^\\s'",]+)['"]?(?=[\\s,}])`))?.[1];
+};
+export const parseOutputValue = (output, key) => {
+    const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return output.match(new RegExp(`\\b${escaped}(?:\\s*:\\s*|\\s+)['"]?([^\\s'",]+)`))?.[1];
+};
+/** Owns a real `alchemy dev` child and its complete detached process group. */
+export class DevCli {
+    root;
+    stage;
+    alchemyBin;
+    env;
+    #process;
+    #output = "";
+    constructor(options) {
+        this.root = options.root;
+        this.stage = options.stage ?? "dev-cli-test";
+        this.alchemyBin =
+            options.alchemyBin ?? path.join(this.root, "node_modules", "alchemy", "bin", "alchemy.js");
+        this.env = { ...process.env, ...options.env };
+    }
+    get output() {
+        return this.#output;
+    }
+    get outputTail() {
+        return `--- alchemy dev output (tail) ---\n${this.#output.slice(-4_000)}`;
+    }
+    start() {
+        if (this.#process !== undefined)
+            throw new Error("alchemy dev is running");
+        const child = spawn("bun", [this.alchemyBin, "dev", "--stage", this.stage], {
+            cwd: this.root,
+            detached: true,
+            env: this.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        this.#process = child;
+        forwardSignals(child);
+        const capture = (chunk) => {
+            const text = chunk.toString();
+            this.#output += text;
+            if (process.env.DEBUG)
+                process.stderr.write(text);
+        };
+        child.stdout.on("data", capture);
+        child.stderr.on("data", capture);
+    }
+    outputUrl(key) {
+        return parseOutputUrl(this.#output, key);
+    }
+    outputValue(key) {
+        return parseOutputValue(this.#output, key);
+    }
+    pollUntil(what, effect, options = {}) {
+        return pollUntil(what, effect, {
+            ...options,
+            diagnostics: () => this.outputTail,
+            // A dev child that died (crash, failed apply) never produces what we're
+            // waiting for — fail immediately with its output instead of sitting
+            // through the full poll budget.
+            abandonIf: () => {
+                const child = this.#process;
+                if (child === undefined)
+                    return "alchemy dev is not running";
+                if (child.exitCode !== null) {
+                    return `alchemy dev exited with code ${child.exitCode}`;
+                }
+                if (child.signalCode !== null) {
+                    return `alchemy dev was killed by ${child.signalCode}`;
+                }
+                return undefined;
+            },
+        });
+    }
+    outputUrlWhenReady(key, options) {
+        return this.pollUntil(`${key} url in stack outputs`, () => this.outputUrl(key), options);
+    }
+    async stop() {
+        const child = this.#process;
+        if (child?.pid === undefined)
+            return;
+        if (child.exitCode !== null || child.signalCode !== null) {
+            this.#process = undefined;
+            return;
+        }
+        const killGroup = (signal) => {
+            try {
+                process.kill(-child.pid, signal);
+            }
+            catch {
+                // The group has already exited.
+            }
+        };
+        const exited = new Promise((resolve) => child.once("exit", () => resolve()));
+        killGroup("SIGINT");
+        await Promise.race([exited, Bun.sleep(15_000)]);
+        if (child.exitCode === null && child.signalCode === null) {
+            killGroup("SIGKILL");
+            await Promise.race([exited, Bun.sleep(5_000)]);
+        }
+        this.#process = undefined;
+    }
+    destroy(options = {}) {
+        const result = spawnSync("bun", [this.alchemyBin, "destroy", "--stage", this.stage, "--yes"], {
+            cwd: this.root,
+            env: this.env,
+            stdio: "inherit",
+            timeout: options.timeout ?? 120_000,
+        });
+        if (result.error !== undefined)
+            throw result.error;
+        if (result.status !== 0) {
+            throw new Error(`alchemy destroy exited ${result.status ?? "by signal"}`);
+        }
+    }
+}
+/** Forward Ctrl-C to a detached CLI and let it finish its own cleanup. */
+export const forwardSignals = (child) => {
+    let interrupted;
+    const forward = (signal) => {
+        if (interrupted !== undefined)
+            return;
+        interrupted = signal;
+        child.kill(signal);
+    };
+    const removeListeners = () => {
+        process.off("SIGINT", forward);
+        process.off("SIGTERM", forward);
+    };
+    process.on("SIGINT", forward);
+    process.on("SIGTERM", forward);
+    child.once("error", removeListeners);
+    child.once("exit", () => {
+        removeListeners();
+        // Bun skips afterAll on Ctrl-C. Exit only after the CLI has shut down,
+        // without resuming the interrupted tests or starting the next command.
+        if (interrupted !== undefined) {
+            process.exit(interrupted === "SIGINT" ? 130 : 143);
+        }
+    });
+};
+//# sourceMappingURL=DevCli.js.map

package/lib/DevCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevCli.js","sources":["../src/DevCli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAqB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAOlC,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,IAAY,EACZ,MAAoD,EACpD,OAAO,GAQH,EAAE,EACM,EAAE;IACd,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,GAAG,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACxE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,MAAM,EAAE,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,MAAM,GAAG,SAAS,EAAE,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,WAAW,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,MAAM,GAAG,WAAW,EAAE,EAAE,CAAC;IAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClF,CAAC,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAiB,EACjB,aAAa,GAA8B,EAAE,EAC7C,eAA6B;IAE7B,MAAM,WAAW,GACf,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,IAAI,aAAa,IAAI,SAAS,IAAI,aAAa,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,aAA6B,CAAC;IACtE,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAE,aAA6B,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IACvF,MAAM,EAAE,KAAK,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAC9C,IAAI,IAA0B,CAAC;IAC/B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QACD,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,GAAG,qCAAqC,IAAI,EAAE,MAAM,GAAG,CACpF,CAAC;AACJ,CAAC;AASD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,GAAW,EAAsB,EAAE;IAChF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,KAAK,CACjB,IAAI,MAAM,CAAC,MAAM,OAAO,yDAAyD,CAAC,CACnF,EAAE,CAAC,CAAC,CAAC,CAAC;AACT,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAE,GAAW,EAAsB,EAAE;IAClF,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,OAAO,qCAAqC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3F,CAAC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,OAAO,MAAM;IACR,IAAI,CAAS;IACb,KAAK,CAAS;IACd,UAAU,CAAS;IACnB,GAAG,CAAoB;IAChC,QAAQ,CAAuC;IAC/C,OAAO,GAAG,EAAE,CAAC;IAEb,YAAY,OAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;QAC7C,IAAI,CAAC,UAAU;YACb,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAC7F,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,sCAAsC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;YAC1E,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,cAAc,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;YACrB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS,CACP,IAAY,EACZ,MAAoD,EACpD,OAAO,GAAgB,EAAE;QAEzB,OAAO,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE;YAC7B,GAAG,OAAO;YACV,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU;YAClC,wEAAwE;YACxE,oEAAoE;YACpE,gCAAgC;YAChC,SAAS,EAAE,GAAG,EAAE;gBACd,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAC5B,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO,4BAA4B,CAAC;gBAC7D,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;oBAC5B,OAAO,gCAAgC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC1D,CAAC;gBACD,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;oBAC9B,OAAO,6BAA6B,KAAK,CAAC,UAAU,EAAE,CAAC;gBACzD,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB,CAAC,GAAW,EAAE,OAAqB;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,uBAAuB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,KAAK,EAAE,GAAG,KAAK,SAAS;YAAE,OAAO;QACrC,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACzD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,MAAsB,EAAE,EAAE;YAC3C,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAI,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;QACH,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACnF,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACzD,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,OAAO,GAAkC,EAAE;QACjD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;YAC5F,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;SACpC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC;QACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAmB,EAAQ,EAAE;IAC1D,IAAI,WAAuC,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,MAAsB,EAAE,EAAE;QACzC,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO;QACtC,WAAW,GAAG,MAAM,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC,CAAC;IACF,MAAM,eAAe,GAAG,GAAG,EAAE;QAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,eAAe,EAAE,CAAC;QAClB,uEAAuE;QACvE,uEAAuE;QACvE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/lib/Expect.d.ts

@@ -0,0 +1,84 @@
+/**
+ * A from-scratch, dependency-free `expect` covering the matcher surface used
+ * by the alchemy test suite. Vitest-compatible semantics for:
+ *
+ * - equality: toBe, toEqual, toStrictEqual
+ * - presence: toBeDefined, toBeUndefined, toBeNull, toBeTruthy, toBeFalsy, toBeNaN
+ * - containers: toContain, toContainEqual, toHaveLength, toHaveProperty
+ * - strings: toMatch
+ * - objects: toMatchObject, toBeInstanceOf, toBeTypeOf
+ * - numbers: toBeGreaterThan(OrEqual), toBeLessThan(OrEqual), toBeCloseTo
+ * - misc: toSatisfy, toBeOneOf, toThrow / toThrowError
+ * - modifiers: .not, .resolves, .rejects
+ * - asymmetric: expect.any, expect.anything, expect.arrayContaining,
+ *   expect.objectContaining, expect.stringContaining, expect.stringMatching
+ * - expect.fail
+ *
+ * Assertion failures throw {@link AssertionError} (a plain Error subclass) so
+ * they propagate through Effect as defects and render with a clean message.
+ */
+export declare class AssertionError extends Error {
+    readonly actual?: unknown;
+    readonly expected?: unknown;
+    readonly name = "AssertionError";
+    constructor(message: string, actual?: unknown, expected?: unknown);
+}
+export declare const stringify: (value: unknown) => string;
+export declare const equals: (actual: unknown, expected: unknown, strict?: boolean) => boolean;
+export interface Matchers<A = unknown> {
+    toBe(expected: unknown): void;
+    toEqual(expected: unknown): void;
+    toStrictEqual(expected: unknown): void;
+    toBeDefined(): void;
+    toBeUndefined(): void;
+    toBeNull(): void;
+    toBeTruthy(): void;
+    toBeFalsy(): void;
+    toBeNaN(): void;
+    toContain(item: unknown): void;
+    toContainEqual(item: unknown): void;
+    toHaveLength(length: number): void;
+    toHaveProperty(path: string | Array<PropertyKey>, value?: unknown): void;
+    toMatch(pattern: string | RegExp): void;
+    toMatchObject(expected: object): void;
+    toThrow(expected?: string | RegExp | Error | (new (...args: Array<any>) => Error)): void;
+    toThrowError(expected?: string | RegExp | Error | (new (...args: Array<any>) => Error)): void;
+    toBeGreaterThan(expected: number | bigint): void;
+    toBeGreaterThanOrEqual(expected: number | bigint): void;
+    toBeLessThan(expected: number | bigint): void;
+    toBeLessThanOrEqual(expected: number | bigint): void;
+    toBeCloseTo(expected: number, precision?: number): void;
+    toBeInstanceOf(ctor: abstract new (...args: Array<any>) => unknown): void;
+    toBeTypeOf(type: "string" | "number" | "boolean" | "bigint" | "symbol" | "function" | "object" | "undefined"): void;
+    toSatisfy(predicate: (value: A) => boolean): void;
+    toBeOneOf(values: ReadonlyArray<unknown>): void;
+    readonly not: Matchers<A>;
+    readonly resolves: PromiseMatchers<A>;
+    readonly rejects: PromiseMatchers<A>;
+}
+export type PromiseMatchers<A> = {
+    readonly [K in Exclude<keyof Matchers<A>, "not" | "resolves" | "rejects">]: (...args: Parameters<Matchers<A>[K]>) => Promise<void>;
+} & {
+    readonly not: PromiseMatchers<A>;
+};
+export interface Expect {
+    <A>(actual: A, message?: string): Matchers<A>;
+    any(ctor: any): any;
+    anything(): any;
+    arrayContaining(items: ReadonlyArray<unknown>): any;
+    objectContaining(subset: Record<string, unknown>): any;
+    stringContaining(substring: string): any;
+    stringMatching(pattern: string | RegExp): any;
+    toSatisfy(predicate: (value: any) => boolean, description?: string): any;
+    fail(message?: string): never;
+}
+export declare const expect: Expect;
+export interface Assert {
+    (condition: unknown, message?: string): asserts condition;
+    strictEqual(actual: unknown, expected: unknown, message?: string): void;
+    deepStrictEqual(actual: unknown, expected: unknown, message?: string): void;
+    isDefined<A>(value: A): asserts value is NonNullable<A>;
+    fail(message?: string): never;
+}
+export declare const assert: Assert;
+//# sourceMappingURL=Expect.d.ts.map

package/lib/Expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Expect.d.ts","sources":["../src/Expect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,qBAAa,cAAe,SAAQ,KAAK;IAIrC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO;IAJ7B,SAAkB,IAAI,oBAAoB;IAC1C,YACE,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,OAAO,EAG5B;CACF;AAUD,eAAO,MAAM,SAAS,UAAW,OAAO,KAAG,MAS1C,CAAC;AA4GF,eAAO,MAAM,MAAM,WAAY,OAAO,YAAY,OAAO,uBAAmB,OACnC,CAAC;AAmJ1C,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,WAAW,IAAI,IAAI,CAAC;IACpB,aAAa,IAAI,IAAI,CAAC;IACtB,QAAQ,IAAI,IAAI,CAAC;IACjB,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,IAAI,IAAI,CAAC;IAClB,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC;IACzF,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC;IAC9F,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjD,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,cAAc,CAAC,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC;IAC1E,UAAU,CACR,IAAI,EACA,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,WAAW,GACd,IAAI,CAAC;IACR,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC;IAClD,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,QAAQ,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG,CAC1E,GAAG,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAChC,OAAO,CAAC,IAAI,CAAC;CACnB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC;AA4TzC,MAAM,WAAW,MAAM;IACrB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9C,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IACpB,QAAQ,IAAI,GAAG,CAAC;IAChB,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC;IACpD,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC;IACvD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IACzC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;IAC9C,SAAS,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACzE,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC/B;AAED,eAAO,MAAM,MAAM,EAAE,MAiCpB,CAAC;AAMF,MAAM,WAAW,MAAM;IACrB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAC1D,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxE,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5E,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC/B;AAQD,eAAO,MAAM,MAAM,EAAE,MA2BT,CAAC"}