@browserbasehq/orca 3.4.0-preview-4 → 3.4.0-preview-5

package/dist/cjs/tests/unit/api-multiregion.test.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const api_1 = require("../../lib/v3/api");
-(0, vitest_1.describe)("Multi-region API URL mapping", () => {
-    (0, vitest_1.describe)("REGION_API_URLS constant", () => {
-        (0, vitest_1.it)("should have the correct URL for us-west-2 (default)", () => {
-            (0, vitest_1.expect)(api_1.REGION_API_URLS["us-west-2"]).toBe("https://api.stagehand.browserbase.com");
-        });
-        (0, vitest_1.it)("should have the correct URL for us-east-1", () => {
-            (0, vitest_1.expect)(api_1.REGION_API_URLS["us-east-1"]).toBe("https://api.use1.stagehand.browserbase.com");
-        });
-        (0, vitest_1.it)("should have the correct URL for eu-central-1", () => {
-            (0, vitest_1.expect)(api_1.REGION_API_URLS["eu-central-1"]).toBe("https://api.euc1.stagehand.browserbase.com");
-        });
-        (0, vitest_1.it)("should have the correct URL for ap-southeast-1", () => {
-            (0, vitest_1.expect)(api_1.REGION_API_URLS["ap-southeast-1"]).toBe("https://api.apse1.stagehand.browserbase.com");
-        });
-    });
-    (0, vitest_1.describe)("getApiUrlForRegion", () => {
-        (0, vitest_1.it)("should return the correct URL for us-west-2", () => {
-            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("us-west-2")).toBe("https://api.stagehand.browserbase.com/v1");
-        });
-        (0, vitest_1.it)("should return the correct URL for us-east-1", () => {
-            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("us-east-1")).toBe("https://api.use1.stagehand.browserbase.com/v1");
-        });
-        (0, vitest_1.it)("should return the correct URL for eu-central-1", () => {
-            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("eu-central-1")).toBe("https://api.euc1.stagehand.browserbase.com/v1");
-        });
-        (0, vitest_1.it)("should return the correct URL for ap-southeast-1", () => {
-            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("ap-southeast-1")).toBe("https://api.apse1.stagehand.browserbase.com/v1");
-        });
-        (0, vitest_1.it)("should return the default us-west-2 URL when no region is specified", () => {
-            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)(undefined)).toBe("https://api.stagehand.browserbase.com/v1");
-        });
-        (0, vitest_1.it)("should return the default us-west-2 URL for unknown regions", () => {
-            // @ts-expect-error - testing invalid region
-            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("invalid-region")).toBe("https://api.stagehand.browserbase.com/v1");
-        });
-    });
-    (0, vitest_1.describe)("URL /v1 suffix handling", () => {
-        (0, vitest_1.it)("getApiUrlForRegion always includes /v1 suffix for consistency", () => {
-            // getApiUrlForRegion returns a URL with /v1
-            // This documents the expected contract that all API base URLs include /v1
-            const url = (0, api_1.getApiUrlForRegion)("us-west-2");
-            (0, vitest_1.expect)(url.endsWith("/v1")).toBe(true);
-        });
-        (0, vitest_1.it)("all regional URLs should be base URLs without /v1 in REGION_API_URLS", () => {
-            // Verify REGION_API_URLS contains base URLs (without /v1)
-            // The /v1 suffix is added by getApiUrlForRegion
-            for (const [region, baseUrl] of Object.entries(api_1.REGION_API_URLS)) {
-                (0, vitest_1.expect)(baseUrl.endsWith("/v1")).toBe(false);
-                (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)(region)).toBe(`${baseUrl}/v1`);
-            }
-        });
-    });
-});
-//# sourceMappingURL=api-multiregion.test.js.map

package/dist/cjs/tests/unit/api-multiregion.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-multiregion.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-multiregion.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { getApiUrlForRegion, REGION_API_URLS } from \"../../lib/v3/api\";\n\ndescribe(\"Multi-region API URL mapping\", () => {\n  describe(\"REGION_API_URLS constant\", () => {\n    it(\"should have the correct URL for us-west-2 (default)\", () => {\n      expect(REGION_API_URLS[\"us-west-2\"]).toBe(\n        \"https://api.stagehand.browserbase.com\",\n      );\n    });\n\n    it(\"should have the correct URL for us-east-1\", () => {\n      expect(REGION_API_URLS[\"us-east-1\"]).toBe(\n        \"https://api.use1.stagehand.browserbase.com\",\n      );\n    });\n\n    it(\"should have the correct URL for eu-central-1\", () => {\n      expect(REGION_API_URLS[\"eu-central-1\"]).toBe(\n        \"https://api.euc1.stagehand.browserbase.com\",\n      );\n    });\n\n    it(\"should have the correct URL for ap-southeast-1\", () => {\n      expect(REGION_API_URLS[\"ap-southeast-1\"]).toBe(\n        \"https://api.apse1.stagehand.browserbase.com\",\n      );\n    });\n  });\n\n  describe(\"getApiUrlForRegion\", () => {\n    it(\"should return the correct URL for us-west-2\", () => {\n      expect(getApiUrlForRegion(\"us-west-2\")).toBe(\n        \"https://api.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the correct URL for us-east-1\", () => {\n      expect(getApiUrlForRegion(\"us-east-1\")).toBe(\n        \"https://api.use1.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the correct URL for eu-central-1\", () => {\n      expect(getApiUrlForRegion(\"eu-central-1\")).toBe(\n        \"https://api.euc1.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the correct URL for ap-southeast-1\", () => {\n      expect(getApiUrlForRegion(\"ap-southeast-1\")).toBe(\n        \"https://api.apse1.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the default us-west-2 URL when no region is specified\", () => {\n      expect(getApiUrlForRegion(undefined)).toBe(\n        \"https://api.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the default us-west-2 URL for unknown regions\", () => {\n      // @ts-expect-error - testing invalid region\n      expect(getApiUrlForRegion(\"invalid-region\")).toBe(\n        \"https://api.stagehand.browserbase.com/v1\",\n      );\n    });\n  });\n\n  describe(\"URL /v1 suffix handling\", () => {\n    it(\"getApiUrlForRegion always includes /v1 suffix for consistency\", () => {\n      // getApiUrlForRegion returns a URL with /v1\n      // This documents the expected contract that all API base URLs include /v1\n      const url = getApiUrlForRegion(\"us-west-2\");\n      expect(url.endsWith(\"/v1\")).toBe(true);\n    });\n\n    it(\"all regional URLs should be base URLs without /v1 in REGION_API_URLS\", () => {\n      // Verify REGION_API_URLS contains base URLs (without /v1)\n      // The /v1 suffix is added by getApiUrlForRegion\n      for (const [region, baseUrl] of Object.entries(REGION_API_URLS)) {\n        expect(baseUrl.endsWith(\"/v1\")).toBe(false);\n        expect(getApiUrlForRegion(region as keyof typeof REGION_API_URLS)).toBe(\n          `${baseUrl}/v1`,\n        );\n      }\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/api-optional-model-api-key.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cjs/tests/unit/api-optional-model-api-key.test.js

@@ -1,155 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const api_1 = require("../../lib/v3/api");
-/**
- * Tests that modelApiKey is optional when calling StagehandAPIClient.init().
- *
- * Previously, init() would throw "modelApiKey is required" if the key was not
- * provided. After the fix, sessions can be started without a model API key
- * (the server may provide its own key or the user may not need one).
- * When provided, the key should still be sent via the x-model-api-key header.
- */
-(0, vitest_1.describe)("StagehandAPIClient - optional modelApiKey", () => {
-    const logger = vitest_1.vi.fn();
-    // We mock fetch to avoid real network calls; we just need to verify
-    // that init() doesn't throw when modelApiKey is omitted and that
-    // the header is conditionally included.
-    let originalFetch;
-    function createSessionStartResponse(sessionId) {
-        return new Response(JSON.stringify({
-            success: true,
-            data: { sessionId, available: true },
-        }), {
-            status: 200,
-            headers: { "Content-Type": "application/json" },
-        });
-    }
-    (0, vitest_1.beforeEach)(() => {
-        originalFetch = globalThis.fetch;
-        logger.mockClear();
-    });
-    (0, vitest_1.afterEach)(() => {
-        globalThis.fetch = originalFetch;
-        delete process.env.STAGEHAND_BASE_URL;
-        delete process.env.STAGEHAND_API_URL;
-        vitest_1.vi.restoreAllMocks();
-    });
-    (0, vitest_1.it)("should NOT throw when modelApiKey is omitted", async () => {
-        globalThis.fetch = vitest_1.vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-123"));
-        const client = new api_1.StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        // Should not throw "modelApiKey is required"
-        await (0, vitest_1.expect)(client.init({
-            modelName: "openai/gpt-4.1-mini",
-        })).resolves.toBeDefined();
-    });
-    (0, vitest_1.it)("should NOT throw when modelApiKey is undefined", async () => {
-        globalThis.fetch = vitest_1.vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-456"));
-        const client = new api_1.StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await (0, vitest_1.expect)(client.init({
-            modelName: "openai/gpt-4.1-mini",
-            modelApiKey: undefined,
-        })).resolves.toBeDefined();
-    });
-    (0, vitest_1.it)("should send x-model-api-key header when modelApiKey IS provided", async () => {
-        const fetchSpy = vitest_1.vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-789"));
-        globalThis.fetch = fetchSpy;
-        const client = new api_1.StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-            modelApiKey: "my-model-key",
-        });
-        // Verify the fetch was called with x-model-api-key header
-        const [, requestInit] = fetchSpy.mock.calls[0];
-        (0, vitest_1.expect)(requestInit.headers["x-model-api-key"]).toBe("my-model-key");
-    });
-    (0, vitest_1.it)("should NOT send x-model-api-key header when modelApiKey is omitted", async () => {
-        const fetchSpy = vitest_1.vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-012"));
-        globalThis.fetch = fetchSpy;
-        const client = new api_1.StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        // Verify x-model-api-key header is NOT present
-        const [, requestInit] = fetchSpy.mock.calls[0];
-        (0, vitest_1.expect)(requestInit.headers["x-model-api-key"]).toBeUndefined();
-    });
-    (0, vitest_1.it)("should use STAGEHAND_API_URL for the API base URL", async () => {
-        process.env.STAGEHAND_API_URL = "http://localhost:5000";
-        const fetchSpy = vitest_1.vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-api-url"));
-        globalThis.fetch = fetchSpy;
-        const client = new api_1.StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        const [url] = fetchSpy.mock.calls[0];
-        (0, vitest_1.expect)(url.toString()).toBe("http://localhost:5000/v1/sessions/start");
-    });
-    (0, vitest_1.it)("should use STAGEHAND_BASE_URL as a legacy fallback", async () => {
-        process.env.STAGEHAND_BASE_URL = "http://localhost:5001";
-        const fetchSpy = vitest_1.vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-base-url"));
-        globalThis.fetch = fetchSpy;
-        const client = new api_1.StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        const [url] = fetchSpy.mock.calls[0];
-        (0, vitest_1.expect)(url.toString()).toBe("http://localhost:5001/v1/sessions/start");
-        (0, vitest_1.expect)(logger).toHaveBeenCalledWith(vitest_1.expect.objectContaining({
-            category: "config",
-            message: "STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.",
-            level: 0,
-        }));
-    });
-    (0, vitest_1.it)("should prefer STAGEHAND_API_URL over STAGEHAND_BASE_URL", async () => {
-        process.env.STAGEHAND_BASE_URL = "http://localhost:5002";
-        process.env.STAGEHAND_API_URL = "http://localhost:5003";
-        const fetchSpy = vitest_1.vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-base-precedence"));
-        globalThis.fetch = fetchSpy;
-        const client = new api_1.StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        const [url] = fetchSpy.mock.calls[0];
-        (0, vitest_1.expect)(url.toString()).toBe("http://localhost:5003/v1/sessions/start");
-        (0, vitest_1.expect)(logger).not.toHaveBeenCalledWith(vitest_1.expect.objectContaining({
-            message: "STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.",
-        }));
-    });
-});
-//# sourceMappingURL=api-optional-model-api-key.test.js.map

package/dist/cjs/tests/unit/api-optional-model-api-key.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-optional-model-api-key.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-optional-model-api-key.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi, beforeEach, afterEach } from \"vitest\";\nimport { StagehandAPIClient } from \"../../lib/v3/api\";\n\n/**\n * Tests that modelApiKey is optional when calling StagehandAPIClient.init().\n *\n * Previously, init() would throw \"modelApiKey is required\" if the key was not\n * provided. After the fix, sessions can be started without a model API key\n * (the server may provide its own key or the user may not need one).\n * When provided, the key should still be sent via the x-model-api-key header.\n */\ndescribe(\"StagehandAPIClient - optional modelApiKey\", () => {\n  const logger = vi.fn();\n\n  // We mock fetch to avoid real network calls; we just need to verify\n  // that init() doesn't throw when modelApiKey is omitted and that\n  // the header is conditionally included.\n  let originalFetch: typeof globalThis.fetch;\n\n  function createSessionStartResponse(sessionId: string) {\n    return new Response(\n      JSON.stringify({\n        success: true,\n        data: { sessionId, available: true },\n      }),\n      {\n        status: 200,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n\n  beforeEach(() => {\n    originalFetch = globalThis.fetch;\n    logger.mockClear();\n  });\n\n  afterEach(() => {\n    globalThis.fetch = originalFetch;\n    delete process.env.STAGEHAND_BASE_URL;\n    delete process.env.STAGEHAND_API_URL;\n    vi.restoreAllMocks();\n  });\n\n  it(\"should NOT throw when modelApiKey is omitted\", async () => {\n    globalThis.fetch = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-123\"));\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    // Should not throw \"modelApiKey is required\"\n    await expect(\n      client.init({\n        modelName: \"openai/gpt-4.1-mini\",\n      }),\n    ).resolves.toBeDefined();\n  });\n\n  it(\"should NOT throw when modelApiKey is undefined\", async () => {\n    globalThis.fetch = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-456\"));\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await expect(\n      client.init({\n        modelName: \"openai/gpt-4.1-mini\",\n        modelApiKey: undefined,\n      }),\n    ).resolves.toBeDefined();\n  });\n\n  it(\"should send x-model-api-key header when modelApiKey IS provided\", async () => {\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-789\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n      modelApiKey: \"my-model-key\",\n    });\n\n    // Verify the fetch was called with x-model-api-key header\n    const [, requestInit] = fetchSpy.mock.calls[0];\n    expect(requestInit.headers[\"x-model-api-key\"]).toBe(\"my-model-key\");\n  });\n\n  it(\"should NOT send x-model-api-key header when modelApiKey is omitted\", async () => {\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-012\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    // Verify x-model-api-key header is NOT present\n    const [, requestInit] = fetchSpy.mock.calls[0];\n    expect(requestInit.headers[\"x-model-api-key\"]).toBeUndefined();\n  });\n\n  it(\"should use STAGEHAND_API_URL for the API base URL\", async () => {\n    process.env.STAGEHAND_API_URL = \"http://localhost:5000\";\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-api-url\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    const [url] = fetchSpy.mock.calls[0];\n    expect(url.toString()).toBe(\"http://localhost:5000/v1/sessions/start\");\n  });\n\n  it(\"should use STAGEHAND_BASE_URL as a legacy fallback\", async () => {\n    process.env.STAGEHAND_BASE_URL = \"http://localhost:5001\";\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-base-url\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    const [url] = fetchSpy.mock.calls[0];\n    expect(url.toString()).toBe(\"http://localhost:5001/v1/sessions/start\");\n    expect(logger).toHaveBeenCalledWith(\n      expect.objectContaining({\n        category: \"config\",\n        message:\n          \"STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.\",\n        level: 0,\n      }),\n    );\n  });\n\n  it(\"should prefer STAGEHAND_API_URL over STAGEHAND_BASE_URL\", async () => {\n    process.env.STAGEHAND_BASE_URL = \"http://localhost:5002\";\n    process.env.STAGEHAND_API_URL = \"http://localhost:5003\";\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-base-precedence\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    const [url] = fetchSpy.mock.calls[0];\n    expect(url.toString()).toBe(\"http://localhost:5003/v1/sessions/start\");\n    expect(logger).not.toHaveBeenCalledWith(\n      expect.objectContaining({\n        message:\n          \"STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.\",\n      }),\n    );\n  });\n});\n"]}

package/dist/cjs/tests/unit/api-variables-schema.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cjs/tests/unit/api-variables-schema.test.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const index_js_1 = require("../../lib/v3/types/public/index.js");
-(0, vitest_1.describe)("API variable schemas", () => {
-    (0, vitest_1.it)("accepts rich variables for act requests", () => {
-        const result = index_js_1.Api.ActRequestSchema.safeParse({
-            input: "type %username% into the email field",
-            options: {
-                variables: {
-                    username: {
-                        value: "john@example.com",
-                        description: "The login email",
-                    },
-                    rememberMe: true,
-                },
-            },
-        });
-        (0, vitest_1.expect)(result.success).toBe(true);
-    });
-    (0, vitest_1.it)("accepts rich variables for observe requests", () => {
-        const result = index_js_1.Api.ObserveRequestSchema.safeParse({
-            instruction: "find the field where %username% should be entered",
-            options: {
-                variables: {
-                    username: {
-                        value: "john@example.com",
-                        description: "The login email",
-                    },
-                    rememberMe: true,
-                },
-                ignoreSelectors: [".cookie-banner", "#sidebar-ads"],
-            },
-        });
-        (0, vitest_1.expect)(result.success).toBe(true);
-        if (!result.success)
-            throw result.error;
-        (0, vitest_1.expect)(result.data.options?.ignoreSelectors).toEqual([
-            ".cookie-banner",
-            "#sidebar-ads",
-        ]);
-    });
-    (0, vitest_1.it)("preserves variables for agent execute requests", () => {
-        const result = index_js_1.Api.AgentExecuteRequestSchema.safeParse({
-            agentConfig: { mode: "dom" },
-            executeOptions: {
-                instruction: "fill the form with %username% and %password%",
-                variables: {
-                    username: "john@example.com",
-                    password: {
-                        value: "secret-password",
-                        description: "The login password",
-                    },
-                },
-            },
-        });
-        (0, vitest_1.expect)(result.success).toBe(true);
-        if (!result.success)
-            throw result.error;
-        (0, vitest_1.expect)(result.data.executeOptions.variables).toEqual({
-            username: "john@example.com",
-            password: {
-                value: "secret-password",
-                description: "The login password",
-            },
-        });
-    });
-});
-//# sourceMappingURL=api-variables-schema.test.js.map

package/dist/cjs/tests/unit/api-variables-schema.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-variables-schema.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-variables-schema.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,iEAAyD;AAEzD,IAAA,iBAAQ,EAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,cAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAC5C,KAAK,EAAE,sCAAsC;YAC7C,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,cAAG,CAAC,oBAAoB,CAAC,SAAS,CAAC;YAChD,WAAW,EAAE,mDAAmD;YAChE,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;gBACD,eAAe,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC;aACpD;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC;QACxC,IAAA,eAAM,EAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC;YACnD,gBAAgB;YAChB,cAAc;SACf,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,cAAG,CAAC,yBAAyB,CAAC,SAAS,CAAC;YACrD,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;YAC5B,cAAc,EAAE;gBACd,WAAW,EAAE,8CAA8C;gBAC3D,SAAS,EAAE;oBACT,QAAQ,EAAE,kBAAkB;oBAC5B,QAAQ,EAAE;wBACR,KAAK,EAAE,iBAAiB;wBACxB,WAAW,EAAE,oBAAoB;qBAClC;iBACF;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC;QACxC,IAAA,eAAM,EAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;YACnD,QAAQ,EAAE,kBAAkB;YAC5B,QAAQ,EAAE;gBACR,KAAK,EAAE,iBAAiB;gBACxB,WAAW,EAAE,oBAAoB;aAClC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { Api } from \"../../lib/v3/types/public/index.js\";\n\ndescribe(\"API variable schemas\", () => {\n  it(\"accepts rich variables for act requests\", () => {\n    const result = Api.ActRequestSchema.safeParse({\n      input: \"type %username% into the email field\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n  });\n\n  it(\"accepts rich variables for observe requests\", () => {\n    const result = Api.ObserveRequestSchema.safeParse({\n      instruction: \"find the field where %username% should be entered\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n        ignoreSelectors: [\".cookie-banner\", \"#sidebar-ads\"],\n      },\n    });\n\n    expect(result.success).toBe(true);\n    if (!result.success) throw result.error;\n    expect(result.data.options?.ignoreSelectors).toEqual([\n      \".cookie-banner\",\n      \"#sidebar-ads\",\n    ]);\n  });\n\n  it(\"preserves variables for agent execute requests\", () => {\n    const result = Api.AgentExecuteRequestSchema.safeParse({\n      agentConfig: { mode: \"dom\" },\n      executeOptions: {\n        instruction: \"fill the form with %username% and %password%\",\n        variables: {\n          username: \"john@example.com\",\n          password: {\n            value: \"secret-password\",\n            description: \"The login password\",\n          },\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n    if (!result.success) throw result.error;\n    expect(result.data.executeOptions.variables).toEqual({\n      username: \"john@example.com\",\n      password: {\n        value: \"secret-password\",\n        description: \"The login password\",\n      },\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/browserbase-session-accessors.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/cjs/tests/unit/browserbase-session-accessors.test.js

@@ -1,142 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const v3_js_1 = require("../../lib/v3/v3.js");
-const MOCK_SESSION_ID = "session-123";
-const MOCK_SESSION_URL = `https://www.browserbase.com/sessions/${MOCK_SESSION_ID}`;
-const MOCK_DEBUG_URL = `https://debug.browserbase.com/${MOCK_SESSION_ID}`;
-vitest_1.vi.mock("../../lib/v3/understudy/context", () => {
-    class MockConnection {
-        onTransportClosed = vitest_1.vi.fn();
-        offTransportClosed = vitest_1.vi.fn();
-        send = vitest_1.vi.fn(async () => { });
-    }
-    class MockV3Context {
-        static async create() {
-            return new MockV3Context();
-        }
-        conn = new MockConnection();
-        pages() {
-            return [];
-        }
-        async close() {
-            // noop
-        }
-    }
-    return { V3Context: MockV3Context };
-});
-vitest_1.vi.mock("../../lib/v3/launch/browserbase", () => ({
-    createBrowserbaseSession: vitest_1.vi.fn(async () => ({
-        ws: "wss://mock-browserbase",
-        sessionId: MOCK_SESSION_ID,
-        bb: {
-            sessions: {
-                debug: vitest_1.vi.fn(async () => ({ debuggerUrl: MOCK_DEBUG_URL })),
-            },
-        },
-    })),
-}));
-vitest_1.vi.mock("../../lib/v3/launch/local", () => ({
-    launchLocalChrome: vitest_1.vi.fn(async () => ({
-        ws: "ws://local-cdp",
-        chrome: { kill: vitest_1.vi.fn(async () => { }) },
-    })),
-}));
-(0, vitest_1.describe)("browserbase accessors", () => {
-    (0, vitest_1.beforeEach)(() => {
-        process.env.BROWSERBASE_API_KEY = "fake-key";
-        process.env.BROWSERBASE_PROJECT_ID = "fake-project";
-    });
-    (0, vitest_1.afterEach)(() => {
-        delete process.env.BROWSERBASE_API_KEY;
-        delete process.env.BROWSERBASE_PROJECT_ID;
-        vitest_1.vi.clearAllMocks();
-    });
-    (0, vitest_1.it)("exposes Browserbase session and debug URLs after init", async () => {
-        const v3 = new v3_js_1.V3({
-            env: "BROWSERBASE",
-            disableAPI: true,
-            verbose: 0,
-        });
-        try {
-            await v3.init();
-            (0, vitest_1.expect)(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);
-            (0, vitest_1.expect)(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);
-            (0, vitest_1.expect)(v3.isCaptchaAutoSolveEnabled).toBe(true);
-        }
-        finally {
-            await v3.close().catch(() => { });
-        }
-    });
-    (0, vitest_1.it)("clears stored URLs after close", async () => {
-        const v3 = new v3_js_1.V3({
-            env: "BROWSERBASE",
-            disableAPI: true,
-            verbose: 0,
-        });
-        await v3.init();
-        await v3.close();
-        (0, vitest_1.expect)(v3.browserbaseSessionURL).toBeUndefined();
-        (0, vitest_1.expect)(v3.browserbaseDebugURL).toBeUndefined();
-    });
-    (0, vitest_1.it)("disables captcha solving when solveCaptchas is explicitly false", async () => {
-        const v3 = new v3_js_1.V3({
-            env: "BROWSERBASE",
-            disableAPI: true,
-            verbose: 0,
-            browserbaseSessionCreateParams: {
-                browserSettings: {
-                    solveCaptchas: false,
-                },
-            },
-        });
-        try {
-            await v3.init();
-            (0, vitest_1.expect)(v3.isCaptchaAutoSolveEnabled).toBe(false);
-        }
-        finally {
-            await v3.close().catch(() => { });
-        }
-    });
-    (0, vitest_1.it)("treats verified Browserbase sessions as managed fingerprinting mode", async () => {
-        const v3 = new v3_js_1.V3({
-            env: "BROWSERBASE",
-            disableAPI: true,
-            verbose: 0,
-            browserbaseSessionCreateParams: {
-                browserSettings: {
-                    verified: true,
-                },
-            },
-        });
-        try {
-            await v3.init();
-            (0, vitest_1.expect)(v3.isVerified).toBe(true);
-            (0, vitest_1.expect)(v3.isAdvancedStealth).toBe(true);
-        }
-        finally {
-            await v3.close().catch(() => { });
-        }
-    });
-});
-(0, vitest_1.describe)("local accessors", () => {
-    (0, vitest_1.it)("stay empty for LOCAL environments", async () => {
-        const v3 = new v3_js_1.V3({
-            env: "LOCAL",
-            disableAPI: true,
-            verbose: 0,
-            localBrowserLaunchOptions: {
-                cdpUrl: "ws://local-existing-session",
-            },
-        });
-        try {
-            await v3.init();
-            (0, vitest_1.expect)(v3.browserbaseSessionURL).toBeUndefined();
-            (0, vitest_1.expect)(v3.browserbaseDebugURL).toBeUndefined();
-        }
-        finally {
-            await v3.close().catch(() => { });
-        }
-    });
-});
-//# sourceMappingURL=browserbase-session-accessors.test.js.map

package/dist/cjs/tests/unit/browserbase-session-accessors.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"browserbase-session-accessors.test.js","sourceRoot":"","sources":["../../../../tests/unit/browserbase-session-accessors.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi, beforeEach, afterEach } from \"vitest\";\nimport { V3 } from \"../../lib/v3/v3.js\";\n\nconst MOCK_SESSION_ID = \"session-123\";\nconst MOCK_SESSION_URL = `https://www.browserbase.com/sessions/${MOCK_SESSION_ID}`;\nconst MOCK_DEBUG_URL = `https://debug.browserbase.com/${MOCK_SESSION_ID}`;\n\nvi.mock(\"../../lib/v3/understudy/context\", () => {\n  class MockConnection {\n    onTransportClosed = vi.fn();\n    offTransportClosed = vi.fn();\n    send = vi.fn(async () => {});\n  }\n\n  class MockV3Context {\n    static async create(): Promise<MockV3Context> {\n      return new MockV3Context();\n    }\n\n    conn = new MockConnection();\n\n    pages(): never[] {\n      return [];\n    }\n\n    async close(): Promise<void> {\n      // noop\n    }\n  }\n\n  return { V3Context: MockV3Context };\n});\n\nvi.mock(\"../../lib/v3/launch/browserbase\", () => ({\n  createBrowserbaseSession: vi.fn(async () => ({\n    ws: \"wss://mock-browserbase\",\n    sessionId: MOCK_SESSION_ID,\n    bb: {\n      sessions: {\n        debug: vi.fn(async () => ({ debuggerUrl: MOCK_DEBUG_URL })),\n      },\n    },\n  })),\n}));\n\nvi.mock(\"../../lib/v3/launch/local\", () => ({\n  launchLocalChrome: vi.fn(async () => ({\n    ws: \"ws://local-cdp\",\n    chrome: { kill: vi.fn(async () => {}) },\n  })),\n}));\n\ndescribe(\"browserbase accessors\", () => {\n  beforeEach(() => {\n    process.env.BROWSERBASE_API_KEY = \"fake-key\";\n    process.env.BROWSERBASE_PROJECT_ID = \"fake-project\";\n  });\n\n  afterEach(() => {\n    delete process.env.BROWSERBASE_API_KEY;\n    delete process.env.BROWSERBASE_PROJECT_ID;\n    vi.clearAllMocks();\n  });\n\n  it(\"exposes Browserbase session and debug URLs after init\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    try {\n      await v3.init();\n\n      expect(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);\n      expect(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);\n      expect(v3.isCaptchaAutoSolveEnabled).toBe(true);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n\n  it(\"clears stored URLs after close\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    await v3.init();\n    await v3.close();\n\n    expect(v3.browserbaseSessionURL).toBeUndefined();\n    expect(v3.browserbaseDebugURL).toBeUndefined();\n  });\n\n  it(\"disables captcha solving when solveCaptchas is explicitly false\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n      browserbaseSessionCreateParams: {\n        browserSettings: {\n          solveCaptchas: false,\n        },\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.isCaptchaAutoSolveEnabled).toBe(false);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n\n  it(\"treats verified Browserbase sessions as managed fingerprinting mode\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n      browserbaseSessionCreateParams: {\n        browserSettings: {\n          verified: true,\n        },\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.isVerified).toBe(true);\n      expect(v3.isAdvancedStealth).toBe(true);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n});\n\ndescribe(\"local accessors\", () => {\n  it(\"stay empty for LOCAL environments\", async () => {\n    const v3 = new V3({\n      env: \"LOCAL\",\n      disableAPI: true,\n      verbose: 0,\n      localBrowserLaunchOptions: {\n        cdpUrl: \"ws://local-existing-session\",\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.browserbaseSessionURL).toBeUndefined();\n      expect(v3.browserbaseDebugURL).toBeUndefined();\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n});\n"]}

package/dist/cjs/tests/unit/cache-llm-resolution.test.d.ts

@@ -1 +0,0 @@
-export {};