effect-browserbase 0.1.0-beta.102

package/dist/Transfers-Czv5IZzJ.d.mts

@@ -0,0 +1,76 @@
+import { o as SessionReference } from "./References-URDAtapt.mjs";
+import { Schema } from "effect";
+declare namespace Transfers_d_exports {
+  export { ArtifactTransferPolicy, DownloadMetadata, DownloadObservation, PositiveInt, RecordingBatch, RecordingPage, RecordingPageReference, RemoteFilePath, ReplayPage, SafeFilename, UploadReceipt };
+}
+declare const PositiveInt: Schema.Int;
+/** Shared caller-owned transfer bounds. Omitted timeout retains the 60-second default. */
+declare const ArtifactTransferPolicy: Schema.Struct<{
+  readonly maxBytes: Schema.Int;
+  readonly timeoutMillis: Schema.optionalKey<Schema.Int>;
+}>;
+type ArtifactTransferPolicy = typeof ArtifactTransferPolicy.Type;
+/** Portable basename only; never a local or remote filesystem path. */
+declare const SafeFilename: Schema.NonEmptyString;
+/**
+ * A path the provider reported for a file it already holds. It is only ever decoded from a
+ * provider response: no caller, and certainly no model, names a remote filesystem path.
+ */
+declare const RemoteFilePath: Schema.NonEmptyString;
+declare const UploadReceipt_base: Schema.Class<UploadReceipt, Schema.Struct<{
+  readonly reference: typeof SessionReference;
+  readonly filename: Schema.NonEmptyString;
+  readonly bytes: Schema.Natural;
+  readonly remotePath: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly acknowledgement: Schema.optionalKey<Schema.String>;
+}>, {}>;
+/**
+ * Evidence of one accepted upload. `remotePath` exists only when the provider returned one;
+ * its absence is reported rather than guessed, and attachment is refused without it.
+ */
+declare class UploadReceipt extends UploadReceipt_base {}
+declare const DownloadMetadata_base: Schema.Class<DownloadMetadata, Schema.Struct<{
+  readonly id: Schema.NonEmptyString;
+  readonly sessionId: Schema.NonEmptyString;
+  readonly filename: Schema.NonEmptyString;
+  readonly mimeType: Schema.NonEmptyString;
+  readonly size: Schema.Natural;
+  readonly checksum: Schema.String;
+  readonly createdAt: Schema.NonEmptyString;
+}>, {}>;
+declare class DownloadMetadata extends DownloadMetadata_base {}
+declare const DownloadObservation_base: Schema.Class<DownloadObservation, Schema.Struct<{
+  readonly reference: typeof SessionReference;
+  readonly downloadId: Schema.NonEmptyString;
+  readonly filename: Schema.NonEmptyString;
+  readonly state: Schema.Literals<readonly ["started", "completed", "failed", "unknown"]>;
+}>, {}>;
+/** A native event identity is not a provider download ID. Associate provider metadata explicitly. */
+declare class DownloadObservation extends DownloadObservation_base {}
+declare const RecordingPageReference_base: Schema.Class<RecordingPageReference, Schema.Struct<{
+  readonly session: typeof SessionReference;
+  readonly pageId: Schema.NonEmptyString;
+}>, {}>;
+declare class RecordingPageReference extends RecordingPageReference_base {}
+declare const RecordingPage_base: Schema.Class<RecordingPage, Schema.Struct<{
+  readonly pageId: Schema.NonEmptyString;
+  readonly status: Schema.Literals<readonly ["NOT_REQUESTED", "PENDING", "COMPLETED", "FAILED"]>;
+  readonly delivery: Schema.Literals<readonly ["not-ready", "download", "external-storage"]>;
+  readonly completedAt: Schema.optionalKey<Schema.String>;
+}>, {}>;
+declare class RecordingPage extends RecordingPage_base {}
+declare const RecordingBatch_base: Schema.Class<RecordingBatch, Schema.Struct<{
+  readonly reference: typeof SessionReference;
+  readonly pages: Schema.$Array<typeof RecordingPage>;
+  readonly timedOut: Schema.Boolean;
+}>, {}>;
+declare class RecordingBatch extends RecordingBatch_base {}
+declare const ReplayPage_base: Schema.Class<ReplayPage, Schema.Struct<{
+  readonly pageId: Schema.NonEmptyString;
+  readonly startTimeMs: Schema.Finite;
+  readonly endTimeMs: Schema.Finite;
+}>, {}>;
+declare class ReplayPage extends ReplayPage_base {}
+//#endregion
+export { RecordingBatch as a, RemoteFilePath as c, Transfers_d_exports as d, UploadReceipt as f, PositiveInt as i, ReplayPage as l, DownloadMetadata as n, RecordingPage as o, DownloadObservation as r, RecordingPageReference as s, ArtifactTransferPolicy as t, SafeFilename as u };
+//# sourceMappingURL=Transfers-Czv5IZzJ.d.mts.map

package/dist/Transfers.d.mts

@@ -0,0 +1,2 @@
+import { a as RecordingBatch, c as RemoteFilePath, f as UploadReceipt, i as PositiveInt, l as ReplayPage, n as DownloadMetadata, o as RecordingPage, r as DownloadObservation, s as RecordingPageReference, t as ArtifactTransferPolicy, u as SafeFilename } from "./Transfers-Czv5IZzJ.mjs";
+export { ArtifactTransferPolicy, DownloadMetadata, DownloadObservation, PositiveInt, RecordingBatch, RecordingPage, RecordingPageReference, RemoteFilePath, ReplayPage, SafeFilename, UploadReceipt };

package/dist/Transfers.mjs

@@ -0,0 +1,101 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Identifier, SessionReference } from "./References.mjs";
+import { Schema } from "effect";
+//#region src/Transfers.ts
+var Transfers_exports = /* @__PURE__ */ __exportAll({
+	ArtifactTransferPolicy: () => ArtifactTransferPolicy,
+	DownloadMetadata: () => DownloadMetadata,
+	DownloadObservation: () => DownloadObservation,
+	PositiveInt: () => PositiveInt,
+	RecordingBatch: () => RecordingBatch,
+	RecordingPage: () => RecordingPage,
+	RecordingPageReference: () => RecordingPageReference,
+	RemoteFilePath: () => RemoteFilePath,
+	ReplayPage: () => ReplayPage,
+	SafeFilename: () => SafeFilename,
+	UploadReceipt: () => UploadReceipt
+});
+const PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));
+/** Shared caller-owned transfer bounds. Omitted timeout retains the 60-second default. */
+const ArtifactTransferPolicy = Schema.Struct({
+	maxBytes: Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 2 ** 31 - 1
+	})),
+	timeoutMillis: Schema.optionalKey(Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 6e5
+	})))
+});
+/** Portable basename only; never a local or remote filesystem path. */
+const SafeFilename = Schema.NonEmptyString.check(Schema.isMaxLength(240), Schema.makeFilter((value) => value !== "." && value !== ".." && !/[\x00-\x1f\x7f/\\:]/.test(value) && !/[. ]$/.test(value) && !/^\s/.test(value) && !/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(value), { title: "a portable, non-path download filename" }));
+/**
+* A path the provider reported for a file it already holds. It is only ever decoded from a
+* provider response: no caller, and certainly no model, names a remote filesystem path.
+*/
+const RemoteFilePath = Schema.NonEmptyString.check(Schema.isMaxLength(4096), Schema.makeFilter((value) => value.startsWith("/") && !value.includes("\\") && !value.includes("//") && ![...value].some((character) => character < " " || character === "") && value.split("/").every((segment) => segment !== "." && segment !== ".."), { title: "an absolute, traversal-free remote path" }));
+/**
+* Evidence of one accepted upload. `remotePath` exists only when the provider returned one;
+* its absence is reported rather than guessed, and attachment is refused without it.
+*/
+var UploadReceipt = class extends Schema.Class("BrowserbaseUploadReceipt")({
+	reference: SessionReference,
+	filename: SafeFilename,
+	bytes: Schema.Natural,
+	remotePath: Schema.optionalKey(RemoteFilePath),
+	acknowledgement: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(1024)))
+}) {};
+var DownloadMetadata = class extends Schema.Class("BrowserbaseDownloadMetadata")({
+	id: Identifier,
+	sessionId: Identifier,
+	filename: SafeFilename,
+	mimeType: Schema.NonEmptyString.check(Schema.isMaxLength(128)),
+	size: Schema.Natural,
+	checksum: Schema.String.check(Schema.isPattern(/^[a-fA-F0-9]{64}$/)),
+	createdAt: Schema.NonEmptyString.check(Schema.isMaxLength(64))
+}) {};
+/** A native event identity is not a provider download ID. Associate provider metadata explicitly. */
+var DownloadObservation = class extends Schema.Class("BrowserbaseDownloadObservation")({
+	reference: SessionReference,
+	downloadId: Identifier,
+	filename: SafeFilename,
+	state: Schema.Literals([
+		"started",
+		"completed",
+		"failed",
+		"unknown"
+	])
+}) {};
+var RecordingPageReference = class extends Schema.Class("BrowserbaseRecordingPageReference")({
+	session: SessionReference,
+	pageId: Identifier
+}) {};
+var RecordingPage = class extends Schema.Class("BrowserbaseRecordingPage")({
+	pageId: Identifier,
+	status: Schema.Literals([
+		"NOT_REQUESTED",
+		"PENDING",
+		"COMPLETED",
+		"FAILED"
+	]),
+	delivery: Schema.Literals([
+		"not-ready",
+		"download",
+		"external-storage"
+	]),
+	completedAt: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(64)))
+}) {};
+var RecordingBatch = class extends Schema.Class("BrowserbaseRecordingBatch")({
+	reference: SessionReference,
+	pages: Schema.Array(RecordingPage).check(Schema.isMaxLength(256)),
+	timedOut: Schema.Boolean
+}) {};
+var ReplayPage = class extends Schema.Class("BrowserbaseReplayPage")({
+	pageId: Identifier,
+	startTimeMs: Schema.Finite,
+	endTimeMs: Schema.Finite
+}) {};
+//#endregion
+export { ArtifactTransferPolicy, DownloadMetadata, DownloadObservation, PositiveInt, RecordingBatch, RecordingPage, RecordingPageReference, RemoteFilePath, ReplayPage, SafeFilename, UploadReceipt, Transfers_exports as t };
+
+//# sourceMappingURL=Transfers.mjs.map

package/dist/Transfers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transfers.mjs","names":[],"sources":["../src/Transfers.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nimport { Identifier, SessionReference } from \"./References.ts\";\n\nexport const PositiveInt = Schema.Int.check(Schema.isGreaterThan(0));\n\n/** Shared caller-owned transfer bounds. Omitted timeout retains the 60-second default. */\nexport const ArtifactTransferPolicy = Schema.Struct({\n  maxBytes: Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 2 ** 31 - 1 })),\n  timeoutMillis: Schema.optionalKey(\n    Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 600_000 })),\n  ),\n});\n\nexport type ArtifactTransferPolicy = typeof ArtifactTransferPolicy.Type;\n\n/** Portable basename only; never a local or remote filesystem path. */\nexport const SafeFilename = Schema.NonEmptyString.check(\n  Schema.isMaxLength(240),\n  Schema.makeFilter(\n    (value) =>\n      value !== \".\" &&\n      value !== \"..\" &&\n      !/[\\x00-\\x1f\\x7f/\\\\:]/.test(value) &&\n      !/[. ]$/.test(value) &&\n      !/^\\s/.test(value) &&\n      !/^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\\.|$)/i.test(value),\n    { title: \"a portable, non-path download filename\" },\n  ),\n);\n\n/**\n * A path the provider reported for a file it already holds. It is only ever decoded from a\n * provider response: no caller, and certainly no model, names a remote filesystem path.\n */\nexport const RemoteFilePath = Schema.NonEmptyString.check(\n  Schema.isMaxLength(4096),\n  Schema.makeFilter(\n    (value) =>\n      value.startsWith(\"/\") &&\n      !value.includes(\"\\\\\") &&\n      !value.includes(\"//\") &&\n      ![...value].some((character) => character < \" \" || character === \"\\x7f\") &&\n      value.split(\"/\").every((segment) => segment !== \".\" && segment !== \"..\"),\n    { title: \"an absolute, traversal-free remote path\" },\n  ),\n);\n\n/**\n * Evidence of one accepted upload. `remotePath` exists only when the provider returned one;\n * its absence is reported rather than guessed, and attachment is refused without it.\n */\nexport class UploadReceipt extends Schema.Class<UploadReceipt>(\"BrowserbaseUploadReceipt\")({\n  reference: SessionReference,\n  filename: SafeFilename,\n  bytes: Schema.Natural,\n  remotePath: Schema.optionalKey(RemoteFilePath),\n  acknowledgement: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(1024))),\n}) {}\n\nexport class DownloadMetadata extends Schema.Class<DownloadMetadata>(\"BrowserbaseDownloadMetadata\")(\n  {\n    id: Identifier,\n    sessionId: Identifier,\n    filename: SafeFilename,\n    mimeType: Schema.NonEmptyString.check(Schema.isMaxLength(128)),\n    size: Schema.Natural,\n    checksum: Schema.String.check(Schema.isPattern(/^[a-fA-F0-9]{64}$/)),\n    createdAt: Schema.NonEmptyString.check(Schema.isMaxLength(64)),\n  },\n) {}\n\n/** A native event identity is not a provider download ID. Associate provider metadata explicitly. */\nexport class DownloadObservation extends Schema.Class<DownloadObservation>(\n  \"BrowserbaseDownloadObservation\",\n)({\n  reference: SessionReference,\n  downloadId: Identifier,\n  filename: SafeFilename,\n  state: Schema.Literals([\"started\", \"completed\", \"failed\", \"unknown\"]),\n}) {}\n\nexport class RecordingPageReference extends Schema.Class<RecordingPageReference>(\n  \"BrowserbaseRecordingPageReference\",\n)({\n  session: SessionReference,\n  pageId: Identifier,\n}) {}\n\nexport class RecordingPage extends Schema.Class<RecordingPage>(\"BrowserbaseRecordingPage\")({\n  pageId: Identifier,\n  status: Schema.Literals([\"NOT_REQUESTED\", \"PENDING\", \"COMPLETED\", \"FAILED\"]),\n  delivery: Schema.Literals([\"not-ready\", \"download\", \"external-storage\"]),\n  completedAt: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(64))),\n}) {}\n\nexport class RecordingBatch extends Schema.Class<RecordingBatch>(\"BrowserbaseRecordingBatch\")({\n  reference: SessionReference,\n  pages: Schema.Array(RecordingPage).check(Schema.isMaxLength(256)),\n  timedOut: Schema.Boolean,\n}) {}\n\nexport class ReplayPage extends Schema.Class<ReplayPage>(\"BrowserbaseReplayPage\")({\n  pageId: Identifier,\n  startTimeMs: Schema.Finite,\n  endTimeMs: Schema.Finite,\n}) {}\n"],"mappings":"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"}

package/dist/Uploads.d.mts

@@ -0,0 +1,29 @@
+import { o as SessionReference } from "./References-URDAtapt.mjs";
+import { FileError } from "./Errors.mjs";
+import { t as BrowserbaseClient } from "./Client-Ca0zSg1n.mjs";
+import { t as BrowserbaseSessions } from "./Sessions-B8E4kMxo.mjs";
+import { f as UploadReceipt } from "./Transfers-Czv5IZzJ.mjs";
+import { Context, Effect, Layer } from "effect";
+declare namespace Uploads_d_exports {
+  export { BrowserbaseUploads, UploadFile };
+}
+export interface UploadFile {
+  readonly filename: string;
+  readonly mediaType: string;
+  readonly bytes: Uint8Array;
+  readonly maxBytes?: number;
+  readonly timeoutMillis?: number;
+}
+declare const BrowserbaseUploads_base: Context.ServiceClass<BrowserbaseUploads, "effect-browserbase/Uploads", {
+  readonly create: (reference: SessionReference, file: UploadFile) => Effect.Effect<UploadReceipt, FileError>;
+}>;
+/**
+ * A session upload places bytes where the remote browser can already reach them. It is the
+ * large-file half of file selection; small in-memory selection needs no provisioning at all.
+ */
+export declare class BrowserbaseUploads extends BrowserbaseUploads_base {
+  static readonly layer: Layer.Layer<BrowserbaseUploads, never, BrowserbaseClient | BrowserbaseSessions>;
+}
+//#endregion
+export { Uploads_d_exports as t };
+//# sourceMappingURL=Uploads.d.mts.map

package/dist/Uploads.mjs

@@ -0,0 +1,107 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { FileError } from "./Errors.mjs";
+import { RemoteFilePath, SafeFilename, UploadReceipt } from "./Transfers.mjs";
+import { t as BrowserbaseClient } from "./Client-D1_xYM9o.mjs";
+import { t as BrowserbaseSessions } from "./Sessions-CtbseWEh.mjs";
+import { n as recordIssuedUpload } from "./Issued-DejqoMYL.mjs";
+import { Context, Effect, Layer, Schema } from "effect";
+//#region src/Uploads.ts
+var Uploads_exports = /* @__PURE__ */ __exportAll({ BrowserbaseUploads: () => BrowserbaseUploads });
+/** The provider's documented per-file ceiling for a session upload. */
+const MAX_UPLOAD_BYTES = 536870912;
+const MediaType = Schema.NonEmptyString.check(Schema.isMaxLength(128), Schema.isPattern(/^[a-z0-9][a-z0-9!#$&^_+.-]*\/[a-z0-9][a-z0-9!#$&^_+.-]*$/));
+const UploadOptions = Schema.Struct({
+	filename: SafeFilename,
+	mediaType: MediaType,
+	maxBytes: Schema.optionalKey(Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: MAX_UPLOAD_BYTES
+	}))),
+	timeoutMillis: Schema.optionalKey(Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 6e5
+	})))
+});
+/**
+* Only fields this package can validate are carried forward. `path` is the provider's own
+* remote location for the stored file; when the response omits it, the receipt says so
+* instead of inventing one, and attachment by path is refused rather than guessed.
+*/
+/**
+* Where the provider places session uploads inside the remote browser. Observed against the
+* provider on 21 September 2026 and documented at
+* https://docs.browserbase.com/platform/browser/files/uploads.md; the create reply does not
+* return it.
+*/
+const UPLOAD_DIRECTORY = "/tmp/.uploads";
+const ProviderUpload = Schema.Struct({
+	message: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(1024))),
+	path: Schema.optionalKey(RemoteFilePath)
+});
+const failure = (operation, reason) => FileError.make({
+	operation,
+	reason,
+	outcome: "undispatched"
+});
+const fromClient = (operation) => (error) => FileError.make({
+	operation,
+	reason: error.reason,
+	...error.outcome === void 0 ? {} : { outcome: error.outcome },
+	...error.status === void 0 ? {} : { status: error.status },
+	...error.retryAfterMillis === void 0 ? {} : { retryAfterMillis: error.retryAfterMillis }
+});
+/**
+* A session upload places bytes where the remote browser can already reach them. It is the
+* large-file half of file selection; small in-memory selection needs no provisioning at all.
+*/
+var BrowserbaseUploads = class BrowserbaseUploads extends Context.Service()("effect-browserbase/Uploads") {
+	static layer = Layer.effect(BrowserbaseUploads, Effect.gen(function* () {
+		const client = yield* BrowserbaseClient;
+		const sessions = yield* BrowserbaseSessions;
+		const create = Effect.fn("BrowserbaseUploads.create")(function* (reference, file) {
+			const { bytes, ...rest } = file;
+			const value = yield* Schema.decodeEffect(UploadOptions)(rest, { onExcessProperty: "error" }).pipe(Effect.mapError(() => failure("upload", "configuration")));
+			if (!(bytes instanceof Uint8Array)) return yield* failure("upload", "configuration");
+			const maxBytes = value.maxBytes ?? MAX_UPLOAD_BYTES;
+			if (bytes.byteLength < 1 || bytes.byteLength > maxBytes) return yield* failure("upload", "limit");
+			const state = yield* sessions.retrieve(reference).pipe(Effect.mapError((error) => FileError.make({
+				operation: "upload",
+				reason: error.reason
+			})));
+			if (state.status !== "RUNNING") return yield* failure("upload", "expired");
+			const owned = new Uint8Array(bytes);
+			const raw = yield* client.upload(`/v1/sessions/${encodeURIComponent(state.reference.sessionId)}/uploads`, {
+				field: "file",
+				filename: value.filename,
+				mediaType: value.mediaType,
+				bytes: owned
+			}, {
+				maxBytes,
+				...value.timeoutMillis === void 0 ? {} : { timeoutMillis: value.timeoutMillis }
+			}).pipe(Effect.mapError(fromClient("upload")));
+			const acknowledged = yield* Schema.decodeUnknownEffect(ProviderUpload)(raw).pipe(Effect.mapError(() => FileError.make({
+				operation: "upload",
+				reason: "malformed",
+				outcome: "unknown"
+			})));
+			const remotePath = acknowledged.path ?? `${UPLOAD_DIRECTORY}/${value.filename}`;
+			const receipt = UploadReceipt.make({
+				reference: state.reference,
+				filename: value.filename,
+				bytes: owned.byteLength,
+				remotePath,
+				...acknowledged.message === void 0 ? {} : { acknowledgement: acknowledged.message }
+			});
+			recordIssuedUpload(receipt, {
+				reference: state.reference,
+				remotePath
+			});
+			return receipt;
+		});
+		return BrowserbaseUploads.of({ create });
+	}));
+};
+//#endregion
+export { BrowserbaseUploads, Uploads_exports as t };
+
+//# sourceMappingURL=Uploads.mjs.map

package/dist/Uploads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Uploads.mjs","names":[],"sources":["../src/Uploads.ts"],"sourcesContent":["import { Context, Effect, Layer, Schema } from \"effect\";\n\nimport { BrowserbaseClient } from \"./Client.ts\";\nimport { type ClientError, FileError } from \"./Errors.ts\";\nimport { recordIssuedUpload } from \"./internal/upload/Issued.ts\";\nimport type { SessionReference } from \"./References.ts\";\nimport { BrowserbaseSessions } from \"./Sessions.ts\";\nimport { RemoteFilePath, SafeFilename, UploadReceipt } from \"./Transfers.ts\";\n\n/** The provider's documented per-file ceiling for a session upload. */\nconst MAX_UPLOAD_BYTES = 512 * 1024 * 1024;\n\nconst MediaType = Schema.NonEmptyString.check(\n  Schema.isMaxLength(128),\n  Schema.isPattern(/^[a-z0-9][a-z0-9!#$&^_+.-]*\\/[a-z0-9][a-z0-9!#$&^_+.-]*$/),\n);\n\nconst UploadOptions = Schema.Struct({\n  filename: SafeFilename,\n  mediaType: MediaType,\n  maxBytes: Schema.optionalKey(\n    Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: MAX_UPLOAD_BYTES })),\n  ),\n  timeoutMillis: Schema.optionalKey(\n    Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 600_000 })),\n  ),\n});\n\n/**\n * Only fields this package can validate are carried forward. `path` is the provider's own\n * remote location for the stored file; when the response omits it, the receipt says so\n * instead of inventing one, and attachment by path is refused rather than guessed.\n */\n/**\n * Where the provider places session uploads inside the remote browser. Observed against the\n * provider on 21 September 2026 and documented at\n * https://docs.browserbase.com/platform/browser/files/uploads.md; the create reply does not\n * return it.\n */\nconst UPLOAD_DIRECTORY = \"/tmp/.uploads\";\n\nconst ProviderUpload = Schema.Struct({\n  message: Schema.optionalKey(Schema.String.check(Schema.isMaxLength(1024))),\n  path: Schema.optionalKey(RemoteFilePath),\n});\n\nexport interface UploadFile {\n  readonly filename: string;\n  readonly mediaType: string;\n  readonly bytes: Uint8Array;\n  readonly maxBytes?: number;\n  readonly timeoutMillis?: number;\n}\n\nconst failure = (operation: FileError[\"operation\"], reason: FileError[\"reason\"]) =>\n  FileError.make({ operation, reason, outcome: \"undispatched\" });\n\nconst fromClient = (operation: FileError[\"operation\"]) => (error: ClientError) =>\n  FileError.make({\n    operation,\n    reason: error.reason,\n    ...(error.outcome === undefined ? {} : { outcome: error.outcome }),\n    ...(error.status === undefined ? {} : { status: error.status }),\n    ...(error.retryAfterMillis === undefined ? {} : { retryAfterMillis: error.retryAfterMillis }),\n  });\n\n/**\n * A session upload places bytes where the remote browser can already reach them. It is the\n * large-file half of file selection; small in-memory selection needs no provisioning at all.\n */\nexport class BrowserbaseUploads extends Context.Service<\n  BrowserbaseUploads,\n  {\n    readonly create: (\n      reference: SessionReference,\n      file: UploadFile,\n    ) => Effect.Effect<UploadReceipt, FileError>;\n  }\n>()(\"effect-browserbase/Uploads\") {\n  static readonly layer: Layer.Layer<\n    BrowserbaseUploads,\n    never,\n    BrowserbaseClient | BrowserbaseSessions\n  > = Layer.effect(\n    BrowserbaseUploads,\n    Effect.gen(function* () {\n      const client = yield* BrowserbaseClient;\n      const sessions = yield* BrowserbaseSessions;\n\n      const create = Effect.fn(\"BrowserbaseUploads.create\")(function* (\n        reference: SessionReference,\n        file: UploadFile,\n      ) {\n        const { bytes, ...rest } = file;\n\n        const value = yield* Schema.decodeEffect(UploadOptions)(rest, {\n          onExcessProperty: \"error\",\n        }).pipe(Effect.mapError(() => failure(\"upload\", \"configuration\")));\n\n        if (!(bytes instanceof Uint8Array)) return yield* failure(\"upload\", \"configuration\");\n        const maxBytes = value.maxBytes ?? MAX_UPLOAD_BYTES;\n\n        if (bytes.byteLength < 1 || bytes.byteLength > maxBytes)\n          return yield* failure(\"upload\", \"limit\");\n\n        // The exact owning session admits the upload; a terminal session cannot receive files.\n        const state = yield* sessions\n          .retrieve(reference)\n          .pipe(\n            Effect.mapError((error) =>\n              FileError.make({ operation: \"upload\", reason: error.reason }),\n            ),\n          );\n\n        if (state.status !== \"RUNNING\") return yield* failure(\"upload\", \"expired\");\n\n        // Send the same immutable bytes that were measured a moment ago.\n        const owned = new Uint8Array(bytes);\n\n        const raw = yield* client\n          .upload(\n            `/v1/sessions/${encodeURIComponent(state.reference.sessionId)}/uploads`,\n            {\n              field: \"file\",\n              filename: value.filename,\n              mediaType: value.mediaType,\n              bytes: owned,\n            },\n            {\n              maxBytes,\n              ...(value.timeoutMillis === undefined ? {} : { timeoutMillis: value.timeoutMillis }),\n            },\n          )\n          .pipe(Effect.mapError(fromClient(\"upload\")));\n\n        const acknowledged = yield* Schema.decodeUnknownEffect(ProviderUpload)(raw).pipe(\n          Effect.mapError(() =>\n            FileError.make({ operation: \"upload\", reason: \"malformed\", outcome: \"unknown\" }),\n          ),\n        );\n\n        // The provider's reply carries only a message; its documented upload location is a\n        // fixed directory keyed by the part's filename, which was validated above. A path the\n        // provider does return still wins, and was checked for traversal when decoded.\n        const remotePath = acknowledged.path ?? `${UPLOAD_DIRECTORY}/${value.filename}`;\n\n        const receipt = UploadReceipt.make({\n          reference: state.reference,\n          filename: value.filename,\n          bytes: owned.byteLength,\n          remotePath,\n          ...(acknowledged.message === undefined ? {} : { acknowledgement: acknowledged.message }),\n        });\n\n        recordIssuedUpload(receipt, { reference: state.reference, remotePath });\n\n        return receipt;\n      });\n\n      return BrowserbaseUploads.of({ create });\n    }),\n  );\n}\n"],"mappings":"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"}

package/dist/Webhooks.d.mts

@@ -0,0 +1,60 @@
+import { PlatformError } from "./Errors.mjs";
+import { t as BrowserbaseClient } from "./Client-Ca0zSg1n.mjs";
+import { Context, Effect, Layer, Redacted, Schema } from "effect";
+declare namespace Webhooks_d_exports {
+  export { BrowserbaseWebhooks, WebhookEventType, WebhookListQuery, WebhookMetadata, WebhookPage, WebhookRegistration, WebhookSettings, WebhookUpdate };
+}
+/** Provider event names. Browserbase currently emits Functions events only. */
+export declare const WebhookEventType: Schema.Literals<readonly ["functions.builds.running", "functions.builds.completed", "functions.builds.failed", "functions.invocations.pending", "functions.invocations.running", "functions.invocations.completed", "functions.invocations.failed"]>;
+export type WebhookEventType = typeof WebhookEventType.Type;
+export declare const WebhookSettings: Schema.Struct<{
+  readonly endpoint: Schema.NonEmptyString;
+  readonly eventTypes: Schema.$Array<Schema.Literals<readonly ["functions.builds.running", "functions.builds.completed", "functions.builds.failed", "functions.invocations.pending", "functions.invocations.running", "functions.invocations.completed", "functions.invocations.failed"]>>;
+}>;
+export type WebhookSettings = typeof WebhookSettings.Type;
+export declare const WebhookUpdate: Schema.Struct<{
+  readonly endpoint: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly eventTypes: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["functions.builds.running", "functions.builds.completed", "functions.builds.failed", "functions.invocations.pending", "functions.invocations.running", "functions.invocations.completed", "functions.invocations.failed"]>>>;
+}>;
+export type WebhookUpdate = typeof WebhookUpdate.Type;
+declare const WebhookMetadata_base: Schema.Class<WebhookMetadata, Schema.Struct<{
+  readonly webhookId: Schema.NonEmptyString;
+  readonly projectId: Schema.NonEmptyString;
+  readonly endpoint: Schema.String;
+  readonly eventTypes: Schema.$Array<Schema.String>;
+  readonly createdAt: Schema.String;
+  readonly updatedAt: Schema.String;
+}>, {}>;
+export declare class WebhookMetadata extends WebhookMetadata_base {}
+/** A signing secret is returned once, redacted so it cannot be logged by accident. */
+export interface WebhookRegistration {
+  readonly webhook: WebhookMetadata;
+  readonly secret: Redacted.Redacted<string>;
+}
+export interface WebhookPage {
+  readonly webhooks: ReadonlyArray<WebhookMetadata>;
+  readonly nextCursor: string | undefined;
+}
+export declare const WebhookListQuery: Schema.Struct<{
+  readonly cursor: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly limit: Schema.optionalKey<Schema.Int>;
+}>;
+export type WebhookListQuery = typeof WebhookListQuery.Type;
+declare const BrowserbaseWebhooks_base: Context.ServiceClass<BrowserbaseWebhooks, "effect-browserbase/Webhooks", {
+  readonly create: (settings: WebhookSettings) => Effect.Effect<WebhookRegistration, PlatformError>;
+  readonly list: (query?: WebhookListQuery) => Effect.Effect<WebhookPage, PlatformError>;
+  readonly retrieve: (webhookId: string) => Effect.Effect<WebhookMetadata, PlatformError>;
+  readonly update: (webhookId: string, update: WebhookUpdate) => Effect.Effect<WebhookMetadata, PlatformError>;
+  readonly delete: (webhookId: string) => Effect.Effect<void, PlatformError>;
+  /** Issues a new secret; the old one keeps working unless `revokeImmediately`. */
+  readonly rotateSecret: (webhookId: string, options?: {
+    readonly revokeImmediately?: boolean;
+  }) => Effect.Effect<Redacted.Redacted<string>, PlatformError>;
+}>;
+/** Webhook administration for the Client's project. Mutations are never retried. */
+export declare class BrowserbaseWebhooks extends BrowserbaseWebhooks_base {
+  static readonly layer: Layer.Layer<BrowserbaseWebhooks, never, BrowserbaseClient>;
+}
+//#endregion
+export { Webhooks_d_exports as t };
+//# sourceMappingURL=Webhooks.d.mts.map

package/dist/Webhooks.mjs

@@ -0,0 +1,143 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { Identifier } from "./References.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, Redacted, Schema } from "effect";
+//#region src/Webhooks.ts
+var Webhooks_exports = /* @__PURE__ */ __exportAll({
+	BrowserbaseWebhooks: () => BrowserbaseWebhooks,
+	WebhookEventType: () => WebhookEventType,
+	WebhookListQuery: () => WebhookListQuery,
+	WebhookMetadata: () => WebhookMetadata,
+	WebhookSettings: () => WebhookSettings,
+	WebhookUpdate: () => WebhookUpdate
+});
+const Timestamp = Schema.String.check(Schema.isMaxLength(64));
+/** Provider event names. Browserbase currently emits Functions events only. */
+const WebhookEventType = Schema.Literals([
+	"functions.builds.running",
+	"functions.builds.completed",
+	"functions.builds.failed",
+	"functions.invocations.pending",
+	"functions.invocations.running",
+	"functions.invocations.completed",
+	"functions.invocations.failed"
+]);
+const Endpoint = Schema.NonEmptyString.check(Schema.isMaxLength(2048), Schema.makeFilter((value) => {
+	try {
+		const url = new URL(value);
+		return url.protocol === "https:" && !url.username && !url.password;
+	} catch {
+		return false;
+	}
+}));
+const EventTypes = Schema.Array(WebhookEventType).check(Schema.isMinLength(1), Schema.isMaxLength(7), Schema.isUnique());
+const WebhookSettings = Schema.Struct({
+	endpoint: Endpoint,
+	eventTypes: EventTypes
+});
+const WebhookUpdate = Schema.Struct({
+	endpoint: Schema.optionalKey(Endpoint),
+	eventTypes: Schema.optionalKey(EventTypes)
+});
+var WebhookMetadata = class extends Schema.Class("BrowserbaseWebhookMetadata")({
+	webhookId: Identifier,
+	projectId: Identifier,
+	endpoint: Schema.String.check(Schema.isMaxLength(2048)),
+	eventTypes: Schema.Array(Schema.String.check(Schema.isMaxLength(128))).check(Schema.isMaxLength(64)),
+	createdAt: Timestamp,
+	updatedAt: Timestamp
+}) {};
+const ProviderWebhook = Schema.Struct({
+	id: Identifier,
+	projectId: Identifier,
+	endpoint: WebhookMetadata.fields.endpoint,
+	eventTypes: WebhookMetadata.fields.eventTypes,
+	createdAt: Timestamp,
+	updatedAt: Timestamp
+});
+const Secret = Schema.NonEmptyString.check(Schema.isMaxLength(1024));
+const Page = Schema.Struct({
+	data: Schema.Array(ProviderWebhook).check(Schema.isMaxLength(100)),
+	nextCursor: Schema.optionalKey(Schema.NullOr(Schema.String.check(Schema.isMaxLength(4096))))
+});
+const WebhookListQuery = Schema.Struct({
+	cursor: Schema.optionalKey(Schema.NonEmptyString.check(Schema.isMaxLength(4096))),
+	limit: Schema.optionalKey(Schema.Int.check(Schema.isBetween({
+		minimum: 1,
+		maximum: 100
+	})))
+});
+/** Webhook administration for the Client's project. Mutations are never retried. */
+var BrowserbaseWebhooks = class BrowserbaseWebhooks extends Context.Service()("effect-browserbase/Webhooks") {
+	static layer = Layer.effect(BrowserbaseWebhooks, Effect.gen(function* () {
+		const client = yield* BrowserbaseClient;
+		const api = resource(client, (failure) => PlatformError.make({
+			...failure,
+			service: "webhooks"
+		}));
+		const decode = (operation, mutation, expected) => Effect.fnUntraced(function* (value) {
+			if (value.projectId !== client.projectId || expected !== void 0 && value.id !== expected) return yield* api.malformed(operation, mutation);
+			const { id, ...rest } = value;
+			return WebhookMetadata.make({
+				webhookId: id,
+				...rest
+			});
+		});
+		const path = (id) => `/v1/webhooks/${api.segment(id)}`;
+		const create = Effect.fn("BrowserbaseWebhooks.create")(function* (settings) {
+			const value = yield* api.input(WebhookSettings, settings, "webhook-create");
+			const { secret, ...webhook } = yield* api.request("POST", "/v1/webhooks", Schema.Struct({
+				...ProviderWebhook.fields,
+				secret: Secret
+			}), "webhook-create", value);
+			return {
+				webhook: yield* decode("webhook-create", true)(webhook),
+				secret: Redacted.make(secret)
+			};
+		});
+		const list = Effect.fn("BrowserbaseWebhooks.list")(function* (query = {}) {
+			const value = yield* api.input(WebhookListQuery, query, "webhook-list");
+			const page = yield* api.request("GET", `/v1/webhooks${api.query(value)}`, Page, "webhook-list");
+			return {
+				webhooks: yield* Effect.forEach(page.data, decode("webhook-list", false)),
+				nextCursor: page.nextCursor ?? void 0
+			};
+		});
+		const retrieve = Effect.fn("BrowserbaseWebhooks.retrieve")(function* (webhookId) {
+			const id = yield* api.input(Identifier, webhookId, "webhook-retrieve");
+			const value = yield* api.request("GET", path(id), ProviderWebhook, "webhook-retrieve");
+			return yield* decode("webhook-retrieve", false, id)(value);
+		});
+		const update = Effect.fn("BrowserbaseWebhooks.update")(function* (webhookId, changes) {
+			const id = yield* api.input(Identifier, webhookId, "webhook-update");
+			const value = yield* api.input(WebhookUpdate, changes, "webhook-update");
+			if (value.endpoint === void 0 && value.eventTypes === void 0) return yield* api.configuration("webhook-update");
+			const updated = yield* api.request("PATCH", path(id), ProviderWebhook, "webhook-update", value);
+			return yield* decode("webhook-update", true, id)(updated);
+		});
+		const remove = Effect.fn("BrowserbaseWebhooks.delete")(function* (webhookId) {
+			const id = yield* api.input(Identifier, webhookId, "webhook-delete");
+			yield* api.remove(path(id), "webhook-delete");
+		});
+		const rotateSecret = Effect.fn("BrowserbaseWebhooks.rotateSecret")(function* (webhookId, options = {}) {
+			const id = yield* api.input(Identifier, webhookId, "webhook-rotate-secret");
+			const value = yield* api.input(Schema.Struct({ revokeImmediately: Schema.optionalKey(Schema.Boolean) }), options, "webhook-rotate-secret");
+			const rotated = yield* api.request("POST", `${path(id)}/secret`, Schema.Struct({ secret: Secret }), "webhook-rotate-secret", value);
+			return Redacted.make(rotated.secret);
+		});
+		return BrowserbaseWebhooks.of({
+			create,
+			list,
+			retrieve,
+			update,
+			delete: remove,
+			rotateSecret
+		});
+	}));
+};
+//#endregion
+export { BrowserbaseWebhooks, WebhookEventType, WebhookListQuery, WebhookMetadata, WebhookSettings, WebhookUpdate, Webhooks_exports as t };
+
+//# sourceMappingURL=Webhooks.mjs.map

package/dist/Webhooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Webhooks.mjs","names":[],"sources":["../src/Webhooks.ts"],"sourcesContent":["import { Context, Effect, Layer, Redacted, Schema } from \"effect\";\n\nimport { BrowserbaseClient } from \"./Client.ts\";\nimport { PlatformError } from \"./Errors.ts\";\nimport { resource } from \"./internal/http/Resource.ts\";\nimport { Identifier } from \"./References.ts\";\n\nconst Timestamp = Schema.String.check(Schema.isMaxLength(64));\n\n/** Provider event names. Browserbase currently emits Functions events only. */\nexport const WebhookEventType = Schema.Literals([\n  \"functions.builds.running\",\n  \"functions.builds.completed\",\n  \"functions.builds.failed\",\n  \"functions.invocations.pending\",\n  \"functions.invocations.running\",\n  \"functions.invocations.completed\",\n  \"functions.invocations.failed\",\n]);\n\nexport type WebhookEventType = typeof WebhookEventType.Type;\n\nconst Endpoint = Schema.NonEmptyString.check(\n  Schema.isMaxLength(2048),\n  Schema.makeFilter((value) => {\n    try {\n      const url = new URL(value);\n\n      return url.protocol === \"https:\" && !url.username && !url.password;\n    } catch {\n      return false;\n    }\n  }),\n);\n\nconst EventTypes = Schema.Array(WebhookEventType).check(\n  Schema.isMinLength(1),\n  Schema.isMaxLength(7),\n  Schema.isUnique(),\n);\n\nexport const WebhookSettings = Schema.Struct({ endpoint: Endpoint, eventTypes: EventTypes });\nexport type WebhookSettings = typeof WebhookSettings.Type;\n\nexport const WebhookUpdate = Schema.Struct({\n  endpoint: Schema.optionalKey(Endpoint),\n  eventTypes: Schema.optionalKey(EventTypes),\n});\n\nexport type WebhookUpdate = typeof WebhookUpdate.Type;\n\nexport class WebhookMetadata extends Schema.Class<WebhookMetadata>(\"BrowserbaseWebhookMetadata\")({\n  webhookId: Identifier,\n  projectId: Identifier,\n  endpoint: Schema.String.check(Schema.isMaxLength(2048)),\n  eventTypes: Schema.Array(Schema.String.check(Schema.isMaxLength(128))).check(\n    Schema.isMaxLength(64),\n  ),\n  createdAt: Timestamp,\n  updatedAt: Timestamp,\n}) {}\n\n/** A signing secret is returned once, redacted so it cannot be logged by accident. */\nexport interface WebhookRegistration {\n  readonly webhook: WebhookMetadata;\n  readonly secret: Redacted.Redacted<string>;\n}\n\nexport interface WebhookPage {\n  readonly webhooks: ReadonlyArray<WebhookMetadata>;\n  readonly nextCursor: string | undefined;\n}\n\nconst ProviderWebhook = Schema.Struct({\n  id: Identifier,\n  projectId: Identifier,\n  endpoint: WebhookMetadata.fields.endpoint,\n  eventTypes: WebhookMetadata.fields.eventTypes,\n  createdAt: Timestamp,\n  updatedAt: Timestamp,\n});\n\nconst Secret = Schema.NonEmptyString.check(Schema.isMaxLength(1024));\n\nconst Page = Schema.Struct({\n  data: Schema.Array(ProviderWebhook).check(Schema.isMaxLength(100)),\n  nextCursor: Schema.optionalKey(Schema.NullOr(Schema.String.check(Schema.isMaxLength(4096)))),\n});\n\nexport const WebhookListQuery = Schema.Struct({\n  cursor: Schema.optionalKey(Schema.NonEmptyString.check(Schema.isMaxLength(4096))),\n  limit: Schema.optionalKey(Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 100 }))),\n});\n\nexport type WebhookListQuery = typeof WebhookListQuery.Type;\n\n/** Webhook administration for the Client's project. Mutations are never retried. */\nexport class BrowserbaseWebhooks extends Context.Service<\n  BrowserbaseWebhooks,\n  {\n    readonly create: (\n      settings: WebhookSettings,\n    ) => Effect.Effect<WebhookRegistration, PlatformError>;\n    readonly list: (query?: WebhookListQuery) => Effect.Effect<WebhookPage, PlatformError>;\n    readonly retrieve: (webhookId: string) => Effect.Effect<WebhookMetadata, PlatformError>;\n    readonly update: (\n      webhookId: string,\n      update: WebhookUpdate,\n    ) => Effect.Effect<WebhookMetadata, PlatformError>;\n    readonly delete: (webhookId: string) => Effect.Effect<void, PlatformError>;\n    /** Issues a new secret; the old one keeps working unless `revokeImmediately`. */\n    readonly rotateSecret: (\n      webhookId: string,\n      options?: { readonly revokeImmediately?: boolean },\n    ) => Effect.Effect<Redacted.Redacted<string>, PlatformError>;\n  }\n>()(\"effect-browserbase/Webhooks\") {\n  static readonly layer: Layer.Layer<BrowserbaseWebhooks, never, BrowserbaseClient> = Layer.effect(\n    BrowserbaseWebhooks,\n    Effect.gen(function* () {\n      const client = yield* BrowserbaseClient;\n\n      const api = resource<PlatformError>(client, (failure) =>\n        PlatformError.make({ ...failure, service: \"webhooks\" }),\n      );\n\n      const decode = (\n        operation: PlatformError[\"operation\"],\n        mutation: boolean,\n        expected?: string,\n      ) =>\n        Effect.fnUntraced(function* (value: typeof ProviderWebhook.Type) {\n          if (\n            value.projectId !== client.projectId ||\n            (expected !== undefined && value.id !== expected)\n          )\n            return yield* api.malformed(operation, mutation);\n\n          const { id, ...rest } = value;\n\n          return WebhookMetadata.make({ webhookId: id, ...rest });\n        });\n\n      const path = (id: string) => `/v1/webhooks/${api.segment(id)}`;\n\n      const create = Effect.fn(\"BrowserbaseWebhooks.create\")(function* (settings: WebhookSettings) {\n        const value = yield* api.input(WebhookSettings, settings, \"webhook-create\");\n\n        const created = yield* api.request(\n          \"POST\",\n          \"/v1/webhooks\",\n          Schema.Struct({ ...ProviderWebhook.fields, secret: Secret }),\n          \"webhook-create\",\n          value,\n        );\n\n        const { secret, ...webhook } = created;\n\n        return {\n          webhook: yield* decode(\"webhook-create\", true)(webhook),\n          secret: Redacted.make(secret),\n        };\n      });\n\n      const list = Effect.fn(\"BrowserbaseWebhooks.list\")(function* (query: WebhookListQuery = {}) {\n        const value = yield* api.input(WebhookListQuery, query, \"webhook-list\");\n\n        const page = yield* api.request(\n          \"GET\",\n          `/v1/webhooks${api.query(value)}`,\n          Page,\n          \"webhook-list\",\n        );\n\n        return {\n          webhooks: yield* Effect.forEach(page.data, decode(\"webhook-list\", false)),\n          nextCursor: page.nextCursor ?? undefined,\n        };\n      });\n\n      const retrieve = Effect.fn(\"BrowserbaseWebhooks.retrieve\")(function* (webhookId: string) {\n        const id = yield* api.input(Identifier, webhookId, \"webhook-retrieve\");\n        const value = yield* api.request(\"GET\", path(id), ProviderWebhook, \"webhook-retrieve\");\n\n        return yield* decode(\"webhook-retrieve\", false, id)(value);\n      });\n\n      const update = Effect.fn(\"BrowserbaseWebhooks.update\")(function* (\n        webhookId: string,\n        changes: WebhookUpdate,\n      ) {\n        const id = yield* api.input(Identifier, webhookId, \"webhook-update\");\n        const value = yield* api.input(WebhookUpdate, changes, \"webhook-update\");\n\n        if (value.endpoint === undefined && value.eventTypes === undefined)\n          return yield* api.configuration(\"webhook-update\");\n\n        const updated = yield* api.request(\n          \"PATCH\",\n          path(id),\n          ProviderWebhook,\n          \"webhook-update\",\n          value,\n        );\n\n        return yield* decode(\"webhook-update\", true, id)(updated);\n      });\n\n      const remove = Effect.fn(\"BrowserbaseWebhooks.delete\")(function* (webhookId: string) {\n        const id = yield* api.input(Identifier, webhookId, \"webhook-delete\");\n\n        yield* api.remove(path(id), \"webhook-delete\");\n      });\n\n      const rotateSecret = Effect.fn(\"BrowserbaseWebhooks.rotateSecret\")(function* (\n        webhookId: string,\n        options: { readonly revokeImmediately?: boolean } = {},\n      ) {\n        const id = yield* api.input(Identifier, webhookId, \"webhook-rotate-secret\");\n\n        const value = yield* api.input(\n          Schema.Struct({ revokeImmediately: Schema.optionalKey(Schema.Boolean) }),\n          options,\n          \"webhook-rotate-secret\",\n        );\n\n        const rotated = yield* api.request(\n          \"POST\",\n          `${path(id)}/secret`,\n          Schema.Struct({ secret: Secret }),\n          \"webhook-rotate-secret\",\n          value,\n        );\n\n        return Redacted.make(rotated.secret);\n      });\n\n      return BrowserbaseWebhooks.of({\n        create,\n        list,\n        retrieve,\n        update,\n        delete: remove,\n        rotateSecret,\n      });\n    }),\n  );\n}\n"],"mappings":"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"}