@alchemy.run/test 0.0.0-stage → 2.0.0-beta.85

package/lib/Api.js

@@ -0,0 +1,245 @@
+/**
+ * The vitest-compatible registration API: `describe`, `it`/`test`, hooks and
+ * `layer`. Registration builds the {@link Model} tree; execution is the
+ * runner's job. Everything is Effect-first — plain-function tests are wrapped
+ * into Effects at registration time.
+ */
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Layer from "effect/Layer";
+import * as Scope from "effect/Scope";
+import * as TestClock from "effect/testing/TestClock";
+import * as TestConsole from "effect/testing/TestConsole";
+import { makeSuite } from "./Model.js";
+import { currentFileSuite, currentSuite, withSuite } from "./Registry.js";
+import { mergeTags } from "./Tags.js";
+export const timeoutOf = (options) => typeof options === "number" ? options : options?.timeout;
+export const retryOf = (options) => typeof options === "object" && options !== null ? options.retry : undefined;
+export const exclusiveOf = (options) => typeof options === "object" && options !== null ? (options.exclusive ?? false) : false;
+export const tagsOf = (options) => typeof options === "object" ? options?.tags : undefined;
+export const optInTagsOf = (options) => typeof options === "object" ? options?.optInTags : undefined;
+const makeDescribe = (config) => {
+    const fn = (nameOrBody, second, third) => {
+        // Normalize the vitest signatures:
+        //   describe(name, body)
+        //   describe(name, body, timeout)
+        //   describe(name, options, body)
+        //   describe(body)                    (via describe.skipIf(...)(() => {}))
+        let name;
+        let body;
+        let sequential = config.sequential;
+        let tags;
+        let optInTags;
+        if (typeof nameOrBody === "function") {
+            name = "";
+            body = nameOrBody;
+        }
+        else {
+            name = nameOrBody;
+            if (typeof second === "function") {
+                body = second;
+            }
+            else if (typeof second === "object" && second !== null) {
+                tags = second.tags;
+                optInTags = second.optInTags;
+                if (second.concurrent === true || second.sequential === false) {
+                    sequential = false;
+                }
+                else if (second.concurrent === false || second.sequential === true) {
+                    sequential = true;
+                }
+                body = typeof third === "function" ? third : undefined;
+            }
+            else {
+                body = typeof third === "function" ? third : undefined;
+            }
+        }
+        const parent = currentSuite();
+        const suite = makeSuite(name, parent, config.mode, tags, optInTags);
+        suite.sequential = sequential;
+        parent.children.push(suite);
+        // `describe.skip` still collects its children (they're reported as
+        // skipped, matching vitest); only `todo` suites skip collection.
+        if (body !== undefined && config.mode !== "todo") {
+            withSuite(suite, body);
+        }
+    };
+    const withMethods = Object.assign(fn, {
+        each: (cases) => (name, eachBody, options) => {
+            cases.forEach((args, index) => {
+                fn(formatEachName(name, args, index), { tags: tagsOf(options), optInTags: optInTagsOf(options) }, () => eachBody(args));
+            });
+        },
+        skipIf: (condition) => makeDescribe(condition ? { ...config, mode: "skip" } : config),
+        runIf: (condition) => makeDescribe(condition ? config : { ...config, mode: "skip" }),
+    });
+    // Lazy getters — Object.assign would evaluate them eagerly and recurse
+    // forever (each modifier constructs another DescribeFn).
+    Object.defineProperties(withMethods, {
+        sequential: { get: () => makeDescribe({ ...config, sequential: true }) },
+        concurrent: { get: () => makeDescribe({ ...config, sequential: false }) },
+        skip: { get: () => makeDescribe({ ...config, mode: "skip" }) },
+        only: { get: () => makeDescribe({ ...config, mode: "only" }) },
+        todo: { get: () => makeDescribe({ ...config, mode: "todo" }) },
+    });
+    return withMethods;
+};
+export const describe = makeDescribe({
+    mode: "run",
+    sequential: true,
+});
+/** Low-level test registration — used by adapters (e.g. alchemy Test.make). */
+export const registerTest = (options) => {
+    const parent = currentSuite();
+    parent.children.push({
+        type: "test",
+        name: options.name,
+        tags: mergeTags(parent.tags, options.tags),
+        optInTags: mergeTags(parent.optInTags, options.optInTags),
+        mode: options.mode,
+        fails: options.fails ?? false,
+        exclusive: options.exclusive ?? false,
+        retry: options.retry,
+        timeout: options.timeout,
+        body: options.body,
+        parent,
+    });
+};
+/** Wrap a plain (sync or async) test function into a self-contained Effect. */
+const fromFn = (fn) => () => Effect.promise(async () => {
+    await fn(emptyContext);
+});
+const emptyContext = {};
+// ---------------------------------------------------------------------------
+// Effect testers (it.effect / it.live)
+// ---------------------------------------------------------------------------
+/**
+ * The environment `it.effect` provides, matching @effect/vitest: a TestClock
+ * and a TestConsole on top of a per-test Scope.
+ */
+const TestEnv = Layer.mergeAll(TestConsole.layer, TestClock.layer());
+export const makeTester = (mapEffect) => {
+    const register = (name, self, options, overrides) => registerTest({
+        name,
+        mode: "run",
+        timeout: timeoutOf(options),
+        tags: tagsOf(options),
+        optInTags: optInTagsOf(options),
+        retry: retryOf(options),
+        exclusive: exclusiveOf(options),
+        body: () => mapEffect(Effect.suspend(() => self(emptyContext))),
+        ...overrides,
+    });
+    const fn = ((name, self, options) => register(name, self, options));
+    return Object.assign(fn, {
+        skip: (name, self, options) => register(name, self, options, { mode: "skip" }),
+        skipIf: (condition) => (name, self, options) => register(name, self, options, { mode: condition ? "skip" : "run" }),
+        runIf: (condition) => (name, self, options) => register(name, self, options, { mode: condition ? "run" : "skip" }),
+        only: (name, self, options) => register(name, self, options, { mode: "only" }),
+        fails: (name, self, options) => register(name, self, options, { fails: true }),
+        each: (cases) => (name, self, options) => {
+            cases.forEach((args, index) => {
+                register(formatEachName(name, args, index), () => self(args), options);
+            });
+        },
+    });
+};
+const formatEachName = (name, args, index) => {
+    let out = name;
+    // `$prop` templating (vitest): "Container (dev: $dev)"
+    if (out.includes("$") && typeof args === "object" && args !== null) {
+        out = out.replace(/\$([a-zA-Z_$][\w.$]*)/g, (match, path) => {
+            const value = path
+                .split(".")
+                .reduce((acc, key) => acc !== null && typeof acc === "object"
+                ? acc[key]
+                : undefined, args);
+            return value === undefined ? match : String(value);
+        });
+    }
+    // printf-style templating: "adds %s"
+    if (out.includes("%")) {
+        out = out.replace(/%[sdifjo#]/g, () => typeof args === "object" ? JSON.stringify(args) : String(args));
+    }
+    return out === name ? `${name} [${index}]` : out;
+};
+const registerFnTest = (name, fn, options, mode, fails = false) => registerTest({
+    name,
+    mode: fn === undefined ? "todo" : mode,
+    fails,
+    timeout: timeoutOf(options),
+    tags: tagsOf(options),
+    optInTags: optInTagsOf(options),
+    retry: retryOf(options),
+    exclusive: exclusiveOf(options),
+    body: fn === undefined ? undefined : fromFn(fn),
+});
+const makeTestFn = () => {
+    const fn = ((name, body, options) => registerFnTest(name, body, options, "run"));
+    return Object.assign(fn, {
+        skip: (name, body, options) => registerFnTest(name, body, options, "skip"),
+        only: (name, body, options) => registerFnTest(name, body, options, "only"),
+        todo: (name, body, options) => registerFnTest(name, body, options, "todo"),
+        fails: (name, body, options) => registerFnTest(name, body, options, "run", true),
+        skipIf: (condition) => (name, body, options) => registerFnTest(name, body, options, condition ? "skip" : "run"),
+        runIf: (condition) => (name, body, options) => registerFnTest(name, body, options, condition ? "run" : "skip"),
+        each: (cases) => (name, body, options) => {
+            cases.forEach((args, index) => {
+                registerFnTest(formatEachName(name, args, index), () => body(args), options, "run");
+            });
+        },
+        effect: makeTester((self) => self.pipe(Effect.scoped, Effect.provide(TestEnv))),
+        live: makeTester((self) => Effect.scoped(self)),
+    });
+};
+export const it = makeTestFn();
+export const test = it;
+/** Framework cleanup after user teardown, including files with no runnable tests. */
+export const registerFileCleanup = (hook) => {
+    currentFileSuite().cleanups.push(hook);
+};
+/** Low-level hook registration with an Effect body — used by adapters. */
+export const registerHook = (kind, hook) => {
+    currentSuite()[kind].push(hook);
+};
+const hookFromFn = (fn) => () => Effect.promise(async () => {
+    await fn();
+});
+export const beforeAll = (fn, timeout) => registerHook("beforeAll", { body: hookFromFn(fn), timeout });
+export const afterAll = (fn, timeout) => registerHook("afterAll", { body: hookFromFn(fn), timeout });
+export const beforeEach = (fn, timeout) => registerHook("beforeEach", { body: hookFromFn(fn), timeout });
+export const afterEach = (fn, timeout) => registerHook("afterEach", { body: hookFromFn(fn), timeout });
+export const layer = (layer_, options) => (...args) => {
+    const excludeTestServices = options?.excludeTestServices ?? false;
+    const withTestEnv = excludeTestServices
+        ? layer_
+        : Layer.provideMerge(layer_, TestEnv);
+    const memoMap = options?.memoMap ?? Effect.runSync(Layer.makeMemoMap);
+    const scope = Scope.makeUnsafe();
+    const contextEffect = Layer.buildWithMemoMap(withTestEnv, memoMap, scope).pipe(Effect.orDie, Effect.cached, Effect.runSync);
+    const makeMethods = () => ({
+        effect: makeTester((self) => Effect.flatMap(contextEffect, (context) => self.pipe(Effect.scoped, Effect.provide(context)))),
+        layer: (nested, nestedOptions) => layer(Layer.provideMerge(nested, withTestEnv), {
+            ...nestedOptions,
+            memoMap: Layer.forkMemoMapUnsafe(memoMap),
+            excludeTestServices,
+        }),
+    });
+    const register = () => {
+        const cleanup = {
+            body: () => Scope.close(scope, Exit.void),
+            timeout: options?.timeout,
+        };
+        registerHook("afterAll", cleanup);
+        registerFileCleanup(cleanup);
+        const f = (args.length === 1 ? args[0] : args[1]);
+        f(makeMethods());
+    };
+    if (args.length === 2) {
+        describe(args[0], register);
+    }
+    else {
+        register();
+    }
+};
+//# sourceMappingURL=Api.js.map

package/lib/Api.js.map

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

package/lib/Bun.d.ts

@@ -0,0 +1,67 @@
+/** @effect-diagnostics anyUnknownInErrorContext:off */
+import bun from "bun:test";
+import type { HookOptions } from "node:test";
+import type { StackDefinition } from "alchemy/Stack";
+import * as Effect from "effect/Effect";
+import * as Core from "./Core.ts";
+export { executeWhenReady, getWhenReady, guardContentType, guardedFetchLayer, rpcClientLayer, WorkerNotReady, type EdgeGuardOptions, type WhenReadyOptions, } from "./Http.ts";
+export type MakeOptions<ROut = any> = Core.MakeOptions<ROut>;
+export type ScratchStack = Core.ScratchStack;
+export type TestEffect<A, R = never> = Core.TestEffect<A, R>;
+export declare const defaultStage: typeof Core.defaultStage;
+export declare const resolveStage: typeof Core.resolveStage;
+export interface TestApi {
+    test: TestFn;
+    beforeAll: BeforeAllFn;
+    beforeEach: BeforeEachFn;
+    afterAll: AfterAllFn;
+    afterEach: AfterEachFn;
+    deploy: Core.Deploy;
+    destroy: <ROut>(stack: StackDefinition<ROut>, options?: {
+        stage?: string;
+        include?: never;
+        exclude?: never;
+    }) => ReturnType<typeof Core.destroy>;
+}
+interface TestFn {
+    (name: string, eff: TestEffect<void>, options?: bun.TestOptions): void;
+    skip: (name: string, eff: TestEffect<void>, options?: bun.TestOptions) => void;
+    skipIf: (condition: boolean) => (name: string, eff: TestEffect<void>, options?: bun.TestOptions) => void;
+    only: (name: string, eff: TestEffect<void>, options?: bun.TestOptions) => void;
+    todo: (name: string, eff: TestEffect<void>, options?: bun.TestOptions) => void;
+    provider: ProviderFn;
+}
+interface ProviderFn {
+    (name: string, fn: (stack: ScratchStack) => Effect.Effect<void, any, any>, options?: bun.TestOptions): void;
+    skip: (name: string, fn: (stack: ScratchStack) => Effect.Effect<void, any, any>, options?: bun.TestOptions) => void;
+    skipIf: (condition: boolean) => (name: string, fn: (stack: ScratchStack) => Effect.Effect<void, any, any>, options?: bun.TestOptions) => void;
+}
+interface BeforeAllFn {
+    <A>(eff: TestEffect<A>, options?: HookOptions): Effect.Effect<A>;
+}
+interface BeforeEachFn {
+    (eff: TestEffect<void>, options?: HookOptions): void;
+}
+interface AfterAllFn {
+    (eff: TestEffect<any>, options?: HookOptions): void;
+    skipIf: (predicate: boolean) => (eff: TestEffect<any>, options?: HookOptions) => void;
+}
+interface AfterEachFn {
+    (eff: TestEffect<void>, options?: HookOptions): void;
+}
+/**
+ * Build the per-file test API. Configure providers / state once at the top of
+ * the test file:
+ *
+ * ```ts
+ * import * as Test from "@alchemy.run/test/Bun";
+ * import * as Cloudflare from "@alchemy.run/cloudflare";
+ *
+ * const { test, deploy, destroy, beforeAll, afterAll } = Test.make({
+ *   providers: Cloudflare.providers(),
+ *   state: Cloudflare.state(),
+ * });
+ * ```
+ */
+export declare const make: <ROut = any>(options: MakeOptions<ROut>) => TestApi;
+//# sourceMappingURL=Bun.d.ts.map

package/lib/Bun.d.ts.map

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

package/lib/Bun.js

@@ -0,0 +1,143 @@
+/** @effect-diagnostics anyUnknownInErrorContext:off */
+import bun from "bun:test";
+import * as Cause from "effect/Cause";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Scope from "effect/Scope";
+import * as Core from "./Core.js";
+export { executeWhenReady, getWhenReady, guardContentType, guardedFetchLayer, rpcClientLayer, WorkerNotReady, } from "./Http.js";
+export const defaultStage = Core.defaultStage;
+export const resolveStage = Core.resolveStage;
+const DEFAULT_HOOK_TIMEOUT = { timeout: 120_000 };
+/** The timeout bun applies to a test, from its options. */
+const timeoutOf = (options) => typeof options === "number" ? options : options?.timeout;
+/**
+ * Interrupt `eff` shortly before bun's own timeout. When bun times a test or
+ * hook out it only stops waiting: the effect keeps running, so the file's
+ * `afterAll` destroy races a deploy still creating resources, and whatever
+ * that deploy creates afterwards is never cleaned up. Interrupting it first
+ * lets the engine record what it created, so the destroy that follows finds
+ * it.
+ */
+const DEADLINE_MARGIN_MS = 5_000;
+const withDeadline = (eff, timeout) => timeout === undefined || timeout <= DEADLINE_MARGIN_MS * 2
+    ? eff
+    : eff.pipe(Effect.timeout(Duration.millis(timeout - DEADLINE_MARGIN_MS)));
+/**
+ * Build the per-file test API. Configure providers / state once at the top of
+ * the test file:
+ *
+ * ```ts
+ * import * as Test from "@alchemy.run/test/Bun";
+ * import * as Cloudflare from "@alchemy.run/cloudflare";
+ *
+ * const { test, deploy, destroy, beforeAll, afterAll } = Test.make({
+ *   providers: Cloudflare.providers(),
+ *   state: Cloudflare.state(),
+ * });
+ * ```
+ */
+export const make = (options) => {
+    // Single scope shared across `beforeAll`, every `test`, and `afterAll`.
+    // Scoped resources in dev mode (the Cloudflare sidecar process and its
+    // workerd children) must outlive a single `Effect.runPromise` boundary,
+    // otherwise the proxy is killed the moment `beforeAll(deploy(Stack))`
+    // resolves and every later `HttpClient.get(workerUrl)` hits a dead port.
+    // The scope is closed by `destroy(...)` (or never — the next test run
+    // reclaims any leaked sidecar via the lock file).
+    const sharedScope = Scope.makeUnsafe("sequential");
+    // In dev mode, run local providers behind one file-scoped RPC sidecar
+    // (the `alchemy dev` topology). Lives in its own scope — NOT sharedScope,
+    // which `destroy(Stack)` closes mid-file in self-contained tests — and is
+    // closed by the fallback afterAll below.
+    const sidecar = Core.makeSidecarHandle(options);
+    const runEff = (eff, timeout) => Core.run(withDeadline(eff, timeout), options, sharedScope, sidecar);
+    const test = ((name, eff, opts) => {
+        bun.test(name, () => runEff(eff, timeoutOf(opts)), opts);
+    });
+    test.skip = (name, eff, opts) => {
+        bun.test.skip(name, () => runEff(eff, timeoutOf(opts)), opts);
+    };
+    test.skipIf = (condition) => (name, eff, opts) => {
+        bun.test.skipIf(condition)(name, () => runEff(eff, timeoutOf(opts)), opts);
+    };
+    test.only = (name, eff, opts) => {
+        bun.test.only(name, () => runEff(eff, timeoutOf(opts)), opts);
+    };
+    test.todo = (name, eff, opts) => {
+        bun.test.todo(name, () => runEff(eff, timeoutOf(opts)), opts);
+    };
+    const runProvider = (name, fn, timeout) => {
+        const scratch = Core.scratchStack(options, name);
+        return Core.run(withDeadline(Core.withProviders(fn(scratch), options, scratch.name), timeout), { ...options, state: scratch.state }, sharedScope, sidecar);
+    };
+    const provider = ((name, fn, opts) => {
+        bun.test(name, () => runProvider(name, fn, timeoutOf(opts)), opts);
+    });
+    provider.skip = (name, fn, opts) => {
+        bun.test.skip(name, () => runProvider(name, fn, timeoutOf(opts)), opts);
+    };
+    provider.skipIf = (condition) => (name, fn, opts) => {
+        bun.test.skipIf(condition)(name, () => runProvider(name, fn, timeoutOf(opts)), opts);
+    };
+    test.provider = provider;
+    const beforeAll = (eff, hookOptions) => {
+        let result;
+        const options = hookOptions ?? DEFAULT_HOOK_TIMEOUT;
+        bun.beforeAll(() => runEff(eff, options.timeout).then((v) => (result = v)), options);
+        return Effect.sync(() => result);
+    };
+    const beforeEach = (eff, hookOptions) => {
+        bun.beforeEach(() => runEff(eff), hookOptions);
+    };
+    // bun:test stops running later `afterAll` hooks once one throws, which
+    // would skip the fallback cleanup hook below — leaking the shared scope
+    // and the sidecar for the rest of the process whenever a teardown
+    // assertion fails. Guard every user teardown: on failure, run the
+    // (idempotent) cleanup before rethrowing so the failure still fails the
+    // suite. (`closeAll` is initialized below; hooks only run after `make`
+    // returns.)
+    const guardTeardown = (eff) => () => runEff(eff).catch(async (error) => {
+        await Effect.runPromise(closeAll);
+        throw error;
+    });
+    const afterAll = ((eff, hookOptions) => {
+        bun.afterAll(guardTeardown(eff), hookOptions ?? DEFAULT_HOOK_TIMEOUT);
+    });
+    afterAll.skipIf = (predicate) => (eff, hookOptions) => {
+        if (predicate)
+            return;
+        bun.afterAll(guardTeardown(eff), hookOptions ?? DEFAULT_HOOK_TIMEOUT);
+    };
+    const afterEach = (eff, hookOptions) => {
+        bun.afterEach(() => runEff(eff), hookOptions);
+    };
+    // `destroy(Stack)` needs the dev sidecar alive so it can call `sidecar.stop`
+    // for each worker. We close the shared scope only AFTER destroy completes.
+    // `Scope.close` on an already-closed scope is a no-op, so it's safe for both
+    // the destroy wrapper AND the fallback cleanup hook below to call it.
+    const closeScope = Effect.suspend(() => Scope.close(sharedScope, Exit.void)).pipe(Effect.ignore);
+    // Fallback cleanup: if the user never calls `destroy(Stack)` (e.g.
+    // `NO_DESTROY=1`), nothing else closes the shared scope and the sidecar
+    // child process leaks past the test process. Register an `afterAll` that
+    // closes it (and the RPC sidecar, which lives in its own scope so that
+    // mid-file `destroy(Stack)` calls can't kill it for later tests). We defer
+    // registration to a microtask so it runs AFTER any user-registered
+    // `afterAll` (including `destroy(Stack)`); bun runs afterAll hooks in
+    // registration order.
+    const closeAll = sidecar ? Effect.andThen(closeScope, sidecar.close) : closeScope;
+    queueMicrotask(() => {
+        bun.afterAll(() => Effect.runPromise(closeAll), DEFAULT_HOOK_TIMEOUT);
+    });
+    return {
+        test,
+        beforeAll,
+        beforeEach,
+        afterAll,
+        afterEach,
+        deploy: Core.makeDeploy(options, sharedScope),
+        destroy: (stack, callOpts) => Core.destroy(options, stack, { ...callOpts, scope: sharedScope }).pipe(Effect.ensuring(closeScope)),
+    };
+};
+//# sourceMappingURL=Bun.js.map

package/lib/Bun.js.map

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

package/lib/Capture.d.ts

@@ -0,0 +1,10 @@
+import type { LogEntry } from "./Model.ts";
+/** Bounded live previews; every original entry is persisted before trimming. */
+export declare const makeCapture: (limits?: {
+    capture: number;
+    total: number;
+}) => {
+    create: (persist: (entry: LogEntry) => void) => Array<LogEntry>;
+    release: (buffer: Array<LogEntry>) => void;
+};
+//# sourceMappingURL=Capture.d.ts.map

package/lib/Capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Capture.d.ts","sourceRoot":"","sources":["../src/Capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,gFAAgF;AAChF,eAAO,MAAM,WAAW;IAAe,OAAO;IAAiB,KAAK;;sBAgCzC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,KAAG,KAAK,CAAC,QAAQ,CAAC;sBA5B3C,KAAK,CAAC,QAAQ,CAAC;CA4DzC,CAAC"}

package/lib/Capture.js

@@ -0,0 +1,68 @@
+const CAPTURE_BYTES = 256 * 1024;
+const TOTAL_BYTES = 16 * 1024 * 1024;
+const TRUNCATED = "[Earlier output omitted from preview; full output is in the run log.]";
+/** Bounded live previews; every original entry is persisted before trimming. */
+export const makeCapture = (limits = { capture: CAPTURE_BYTES, total: TOTAL_BYTES }) => {
+    const buffers = new Map();
+    let total = 0;
+    const size = (entry) => Buffer.byteLength(entry.message, "utf8") + 64;
+    const release = (buffer) => {
+        total -= buffers.get(buffer) ?? 0;
+        buffers.delete(buffer);
+        buffer.length = 0;
+    };
+    const trim = (buffer, limit) => {
+        let bytes = buffers.get(buffer) ?? 0;
+        let removed = false;
+        while (bytes > limit && buffer.length > 0) {
+            const entry = buffer.shift();
+            const cost = size(entry);
+            bytes -= cost;
+            total -= cost;
+            removed = true;
+        }
+        if (removed && buffer.length > 0 && buffer[0].message !== TRUNCATED) {
+            const entry = {
+                level: "info",
+                message: TRUNCATED,
+                time: buffer[0].time,
+            };
+            buffer.unshift(entry);
+            bytes += size(entry);
+            total += size(entry);
+        }
+        if (bytes === 0)
+            buffers.delete(buffer);
+        else
+            buffers.set(buffer, bytes);
+    };
+    const create = (persist) => {
+        const buffer = [];
+        buffer.push = (...entries) => {
+            for (const entry of entries) {
+                persist(entry);
+                // A single oversized message must not defeat either preview limit.
+                const maxChars = Math.max(0, Math.floor((Math.min(limits.capture, limits.total) - 256) / 4));
+                const preview = entry.message.length > maxChars
+                    ? {
+                        ...entry,
+                        message: `${TRUNCATED}\n${maxChars === 0 ? "" : entry.message.slice(-maxChars)}`,
+                    }
+                    : entry;
+                Array.prototype.push.call(buffer, preview);
+                const cost = size(preview);
+                buffers.set(buffer, (buffers.get(buffer) ?? 0) + cost);
+                total += cost;
+                trim(buffer, Math.max(0, limits.capture - 256));
+                while (total > limits.total && buffers.size > 0) {
+                    const oldest = buffers.keys().next().value;
+                    release(oldest);
+                }
+            }
+            return buffer.length;
+        };
+        return buffer;
+    };
+    return { create, release };
+};
+//# sourceMappingURL=Capture.js.map

package/lib/Capture.js.map

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