@calmlens/sdk 0.10.1 → 0.12.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-DJnaLpRy.js");
+const require_CalmLensError = require("./CalmLensError-CKwMKV0S.js");
+const require_CalmLensWebhooks = require("./CalmLensWebhooks-BTPxKvcD.js");
+const require_CalmLensUtils = require("./CalmLensUtils-Dg3s4loH.js");
 let zod = require("zod");
 zod = __toESM(zod);
 require("zod/v4");
@@ -112,6 +114,7 @@ const SHARED_QUALIFIERS = [
 [...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 +123,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 = {
@@ -233,7 +346,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 +402,8 @@ const ACTION_SCHEMA = zod.enum([
 	"metadata:write",
 	"lenses:read",
 	"lenses:write",
+	"upload-presets:read",
+	"upload-presets:write",
 	"project:manage"
 ]);
 const PROJECT_ACTIONS = [...[
@@ -296,7 +412,8 @@ const PROJECT_ACTIONS = [...[
 	"api-keys",
 	"connectors",
 	"metadata",
-	"lenses"
+	"lenses",
+	"upload-presets"
 ].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. */
@@ -357,9 +474,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 +484,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 +572,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_CalmLensError.invalidArgument("pageIndex must be a non-negative integer");
+	if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) throw require_CalmLensError.invalidArgument("pageSize must be an integer from 1 to 100");
 	const start = pageIndex * pageSize;
 	return {
 		items: items.slice(start, start + pageSize),
@@ -499,7 +616,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_CalmLensError.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 +673,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 +684,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_CalmLensError.CalmLensError(require_CalmLensError.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_CalmLensError.CalmLensError(require_CalmLensError.SDK_ERROR_CODES.TIMEOUT, {
 			message: "Request timed out",
 			cause
 		});
@@ -582,12 +699,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 +713,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 +728,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 +765,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_CalmLensError.API_ERROR_DEFINITIONS[code];
 		const requestId = `mock-request-${++this.requestCount}`;
-		return new require_CalmLensWebhooks.CalmLensError(code, {
+		return new require_CalmLensError.CalmLensError(code, {
 			message: options.message ?? definition.message,
 			status: definition.status,
 			details: options.details,
@@ -661,18 +779,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_CalmLensError.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_CalmLensError.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_CalmLensError.API_ERROR_CODES.ASSET_NOT_FOUND);
 		return asset;
 	}
 	begin(operation, options) {
@@ -702,8 +820,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 +889,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_CalmLensError.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 +897,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_CalmLensError.API_ERROR_CODES.INVALID_EVENT_CURSOR);
 		const events = this.eventFeed.slice(position, position + limit);
 		const next = position + events.length;
 		return {
@@ -810,7 +928,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 +987,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 +995,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 +1024,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_CalmLensError.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_CalmLensError.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_CalmLensError.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 +1051,11 @@ 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_CalmLensError.invalidArgument("Specify either a lens or a transform, not both");
 				const expiresInSeconds = options.expiresInSeconds ?? 900;
 				const resource = options.resource ?? "content";
-				const selector = options.lens ? `&lens=${encodeURIComponent(options.lens)}` : options.transform ? `&transform=${encodeURIComponent(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}`,
 					expiresAt: this.now() + expiresInSeconds * 1e3
@@ -947,7 +1066,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_CalmLensError.API_ERROR_CODES.FOLDER_NOT_FOUND);
 				}
 				return this.databaseStorage.updateAsset({
 					...asset,
@@ -958,8 +1077,8 @@ 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_CalmLensError.API_ERROR_CODES.ASSET_NOT_RETRYABLE);
+				if (asset.storageDeletedAt) throw this.apiError(require_CalmLensError.API_ERROR_CODES.ASSET_CONTENT_UNAVAILABLE);
 				return this.databaseStorage.updateAsset({
 					...asset,
 					status: "pending",
@@ -985,6 +1104,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 () => {
@@ -1028,7 +1157,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_CalmLensError.API_ERROR_CODES.FOLDER_NOT_EMPTY, { details: {
 					hasAssets,
 					hasChildren
 				} });
@@ -1043,7 +1172,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_CalmLensError.API_ERROR_CODES.FOLDER_PARENT_CYCLE);
 						visited.add(candidate.id);
 						candidate = candidate.parentId ? await this.resolveFolder(candidate.parentId) : void 0;
 					}
@@ -1060,7 +1189,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_CalmLensError.invalidArgument("Lens identifier is required");
 		return this.ensureLensDefinition(options);
 	}
 	ensureLensDefinition(options) {
@@ -1087,7 +1216,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_CalmLensError.API_ERROR_CODES.LENS_VERSION_CONFLICT, { details: {
 			currentVersion: existing.version,
 			minimumVersion: existing.version + 1,
 			requestedVersion: options.version
@@ -1095,19 +1224,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_CalmLensError.invalidArgument("At least one lens is required");
+		if (options.lenses.some((lens) => !lens?.identifier)) throw require_CalmLensError.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_CalmLensError.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_CalmLensError.API_ERROR_CODES.IDEMPOTENCY_KEY_REUSED);
 			return saved.asset;
 		}
 		const asset = await run();
@@ -1122,28 +1251,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_CalmLensError.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_CalmLensError.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_CalmLensError.API_ERROR_CODES.DUPLICATE_EXTERNAL_ID);
 		}
 		const id = this.createId();
 		const now = this.now();
@@ -1181,20 +1310,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_CalmLensError.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_CalmLensError.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
@@ -1231,7 +1360,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;