@calmlens/sdk 0.5.0 → 0.6.0

package/cjs/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_CalmLensUtils = require("./CalmLensUtils-0QaxbI3A.js");
+const require_CalmLensUtils = require("./CalmLensUtils-DA1_j5-P.js");
 let zod = require("zod");
 zod = require_CalmLensUtils.__toESM(zod);
 require("zod/v4");
@@ -203,7 +203,8 @@ zod.object({
 			source: zod.enum([
 				"frame",
 				"speech",
-				"frame-text"
+				"frame-text",
+				"clip"
 			]),
 			startSeconds: zod.number().nonnegative(),
 			endSeconds: zod.number().nonnegative(),
@@ -247,6 +248,24 @@ const WEBHOOK_TIMESTAMP_HEADER = "x-calmlens-timestamp";
 const WEBHOOK_SIGNATURE_HEADER = "x-calmlens-signature";
 /** Deliveries whose timestamp is further than this from the receiver's clock are rejected. */
 const WEBHOOK_SIGNATURE_TOLERANCE_SECONDS = 300;
+/** The JSON body of a webhook delivery for a stored event. */
+const toWebhookEventPayload = (event) => {
+	var _event$description, _event$assetId, _event$asset;
+	return {
+		id: event.id,
+		type: event.type,
+		createdAt: event.createdAt,
+		projectId: event.projectId,
+		data: {
+			severity: event.severity,
+			title: event.title,
+			description: (_event$description = event.description) !== null && _event$description !== void 0 ? _event$description : null,
+			assetId: (_event$assetId = event.assetId) !== null && _event$assetId !== void 0 ? _event$assetId : null,
+			asset: (_event$asset = event.asset) !== null && _event$asset !== void 0 ? _event$asset : null,
+			facts: event.facts
+		}
+	};
+};
 const encoder = new TextEncoder();
 const hmacSha256Hex = function() {
 	var _ref = require_CalmLensUtils._asyncToGenerator(function* (secret, message) {
@@ -277,7 +296,8 @@ const createWebhookSignatureHeader = function() {
 		return _ref2.apply(this, arguments);
 	};
 }();
-(function() {
+/** Headers for one signed delivery of `body`. */
+const createWebhookHeaders = function() {
 	var _ref3 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 		var _options$timestampSec;
 		const timestamp = (_options$timestampSec = options.timestampSeconds) !== null && _options$timestampSec !== void 0 ? _options$timestampSec : Math.floor(Date.now() / 1e3);
@@ -291,7 +311,7 @@ const createWebhookSignatureHeader = function() {
 	return function createWebhookHeaders(_x6) {
 		return _ref3.apply(this, arguments);
 	};
-})();
+}();
 /**
 * Verifies a webhook delivery: `x-calmlens-signature` must contain a `v1=` HMAC-SHA256 of
 * `"<x-calmlens-timestamp>.<raw body>"`, and the timestamp must be within `toleranceSeconds`
@@ -440,16 +460,42 @@ const requestSignal = (options, signal) => {
 	].filter((value) => value != null);
 	return AbortSignal.any(signals);
 };
-const safeFetch = (fetchImpl, options) => function() {
-	var _ref = require_CalmLensUtils._asyncToGenerator(function* (input, init) {
+/** Copies a fully read body into a new Response, so later JSON parsing cannot hit the network. */
+const toBufferedResponse = function() {
+	var _ref = require_CalmLensUtils._asyncToGenerator(function* (response) {
+		const body = response.status === 204 || response.status === 304 ? null : yield response.arrayBuffer();
+		const headers = new Headers(response.headers);
+		headers.delete("content-encoding");
+		headers.delete("content-length");
+		const buffered = new Response(body, {
+			status: response.status,
+			statusText: response.statusText,
+			headers
+		});
+		Object.defineProperty(buffered, "url", { value: response.url });
+		return buffered;
+	});
+	return function toBufferedResponse(_x) {
+		return _ref.apply(this, arguments);
+	};
+}();
+/**
+* Wraps fetch with the client's deadline, cancellation and redirect policy. Every failure,
+* including body reads, decompression and truncated bodies when `bufferBody` is set, becomes a
+* `CalmLensError` (`sdk/transport-error`, `sdk/timeout` or `sdk/cancelled`) with the original
+* error as its `cause`.
+*/
+const safeFetch = (fetchImpl, options, { bufferBody }) => function() {
+	var _ref2 = require_CalmLensUtils._asyncToGenerator(function* (input, init) {
 		var _init$signal;
 		const signal = requestSignal(options, (_init$signal = init === null || init === void 0 ? void 0 : init.signal) !== null && _init$signal !== void 0 ? _init$signal : input instanceof Request ? input.signal : void 0);
 		try {
 			signal.throwIfAborted();
-			return yield fetchImpl(input, require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, init), {}, {
+			const response = yield fetchImpl(input, require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, init), {}, {
 				redirect: "error",
 				signal
 			}));
+			return bufferBody ? yield toBufferedResponse(response) : response;
 		} catch (cause) {
 			var _signal$reason;
 			throw require_CalmLensUtils.calmLensError({ id: signal.aborted ? ((_signal$reason = signal.reason) === null || _signal$reason === void 0 ? void 0 : _signal$reason.name) === "TimeoutError" ? "sdk/timeout" : "sdk/cancelled" : "sdk/transport-error" }, {
@@ -458,8 +504,8 @@ const safeFetch = (fetchImpl, options) => function() {
 			});
 		}
 	});
-	return function(_x, _x2) {
-		return _ref.apply(this, arguments);
+	return function(_x2, _x3) {
+		return _ref2.apply(this, arguments);
 	};
 }();
 const createApi = (options) => {
@@ -475,7 +521,7 @@ const createApi = (options) => {
 				if (context.error) throw normalizeApiError(context.error);
 			} }
 		],
-		requestBackend: options.requestBackend ? Object.assign(Object.create(options.requestBackend), "fetch" in options.requestBackend && typeof options.requestBackend.fetch === "function" ? { fetch: safeFetch(options.requestBackend.fetch, options) } : {}) : new api_def.FetchRequestBackend(safeFetch(globalThis.fetch, options))
+		requestBackend: options.requestBackend ? Object.assign(Object.create(options.requestBackend), "fetch" in options.requestBackend && typeof options.requestBackend.fetch === "function" ? { fetch: safeFetch(options.requestBackend.fetch, options, { bufferBody: true }) } : {}) : new api_def.FetchRequestBackend(safeFetch(globalThis.fetch, options, { bufferBody: true }))
 	});
 };
 const isApiErrorPayload = (value) => {
@@ -669,9 +715,7 @@ var CalmLensClient = class CalmLensClient {
 		this.pendingEnsureLenses = /* @__PURE__ */ new Map();
 		this.multipartImageUploadSizes = /* @__PURE__ */ new Map();
 		this.multipartUploadQueues = /* @__PURE__ */ new Map();
-		if (!options.apiKey) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "API key is required" });
-		if (!options.projectId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Project ID is required" });
-		if (options.timeoutMs !== void 0 && (!Number.isSafeInteger(options.timeoutMs) || options.timeoutMs <= 0)) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "timeoutMs must be a positive integer" });
+		require_CalmLensUtils.validateClientOptions(options);
 		this.options = require_CalmLensUtils._objectSpread2({}, options);
 		this.options.baseUrl = (_this$options$baseUrl = this.options.baseUrl) !== null && _this$options$baseUrl !== void 0 ? _this$options$baseUrl : `https://api.${require_CalmLensUtils.DOMAIN}/v1`;
 		this.options.cdnBaseUrl = (_this$options$cdnBase = this.options.cdnBaseUrl) !== null && _this$options$cdnBase !== void 0 ? _this$options$cdnBase : `https://cdn.${require_CalmLensUtils.DOMAIN}/v1`;
@@ -686,11 +730,11 @@ var CalmLensClient = class CalmLensClient {
 		return client;
 	}
 	getUploadFetch() {
-		var _this$options$request, _ref2, _this$options$uploadF;
+		var _this$options$request, _ref3, _this$options$uploadF;
 		const requestBackendFetch = (_this$options$request = this.options.requestBackend) === null || _this$options$request === void 0 ? void 0 : _this$options$request.fetch;
-		const fetchImpl = (_ref2 = (_this$options$uploadF = this.options.uploadFetch) !== null && _this$options$uploadF !== void 0 ? _this$options$uploadF : requestBackendFetch) !== null && _ref2 !== void 0 ? _ref2 : globalThis.fetch;
+		const fetchImpl = (_ref3 = (_this$options$uploadF = this.options.uploadFetch) !== null && _this$options$uploadF !== void 0 ? _this$options$uploadF : requestBackendFetch) !== null && _ref3 !== void 0 ? _ref3 : globalThis.fetch;
 		if (!fetchImpl) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.SDK_ERRORS.NO_CDN_FETCH);
-		return safeFetch(fetchImpl, this.options);
+		return safeFetch(fetchImpl, this.options, { bufferBody: true });
 	}
 	submitRawAssetUpload(options, queue) {
 		var _this = this;
@@ -779,7 +823,7 @@ var CalmLensClient = class CalmLensClient {
 			try {
 				data = yield response.json();
 			} catch (cause) {
-				throw require_CalmLensUtils.calmLensError({ id: cause instanceof Error && ["TimeoutError", "AbortError"].includes(cause.name) ? cause.name === "TimeoutError" ? "sdk/timeout" : "sdk/cancelled" : response.ok ? "sdk/invalid-response" : "sdk/http-error" }, {
+				throw require_CalmLensUtils.calmLensError({ id: response.ok ? "sdk/invalid-response" : "sdk/http-error" }, {
 					message: `Invalid JSON response (HTTP ${response.status})`,
 					status: response.status,
 					cause
@@ -822,9 +866,9 @@ var CalmLensClient = class CalmLensClient {
 			* Create a CDN URL for asset content or previews.
 			* Private assets require an authenticated request or signed URL.
 			*/
-			getAssetUrl: (_ref3) => {
+			getAssetUrl: (_ref4) => {
 				var _options$resource;
-				let { assetIdentifier } = _ref3, options = require_CalmLensUtils._objectWithoutProperties(_ref3, _excluded3);
+				let { assetIdentifier } = _ref4, options = require_CalmLensUtils._objectWithoutProperties(_ref4, _excluded3);
 				if (!assetIdentifier) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset identifier is required" });
 				const resource = (_options$resource = options.resource) !== null && _options$resource !== void 0 ? _options$resource : "content";
 				const url = `${this.options.cdnBaseUrl.replace(/\/$/, "")}/assets/${encodeURIComponent(this.options.projectId)}/${encodeURIComponent(assetIdentifier)}/${resource}`;
@@ -835,15 +879,15 @@ var CalmLensClient = class CalmLensClient {
 			* Private assets are authenticated with the client's API key.
 			*/
 			serve: function() {
-				var _ref5 = require_CalmLensUtils._asyncToGenerator(function* (_ref4) {
+				var _ref6 = require_CalmLensUtils._asyncToGenerator(function* (_ref5) {
 					var _this$options$cdnFetc;
-					let { assetIdentifier, init } = _ref4, urlOptions = require_CalmLensUtils._objectWithoutProperties(_ref4, _excluded4);
+					let { assetIdentifier, init } = _ref5, urlOptions = require_CalmLensUtils._objectWithoutProperties(_ref5, _excluded4);
 					const fetchImpl = (_this$options$cdnFetc = _this3.options.cdnFetch) !== null && _this$options$cdnFetc !== void 0 ? _this$options$cdnFetc : globalThis.fetch;
 					if (!fetchImpl) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.SDK_ERRORS.NO_CDN_FETCH);
-					return safeFetch(fetchImpl, _this3.options)(_this3.cdn.getAssetUrl(require_CalmLensUtils._objectSpread2({ assetIdentifier }, urlOptions)), withApiKeyHeader(init, _this3.options.apiKey));
+					return safeFetch(fetchImpl, _this3.options, { bufferBody: false })(_this3.cdn.getAssetUrl(require_CalmLensUtils._objectSpread2({ assetIdentifier }, urlOptions)), withApiKeyHeader(init, _this3.options.apiKey));
 				});
-				return function serve(_x3) {
-					return _ref5.apply(this, arguments);
+				return function serve(_x4) {
+					return _ref6.apply(this, arguments);
 				};
 			}()
 		};
@@ -851,11 +895,11 @@ var CalmLensClient = class CalmLensClient {
 	get text() {
 		var _this4 = this;
 		return { moderate: function() {
-			var _ref6 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+			var _ref7 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 				return _this4.assets.moderate(require_CalmLensUtils.toTextAssetOptions(options));
 			});
-			return function moderate(_x4) {
-				return _ref6.apply(this, arguments);
+			return function moderate(_x5) {
+				return _ref7.apply(this, arguments);
 			};
 		}() };
 	}
@@ -868,15 +912,15 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with paginated assets
 			*/
 			list: function() {
-				var _ref7 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref8 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					var _options$pageIndex;
 					return (yield _this5.endpoints.getAssetsPage.submit({
 						params: { projectId: _this5.options.projectId },
 						query: require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, options), {}, { pageIndex: (_options$pageIndex = options.pageIndex) !== null && _options$pageIndex !== void 0 ? _options$pageIndex : 0 })
 					})).data;
 				});
-				return function list(_x5) {
-					return _ref7.apply(this, arguments);
+				return function list(_x6) {
+					return _ref8.apply(this, arguments);
 				};
 			}(),
 			/**
@@ -885,25 +929,25 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with asset data
 			*/
 			retrieve: function() {
-				var _ref8 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
+				var _ref9 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					return (yield _this5.endpoints.getAsset.submit({ params: { assetId } })).data;
 				});
-				return function retrieve(_x6) {
-					return _ref8.apply(this, arguments);
+				return function retrieve(_x7) {
+					return _ref9.apply(this, arguments);
 				};
 			}(),
 			update: function() {
-				var _ref10 = require_CalmLensUtils._asyncToGenerator(function* (_ref9) {
-					let { assetId } = _ref9, body = require_CalmLensUtils._objectWithoutProperties(_ref9, _excluded5);
+				var _ref11 = require_CalmLensUtils._asyncToGenerator(function* (_ref10) {
+					let { assetId } = _ref10, body = require_CalmLensUtils._objectWithoutProperties(_ref10, _excluded5);
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					return (yield _this5.endpoints.patchAsset.submit({
 						params: { assetId },
 						body
 					})).data;
 				});
-				return function update(_x7) {
-					return _ref10.apply(this, arguments);
+				return function update(_x8) {
+					return _ref11.apply(this, arguments);
 				};
 			}(),
 			/**
@@ -913,17 +957,17 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with paginated child assets
 			*/
 			listChildren: function() {
-				var _ref12 = require_CalmLensUtils._asyncToGenerator(function* (_ref11) {
+				var _ref13 = require_CalmLensUtils._asyncToGenerator(function* (_ref12) {
 					var _options$pageIndex2;
-					let { assetId } = _ref11, options = require_CalmLensUtils._objectWithoutProperties(_ref11, _excluded6);
+					let { assetId } = _ref12, options = require_CalmLensUtils._objectWithoutProperties(_ref12, _excluded6);
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					return (yield _this5.endpoints.getAssetChildren.submit({
 						params: { assetId },
 						query: require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, options), {}, { pageIndex: (_options$pageIndex2 = options.pageIndex) !== null && _options$pageIndex2 !== void 0 ? _options$pageIndex2 : 0 })
 					})).data;
 				});
-				return function listChildren(_x8) {
-					return _ref12.apply(this, arguments);
+				return function listChildren(_x9) {
+					return _ref13.apply(this, arguments);
 				};
 			}(),
 			/**
@@ -933,7 +977,7 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with created asset
 			*/
 			create: function() {
-				var _ref13 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref14 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					const body = prepareSubmitAssetOptions(options);
 					if ("content" in body || "part" in body) return yield _this5.submitRawAssetUpload(body, true);
 					return (yield _this5.endpoints.postUploadAsset.submit({
@@ -942,8 +986,8 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: true }
 					})).data;
 				});
-				return function create(_x9) {
-					return _ref13.apply(this, arguments);
+				return function create(_x10) {
+					return _ref14.apply(this, arguments);
 				};
 			}(),
 			/**
@@ -954,7 +998,7 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with created and analyzed asset
 			*/
 			moderate: function() {
-				var _ref14 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref15 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					if ("content" in options && "plainText" in options.content && (typeof options.content.plainText !== "string" || !options.content.plainText.trim())) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Text to moderate must be a non-empty string" });
 					const body = prepareSubmitAssetOptions(options);
 					if ("content" in body || "part" in body) return yield _this5.submitRawAssetUpload(body, false);
@@ -964,8 +1008,8 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: false }
 					})).data;
 				});
-				return function moderate(_x10) {
-					return _ref14.apply(this, arguments);
+				return function moderate(_x11) {
+					return _ref15.apply(this, arguments);
 				};
 			}(),
 			/**
@@ -975,7 +1019,7 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with asset data
 			*/
 			uploadPart: function() {
-				var _ref15 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId, part }) {
+				var _ref16 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId, part }) {
 					var _part$sizeInBytes3, _this$multipartUpload;
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					if (!part) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Part options are required" });
@@ -993,8 +1037,8 @@ var CalmLensClient = class CalmLensClient {
 					}
 					return yield _this5.submitRawAssetPart(assetId, part, (_this$multipartUpload = _this5.multipartUploadQueues.get(assetId)) !== null && _this$multipartUpload !== void 0 ? _this$multipartUpload : false);
 				});
-				return function uploadPart(_x11) {
-					return _ref15.apply(this, arguments);
+				return function uploadPart(_x12) {
+					return _ref16.apply(this, arguments);
 				};
 			}(),
 			/**
@@ -1003,9 +1047,9 @@ var CalmLensClient = class CalmLensClient {
 			* auth cookies or API keys to the CDN on every media request.
 			*/
 			createSignedUrl: function() {
-				var _ref17 = require_CalmLensUtils._asyncToGenerator(function* (_ref16) {
+				var _ref18 = require_CalmLensUtils._asyncToGenerator(function* (_ref17) {
 					var _options$resource2, _options$expiresInSec;
-					let { assetId } = _ref16, options = require_CalmLensUtils._objectWithoutProperties(_ref16, _excluded7);
+					let { assetId } = _ref17, options = require_CalmLensUtils._objectWithoutProperties(_ref17, _excluded7);
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					if (options.lens && options.transform) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Specify either a lens or a transform, not both" });
 					return (yield _this5.endpoints.postAssetSignedUrl.submit({
@@ -1018,20 +1062,20 @@ var CalmLensClient = class CalmLensClient {
 						params: { assetId }
 					})).data;
 				});
-				return function createSignedUrl(_x12) {
-					return _ref17.apply(this, arguments);
+				return function createSignedUrl(_x13) {
+					return _ref18.apply(this, arguments);
 				};
 			}(),
 			move: function() {
-				var _ref18 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId, folderId }) {
+				var _ref19 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId, folderId }) {
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					return (yield _this5.endpoints.moveAsset.submit({
 						params: { assetId },
 						body: { folderId }
 					})).data;
 				});
-				return function move(_x13) {
-					return _ref18.apply(this, arguments);
+				return function move(_x14) {
+					return _ref19.apply(this, arguments);
 				};
 			}(),
 			/**
@@ -1039,12 +1083,12 @@ var CalmLensClient = class CalmLensClient {
 			* moderated like a new upload; its content must still be stored.
 			*/
 			retry: function() {
-				var _ref19 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
+				var _ref20 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					return (yield _this5.endpoints.retryAsset.submit({ params: { assetId } })).data;
 				});
-				return function retry(_x14) {
-					return _ref19.apply(this, arguments);
+				return function retry(_x15) {
+					return _ref20.apply(this, arguments);
 				};
 			}()
 		};
@@ -1058,14 +1102,14 @@ var CalmLensClient = class CalmLensClient {
 		* reshaped as `{ id, type, createdAt, projectId, data }`.
 		*/
 list: function() {
-			var _ref20 = require_CalmLensUtils._asyncToGenerator(function* (options = {}) {
+			var _ref21 = require_CalmLensUtils._asyncToGenerator(function* (options = {}) {
 				return (yield _this6.endpoints.getEvents.submit({
 					params: { projectId: _this6.options.projectId },
 					query: options
 				})).data;
 			});
 			return function list() {
-				return _ref20.apply(this, arguments);
+				return _ref21.apply(this, arguments);
 			};
 		}() };
 	}
@@ -1073,65 +1117,65 @@ list: function() {
 		var _this7 = this;
 		return {
 			list: function() {
-				var _ref21 = require_CalmLensUtils._asyncToGenerator(function* () {
+				var _ref22 = require_CalmLensUtils._asyncToGenerator(function* () {
 					return (yield _this7.endpoints.getFolders.submit({ params: { projectId: _this7.options.projectId } })).data.folders;
 				});
 				return function list() {
-					return _ref21.apply(this, arguments);
+					return _ref22.apply(this, arguments);
 				};
 			}(),
 			retrieve: function() {
-				var _ref22 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
+				var _ref23 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.getFolder.submit({ params: { folderId } })).data;
 				});
-				return function retrieve(_x15) {
-					return _ref22.apply(this, arguments);
+				return function retrieve(_x16) {
+					return _ref23.apply(this, arguments);
 				};
 			}(),
 			create: function() {
-				var _ref23 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref24 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					return (yield _this7.endpoints.postFolder.submit({
 						params: { projectId: _this7.options.projectId },
 						body: options
 					})).data;
 				});
-				return function create(_x16) {
-					return _ref23.apply(this, arguments);
+				return function create(_x17) {
+					return _ref24.apply(this, arguments);
 				};
 			}(),
 			update: function() {
-				var _ref25 = require_CalmLensUtils._asyncToGenerator(function* (_ref24) {
-					let { folderId } = _ref24, body = require_CalmLensUtils._objectWithoutProperties(_ref24, _excluded8);
+				var _ref26 = require_CalmLensUtils._asyncToGenerator(function* (_ref25) {
+					let { folderId } = _ref25, body = require_CalmLensUtils._objectWithoutProperties(_ref25, _excluded8);
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.patchFolder.submit({
 						params: { folderId },
 						body
 					})).data;
 				});
-				return function update(_x17) {
-					return _ref25.apply(this, arguments);
+				return function update(_x18) {
+					return _ref26.apply(this, arguments);
 				};
 			}(),
 			delete: function() {
-				var _ref26 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
+				var _ref27 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					yield _this7.endpoints.deleteFolder.submit({ params: { folderId } });
 				});
-				return function _delete(_x18) {
-					return _ref26.apply(this, arguments);
+				return function _delete(_x19) {
+					return _ref27.apply(this, arguments);
 				};
 			}(),
 			move: function() {
-				var _ref27 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId, parentId }) {
+				var _ref28 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId, parentId }) {
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.moveFolder.submit({
 						params: { folderId },
 						body: { parentId }
 					})).data;
 				});
-				return function move(_x19) {
-					return _ref27.apply(this, arguments);
+				return function move(_x20) {
+					return _ref28.apply(this, arguments);
 				};
 			}()
 		};
@@ -1202,5 +1246,7 @@ exports.WEBHOOK_DELIVERY_HEADER = WEBHOOK_DELIVERY_HEADER;
 exports.WEBHOOK_SIGNATURE_HEADER = WEBHOOK_SIGNATURE_HEADER;
 exports.WEBHOOK_SIGNATURE_TOLERANCE_SECONDS = WEBHOOK_SIGNATURE_TOLERANCE_SECONDS;
 exports.WEBHOOK_TIMESTAMP_HEADER = WEBHOOK_TIMESTAMP_HEADER;
+exports.createWebhookHeaders = createWebhookHeaders;
 exports.generateMediaTestCode = generateMediaTestCode;
+exports.toWebhookEventPayload = toWebhookEventPayload;
 exports.verifyWebhookSignature = verifyWebhookSignature;

package/cjs/testing.d.ts

@@ -1,19 +1,31 @@
-import { A as GetEventsResponse, D as GetAssetChildrenResponse, F as Folder, N as AssetBinaryPayloadInput, O as GetAssetResponse, P as Lens, S as SubmitAssetOptions, T as UploadAssetPartOptions, U as Asset, W as AssetStatus, a as CreateAssetSignedUrlOptions, b as RetrieveAssetOptions, c as EnsureLensOptions, d as ListAssetChildrenOptions, f as ListAssetsOptions, g as MoveFolderOptions, h as MoveAssetOptions, i as CdnServeOptions, j as PostAssetSignedUrlResponse, k as GetAssetsPageResponse, l as EnsureLensesOptions, m as ModerateTextOptions, n as CalmLensClientOptions, o as CreateFolderOptions, p as ListEventsOptions, r as CdnAssetUrlOptions, u as FolderIdOptions, w as UpdateFolderOptions, x as RetryAssetOptions } from "./CalmLensTypes-DG_kHVqY.js";
+import { A as GetEventsResponse, C as UpdateAssetOptions, D as GetAssetChildrenResponse, F as Folder, G as AssetStatus, N as AssetBinaryPayloadInput, O as GetAssetResponse, P as Lens, S as SubmitAssetOptions, T as UploadAssetPartOptions, W as Asset, a as CreateAssetSignedUrlOptions, b as RetrieveAssetOptions, c as EnsureLensOptions, d as ListAssetChildrenOptions, f as ListAssetsOptions, g as MoveFolderOptions, h as MoveAssetOptions, i as CdnServeOptions, j as PostAssetSignedUrlResponse, k as GetAssetsPageResponse, l as EnsureLensesOptions, m as ModerateTextOptions, n as CalmLensClientOptions, o as CreateFolderOptions, p as ListEventsOptions, r as CdnAssetUrlOptions, u as FolderIdOptions, w as UpdateFolderOptions, x as RetryAssetOptions } from "./CalmLensTypes-BpmT60j-.js";
 import * as zod from "zod";
 //#region ../shared/src/Permissions.d.ts
 declare const GRANT_SCHEMA: zod.ZodObject<{
   actions: zod.ZodArray<zod.ZodEnum<{
+    "api-keys:read": "api-keys:read";
+    "api-keys:write": "api-keys:write";
     "assets:create": "assets:create";
     "assets:delete": "assets:delete";
     "assets:download": "assets:download";
     "assets:read": "assets:read";
     "assets:share": "assets:share";
     "assets:update": "assets:update";
+    "connectors:read": "connectors:read";
+    "connectors:write": "connectors:write";
     "folders:create": "folders:create";
     "folders:delete": "folders:delete";
     "folders:read": "folders:read";
     "folders:update": "folders:update";
+    "lenses:read": "lenses:read";
+    "lenses:write": "lenses:write";
+    "members:read": "members:read";
+    "members:write": "members:write";
+    "metadata:read": "metadata:read";
+    "metadata:write": "metadata:write";
     "project:manage": "project:manage";
+    "settings:read": "settings:read";
+    "settings:write": "settings:write";
   }>>;
   folderId: zod.ZodNullable<zod.ZodString>;
   includeSubfolders: zod.ZodBoolean;
@@ -92,9 +104,21 @@ interface MockCalmLensClientOptions extends CalmLensClientOptions {
     queuedStatus?: AssetStatus;
     analyzedStatus?: AssetStatus;
     signedUrlBaseUrl?: string;
-    cdnBaseUrl?: string;
   };
 }
+/** A `MockCalmLensClient` method, named like its path on the client. */
+type MockCalmLensOperation = "assets.list" | "assets.retrieve" | "assets.update" | "assets.listChildren" | "assets.create" | "assets.moderate" | "assets.uploadPart" | "assets.createSignedUrl" | "assets.move" | "assets.retry" | "text.moderate" | "cdn.serve" | "events.list" | "folders.list" | "folders.retrieve" | "folders.create" | "folders.update" | "folders.delete" | "folders.move" | "ensureLens" | "ensureLenses";
+/** One recorded call: the method and the options object it was given, exactly as passed. */
+interface MockCalmLensCall {
+  operation: MockCalmLensOperation;
+  options: unknown;
+}
+/**
+ * What a simulated request failure throws: `"transport-error"` and `"timeout"` throw the same
+ * `CalmLensError` the real client throws for a network failure (`sdk/transport-error`) or a
+ * deadline (`sdk/timeout`); any `Error` is thrown as given.
+ */
+type MockRequestFailure = "transport-error" | "timeout" | Error;
 export declare class MockCalmLensClient {
   private readonly options;
   readonly databaseStorage: MockDatabaseStorage;
@@ -107,10 +131,24 @@ export declare class MockCalmLensClient {
   private readonly signedUrlBaseUrl;
   private readonly cdnBaseUrl;
   private readonly lenses;
+  private readonly pendingFailures;
+  /** Every call made through this client, oldest first. */
+  readonly calls: MockCalmLensCall[];
+  /** Accepts the same options as `CalmLensClient` (validated the same way), plus `mockOptions`. */
   constructor(options: MockCalmLensClientOptions);
+  /**
+   * Makes the next call (or the next call to `operation`) throw `failure` instead of running,
+   * as if the request never completed. Queue several to fail several calls in a row.
+   */
+  failNextRequest(failure?: MockRequestFailure, { operation }?: {
+    operation?: MockCalmLensOperation;
+  }): void;
+  /** Calls recorded for one operation, oldest first. */
+  callsTo(operation: MockCalmLensOperation): MockCalmLensCall[];
+  private begin;
   get cdn(): {
     getAssetUrl: ({ assetIdentifier, ...options }: CdnAssetUrlOptions) => string;
-    serve: ({ assetIdentifier, ...options }: CdnServeOptions) => Promise<Response>;
+    serve: (serveOptions: CdnServeOptions) => Promise<Response>;
   };
   get events(): {
     /** The mock does not record events; it always returns an empty page at "now". */
@@ -121,29 +159,32 @@ export declare class MockCalmLensClient {
   };
   get assets(): {
     list: (options: ListAssetsOptions) => Promise<GetAssetsPageResponse>;
-    retrieve: ({ assetId }: RetrieveAssetOptions) => Promise<GetAssetResponse>;
-    listChildren: ({ assetId, ...options }: ListAssetChildrenOptions) => Promise<GetAssetChildrenResponse>;
+    retrieve: (options: RetrieveAssetOptions) => Promise<GetAssetResponse>;
+    listChildren: (childrenOptions: ListAssetChildrenOptions) => Promise<GetAssetChildrenResponse>;
+    update: (options: UpdateAssetOptions) => Promise<Asset>;
     create: (options: SubmitAssetOptions) => Promise<Asset>;
     moderate: (options: SubmitAssetOptions) => Promise<Asset>;
-    uploadPart: ({ assetId, part }: UploadAssetPartOptions) => Promise<Asset>;
-    createSignedUrl: ({ assetId, ...options }: CreateAssetSignedUrlOptions) => Promise<PostAssetSignedUrlResponse>;
-    move: ({ assetId, folderId }: MoveAssetOptions) => Promise<Asset>;
-    retry: ({ assetId }: RetryAssetOptions) => Promise<Asset>;
+    uploadPart: (options: UploadAssetPartOptions) => Promise<Asset>;
+    createSignedUrl: (signedUrlOptions: CreateAssetSignedUrlOptions) => Promise<PostAssetSignedUrlResponse>;
+    move: (options: MoveAssetOptions) => Promise<Asset>;
+    retry: (options: RetryAssetOptions) => Promise<Asset>;
   };
   get folders(): {
     list: () => Promise<Folder[]>;
-    retrieve: ({ folderId }: FolderIdOptions) => Promise<Folder>;
+    retrieve: (options: FolderIdOptions) => Promise<Folder>;
     create: (options: CreateFolderOptions) => Promise<Folder>;
-    update: ({ folderId, ...body }: UpdateFolderOptions) => Promise<Folder>;
-    delete: ({ folderId }: FolderIdOptions) => Promise<void>;
-    move: ({ folderId, parentId }: MoveFolderOptions) => Promise<Folder>;
+    update: (options: UpdateFolderOptions) => Promise<Folder>;
+    delete: (options: FolderIdOptions) => Promise<void>;
+    move: (options: MoveFolderOptions) => Promise<Folder>;
   };
   ensureLens(options: EnsureLensOptions): Promise<Lens>;
-  ensureLenses({ lenses }: EnsureLensesOptions): Promise<Lens[]>;
+  private ensureLensDefinition;
+  ensureLenses(options: EnsureLensesOptions): Promise<Lens[]>;
+  private moderateAsset;
   private createAsset;
   private resolveFolder;
   private assertUniqueFolderName;
   private getSizeInBytes;
 }
 //#endregion
-export type { MockCalmLensClientOptions, MockDatabaseStorage, MockImageStorage, MockStoredContent };
+export type { MockCalmLensCall, MockCalmLensClientOptions, MockCalmLensOperation, MockDatabaseStorage, MockImageStorage, MockRequestFailure, MockStoredContent };