@calmlens/sdk 0.11.0 → 0.13.0

package/cjs/testing.js

@@ -21,7 +21,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_CalmLensWebhooks = require("./CalmLensWebhooks-CH2PaPs0.js");
+const require_CalmLensVersion = require("./CalmLensVersion-DjhsJ1gj.js");
+const require_CalmLensWebhooks = require("./CalmLensWebhooks-hVquX5L1.js");
+const require_CalmLensUtils = require("./CalmLensUtils-vX5H_vMn.js");
 let zod = require("zod");
 zod = __toESM(zod);
 require("zod/v4");
@@ -58,60 +60,66 @@ const MODERATION_CATEGORY_DEFINITIONS = {
 		docsHref: "/docs/guides/moderation-categories#hate-and-identity-abuse"
 	},
 	"criminal-activity": {
-		summary: "Planning, assistance, instructions, encouragement or facilitation of a concrete criminal or seriously dangerous act.",
-		definition: "covers planning, requests for assistance, instructions, encouragement or facilitation of a concrete criminal or seriously dangerous act. A request can qualify even when no act occurs and a later reply refuses it. Dangerous activity requires a concrete serious risk of physical harm.",
-		exclusions: "Neutral reporting, prevention, lawful safety advice, fiction without criminal assistance, and vague dangerous references do not qualify. Masks, computers, payment cards, detention or ordinary tools do not establish criminal facilitation by themselves. A clear visual demonstration of how to carry out a crime can qualify.",
+		summary: "Planning, assistance, instructions, encouragement or facilitation of a concrete criminal or seriously dangerous act, and illegal drugs or contraband.",
+		definition: "covers planning, requests for assistance, instructions, encouragement or facilitation of a concrete criminal or seriously dangerous act. A request can qualify even when no act occurs and a later reply refuses it. Dangerous activity requires a concrete serious risk of physical harm. It also covers illegal drug use, dealing, production or trafficking, and contraband such as stolen goods, counterfeit money or documents and smuggled or illegally traded weapons.",
+		exclusions: "Neutral reporting, prevention, lawful safety advice, fiction without criminal assistance, and vague dangerous references do not qualify. Medical, pharmaceutical, clinical, research and educational content does not qualify, including prescriptions, dosages, side effects, controlled medicines used as prescribed, pharmacies, hospitals and drug manufacturing by pharmaceutical companies. Lawful alcohol and tobacco, harm reduction, addiction recovery and drug-policy discussion do not qualify either. Masks, computers, payment cards, detention or ordinary tools do not establish criminal facilitation by themselves. A clear visual demonstration of how to carry out a crime can qualify.",
 		docsHref: "/docs/guides/moderation-categories#criminal-and-dangerous-activity"
 	}
 };
 //#endregion
 //#region ../shared/src/ModerationPolicyDimensions.ts
 const MODERATION_QUALIFIERS = [
-	"nudity",
+	"sexual-nudity",
 	"sexual-activity",
-	"explicit-sexual-language",
+	"sexual-explicit-language",
 	"sexual-solicitation",
-	"physical-attack",
-	"violent-threat",
-	"violent-preparation",
-	"violent-encouragement",
-	"injury",
-	"death",
-	"graphic",
+	"sexual-historical",
+	"sexual-documentary",
+	"sexual-fictional",
+	"sexual-support-prevention",
+	"violence-attack",
+	"violence-threat",
+	"violence-preparation",
+	"violence-encouragement",
+	"violence-injury",
+	"violence-death",
+	"violence-graphic",
+	"violence-historical",
+	"violence-documentary",
+	"violence-fictional",
+	"violence-support-prevention",
 	"self-harm-thoughts",
 	"self-harm-preparation",
 	"self-harm-act",
 	"self-harm-methods",
 	"self-harm-encouragement",
-	"personal-abuse",
-	"targeted-intimidation",
+	"self-harm-documentary",
+	"self-harm-fictional",
+	"self-harm-support-prevention",
+	"harassment-abuse",
+	"harassment-intimidation",
 	"harassment-threat",
-	"sexual-harassment",
+	"harassment-sexual",
 	"harassment-encouragement",
-	"identity-abuse",
-	"dehumanization",
-	"identity-inferiority",
-	"discriminatory-exclusion",
+	"harassment-fictional",
+	"hate-abuse",
+	"hate-dehumanization",
+	"hate-inferiority",
+	"hate-exclusion",
 	"hate-threat",
-	"criminal-demonstration",
-	"criminal-preparation",
-	"criminal-request",
-	"criminal-instructions",
-	"criminal-promotion",
-	"historical",
-	"documentary",
-	"fictional",
-	"support-prevention"
+	"hate-historical",
+	"hate-fictional",
+	"criminal-activity-demonstration",
+	"criminal-activity-preparation",
+	"criminal-activity-request",
+	"criminal-activity-instructions",
+	"criminal-activity-promotion",
+	"criminal-activity-substances",
+	"criminal-activity-fictional"
 ];
-const SHARED_QUALIFIERS = [
-	"historical",
-	"documentary",
-	"fictional",
-	"support-prevention"
-];
-[...SHARED_QUALIFIERS], [...SHARED_QUALIFIERS], [...SHARED_QUALIFIERS], [...SHARED_QUALIFIERS], [...SHARED_QUALIFIERS], [...SHARED_QUALIFIERS];
 //#endregion
 //#region ../../node_modules/zod-meta/esm/index.js
+const ZOD_META_KEY = "__zod_meta__";
 const createMetaType = (type) => {
 	return Object.assign((value) => {
 		return {
@@ -120,7 +128,117 @@ const createMetaType = (type) => {
 		};
 	}, type);
 };
-createMetaType({ id: "docPropertyInfo" });
+const metaStore$1 = (meta) => {
+	const metaMap = meta.reduce((acc, meta) => {
+		if (meta) acc[meta.type.id] = meta;
+		return acc;
+	}, {});
+	return { [ZOD_META_KEY]: {
+		itemMap: metaMap,
+		get itemList() {
+			return Object.values(metaMap);
+		}
+	} };
+};
+//#endregion
+//#region ../shared/src/DocMetaTypes.ts
+const docPropertyInfo = createMetaType({ id: "docPropertyInfo" });
+//#endregion
+//#region ../shared/src/ProcessingFeatures.ts
+/**
+* Optional analyses a request can turn on with `processingOptions.features.<id>`. The catalog is
+* the single source for the request and result schemas, cache keys and metering. Features are
+* chosen per request only; there is no project-level default.
+*/
+/** How mature a feature is. Beta results may change shape. */
+const PROCESSING_FEATURE_STAGES = ["beta", "ga"];
+const createFeatureOptionsSchemas = (booleanSchema) => {
+	const enabled = booleanSchema.meta(metaStore$1([docPropertyInfo({ description: "Whether to run the feature. Every feature is off unless this is true." })]));
+	return {
+		ocr: zod.object({ enabled }).strict().meta(metaStore$1([docPropertyInfo({
+			description: "Extract image text into a child asset and run normal text moderation. Applies to images, including those extracted from multimedia documents and websites.",
+			namedType: "OcrFeatureOptions"
+		})])),
+		personDetection: zod.object({ enabled }).strict().meta(metaStore$1([docPropertyInfo({
+			description: "Beta. Locate people in images, including people whose faces are not visible. Results are informational and never change the moderation decision.",
+			namedType: "PersonDetectionFeatureOptions"
+		})])),
+		faceDetection: zod.object({
+			enabled,
+			ageEstimation: booleanSchema.optional().meta(metaStore$1([docPropertyInfo({
+				description: "Also estimate an age range for each face",
+				defaultValue: false
+			})]))
+		}).strict().meta(metaStore$1([docPropertyInfo({
+			description: "Beta. Locate faces in images and optionally estimate an age range for each. Faces are not identified or stored as biometric templates. Results are informational and never change the moderation decision.",
+			namedType: "FaceDetectionFeatureOptions"
+		})]))
+	};
+};
+const createProcessingFeaturesSchema = (booleanSchema) => {
+	const options = createFeatureOptionsSchemas(booleanSchema);
+	return zod.object({
+		ocr: options.ocr.nullish(),
+		personDetection: options.personDetection.nullish(),
+		faceDetection: options.faceDetection.nullish()
+	}).strict().meta(metaStore$1([docPropertyInfo({
+		description: "Optional analyses to run on this asset, keyed by feature. Unknown features are rejected.",
+		namedType: "ProcessingFeatures"
+	})]));
+};
+createProcessingFeaturesSchema(zod.boolean());
+/** Position and size as fractions of the image width and height, from 0 to 1. */
+const BOUNDING_BOX_SCHEMA = zod.object({
+	left: zod.number(),
+	top: zod.number(),
+	width: zod.number().min(0),
+	height: zod.number().min(0)
+}).strict().meta(metaStore$1([docPropertyInfo({
+	description: "Position and size as fractions of the image width and height, from 0 to 1. `left` and `top` can be slightly negative when the subject extends past the edge.",
+	namedType: "BoundingBox"
+})]));
+const DETECTION_CONFIDENCE_SCHEMA = zod.number().min(0).max(1).describe("Detection confidence from 0 to 1");
+const AGE_RANGE_SCHEMA = zod.object({
+	low: zod.number().int().nonnegative(),
+	high: zod.number().int().nonnegative()
+}).strict().meta(metaStore$1([docPropertyInfo({
+	description: "Estimated age range in years. Estimates can be off by several years.",
+	namedType: "AgeRange"
+})]));
+const DETECTED_PERSON_SCHEMA = zod.object({
+	box: BOUNDING_BOX_SCHEMA,
+	confidence: DETECTION_CONFIDENCE_SCHEMA
+}).strict().meta(metaStore$1([docPropertyInfo({
+	description: "A detected person",
+	namedType: "DetectedPerson"
+})]));
+const DETECTED_FACE_SCHEMA = zod.object({
+	box: BOUNDING_BOX_SCHEMA,
+	confidence: DETECTION_CONFIDENCE_SCHEMA,
+	ageRange: AGE_RANGE_SCHEMA.optional()
+}).strict().meta(metaStore$1([docPropertyInfo({
+	description: "A detected face",
+	namedType: "DetectedFace"
+})]));
+const NOT_EVALUATED_FEATURE_RESULT_SCHEMA = zod.object({
+	status: zod.literal("not-evaluated"),
+	stage: zod.enum(PROCESSING_FEATURE_STAGES),
+	reason: zod.enum(["not-supported", "unavailable"])
+}).strict();
+const createFeatureResultSchema = (shape) => zod.discriminatedUnion("status", [zod.object({
+	status: zod.literal("evaluated"),
+	stage: zod.enum(PROCESSING_FEATURE_STAGES),
+	...shape
+}).strict(), NOT_EVALUATED_FEATURE_RESULT_SCHEMA]);
+const PERSON_DETECTION_RESULT_SCHEMA = createFeatureResultSchema({ people: zod.array(DETECTED_PERSON_SCHEMA) });
+const FACE_DETECTION_RESULT_SCHEMA = createFeatureResultSchema({ faces: zod.array(DETECTED_FACE_SCHEMA) });
+const PROCESSING_FEATURE_RESULTS_SCHEMA = zod.object({
+	personDetection: PERSON_DETECTION_RESULT_SCHEMA.optional(),
+	faceDetection: FACE_DETECTION_RESULT_SCHEMA.optional()
+}).strict().meta(metaStore$1([docPropertyInfo({
+	description: "Results of the optional features requested in `processingOptions.features`, keyed by feature",
+	namedType: "ProcessingFeatureResults"
+})]));
 //#endregion
 //#region ../shared/src/ZodUtils.ts
 const SIZE_LIMITS = {
@@ -163,7 +281,11 @@ const LIKELIHOOD_SCHEMA = zod.enum([
 	"likely",
 	"very-likely"
 ]);
-const CLASSIFICATION_NOT_EVALUATED_REASON_SCHEMA = zod.enum(["not-supported", "unavailable"]);
+const CLASSIFICATION_NOT_EVALUATED_REASON_SCHEMA = zod.enum([
+	"not-supported",
+	"unavailable",
+	"not-requested"
+]);
 const CLASSIFICATION_QUALIFIER_RESULTS_SCHEMA = zod.partialRecord(zod.enum(MODERATION_QUALIFIERS), zod.discriminatedUnion("status", [zod.object({
 	status: zod.literal("evaluated"),
 	score: zod.number().min(0).max(1),
@@ -233,7 +355,8 @@ zod.object({
 			categories: CATEGORIES_SCHEMA
 		}).strict())
 	}).strict().optional(),
-	labels: zod.array(CLASSIFICATION_LABEL_SCHEMA).nullish()
+	labels: zod.array(CLASSIFICATION_LABEL_SCHEMA).nullish(),
+	features: PROCESSING_FEATURE_RESULTS_SCHEMA.optional()
 }).strict();
 //#endregion
 //#region ../shared/src/MediaTestTriggers.ts
@@ -288,6 +411,10 @@ const ACTION_SCHEMA = zod.enum([
 	"metadata:write",
 	"lenses:read",
 	"lenses:write",
+	"upload-presets:read",
+	"upload-presets:write",
+	"reviews:read",
+	"reviews:write",
 	"project:manage"
 ]);
 const PROJECT_ACTIONS = [...[
@@ -296,7 +423,9 @@ const PROJECT_ACTIONS = [...[
 	"api-keys",
 	"connectors",
 	"metadata",
-	"lenses"
+	"lenses",
+	"upload-presets",
+	"reviews"
 ].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. */
@@ -309,7 +438,7 @@ const GRANT_SCHEMA = zod.object({
 const GRANTS_SCHEMA = zod.array(GRANT_SCHEMA).max(100);
 zod.enum([
 	"admin",
-	"member",
+	"editor",
 	"viewer",
 	"custom"
 ]);
@@ -357,9 +486,9 @@ var InMemoryMockImageStorage = class {
 		this.content = /* @__PURE__ */ new Map();
 	}
 	async putContent(assetId, content) {
-		const validation = require_CalmLensWebhooks.validateAssetPayload(content);
+		const validation = require_CalmLensUtils.validateAssetPayload(content);
 		if (!validation.ok) throw new Error(validation.error);
-		const bytes = await require_CalmLensWebhooks.assetDataToUint8Array(require_CalmLensWebhooks.assetToData(content));
+		const bytes = await require_CalmLensUtils.assetDataToUint8Array(require_CalmLensUtils.assetToData(content));
 		this.content.set(assetId, {
 			assetId,
 			parts: /* @__PURE__ */ new Map([[1, bytes]]),
@@ -367,12 +496,12 @@ var InMemoryMockImageStorage = class {
 		});
 	}
 	async putPart(assetId, part) {
-		const validation = require_CalmLensWebhooks.validateAssetPayload(part, {
+		const validation = require_CalmLensUtils.validateAssetPayload(part, {
 			multipart: true,
 			isFinal: part.isFinal
 		});
 		if (!validation.ok) throw new Error(validation.error);
-		const bytes = await require_CalmLensWebhooks.assetDataToUint8Array(require_CalmLensWebhooks.assetToData(part));
+		const bytes = await require_CalmLensUtils.assetDataToUint8Array(require_CalmLensUtils.assetToData(part));
 		const existing = this.content.get(assetId) ?? {
 			assetId,
 			parts: /* @__PURE__ */ new Map(),
@@ -455,8 +584,8 @@ const inferAssetType = (options) => {
 const createPage = (items, query) => {
 	const pageIndex = query.pageIndex ?? 0;
 	const pageSize = query.pageSize ?? 10;
-	if (!Number.isInteger(pageIndex) || pageIndex < 0) throw require_CalmLensWebhooks.invalidArgument("pageIndex must be a non-negative integer");
-	if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) throw require_CalmLensWebhooks.invalidArgument("pageSize must be an integer from 1 to 100");
+	if (!Number.isInteger(pageIndex) || pageIndex < 0) throw require_CalmLensVersion.invalidArgument("pageIndex must be a non-negative integer");
+	if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) throw require_CalmLensVersion.invalidArgument("pageSize must be an integer from 1 to 100");
 	const start = pageIndex * pageSize;
 	return {
 		items: items.slice(start, start + pageSize),
@@ -499,7 +628,7 @@ const parseFilterValue = (raw) => {
 	return value;
 };
 const readField = (item, path) => path.split(".").reduce((value, key) => value && typeof value === "object" ? value[key] : void 0, item);
-const unsupportedFilter = (expression) => require_CalmLensWebhooks.invalidArgument(`MockCalmLensClient cannot evaluate the filter "${expression}". It supports ==, !=, <, <=, >, >=, =in= and =out=, joined by ; (and) or , (or), without grouping parentheses.`);
+const unsupportedFilter = (expression) => require_CalmLensVersion.invalidArgument(`MockCalmLensServerClient cannot evaluate the filter "${expression}". It supports ==, !=, <, <=, >, >=, =in= and =out=, joined by ; (and) or , (or), without grouping parentheses.`);
 const matchesComparison = (item, comparison) => {
 	const match = COMPARISON.exec(comparison.trim());
 	if (!match) throw unsupportedFilter(comparison);
@@ -556,7 +685,7 @@ const filterAssets = (items, filter) => {
 	return items.filter((item) => alternatives.some((conditions) => conditions.every((condition) => matchesComparison(item, condition))));
 };
 //#endregion
-//#region src/testing/MockCalmLensClient.ts
+//#region src/testing/MockCalmLensServerClient.ts
 const DEFAULT_EVENTS_LIMIT = 50;
 /** Stands in for binary payloads when comparing idempotent requests, like the API's size check. */
 const describeBinary = (value) => {
@@ -567,14 +696,14 @@ const describeBinary = (value) => {
 };
 const MAX_EVENTS_LIMIT = 100;
 const toFailureError = (failure) => {
-	if (failure === "transport-error") return new require_CalmLensWebhooks.CalmLensError(require_CalmLensWebhooks.SDK_ERROR_CODES.TRANSPORT_ERROR, {
+	if (failure === "transport-error") return new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.TRANSPORT_ERROR, {
 		message: "Request failed",
 		cause: /* @__PURE__ */ new TypeError("Simulated network failure")
 	});
 	if (failure === "timeout") {
 		const cause = /* @__PURE__ */ new Error("The operation timed out.");
 		cause.name = "TimeoutError";
-		return new require_CalmLensWebhooks.CalmLensError(require_CalmLensWebhooks.SDK_ERROR_CODES.TIMEOUT, {
+		return new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.TIMEOUT, {
 			message: "Request timed out",
 			cause
 		});
@@ -582,12 +711,12 @@ const toFailureError = (failure) => {
 	return failure;
 };
 /**
-* An in-memory stand-in for `CalmLensClient` with the same methods, validation and error
+* An in-memory stand-in for `CalmLensServerClient` with the same methods, validation and error
 * codes. API errors carry the HTTP status, a `requestId` and response headers like the real
 * client's, so error handling can be tested without a network.
 */
-var MockCalmLensClient = class {
-	/** Accepts the same options as `CalmLensClient` (validated the same way), plus `mockOptions`. */
+var MockCalmLensServerClient = class {
+	/** Accepts the same options as `CalmLensServerClient` (validated the same way), plus `mockOptions`. */
 	constructor(options) {
 		this.lenses = /* @__PURE__ */ new Map();
 		this.eventFeed = [];
@@ -596,8 +725,9 @@ var MockCalmLensClient = class {
 		this.requestCount = 0;
 		this.pendingFailures = [];
 		this.calls = [];
-		require_CalmLensWebhooks.validateClientOptions(options);
+		require_CalmLensUtils.validateServerClientOptions(options);
 		this.projectId = options.projectId;
+		this.apiKey = options.apiKey;
 		this.databaseStorage = options.mockOptions?.databaseStorage ?? new InMemoryMockDatabaseStorage();
 		this.imageStorage = options.mockOptions?.imageStorage ?? new InMemoryMockImageStorage();
 		this.createId = options.mockOptions?.createId ?? crypto.randomUUID.bind(crypto);
@@ -610,7 +740,7 @@ var MockCalmLensClient = class {
 	}
 	/** Keeps the API key out of `console.log` and `util.inspect`. */
 	[Symbol.for("nodejs.util.inspect.custom")]() {
-		return `MockCalmLensClient { projectId: ${JSON.stringify(this.projectId)} }`;
+		return `MockCalmLensServerClient { projectId: ${JSON.stringify(this.projectId)} }`;
 	}
 	/**
 	* Makes the next call (or the next call to `operation`) throw `failure` instead of running,
@@ -647,9 +777,9 @@ var MockCalmLensClient = class {
 	}
 	/** An API error as the real client throws it: status, default message and request ID. */
 	apiError(code, options = {}) {
-		const definition = require_CalmLensWebhooks.API_ERROR_DEFINITIONS[code];
+		const definition = require_CalmLensVersion.API_ERROR_DEFINITIONS[code];
 		const requestId = `mock-request-${++this.requestCount}`;
-		return new require_CalmLensWebhooks.CalmLensError(code, {
+		return new require_CalmLensVersion.CalmLensError(code, {
 			message: options.message ?? definition.message,
 			status: definition.status,
 			details: options.details,
@@ -661,18 +791,18 @@ var MockCalmLensClient = class {
 		});
 	}
 	assertValidUploadMimeType(mimeType) {
-		if (require_CalmLensWebhooks.isRejectedUploadMimeType(mimeType)) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.INVALID_UPLOAD_MIME_TYPE, {
-			message: require_CalmLensWebhooks.getRejectedUploadMimeTypeError(mimeType),
+		if (require_CalmLensUtils.isRejectedUploadMimeType(mimeType)) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.INVALID_UPLOAD_MIME_TYPE, {
+			message: require_CalmLensUtils.getRejectedUploadMimeTypeError(mimeType),
 			details: { mimeType }
 		});
 	}
 	invalidPayload(message) {
-		return this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message });
+		return this.apiError(require_CalmLensVersion.API_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message });
 	}
 	async findOwnAsset(assetId) {
-		require_CalmLensWebhooks.encodePathSegment(assetId, "Asset ID");
+		require_CalmLensUtils.encodePathSegment(assetId, "Asset ID");
 		const asset = await this.databaseStorage.getAsset(assetId);
-		if (!asset || asset.projectId !== this.projectId) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.ASSET_NOT_FOUND);
+		if (!asset || asset.projectId !== this.projectId) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.ASSET_NOT_FOUND);
 		return asset;
 	}
 	begin(operation, options) {
@@ -702,8 +832,8 @@ var MockCalmLensClient = class {
 		return {
 			getAssetUrl: ({ assetIdentifier, ...options }) => {
 				const resource = options.resource ?? "content";
-				const url = `${this.cdnBaseUrl}/assets/${encodeURIComponent(this.projectId)}/${require_CalmLensWebhooks.encodePathSegment(assetIdentifier, "Asset identifier")}/${resource}`;
-				return require_CalmLensWebhooks.appendCdnSelector(url, options);
+				const url = `${this.cdnBaseUrl}/assets/${encodeURIComponent(this.projectId)}/${require_CalmLensUtils.encodePathSegment(assetIdentifier, "Asset identifier")}/${resource}`;
+				return require_CalmLensUtils.appendCdnSelector(url, options);
 			},
 			/**
 			* Serves stored content like the CDN: `200` with `Content-Type`, `Content-Length`,
@@ -771,7 +901,7 @@ var MockCalmLensClient = class {
 	}
 	listEvents(options) {
 		const limit = options.limit ?? DEFAULT_EVENTS_LIMIT;
-		if (!Number.isInteger(limit) || limit < 1 || limit > MAX_EVENTS_LIMIT) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: `limit must be an integer from 1 to ${MAX_EVENTS_LIMIT}` });
+		if (!Number.isInteger(limit) || limit < 1 || limit > MAX_EVENTS_LIMIT) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: `limit must be an integer from 1 to ${MAX_EVENTS_LIMIT}` });
 		if (!options.after) return {
 			events: [],
 			cursor: `mock_${this.eventFeed.length}`,
@@ -779,7 +909,7 @@ var MockCalmLensClient = class {
 		};
 		const match = /^mock_(\d+)$/.exec(options.after);
 		const position = match ? Number(match[1]) : NaN;
-		if (!Number.isSafeInteger(position) || position > this.eventFeed.length) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.INVALID_EVENT_CURSOR);
+		if (!Number.isSafeInteger(position) || position > this.eventFeed.length) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.INVALID_EVENT_CURSOR);
 		const events = this.eventFeed.slice(position, position + limit);
 		const next = position + events.length;
 		return {
@@ -810,7 +940,7 @@ var MockCalmLensClient = class {
 	get text() {
 		return { moderate: async (options) => {
 			this.begin("text.moderate", options);
-			return this.moderateAsset(require_CalmLensWebhooks.toTextAssetOptions(options), "text.moderate");
+			return this.moderateAsset(require_CalmLensUtils.toTextAssetOptions(options), "text.moderate");
 		} };
 	}
 	get assets() {
@@ -869,7 +999,7 @@ var MockCalmLensClient = class {
 			listChildren: async (childrenOptions = {}) => {
 				this.begin("assets.listChildren", childrenOptions);
 				const { assetId, ...options } = childrenOptions;
-				require_CalmLensWebhooks.encodePathSegment(assetId, "Asset ID");
+				require_CalmLensUtils.encodePathSegment(assetId, "Asset ID");
 				const assets = await this.databaseStorage.listAssets(this.projectId);
 				return createPage(orderItems(assets.filter((asset) => asset.parentId === assetId), options.ordering), {
 					...options,
@@ -877,7 +1007,7 @@ var MockCalmLensClient = class {
 				});
 			},
 			iterateChildren: (options) => {
-				require_CalmLensWebhooks.encodePathSegment(options?.assetId, "Asset ID");
+				require_CalmLensUtils.encodePathSegment(options?.assetId, "Asset ID");
 				return this.iteratePages((pageIndex) => this.assets.listChildren({
 					...options,
 					pageIndex
@@ -906,18 +1036,18 @@ var MockCalmLensClient = class {
 			uploadPart: async (options) => {
 				this.begin("assets.uploadPart", options);
 				const { assetId, part } = options;
-				require_CalmLensWebhooks.encodePathSegment(assetId, "Asset ID");
-				if (!part) throw require_CalmLensWebhooks.invalidArgument("Part options are required");
+				require_CalmLensUtils.encodePathSegment(assetId, "Asset ID");
+				if (!part) throw require_CalmLensVersion.invalidArgument("Part options are required");
 				return this.withIdempotency("assets.uploadPart", options, async () => {
 					const asset = await this.findOwnAsset(assetId);
-					const validation = require_CalmLensWebhooks.validateAssetPayload(part, {
+					const validation = require_CalmLensUtils.validateAssetPayload(part, {
 						multipart: true,
 						isFinal: part.isFinal
 					});
 					if (!validation.ok) throw this.invalidPayload(validation.error);
-					if (asset.status !== "uploading") throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.UPLOAD_NOT_OPEN);
+					if (asset.status !== "uploading") throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.UPLOAD_NOT_OPEN);
 					const expectedPartNumber = (asset.uploadPartsReceived ?? 1) + 1;
-					if (part.partNumber !== expectedPartNumber) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.INVALID_UPLOAD_PART_NUMBER, { details: { expectedPartNumber } });
+					if (part.partNumber !== expectedPartNumber) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.INVALID_UPLOAD_PART_NUMBER, { details: { expectedPartNumber } });
 					await this.imageStorage.putPart(assetId, part);
 					const queue = options.queue ?? this.uploadQueues.get(assetId) ?? false;
 					if (part.isFinal) this.uploadQueues.delete(assetId);
@@ -933,10 +1063,10 @@ var MockCalmLensClient = class {
 				this.begin("assets.createSignedUrl", signedUrlOptions);
 				const { assetId, ...options } = signedUrlOptions;
 				const asset = await this.findOwnAsset(assetId);
-				if (options.lens && options.transform) throw require_CalmLensWebhooks.invalidArgument("Specify either a lens or a transform, not both");
+				if (options.lens && options.transform) throw require_CalmLensVersion.invalidArgument("Specify either a lens or a transform, not both");
 				const expiresInSeconds = options.expiresInSeconds ?? 900;
 				const resource = options.resource ?? "content";
-				const transform = require_CalmLensWebhooks.transformSelector(options.transform);
+				const transform = require_CalmLensUtils.transformSelector(options.transform);
 				const selector = options.lens ? `&lens=${encodeURIComponent(options.lens)}` : transform ? `&transform=${encodeURIComponent(transform)}` : "";
 				return {
 					url: `${this.signedUrlBaseUrl}/assets/${asset.id}/${resource}?expiresInSeconds=${expiresInSeconds}${selector}`,
@@ -948,7 +1078,7 @@ var MockCalmLensClient = class {
 				const { assetId, folderId } = options;
 				const asset = await this.findOwnAsset(assetId);
 				if (folderId !== null && folderId !== void 0) {
-					if (!await this.resolveFolder(folderId)) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.FOLDER_NOT_FOUND);
+					if (!await this.resolveFolder(folderId)) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.FOLDER_NOT_FOUND);
 				}
 				return this.databaseStorage.updateAsset({
 					...asset,
@@ -959,14 +1089,20 @@ var MockCalmLensClient = class {
 			retry: async (options) => {
 				this.begin("assets.retry", options);
 				const asset = await this.findOwnAsset(options?.assetId);
-				if (asset.status !== "error") throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.ASSET_NOT_RETRYABLE);
-				if (asset.storageDeletedAt) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.ASSET_CONTENT_UNAVAILABLE);
+				if (asset.status !== "error") throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.ASSET_NOT_RETRYABLE);
+				if (asset.storageDeletedAt) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.ASSET_CONTENT_UNAVAILABLE);
 				return this.databaseStorage.updateAsset({
 					...asset,
 					status: "pending",
 					updatedAt: this.now()
 				});
 			},
+			/** Waits like the real client, checking the mock's storage for a decision. */
+			waitForDecision: async (options) => {
+				this.begin("assets.waitForDecision", options);
+				const { assetId, ...waitOptions } = options;
+				return require_CalmLensUtils.pollForDecision(() => this.findOwnAsset(assetId), waitOptions, require_CalmLensUtils.sleep);
+			},
 			deleteContent: async (options) => {
 				this.begin("assets.deleteContent", options);
 				const asset = await this.findOwnAsset(options?.assetId);
@@ -986,6 +1122,16 @@ var MockCalmLensClient = class {
 			}
 		};
 	}
+	/** Signs real upload tokens with the mock's API key, like the real client, without a request. */
+	get uploadTokens() {
+		return { sign: async (options) => {
+			this.begin("uploadTokens.sign", options);
+			return require_CalmLensWebhooks.signUploadTokenWithApiKey(this.apiKey, options, {
+				now: this.now(),
+				nonce: this.createId()
+			});
+		} };
+	}
 	get folders() {
 		return {
 			list: async () => {
@@ -1029,7 +1175,7 @@ var MockCalmLensClient = class {
 				await this.findOwnFolder(folderId);
 				const hasAssets = (await this.databaseStorage.listAssets(this.projectId)).some((asset) => asset.folderId === folderId);
 				const hasChildren = (this.databaseStorage.listFolders ? await this.databaseStorage.listFolders(this.projectId) : []).some((f) => f.parentId === folderId);
-				if (hasAssets || hasChildren) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.FOLDER_NOT_EMPTY, { details: {
+				if (hasAssets || hasChildren) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.FOLDER_NOT_EMPTY, { details: {
 					hasAssets,
 					hasChildren
 				} });
@@ -1044,7 +1190,7 @@ var MockCalmLensClient = class {
 					let candidate = await this.findOwnFolder(targetParentId);
 					const visited = /* @__PURE__ */ new Set();
 					while (candidate) {
-						if (candidate.id === folderId || visited.has(candidate.id)) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.FOLDER_PARENT_CYCLE);
+						if (candidate.id === folderId || visited.has(candidate.id)) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.FOLDER_PARENT_CYCLE);
 						visited.add(candidate.id);
 						candidate = candidate.parentId ? await this.resolveFolder(candidate.parentId) : void 0;
 					}
@@ -1061,7 +1207,7 @@ var MockCalmLensClient = class {
 	}
 	async ensureLens(options) {
 		this.begin("ensureLens", options);
-		if (!options?.identifier) throw require_CalmLensWebhooks.invalidArgument("Lens identifier is required");
+		if (!options?.identifier) throw require_CalmLensVersion.invalidArgument("Lens identifier is required");
 		return this.ensureLensDefinition(options);
 	}
 	ensureLensDefinition(options) {
@@ -1088,7 +1234,7 @@ var MockCalmLensClient = class {
 			this.lenses.set(lens.identifier, lens);
 			return lens;
 		}
-		throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.LENS_VERSION_CONFLICT, { details: {
+		throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.LENS_VERSION_CONFLICT, { details: {
 			currentVersion: existing.version,
 			minimumVersion: existing.version + 1,
 			requestedVersion: options.version
@@ -1096,19 +1242,19 @@ var MockCalmLensClient = class {
 	}
 	async ensureLenses(options) {
 		this.begin("ensureLenses", options);
-		if (!Array.isArray(options?.lenses) || options.lenses.length === 0) throw require_CalmLensWebhooks.invalidArgument("At least one lens is required");
-		if (options.lenses.some((lens) => !lens?.identifier)) throw require_CalmLensWebhooks.invalidArgument("Lens identifier is required");
+		if (!Array.isArray(options?.lenses) || options.lenses.length === 0) throw require_CalmLensVersion.invalidArgument("At least one lens is required");
+		if (options.lenses.some((lens) => !lens?.identifier)) throw require_CalmLensVersion.invalidArgument("Lens identifier is required");
 		return options.lenses.map((option) => this.ensureLensDefinition(option));
 	}
 	/** Replays the first result for a reused idempotency key, like the API. */
 	async withIdempotency(operation, options, run) {
 		const key = options?.idempotencyKey;
 		if (key === void 0) return run();
-		if (!key || key.length > 255 || !/^[\x21-\x7e]+$/.test(key)) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.INVALID_IDEMPOTENCY_KEY);
+		if (!key || key.length > 255 || !/^[\x21-\x7e]+$/.test(key)) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.INVALID_IDEMPOTENCY_KEY);
 		const fingerprint = `${operation}:${require_CalmLensWebhooks.stringifyJsonCanonical(JSON.parse(JSON.stringify(options, (_key, value) => describeBinary(value))))}`;
 		const saved = this.idempotentResults.get(key);
 		if (saved) {
-			if (saved.fingerprint !== fingerprint) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.IDEMPOTENCY_KEY_REUSED);
+			if (saved.fingerprint !== fingerprint) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.IDEMPOTENCY_KEY_REUSED);
 			return saved.asset;
 		}
 		const asset = await run();
@@ -1123,28 +1269,28 @@ var MockCalmLensClient = class {
 		return this.withIdempotency(operation, options, () => this.createAsset(options, false));
 	}
 	async createAsset(options, queue) {
-		if (!options || typeof options !== "object") throw require_CalmLensWebhooks.invalidArgument("Asset options are required");
+		if (!options || typeof options !== "object") throw require_CalmLensVersion.invalidArgument("Asset options are required");
 		if (!("content" in options) && !("url" in options) && !("part" in options)) throw this.invalidPayload("Either file content, URL, or multipart part is required");
 		if (!options.name) throw this.invalidPayload("Asset name is required");
 		if (!("part" in options) && "isFinal" in options) throw this.invalidPayload("isFinal is only valid for multipart uploads");
-		if ("part" in options && options.part.partNumber && options.part.partNumber > 1) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.USE_UPLOAD_PART);
+		if ("part" in options && options.part.partNumber && options.part.partNumber > 1) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.USE_UPLOAD_PART);
 		if ("content" in options) {
 			this.assertValidUploadMimeType(options.content.type);
 			if (!("plainText" in options.content)) {
-				const validation = require_CalmLensWebhooks.validateAssetPayload(options.content);
+				const validation = require_CalmLensUtils.validateAssetPayload(options.content);
 				if (!validation.ok) throw this.invalidPayload(validation.error);
 			}
 		}
 		if ("part" in options) {
 			this.assertValidUploadMimeType(options.part.type);
-			const validation = require_CalmLensWebhooks.validateAssetPayload(options.part, {
+			const validation = require_CalmLensUtils.validateAssetPayload(options.part, {
 				multipart: true,
 				isFinal: options.part.isFinal
 			});
 			if (!validation.ok) throw this.invalidPayload(validation.error);
 		}
 		if (options.externalId) {
-			if ((await this.databaseStorage.listAssets(this.projectId)).some((asset) => asset.externalId === options.externalId)) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.DUPLICATE_EXTERNAL_ID);
+			if ((await this.databaseStorage.listAssets(this.projectId)).some((asset) => asset.externalId === options.externalId)) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.DUPLICATE_EXTERNAL_ID);
 		}
 		const id = this.createId();
 		const now = this.now();
@@ -1182,20 +1328,20 @@ var MockCalmLensClient = class {
 		return folder;
 	}
 	async findOwnFolder(folderId) {
-		require_CalmLensWebhooks.encodePathSegment(folderId, "Folder ID");
+		require_CalmLensUtils.encodePathSegment(folderId, "Folder ID");
 		const folder = await this.resolveFolder(folderId);
-		if (!folder) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.FOLDER_NOT_FOUND);
+		if (!folder) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.FOLDER_NOT_FOUND);
 		return folder;
 	}
 	async assertUniqueFolderName(name, parentId, excludeFolderId) {
-		if ((this.databaseStorage.listFolders ? await this.databaseStorage.listFolders(this.projectId) : []).find((f) => f.id !== excludeFolderId && f.parentId === (parentId ?? null) && f.name === name)) throw this.apiError(require_CalmLensWebhooks.API_ERROR_CODES.DUPLICATE_FOLDER_NAME, { message: `A folder named "${name}" already exists in this location.` });
+		if ((this.databaseStorage.listFolders ? await this.databaseStorage.listFolders(this.projectId) : []).find((f) => f.id !== excludeFolderId && f.parentId === (parentId ?? null) && f.name === name)) throw this.apiError(require_CalmLensVersion.API_ERROR_CODES.DUPLICATE_FOLDER_NAME, { message: `A folder named "${name}" already exists in this location.` });
 	}
 	getSizeInBytes(options) {
 		if ("content" in options) {
 			if ("plainText" in options.content) return new TextEncoder().encode(options.content.plainText).byteLength;
-			return require_CalmLensWebhooks.getAssetPayloadByteLength(options.content);
+			return require_CalmLensUtils.getAssetPayloadByteLength(options.content);
 		}
-		if ("part" in options) return options.part.sizeInBytes ?? options.sizeInBytes ?? require_CalmLensWebhooks.getAssetPayloadByteLength(options.part);
+		if ("part" in options) return options.part.sizeInBytes ?? options.sizeInBytes ?? require_CalmLensUtils.getAssetPayloadByteLength(options.part);
 	}
 };
 //#endregion
@@ -1232,7 +1378,7 @@ exports.InMemoryMockDatabaseStorage = InMemoryMockDatabaseStorage;
 exports.InMemoryMockImageStorage = InMemoryMockImageStorage;
 exports.MEDIA_TEST_SIGNALS = MEDIA_TEST_SIGNALS;
 exports.MOCK_API_KEY_PREFIX = MOCK_API_KEY_PREFIX;
-exports.MockCalmLensClient = MockCalmLensClient;
+exports.MockCalmLensServerClient = MockCalmLensServerClient;
 exports.createMockApiKey = createMockApiKey;
 exports.createWebhookHeaders = createWebhookHeaders;
 exports.createWebhookSignatureHeader = createWebhookSignatureHeader;