effect-browserbase 0.2.0-beta.8 → 0.3.0-beta.10

package/dist/BrowserbaseClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserbaseClient.mjs","names":[],"sources":["../src/BrowserbaseClient.ts"],"sourcesContent":["/**\n * A small client for the Browserbase REST API: sessions, stored contexts, extensions, web search\n * and page fetch.\n *\n * It runs on the `HttpClient` the application provides, such as `FetchHttpClient.layer`. The API\n * key travels only in the `X-BB-API-Key` header and is redacted from logs and traces. Redirects\n * are refused rather than followed, because following one would send the key wherever it points.\n *\n * Every request has a deadline, so a provider that never answers cannot hold a caller's scope open.\n * Reads are retried twice on transient failures. Writes are not: a session create that fails in\n * transit or misses its deadline may still have created the session, which then ends at its timeout.\n *\n * @since 0.3.0\n */\nimport {\n  Config,\n  Context,\n  Duration,\n  Effect,\n  Exit,\n  flow,\n  identity,\n  Layer,\n  Option,\n  Redacted,\n  Schedule,\n  Schema,\n} from \"effect\";\nimport {\n  FetchHttpClient,\n  Headers,\n  HttpClient,\n  HttpClientRequest,\n  HttpClientResponse,\n} from \"effect/http\";\n\nimport {\n  BrowserbaseError,\n  Decode,\n  InvalidRequest,\n  isTransient,\n  NotFound,\n  RateLimited,\n  type Reason,\n  Status,\n  Transport,\n  Unauthorized,\n} from \"./BrowserbaseError.ts\";\n\nexport const defaultBaseUrl = \"https://api.browserbase.com\";\n\nexport class Session extends Schema.Class<Session>(\"effect-browserbase/Session\")({\n  id: Schema.String,\n  /** `PENDING`, `RUNNING`, `ERROR`, `TIMED_OUT` or `COMPLETED`, kept open for new values. */\n  status: Schema.String,\n  region: Schema.String,\n  keepAlive: Schema.Boolean,\n  createdAt: Schema.String,\n  expiresAt: Schema.String,\n  endedAt: Schema.optional(Schema.String),\n  contextId: Schema.optional(Schema.String),\n  proxyBytes: Schema.optional(Schema.Finite),\n  userMetadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),\n  /** The CDP WebSocket address, a credential. Only create and get return it. */\n  connectUrl: Schema.optional(Schema.RedactedFromValue(Schema.String)),\n}) {}\n\n/** Links that let a person watch and control a running session. They are credentials. */\nexport class LiveView extends Schema.Class<LiveView>(\"effect-browserbase/LiveView\")({\n  /** The active tab, without browser chrome: suited to an iframe. */\n  debuggerFullscreenUrl: Schema.RedactedFromValue(Schema.String),\n  debuggerUrl: Schema.RedactedFromValue(Schema.String),\n  pages: Schema.Array(\n    Schema.Struct({\n      id: Schema.String,\n      url: Schema.String,\n      title: Schema.String,\n      debuggerFullscreenUrl: Schema.RedactedFromValue(Schema.String),\n    }),\n  ),\n}) {}\n\n/** Browser state (cookies, storage, cache) kept by Browserbase for sessions to load and save. */\nexport class StoredContext extends Schema.Class<StoredContext>(\"effect-browserbase/StoredContext\")({\n  id: Schema.String,\n  name: Schema.optional(Schema.String),\n  /** `getContext` returns the timestamps; `createContext` does not. */\n  createdAt: Schema.optional(Schema.String),\n  updatedAt: Schema.optional(Schema.String),\n}) {}\n\n/** A Chrome extension uploaded to the project, which sessions load when created with its id. */\nexport class Extension extends Schema.Class<Extension>(\"effect-browserbase/Extension\")({\n  id: Schema.String,\n  fileName: Schema.String,\n  createdAt: Schema.String,\n  updatedAt: Schema.String,\n}) {}\n\nexport class SearchResult extends Schema.Class<SearchResult>(\"effect-browserbase/SearchResult\")({\n  url: Schema.String,\n  title: Schema.String,\n  author: Schema.optional(Schema.String),\n  publishedDate: Schema.optional(Schema.String),\n}) {}\n\n/** A page fetched without a browser. */\nexport class FetchedPage extends Schema.Class<FetchedPage>(\"effect-browserbase/FetchedPage\")({\n  statusCode: Schema.Finite,\n  contentType: Schema.String,\n  headers: Schema.Record(Schema.String, Schema.String),\n  /** Text for the `raw` and `markdown` formats; the extracted object for `json`. */\n  content: Schema.Union([Schema.String, Schema.Record(Schema.String, Schema.Unknown)]),\n}) {}\n\n/** A session create request, as Browserbase's API reference describes it. */\nexport interface SessionOptions {\n  /** Defaults to the API key's project. */\n  readonly projectId?: string | undefined;\n  /** An uploaded extension for the browser to load. It makes the session slower to start. */\n  readonly extensionId?: string | undefined;\n  /** Seconds until Browserbase ends the session, from 60 to 21,600. Defaults to the project's. */\n  readonly timeout?: number | undefined;\n  /** Keep the session running after every client disconnects, until released or timed out. */\n  readonly keepAlive?: boolean | undefined;\n  readonly region?: \"us-west-2\" | \"us-east-1\" | \"eu-central-1\" | \"ap-southeast-1\" | undefined;\n  /** `true` for Browserbase's proxies, or rules per domain. */\n  readonly proxies?: boolean | ReadonlyArray<ProxyRule> | undefined;\n  /** Labels that `listSessions` can query. */\n  readonly userMetadata?: Readonly<Record<string, unknown>> | undefined;\n  readonly browserSettings?: BrowserSettings | undefined;\n}\n\n/** Browser settings. Left unset, each takes Browserbase's default. */\nexport interface BrowserSettings {\n  /**\n   * Load a stored context. With `persist`, Browserbase saves the session's changes back to it once\n   * the session ends; `Browserbase.open` lets one such session at a time write to each context.\n   */\n  readonly context?: { readonly id: string; readonly persist?: boolean | undefined } | undefined;\n  readonly viewport?: { readonly width: number; readonly height: number } | undefined;\n  readonly blockAds?: boolean | undefined;\n  /** Browserbase solves captchas unless this is false. */\n  readonly solveCaptchas?: boolean | undefined;\n  /** Browserbase records the session for replay unless this is false. */\n  readonly recordSession?: boolean | undefined;\n  /** Browserbase keeps the session's logs unless this is false. */\n  readonly logSession?: boolean | undefined;\n  /** Verified browser mode, on plans that include it. */\n  readonly verified?: boolean | undefined;\n  readonly os?: \"windows\" | \"mac\" | \"linux\" | \"mobile\" | \"tablet\" | undefined;\n  /** Restrict top-level navigation to these domains and their subdomains. */\n  readonly allowedDomains?: ReadonlyArray<string> | undefined;\n  readonly ignoreCertificateErrors?: boolean | undefined;\n}\n\nexport type ProxyRule =\n  | {\n      readonly type: \"browserbase\";\n      readonly geolocation?:\n        | {\n            readonly country: string;\n            readonly state?: string | undefined;\n            readonly city?: string | undefined;\n          }\n        | undefined;\n      readonly domainPattern?: string | undefined;\n    }\n  | {\n      readonly type: \"external\";\n      readonly server: string;\n      readonly username?: string | undefined;\n      readonly password?: string | undefined;\n      readonly domainPattern?: string | undefined;\n    }\n  | { readonly type: \"none\"; readonly domainPattern?: string | undefined };\n\nexport interface FetchOptions {\n  /** `raw` (the default) returns the body as is; `json` needs `schema`. */\n  readonly format?: \"raw\" | \"markdown\" | \"json\" | undefined;\n  /** JSON Schema of the object to extract with the `json` format. */\n  readonly schema?: Readonly<Record<string, unknown>> | undefined;\n  readonly allowRedirects?: boolean | undefined;\n  readonly allowInsecureSsl?: boolean | undefined;\n  readonly proxies?: boolean | undefined;\n}\n\nexport interface Service {\n  readonly createSession: (options?: SessionOptions) => Effect.Effect<Session, BrowserbaseError>;\n  readonly getSession: (id: string) => Effect.Effect<Session, BrowserbaseError>;\n  /** Sessions with the given status, or all. `query` filters on user metadata, in Browserbase's syntax. */\n  readonly listSessions: (options?: {\n    readonly status?: string | undefined;\n    readonly query?: string | undefined;\n  }) => Effect.Effect<ReadonlyArray<Session>, BrowserbaseError>;\n  /** End the session now, which stops its billing. Ending an ended session succeeds. */\n  readonly releaseSession: (id: string) => Effect.Effect<void, BrowserbaseError>;\n  /** Live view links. They last `expiresInSeconds`, or as long as the session. */\n  readonly liveView: (\n    id: string,\n    options?: { readonly expiresInSeconds?: number | undefined },\n  ) => Effect.Effect<LiveView, BrowserbaseError>;\n  readonly createContext: (options?: {\n    readonly name?: string | undefined;\n  }) => Effect.Effect<StoredContext, BrowserbaseError>;\n  readonly getContext: (id: string) => Effect.Effect<StoredContext, BrowserbaseError>;\n  /** Delete a stored context for good. Sessions can no longer load it. */\n  readonly deleteContext: (id: string) => Effect.Effect<void, BrowserbaseError>;\n  /**\n   * Upload a Chrome extension: a zip of at most 100 MB with `manifest.json` at its root. Create a\n   * session with the returned id as `extensionId` to load it.\n   */\n  readonly uploadExtension: (\n    archive: Uint8Array,\n    options?: { readonly fileName?: string | undefined },\n  ) => Effect.Effect<Extension, BrowserbaseError>;\n  readonly getExtension: (id: string) => Effect.Effect<Extension, BrowserbaseError>;\n  readonly deleteExtension: (id: string) => Effect.Effect<void, BrowserbaseError>;\n  /** Search the web for up to `results` hits, from 1 to 25. Defaults to 10. */\n  readonly search: (\n    query: string,\n    options?: { readonly results?: number | undefined },\n  ) => Effect.Effect<ReadonlyArray<SearchResult>, BrowserbaseError>;\n  readonly fetch: (\n    url: string,\n    options?: FetchOptions,\n  ) => Effect.Effect<FetchedPage, BrowserbaseError>;\n}\n\nexport class BrowserbaseClient extends Context.Service<BrowserbaseClient, Service>()(\n  \"effect-browserbase/BrowserbaseClient\",\n) {}\n\nexport interface Options {\n  readonly apiKey: Redacted.Redacted<string>;\n  /** Defaults to `https://api.browserbase.com`. */\n  readonly baseUrl?: string | undefined;\n  /** Bound on each request attempt, including reading its answer. Defaults to 60 seconds. */\n  readonly requestTimeout?: Duration.Input | undefined;\n}\n\nconst ids = /^[A-Za-z0-9_-]{1,128}$/;\nconst maxExtensionBytes = 100 * 1024 * 1024;\nconst ErrorBody = Schema.fromJsonString(Schema.Struct({ message: Schema.String }));\nconst SearchResponse = Schema.Struct({ results: Schema.Array(SearchResult) });\nconst CreatedId = Schema.Struct({ id: Schema.String.check(Schema.isPattern(ids)) });\n\nconst statusReason = (status: number, detail: string): Reason => {\n  if (status < 200 || (status >= 300 && status < 400)) {\n    return new Status({\n      status,\n      detail: \"redirected; redirects are refused so the API key stays with Browserbase\",\n    });\n  }\n  if (status === 400) return new InvalidRequest({ detail });\n  if (status === 401 || status === 403) return new Unauthorized({ detail });\n  if (status === 404) return new NotFound({ detail });\n  if (status === 429) return new RateLimited({ detail });\n\n  return new Status({ status, detail });\n};\n\n/** A create's answer that did not decode though it named session `id`, released or not since. */\nconst undecoded = (detail: string, id: string, released: boolean) =>\n  new Decode({\n    detail: `${detail}; session ${id} ${released ? \"was released\" : \"could not be released and ends at its timeout\"}`,\n    released,\n  });\n\n/** Run the request with fetch's redirect mode set to manual, keeping any other fetch options. */\nconst refuseRedirects = <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> =>\n  Effect.contextWith((context: Context.Context<never>) =>\n    Effect.provideService(effect, FetchHttpClient.RequestInit, {\n      ...Context.getOrUndefined(context, FetchHttpClient.RequestInit),\n      redirect: \"manual\",\n    }),\n  );\n\nexport const make = Effect.fnUntraced(function* (options: Options) {\n  const http = (yield* HttpClient.HttpClient).pipe(\n    HttpClient.mapRequest(\n      flow(\n        HttpClientRequest.prependUrl(options.baseUrl ?? defaultBaseUrl),\n        HttpClientRequest.setHeader(\"x-bb-api-key\", Redacted.value(options.apiKey)),\n        HttpClientRequest.acceptJson,\n      ),\n    ),\n    HttpClient.transformResponse(\n      flow(\n        refuseRedirects,\n        Effect.updateService(Headers.CurrentRedactedNames, (names) => [...names, \"x-bb-api-key\"]),\n      ),\n    ),\n  );\n\n  const failure = (operation: string, reason: Reason) =>\n    new BrowserbaseError({ operation, reason });\n\n  const requestTimeout = Duration.fromInputUnsafe(options.requestTimeout ?? Duration.seconds(60));\n\n  /** Send one request; on a success status, read the answer with `read`. */\n  const send = <A>(\n    operation: string,\n    request: HttpClientRequest.HttpClientRequest,\n    read: (response: HttpClientResponse.HttpClientResponse) => Effect.Effect<A, BrowserbaseError>,\n  ): Effect.Effect<A, BrowserbaseError> =>\n    http.execute(request).pipe(\n      Effect.mapError((error) => failure(operation, new Transport({ detail: error.message }))),\n      Effect.flatMap((response) =>\n        response.status >= 200 && response.status < 300\n          ? read(response)\n          : response.text.pipe(\n              Effect.map((text) =>\n                Option.getOrElse(\n                  Option.map(Schema.decodeOption(ErrorBody)(text), (body) => body.message),\n                  () => text.slice(0, 300),\n                ),\n              ),\n              Effect.orElseSucceed(() => \"\"),\n              Effect.flatMap((detail) =>\n                Effect.fail(failure(operation, statusReason(response.status, detail))),\n              ),\n            ),\n      ),\n      // The deadline also applies inside a caller's uninterruptible acquisition, such as the\n      // session create in Browserbase.open, so that acquisition always settles.\n      Effect.timeoutOrElse({\n        duration: requestTimeout,\n        orElse: () =>\n          Effect.fail(\n            failure(\n              operation,\n              new Transport({\n                detail: `no answer within ${Duration.format(requestTimeout)}`,\n              }),\n            ),\n          ),\n      }),\n      request.method === \"GET\"\n        ? Effect.retry({\n            while: isTransient,\n            times: 2,\n            schedule: Schedule.exponential(\"250 millis\").pipe(Schedule.jittered),\n          })\n        : identity,\n      Effect.withSpan(`Browserbase.${operation}`),\n    );\n\n  const json =\n    <A>(operation: string, schema: Schema.Decoder<A>) =>\n    (response: HttpClientResponse.HttpClientResponse) =>\n      HttpClientResponse.schemaBodyJson(schema)(response).pipe(\n        Effect.mapError((error) =>\n          failure(operation, new Decode({ detail: error.message.split(\"\\n\")[0] ?? \"\" })),\n        ),\n      );\n\n  const ignoreBody = () => Effect.void;\n\n  const withBody = (\n    operation: string,\n    request: HttpClientRequest.HttpClientRequest,\n    body: unknown,\n  ) =>\n    HttpClientRequest.bodyJson(request, body).pipe(\n      Effect.mapError((error) => failure(operation, new InvalidRequest({ detail: error.message }))),\n    );\n\n  const checkId = (operation: string, id: string): Effect.Effect<string, BrowserbaseError> =>\n    ids.test(id)\n      ? Effect.succeed(id)\n      : Effect.fail(\n          failure(\n            operation,\n            new InvalidRequest({ detail: `${JSON.stringify(id)} is not a Browserbase id` }),\n          ),\n        );\n\n  const releaseSession = (id: string) =>\n    checkId(\"releaseSession\", id).pipe(\n      Effect.flatMap(() =>\n        withBody(\"releaseSession\", HttpClientRequest.post(`/v1/sessions/${id}`), {\n          status: \"REQUEST_RELEASE\",\n        }),\n      ),\n      Effect.flatMap((request) => send(\"releaseSession\", request, ignoreBody)),\n    );\n\n  // A success answer means the session exists even if the rest of it does not decode. Only an id\n  // lets anyone end it early, so release it here before reporting the unexpected answer.\n  const createSession = (body: SessionOptions) =>\n    withBody(\"createSession\", HttpClientRequest.post(\"/v1/sessions\"), body).pipe(\n      Effect.flatMap((request) =>\n        send(\"createSession\", request, json(\"createSession\", Schema.Unknown)),\n      ),\n      Effect.flatMap((answer) =>\n        Schema.decodeUnknownEffect(Session)(answer).pipe(\n          Effect.catch((error) => {\n            const detail = error.message.split(\"\\n\")[0] ?? \"\";\n\n            return Option.match(Schema.decodeUnknownOption(CreatedId)(answer), {\n              onNone: () => Effect.fail(failure(\"createSession\", new Decode({ detail }))),\n              onSome: ({ id }) =>\n                releaseSession(id).pipe(\n                  Effect.exit,\n                  Effect.flatMap((release) =>\n                    Effect.fail(\n                      failure(\"createSession\", undecoded(detail, id, Exit.isSuccess(release))),\n                    ),\n                  ),\n                ),\n            });\n          }),\n        ),\n      ),\n    );\n\n  return BrowserbaseClient.of({\n    createSession: (body = {}) => createSession(body),\n    getSession: (id) =>\n      checkId(\"getSession\", id).pipe(\n        Effect.flatMap(() =>\n          send(\n            \"getSession\",\n            HttpClientRequest.get(`/v1/sessions/${id}`),\n            json(\"getSession\", Session),\n          ),\n        ),\n      ),\n    listSessions: (filter = {}) =>\n      send(\n        \"listSessions\",\n        HttpClientRequest.get(\"/v1/sessions\", {\n          urlParams: {\n            ...(filter.status === undefined ? {} : { status: filter.status }),\n            ...(filter.query === undefined ? {} : { q: filter.query }),\n          },\n        }),\n        json(\"listSessions\", Schema.Array(Session)),\n      ),\n    releaseSession,\n    liveView: (id, options = {}) =>\n      checkId(\"liveView\", id).pipe(\n        Effect.flatMap(() =>\n          send(\n            \"liveView\",\n            HttpClientRequest.get(`/v1/sessions/${id}/debug`, {\n              urlParams:\n                options.expiresInSeconds === undefined\n                  ? {}\n                  : { expiresIn: options.expiresInSeconds },\n            }),\n            json(\"liveView\", LiveView),\n          ),\n        ),\n      ),\n    createContext: (body = {}) =>\n      withBody(\"createContext\", HttpClientRequest.post(\"/v1/contexts\"), body).pipe(\n        Effect.flatMap((request) =>\n          send(\"createContext\", request, json(\"createContext\", StoredContext)),\n        ),\n      ),\n    getContext: (id) =>\n      checkId(\"getContext\", id).pipe(\n        Effect.flatMap(() =>\n          send(\n            \"getContext\",\n            HttpClientRequest.get(`/v1/contexts/${id}`),\n            json(\"getContext\", StoredContext),\n          ),\n        ),\n      ),\n    deleteContext: (id) =>\n      checkId(\"deleteContext\", id).pipe(\n        Effect.flatMap(() =>\n          send(\"deleteContext\", HttpClientRequest.delete(`/v1/contexts/${id}`), ignoreBody),\n        ),\n      ),\n    uploadExtension: (archive, options = {}) =>\n      archive.byteLength === 0 || archive.byteLength > maxExtensionBytes\n        ? Effect.fail(\n            failure(\n              \"uploadExtension\",\n              new InvalidRequest({\n                detail: `the archive has ${archive.byteLength} bytes; Browserbase takes 1 byte to 100 MB`,\n              }),\n            ),\n          )\n        : Effect.suspend(() => {\n            const form = new FormData();\n\n            form.append(\n              \"file\",\n              new Blob([new Uint8Array(archive)], { type: \"application/zip\" }),\n              options.fileName ?? \"extension.zip\",\n            );\n\n            return send(\n              \"uploadExtension\",\n              HttpClientRequest.post(\"/v1/extensions\").pipe(HttpClientRequest.bodyFormData(form)),\n              json(\"uploadExtension\", Extension),\n            );\n          }),\n    getExtension: (id) =>\n      checkId(\"getExtension\", id).pipe(\n        Effect.flatMap(() =>\n          send(\n            \"getExtension\",\n            HttpClientRequest.get(`/v1/extensions/${id}`),\n            json(\"getExtension\", Extension),\n          ),\n        ),\n      ),\n    deleteExtension: (id) =>\n      checkId(\"deleteExtension\", id).pipe(\n        Effect.flatMap(() =>\n          send(\"deleteExtension\", HttpClientRequest.delete(`/v1/extensions/${id}`), ignoreBody),\n        ),\n      ),\n    search: (query, options = {}) =>\n      withBody(\"search\", HttpClientRequest.post(\"/v1/search\"), {\n        query,\n        ...(options.results === undefined ? {} : { numResults: options.results }),\n      }).pipe(\n        Effect.flatMap((request) => send(\"search\", request, json(\"search\", SearchResponse))),\n        Effect.map((response) => response.results),\n      ),\n    fetch: (url, options = {}) =>\n      withBody(\"fetch\", HttpClientRequest.post(\"/v1/fetch\"), { url, ...options }).pipe(\n        Effect.flatMap((request) => send(\"fetch\", request, json(\"fetch\", FetchedPage))),\n      ),\n  });\n});\n\nexport const layer = (\n  options: Options,\n): Layer.Layer<BrowserbaseClient, never, HttpClient.HttpClient> =>\n  Layer.effect(BrowserbaseClient, make(options));\n\n/** The client configured from `BROWSERBASE_API_KEY` and, optionally, `BROWSERBASE_BASE_URL`. */\nexport const layerConfig = (\n  options: {\n    readonly apiKey?: Config.Config<Redacted.Redacted<string>> | undefined;\n    readonly baseUrl?: Config.Config<string> | undefined;\n  } = {},\n): Layer.Layer<BrowserbaseClient, Config.ConfigError, HttpClient.HttpClient> =>\n  Layer.effect(\n    BrowserbaseClient,\n    Effect.gen(function* () {\n      const apiKey = yield* options.apiKey ?? Config.Redacted(\"BROWSERBASE_API_KEY\");\n\n      const baseUrl = yield* (\n        options.baseUrl ??\n          Config.String(\"BROWSERBASE_BASE_URL\").pipe(Config.withDefault(defaultBaseUrl))\n      );\n\n      return yield* make({ apiKey, baseUrl });\n    }),\n  );\n"],"mappings":"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"}

package/dist/BrowserbaseError-D1EOrLNc.d.mts

@@ -0,0 +1,79 @@
+import { Schema } from "effect";
+declare namespace BrowserbaseError_d_exports {
+  export { BrowserbaseError, Decode, InvalidRequest, NotFound, RateLimited, Reason, Status, Transport, Unauthorized, isTransient };
+}
+declare const Unauthorized_base: Schema.Class<Unauthorized, Schema.TaggedStruct<"Unauthorized", {
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The API key is missing, wrong or not allowed to do this (401 or 403). */
+declare class Unauthorized extends Unauthorized_base {
+  get message(): string;
+}
+declare const NotFound_base: Schema.Class<NotFound, Schema.TaggedStruct<"NotFound", {
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** No session, context or other resource has that id (404). */
+declare class NotFound extends NotFound_base {
+  get message(): string;
+}
+declare const RateLimited_base: Schema.Class<RateLimited, Schema.TaggedStruct<"RateLimited", {
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Too many concurrent sessions or requests for the plan (429). Wait, then try again. */
+declare class RateLimited extends RateLimited_base {
+  get message(): string;
+}
+declare const Status_base: Schema.Class<Status, Schema.TaggedStruct<"Status", {
+  readonly status: Schema.Finite;
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Any other answer that is not a success, including a redirect, which is never followed. */
+declare class Status extends Status_base {
+  get message(): string;
+}
+declare const Transport_base: Schema.Class<Transport, Schema.TaggedStruct<"Transport", {
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * No answer arrived: the request could not be sent, or the connection failed. A request that
+ * creates something may still have created it.
+ */
+declare class Transport extends Transport_base {
+  get message(): string;
+}
+declare const Decode_base: Schema.Class<Decode, Schema.TaggedStruct<"Decode", {
+  readonly detail: Schema.String;
+  readonly released: Schema.optional<Schema.Boolean>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * The answer did not have the expected shape. For a create whose answer named its session,
+ * `released` says whether the client then released that session; without it, a session may be
+ * left running.
+ */
+declare class Decode extends Decode_base {
+  get message(): string;
+}
+declare const InvalidRequest_base: Schema.Class<InvalidRequest, Schema.TaggedStruct<"InvalidRequest", {
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Not a request Browserbase takes, such as an id that is not one: Browserbase refused it (400), or
+ * it was refused before sending.
+ */
+declare class InvalidRequest extends InvalidRequest_base {
+  get message(): string;
+}
+declare const Reason: Schema.Union<readonly [typeof Unauthorized, typeof NotFound, typeof RateLimited, typeof Status, typeof Transport, typeof Decode, typeof InvalidRequest]>;
+type Reason = typeof Reason.Type;
+declare const BrowserbaseError_base: Schema.Class<BrowserbaseError, Schema.TaggedStruct<"BrowserbaseError", {
+  readonly operation: Schema.String;
+  readonly reason: Schema.Union<readonly [typeof Unauthorized, typeof NotFound, typeof RateLimited, typeof Status, typeof Transport, typeof Decode, typeof InvalidRequest]>;
+}>, import("effect/Cause").YieldableError>;
+declare class BrowserbaseError extends BrowserbaseError_base {
+  get message(): string;
+}
+/** True for failures worth retrying after a pause: no answer, a rate limit or a server error. */
+declare const isTransient: (error: BrowserbaseError) => boolean;
+//#endregion
+export { NotFound as a, Status as c, isTransient as d, InvalidRequest as i, Transport as l, BrowserbaseError_d_exports as n, RateLimited as o, Decode as r, Reason as s, BrowserbaseError as t, Unauthorized as u };
+//# sourceMappingURL=BrowserbaseError-D1EOrLNc.d.mts.map

package/dist/BrowserbaseError.d.mts

@@ -0,0 +1,2 @@
+import { a as NotFound, c as Status, d as isTransient, i as InvalidRequest, l as Transport, o as RateLimited, r as Decode, s as Reason, t as BrowserbaseError, u as Unauthorized } from "./BrowserbaseError-D1EOrLNc.mjs";
+export { BrowserbaseError, Decode, InvalidRequest, NotFound, RateLimited, Reason, Status, Transport, Unauthorized, isTransient };

package/dist/BrowserbaseError.mjs

@@ -0,0 +1,101 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Schema } from "effect";
+//#region src/BrowserbaseError.ts
+/**
+* The one error every Browserbase API call fails with. `reason` says what went wrong.
+*
+* @since 0.3.0
+*/
+var BrowserbaseError_exports = /* @__PURE__ */ __exportAll({
+	BrowserbaseError: () => BrowserbaseError,
+	Decode: () => Decode,
+	InvalidRequest: () => InvalidRequest,
+	NotFound: () => NotFound,
+	RateLimited: () => RateLimited,
+	Reason: () => Reason,
+	Status: () => Status,
+	Transport: () => Transport,
+	Unauthorized: () => Unauthorized,
+	isTransient: () => isTransient
+});
+/** The API key is missing, wrong or not allowed to do this (401 or 403). */
+var Unauthorized = class extends Schema.TaggedError()("Unauthorized", { detail: Schema.String }) {
+	get message() {
+		return `unauthorized: ${this.detail}`;
+	}
+};
+/** No session, context or other resource has that id (404). */
+var NotFound = class extends Schema.TaggedError()("NotFound", { detail: Schema.String }) {
+	get message() {
+		return `not found: ${this.detail}`;
+	}
+};
+/** Too many concurrent sessions or requests for the plan (429). Wait, then try again. */
+var RateLimited = class extends Schema.TaggedError()("RateLimited", { detail: Schema.String }) {
+	get message() {
+		return `rate limited: ${this.detail}`;
+	}
+};
+/** Any other answer that is not a success, including a redirect, which is never followed. */
+var Status = class extends Schema.TaggedError()("Status", {
+	status: Schema.Finite,
+	detail: Schema.String
+}) {
+	get message() {
+		return `status ${this.status}: ${this.detail}`;
+	}
+};
+/**
+* No answer arrived: the request could not be sent, or the connection failed. A request that
+* creates something may still have created it.
+*/
+var Transport = class extends Schema.TaggedError()("Transport", { detail: Schema.String }) {
+	get message() {
+		return this.detail;
+	}
+};
+/**
+* The answer did not have the expected shape. For a create whose answer named its session,
+* `released` says whether the client then released that session; without it, a session may be
+* left running.
+*/
+var Decode = class extends Schema.TaggedError()("Decode", {
+	detail: Schema.String,
+	released: Schema.optional(Schema.Boolean)
+}) {
+	get message() {
+		return `unexpected response: ${this.detail}`;
+	}
+};
+/**
+* Not a request Browserbase takes, such as an id that is not one: Browserbase refused it (400), or
+* it was refused before sending.
+*/
+var InvalidRequest = class extends Schema.TaggedError()("InvalidRequest", { detail: Schema.String }) {
+	get message() {
+		return this.detail;
+	}
+};
+const Reason = Schema.Union([
+	Unauthorized,
+	NotFound,
+	RateLimited,
+	Status,
+	Transport,
+	Decode,
+	InvalidRequest
+]);
+var BrowserbaseError = class extends Schema.TaggedError()("BrowserbaseError", {
+	operation: Schema.String,
+	reason: Reason
+}) {
+	get message() {
+		return `Browserbase ${this.operation} failed: ${this.reason.message}`;
+	}
+};
+/** True for failures worth retrying after a pause: no answer, a rate limit or a server error. */
+const isTransient = (error) => error.reason._tag === "Transport" || error.reason._tag === "RateLimited" || error.reason._tag === "Status" && (error.reason.status >= 500 || error.reason.status === 408);
+//#endregion
+export { BrowserbaseError, Decode, InvalidRequest, NotFound, RateLimited, Reason, Status, Transport, Unauthorized, isTransient, BrowserbaseError_exports as t };
+
+//# sourceMappingURL=BrowserbaseError.mjs.map

package/dist/BrowserbaseError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserbaseError.mjs","names":[],"sources":["../src/BrowserbaseError.ts"],"sourcesContent":["/**\n * The one error every Browserbase API call fails with. `reason` says what went wrong.\n *\n * @since 0.3.0\n */\nimport { Schema } from \"effect\";\n\n/** The API key is missing, wrong or not allowed to do this (401 or 403). */\nexport class Unauthorized extends Schema.TaggedError<Unauthorized>()(\"Unauthorized\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return `unauthorized: ${this.detail}`;\n  }\n}\n\n/** No session, context or other resource has that id (404). */\nexport class NotFound extends Schema.TaggedError<NotFound>()(\"NotFound\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return `not found: ${this.detail}`;\n  }\n}\n\n/** Too many concurrent sessions or requests for the plan (429). Wait, then try again. */\nexport class RateLimited extends Schema.TaggedError<RateLimited>()(\"RateLimited\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return `rate limited: ${this.detail}`;\n  }\n}\n\n/** Any other answer that is not a success, including a redirect, which is never followed. */\nexport class Status extends Schema.TaggedError<Status>()(\"Status\", {\n  status: Schema.Finite,\n  detail: Schema.String,\n}) {\n  override get message() {\n    return `status ${this.status}: ${this.detail}`;\n  }\n}\n\n/**\n * No answer arrived: the request could not be sent, or the connection failed. A request that\n * creates something may still have created it.\n */\nexport class Transport extends Schema.TaggedError<Transport>()(\"Transport\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return this.detail;\n  }\n}\n\n/**\n * The answer did not have the expected shape. For a create whose answer named its session,\n * `released` says whether the client then released that session; without it, a session may be\n * left running.\n */\nexport class Decode extends Schema.TaggedError<Decode>()(\"Decode\", {\n  detail: Schema.String,\n  released: Schema.optional(Schema.Boolean),\n}) {\n  override get message() {\n    return `unexpected response: ${this.detail}`;\n  }\n}\n\n/**\n * Not a request Browserbase takes, such as an id that is not one: Browserbase refused it (400), or\n * it was refused before sending.\n */\nexport class InvalidRequest extends Schema.TaggedError<InvalidRequest>()(\"InvalidRequest\", {\n  detail: Schema.String,\n}) {\n  override get message() {\n    return this.detail;\n  }\n}\n\nexport const Reason = Schema.Union([\n  Unauthorized,\n  NotFound,\n  RateLimited,\n  Status,\n  Transport,\n  Decode,\n  InvalidRequest,\n]);\n\nexport type Reason = typeof Reason.Type;\n\nexport class BrowserbaseError extends Schema.TaggedError<BrowserbaseError>()(\"BrowserbaseError\", {\n  operation: Schema.String,\n  reason: Reason,\n}) {\n  override get message() {\n    return `Browserbase ${this.operation} failed: ${this.reason.message}`;\n  }\n}\n\n/** True for failures worth retrying after a pause: no answer, a rate limit or a server error. */\nexport const isTransient = (error: BrowserbaseError): boolean =>\n  error.reason._tag === \"Transport\" ||\n  error.reason._tag === \"RateLimited\" ||\n  (error.reason._tag === \"Status\" && (error.reason.status >= 500 || error.reason.status === 408));\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAQA,IAAa,eAAb,cAAkC,OAAO,YAA0B,CAAC,CAAC,gBAAgB,EACnF,QAAQ,OAAO,OACjB,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,iBAAiB,KAAK;CAC/B;AACF;;AAGA,IAAa,WAAb,cAA8B,OAAO,YAAsB,CAAC,CAAC,YAAY,EACvE,QAAQ,OAAO,OACjB,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,cAAc,KAAK;CAC5B;AACF;;AAGA,IAAa,cAAb,cAAiC,OAAO,YAAyB,CAAC,CAAC,eAAe,EAChF,QAAQ,OAAO,OACjB,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,iBAAiB,KAAK;CAC/B;AACF;;AAGA,IAAa,SAAb,cAA4B,OAAO,YAAoB,CAAC,CAAC,UAAU;CACjE,QAAQ,OAAO;CACf,QAAQ,OAAO;AACjB,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,UAAU,KAAK,OAAO,IAAI,KAAK;CACxC;AACF;;;;;AAMA,IAAa,YAAb,cAA+B,OAAO,YAAuB,CAAC,CAAC,aAAa,EAC1E,QAAQ,OAAO,OACjB,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,KAAK;CACd;AACF;;;;;;AAOA,IAAa,SAAb,cAA4B,OAAO,YAAoB,CAAC,CAAC,UAAU;CACjE,QAAQ,OAAO;CACf,UAAU,OAAO,SAAS,OAAO,OAAO;AAC1C,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,wBAAwB,KAAK;CACtC;AACF;;;;;AAMA,IAAa,iBAAb,cAAoC,OAAO,YAA4B,CAAC,CAAC,kBAAkB,EACzF,QAAQ,OAAO,OACjB,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,KAAK;CACd;AACF;AAEA,MAAa,SAAS,OAAO,MAAM;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAID,IAAa,mBAAb,cAAsC,OAAO,YAA8B,CAAC,CAAC,oBAAoB;CAC/F,WAAW,OAAO;CAClB,QAAQ;AACV,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,eAAe,KAAK,UAAU,WAAW,KAAK,OAAO;CAC9D;AACF;;AAGA,MAAa,eAAe,UAC1B,MAAM,OAAO,SAAS,eACtB,MAAM,OAAO,SAAS,iBACrB,MAAM,OAAO,SAAS,aAAa,MAAM,OAAO,UAAU,OAAO,MAAM,OAAO,WAAW"}

package/dist/ContextLease.d.mts

@@ -0,0 +1,42 @@
+import { Context, Effect, Layer, Schema, Scope } from "effect";
+declare namespace ContextLease_d_exports {
+  export { ContextHeld, ContextLease, Hold, Service, layer };
+}
+declare const ContextHeld_base: Schema.Class<ContextHeld, Schema.TaggedStruct<"ContextHeld", {
+  readonly context: Schema.String;
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * The stored context could not be held for writing: a session that saves to it may still run, as
+ * its sessions could not be confirmed ended, or the lease itself could not be taken. The next try
+ * clears it again.
+ */
+export declare class ContextHeld extends ContextHeld_base {
+  get message(): string;
+}
+/** A writer's hold on a stored context, for the scope `hold` was given. */
+export interface Hold {
+  /** Whether a session that saves to the context may still run, as the writer before left it. */
+  readonly unsettled: boolean;
+  /** Say how this writer leaves the context, once, before the hold goes: the next writer reads it. */
+  readonly leave: (unsettled: boolean) => Effect.Effect<void>;
+}
+export interface Service {
+  /**
+   * Hold the context as its only writer until the scope closes, waiting while another holds it.
+   * It fails with `ContextHeld` when the lease cannot be taken, as when its own store is down.
+   */
+  readonly hold: (context: string) => Effect.Effect<Hold, ContextHeld, Scope.Scope>;
+}
+declare const ContextLease_base: Context.ServiceClass<ContextLease, "effect-browserbase/ContextLease", Service>;
+export declare class ContextLease extends ContextLease_base {}
+/**
+ * The lease within this process: one writer at a time for each stored context. A context it has
+ * not held is presumed settled, so writers in other processes are the application's to exclude,
+ * with a lease of its own. It forgets a context once nobody holds it, or waits for it, and it was
+ * left settled.
+ */
+export declare const layer: Layer.Layer<ContextLease>;
+//#endregion
+export { ContextLease_d_exports as t };
+//# sourceMappingURL=ContextLease.d.mts.map

package/dist/ContextLease.mjs

@@ -0,0 +1,80 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Context, Effect, Layer, Schema, Semaphore } from "effect";
+//#region src/ContextLease.ts
+/**
+* Who may write a stored context. A session that persists to a context saves to it when the
+* session ends, so two at once can lose one's changes. `Browserbase.open` holds a context through
+* its `ContextLease` from before it creates a persisting session until that session has ended and
+* its save has settled, and the next writer waits. `verifyContext` and `reconcile` hold it too.
+*
+* The lease is a port. `layer` holds contexts within the process that builds it. An application
+* whose writers run in several processes provides its own, such as an advisory lock in its
+* database, and so excludes them all.
+*
+* A hold also passes on how the writer before left the context: `unsettled` while a session that
+* saves to it may still run, as when that writer's release was left unconfirmed, its create's answer
+* was lost, or it kept its session past its scope. The next writer then ends the context's sessions
+* before it writes. A writer says how it leaves the context once, as it lets the hold go; a hold
+* that never says, as when its process ends first, must read as `unsettled` to the next.
+*
+* @since 0.3.0
+*/
+var ContextLease_exports = /* @__PURE__ */ __exportAll({
+	ContextHeld: () => ContextHeld,
+	ContextLease: () => ContextLease,
+	layer: () => layer
+});
+/**
+* The stored context could not be held for writing: a session that saves to it may still run, as
+* its sessions could not be confirmed ended, or the lease itself could not be taken. The next try
+* clears it again.
+*/
+var ContextHeld = class extends Schema.TaggedError()("ContextHeld", {
+	context: Schema.String,
+	detail: Schema.String
+}) {
+	get message() {
+		return `context ${this.context} is held: ${this.detail}`;
+	}
+};
+var ContextLease = class extends Context.Service()("effect-browserbase/ContextLease") {};
+/**
+* The lease within this process: one writer at a time for each stored context. A context it has
+* not held is presumed settled, so writers in other processes are the application's to exclude,
+* with a lease of its own. It forgets a context once nobody holds it, or waits for it, and it was
+* left settled.
+*/
+const layer = Layer.sync(ContextLease, () => {
+	const contexts = /* @__PURE__ */ new Map();
+	const enter = (context) => {
+		const entry = contexts.get(context) ?? {
+			lock: Semaphore.makeUnsafe(1),
+			unsettled: false,
+			users: 0
+		};
+		entry.users += 1;
+		contexts.set(context, entry);
+		return entry;
+	};
+	const exit = (context, entry) => {
+		entry.users -= 1;
+		if (entry.users === 0 && !entry.unsettled) contexts.delete(context);
+	};
+	return ContextLease.of({ hold: (context) => Effect.gen(function* () {
+		const entry = yield* Effect.acquireRelease(Effect.sync(() => enter(context)), (entered) => Effect.sync(() => exit(context, entered)));
+		let leaving = true;
+		yield* Effect.acquireRelease(entry.lock.take(1), () => Effect.sync(() => {
+			entry.unsettled = leaving;
+		}).pipe(Effect.andThen(entry.lock.release(1))), { interruptible: true });
+		return {
+			unsettled: entry.unsettled,
+			leave: (unsettled) => Effect.sync(() => {
+				leaving = unsettled;
+			})
+		};
+	}) });
+});
+//#endregion
+export { ContextHeld, ContextLease, layer, ContextLease_exports as t };
+
+//# sourceMappingURL=ContextLease.mjs.map

package/dist/ContextLease.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextLease.mjs","names":[],"sources":["../src/ContextLease.ts"],"sourcesContent":["/**\n * Who may write a stored context. A session that persists to a context saves to it when the\n * session ends, so two at once can lose one's changes. `Browserbase.open` holds a context through\n * its `ContextLease` from before it creates a persisting session until that session has ended and\n * its save has settled, and the next writer waits. `verifyContext` and `reconcile` hold it too.\n *\n * The lease is a port. `layer` holds contexts within the process that builds it. An application\n * whose writers run in several processes provides its own, such as an advisory lock in its\n * database, and so excludes them all.\n *\n * A hold also passes on how the writer before left the context: `unsettled` while a session that\n * saves to it may still run, as when that writer's release was left unconfirmed, its create's answer\n * was lost, or it kept its session past its scope. The next writer then ends the context's sessions\n * before it writes. A writer says how it leaves the context once, as it lets the hold go; a hold\n * that never says, as when its process ends first, must read as `unsettled` to the next.\n *\n * @since 0.3.0\n */\nimport { Context, Effect, Layer, Schema, type Scope, Semaphore } from \"effect\";\n\n/**\n * The stored context could not be held for writing: a session that saves to it may still run, as\n * its sessions could not be confirmed ended, or the lease itself could not be taken. The next try\n * clears it again.\n */\nexport class ContextHeld extends Schema.TaggedError<ContextHeld>()(\"ContextHeld\", {\n  context: Schema.String,\n  detail: Schema.String,\n}) {\n  override get message() {\n    return `context ${this.context} is held: ${this.detail}`;\n  }\n}\n\n/** A writer's hold on a stored context, for the scope `hold` was given. */\nexport interface Hold {\n  /** Whether a session that saves to the context may still run, as the writer before left it. */\n  readonly unsettled: boolean;\n  /** Say how this writer leaves the context, once, before the hold goes: the next writer reads it. */\n  readonly leave: (unsettled: boolean) => Effect.Effect<void>;\n}\n\nexport interface Service {\n  /**\n   * Hold the context as its only writer until the scope closes, waiting while another holds it.\n   * It fails with `ContextHeld` when the lease cannot be taken, as when its own store is down.\n   */\n  readonly hold: (context: string) => Effect.Effect<Hold, ContextHeld, Scope.Scope>;\n}\n\nexport class ContextLease extends Context.Service<ContextLease, Service>()(\n  \"effect-browserbase/ContextLease\",\n) {}\n\ninterface Entry {\n  readonly lock: Semaphore.Semaphore;\n  unsettled: boolean;\n  /** Its holder and the writers waiting for it. */\n  users: number;\n}\n\n/**\n * The lease within this process: one writer at a time for each stored context. A context it has\n * not held is presumed settled, so writers in other processes are the application's to exclude,\n * with a lease of its own. It forgets a context once nobody holds it, or waits for it, and it was\n * left settled.\n */\nexport const layer: Layer.Layer<ContextLease> = Layer.sync(ContextLease, () => {\n  const contexts = new Map<string, Entry>();\n\n  const enter = (context: string) => {\n    const entry = contexts.get(context) ?? {\n      lock: Semaphore.makeUnsafe(1),\n      unsettled: false,\n      users: 0,\n    };\n\n    entry.users += 1;\n    contexts.set(context, entry);\n\n    return entry;\n  };\n\n  const exit = (context: string, entry: Entry) => {\n    entry.users -= 1;\n    if (entry.users === 0 && !entry.unsettled) contexts.delete(context);\n  };\n\n  return ContextLease.of({\n    hold: (context) =>\n      Effect.gen(function* () {\n        const entry = yield* Effect.acquireRelease(\n          Effect.sync(() => enter(context)),\n          (entered) => Effect.sync(() => exit(context, entered)),\n        );\n\n        // Unless the holder says otherwise, it leaves a session that saves to the context running.\n        let leaving = true;\n\n        yield* Effect.acquireRelease(\n          entry.lock.take(1),\n          () =>\n            Effect.sync(() => {\n              entry.unsettled = leaving;\n            }).pipe(Effect.andThen(entry.lock.release(1))),\n          { interruptible: true },\n        );\n\n        return {\n          unsettled: entry.unsettled,\n          leave: (unsettled) =>\n            Effect.sync(() => {\n              leaving = unsettled;\n            }),\n        } satisfies Hold;\n      }),\n  });\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,IAAa,cAAb,cAAiC,OAAO,YAAyB,CAAC,CAAC,eAAe;CAChF,SAAS,OAAO;CAChB,QAAQ,OAAO;AACjB,CAAC,CAAC,CAAC;CACD,IAAa,UAAU;EACrB,OAAO,WAAW,KAAK,QAAQ,YAAY,KAAK;CAClD;AACF;AAkBA,IAAa,eAAb,cAAkC,QAAQ,QAA+B,CAAC,CACxE,iCACF,CAAC,CAAC,CAAC;;;;;;;AAeH,MAAa,QAAmC,MAAM,KAAK,oBAAoB;CAC7E,MAAM,2BAAW,IAAI,IAAmB;CAExC,MAAM,SAAS,YAAoB;EACjC,MAAM,QAAQ,SAAS,IAAI,OAAO,KAAK;GACrC,MAAM,UAAU,WAAW,CAAC;GAC5B,WAAW;GACX,OAAO;EACT;EAEA,MAAM,SAAS;EACf,SAAS,IAAI,SAAS,KAAK;EAE3B,OAAO;CACT;CAEA,MAAM,QAAQ,SAAiB,UAAiB;EAC9C,MAAM,SAAS;EACf,IAAI,MAAM,UAAU,KAAK,CAAC,MAAM,WAAW,SAAS,OAAO,OAAO;CACpE;CAEA,OAAO,aAAa,GAAG,EACrB,OAAO,YACL,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,OAAO,OAAO,eAC1B,OAAO,WAAW,MAAM,OAAO,CAAC,IAC/B,YAAY,OAAO,WAAW,KAAK,SAAS,OAAO,CAAC,CACvD;EAGA,IAAI,UAAU;EAEd,OAAO,OAAO,eACZ,MAAM,KAAK,KAAK,CAAC,SAEf,OAAO,WAAW;GAChB,MAAM,YAAY;EACpB,CAAC,CAAC,CAAC,KAAK,OAAO,QAAQ,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAC/C,EAAE,eAAe,KAAK,CACxB;EAEA,OAAO;GACL,WAAW,MAAM;GACjB,QAAQ,cACN,OAAO,WAAW;IAChB,UAAU;GACZ,CAAC;EACL;CACF,CAAC,EACL,CAAC;AACH,CAAC"}

package/dist/index.d.mts

@@ -1,27 +1,5 @@
-import * as Account from "./Account.mjs";
-import * as Agents from "./Agents.mjs";
-import * as Allocation from "./Allocation.mjs";
-import * as Browser from "./Browser.mjs";
-import * as Certificates from "./Certificates.mjs";
-import * as Cleanup from "./Cleanup.mjs";
-import * as Client from "./Client.mjs";
-import * as ContextCoordination from "./ContextCoordination.mjs";
-import * as Contexts from "./Contexts.mjs";
-import * as Downloads from "./Downloads.mjs";
-import * as Errors from "./Errors.mjs";
-import * as Extensions from "./Extensions.mjs";
-import * as Functions from "./Functions.mjs";
-import * as Launch from "./Launch.mjs";
-import * as PageFetch from "./PageFetch.mjs";
-import * as Projects from "./Projects.mjs";
-import * as Recordings from "./Recordings.mjs";
-import * as References from "./References.mjs";
-import * as Replays from "./Replays.mjs";
-import * as Search from "./Search.mjs";
-import * as SessionData from "./SessionData.mjs";
-import * as Sessions from "./Sessions.mjs";
-import * as Transfers from "./Transfers.mjs";
-import * as Uploads from "./Uploads.mjs";
-import * as Webhooks from "./Webhooks.mjs";
-export { Account, Agents, Allocation, Browser, Certificates, Cleanup, Client, ContextCoordination, Contexts, Downloads, Errors, Extensions, Functions, Launch, PageFetch, Projects, Recordings, References, Replays, Search, SessionData, Sessions, Transfers, Uploads, Webhooks };
-export {};
+import { n as BrowserbaseError_d_exports } from "./BrowserbaseError-D1EOrLNc.mjs";
+import { r as BrowserbaseClient_d_exports } from "./BrowserbaseClient-CtAQ2rg4.mjs";
+import { t as ContextLease_d_exports } from "./ContextLease.mjs";
+import { t as Browserbase_d_exports } from "./Browserbase.mjs";
+export { Browserbase_d_exports as Browserbase, BrowserbaseClient_d_exports as BrowserbaseClient, BrowserbaseError_d_exports as BrowserbaseError, ContextLease_d_exports as ContextLease };

package/dist/index.mjs

@@ -1,26 +1,5 @@
-import * as Account from "./Account.mjs";
-import * as Agents from "./Agents.mjs";
-import * as Allocation from "./Allocation.mjs";
-import * as Browser from "./Browser.mjs";
-import * as Certificates from "./Certificates.mjs";
-import * as Cleanup from "./Cleanup.mjs";
-import * as Client from "./Client.mjs";
-import * as ContextCoordination from "./ContextCoordination.mjs";
-import * as Contexts from "./Contexts.mjs";
-import * as Downloads from "./Downloads.mjs";
-import * as Errors from "./Errors.mjs";
-import * as Extensions from "./Extensions.mjs";
-import * as Functions from "./Functions.mjs";
-import * as Launch from "./Launch.mjs";
-import * as PageFetch from "./PageFetch.mjs";
-import * as Projects from "./Projects.mjs";
-import * as Recordings from "./Recordings.mjs";
-import * as References from "./References.mjs";
-import * as Replays from "./Replays.mjs";
-import * as Search from "./Search.mjs";
-import * as SessionData from "./SessionData.mjs";
-import * as Sessions from "./Sessions.mjs";
-import * as Transfers from "./Transfers.mjs";
-import * as Uploads from "./Uploads.mjs";
-import * as Webhooks from "./Webhooks.mjs";
-export { Account, Agents, Allocation, Browser, Certificates, Cleanup, Client, ContextCoordination, Contexts, Downloads, Errors, Extensions, Functions, Launch, PageFetch, Projects, Recordings, References, Replays, Search, SessionData, Sessions, Transfers, Uploads, Webhooks };
+import { t as BrowserbaseError_exports } from "./BrowserbaseError.mjs";
+import { t as BrowserbaseClient_exports } from "./BrowserbaseClient.mjs";
+import { t as ContextLease_exports } from "./ContextLease.mjs";
+import { t as Browserbase_exports } from "./Browserbase-CaPKwEY9.mjs";
+export { Browserbase_exports as Browserbase, BrowserbaseClient_exports as BrowserbaseClient, BrowserbaseError_exports as BrowserbaseError, ContextLease_exports as ContextLease };

package/dist/rolldown-runtime-D7D4PA-g.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/testing/index.d.mts

@@ -0,0 +1,136 @@
+import { t as BrowserbaseError } from "../BrowserbaseError-D1EOrLNc.mjs";
+import { n as BrowserbaseClient, p as SessionOptions } from "../BrowserbaseClient-CtAQ2rg4.mjs";
+import { Context, Effect, Layer, Schema } from "effect";
+import { HttpClient } from "effect/http";
+declare namespace BrowserbaseContract_d_exports {
+  export { Broken, Check, checks };
+}
+declare const Broken_base: Schema.Class<Broken, Schema.TaggedStruct<"Broken", {
+  readonly check: Schema.String;
+  readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A check found the API behaving otherwise. */
+declare class Broken extends Broken_base {
+  get message(): string;
+}
+interface Check {
+  readonly name: string;
+  /** It moves the test clock, so only the fake can run it. */
+  readonly clock: boolean;
+  readonly run: Effect.Effect<void, Broken | BrowserbaseError, BrowserbaseClient>;
+}
+declare const checks: ReadonlyArray<Check>;
+declare namespace TestBrowserbase_d_exports {
+  export { Create, Handle, Kept, Read, Release, Script, TestBrowserbase, apiKey, layer, make };
+}
+/** How a session create answers. */
+declare const Create: Schema.Union<readonly [Schema.TaggedStruct<"Accept", {}>, Schema.TaggedStruct<"Reject", {
+  readonly status: Schema.Int;
+  readonly retryAfterSeconds: Schema.optional<Schema.Int>;
+}>, Schema.TaggedStruct<"Malformed", {}>, Schema.TaggedStruct<"Lost", {
+  readonly listedAfter: Schema.optional<Schema.Finite>;
+}>]>;
+/** How a release answers. */
+declare const Release: Schema.Union<readonly [Schema.TaggedStruct<"Ends", {}>, Schema.TaggedStruct<"Pending", {
+  readonly millis: Schema.optional<Schema.Finite>;
+}>, Schema.TaggedStruct<"Refused", {
+  readonly status: Schema.Int;
+}>, Schema.TaggedStruct<"Lost", {}>]>;
+/** How a session read answers. */
+declare const Read: Schema.Union<readonly [Schema.TaggedStruct<"Answer", {}>, Schema.TaggedStruct<"Refused", {
+  readonly status: Schema.Int;
+}>, Schema.TaggedStruct<"Lost", {}>]>;
+declare const Script: Schema.Struct<{
+  /** How creates answer, in turn; once these run out, each is accepted. */
+  readonly creates: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.TaggedStruct<"Accept", {}>, Schema.TaggedStruct<"Reject", {
+    readonly status: Schema.Int;
+    readonly retryAfterSeconds: Schema.optional<Schema.Int>;
+  }>, Schema.TaggedStruct<"Malformed", {}>, Schema.TaggedStruct<"Lost", {
+    readonly listedAfter: Schema.optional<Schema.Finite>;
+  }>]>>>;
+  /** How releases answer, in turn; once these run out, each ends its session. */
+  readonly releases: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.TaggedStruct<"Ends", {}>, Schema.TaggedStruct<"Pending", {
+    readonly millis: Schema.optional<Schema.Finite>;
+  }>, Schema.TaggedStruct<"Refused", {
+    readonly status: Schema.Int;
+  }>, Schema.TaggedStruct<"Lost", {}>]>>>;
+  /** How session reads answer, in turn; once these run out, each answers. */
+  readonly reads: Schema.optional<Schema.$Array<Schema.Union<readonly [Schema.TaggedStruct<"Answer", {}>, Schema.TaggedStruct<"Refused", {
+    readonly status: Schema.Int;
+  }>, Schema.TaggedStruct<"Lost", {}>]>>>;
+  /** The DevTools address each session hands out. Without it, sessions have none. */
+  readonly connectUrl: Schema.optional<Schema.String>;
+}>;
+type Script = typeof Script.Type;
+/** A session as the fake keeps it, with how many releases it was asked. */
+interface Kept {
+  readonly id: string;
+  readonly status: string;
+  /** The create options as sent, without provider defaults. Only the test handle exposes them. */
+  readonly options: SessionOptions;
+  readonly userMetadata: Readonly<Record<string, unknown>> | undefined;
+  readonly releases: number;
+  /** Whether it was created to outlive its connections, until released or timed out. */
+  readonly keepAlive: boolean;
+  /** The stored context it loaded, and whether it saves to it as it ends. */
+  readonly context: {
+    readonly id: string;
+    readonly persist: boolean;
+  } | undefined;
+}
+interface Handle {
+  /** Every request, oldest first, as `METHOD /path?query`. */
+  readonly requests: Effect.Effect<ReadonlyArray<string>>;
+  /** Each session as Browserbase would describe it now, oldest first. */
+  readonly sessions: Effect.Effect<ReadonlyArray<Kept>>;
+  /** End a session as Browserbase does on its own, as when its browser fails. */
+  readonly end: (id: string) => Effect.Effect<void>;
+}
+declare const TestBrowserbase_base: Context.ServiceClass<TestBrowserbase, "effect-browserbase/testing/TestBrowserbase", Handle>;
+/** The fake's handle, beside the `BrowserbaseClient` that `layer` runs on it. */
+declare class TestBrowserbase extends TestBrowserbase_base {}
+/** The API key the fake takes; any other is unauthorized. */
+declare const apiKey = "test-browserbase-key";
+/** The fake as an `HttpClient`, with its handle. */
+declare const make: (script?: {
+  readonly creates?: readonly ({
+    readonly _tag: "Accept";
+  } | {
+    readonly _tag: "Reject";
+    readonly status: number;
+    readonly retryAfterSeconds?: number | undefined;
+  } | {
+    readonly _tag: "Malformed";
+  } | {
+    readonly _tag: "Lost";
+    readonly listedAfter?: number | undefined;
+  })[] | undefined;
+  readonly releases?: readonly ({
+    readonly _tag: "Lost";
+  } | {
+    readonly _tag: "Ends";
+  } | {
+    readonly _tag: "Pending";
+    readonly millis?: number | undefined;
+  } | {
+    readonly _tag: "Refused";
+    readonly status: number;
+  })[] | undefined;
+  readonly reads?: readonly ({
+    readonly _tag: "Answer";
+  } | {
+    readonly _tag: "Refused";
+    readonly status: number;
+  } | {
+    readonly _tag: "Lost";
+  })[] | undefined;
+  readonly connectUrl?: string | undefined;
+} | undefined) => Effect.Effect<{
+  http: HttpClient.HttpClient;
+  handle: Handle;
+}, never, never>;
+/** The real `BrowserbaseClient` over the fake, and the fake's handle. */
+declare const layer: (script?: Script) => Layer.Layer<BrowserbaseClient | TestBrowserbase>;
+//#endregion
+export { BrowserbaseContract_d_exports as BrowserbaseContract, TestBrowserbase_d_exports as TestBrowserbase };
+//# sourceMappingURL=index.d.mts.map