@poe-platform/safe-bash 0.1.695 → 0.1.697

package/dist/safe-bash/playwright/profile.js

@@ -0,0 +1,147 @@
+import { readPlaywrightStorageState } from './native-storage-replacement.js';
+import { parsePlaywrightContextOptions } from './open-options.js';
+import { parsePlaywrightSessionConfiguration } from './session-configuration.js';
+import { parsePlaywrightStorageState } from './storage-state.js';
+/** Validate persisted JSON before it can allocate or navigate a browser. */
+export function parseBrowserProfile(bytes, limits) {
+    validateProfileLimits(limits);
+    if (bytes.byteLength > limits.maxBytes)
+        throw new Error("Browser profile byte limit exceeded");
+    const value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+    if (!value ||
+        typeof value !== "object" ||
+        !("state" in value) ||
+        !("tabs" in value) ||
+        !Array.isArray(value.tabs) ||
+        value.tabs.length > limits.maxTabs ||
+        !("selected" in value) ||
+        typeof value.selected !== "number" ||
+        !Number.isSafeInteger(value.selected) ||
+        value.selected < 0 ||
+        value.selected >= Math.max(1, value.tabs.length))
+        throw new Error("Invalid stored browser profile");
+    const tabs = [];
+    for (const tab of value.tabs) {
+        if (typeof tab !== "string" || !URL.canParse(tab))
+            throw new Error("Invalid stored browser tab");
+        tabs.push(tab);
+    }
+    return {
+        ...profileSettings(value),
+        state: parsePlaywrightStorageState(value.state, { maxBytes: limits.maxBytes }),
+        tabs,
+        selected: value.selected,
+        ...('runtimeState' in value ? { runtimeState: value.runtimeState } : {}),
+    };
+}
+function profileSettings(value) {
+    const settings = {};
+    if ("expiresAt" in value)
+        settings.expiresAt = timing(value.expiresAt);
+    if ("idleTimeoutMs" in value)
+        settings.idleTimeoutMs = timing(value.idleTimeoutMs);
+    if ("contextOptions" in value) {
+        settings.contextOptions = parsePlaywrightContextOptions(value.contextOptions);
+        if (settings.contextOptions.storageState)
+            throw new Error("Stored context options must use the current profile state");
+    }
+    if ("configuration" in value)
+        settings.configuration = parsePlaywrightSessionConfiguration(value.configuration);
+    return settings;
+}
+function timing(value) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        throw new Error("Invalid stored browser expiry");
+    return value;
+}
+function validateProfileLimits(limits) {
+    if (!limits || !Number.isSafeInteger(limits.maxBytes) || limits.maxBytes <= 0 || !Number.isSafeInteger(limits.maxTabs) || limits.maxTabs <= 0)
+        throw new TypeError("Invalid browser profile limits");
+}
+export function encodeBrowserProfile(profile, limits) {
+    const bytes = new TextEncoder().encode(JSON.stringify(profile));
+    parseBrowserProfile(bytes, limits);
+    return bytes;
+}
+/** Return an initializer so the standard controller installs configuration before navigation. */
+export async function restoreBrowserProfile(options) {
+    const { adapter, limits, name, signal } = options;
+    signal.throwIfAborted();
+    const profile = parseBrowserProfile(encodeBrowserProfile(options.profile, limits), limits);
+    const lease = await adapter.acquire({
+        acquisitionId: crypto.randomUUID(), session: name, browser: 'chromium', headless: true,
+        contextOptions: { ...profile.contextOptions, storageState: profile.state }, signal,
+    });
+    try {
+        const pages = [];
+        const urls = profile.tabs.length ? profile.tabs : ['about:blank'];
+        for (const ignoredUrl of urls) {
+            signal.throwIfAborted();
+            pages.push(await lease.context.newPage());
+        }
+        signal.throwIfAborted();
+        return {
+            lease, selectedPage: pages[profile.selected],
+            ...(profile.configuration === undefined ? {} : { configuration: profile.configuration }),
+            ...(profile.contextOptions === undefined ? {} : { contextOptions: profile.contextOptions }),
+            ...(profile.expiresAt === undefined ? {} : { expiresAt: profile.expiresAt }),
+            ...(profile.idleTimeoutMs === undefined ? {} : { idleTimeoutMs: profile.idleTimeoutMs }),
+            async initialize({ signal }) {
+                // The controller owns retirement after adoption, including failed navigation.
+                if (profile.runtimeState !== undefined) {
+                    const runtime = lease.context.browserProfile;
+                    if (!runtime)
+                        throw new Error('Browser adapter cannot restore provider profile settings');
+                    await runtime.restore(profile.runtimeState, signal);
+                }
+                for (let i = 0; i < pages.length; i++) {
+                    signal.throwIfAborted();
+                    await pages[i].goto(urls[i]);
+                }
+            },
+        };
+    }
+    catch (error) {
+        try {
+            await lease.release();
+        }
+        catch (cleanup) {
+            throw new AggregateError([error, cleanup], 'Browser profile restoration and cleanup failed');
+        }
+        throw error;
+    }
+}
+/** Read closed-origin IndexedDB using isolated targets and settle every registered reader cleanup. */
+export async function checkpointBrowserProfile(session, limits, signal) {
+    validateProfileLimits(limits);
+    signal.throwIfAborted();
+    const cleanups = [];
+    const [result] = await Promise.allSettled([readPlaywrightStorageState(session.context, {
+            signal, indexedDB: true, maxBytes: limits.maxBytes, registerCleanup: cleanup => cleanups.push(cleanup),
+        })]);
+    const outcomes = await Promise.allSettled(cleanups.map(cleanup => Promise.resolve().then(cleanup)));
+    const failures = outcomes.filter((outcome) => outcome.status === 'rejected').map(outcome => outcome.reason);
+    if (result.status === 'rejected' || signal.aborted)
+        failures.unshift(result.status === 'rejected' ? result.reason : signal.reason);
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1)
+        throw new AggregateError(failures, 'Browser profile checkpoint and cleanup failed');
+    if (result.status !== 'fulfilled')
+        throw new Error('Browser profile checkpoint failed');
+    const pages = session.context.pages();
+    const contextOptions = { ...session.contextOptions };
+    delete contextOptions.storageState;
+    const runtime = session.context.browserProfile;
+    const runtimeState = await runtime?.capture(signal);
+    signal.throwIfAborted();
+    return encodeBrowserProfile({
+        state: result.value, contextOptions,
+        tabs: pages.map(page => page.url()), selected: Math.max(0, session.selectedPage ? pages.indexOf(session.selectedPage) : 0),
+        ...(session.configuration === undefined ? {} : { configuration: session.configuration }),
+        ...(session.expiresAt === undefined ? {} : { expiresAt: session.expiresAt }),
+        ...(session.idleTimeoutMs === undefined ? {} : { idleTimeoutMs: session.idleTimeoutMs }),
+        ...(runtimeState === undefined ? {} : { runtimeState }),
+    }, limits);
+}
+//# sourceMappingURL=profile.js.map

package/dist/safe-bash/playwright/profile.js.map

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

package/dist/safe-playwright-cloudflare/browser-artifact.js

@@ -0,0 +1,46 @@
+import { mkdtemp, open, rm } from "node:fs/promises";
+/** Cloudflare's tracing client writes to its private /tmp filesystem. Read a
+ * bounded artifact only after the producer settles, and always retire its files. */
+export const captureBrowserArtifact = async (produce, options) => {
+    const { signal, maxBytes, extension } = options;
+    signal.throwIfAborted();
+    if (!Number.isSafeInteger(maxBytes) ||
+        maxBytes < 1 ||
+        !extension ||
+        extension.length > 16 ||
+        [...extension].some((letter) => !"abcdefghijklmnopqrstuvwxyz0123456789".includes(letter)))
+        throw new Error("Invalid browser artifact options");
+    const directory = await mkdtemp("/tmp/poe-browser-artifact-");
+    try {
+        signal.throwIfAborted();
+        const path = `${directory}/artifact.${extension}`;
+        await produce(path);
+        signal.throwIfAborted();
+        const file = await open(path, "r");
+        try {
+            const stat = await file.stat();
+            if (!stat.isFile() || stat.size > maxBytes)
+                throw new Error("Browser artifact byte limit exceeded");
+            const bytes = new Uint8Array(stat.size + 1);
+            let offset = 0;
+            while (offset < bytes.byteLength) {
+                signal.throwIfAborted();
+                // biome-ignore lint/performance/noAwaitInLoops: Each short read advances the same file cursor and bounded destination.
+                const { bytesRead } = await file.read(bytes, offset, bytes.byteLength - offset, null);
+                if (!bytesRead)
+                    break;
+                offset += bytesRead;
+            }
+            if (offset !== stat.size)
+                throw new Error("Browser artifact changed during capture");
+            signal.throwIfAborted();
+            return bytes.slice(0, offset);
+        }
+        finally {
+            await file.close();
+        }
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+};

package/dist/safe-playwright-cloudflare/browser-code-executor.d.ts

@@ -0,0 +1,7 @@
+import type { PlaywrightCodeExecutor } from "../safe-bash/commands/playwright/index.js";
+import type { acquireCloudflareBrowser } from "./shell-browser-resource.js";
+export interface BrowserCodeRuntime {
+    ownerId: string;
+    loader?: WorkerLoader;
+}
+export declare function createBrowserCodeExecutor(resource: Awaited<ReturnType<typeof acquireCloudflareBrowser>>, runtime?: BrowserCodeRuntime): PlaywrightCodeExecutor;

package/dist/safe-playwright-cloudflare/browser-code-executor.js

@@ -0,0 +1,20 @@
+import { createBrowserRunCode } from "./browser-run-code.js";
+import { browserRunCodeGuestSource } from "./browser-run-code-guest.generated.js";
+export function createBrowserCodeExecutor(resource, runtime) {
+    const execute = runtime?.loader
+        ? createBrowserRunCode({
+            ownerId: runtime.ownerId,
+            loader: runtime.loader,
+            guestSource: browserRunCodeGuestSource,
+            browser: resource.browser,
+            connectSocket: resource.connectSocket,
+            retire: resource.release,
+        })
+        : undefined;
+    return async (input) => {
+        if (!execute)
+            throw new Error("Playwright run-code is unavailable: Worker Loader binding missing");
+        // The provider created this native Page; the portable adapter narrows its type.
+        return execute({ ...input, page: input.page });
+    };
+}