effect-browserbase 0.1.0-beta.102

package/dist/Launch-BHcAEq05.mjs

@@ -0,0 +1,111 @@
+import { AllocationAttempt } from "./References.mjs";
+import { BrowserError } from "./Errors.mjs";
+import { Viewport } from "./BrowserData.mjs";
+import { LaunchRecipe } from "./Launch.mjs";
+import { Effect, Redacted, Schema } from "effect";
+//#region src/internal/provider/Launch.ts
+const proxy = (rule) => rule.type === "external" ? {
+	type: rule.type,
+	server: rule.server,
+	...rule.domainPattern === void 0 ? {} : { domainPattern: rule.domainPattern },
+	...rule.username === void 0 ? {} : { username: Redacted.value(rule.username) },
+	...rule.password === void 0 ? {} : { password: Redacted.value(rule.password) }
+} : rule.type === "none" ? {
+	type: rule.type,
+	...rule.domainPattern === void 0 ? {} : { domainPattern: rule.domainPattern }
+} : {
+	type: rule.type,
+	...rule.domainPattern === void 0 ? {} : { domainPattern: rule.domainPattern },
+	...rule.geolocation === void 0 ? {} : { geolocation: { ...rule.geolocation } }
+};
+/** One validation/copy/compiler path. No legacy constructor or second default body exists. */
+const compileLaunch = Effect.fnUntraced(function* (input, identity) {
+	const recipe = yield* Schema.decodeUnknownEffect(LaunchRecipe)(input, { onExcessProperty: "error" }).pipe(Effect.mapError(() => BrowserError.make({
+		operation: "launch",
+		reason: "configuration",
+		outcome: "undispatched"
+	})));
+	const attempt = Object.freeze(AllocationAttempt.make({
+		...identity,
+		timeoutSeconds: recipe.remoteTimeoutSeconds
+	}));
+	const settings = recipe.provider.browserSettings ?? {};
+	const fail = () => BrowserError.make({
+		operation: "launch",
+		reason: "configuration",
+		outcome: "undispatched"
+	});
+	if (recipe.context !== void 0 && recipe.context.reference.projectId !== attempt.projectId || recipe.extension !== void 0 && recipe.extension.projectId !== attempt.projectId || settings.verified === true && recipe.viewport._tag !== "ProviderManaged" || settings.os !== void 0 && settings.verified !== true) return yield* fail();
+	const viewport = recipe.viewport._tag === "Fixed" ? yield* Schema.decodeEffect(Viewport)({
+		width: recipe.viewport.width,
+		height: recipe.viewport.height
+	}).pipe(Effect.mapError(fail)) : void 0;
+	if (Array.isArray(recipe.provider.proxies)) for (const rule of recipe.provider.proxies) {
+		if (rule.type === "browserbase" && rule.geolocation?.state !== void 0 && rule.geolocation.country !== "US") return yield* fail();
+		if (rule.type === "external") {
+			if (!(yield* Effect.try({
+				try: () => {
+					const url = new URL(rule.server);
+					return ["http:", "https:"].includes(url.protocol) && !url.username && !url.password && !url.hash;
+				},
+				catch: fail
+			}))) return yield* fail();
+		}
+	}
+	for (const domain of settings.allowedDomains ?? []) if (!(yield* Effect.try({
+		try: () => {
+			const url = new URL(`https://${domain}/`);
+			return !domain.includes("*") && url.hostname === domain && !url.port && !url.username && !url.password;
+		},
+		catch: fail
+	}))) return yield* fail();
+	const metadata = recipe.provider.userMetadata ?? {};
+	if (Object.keys(metadata).length > 32 || Object.keys(metadata).some((key) => key === "effectAgentAttempt" || key.startsWith("browserbaseIntegration"))) return yield* fail();
+	const keepAlive = recipe.keepAlive ?? false;
+	const context = recipe.context === void 0 ? void 0 : {
+		id: recipe.context.reference.contextId,
+		persist: recipe.context.persist
+	};
+	const recordSession = settings.recordSession ?? false;
+	const body = {
+		projectId: attempt.projectId,
+		timeout: recipe.remoteTimeoutSeconds,
+		keepAlive,
+		...recipe.provider.region === void 0 ? {} : { region: recipe.provider.region },
+		proxies: Array.isArray(recipe.provider.proxies) ? recipe.provider.proxies.map(proxy) : recipe.provider.proxies ?? false,
+		...recipe.provider.proxySettings === void 0 ? {} : { proxySettings: recipe.provider.proxySettings },
+		...recipe.extension === void 0 ? {} : { extensionId: recipe.extension.extensionId },
+		browserSettings: {
+			...settings,
+			recordSession,
+			logSession: settings.logSession ?? false,
+			solveCaptchas: settings.solveCaptchas ?? false,
+			...context === void 0 ? {} : { context },
+			...viewport === void 0 ? {} : { viewport: {
+				width: viewport.width,
+				height: viewport.height
+			} }
+		},
+		userMetadata: {
+			...metadata,
+			browserbaseIntegrationAttempt: attempt.attemptId
+		}
+	};
+	const encoded = yield* Effect.try({
+		try: () => JSON.stringify(body),
+		catch: fail
+	});
+	if (new TextEncoder().encode(encoded).length > 65536) return yield* fail();
+	return {
+		attempt,
+		body: yield* Schema.decodeEffect(Schema.fromJsonString(Schema.Json))(encoded).pipe(Effect.mapError(fail)),
+		viewport,
+		keepAlive,
+		context,
+		recordSession
+	};
+});
+//#endregion
+export { proxy as n, compileLaunch as t };
+
+//# sourceMappingURL=Launch-BHcAEq05.mjs.map

package/dist/Launch-BHcAEq05.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Launch-BHcAEq05.mjs","names":[],"sources":["../src/internal/provider/Launch.ts"],"sourcesContent":["import { Effect, Redacted, Schema } from \"effect\";\n\nimport { Viewport } from \"../../BrowserData.ts\";\nimport { BrowserError } from \"../../Errors.ts\";\nimport { LaunchRecipe, type ProxyRule } from \"../../Launch.ts\";\nimport { AllocationAttempt } from \"../../References.ts\";\n\nexport interface CompiledLaunch {\n  readonly attempt: AllocationAttempt;\n  readonly body: Schema.Json;\n  readonly viewport: Viewport | undefined;\n  readonly keepAlive: boolean;\n  readonly context: { readonly id: string; readonly persist: boolean } | undefined;\n  readonly recordSession: boolean;\n}\n\nexport const proxy = (rule: ProxyRule): Schema.Json =>\n  rule.type === \"external\"\n    ? {\n        type: rule.type,\n        server: rule.server,\n        ...(rule.domainPattern === undefined ? {} : { domainPattern: rule.domainPattern }),\n        ...(rule.username === undefined ? {} : { username: Redacted.value(rule.username) }),\n        ...(rule.password === undefined ? {} : { password: Redacted.value(rule.password) }),\n      }\n    : rule.type === \"none\"\n      ? {\n          type: rule.type,\n          ...(rule.domainPattern === undefined ? {} : { domainPattern: rule.domainPattern }),\n        }\n      : {\n          type: rule.type,\n          ...(rule.domainPattern === undefined ? {} : { domainPattern: rule.domainPattern }),\n          ...(rule.geolocation === undefined ? {} : { geolocation: { ...rule.geolocation } }),\n        };\n\n/** One validation/copy/compiler path. No legacy constructor or second default body exists. */\nexport const compileLaunch = Effect.fnUntraced(function* (\n  input: unknown,\n  identity: Pick<AllocationAttempt, \"projectId\" | \"attemptId\" | \"requestedAtMillis\">,\n): Effect.fn.Return<CompiledLaunch, BrowserError> {\n  const recipe = yield* Schema.decodeUnknownEffect(LaunchRecipe)(input, {\n    onExcessProperty: \"error\",\n  }).pipe(\n    Effect.mapError(() =>\n      BrowserError.make({ operation: \"launch\", reason: \"configuration\", outcome: \"undispatched\" }),\n    ),\n  );\n\n  const attempt = Object.freeze(\n    AllocationAttempt.make({ ...identity, timeoutSeconds: recipe.remoteTimeoutSeconds }),\n  );\n\n  const settings = recipe.provider.browserSettings ?? {};\n\n  const fail = () =>\n    BrowserError.make({ operation: \"launch\", reason: \"configuration\", outcome: \"undispatched\" });\n\n  // The qualified reference is the only extension spelling, so a foreign project cannot\n  // reach POST and there is no second alias whose precedence would have to be invented.\n  if (\n    (recipe.context !== undefined && recipe.context.reference.projectId !== attempt.projectId) ||\n    (recipe.extension !== undefined && recipe.extension.projectId !== attempt.projectId) ||\n    (settings.verified === true && recipe.viewport._tag !== \"ProviderManaged\") ||\n    (settings.os !== undefined && settings.verified !== true)\n  )\n    return yield* fail();\n\n  const viewport =\n    recipe.viewport._tag === \"Fixed\"\n      ? yield* Schema.decodeEffect(Viewport)({\n          width: recipe.viewport.width,\n          height: recipe.viewport.height,\n        }).pipe(Effect.mapError(fail))\n      : undefined;\n\n  if (Array.isArray(recipe.provider.proxies)) {\n    for (const rule of recipe.provider.proxies) {\n      if (\n        rule.type === \"browserbase\" &&\n        rule.geolocation?.state !== undefined &&\n        rule.geolocation.country !== \"US\"\n      )\n        return yield* fail();\n      if (rule.type === \"external\") {\n        const valid = yield* Effect.try({\n          try: () => {\n            const url = new URL(rule.server);\n\n            return (\n              [\"http:\", \"https:\"].includes(url.protocol) &&\n              !url.username &&\n              !url.password &&\n              !url.hash\n            );\n          },\n          catch: fail,\n        });\n\n        if (!valid) return yield* fail();\n      }\n    }\n  }\n  for (const domain of settings.allowedDomains ?? []) {\n    const valid = yield* Effect.try({\n      try: () => {\n        const url = new URL(`https://${domain}/`);\n\n        return (\n          !domain.includes(\"*\") &&\n          url.hostname === domain &&\n          !url.port &&\n          !url.username &&\n          !url.password\n        );\n      },\n      catch: fail,\n    });\n\n    if (!valid) return yield* fail();\n  }\n  const metadata = recipe.provider.userMetadata ?? {};\n\n  if (\n    Object.keys(metadata).length > 32 ||\n    Object.keys(metadata).some(\n      (key) => key === \"effectAgentAttempt\" || key.startsWith(\"browserbaseIntegration\"),\n    )\n  )\n    return yield* fail();\n  const keepAlive = recipe.keepAlive ?? false;\n\n  const context =\n    recipe.context === undefined\n      ? undefined\n      : { id: recipe.context.reference.contextId, persist: recipe.context.persist };\n\n  const recordSession = settings.recordSession ?? false;\n\n  const body = {\n    projectId: attempt.projectId,\n    timeout: recipe.remoteTimeoutSeconds,\n    keepAlive,\n    ...(recipe.provider.region === undefined ? {} : { region: recipe.provider.region }),\n    proxies: Array.isArray(recipe.provider.proxies)\n      ? recipe.provider.proxies.map(proxy)\n      : (recipe.provider.proxies ?? false),\n    ...(recipe.provider.proxySettings === undefined\n      ? {}\n      : { proxySettings: recipe.provider.proxySettings }),\n    ...(recipe.extension === undefined ? {} : { extensionId: recipe.extension.extensionId }),\n    browserSettings: {\n      ...settings,\n      recordSession,\n      logSession: settings.logSession ?? false,\n      solveCaptchas: settings.solveCaptchas ?? false,\n      ...(context === undefined ? {} : { context }),\n      ...(viewport === undefined\n        ? {}\n        : { viewport: { width: viewport.width, height: viewport.height } }),\n    },\n    userMetadata: { ...metadata, browserbaseIntegrationAttempt: attempt.attemptId },\n  };\n\n  // Own all nested values, including arrays. The admitted body never observes later caller mutation.\n  const encoded = yield* Effect.try({ try: () => JSON.stringify(body), catch: fail });\n\n  if (new TextEncoder().encode(encoded).length > 64 * 1024) return yield* fail();\n\n  const owned = yield* Schema.decodeEffect(Schema.fromJsonString(Schema.Json))(encoded).pipe(\n    Effect.mapError(fail),\n  );\n\n  return { attempt, body: owned, viewport, keepAlive, context, recordSession };\n});\n"],"mappings":"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"}

package/dist/Launch-C8CfaYxb.d.mts

@@ -0,0 +1,132 @@
+import { n as ContextReference, r as ExtensionReference } from "./References-URDAtapt.mjs";
+import { Schema } from "effect";
+declare namespace Launch_d_exports {
+  export { LaunchRecipe, ProviderLaunchOptions, ProxyRule, recipe };
+}
+declare const ProxyRule: Schema.Union<readonly [Schema.Struct<{
+  readonly type: Schema.Literal<"browserbase">;
+  readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly geolocation: Schema.optionalKey<Schema.Struct<{
+    readonly country: Schema.String;
+    readonly state: Schema.optionalKey<Schema.String>;
+    readonly city: Schema.optionalKey<Schema.NonEmptyString>;
+  }>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"external">;
+  readonly server: Schema.NonEmptyString;
+  readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly username: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+  readonly password: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+}>, Schema.Struct<{
+  readonly type: Schema.Literal<"none">;
+  readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+}>]>;
+type ProxyRule = typeof ProxyRule.Type;
+/** SDK 2.20 browser subset. Names follow Browserbase; ownership-managed fields are excluded. */
+declare const ProviderLaunchOptions: Schema.Struct<{
+  readonly region: Schema.optionalKey<Schema.Literals<readonly ["us-west-2", "us-east-1", "eu-central-1", "ap-southeast-1"]>>;
+  readonly proxies: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.Literal<"browserbase">;
+    readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly geolocation: Schema.optionalKey<Schema.Struct<{
+      readonly country: Schema.String;
+      readonly state: Schema.optionalKey<Schema.String>;
+      readonly city: Schema.optionalKey<Schema.NonEmptyString>;
+    }>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"external">;
+    readonly server: Schema.NonEmptyString;
+    readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly username: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+    readonly password: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+  }>, Schema.Struct<{
+    readonly type: Schema.Literal<"none">;
+    readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+  }>]>>]>>;
+  readonly proxySettings: Schema.optionalKey<Schema.Struct<{
+    readonly caCertificates: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+  }>>;
+  readonly browserSettings: Schema.optionalKey<Schema.Struct<{
+    readonly verified: Schema.optionalKey<Schema.Boolean>;
+    readonly os: Schema.optionalKey<Schema.Literals<readonly ["windows", "mac", "linux", "mobile", "tablet"]>>;
+    readonly allowedDomains: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    readonly blockAds: Schema.optionalKey<Schema.Boolean>;
+    readonly captchaImageSelector: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly captchaInputSelector: Schema.optionalKey<Schema.NonEmptyString>;
+    readonly ignoreCertificateErrors: Schema.optionalKey<Schema.Boolean>;
+    readonly logSession: Schema.optionalKey<Schema.Boolean>;
+    readonly recordSession: Schema.optionalKey<Schema.Boolean>;
+    readonly solveCaptchas: Schema.optionalKey<Schema.Boolean>;
+  }>>;
+  readonly userMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+}>;
+type ProviderLaunchOptions = typeof ProviderLaunchOptions.Type;
+/** Connection behavior and business budgets are not provider session lifetime. */
+declare const LaunchRecipe: Schema.Struct<{
+  readonly remoteTimeoutSeconds: Schema.Int;
+  readonly keepAlive: Schema.optionalKey<Schema.Boolean>;
+  readonly context: Schema.optionalKey<Schema.Struct<{
+    readonly reference: typeof ContextReference;
+    readonly persist: Schema.Boolean;
+  }>>;
+  /**
+   * Project-qualified selection of an already provisioned extension, never an upload. It is
+   * the only spelling: the compiler alone projects it to the provider's `extensionId`, so an
+   * unqualified identifier cannot reach the provider unchecked.
+   */
+  readonly extension: Schema.optionalKey<typeof ExtensionReference>;
+  readonly viewport: Schema.Union<readonly [Schema.Struct<{
+    readonly _tag: Schema.Literal<"ProviderManaged">;
+  }>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"Fixed">;
+    readonly width: Schema.Int;
+    readonly height: Schema.Int;
+  }>]>;
+  readonly provider: Schema.Struct<{
+    readonly region: Schema.optionalKey<Schema.Literals<readonly ["us-west-2", "us-east-1", "eu-central-1", "ap-southeast-1"]>>;
+    readonly proxies: Schema.optionalKey<Schema.Union<readonly [Schema.Boolean, Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+      readonly type: Schema.Literal<"browserbase">;
+      readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly geolocation: Schema.optionalKey<Schema.Struct<{
+        readonly country: Schema.String;
+        readonly state: Schema.optionalKey<Schema.String>;
+        readonly city: Schema.optionalKey<Schema.NonEmptyString>;
+      }>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"external">;
+      readonly server: Schema.NonEmptyString;
+      readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly username: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+      readonly password: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+    }>, Schema.Struct<{
+      readonly type: Schema.Literal<"none">;
+      readonly domainPattern: Schema.optionalKey<Schema.NonEmptyString>;
+    }>]>>]>>;
+    readonly proxySettings: Schema.optionalKey<Schema.Struct<{
+      readonly caCertificates: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+    }>>;
+    readonly browserSettings: Schema.optionalKey<Schema.Struct<{
+      readonly verified: Schema.optionalKey<Schema.Boolean>;
+      readonly os: Schema.optionalKey<Schema.Literals<readonly ["windows", "mac", "linux", "mobile", "tablet"]>>;
+      readonly allowedDomains: Schema.optionalKey<Schema.$Array<Schema.NonEmptyString>>;
+      readonly blockAds: Schema.optionalKey<Schema.Boolean>;
+      readonly captchaImageSelector: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly captchaInputSelector: Schema.optionalKey<Schema.NonEmptyString>;
+      readonly ignoreCertificateErrors: Schema.optionalKey<Schema.Boolean>;
+      readonly logSession: Schema.optionalKey<Schema.Boolean>;
+      readonly recordSession: Schema.optionalKey<Schema.Boolean>;
+      readonly solveCaptchas: Schema.optionalKey<Schema.Boolean>;
+    }>>;
+    readonly userMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+  }>;
+}>;
+type LaunchRecipe = typeof LaunchRecipe.Type;
+/**
+ * A recipe with the smallest reasonable choices filled in: a five-minute provider lifetime,
+ * a provider-managed viewport (which Verified requires) and no provider options. Privacy
+ * defaults are unchanged: recording, logging and captcha solving stay off unless requested.
+ */
+declare const recipe: (options?: Partial<LaunchRecipe>) => LaunchRecipe;
+//#endregion
+export { recipe as a, ProxyRule as i, Launch_d_exports as n, ProviderLaunchOptions as r, LaunchRecipe as t };
+//# sourceMappingURL=Launch-C8CfaYxb.d.mts.map

package/dist/Launch.d.mts

@@ -0,0 +1,2 @@
+import { a as recipe, i as ProxyRule, r as ProviderLaunchOptions, t as LaunchRecipe } from "./Launch-C8CfaYxb.mjs";
+export { LaunchRecipe, ProviderLaunchOptions, ProxyRule, recipe };

package/dist/Launch.mjs

@@ -0,0 +1,105 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { ContextReference, ExtensionReference, Identifier } from "./References.mjs";
+import { Viewport } from "./BrowserData.mjs";
+import { Schema } from "effect";
+//#region src/Launch.ts
+var Launch_exports = /* @__PURE__ */ __exportAll({
+	LaunchRecipe: () => LaunchRecipe,
+	ProviderLaunchOptions: () => ProviderLaunchOptions,
+	ProxyRule: () => ProxyRule,
+	recipe: () => recipe
+});
+const BoundedString = Schema.NonEmptyString.check(Schema.isMaxLength(1024));
+const ProxySecret = Schema.Redacted(Schema.String.check(Schema.isMaxLength(8192)));
+const Geolocation = Schema.Struct({
+	country: Schema.String.check(Schema.isPattern(/^[A-Z]{2}$/)),
+	state: Schema.optionalKey(Schema.String.check(Schema.isPattern(/^[A-Z]{2}$/))),
+	city: Schema.optionalKey(Schema.NonEmptyString.check(Schema.isMaxLength(256)))
+});
+const ProxyRule = Schema.Union([
+	Schema.Struct({
+		type: Schema.Literal("browserbase"),
+		domainPattern: Schema.optionalKey(BoundedString),
+		geolocation: Schema.optionalKey(Geolocation)
+	}),
+	Schema.Struct({
+		type: Schema.Literal("external"),
+		server: BoundedString,
+		domainPattern: Schema.optionalKey(BoundedString),
+		username: Schema.optionalKey(ProxySecret),
+		password: Schema.optionalKey(ProxySecret)
+	}),
+	Schema.Struct({
+		type: Schema.Literal("none"),
+		domainPattern: Schema.optionalKey(BoundedString)
+	})
+]);
+/** SDK 2.20 browser subset. Names follow Browserbase; ownership-managed fields are excluded. */
+const ProviderLaunchOptions = Schema.Struct({
+	region: Schema.optionalKey(Schema.Literals([
+		"us-west-2",
+		"us-east-1",
+		"eu-central-1",
+		"ap-southeast-1"
+	])),
+	proxies: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Array(ProxyRule).check(Schema.isMaxLength(64))])),
+	proxySettings: Schema.optionalKey(Schema.Struct({ caCertificates: Schema.optionalKey(Schema.Array(Identifier).check(Schema.isMaxLength(64), Schema.isUnique())) })),
+	browserSettings: Schema.optionalKey(Schema.Struct({
+		verified: Schema.optionalKey(Schema.Boolean),
+		os: Schema.optionalKey(Schema.Literals([
+			"windows",
+			"mac",
+			"linux",
+			"mobile",
+			"tablet"
+		])),
+		allowedDomains: Schema.optionalKey(Schema.Array(BoundedString).check(Schema.isMaxLength(64), Schema.isUnique())),
+		blockAds: Schema.optionalKey(Schema.Boolean),
+		captchaImageSelector: Schema.optionalKey(BoundedString),
+		captchaInputSelector: Schema.optionalKey(BoundedString),
+		ignoreCertificateErrors: Schema.optionalKey(Schema.Boolean),
+		logSession: Schema.optionalKey(Schema.Boolean),
+		recordSession: Schema.optionalKey(Schema.Boolean),
+		solveCaptchas: Schema.optionalKey(Schema.Boolean)
+	})),
+	userMetadata: Schema.optionalKey(Schema.Record(Schema.String.check(Schema.isMaxLength(128)), Schema.Json))
+});
+/** Connection behavior and business budgets are not provider session lifetime. */
+const LaunchRecipe = Schema.Struct({
+	remoteTimeoutSeconds: Schema.Int.check(Schema.isBetween({
+		minimum: 60,
+		maximum: 21600
+	})),
+	keepAlive: Schema.optionalKey(Schema.Boolean),
+	context: Schema.optionalKey(Schema.Struct({
+		reference: ContextReference,
+		persist: Schema.Boolean
+	})),
+	/**
+	* Project-qualified selection of an already provisioned extension, never an upload. It is
+	* the only spelling: the compiler alone projects it to the provider's `extensionId`, so an
+	* unqualified identifier cannot reach the provider unchecked.
+	*/
+	extension: Schema.optionalKey(ExtensionReference),
+	viewport: Schema.Union([Schema.Struct({ _tag: Schema.Literal("ProviderManaged") }), Schema.Struct({
+		_tag: Schema.Literal("Fixed"),
+		width: Viewport.fields.width,
+		height: Viewport.fields.height
+	})]),
+	provider: ProviderLaunchOptions
+});
+/**
+* A recipe with the smallest reasonable choices filled in: a five-minute provider lifetime,
+* a provider-managed viewport (which Verified requires) and no provider options. Privacy
+* defaults are unchanged: recording, logging and captcha solving stay off unless requested.
+*/
+const recipe = (options = {}) => ({
+	remoteTimeoutSeconds: 300,
+	viewport: { _tag: "ProviderManaged" },
+	provider: {},
+	...options
+});
+//#endregion
+export { LaunchRecipe, ProviderLaunchOptions, ProxyRule, recipe, Launch_exports as t };
+
+//# sourceMappingURL=Launch.mjs.map

package/dist/Launch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Launch.mjs","names":[],"sources":["../src/Launch.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nimport { Viewport } from \"./BrowserData.ts\";\nimport { ContextReference, ExtensionReference, Identifier } from \"./References.ts\";\n\nconst BoundedString = Schema.NonEmptyString.check(Schema.isMaxLength(1024));\nconst ProxySecret = Schema.Redacted(Schema.String.check(Schema.isMaxLength(8192)));\n\nconst Geolocation = Schema.Struct({\n  country: Schema.String.check(Schema.isPattern(/^[A-Z]{2}$/)),\n  state: Schema.optionalKey(Schema.String.check(Schema.isPattern(/^[A-Z]{2}$/))),\n  city: Schema.optionalKey(Schema.NonEmptyString.check(Schema.isMaxLength(256))),\n});\n\nexport const ProxyRule = Schema.Union([\n  Schema.Struct({\n    type: Schema.Literal(\"browserbase\"),\n    domainPattern: Schema.optionalKey(BoundedString),\n    geolocation: Schema.optionalKey(Geolocation),\n  }),\n  Schema.Struct({\n    type: Schema.Literal(\"external\"),\n    server: BoundedString,\n    domainPattern: Schema.optionalKey(BoundedString),\n    username: Schema.optionalKey(ProxySecret),\n    password: Schema.optionalKey(ProxySecret),\n  }),\n  Schema.Struct({ type: Schema.Literal(\"none\"), domainPattern: Schema.optionalKey(BoundedString) }),\n]);\n\nexport type ProxyRule = typeof ProxyRule.Type;\n\n/** SDK 2.20 browser subset. Names follow Browserbase; ownership-managed fields are excluded. */\nexport const ProviderLaunchOptions = Schema.Struct({\n  region: Schema.optionalKey(\n    Schema.Literals([\"us-west-2\", \"us-east-1\", \"eu-central-1\", \"ap-southeast-1\"]),\n  ),\n  proxies: Schema.optionalKey(\n    Schema.Union([Schema.Boolean, Schema.Array(ProxyRule).check(Schema.isMaxLength(64))]),\n  ),\n  proxySettings: Schema.optionalKey(\n    Schema.Struct({\n      caCertificates: Schema.optionalKey(\n        Schema.Array(Identifier).check(Schema.isMaxLength(64), Schema.isUnique()),\n      ),\n    }),\n  ),\n  browserSettings: Schema.optionalKey(\n    Schema.Struct({\n      verified: Schema.optionalKey(Schema.Boolean),\n      os: Schema.optionalKey(Schema.Literals([\"windows\", \"mac\", \"linux\", \"mobile\", \"tablet\"])),\n      allowedDomains: Schema.optionalKey(\n        Schema.Array(BoundedString).check(Schema.isMaxLength(64), Schema.isUnique()),\n      ),\n      blockAds: Schema.optionalKey(Schema.Boolean),\n      captchaImageSelector: Schema.optionalKey(BoundedString),\n      captchaInputSelector: Schema.optionalKey(BoundedString),\n      ignoreCertificateErrors: Schema.optionalKey(Schema.Boolean),\n      logSession: Schema.optionalKey(Schema.Boolean),\n      recordSession: Schema.optionalKey(Schema.Boolean),\n      solveCaptchas: Schema.optionalKey(Schema.Boolean),\n    }),\n  ),\n  userMetadata: Schema.optionalKey(\n    Schema.Record(Schema.String.check(Schema.isMaxLength(128)), Schema.Json),\n  ),\n});\n\nexport type ProviderLaunchOptions = typeof ProviderLaunchOptions.Type;\n\n/** Connection behavior and business budgets are not provider session lifetime. */\nexport const LaunchRecipe = Schema.Struct({\n  remoteTimeoutSeconds: Schema.Int.check(Schema.isBetween({ minimum: 60, maximum: 21600 })),\n  keepAlive: Schema.optionalKey(Schema.Boolean),\n  context: Schema.optionalKey(\n    Schema.Struct({ reference: ContextReference, persist: Schema.Boolean }),\n  ),\n  /**\n   * Project-qualified selection of an already provisioned extension, never an upload. It is\n   * the only spelling: the compiler alone projects it to the provider's `extensionId`, so an\n   * unqualified identifier cannot reach the provider unchecked.\n   */\n  extension: Schema.optionalKey(ExtensionReference),\n  viewport: Schema.Union([\n    Schema.Struct({ _tag: Schema.Literal(\"ProviderManaged\") }),\n    Schema.Struct({\n      _tag: Schema.Literal(\"Fixed\"),\n      width: Viewport.fields.width,\n      height: Viewport.fields.height,\n    }),\n  ]),\n  provider: ProviderLaunchOptions,\n});\n\nexport type LaunchRecipe = typeof LaunchRecipe.Type;\n\n/**\n * A recipe with the smallest reasonable choices filled in: a five-minute provider lifetime,\n * a provider-managed viewport (which Verified requires) and no provider options. Privacy\n * defaults are unchanged: recording, logging and captcha solving stay off unless requested.\n */\nexport const recipe = (options: Partial<LaunchRecipe> = {}): LaunchRecipe => ({\n  remoteTimeoutSeconds: 300,\n  viewport: { _tag: \"ProviderManaged\" },\n  provider: {},\n  ...options,\n});\n"],"mappings":"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"}

package/dist/PageControl.d.mts

@@ -0,0 +1,16 @@
+import { BrowserError } from "./Errors.mjs";
+import { D as PageSuspension, E as PageInfo, T as PageExecutionState } from "./BrowserData-LpcAuAub.mjs";
+import { BrowserbaseSession } from "./Browser.mjs";
+import { Effect } from "effect";
+declare namespace PageControl_d_exports {
+  export { PageExecutionState, PageSuspension, resume, state, suspend };
+}
+/** Last acknowledged state; no remote guarantee survives connection loss or external control. */
+export declare const state: <E>(session: BrowserbaseSession<E>, page: PageInfo) => Effect.Effect<PageExecutionState, BrowserError>;
+/** Explicit host-only hold requiring InteractiveOptions.pageControl; capture ACKs never invoke it. */
+export declare const suspend: <E>(session: BrowserbaseSession<E>, page: PageInfo) => Effect.Effect<PageSuspension, BrowserError>;
+/** Consumes the exact live receipt. Activation is intentional; stale receipts never replay commands. */
+export declare const resume: <E>(session: BrowserbaseSession<E>, receipt: PageSuspension) => Effect.Effect<void, BrowserError>;
+//#endregion
+export { PageExecutionState, PageSuspension, PageControl_d_exports as t };
+//# sourceMappingURL=PageControl.d.mts.map

package/dist/PageControl.mjs

@@ -0,0 +1,36 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { BrowserError } from "./Errors.mjs";
+import { PageExecutionState, PageInfo, PageSuspension } from "./BrowserData.mjs";
+import { n as pageControl } from "./PageControlAssociation-DabEg5AR.mjs";
+import { Effect, Schema } from "effect";
+//#region src/PageControl.ts
+var PageControl_exports = /* @__PURE__ */ __exportAll({
+	PageExecutionState: () => PageExecutionState,
+	PageSuspension: () => PageSuspension,
+	resume: () => resume,
+	state: () => state,
+	suspend: () => suspend
+});
+const owner = (session) => Effect.suspend(() => {
+	const port = pageControl(session);
+	return port === void 0 ? Effect.fail(BrowserError.make({
+		operation: "page-control",
+		reason: "unsupported",
+		outcome: "undispatched"
+	})) : Effect.succeed(port);
+});
+const invalid = () => BrowserError.make({
+	operation: "page-control",
+	reason: "configuration",
+	outcome: "undispatched"
+});
+/** Last acknowledged state; no remote guarantee survives connection loss or external control. */
+const state = (session, page) => Schema.decodeEffect(PageInfo)(page).pipe(Effect.mapError(invalid), Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))), Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.state(value)))));
+/** Explicit host-only hold requiring InteractiveOptions.pageControl; capture ACKs never invoke it. */
+const suspend = (session, page) => Schema.decodeEffect(PageInfo)(page).pipe(Effect.mapError(invalid), Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))), Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.suspend(value)))));
+/** Consumes the exact live receipt. Activation is intentional; stale receipts never replay commands. */
+const resume = (session, receipt) => Schema.decodeEffect(PageSuspension)(receipt).pipe(Effect.mapError(invalid), Effect.map((value) => Object.freeze(PageSuspension.make({ ...value }))), Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.resume(value)))));
+//#endregion
+export { PageExecutionState, PageSuspension, resume, state, suspend, PageControl_exports as t };
+
+//# sourceMappingURL=PageControl.mjs.map

package/dist/PageControl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageControl.mjs","names":[],"sources":["../src/PageControl.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\";\n\nimport type { BrowserbaseSession } from \"./Browser.ts\";\nimport { type PageExecutionState, PageInfo, PageSuspension } from \"./BrowserData.ts\";\nimport { BrowserError } from \"./Errors.ts\";\nimport { pageControl } from \"./internal/browser/PageControlAssociation.ts\";\nexport { PageExecutionState, PageSuspension } from \"./BrowserData.ts\";\n\nconst owner = <E>(session: BrowserbaseSession<E>) =>\n  Effect.suspend(() => {\n    const port = pageControl(session);\n\n    return port === undefined\n      ? Effect.fail(\n          BrowserError.make({\n            operation: \"page-control\",\n            reason: \"unsupported\",\n            outcome: \"undispatched\",\n          }),\n        )\n      : Effect.succeed(port);\n  });\n\nconst invalid = () =>\n  BrowserError.make({\n    operation: \"page-control\",\n    reason: \"configuration\",\n    outcome: \"undispatched\",\n  });\n\n/** Last acknowledged state; no remote guarantee survives connection loss or external control. */\nexport const state = <E>(\n  session: BrowserbaseSession<E>,\n  page: PageInfo,\n): Effect.Effect<PageExecutionState, BrowserError> =>\n  Schema.decodeEffect(PageInfo)(page).pipe(\n    Effect.mapError(invalid),\n    Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))),\n    Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.state(value)))),\n  );\n\n/** Explicit host-only hold requiring InteractiveOptions.pageControl; capture ACKs never invoke it. */\nexport const suspend = <E>(\n  session: BrowserbaseSession<E>,\n  page: PageInfo,\n): Effect.Effect<PageSuspension, BrowserError> =>\n  Schema.decodeEffect(PageInfo)(page).pipe(\n    Effect.mapError(invalid),\n    Effect.map((value) => Object.freeze(PageInfo.make({ ...value }))),\n    Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.suspend(value)))),\n  );\n\n/** Consumes the exact live receipt. Activation is intentional; stale receipts never replay commands. */\nexport const resume = <E>(\n  session: BrowserbaseSession<E>,\n  receipt: PageSuspension,\n): Effect.Effect<void, BrowserError> =>\n  Schema.decodeEffect(PageSuspension)(receipt).pipe(\n    Effect.mapError(invalid),\n    Effect.map((value) => Object.freeze(PageSuspension.make({ ...value }))),\n    Effect.flatMap((value) => owner(session).pipe(Effect.flatMap((port) => port.resume(value)))),\n  );\n"],"mappings":";;;;;;;;;;;;;AAQA,MAAM,SAAY,YAChB,OAAO,cAAc;CACnB,MAAM,OAAO,YAAY,OAAO;CAEhC,OAAO,SAAS,KAAA,IACZ,OAAO,KACL,aAAa,KAAK;EAChB,WAAW;EACX,QAAQ;EACR,SAAS;CACX,CAAC,CACH,IACA,OAAO,QAAQ,IAAI;AACzB,CAAC;AAEH,MAAM,gBACJ,aAAa,KAAK;CAChB,WAAW;CACX,QAAQ;CACR,SAAS;AACX,CAAC;;AAGH,MAAa,SACX,SACA,SAEA,OAAO,aAAa,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,KAClC,OAAO,SAAS,OAAO,GACvB,OAAO,KAAK,UAAU,OAAO,OAAO,SAAS,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAChE,OAAO,SAAS,UAAU,MAAM,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,SAAS,KAAK,MAAM,KAAK,CAAC,CAAC,CAAC,CAC5F;;AAGF,MAAa,WACX,SACA,SAEA,OAAO,aAAa,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,KAClC,OAAO,SAAS,OAAO,GACvB,OAAO,KAAK,UAAU,OAAO,OAAO,SAAS,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GAChE,OAAO,SAAS,UAAU,MAAM,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,SAAS,KAAK,QAAQ,KAAK,CAAC,CAAC,CAAC,CAC9F;;AAGF,MAAa,UACX,SACA,YAEA,OAAO,aAAa,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,KAC3C,OAAO,SAAS,OAAO,GACvB,OAAO,KAAK,UAAU,OAAO,OAAO,eAAe,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,GACtE,OAAO,SAAS,UAAU,MAAM,OAAO,CAAC,CAAC,KAAK,OAAO,SAAS,SAAS,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC,CAC7F"}

package/dist/PageControlAssociation-DabEg5AR.mjs

@@ -0,0 +1,10 @@
+//#region src/internal/browser/PageControlAssociation.ts
+const owners = /* @__PURE__ */ new WeakMap();
+const associatePageControl = (session, port) => {
+	owners.set(session, port);
+};
+const pageControl = (session) => owners.get(session);
+//#endregion
+export { pageControl as n, associatePageControl as t };
+
+//# sourceMappingURL=PageControlAssociation-DabEg5AR.mjs.map

package/dist/PageControlAssociation-DabEg5AR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageControlAssociation-DabEg5AR.mjs","names":[],"sources":["../src/internal/browser/PageControlAssociation.ts"],"sourcesContent":["import type { Effect } from \"effect\";\n\nimport type { PageExecutionState, PageInfo, PageSuspension } from \"../../BrowserData.ts\";\nimport type { BrowserError } from \"../../Errors.ts\";\n\nexport interface PageControlPort {\n  readonly state: (page: PageInfo) => Effect.Effect<PageExecutionState, BrowserError>;\n  readonly suspend: (page: PageInfo) => Effect.Effect<PageSuspension, BrowserError>;\n  readonly resume: (receipt: PageSuspension) => Effect.Effect<void, BrowserError>;\n}\n\nconst owners = new WeakMap<object, PageControlPort>();\n\nexport const associatePageControl = (session: object, port: PageControlPort): void => {\n  owners.set(session, port);\n};\n\nexport const pageControl = (session: object): PageControlPort | undefined => owners.get(session);\n"],"mappings":";AAWA,MAAM,yBAAS,IAAI,QAAiC;AAEpD,MAAa,wBAAwB,SAAiB,SAAgC;CACpF,OAAO,IAAI,SAAS,IAAI;AAC1B;AAEA,MAAa,eAAe,YAAiD,OAAO,IAAI,OAAO"}

package/dist/PageFetch.d.mts

@@ -0,0 +1,40 @@
+import { PlatformError } from "./Errors.mjs";
+import { t as BrowserbaseClient } from "./Client-Ca0zSg1n.mjs";
+import { Context, Effect, Layer, Schema } from "effect";
+declare namespace PageFetch_d_exports {
+  export { BrowserbasePageFetch, PageFetchRequest, PageFetchResult };
+}
+export declare const PageFetchRequest: Schema.Struct<{
+  readonly url: Schema.NonEmptyString;
+  readonly allowRedirects: Schema.optionalKey<Schema.Boolean>;
+  readonly allowInsecureSsl: Schema.optionalKey<Schema.Boolean>;
+  readonly proxies: Schema.optionalKey<Schema.Boolean>;
+  /** `raw` by default; `json` extracts with `schema`, `markdown` converts the page. */
+  readonly format: Schema.optionalKey<Schema.Literals<readonly ["raw", "json", "markdown"]>>;
+  /** A JSON Schema describing the object to extract when `format` is `json`. */
+  readonly schema: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+}>;
+export type PageFetchRequest = typeof PageFetchRequest.Type;
+declare const PageFetchResult_base: Schema.Class<PageFetchResult, Schema.Struct<{
+  readonly id: Schema.String;
+  readonly statusCode: Schema.Int;
+  readonly headers: Schema.$Record<Schema.String, Schema.String>;
+  readonly content: Schema.Union<readonly [Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>]>;
+  readonly contentType: Schema.String;
+  readonly encoding: Schema.String;
+}>, {}>;
+export declare class PageFetchResult extends PageFetchResult_base {}
+declare const BrowserbasePageFetch_base: Context.ServiceClass<BrowserbasePageFetch, "effect-browserbase/PageFetch", {
+  readonly fetch: (request: PageFetchRequest) => Effect.Effect<PageFetchResult, PlatformError>;
+}>;
+/**
+ * Browserbase's Fetch API: one page retrieved by the provider without a browser session.
+ * Replies are bounded by the 1 MiB control-plane limit (`reason: "limit"`); each call is
+ * billed and never retried. `statusCode` is the target site's status, not the API's.
+ */
+export declare class BrowserbasePageFetch extends BrowserbasePageFetch_base {
+  static readonly layer: Layer.Layer<BrowserbasePageFetch, never, BrowserbaseClient>;
+}
+//#endregion
+export { PageFetch_d_exports as t };
+//# sourceMappingURL=PageFetch.d.mts.map

package/dist/PageFetch.mjs

@@ -0,0 +1,64 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { PlatformError } from "./Errors.mjs";
+import { t as BrowserbaseClient } from "./Client-D1_xYM9o.mjs";
+import { t as resource } from "./Resource-DBksC4zB.mjs";
+import { Context, Effect, Layer, Schema } from "effect";
+//#region src/PageFetch.ts
+var PageFetch_exports = /* @__PURE__ */ __exportAll({
+	BrowserbasePageFetch: () => BrowserbasePageFetch,
+	PageFetchRequest: () => PageFetchRequest,
+	PageFetchResult: () => PageFetchResult
+});
+const HttpUrl = Schema.NonEmptyString.check(Schema.isMaxLength(8192), Schema.makeFilter((value) => {
+	try {
+		const url = new URL(value);
+		return (url.protocol === "https:" || url.protocol === "http:") && !url.username && !url.password;
+	} catch {
+		return false;
+	}
+}));
+const PageFetchRequest = Schema.Struct({
+	url: HttpUrl,
+	allowRedirects: Schema.optionalKey(Schema.Boolean),
+	allowInsecureSsl: Schema.optionalKey(Schema.Boolean),
+	proxies: Schema.optionalKey(Schema.Boolean),
+	/** `raw` by default; `json` extracts with `schema`, `markdown` converts the page. */
+	format: Schema.optionalKey(Schema.Literals([
+		"raw",
+		"json",
+		"markdown"
+	])),
+	/** A JSON Schema describing the object to extract when `format` is `json`. */
+	schema: Schema.optionalKey(Schema.Record(Schema.String, Schema.Json))
+});
+var PageFetchResult = class extends Schema.Class("BrowserbasePageFetchResult")({
+	id: Schema.String.check(Schema.isMaxLength(256)),
+	statusCode: Schema.Int,
+	headers: Schema.Record(Schema.String, Schema.String),
+	content: Schema.Union([Schema.String, Schema.Json]),
+	contentType: Schema.String.check(Schema.isMaxLength(1024)),
+	encoding: Schema.String.check(Schema.isMaxLength(64))
+}) {};
+/**
+* Browserbase's Fetch API: one page retrieved by the provider without a browser session.
+* Replies are bounded by the 1 MiB control-plane limit (`reason: "limit"`); each call is
+* billed and never retried. `statusCode` is the target site's status, not the API's.
+*/
+var BrowserbasePageFetch = class BrowserbasePageFetch extends Context.Service()("effect-browserbase/PageFetch") {
+	static layer = Layer.effect(BrowserbasePageFetch, Effect.gen(function* () {
+		const api = resource(yield* BrowserbaseClient, (failure) => PlatformError.make({
+			...failure,
+			service: "fetch"
+		}));
+		const fetch = Effect.fn("BrowserbasePageFetch.fetch")(function* (request) {
+			const value = yield* api.input(PageFetchRequest, request, "fetch");
+			if (value.schema !== void 0 && value.format !== "json") return yield* api.configuration("fetch");
+			return yield* api.request("POST", "/v1/fetch", PageFetchResult, "fetch", value);
+		});
+		return BrowserbasePageFetch.of({ fetch });
+	}));
+};
+//#endregion
+export { BrowserbasePageFetch, PageFetchRequest, PageFetchResult, PageFetch_exports as t };
+
+//# sourceMappingURL=PageFetch.mjs.map

package/dist/PageFetch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageFetch.mjs","names":[],"sources":["../src/PageFetch.ts"],"sourcesContent":["import { Context, Effect, Layer, Schema } from \"effect\";\n\nimport { BrowserbaseClient } from \"./Client.ts\";\nimport { PlatformError } from \"./Errors.ts\";\nimport { resource } from \"./internal/http/Resource.ts\";\n\nconst HttpUrl = Schema.NonEmptyString.check(\n  Schema.isMaxLength(8192),\n  Schema.makeFilter((value) => {\n    try {\n      const url = new URL(value);\n\n      return (\n        (url.protocol === \"https:\" || url.protocol === \"http:\") && !url.username && !url.password\n      );\n    } catch {\n      return false;\n    }\n  }),\n);\n\nexport const PageFetchRequest = Schema.Struct({\n  url: HttpUrl,\n  allowRedirects: Schema.optionalKey(Schema.Boolean),\n  allowInsecureSsl: Schema.optionalKey(Schema.Boolean),\n  proxies: Schema.optionalKey(Schema.Boolean),\n  /** `raw` by default; `json` extracts with `schema`, `markdown` converts the page. */\n  format: Schema.optionalKey(Schema.Literals([\"raw\", \"json\", \"markdown\"])),\n  /** A JSON Schema describing the object to extract when `format` is `json`. */\n  schema: Schema.optionalKey(Schema.Record(Schema.String, Schema.Json)),\n});\n\nexport type PageFetchRequest = typeof PageFetchRequest.Type;\n\nexport class PageFetchResult extends Schema.Class<PageFetchResult>(\"BrowserbasePageFetchResult\")({\n  id: Schema.String.check(Schema.isMaxLength(256)),\n  statusCode: Schema.Int,\n  headers: Schema.Record(Schema.String, Schema.String),\n  content: Schema.Union([Schema.String, Schema.Json]),\n  contentType: Schema.String.check(Schema.isMaxLength(1024)),\n  encoding: Schema.String.check(Schema.isMaxLength(64)),\n}) {}\n\n/**\n * Browserbase's Fetch API: one page retrieved by the provider without a browser session.\n * Replies are bounded by the 1 MiB control-plane limit (`reason: \"limit\"`); each call is\n * billed and never retried. `statusCode` is the target site's status, not the API's.\n */\nexport class BrowserbasePageFetch extends Context.Service<\n  BrowserbasePageFetch,\n  {\n    readonly fetch: (request: PageFetchRequest) => Effect.Effect<PageFetchResult, PlatformError>;\n  }\n>()(\"effect-browserbase/PageFetch\") {\n  static readonly layer: Layer.Layer<BrowserbasePageFetch, never, BrowserbaseClient> = Layer.effect(\n    BrowserbasePageFetch,\n    Effect.gen(function* () {\n      const api = resource<PlatformError>(yield* BrowserbaseClient, (failure) =>\n        PlatformError.make({ ...failure, service: \"fetch\" }),\n      );\n\n      const fetch = Effect.fn(\"BrowserbasePageFetch.fetch\")(function* (request: PageFetchRequest) {\n        const value = yield* api.input(PageFetchRequest, request, \"fetch\");\n\n        if (value.schema !== undefined && value.format !== \"json\")\n          return yield* api.configuration(\"fetch\");\n\n        return yield* api.request(\"POST\", \"/v1/fetch\", PageFetchResult, \"fetch\", value);\n      });\n\n      return BrowserbasePageFetch.of({ fetch });\n    }),\n  );\n}\n"],"mappings":";;;;;;;;;;;AAMA,MAAM,UAAU,OAAO,eAAe,MACpC,OAAO,YAAY,IAAI,GACvB,OAAO,YAAY,UAAU;CAC3B,IAAI;EACF,MAAM,MAAM,IAAI,IAAI,KAAK;EAEzB,QACG,IAAI,aAAa,YAAY,IAAI,aAAa,YAAY,CAAC,IAAI,YAAY,CAAC,IAAI;CAErF,QAAQ;EACN,OAAO;CACT;AACF,CAAC,CACH;AAEA,MAAa,mBAAmB,OAAO,OAAO;CAC5C,KAAK;CACL,gBAAgB,OAAO,YAAY,OAAO,OAAO;CACjD,kBAAkB,OAAO,YAAY,OAAO,OAAO;CACnD,SAAS,OAAO,YAAY,OAAO,OAAO;;CAE1C,QAAQ,OAAO,YAAY,OAAO,SAAS;EAAC;EAAO;EAAQ;CAAU,CAAC,CAAC;;CAEvE,QAAQ,OAAO,YAAY,OAAO,OAAO,OAAO,QAAQ,OAAO,IAAI,CAAC;AACtE,CAAC;AAID,IAAa,kBAAb,cAAqC,OAAO,MAAuB,4BAA4B,CAAC,CAAC;CAC/F,IAAI,OAAO,OAAO,MAAM,OAAO,YAAY,GAAG,CAAC;CAC/C,YAAY,OAAO;CACnB,SAAS,OAAO,OAAO,OAAO,QAAQ,OAAO,MAAM;CACnD,SAAS,OAAO,MAAM,CAAC,OAAO,QAAQ,OAAO,IAAI,CAAC;CAClD,aAAa,OAAO,OAAO,MAAM,OAAO,YAAY,IAAI,CAAC;CACzD,UAAU,OAAO,OAAO,MAAM,OAAO,YAAY,EAAE,CAAC;AACtD,CAAC,CAAC,CAAC,CAAC;;;;;;AAOJ,IAAa,uBAAb,MAAa,6BAA6B,QAAQ,QAKhD,CAAC,CAAC,8BAA8B,CAAC,CAAC;CAClC,OAAgB,QAAqE,MAAM,OACzF,sBACA,OAAO,IAAI,aAAa;EACtB,MAAM,MAAM,SAAwB,OAAO,oBAAoB,YAC7D,cAAc,KAAK;GAAE,GAAG;GAAS,SAAS;EAAQ,CAAC,CACrD;EAEA,MAAM,QAAQ,OAAO,GAAG,4BAA4B,CAAC,CAAC,WAAW,SAA2B;GAC1F,MAAM,QAAQ,OAAO,IAAI,MAAM,kBAAkB,SAAS,OAAO;GAEjE,IAAI,MAAM,WAAW,KAAA,KAAa,MAAM,WAAW,QACjD,OAAO,OAAO,IAAI,cAAc,OAAO;GAEzC,OAAO,OAAO,IAAI,QAAQ,QAAQ,aAAa,iBAAiB,SAAS,KAAK;EAChF,CAAC;EAED,OAAO,qBAAqB,GAAG,EAAE,MAAM,CAAC;CAC1C,CAAC,CACH;AACF"}

package/dist/Projects.d.mts

@@ -0,0 +1,39 @@
+import { ProjectError } from "./Errors.mjs";
+import { t as BrowserbaseClient } from "./Client-Ca0zSg1n.mjs";
+import { Context, Effect, Layer, Schema } from "effect";
+declare namespace Projects_d_exports {
+  export { BrowserbaseProjects, ProjectMetadata, ProjectUsage };
+}
+declare const ProjectMetadata_base: Schema.Class<ProjectMetadata, Schema.Struct<{
+  readonly projectId: Schema.NonEmptyString;
+  readonly name: Schema.String;
+  readonly ownerId: Schema.String;
+  /** Default provider session lifetime in seconds. */
+  readonly defaultTimeout: Schema.Int;
+  /** Maximum concurrent sessions. */
+  readonly concurrency: Schema.Int;
+  readonly createdAt: Schema.String;
+  readonly updatedAt: Schema.String;
+}>, {}>;
+export declare class ProjectMetadata extends ProjectMetadata_base {}
+declare const ProjectUsage_base: Schema.Class<ProjectUsage, Schema.Struct<{
+  readonly projectId: Schema.NonEmptyString;
+  readonly browserMinutes: Schema.Natural;
+  readonly proxyBytes: Schema.Natural;
+}>, {}>;
+export declare class ProjectUsage extends ProjectUsage_base {}
+declare const BrowserbaseProjects_base: Context.ServiceClass<BrowserbaseProjects, "effect-browserbase/Projects", {
+  readonly list: Effect.Effect<ReadonlyArray<ProjectMetadata>, ProjectError>;
+  readonly retrieve: Effect.Effect<ProjectMetadata, ProjectError>;
+  readonly usage: Effect.Effect<ProjectUsage, ProjectError>;
+}>;
+/**
+ * Passive project inspection. `retrieve` and `usage` read the Client's own project; `list`
+ * reports every project the API key can see. Nothing here changes provider state.
+ */
+export declare class BrowserbaseProjects extends BrowserbaseProjects_base {
+  static readonly layer: Layer.Layer<BrowserbaseProjects, never, BrowserbaseClient>;
+}
+//#endregion
+export { Projects_d_exports as t };
+//# sourceMappingURL=Projects.d.mts.map