@calmlens/sdk 0.5.0 → 0.7.0

package/cjs/testing.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_CalmLensUtils = require("./CalmLensUtils-0QaxbI3A.js");
+const require_CalmLensUtils = require("./CalmLensUtils-CJ6o7KRU.js");
 let zod = require("zod");
 zod = require_CalmLensUtils.__toESM(zod);
 //#region ../shared/src/Permissions.ts
@@ -14,13 +14,36 @@ const ACTION_SCHEMA = zod.enum([
 	"folders:create",
 	"folders:update",
 	"folders:delete",
+	"settings:read",
+	"settings:write",
+	"members:read",
+	"members:write",
+	"api-keys:read",
+	"api-keys:write",
+	"connectors:read",
+	"connectors:write",
+	"metadata:read",
+	"metadata:write",
+	"lenses:read",
+	"lenses:write",
 	"project:manage"
 ]);
+const PROJECT_ACTIONS = [...[
+	"settings",
+	"members",
+	"api-keys",
+	"connectors",
+	"metadata",
+	"lenses"
+].flatMap((feature) => [`${feature}:read`, `${feature}:write`]), "project:manage"];
+const isProjectAction = (action) => PROJECT_ACTIONS.includes(action);
+/** The actions that include `action`: its feature's write action and project:manage. */
+const actionsImplying = (action) => !isProjectAction(action) || action === "project:manage" ? [] : action.endsWith(":read") ? [action.replace(/:read$/, ":write"), "project:manage"] : ["project:manage"];
 const GRANT_SCHEMA = zod.object({
 	actions: zod.array(ACTION_SCHEMA),
 	folderId: zod.string().uuid().nullable(),
 	includeSubfolders: zod.boolean()
-}).strict().refine((g) => g.folderId === null || !g.actions.includes("project:manage"), "Project management requires project scope");
+}).strict().refine((g) => g.folderId === null || !g.actions.some(isProjectAction), "Project configuration permissions require project scope");
 const GRANTS_SCHEMA = zod.array(GRANT_SCHEMA).max(100);
 zod.enum([
 	"admin",
@@ -29,7 +52,7 @@ zod.enum([
 	"custom"
 ]);
 const permits = (grants, action, folderId, folders) => grants.some((grant) => {
-	if (!grant.actions.includes(action)) return false;
+	if (![action, ...actionsImplying(action)].some((held) => grant.actions.includes(held))) return false;
 	if (grant.folderId === null) return true;
 	let current = folderId;
 	const visited = /* @__PURE__ */ new Set();
@@ -191,7 +214,7 @@ var InMemoryMockDatabaseStorage = class {
 //#endregion
 //#region src/testing/MockUtils.ts
 const appendCdnSelector = (url, options) => {
-	if (options.lens && options.transform) throw new Error("Specify either a lens or a transform, not both");
+	if (options.lens && options.transform) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Specify either a lens or a transform, not both" });
 	if (options.lens) return `${url}/@${encodeURIComponent(options.lens)}`;
 	if (!options.transform) return url;
 	return `${url}/${encodeURI(options.transform.replace(/^\/+/, ""))}`;
@@ -237,20 +260,34 @@ const _excluded = ["assetIdentifier"];
 const _excluded2 = ["assetIdentifier"];
 const _excluded3 = ["assetId"];
 const _excluded4 = ["assetId"];
-const _excluded5 = ["folderId"];
+const _excluded5 = ["assetId"];
+const _excluded6 = ["folderId"];
 const assertValidUploadMimeType = (mimeType) => {
 	if (require_CalmLensUtils.isRejectedUploadMimeType(mimeType)) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_MIME_TYPE, {
 		message: require_CalmLensUtils.getRejectedUploadMimeTypeError(mimeType),
 		details: { mimeType }
 	});
 };
+const toFailureError = (failure) => {
+	if (failure === "transport-error") return require_CalmLensUtils.calmLensError({ id: "sdk/transport-error" }, {
+		message: "Request failed",
+		cause: /* @__PURE__ */ new TypeError("Simulated network failure")
+	});
+	if (failure === "timeout") return require_CalmLensUtils.calmLensError({ id: "sdk/timeout" }, {
+		message: "Request aborted",
+		cause: new DOMException("The operation timed out.", "TimeoutError")
+	});
+	return failure;
+};
 var MockCalmLensClient = class {
+	/** Accepts the same options as `CalmLensClient` (validated the same way), plus `mockOptions`. */
 	constructor(options) {
-		var _options$mockOptions$, _options$mockOptions, _options$mockOptions$2, _options$mockOptions2, _options$mockOptions$3, _options$mockOptions3, _options$mockOptions$4, _options$mockOptions4, _options$mockOptions$5, _options$mockOptions5, _options$mockOptions$6, _options$mockOptions6, _options$mockOptions$7, _options$mockOptions7, _options$mockOptions$8, _options$mockOptions8;
+		var _options$mockOptions$, _options$mockOptions, _options$mockOptions$2, _options$mockOptions2, _options$mockOptions$3, _options$mockOptions3, _options$mockOptions$4, _options$mockOptions4, _options$mockOptions$5, _options$mockOptions5, _options$mockOptions$6, _options$mockOptions6, _options$mockOptions$7, _options$mockOptions7, _options$cdnBaseUrl;
 		this.options = options;
 		this.lenses = /* @__PURE__ */ new Map();
-		if (!options.apiKey) throw new Error("API key is required");
-		if (!options.projectId) throw new Error("Project ID is required");
+		this.pendingFailures = [];
+		this.calls = [];
+		require_CalmLensUtils.validateClientOptions(options);
 		this.databaseStorage = (_options$mockOptions$ = (_options$mockOptions = options.mockOptions) === null || _options$mockOptions === void 0 ? void 0 : _options$mockOptions.databaseStorage) !== null && _options$mockOptions$ !== void 0 ? _options$mockOptions$ : new InMemoryMockDatabaseStorage();
 		this.imageStorage = (_options$mockOptions$2 = (_options$mockOptions2 = options.mockOptions) === null || _options$mockOptions2 === void 0 ? void 0 : _options$mockOptions2.imageStorage) !== null && _options$mockOptions$2 !== void 0 ? _options$mockOptions$2 : new InMemoryMockImageStorage();
 		this.createId = (_options$mockOptions$3 = (_options$mockOptions3 = options.mockOptions) === null || _options$mockOptions3 === void 0 ? void 0 : _options$mockOptions3.createId) !== null && _options$mockOptions$3 !== void 0 ? _options$mockOptions$3 : crypto.randomUUID.bind(crypto);
@@ -259,7 +296,32 @@ var MockCalmLensClient = class {
 		this.analyzedStatus = (_options$mockOptions$6 = (_options$mockOptions6 = options.mockOptions) === null || _options$mockOptions6 === void 0 ? void 0 : _options$mockOptions6.analyzedStatus) !== null && _options$mockOptions$6 !== void 0 ? _options$mockOptions$6 : "approved";
 		this.apiKeyGrants = getMockApiKeyGrants(options.apiKey);
 		this.signedUrlBaseUrl = (_options$mockOptions$7 = (_options$mockOptions7 = options.mockOptions) === null || _options$mockOptions7 === void 0 ? void 0 : _options$mockOptions7.signedUrlBaseUrl) !== null && _options$mockOptions$7 !== void 0 ? _options$mockOptions$7 : "mock://calmlens";
-		this.cdnBaseUrl = (_options$mockOptions$8 = (_options$mockOptions8 = options.mockOptions) === null || _options$mockOptions8 === void 0 ? void 0 : _options$mockOptions8.cdnBaseUrl) !== null && _options$mockOptions$8 !== void 0 ? _options$mockOptions$8 : "mock://calmlens/v1";
+		this.cdnBaseUrl = (_options$cdnBaseUrl = options.cdnBaseUrl) !== null && _options$cdnBaseUrl !== void 0 ? _options$cdnBaseUrl : "mock://calmlens/v1";
+	}
+	/**
+	* 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 = "transport-error", { operation } = {}) {
+		this.pendingFailures.push({
+			failure,
+			operation
+		});
+	}
+	/** Calls recorded for one operation, oldest first. */
+	callsTo(operation) {
+		return this.calls.filter((call) => call.operation === operation);
+	}
+	begin(operation, options) {
+		this.calls.push({
+			operation,
+			options
+		});
+		const index = this.pendingFailures.findIndex((pending) => pending.operation === void 0 || pending.operation === operation);
+		if (index !== -1) {
+			const [pending] = this.pendingFailures.splice(index, 1);
+			throw toFailureError(pending.failure);
+		}
 	}
 	get cdn() {
 		var _this = this;
@@ -267,16 +329,17 @@ var MockCalmLensClient = class {
 			getAssetUrl: (_ref) => {
 				var _options$resource;
 				let { assetIdentifier } = _ref, options = require_CalmLensUtils._objectWithoutProperties(_ref, _excluded);
-				if (!assetIdentifier) throw new Error("Asset identifier is required");
+				if (!assetIdentifier) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset identifier is required" });
 				const resource = (_options$resource = options.resource) !== null && _options$resource !== void 0 ? _options$resource : "content";
 				const url = `${this.cdnBaseUrl.replace(/\/$/, "")}/assets/${encodeURIComponent(this.options.projectId)}/${encodeURIComponent(assetIdentifier)}/${resource}`;
 				return appendCdnSelector(url, options);
 			},
 			serve: function() {
-				var _ref3 = require_CalmLensUtils._asyncToGenerator(function* (_ref2) {
+				var _ref2 = require_CalmLensUtils._asyncToGenerator(function* (serveOptions) {
 					var _asset$folderId, _await$this$databaseS, _this$databaseStorage, _this$databaseStorage2, _storedContent$type;
-					let { assetIdentifier } = _ref2, options = require_CalmLensUtils._objectWithoutProperties(_ref2, _excluded2);
-					if (!assetIdentifier) throw new Error("Asset identifier is required");
+					_this.begin("cdn.serve", serveOptions);
+					const { assetIdentifier } = serveOptions, options = require_CalmLensUtils._objectWithoutProperties(serveOptions, _excluded2);
+					if (!assetIdentifier) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset identifier is required" });
 					const asset = (yield _this.databaseStorage.listAssets(_this.options.projectId)).find((asset) => asset.id === assetIdentifier || asset.externalId === assetIdentifier);
 					if (!asset) return new Response("Asset not found", { status: 404 });
 					if (asset.visibility !== "public" && !permits(_this.apiKeyGrants, "assets:download", (_asset$folderId = asset.folderId) !== null && _asset$folderId !== void 0 ? _asset$folderId : null, (_await$this$databaseS = yield (_this$databaseStorage = (_this$databaseStorage2 = _this.databaseStorage).listFolders) === null || _this$databaseStorage === void 0 ? void 0 : _this$databaseStorage.call(_this$databaseStorage2, _this.options.projectId)) !== null && _await$this$databaseS !== void 0 ? _await$this$databaseS : [])) return new Response(JSON.stringify({
@@ -305,7 +368,7 @@ var MockCalmLensClient = class {
 					});
 				});
 				return function serve(_x) {
-					return _ref3.apply(this, arguments);
+					return _ref2.apply(this, arguments);
 				};
 			}()
 		};
@@ -315,8 +378,9 @@ var MockCalmLensClient = class {
 		return { 
 		/** The mock does not record events; it always returns an empty page at "now". */
 list: function() {
-			var _ref4 = require_CalmLensUtils._asyncToGenerator(function* (options = {}) {
+			var _ref3 = require_CalmLensUtils._asyncToGenerator(function* (options = {}) {
 				var _options$after;
+				_this2.begin("events.list", options);
 				return {
 					events: [],
 					cursor: (_options$after = options.after) !== null && _options$after !== void 0 ? _options$after : `${_this2.now()}_`,
@@ -324,18 +388,19 @@ list: function() {
 				};
 			});
 			return function list() {
-				return _ref4.apply(this, arguments);
+				return _ref3.apply(this, arguments);
 			};
 		}() };
 	}
 	get text() {
 		var _this3 = this;
 		return { moderate: function() {
-			var _ref5 = require_CalmLensUtils._asyncToGenerator(function* (options) {
-				return _this3.assets.moderate(require_CalmLensUtils.toTextAssetOptions(options));
+			var _ref4 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				_this3.begin("text.moderate", options);
+				return _this3.moderateAsset(require_CalmLensUtils.toTextAssetOptions(options));
 			});
 			return function moderate(_x2) {
-				return _ref5.apply(this, arguments);
+				return _ref4.apply(this, arguments);
 			};
 		}() };
 	}
@@ -343,62 +408,83 @@ list: function() {
 		var _this4 = this;
 		return {
 			list: function() {
-				var _ref6 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref5 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					var _options$pageIndex;
+					_this4.begin("assets.list", options);
 					const assets = yield _this4.databaseStorage.listAssets(_this4.options.projectId);
 					return createPage(assets, require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, options), {}, { pageIndex: (_options$pageIndex = options.pageIndex) !== null && _options$pageIndex !== void 0 ? _options$pageIndex : 0 }));
 				});
 				return function list(_x3) {
-					return _ref6.apply(this, arguments);
+					return _ref5.apply(this, arguments);
 				};
 			}(),
 			retrieve: function() {
-				var _ref7 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
-					if (!assetId) throw new Error("Asset ID is required");
+				var _ref6 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this4.begin("assets.retrieve", options);
+					const { assetId } = options;
+					if (!assetId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset ID is required" });
 					const asset = yield _this4.databaseStorage.getAsset(assetId);
-					if (!asset) throw new Error("Asset not found");
+					if (!asset) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.ASSET_NOT_FOUND);
 					return asset;
 				});
 				return function retrieve(_x4) {
-					return _ref7.apply(this, arguments);
+					return _ref6.apply(this, arguments);
 				};
 			}(),
 			listChildren: function() {
-				var _ref9 = require_CalmLensUtils._asyncToGenerator(function* (_ref8) {
+				var _ref7 = require_CalmLensUtils._asyncToGenerator(function* (childrenOptions) {
 					var _options$pageIndex2;
-					let { assetId } = _ref8, options = require_CalmLensUtils._objectWithoutProperties(_ref8, _excluded3);
-					if (!assetId) throw new Error("Asset ID is required");
+					_this4.begin("assets.listChildren", childrenOptions);
+					const { assetId } = childrenOptions, options = require_CalmLensUtils._objectWithoutProperties(childrenOptions, _excluded3);
+					if (!assetId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset ID is required" });
 					const assets = yield _this4.databaseStorage.listAssets(_this4.options.projectId);
 					return createPage(assets.filter((asset) => asset.parentId === assetId), require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, options), {}, { pageIndex: (_options$pageIndex2 = options.pageIndex) !== null && _options$pageIndex2 !== void 0 ? _options$pageIndex2 : 0 }));
 				});
 				return function listChildren(_x5) {
-					return _ref9.apply(this, arguments);
+					return _ref7.apply(this, arguments);
+				};
+			}(),
+			update: function() {
+				var _ref8 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this4.begin("assets.update", options);
+					const { assetId } = options, body = require_CalmLensUtils._objectWithoutProperties(options, _excluded4);
+					if (!assetId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset ID is required" });
+					const asset = yield _this4.databaseStorage.getAsset(assetId);
+					if (!asset || asset.projectId !== _this4.options.projectId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.ASSET_NOT_FOUND);
+					const changes = Object.fromEntries(Object.entries(body).filter(([, value]) => value !== void 0));
+					return _this4.databaseStorage.updateAsset(require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, asset), changes), {}, { updatedAt: _this4.now() }));
+				});
+				return function update(_x6) {
+					return _ref8.apply(this, arguments);
 				};
 			}(),
 			create: function() {
-				var _ref10 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref9 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this4.begin("assets.create", options);
 					return _this4.createAsset(options, _this4.queuedStatus);
 				});
-				return function create(_x6) {
-					return _ref10.apply(this, arguments);
+				return function create(_x7) {
+					return _ref9.apply(this, arguments);
 				};
 			}(),
 			moderate: function() {
-				var _ref11 = 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" });
-					return _this4.createAsset(options, _this4.analyzedStatus);
+				var _ref10 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this4.begin("assets.moderate", options);
+					return _this4.moderateAsset(options);
 				});
-				return function moderate(_x7) {
-					return _ref11.apply(this, arguments);
+				return function moderate(_x8) {
+					return _ref10.apply(this, arguments);
 				};
 			}(),
 			uploadPart: function() {
-				var _ref12 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId, part }) {
+				var _ref11 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					var _asset$uploadPartsRec;
-					if (!assetId) throw new Error("Asset ID is required");
-					if (!part) throw new Error("Part options are required");
+					_this4.begin("assets.uploadPart", options);
+					const { assetId, part } = options;
+					if (!assetId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset ID is required" });
+					if (!part) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Part options are required" });
 					const asset = yield _this4.databaseStorage.getAsset(assetId);
-					if (!asset) throw new Error("Asset not found");
+					if (!asset) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.ASSET_NOT_FOUND);
 					const validation = require_CalmLensUtils.validateAssetPayload(part, {
 						multipart: true,
 						isFinal: part.isFinal
@@ -412,32 +498,35 @@ list: function() {
 					});
 					return _this4.databaseStorage.updateAsset(updated);
 				});
-				return function uploadPart(_x8) {
-					return _ref12.apply(this, arguments);
+				return function uploadPart(_x9) {
+					return _ref11.apply(this, arguments);
 				};
 			}(),
 			createSignedUrl: function() {
-				var _ref14 = require_CalmLensUtils._asyncToGenerator(function* (_ref13) {
+				var _ref12 = require_CalmLensUtils._asyncToGenerator(function* (signedUrlOptions) {
 					var _options$expiresInSec, _options$resource2;
-					let { assetId } = _ref13, options = require_CalmLensUtils._objectWithoutProperties(_ref13, _excluded4);
-					if (!assetId) throw new Error("Asset ID is required");
-					if (!(yield _this4.databaseStorage.getAsset(assetId))) throw new Error("Asset not found");
+					_this4.begin("assets.createSignedUrl", signedUrlOptions);
+					const { assetId } = signedUrlOptions, options = require_CalmLensUtils._objectWithoutProperties(signedUrlOptions, _excluded5);
+					if (!assetId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset ID is required" });
+					if (!(yield _this4.databaseStorage.getAsset(assetId))) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.ASSET_NOT_FOUND);
 					const expiresInSeconds = (_options$expiresInSec = options.expiresInSeconds) !== null && _options$expiresInSec !== void 0 ? _options$expiresInSec : 900;
 					const resource = (_options$resource2 = options.resource) !== null && _options$resource2 !== void 0 ? _options$resource2 : "content";
-					if (options.lens && options.transform) throw new Error("Specify either a lens or a transform, not both");
+					if (options.lens && options.transform) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Specify either a lens or a transform, not both" });
 					const selector = options.lens ? `&lens=${encodeURIComponent(options.lens)}` : options.transform ? `&transform=${encodeURIComponent(options.transform)}` : "";
 					return {
 						url: `${_this4.signedUrlBaseUrl}/assets/${assetId}/${resource}?expiresInSeconds=${expiresInSeconds}${selector}`,
 						expiresAt: _this4.now() + expiresInSeconds * 1e3
 					};
 				});
-				return function createSignedUrl(_x9) {
-					return _ref14.apply(this, arguments);
+				return function createSignedUrl(_x10) {
+					return _ref12.apply(this, arguments);
 				};
 			}(),
 			move: function() {
-				var _ref15 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId, folderId }) {
-					if (!assetId) throw new Error("Asset ID is required");
+				var _ref13 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this4.begin("assets.move", options);
+					const { assetId, folderId } = options;
+					if (!assetId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset ID is required" });
 					const asset = yield _this4.databaseStorage.getAsset(assetId);
 					if (!asset || asset.projectId !== _this4.options.projectId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.ASSET_NOT_FOUND);
 					if (folderId !== null && folderId !== void 0) {
@@ -449,13 +538,15 @@ list: function() {
 					});
 					return _this4.databaseStorage.updateAsset(updated);
 				});
-				return function move(_x10) {
-					return _ref15.apply(this, arguments);
+				return function move(_x11) {
+					return _ref13.apply(this, arguments);
 				};
 			}(),
 			retry: function() {
-				var _ref16 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
-					if (!assetId) throw new Error("Asset ID is required");
+				var _ref14 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this4.begin("assets.retry", options);
+					const { assetId } = options;
+					if (!assetId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset ID is required" });
 					const asset = yield _this4.databaseStorage.getAsset(assetId);
 					if (!asset || asset.projectId !== _this4.options.projectId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.ASSET_NOT_FOUND);
 					if (asset.status !== "error") throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.ASSET_NOT_RETRYABLE);
@@ -464,8 +555,8 @@ list: function() {
 						updatedAt: _this4.now()
 					}));
 				});
-				return function retry(_x11) {
-					return _ref16.apply(this, arguments);
+				return function retry(_x12) {
+					return _ref14.apply(this, arguments);
 				};
 			}()
 		};
@@ -474,28 +565,32 @@ list: function() {
 		var _this5 = this;
 		return {
 			list: function() {
-				var _ref17 = require_CalmLensUtils._asyncToGenerator(function* () {
+				var _ref15 = require_CalmLensUtils._asyncToGenerator(function* () {
+					_this5.begin("folders.list", void 0);
 					return [..._this5.databaseStorage.listFolders ? yield _this5.databaseStorage.listFolders(_this5.options.projectId) : []].sort((a, b) => a.name.localeCompare(b.name));
 				});
 				return function list() {
-					return _ref17.apply(this, arguments);
+					return _ref15.apply(this, arguments);
 				};
 			}(),
 			retrieve: function() {
-				var _ref18 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
-					if (!folderId) throw new Error("Folder ID is required");
+				var _ref16 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this5.begin("folders.retrieve", options);
+					const { folderId } = options;
+					if (!folderId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Folder ID is required" });
 					const folder = yield _this5.resolveFolder(folderId);
 					if (!folder) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.FOLDER_NOT_FOUND);
 					return folder;
 				});
-				return function retrieve(_x12) {
-					return _ref18.apply(this, arguments);
+				return function retrieve(_x13) {
+					return _ref16.apply(this, arguments);
 				};
 			}(),
 			create: function() {
-				var _ref19 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref17 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					var _options$parentId, _options$parentId2;
-					if (!options.name) throw new Error("Folder name is required");
+					_this5.begin("folders.create", options);
+					if (!options.name) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Folder name is required" });
 					if (options.parentId) {
 						if (!(yield _this5.resolveFolder(options.parentId))) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.FOLDER_NOT_FOUND);
 					}
@@ -511,14 +606,15 @@ list: function() {
 					if (_this5.databaseStorage.createFolder) return yield _this5.databaseStorage.createFolder(folder);
 					return folder;
 				});
-				return function create(_x13) {
-					return _ref19.apply(this, arguments);
+				return function create(_x14) {
+					return _ref17.apply(this, arguments);
 				};
 			}(),
 			update: function() {
-				var _ref21 = require_CalmLensUtils._asyncToGenerator(function* (_ref20) {
-					let { folderId } = _ref20, body = require_CalmLensUtils._objectWithoutProperties(_ref20, _excluded5);
-					if (!folderId) throw new Error("Folder ID is required");
+				var _ref18 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this5.begin("folders.update", options);
+					const { folderId } = options, body = require_CalmLensUtils._objectWithoutProperties(options, _excluded6);
+					if (!folderId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Folder ID is required" });
 					const folder = yield _this5.resolveFolder(folderId);
 					if (!folder) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.FOLDER_NOT_FOUND);
 					if (body.name !== void 0 && body.name !== folder.name) {
@@ -529,13 +625,15 @@ list: function() {
 					if (_this5.databaseStorage.updateFolder) return yield _this5.databaseStorage.updateFolder(updated);
 					return updated;
 				});
-				return function update(_x14) {
-					return _ref21.apply(this, arguments);
+				return function update(_x15) {
+					return _ref18.apply(this, arguments);
 				};
 			}(),
 			delete: function() {
-				var _ref22 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
-					if (!folderId) throw new Error("Folder ID is required");
+				var _ref19 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this5.begin("folders.delete", options);
+					const { folderId } = options;
+					if (!folderId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Folder ID is required" });
 					if (!(yield _this5.resolveFolder(folderId))) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.FOLDER_NOT_FOUND);
 					const hasAssets = (yield _this5.databaseStorage.listAssets(_this5.options.projectId)).some((asset) => asset.folderId === folderId);
 					const hasChildren = (_this5.databaseStorage.listFolders ? yield _this5.databaseStorage.listFolders(_this5.options.projectId) : []).some((f) => f.parentId === folderId);
@@ -545,13 +643,15 @@ list: function() {
 					} });
 					if (_this5.databaseStorage.deleteFolder) yield _this5.databaseStorage.deleteFolder(folderId);
 				});
-				return function _delete(_x15) {
-					return _ref22.apply(this, arguments);
+				return function _delete(_x16) {
+					return _ref19.apply(this, arguments);
 				};
 			}(),
 			move: function() {
-				var _ref23 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId, parentId }) {
-					if (!folderId) throw new Error("Folder ID is required");
+				var _ref20 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+					_this5.begin("folders.move", options);
+					const { folderId, parentId } = options;
+					if (!folderId) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Folder ID is required" });
 					const folder = yield _this5.resolveFolder(folderId);
 					if (!folder) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.FOLDER_NOT_FOUND);
 					const targetParentId = parentId !== null && parentId !== void 0 ? parentId : null;
@@ -574,8 +674,8 @@ list: function() {
 					if (_this5.databaseStorage.updateFolder) return yield _this5.databaseStorage.updateFolder(updated);
 					return updated;
 				});
-				return function move(_x16) {
-					return _ref23.apply(this, arguments);
+				return function move(_x17) {
+					return _ref20.apply(this, arguments);
 				};
 			}()
 		};
@@ -583,46 +683,58 @@ list: function() {
 	ensureLens(options) {
 		var _this6 = this;
 		return require_CalmLensUtils._asyncToGenerator(function* () {
-			var _existing$description, _options$description, _existing$transforms, _options$transforms;
-			const existing = _this6.lenses.get(options.identifier);
-			if (!existing) {
-				const lens = require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({
-					id: _this6.createId(),
-					projectId: _this6.options.projectId,
-					userId: null
-				}, options), {}, {
-					createdAt: _this6.now(),
-					updatedAt: _this6.now()
-				});
-				_this6.lenses.set(lens.identifier, lens);
-				return lens;
-			}
-			if (existing.name === options.name && ((_existing$description = existing.description) !== null && _existing$description !== void 0 ? _existing$description : null) === ((_options$description = options.description) !== null && _options$description !== void 0 ? _options$description : null) && existing.type === options.type && existing.active === options.active && require_CalmLensUtils.stringifyJsonCanonical((_existing$transforms = existing.transforms) !== null && _existing$transforms !== void 0 ? _existing$transforms : null) === require_CalmLensUtils.stringifyJsonCanonical((_options$transforms = options.transforms) !== null && _options$transforms !== void 0 ? _options$transforms : null) && existing.version === options.version) return existing;
-			if (options.version > existing.version) {
-				const lens = require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, existing), options), {}, { updatedAt: _this6.now() });
-				_this6.lenses.set(lens.identifier, lens);
-				return lens;
-			}
-			throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.LENS_VERSION_CONFLICT, { details: {
-				currentVersion: existing.version,
-				minimumVersion: existing.version + 1,
-				requestedVersion: options.version
-			} });
+			_this6.begin("ensureLens", options);
+			return _this6.ensureLensDefinition(options);
 		})();
 	}
-	ensureLenses({ lenses }) {
+	ensureLensDefinition(options) {
+		var _existing$description, _options$description, _existing$transforms, _options$transforms;
+		const existing = this.lenses.get(options.identifier);
+		if (!existing) {
+			const lens = require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({
+				id: this.createId(),
+				projectId: this.options.projectId,
+				userId: null
+			}, options), {}, {
+				createdAt: this.now(),
+				updatedAt: this.now()
+			});
+			this.lenses.set(lens.identifier, lens);
+			return lens;
+		}
+		if (existing.name === options.name && ((_existing$description = existing.description) !== null && _existing$description !== void 0 ? _existing$description : null) === ((_options$description = options.description) !== null && _options$description !== void 0 ? _options$description : null) && existing.type === options.type && existing.active === options.active && require_CalmLensUtils.stringifyJsonCanonical((_existing$transforms = existing.transforms) !== null && _existing$transforms !== void 0 ? _existing$transforms : null) === require_CalmLensUtils.stringifyJsonCanonical((_options$transforms = options.transforms) !== null && _options$transforms !== void 0 ? _options$transforms : null) && existing.version === options.version) return existing;
+		if (options.version > existing.version) {
+			const lens = require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, existing), options), {}, { updatedAt: this.now() });
+			this.lenses.set(lens.identifier, lens);
+			return lens;
+		}
+		throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.LENS_VERSION_CONFLICT, { details: {
+			currentVersion: existing.version,
+			minimumVersion: existing.version + 1,
+			requestedVersion: options.version
+		} });
+	}
+	ensureLenses(options) {
 		var _this7 = this;
 		return require_CalmLensUtils._asyncToGenerator(function* () {
-			if (lenses.length === 0) throw new Error("At least one lens is required");
-			return yield Promise.all(lenses.map((option) => _this7.ensureLens(option)));
+			_this7.begin("ensureLenses", options);
+			if (options.lenses.length === 0) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "At least one lens is required" });
+			return options.lenses.map((option) => _this7.ensureLensDefinition(option));
 		})();
 	}
-	createAsset(options, status) {
+	moderateAsset(options) {
 		var _this8 = this;
+		return require_CalmLensUtils._asyncToGenerator(function* () {
+			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" });
+			return _this8.createAsset(options, _this8.analyzedStatus);
+		})();
+	}
+	createAsset(options, status) {
+		var _this9 = this;
 		return require_CalmLensUtils._asyncToGenerator(function* () {
 			var _options$folderId, _options$visibility, _options$part$partNum;
-			if (!("content" in options) && !("url" in options) && !("part" in options)) throw new Error("Either file content, URL, or multipart part is required");
-			if (!options.name) throw new Error("Asset name is required");
+			if (!("content" in options) && !("url" in options) && !("part" in options)) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Either file content, URL, or multipart part is required" });
+			if (!options.name) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Asset name is required" });
 			if (!("part" in options) && "isFinal" in options) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "isFinal is only valid for multipart uploads" });
 			if ("part" in options && options.part.partNumber && options.part.partNumber > 1) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.USE_UPLOAD_PART);
 			if ("content" in options) {
@@ -640,13 +752,13 @@ list: function() {
 				});
 				if (!validation.ok) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: validation.error });
 			}
-			const id = _this8.createId();
-			const now = _this8.now();
+			const id = _this9.createId();
+			const now = _this9.now();
 			const type = inferAssetType(options);
-			const sizeInBytes = _this8.getSizeInBytes(options);
+			const sizeInBytes = _this9.getSizeInBytes(options);
 			const asset = {
 				id,
-				projectId: _this8.options.projectId,
+				projectId: _this9.options.projectId,
 				folderId: (_options$folderId = options.folderId) !== null && _options$folderId !== void 0 ? _options$folderId : null,
 				createdAt: now,
 				updatedAt: now,
@@ -663,24 +775,24 @@ list: function() {
 				uploadPartsReceived: "part" in options ? (_options$part$partNum = options.part.partNumber) !== null && _options$part$partNum !== void 0 ? _options$part$partNum : 1 : void 0
 			};
 			if ("content" in options) {
-				if (!("plainText" in options.content)) yield _this8.imageStorage.putContent(id, options.content);
-			} else if ("part" in options) yield _this8.imageStorage.putPart(id, options.part);
-			return _this8.databaseStorage.createAsset(asset);
+				if (!("plainText" in options.content)) yield _this9.imageStorage.putContent(id, options.content);
+			} else if ("part" in options) yield _this9.imageStorage.putPart(id, options.part);
+			return _this9.databaseStorage.createAsset(asset);
 		})();
 	}
 	resolveFolder(folderId) {
-		var _this9 = this;
+		var _this10 = this;
 		return require_CalmLensUtils._asyncToGenerator(function* () {
-			if (!_this9.databaseStorage.getFolder) return void 0;
-			const folder = yield _this9.databaseStorage.getFolder(folderId);
-			if (!folder || folder.projectId !== _this9.options.projectId) return;
+			if (!_this10.databaseStorage.getFolder) return void 0;
+			const folder = yield _this10.databaseStorage.getFolder(folderId);
+			if (!folder || folder.projectId !== _this10.options.projectId) return;
 			return folder;
 		})();
 	}
 	assertUniqueFolderName(name, parentId, excludeFolderId) {
-		var _this10 = this;
+		var _this11 = this;
 		return require_CalmLensUtils._asyncToGenerator(function* () {
-			if ((_this10.databaseStorage.listFolders ? yield _this10.databaseStorage.listFolders(_this10.options.projectId) : []).find((f) => f.id !== excludeFolderId && f.parentId === (parentId !== null && parentId !== void 0 ? parentId : null) && f.name === name)) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.DUPLICATE_FOLDER_NAME, { message: `A folder named "${name}" already exists in this location.` });
+			if ((_this11.databaseStorage.listFolders ? yield _this11.databaseStorage.listFolders(_this11.options.projectId) : []).find((f) => f.id !== excludeFolderId && f.parentId === (parentId !== null && parentId !== void 0 ? parentId : null) && f.name === name)) throw require_CalmLensUtils.calmLensError(require_CalmLensUtils.PUBLIC_ERROR_CODES.DUPLICATE_FOLDER_NAME, { message: `A folder named "${name}" already exists in this location.` });
 		})();
 	}
 	getSizeInBytes(options) {