flakelab 0.1.0

package/dist/solari/executor.js

@@ -0,0 +1,280 @@
+import { chromium } from "@playwright/test";
+import { Solari } from "@solarisdk/browser";
+import { SandboxClient } from "@solarisdk/sandbox";
+import { z } from "zod";
+import { createHash } from "node:crypto";
+import { setTimeout as delay } from "node:timers/promises";
+import { installFault } from "../faults/install.js";
+import { normalizeProviderError, ProviderFailure, solariResponseFailure, } from "../providers/errors.js";
+import { CHECKOUT_APP_DIRECTORY, CHECKOUT_PORT, checkoutServerSource, } from "./checkout-fixture.js";
+import { retryTransient } from "./retry.js";
+import { ResourceUsageTracker } from "./usage.js";
+import { SecureWebSocketProxy } from "./websocket-proxy.js";
+const SANDBOX_TIMEOUT_MS = 5 * 60_000;
+const PREVIEW_ATTEMPTS = 20;
+const rawSessionSchema = z.object({
+    sessionId: z.string().min(1),
+    cdpEndpoint: z.url(),
+});
+function fingerprint(value) {
+    return createHash("sha256").update(value).digest("hex").slice(0, 16);
+}
+function errorFingerprint(error) {
+    return fingerprint(`${error.name}:${error.message}`);
+}
+async function waitForPreview(url, signal) {
+    for (let attempt = 1; attempt <= PREVIEW_ATTEMPTS; attempt += 1) {
+        signal?.throwIfAborted();
+        try {
+            const response = await fetch(url, { signal });
+            if (response.ok) {
+                return;
+            }
+        }
+        catch (error) {
+            if (signal?.aborted) {
+                throw error;
+            }
+        }
+        await delay(500, undefined, { signal });
+    }
+    throw new Error("Solari preview did not become ready");
+}
+export class SolariParallelExecutor {
+    #browsers;
+    #options;
+    #sandboxes;
+    #tracker = new ResourceUsageTracker();
+    #liveBrowsers = new Map();
+    #liveSandboxes = new Map();
+    #previewUrl;
+    #snapshotId;
+    constructor(options) {
+        this.#options = options;
+        this.#sandboxes = new SandboxClient({ apiKey: options.apiKey, baseUrl: options.baseUrl });
+        this.#browsers = new Solari({ apiKey: options.apiKey, baseUrl: options.baseUrl });
+    }
+    async prepare() {
+        this.#options.signal?.throwIfAborted();
+        const cachedSnapshots = await retryTransient(async () => this.#sandboxes.listSnapshots({ template: "base", limit: 100 }), this.#retryOptions());
+        const cached = cachedSnapshots.snapshots.find((snapshot) => snapshot.kind === "sandbox" && snapshot.name === this.#options.snapshotName);
+        if (cached) {
+            this.#snapshotId = cached.id;
+            this.#tracker.snapshotCacheHit();
+            await this.#createSharedTarget();
+            return;
+        }
+        const source = await retryTransient(async () => this.#sandboxes.create({
+            template: "base",
+            timeoutMs: SANDBOX_TIMEOUT_MS,
+            metadata: { product: "flakelab", role: "source" },
+        }), this.#retryOptions());
+        this.#trackSandbox(source);
+        try {
+            await source.connect();
+            await source.files.write(`${CHECKOUT_APP_DIRECTORY}/server.py`, checkoutServerSource);
+            const command = await source.commands.run("sh", {
+                args: [
+                    "-c",
+                    `cd ${CHECKOUT_APP_DIRECTORY} && nohup python3 server.py >server.log 2>&1 &`,
+                ],
+            });
+            if (command.exitCode !== 0) {
+                throw new Error("Checkout fixture failed to start in the prepared sandbox");
+            }
+            const preview = await source.previewUrl(CHECKOUT_PORT);
+            await waitForPreview(preview.url, this.#options.signal);
+            this.#snapshotId = await source.snapshot(this.#options.snapshotName);
+        }
+        finally {
+            await this.#releaseSandbox(source);
+        }
+        await this.#createSharedTarget();
+    }
+    execute = async (trial) => {
+        const startedAt = this.#tracker.trialStarted();
+        let browser;
+        let outcome;
+        let cleanupFailed = false;
+        try {
+            this.#options.signal?.throwIfAborted();
+            if (!this.#previewUrl) {
+                throw new Error("Solari executor must be prepared before trials run");
+            }
+            browser = await this.#createBrowser();
+            this.#trackBrowser(browser);
+            outcome = await this.#exerciseCheckout(browser.browser, this.#previewUrl, trial, startedAt);
+        }
+        catch (error) {
+            const cause = error instanceof Error ? error : new Error("Solari trial failed");
+            const normalized = normalizeProviderError(cause);
+            if (normalized instanceof ProviderFailure) {
+                throw normalized;
+            }
+            outcome = {
+                status: "error",
+                durationMs: Date.now() - startedAt,
+                exitCode: null,
+                failureSignature: errorFingerprint(cause),
+            };
+        }
+        finally {
+            if (browser) {
+                cleanupFailed = !(await this.#releaseBrowser(browser)) || cleanupFailed;
+            }
+            this.#tracker.trialCompleted(startedAt);
+        }
+        if (cleanupFailed) {
+            return {
+                status: "error",
+                durationMs: Date.now() - startedAt,
+                exitCode: null,
+                failureSignature: fingerprint("solari-resource-cleanup-failed"),
+            };
+        }
+        return outcome;
+    };
+    usage() {
+        return this.#tracker.snapshot();
+    }
+    async close() {
+        const released = await Promise.all([
+            ...[...this.#liveBrowsers.values()].map(async (browser) => this.#releaseBrowser(browser)),
+            ...[...this.#liveSandboxes.values()].map(async (sandbox) => this.#releaseSandbox(sandbox)),
+        ]);
+        await this.#browsers.close();
+        if (released.some((clean) => !clean)) {
+            throw new Error("One or more Solari resources could not be confirmed as released");
+        }
+    }
+    snapshotId() {
+        if (!this.#snapshotId) {
+            throw new Error("Solari executor has not prepared a snapshot");
+        }
+        return this.#snapshotId;
+    }
+    async #createSharedTarget() {
+        if (!this.#snapshotId) {
+            throw new Error("Solari executor must be prepared before trials run");
+        }
+        const fork = await retryTransient(async () => this.#sandboxes.create({
+            template: "base",
+            fromSnapshot: this.#snapshotId,
+            timeoutMs: SANDBOX_TIMEOUT_MS,
+            lifecycle: { onTimeout: "kill" },
+            metadata: { product: "flakelab", role: "shared-target" },
+        }), this.#retryOptions());
+        this.#trackSandbox(fork);
+        await retryTransient(async () => fork.connect(), {
+            attempts: 3,
+            baseDelayMs: 250,
+            signal: this.#options.signal,
+            onRetry: () => {
+                this.#tracker.retry();
+            },
+        });
+        const preview = await fork.previewUrl(CHECKOUT_PORT);
+        await waitForPreview(preview.url, this.#options.signal);
+        this.#previewUrl = preview.url;
+    }
+    #retryOptions() {
+        return {
+            attempts: 3,
+            baseDelayMs: 250,
+            signal: this.#options.signal,
+            onRetry: () => {
+                this.#tracker.retry();
+            },
+        };
+    }
+    async #exerciseCheckout(browser, previewUrl, trial, startedAt) {
+        const context = await browser.newContext();
+        const page = await context.newPage();
+        const removeFault = trial.fault ? await installFault(page, trial.fault) : undefined;
+        try {
+            await page.goto(previewUrl);
+            await page.getByRole("button", { name: "Place order" }).click();
+            const status = page.getByRole("status");
+            await status.filter({ hasText: /Checkout complete|Checkout timed out/ }).waitFor();
+            const statusText = await status.textContent();
+            const passed = statusText === "Checkout complete";
+            return {
+                status: passed ? "passed" : "failed",
+                durationMs: Date.now() - startedAt,
+                exitCode: passed ? 0 : 1,
+                ...(passed ? {} : { failureSignature: fingerprint(`checkout:${statusText ?? "missing"}`) }),
+            };
+        }
+        finally {
+            if (removeFault) {
+                await removeFault();
+            }
+            await context.close();
+        }
+    }
+    async #createBrowser() {
+        const response = await retryTransient(async () => this.#browsers.request("POST", "/sessions"), this.#retryOptions());
+        if (!response.ok) {
+            throw await solariResponseFailure(response);
+        }
+        const session = rawSessionSchema.parse(await response.json());
+        this.#tracker.browserCreated();
+        let proxy;
+        try {
+            proxy = await SecureWebSocketProxy.create(session.cdpEndpoint);
+            const browser = await chromium.connectOverCDP(proxy.endpoint());
+            return { browser, proxy, sessionId: session.sessionId };
+        }
+        catch (error) {
+            await proxy?.close().catch(() => undefined);
+            await this.#browsers.sessions.releaseAndWait(session.sessionId).catch(() => undefined);
+            this.#tracker.browserClosed();
+            throw error;
+        }
+    }
+    #trackBrowser(browser) {
+        this.#liveBrowsers.set(browser.sessionId, browser);
+    }
+    #trackSandbox(sandbox) {
+        this.#liveSandboxes.set(sandbox.id, sandbox);
+        this.#tracker.sandboxCreated();
+    }
+    async #releaseBrowser(remote) {
+        let clean = true;
+        try {
+            await remote.browser.close();
+        }
+        catch {
+            clean = false;
+        }
+        try {
+            await remote.proxy.close();
+        }
+        catch {
+            clean = false;
+        }
+        try {
+            await this.#browsers.sessions.releaseAndWait(remote.sessionId);
+        }
+        catch {
+            clean = false;
+        }
+        if (clean && this.#liveBrowsers.delete(remote.sessionId)) {
+            this.#tracker.browserClosed();
+        }
+        return clean;
+    }
+    async #releaseSandbox(sandbox) {
+        try {
+            await sandbox.kill();
+            if (this.#liveSandboxes.delete(sandbox.id)) {
+                this.#tracker.sandboxKilled();
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/solari/executor.js.map

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

package/dist/solari/retry.d.ts

@@ -0,0 +1,7 @@
+export interface RetryOptions {
+    attempts: number;
+    baseDelayMs: number;
+    signal?: AbortSignal;
+    onRetry?: () => void;
+}
+export declare function retryTransient<T>(operation: () => Promise<T>, options: RetryOptions): Promise<T>;

package/dist/solari/retry.js

@@ -0,0 +1,50 @@
+import { SolariError as BrowserSolariError } from "@solarisdk/browser";
+import { ConnectionError, GatewayError, NoCapacityError, TimeoutError, } from "@solarisdk/sandbox";
+import { setTimeout as delay } from "node:timers/promises";
+function isRetryable(error) {
+    if (error instanceof TypeError && error.message === "fetch failed") {
+        return true;
+    }
+    if (error instanceof NoCapacityError || error instanceof TimeoutError) {
+        return true;
+    }
+    if (error instanceof ConnectionError) {
+        return true;
+    }
+    if (error instanceof GatewayError) {
+        return error.status >= 500;
+    }
+    if (error instanceof BrowserSolariError) {
+        return error.status === 502 || error.status === 503;
+    }
+    return false;
+}
+function validateRetryOptions(options) {
+    if (!Number.isInteger(options.attempts) || options.attempts < 1 || options.attempts > 5) {
+        throw new Error("retry attempts must be an integer between 1 and 5");
+    }
+}
+function shouldRetry(error, attempt, attempts) {
+    return isRetryable(error) && attempt < attempts;
+}
+export async function retryTransient(operation, options) {
+    validateRetryOptions(options);
+    for (let attempt = 1; attempt <= options.attempts; attempt += 1) {
+        options.signal?.throwIfAborted();
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            if (!shouldRetry(error, attempt, options.attempts)) {
+                throw error;
+            }
+            options.onRetry?.();
+            await delay(options.baseDelayMs * attempt, undefined, { signal: options.signal });
+        }
+    }
+    throw new Error("retry loop completed without a result");
+}
+//# sourceMappingURL=retry.js.map

package/dist/solari/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/solari/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAS1D,SAAS,WAAW,CAAC,KAAY;IAC/B,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;QACnE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QACtE,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,IAAI,GAAG,CAAA;IAC5B,CAAC;IACD,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAA;IACrD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAqB;IACjD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAY,EAAE,OAAe,EAAE,QAAgB;IAClE,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,GAAG,QAAQ,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAA2B,EAC3B,OAAqB;IAErB,oBAAoB,CAAC,OAAO,CAAC,CAAA;IAE7B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAChE,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAA;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAA;YACb,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnD,MAAM,KAAK,CAAA;YACb,CAAC;YACD,OAAO,CAAC,OAAO,EAAE,EAAE,CAAA;YACnB,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,GAAG,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QACnF,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;AAC1D,CAAC"}

package/dist/solari/run-demo.d.ts

@@ -0,0 +1,21 @@
+import type { DiagnosticResult } from "../runner/local.js";
+import type { ResourceUsage } from "./usage.js";
+export interface SolariDemoOptions {
+    apiKey: string;
+    artifactDirectory: string;
+    baseUrl: string;
+    concurrency: number;
+    delayMs: number;
+    projectRoot: string;
+    runs: number;
+    seed: number;
+    signal?: AbortSignal;
+}
+export declare function snapshotCacheKey(commit: string, lockfile: string, fixture: string): string;
+export interface SolariDemoResult extends DiagnosticResult {
+    artifactPath: string;
+    metricsPath: string;
+    snapshotId: string;
+    usage: ResourceUsage;
+}
+export declare function runSolariDemo(options: SolariDemoOptions): Promise<SolariDemoResult>;

package/dist/solari/run-demo.js

@@ -0,0 +1,64 @@
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { promisify } from "node:util";
+import { createNdjsonWriter } from "../artifacts/ndjson.js";
+import { runRequestSchema } from "../domain/schema.js";
+import { runLocalDiagnostics } from "../runner/local.js";
+import { checkoutServerSource } from "./checkout-fixture.js";
+import { SolariParallelExecutor } from "./executor.js";
+const execFileAsync = promisify(execFile);
+export function snapshotCacheKey(commit, lockfile, fixture) {
+    return createHash("sha256")
+        .update(commit)
+        .update("\0")
+        .update(lockfile)
+        .update("\0")
+        .update(fixture)
+        .digest("hex")
+        .slice(0, 24);
+}
+async function snapshotName(projectRoot) {
+    const [{ stdout: commit }, lockfile] = await Promise.all([
+        execFileAsync("git", ["rev-parse", "HEAD"], { cwd: projectRoot, encoding: "utf8" }),
+        readFile(resolve(projectRoot, "pnpm-lock.yaml"), "utf8"),
+    ]);
+    return `flakelab-${snapshotCacheKey(commit.trim(), lockfile, checkoutServerSource)}`;
+}
+export async function runSolariDemo(options) {
+    const runDirectory = resolve(options.artifactDirectory, `solari-${Date.now()}`);
+    const artifactPath = resolve(runDirectory, "events.ndjson");
+    const metricsPath = resolve(runDirectory, "metrics.json");
+    const request = runRequestSchema.parse({
+        selector: "solari-checkout-demo",
+        runs: options.runs,
+        seed: options.seed,
+        artifactDirectory: runDirectory,
+        fault: {
+            kind: "network-delay",
+            pattern: "**/api/checkout",
+            delayMs: options.delayMs,
+        },
+    });
+    const executor = new SolariParallelExecutor({
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        signal: options.signal,
+        snapshotName: await snapshotName(options.projectRoot),
+    });
+    let result;
+    let snapshotId;
+    try {
+        await executor.prepare();
+        snapshotId = executor.snapshotId();
+        result = await runLocalDiagnostics(request, executor.execute, createNdjsonWriter(artifactPath), { concurrency: options.concurrency, signal: options.signal });
+    }
+    finally {
+        await executor.close();
+    }
+    const usage = executor.usage();
+    await writeFile(metricsPath, `${JSON.stringify(usage, null, 2)}\n`, { encoding: "utf8" });
+    return { ...result, artifactPath, metricsPath, snapshotId, usage };
+}
+//# sourceMappingURL=run-demo.js.map

package/dist/solari/run-demo.js.map

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

package/dist/solari/transport.d.ts

@@ -0,0 +1 @@
+export declare function withSolariTransport<T>(operation: () => Promise<T>): Promise<T>;

package/dist/solari/transport.js

@@ -0,0 +1,21 @@
+import { Agent, getGlobalDispatcher, setGlobalDispatcher } from "undici";
+export async function withSolariTransport(operation) {
+    const previousDispatcher = getGlobalDispatcher();
+    const dispatcher = new Agent({
+        autoSelectFamily: false,
+        connect: {
+            family: 4,
+            maxVersion: "TLSv1.2",
+            ALPNProtocols: ["http/1.1"],
+        },
+    });
+    setGlobalDispatcher(dispatcher);
+    try {
+        return await operation();
+    }
+    finally {
+        setGlobalDispatcher(previousDispatcher);
+        await dispatcher.close();
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/solari/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/solari/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAExE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAI,SAA2B;IACtE,MAAM,kBAAkB,GAAG,mBAAmB,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC;QAC3B,gBAAgB,EAAE,KAAK;QACvB,OAAO,EAAE;YACP,MAAM,EAAE,CAAC;YACT,UAAU,EAAE,SAAS;YACrB,aAAa,EAAE,CAAC,UAAU,CAAC;SAC5B;KACF,CAAC,CAAA;IACF,mBAAmB,CAAC,UAAU,CAAC,CAAA;IAC/B,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAA;IAC1B,CAAC;YAAS,CAAC;QACT,mBAAmB,CAAC,kBAAkB,CAAC,CAAA;QACvC,MAAM,UAAU,CAAC,KAAK,EAAE,CAAA;IAC1B,CAAC;AACH,CAAC"}

package/dist/solari/usage.d.ts

@@ -0,0 +1,23 @@
+export interface ResourceUsage {
+    wallTimeMs: number;
+    trialRuntimeMs: number;
+    peakConcurrency: number;
+    sandboxesCreated: number;
+    sandboxesKilled: number;
+    browserSessionsCreated: number;
+    browserSessionsClosed: number;
+    infrastructureRetries: number;
+    snapshotCacheHit: boolean;
+}
+export declare class ResourceUsageTracker {
+    #private;
+    sandboxCreated(): void;
+    sandboxKilled(): void;
+    browserCreated(): void;
+    browserClosed(): void;
+    retry(): void;
+    snapshotCacheHit(): void;
+    trialStarted(): number;
+    trialCompleted(startedAt: number): void;
+    snapshot(): ResourceUsage;
+}

package/dist/solari/usage.js

@@ -0,0 +1,53 @@
+export class ResourceUsageTracker {
+    #startedAt = Date.now();
+    #activeTrials = 0;
+    #browserSessionsClosed = 0;
+    #browserSessionsCreated = 0;
+    #infrastructureRetries = 0;
+    #peakConcurrency = 0;
+    #sandboxesCreated = 0;
+    #sandboxesKilled = 0;
+    #snapshotCacheHit = false;
+    #trialRuntimeMs = 0;
+    sandboxCreated() {
+        this.#sandboxesCreated += 1;
+    }
+    sandboxKilled() {
+        this.#sandboxesKilled += 1;
+    }
+    browserCreated() {
+        this.#browserSessionsCreated += 1;
+    }
+    browserClosed() {
+        this.#browserSessionsClosed += 1;
+    }
+    retry() {
+        this.#infrastructureRetries += 1;
+    }
+    snapshotCacheHit() {
+        this.#snapshotCacheHit = true;
+    }
+    trialStarted() {
+        this.#activeTrials += 1;
+        this.#peakConcurrency = Math.max(this.#peakConcurrency, this.#activeTrials);
+        return Date.now();
+    }
+    trialCompleted(startedAt) {
+        this.#activeTrials -= 1;
+        this.#trialRuntimeMs += Date.now() - startedAt;
+    }
+    snapshot() {
+        return {
+            wallTimeMs: Date.now() - this.#startedAt,
+            trialRuntimeMs: this.#trialRuntimeMs,
+            peakConcurrency: this.#peakConcurrency,
+            sandboxesCreated: this.#sandboxesCreated,
+            sandboxesKilled: this.#sandboxesKilled,
+            browserSessionsCreated: this.#browserSessionsCreated,
+            browserSessionsClosed: this.#browserSessionsClosed,
+            infrastructureRetries: this.#infrastructureRetries,
+            snapshotCacheHit: this.#snapshotCacheHit,
+        };
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/solari/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/solari/usage.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,oBAAoB;IACtB,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAChC,aAAa,GAAG,CAAC,CAAA;IACjB,sBAAsB,GAAG,CAAC,CAAA;IAC1B,uBAAuB,GAAG,CAAC,CAAA;IAC3B,sBAAsB,GAAG,CAAC,CAAA;IAC1B,gBAAgB,GAAG,CAAC,CAAA;IACpB,iBAAiB,GAAG,CAAC,CAAA;IACrB,gBAAgB,GAAG,CAAC,CAAA;IACpB,iBAAiB,GAAG,KAAK,CAAA;IACzB,eAAe,GAAG,CAAC,CAAA;IAEnB,cAAc;QACZ,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,aAAa;QACX,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,uBAAuB,IAAI,CAAC,CAAA;IACnC,CAAC;IAED,aAAa;QACX,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;IAC/B,CAAC;IAED,YAAY;QACV,IAAI,CAAC,aAAa,IAAI,CAAC,CAAA;QACvB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAC3E,OAAO,IAAI,CAAC,GAAG,EAAE,CAAA;IACnB,CAAC;IAED,cAAc,CAAC,SAAiB;QAC9B,IAAI,CAAC,aAAa,IAAI,CAAC,CAAA;QACvB,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;IAChD,CAAC;IAED,QAAQ;QACN,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU;YACxC,cAAc,EAAE,IAAI,CAAC,eAAe;YACpC,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;YACxC,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,sBAAsB,EAAE,IAAI,CAAC,uBAAuB;YACpD,qBAAqB,EAAE,IAAI,CAAC,sBAAsB;YAClD,qBAAqB,EAAE,IAAI,CAAC,sBAAsB;YAClD,gBAAgB,EAAE,IAAI,CAAC,iBAAiB;SACzC,CAAA;IACH,CAAC;CACF"}

package/dist/solari/websocket-proxy.d.ts

@@ -0,0 +1,7 @@
+export declare class SecureWebSocketProxy {
+    #private;
+    private constructor();
+    static create(upstreamEndpoint: string): Promise<SecureWebSocketProxy>;
+    endpoint(): string;
+    close(): Promise<void>;
+}