@calmlens/sdk 0.10.1 → 0.12.0

package/esm/testing.d.ts

@@ -1,4 +1,4 @@
-import { A as ModerateTextOptions, B as UpdateFolderOptions, C as IterateAssetChildrenOptions, D as ListAssetChildrenOptions, G as AssetSearchQuery, I as RetrieveAssetOptions, J as PostAssetSignedUrlResponse, K as WebhookEventPayload, L as RetryAssetOptions, M as MoveFolderOptions, O as ListAssetsOptions, Q as TypedEvent, R as SubmitAssetOptions, T as Lens, V as UploadAssetPartOptions, X as Folder, Y as AssetBinaryPayloadInput, Z as Event, _ as DeleteAssetOptions, a as AssetSearchResponse, at as ClassificationCategory, b as FolderIdOptions, d as CdnAssetUrlOptions, f as CdnServeOptions, g as DeleteAssetContentOptions, i as AssetPage, j as MoveAssetOptions, k as ListEventsOptions, m as CreateFolderOptions, n as AssetChildrenPage, p as CreateAssetSignedUrlOptions, q as GetEventsResponse, s as AssetStatus, t as Asset, u as CalmLensClientOptions, v as EnsureLensOptions, w as IterateAssetsOptions, y as EnsureLensesOptions, z as UpdateAssetOptions } from "./CalmLensTypes-DjYFaTyh.js";
+import { $ as SearchAssetsOptions, A as DeleteAssetContentOptions, B as Lens, C as CdnAssetUrlOptions, D as CreateAssetSignedUrlOptions, G as ModerateTextOptions, H as ListAssetChildrenOptions, K as MoveAssetOptions, M as EnsureLensOptions, N as EnsureLensesOptions, O as CreateFolderOptions, P as FolderIdOptions, Q as RetryAssetOptions, R as IterateAssetChildrenOptions, S as CalmLensServerClientOptions, U as ListAssetsOptions, W as ListEventsOptions, Z as RetrieveAssetOptions, _t as TypedEvent, at as UpdateFolderOptions, d as Asset, et as SignUploadTokenOptions, ft as GetEventsResponse, g as AssetSearchResponse, h as AssetPage, ht as Event, it as UpdateAssetOptions, j as DeleteAssetOptions, kt as AssetBinaryPayloadInput, mt as Folder, ot as UploadAssetPartOptions, p as AssetChildrenPage, pt as PostAssetSignedUrlResponse, q as MoveFolderOptions, r as ClassificationCategory, rt as SubmitAssetOptions, t as WebhookEventPayload, tt as SignedUploadToken, v as AssetStatus, w as CdnServeOptions, z as IterateAssetsOptions } from "./WebhookPayload-Cgb32aSH.js";
 import * as zod from "zod";
 //#region ../shared/src/TestTriggers.d.ts
 type ClassificationTestSignal = ClassificationCategory | "sexual.involving-minors" | "violence.graphic";
@@ -34,6 +34,8 @@ declare const GRANT_SCHEMA: zod.ZodObject<{
     "project:manage": "project:manage";
     "settings:read": "settings:read";
     "settings:write": "settings:write";
+    "upload-presets:read": "upload-presets:read";
+    "upload-presets:write": "upload-presets:write";
   }>>;
   folderId: zod.ZodNullable<zod.ZodString>;
   includeSubfolders: zod.ZodBoolean;
@@ -102,8 +104,8 @@ export declare class InMemoryMockDatabaseStorage implements MockDatabaseStorage
   deleteFolder(folderId: string): Promise<void>;
 }
 //#endregion
-//#region src/testing/MockCalmLensClient.d.ts
-interface MockCalmLensClientOptions extends CalmLensClientOptions {
+//#region src/testing/MockCalmLensServerClient.d.ts
+interface MockCalmLensServerClientOptions extends CalmLensServerClientOptions {
   mockOptions?: {
     databaseStorage?: MockDatabaseStorage;
     imageStorage?: MockImageStorage;
@@ -116,13 +118,44 @@ interface MockCalmLensClientOptions extends CalmLensClientOptions {
     signedUrlBaseUrl?: string;
   };
 }
-/** A `MockCalmLensClient` method, named like its path on the client. */
-type MockCalmLensOperation = "assets.list" | "assets.search" | "assets.retrieve" | "assets.update" | "assets.listChildren" | "assets.create" | "assets.moderate" | "assets.uploadPart" | "assets.createSignedUrl" | "assets.move" | "assets.retry" | "assets.deleteContent" | "assets.delete" | "text.moderate" | "cdn.serve" | "events.list" | "folders.list" | "folders.retrieve" | "folders.create" | "folders.update" | "folders.delete" | "folders.move" | "ensureLens" | "ensureLenses";
-/** One recorded call: the method and the options object it was given, exactly as passed. */
-interface MockCalmLensCall {
-  operation: MockCalmLensOperation;
-  options: unknown;
+/** The options each `MockCalmLensServerClient` method was given, by operation name. */
+interface MockCalmLensOperationOptions {
+  "assets.list": ListAssetsOptions;
+  "assets.search": SearchAssetsOptions;
+  "assets.retrieve": RetrieveAssetOptions;
+  "assets.update": UpdateAssetOptions;
+  "assets.listChildren": ListAssetChildrenOptions;
+  "assets.create": SubmitAssetOptions;
+  "assets.moderate": SubmitAssetOptions;
+  "assets.uploadPart": UploadAssetPartOptions;
+  "assets.createSignedUrl": CreateAssetSignedUrlOptions;
+  "assets.move": MoveAssetOptions;
+  "assets.retry": RetryAssetOptions;
+  "assets.deleteContent": DeleteAssetContentOptions;
+  "assets.delete": DeleteAssetOptions;
+  "text.moderate": ModerateTextOptions;
+  "cdn.serve": CdnServeOptions;
+  "events.list": ListEventsOptions;
+  "folders.list": undefined;
+  "folders.retrieve": FolderIdOptions;
+  "folders.create": CreateFolderOptions;
+  "folders.update": UpdateFolderOptions;
+  "folders.delete": FolderIdOptions;
+  "folders.move": MoveFolderOptions;
+  ensureLens: EnsureLensOptions;
+  ensureLenses: EnsureLensesOptions;
+  "uploadTokens.sign": SignUploadTokenOptions;
 }
+/** A `MockCalmLensServerClient` method, named like its path on the client. */
+type MockCalmLensOperation = keyof MockCalmLensOperationOptions;
+/**
+ * One recorded call: the method and the options object it was given, exactly as passed. Narrow
+ * on `operation` (or use `callsTo`) to get its options type.
+ */
+type MockCalmLensCall<TOperation extends MockCalmLensOperation = MockCalmLensOperation> = { [Operation in TOperation]: {
+  operation: Operation;
+  options: MockCalmLensOperationOptions[Operation];
+}; }[TOperation];
 /**
  * What a simulated request failure throws: `"transport-error"` and `"timeout"` throw the same
  * `CalmLensError` the real client throws for a network failure (`sdk/transport-error`) or a
@@ -134,11 +167,11 @@ type MockEventInput = Partial<Omit<TypedEvent, "type">> & {
   type: TypedEvent["type"];
 };
 /**
- * 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.
  */
-export declare class MockCalmLensClient {
+export declare class MockCalmLensServerClient {
   readonly databaseStorage: MockDatabaseStorage;
   readonly imageStorage: MockImageStorage;
   private readonly createId;
@@ -149,6 +182,7 @@ export declare class MockCalmLensClient {
   private readonly signedUrlBaseUrl;
   private readonly cdnBaseUrl;
   private readonly projectId;
+  private readonly apiKey;
   private readonly lenses;
   private readonly eventFeed;
   /** The queue mode each open multipart upload was started with, as the API saves it. */
@@ -158,8 +192,8 @@ export declare class MockCalmLensClient {
   private readonly pendingFailures;
   /** Every call made through this client, oldest first. */
   readonly calls: MockCalmLensCall[];
-  /** Accepts the same options as `CalmLensClient` (validated the same way), plus `mockOptions`. */
-  constructor(options: MockCalmLensClientOptions);
+  /** Accepts the same options as `CalmLensServerClient` (validated the same way), plus `mockOptions`. */
+  constructor(options: MockCalmLensServerClientOptions);
   /**
    * 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.
@@ -168,7 +202,7 @@ export declare class MockCalmLensClient {
     operation?: MockCalmLensOperation;
   }): void;
   /** Calls recorded for one operation, oldest first. */
-  callsTo(operation: MockCalmLensOperation): MockCalmLensCall[];
+  callsTo<TOperation extends MockCalmLensOperation>(operation: TOperation): MockCalmLensCall<TOperation>[];
   /**
    * Adds an event to the feed `events.list` reads, as if CalmLens had recorded it. Returns the
    * stored event; pass it to `toWebhookEventPayload` to build a matching webhook body.
@@ -211,9 +245,7 @@ export declare class MockCalmLensClient {
      * description and tags, best match first. Mock scores are 1 for an exact match and 0.5
      * otherwise; `mode` is accepted but there is no semantic search.
      */
-    search: (options: Partial<AssetSearchQuery> & {
-      query: string;
-    }) => Promise<AssetSearchResponse>;
+    search: (options: SearchAssetsOptions) => Promise<AssetSearchResponse>;
     /** Lists assets with the real client's paging, `ordering`, `folderId` and `filter`. */
     list: (options?: ListAssetsOptions) => Promise<AssetPage>;
     iterate: (options?: IterateAssetsOptions) => AsyncGenerator<Asset, void, undefined>;
@@ -231,6 +263,10 @@ export declare class MockCalmLensClient {
     deleteContent: (options: DeleteAssetContentOptions) => Promise<Asset>;
     delete: (options: DeleteAssetOptions) => Promise<void>;
   };
+  /** Signs real upload tokens with the mock's API key, like the real client, without a request. */
+  get uploadTokens(): {
+    sign: (options: SignUploadTokenOptions) => Promise<SignedUploadToken>;
+  };
   get folders(): {
     list: () => Promise<Folder[]>;
     retrieve: (options: FolderIdOptions) => Promise<Folder>;
@@ -265,4 +301,4 @@ export declare const createWebhookHeaders: (options: {
   timestampSeconds?: number;
 }) => Promise<Record<string, string>>;
 //#endregion
-export type { MockCalmLensCall, MockCalmLensClientOptions, MockCalmLensOperation, MockDatabaseStorage, MockEventInput, MockImageStorage, MockRequestFailure, MockStoredContent };
+export type { MockCalmLensCall, MockCalmLensOperation, MockCalmLensOperationOptions, MockCalmLensServerClientOptions, MockDatabaseStorage, MockEventInput, MockImageStorage, MockRequestFailure, MockStoredContent };

package/esm/testing.js

@@ -1,4 +1,6 @@
-import { D as assetDataToUint8Array, E as stringifyJsonCanonical, O as assetToData, T as isRejectedUploadMimeType, _ as invalidArgument, b as API_ERROR_DEFINITIONS, c as appendCdnSelector, d as toTextAssetOptions, f as validateClientOptions, g as SDK_ERROR_CODES, h as CalmLensError, i as WEBHOOK_TIMESTAMP_HEADER, j as validateAssetPayload, k as getAssetPayloadByteLength, l as encodePathSegment, n as WEBHOOK_SIGNATURE_HEADER, s as hmacSha256Hex, t as WEBHOOK_DELIVERY_HEADER, w as getRejectedUploadMimeTypeError, y as API_ERROR_CODES } from "./CalmLensWebhooks-DLUozliX.js";
+import { i as invalidArgument, n as CalmLensError, o as API_ERROR_CODES, r as SDK_ERROR_CODES, s as API_ERROR_DEFINITIONS } from "./CalmLensError-CihGG26K.js";
+import { c as hmacSha256Hex, i as WEBHOOK_TIMESTAMP_HEADER, l as stringifyJsonCanonical, n as WEBHOOK_SIGNATURE_HEADER, s as signUploadTokenWithApiKey, t as WEBHOOK_DELIVERY_HEADER } from "./CalmLensWebhooks-DShmAal4.js";
+import { _ as getRejectedUploadMimeTypeError, a as toTextAssetOptions, d as assetToData, f as getAssetPayloadByteLength, l as validateServerClientOptions, n as encodePathSegment, o as transformSelector, p as validateAssetPayload, t as appendCdnSelector, u as assetDataToUint8Array, v as isRejectedUploadMimeType } from "./CalmLensUtils-Cx32j2zt.js";
 import * as zod from "zod";
 import "zod/v4";
 //#region ../shared/src/ModerationCategoryDefinitions.ts
@@ -88,6 +90,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 {
@@ -96,7 +99,117 @@ const createMetaType = (type) => {
 		};
 	}, type);
 };
-createMetaType({ id: "docPropertyInfo" });
+const metaStore = (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([docPropertyInfo({ description: "Whether to run the feature. Every feature is off unless this is true." })]));
+	return {
+		ocr: zod.object({ enabled }).strict().meta(metaStore([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([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([docPropertyInfo({
+				description: "Also estimate an age range for each face",
+				defaultValue: false
+			})]))
+		}).strict().meta(metaStore([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([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([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([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([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([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([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 = {
@@ -209,7 +322,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
@@ -264,6 +378,8 @@ const ACTION_SCHEMA = zod.enum([
 	"metadata:write",
 	"lenses:read",
 	"lenses:write",
+	"upload-presets:read",
+	"upload-presets:write",
 	"project:manage"
 ]);
 const PROJECT_ACTIONS = [...[
@@ -272,7 +388,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. */
@@ -475,7 +592,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) => invalidArgument(`MockCalmLensClient cannot evaluate the filter "${expression}". It supports ==, !=, <, <=, >, >=, =in= and =out=, joined by ; (and) or , (or), without grouping parentheses.`);
+const unsupportedFilter = (expression) => 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);
@@ -532,7 +649,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) => {
@@ -558,12 +675,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 = [];
@@ -572,8 +689,9 @@ var MockCalmLensClient = class {
 		this.requestCount = 0;
 		this.pendingFailures = [];
 		this.calls = [];
-		validateClientOptions(options);
+		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);
@@ -586,7 +704,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,
@@ -912,7 +1030,8 @@ var MockCalmLensClient = class {
 				if (options.lens && options.transform) throw 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 = 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
@@ -961,6 +1080,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 signUploadTokenWithApiKey(this.apiKey, options, {
+				now: this.now(),
+				nonce: this.createId()
+			});
+		} };
+	}
 	get folders() {
 		return {
 			list: async () => {
@@ -1203,4 +1332,4 @@ const createWebhookHeaders = async (options) => {
 	};
 };
 //#endregion
-export { InMemoryMockDatabaseStorage, InMemoryMockImageStorage, MEDIA_TEST_SIGNALS, MOCK_API_KEY_PREFIX, MockCalmLensClient, createMockApiKey, createWebhookHeaders, createWebhookSignatureHeader, generateMediaTestCode, toWebhookEventPayload };
+export { InMemoryMockDatabaseStorage, InMemoryMockImageStorage, MEDIA_TEST_SIGNALS, MOCK_API_KEY_PREFIX, MockCalmLensServerClient, createMockApiKey, createWebhookHeaders, createWebhookSignatureHeader, generateMediaTestCode, toWebhookEventPayload };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calmlens/sdk",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "Official CalmLens SDK for JavaScript and TypeScript: content moderation, asset storage and CDN delivery.",
   "license": "MIT",
   "homepage": "https://calmlens.com/docs/sdk/javascript",
@@ -72,6 +72,28 @@
       },
       "default": "./esm/index.js"
     },
+    "./server": {
+      "import": {
+        "types": "./esm/server.d.ts",
+        "default": "./esm/server.js"
+      },
+      "require": {
+        "types": "./cjs/server.d.ts",
+        "default": "./cjs/server.js"
+      },
+      "default": "./esm/server.js"
+    },
+    "./app": {
+      "import": {
+        "types": "./esm/app.d.ts",
+        "default": "./esm/app.js"
+      },
+      "require": {
+        "types": "./cjs/app.d.ts",
+        "default": "./cjs/app.js"
+      },
+      "default": "./esm/app.js"
+    },
     "./testing": {
       "import": {
         "types": "./esm/testing.d.ts",