@calmlens/sdk 0.12.0 → 0.14.0

package/esm/testing.js

@@ -1,6 +1,6 @@
-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 { c as invalidArgument, d as API_ERROR_DEFINITIONS, o as CalmLensError, s as SDK_ERROR_CODES, u as API_ERROR_CODES } from "./CalmLensVersion-DPnL_Ebv.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-CWlD-f_P.js";
+import { b as getRejectedUploadMimeTypeError, f as sleep, g as validateAssetPayload, h as getAssetPayloadByteLength, m as assetToData, n as encodePathSegment, o as toTextAssetOptions, p as assetDataToUint8Array, r as pollForDecision, s as transformSelector, t as appendCdnSelector, u as validateServerClientOptions, x as isRejectedUploadMimeType } from "./CalmLensUtils-BQo79TA1.js";
 import * as zod from "zod";
 import "zod/v4";
 //#region ../shared/src/ModerationCategoryDefinitions.ts
@@ -36,58 +36,63 @@ 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__";
@@ -252,7 +257,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),
@@ -302,7 +311,6 @@ const CLASSIFICATION_LABEL_SCHEMA = zod.object({
 zod.object({
 	processedAt: zod.number(),
 	categories: CATEGORIES_SCHEMA,
-	flagged: zod.boolean(),
 	score: zod.number(),
 	notes: saneStringField().nullish(),
 	media: zod.object({
@@ -380,6 +388,8 @@ const ACTION_SCHEMA = zod.enum([
 	"lenses:write",
 	"upload-presets:read",
 	"upload-presets:write",
+	"reviews:read",
+	"reviews:write",
 	"project:manage"
 ]);
 const PROJECT_ACTIONS = [...[
@@ -389,7 +399,8 @@ const PROJECT_ACTIONS = [...[
 	"connectors",
 	"metadata",
 	"lenses",
-	"upload-presets"
+	"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. */
@@ -402,7 +413,7 @@ const GRANT_SCHEMA = zod.object({
 const GRANTS_SCHEMA = zod.array(GRANT_SCHEMA).max(100);
 zod.enum([
 	"admin",
-	"member",
+	"editor",
 	"viewer",
 	"custom"
 ]);
@@ -696,8 +707,8 @@ var MockCalmLensServerClient = class {
 		this.imageStorage = options.mockOptions?.imageStorage ?? new InMemoryMockImageStorage();
 		this.createId = options.mockOptions?.createId ?? crypto.randomUUID.bind(crypto);
 		this.now = options.mockOptions?.now ?? Date.now;
-		this.queuedStatus = options.mockOptions?.queuedStatus ?? "pending";
-		this.analyzedStatus = options.mockOptions?.analyzedStatus ?? "approved";
+		this.queuedOutcome = options.mockOptions?.queuedOutcome ?? "pending";
+		this.analyzedOutcome = options.mockOptions?.analyzedOutcome ?? "approved";
 		this.apiKeyGrants = getMockApiKeyGrants(options.apiKey);
 		this.signedUrlBaseUrl = options.mockOptions?.signedUrlBaseUrl ?? "mock://calmlens";
 		this.cdnBaseUrl = (options.cdnBaseUrl ?? "mock://calmlens/v1").replace(/\/+$/, "");
@@ -1009,18 +1020,22 @@ var MockCalmLensServerClient = class {
 						isFinal: part.isFinal
 					});
 					if (!validation.ok) throw this.invalidPayload(validation.error);
-					if (asset.status !== "uploading") throw this.apiError(API_ERROR_CODES.UPLOAD_NOT_OPEN);
-					const expectedPartNumber = (asset.uploadPartsReceived ?? 1) + 1;
+					if (asset.processing.status !== "uploading") throw this.apiError(API_ERROR_CODES.UPLOAD_NOT_OPEN);
+					const expectedPartNumber = (asset.processing.uploadPartsReceived ?? 1) + 1;
 					if (part.partNumber !== expectedPartNumber) throw this.apiError(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);
-					return this.databaseStorage.updateAsset({
+					const now = this.now();
+					const received = {
 						...asset,
-						status: part.isFinal ? queue ? this.queuedStatus : this.analyzedStatus : "uploading",
-						uploadPartsReceived: part.partNumber,
-						updatedAt: this.now()
-					});
+						processing: {
+							...asset.processing,
+							uploadPartsReceived: part.partNumber
+						},
+						updatedAt: now
+					};
+					return this.databaseStorage.updateAsset(part.isFinal ? await this.applyOutcome(received, queue ? this.queuedOutcome : this.analyzedOutcome) : received);
 				});
 			},
 			createSignedUrl: async (signedUrlOptions) => {
@@ -1053,23 +1068,31 @@ var MockCalmLensServerClient = class {
 			retry: async (options) => {
 				this.begin("assets.retry", options);
 				const asset = await this.findOwnAsset(options?.assetId);
-				if (asset.status !== "error") throw this.apiError(API_ERROR_CODES.ASSET_NOT_RETRYABLE);
-				if (asset.storageDeletedAt) throw this.apiError(API_ERROR_CODES.ASSET_CONTENT_UNAVAILABLE);
-				return this.databaseStorage.updateAsset({
-					...asset,
-					status: "pending",
-					updatedAt: this.now()
-				});
+				if (asset.processing.status !== "failed") throw this.apiError(API_ERROR_CODES.ASSET_NOT_RETRYABLE);
+				if (asset.content.status === "removed") throw this.apiError(API_ERROR_CODES.ASSET_CONTENT_UNAVAILABLE);
+				return this.databaseStorage.updateAsset(await this.applyOutcome(asset, "pending"));
+			},
+			/** 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 pollForDecision(() => this.findOwnAsset(assetId), waitOptions, sleep);
 			},
 			deleteContent: async (options) => {
 				this.begin("assets.deleteContent", options);
 				const asset = await this.findOwnAsset(options?.assetId);
 				await this.imageStorage.deleteContent(asset.id);
+				const now = this.now();
 				return this.databaseStorage.updateAsset({
 					...asset,
-					extractedText: null,
-					storageDeletedAt: asset.storageDeletedAt ?? this.now(),
-					updatedAt: this.now()
+					content: asset.content.status === "removed" ? asset.content : {
+						...asset.content,
+						status: "removed",
+						removalReason: "requested",
+						updatedAt: now,
+						extractedText: null
+					},
+					updatedAt: now
 				});
 			},
 			delete: async (options) => {
@@ -1253,6 +1276,7 @@ var MockCalmLensServerClient = class {
 		const id = this.createId();
 		const now = this.now();
 		const isOpenUpload = "part" in options && !options.part.isFinal;
+		const keepContent = options.processingOptions?.keepContentAfterProcessing === true;
 		const asset = {
 			id,
 			projectId: this.projectId,
@@ -1265,11 +1289,37 @@ var MockCalmLensServerClient = class {
 			externalUrl: "url" in options ? options.url : "content" in options ? options.externalUrl : void 0,
 			type: inferAssetType(options),
 			metadata: options.metadata,
-			status: isOpenUpload ? "uploading" : queue ? this.queuedStatus : this.analyzedStatus,
 			processingOptions: options.processingOptions,
 			visibility: options.visibility ?? "private",
-			sizeInBytes: this.getSizeInBytes(options),
-			uploadPartsReceived: "part" in options ? options.part.partNumber ?? 1 : void 0
+			processing: {
+				status: isOpenUpload ? "uploading" : "processing",
+				updatedAt: now,
+				uploadPartsReceived: "part" in options ? options.part.partNumber ?? 1 : null
+			},
+			moderation: {
+				status: "pending",
+				action: null,
+				note: null,
+				reviewerAction: null,
+				reviewerNote: null,
+				reviewerUserId: null,
+				reviewedAt: null,
+				decidedAt: null,
+				report: null
+			},
+			content: {
+				status: keepContent ? "stored" : "temporary",
+				removalReason: null,
+				updatedAt: now,
+				safetyHold: null,
+				format: this.getContentFormat(options),
+				extension: null,
+				sizeInBytes: this.getSizeInBytes(options) ?? null,
+				checksums: null,
+				image: null,
+				previewImage: null,
+				extractedText: null
+			}
 		};
 		if ("content" in options) {
 			if (!("plainText" in options.content)) await this.imageStorage.putContent(id, options.content);
@@ -1277,7 +1327,39 @@ var MockCalmLensServerClient = class {
 			await this.imageStorage.putPart(id, options.part);
 			if (isOpenUpload) this.uploadQueues.set(id, queue);
 		}
-		return this.databaseStorage.createAsset(asset);
+		return this.databaseStorage.createAsset(isOpenUpload ? asset : await this.applyOutcome(asset, queue ? this.queuedOutcome : this.analyzedOutcome));
+	}
+	/**
+	* Moves an asset to `outcome` like the pipeline would: a decision finishes processing, and
+	* finished processing removes content kept only temporarily (`keepContentAfterProcessing` off).
+	*/
+	async applyOutcome(asset, outcome) {
+		const now = this.now();
+		const decided = outcome === "approved" || outcome === "rejected";
+		const processingStatus = decided ? "done" : outcome === "failed" ? "failed" : "processing";
+		const removeContent = processingStatus === "done" && asset.content.status === "temporary";
+		if (removeContent) await this.imageStorage.deleteContent(asset.id);
+		return {
+			...asset,
+			updatedAt: now,
+			processing: {
+				...asset.processing,
+				status: processingStatus,
+				updatedAt: now
+			},
+			moderation: {
+				...asset.moderation,
+				status: decided ? outcome : "pending",
+				decidedAt: decided ? now : null
+			},
+			content: removeContent ? {
+				...asset.content,
+				status: "removed",
+				removalReason: "retention",
+				updatedAt: now,
+				extractedText: null
+			} : asset.content
+		};
 	}
 	async resolveFolder(folderId) {
 		if (!this.databaseStorage.getFolder) return void 0;
@@ -1294,6 +1376,11 @@ var MockCalmLensServerClient = class {
 	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(API_ERROR_CODES.DUPLICATE_FOLDER_NAME, { message: `A folder named "${name}" already exists in this location.` });
 	}
+	getContentFormat(options) {
+		if ("content" in options) return options.content.type;
+		if ("part" in options) return options.part.type;
+		return null;
+	}
 	getSizeInBytes(options) {
 		if ("content" in options) {
 			if ("plainText" in options.content) return new TextEncoder().encode(options.content.plainText).byteLength;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calmlens/sdk",
-  "version": "0.12.0",
+  "version": "0.14.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",