@calmlens/sdk 0.8.0 → 0.9.0

package/cjs/{CalmLensTypes-B7hr0SBv.d.ts → CalmLensTypes-CZqyni4p.d.ts}

@@ -3542,6 +3542,12 @@ interface RetrieveAssetOptions {
 interface RetryAssetOptions {
   assetId: string;
 }
+interface DeleteAssetOptions {
+  assetId: string;
+}
+interface DeleteAssetContentOptions {
+  assetId: string;
+}
 type UpdateAssetOptions = PatchAssetBody & {
   assetId: string;
 };
@@ -3624,4 +3630,4 @@ interface ModerateTextOptions extends Omit<SubmitAssetCommonOptions, "name" | "v
   name?: string;
 }
 //#endregion
-export { GetEventsResponse as A, EventFactValues as B, UpdateAssetOptions as C, GetAssetChildrenResponse as D, VerifyWebhookSignatureOptions as E, Folder as F, AssetStatus as G, EventSeverity as H, Event as I, MetadataItem as J, AssetType as K, TypedEvent as L, RequestErrorCode as M, AssetBinaryPayloadInput as N, GetAssetResponse as O, Lens as P, EventCategory as R, SubmitAssetOptions as S, UploadAssetPartOptions as T, EventType as U, EventFacts as V, Asset as W, ProcessingOptions as Y, MultipartUploadOptions as _, CreateAssetSignedUrlOptions as a, RetrieveAssetOptions as b, EnsureLensOptions as c, ListAssetChildrenOptions as d, ListAssetsOptions as f, MoveFolderOptions as g, MoveAssetOptions as h, CdnServeOptions as i, PostAssetSignedUrlResponse as j, GetAssetsPageResponse as k, EnsureLensesOptions as l, ModerateTextOptions as m, CalmLensClientOptions as n, CreateFolderOptions as o, ListEventsOptions as p, AssetVisibility as q, CdnAssetUrlOptions as r, CreateMultipartUploadPartOptions as s, AssetContentOptions as t, FolderIdOptions as u, MultipartUploadPartOptions as v, UpdateFolderOptions as w, RetryAssetOptions as x, RequestOptions as y, EventFact as z };
+export { GetAssetResponse as A, EventCategory as B, RetryAssetOptions as C, UploadAssetPartOptions as D, UpdateFolderOptions as E, AssetBinaryPayloadInput as F, EventType as G, EventFactValues as H, Lens as I, AssetType as J, Asset as K, Folder as L, GetEventsResponse as M, PostAssetSignedUrlResponse as N, VerifyWebhookSignatureOptions as O, RequestErrorCode as P, Event as R, RetrieveAssetOptions as S, UpdateAssetOptions as T, EventFacts as U, EventFact as V, EventSeverity as W, MetadataItem as X, AssetVisibility as Y, ProcessingOptions as Z, MoveAssetOptions as _, CreateAssetSignedUrlOptions as a, MultipartUploadPartOptions as b, DeleteAssetContentOptions as c, EnsureLensesOptions as d, FolderIdOptions as f, ModerateTextOptions as g, ListEventsOptions as h, CdnServeOptions as i, GetAssetsPageResponse as j, GetAssetChildrenResponse as k, DeleteAssetOptions as l, ListAssetsOptions as m, CalmLensClientOptions as n, CreateFolderOptions as o, ListAssetChildrenOptions as p, AssetStatus as q, CdnAssetUrlOptions as r, CreateMultipartUploadPartOptions as s, AssetContentOptions as t, EnsureLensOptions as u, MoveFolderOptions as v, SubmitAssetOptions as w, RequestOptions as x, MultipartUploadOptions as y, TypedEvent as z };

package/cjs/{CalmLensUtils-CJ6o7KRU.js → CalmLensUtils-CArkVfj0.js}

@@ -434,6 +434,7 @@ const validateClientOptions = (options) => {
 	if (!options || typeof options !== "object") throw invalidOptions("Client options are required");
 	if (!options.apiKey) throw invalidOptions("API key is required");
 	if (!options.projectId) throw invalidOptions("Project ID is required");
+	encodePathSegment(options.projectId, "Project ID");
 	if (options.timeoutMs !== void 0 && (!Number.isSafeInteger(options.timeoutMs) || options.timeoutMs <= 0)) throw invalidOptions("timeoutMs must be a positive integer");
 	assertHttpUrl("baseUrl", options.baseUrl);
 	assertHttpUrl("cdnBaseUrl", options.cdnBaseUrl);
@@ -449,6 +450,46 @@ const toTextAssetOptions = (_ref) => {
 		}
 	});
 };
+/**
+* Encodes an identifier as one URL path segment. `.` and `..` are rejected because URL
+* resolution would treat them as relative segments and send the request to another route.
+*/
+const encodePathSegment = (value, name) => {
+	if (typeof value !== "string" || !value) throw invalidOptions(`${name} is required`);
+	if (value === "." || value === "..") throw invalidOptions(`${name} cannot be "." or ".."`);
+	return encodeURIComponent(value);
+};
+/** Appends a CDN lens (`/@name`) or direct transform selector to an asset URL. */
+const appendCdnSelector = (url, options) => {
+	if (options.lens && options.transform) throw invalidOptions("Specify either a lens or a transform, not both");
+	if (options.lens) return `${url}/@${encodePathSegment(options.lens, "Lens")}`;
+	if (!options.transform) return url;
+	const transform = options.transform.replace(/^\/+/, "");
+	if (transform.includes("..") || transform.includes("?") || transform.includes("#")) throw invalidOptions("Transform cannot contain \"..\", \"?\" or \"#\"");
+	return `${url}/${encodeURI(transform)}`;
+};
+const appendQueryValue = (parts, key, value) => {
+	if (value === void 0 || value === null) return;
+	if (Array.isArray(value)) {
+		for (const [index, item] of value.entries()) appendQueryValue(parts, `${key}[${index}]`, item);
+		return;
+	}
+	if (typeof value === "object") {
+		for (const [field, item] of Object.entries(value)) appendQueryValue(parts, `${key}[${field}]`, item);
+		return;
+	}
+	parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+};
+/**
+* Serialises a query object the way the API parses it (qs bracket notation), for example
+* `ordering[0][field]=createdAt&ordering[0][direction]=DESC`. Every key and value is
+* percent-encoded and missing values are omitted.
+*/
+const stringifyQuery = (query) => {
+	const parts = [];
+	for (const [key, value] of Object.entries(query)) appendQueryValue(parts, key, value);
+	return parts.join("&");
+};
 //#endregion
 Object.defineProperty(exports, "CalmLensError", {
 	enumerable: true,
@@ -510,6 +551,12 @@ Object.defineProperty(exports, "_objectWithoutProperties", {
 		return _objectWithoutProperties;
 	}
 });
+Object.defineProperty(exports, "appendCdnSelector", {
+	enumerable: true,
+	get: function() {
+		return appendCdnSelector;
+	}
+});
 Object.defineProperty(exports, "assetDataToUint8Array", {
 	enumerable: true,
 	get: function() {
@@ -528,6 +575,12 @@ Object.defineProperty(exports, "calmLensError", {
 		return calmLensError;
 	}
 });
+Object.defineProperty(exports, "encodePathSegment", {
+	enumerable: true,
+	get: function() {
+		return encodePathSegment;
+	}
+});
 Object.defineProperty(exports, "getAssetPayloadByteLength", {
 	enumerable: true,
 	get: function() {
@@ -558,6 +611,12 @@ Object.defineProperty(exports, "stringifyJsonCanonical", {
 		return stringifyJsonCanonical;
 	}
 });
+Object.defineProperty(exports, "stringifyQuery", {
+	enumerable: true,
+	get: function() {
+		return stringifyQuery;
+	}
+});
 Object.defineProperty(exports, "toTextAssetOptions", {
 	enumerable: true,
 	get: function() {

package/cjs/index.d.ts

@@ -1,4 +1,4 @@
-import { A as GetEventsResponse, B as EventFactValues, C as UpdateAssetOptions, D as GetAssetChildrenResponse, E as VerifyWebhookSignatureOptions, F as Folder, G as AssetStatus, H as EventSeverity, I as Event, J as MetadataItem, K as AssetType, L as TypedEvent, M as RequestErrorCode, O as GetAssetResponse, P as Lens, R as EventCategory, S as SubmitAssetOptions, T as UploadAssetPartOptions, U as EventType, V as EventFacts, W as Asset, Y as ProcessingOptions, _ as MultipartUploadOptions, a as CreateAssetSignedUrlOptions, b as RetrieveAssetOptions, c as EnsureLensOptions, d as ListAssetChildrenOptions, f as ListAssetsOptions, g as MoveFolderOptions, h as MoveAssetOptions, i as CdnServeOptions, j as PostAssetSignedUrlResponse, k as GetAssetsPageResponse, l as EnsureLensesOptions, m as ModerateTextOptions, n as CalmLensClientOptions, o as CreateFolderOptions, p as ListEventsOptions, q as AssetVisibility, r as CdnAssetUrlOptions, s as CreateMultipartUploadPartOptions, t as AssetContentOptions, u as FolderIdOptions, v as MultipartUploadPartOptions, w as UpdateFolderOptions, x as RetryAssetOptions, y as RequestOptions, z as EventFact } from "./CalmLensTypes-B7hr0SBv.js";
+import { A as GetAssetResponse, B as EventCategory, C as RetryAssetOptions, D as UploadAssetPartOptions, E as UpdateFolderOptions, G as EventType, H as EventFactValues, I as Lens, J as AssetType, K as Asset, L as Folder, M as GetEventsResponse, N as PostAssetSignedUrlResponse, O as VerifyWebhookSignatureOptions, P as RequestErrorCode, R as Event, S as RetrieveAssetOptions, T as UpdateAssetOptions, U as EventFacts, V as EventFact, W as EventSeverity, X as MetadataItem, Y as AssetVisibility, Z as ProcessingOptions, _ as MoveAssetOptions, a as CreateAssetSignedUrlOptions, b as MultipartUploadPartOptions, c as DeleteAssetContentOptions, d as EnsureLensesOptions, f as FolderIdOptions, g as ModerateTextOptions, h as ListEventsOptions, i as CdnServeOptions, j as GetAssetsPageResponse, k as GetAssetChildrenResponse, l as DeleteAssetOptions, m as ListAssetsOptions, n as CalmLensClientOptions, o as CreateFolderOptions, p as ListAssetChildrenOptions, q as AssetStatus, r as CdnAssetUrlOptions, s as CreateMultipartUploadPartOptions, t as AssetContentOptions, u as EnsureLensOptions, v as MoveFolderOptions, w as SubmitAssetOptions, x as RequestOptions, y as MultipartUploadOptions, z as TypedEvent } from "./CalmLensTypes-CZqyni4p.js";
 import * as zod from "zod";
 //#region ../shared/src/AssetSearch.d.ts
 declare const ASSET_SEARCH_QUERY_SCHEMA: zod.ZodObject<{
@@ -7501,7 +7501,7 @@ declare class CalmLensClient {
      * @param options - Pagination and filtering options
      * @returns Promise with paginated assets
      */
-    list: (options: ListAssetsOptions) => Promise<GetAssetsPageResponse>;
+    list: (options?: ListAssetsOptions) => Promise<GetAssetsPageResponse>;
     /**
      * Retrieve a specific asset by ID
      * @param assetId - The asset ID
@@ -7515,7 +7515,7 @@ declare class CalmLensClient {
      * @param options - Pagination options
      * @returns Promise with paginated child assets
      */
-    listChildren: ({ assetId, ...options }: ListAssetChildrenOptions) => Promise<GetAssetChildrenResponse>;
+    listChildren: ({ assetId, ...options }?: ListAssetChildrenOptions) => Promise<GetAssetChildrenResponse>;
     /**
      * Submit a new asset for processing (queued asynchronously)
      * The asset will be queued for classification and returned immediately.
@@ -7550,6 +7550,14 @@ declare class CalmLensClient {
      * moderated like a new upload; its content must still be stored.
      */
     retry: ({ assetId }: RetryAssetOptions) => Promise<Asset>;
+    /**
+     * Removes an asset's stored content (source, preview and retained extracted text) while
+     * keeping the asset record, metadata and moderation report. The returned asset has
+     * `storageDeletedAt` set; the CDN no longer serves it.
+     */
+    deleteContent: ({ assetId }: DeleteAssetContentOptions) => Promise<Asset>;
+    /** Deletes an asset record together with its stored content. */
+    delete: ({ assetId }: DeleteAssetOptions) => Promise<void>;
   };
   get events(): {
     /**
@@ -7620,4 +7628,4 @@ export declare const createWebhookHeaders: (options: {
  */
 export declare function verifyWebhookSignature({ payload, signature, timestamp, secret, toleranceSeconds, now }: VerifyWebhookSignatureOptions): Promise<boolean>;
 //#endregion
-export { type Asset, type GetAssetChildrenResponse as AssetChildrenPage, type AssetContentOptions, type GetAssetsPageResponse as AssetPage, type AssetSearchQuery, type AssetSearchResponse, type AssetSearchResult, type AssetStatus, type AssetType, type AssetVisibility, CalmLensClient, type CalmLensClientOptions, type CalmLensErrorDetails, type CdnAssetUrlOptions, type CdnServeOptions, type ClassificationCategoryReport, type ClassificationReport, type CreateAssetSignedUrlOptions, type CreateFolderOptions, type CreateMultipartUploadPartOptions, type EnsureLensOptions, type EnsureLensesOptions, type EventCategory, type EventFact, type EventFactValues, type EventFacts, type EventSeverity, type EventType, type GetEventsResponse as EventsPage, type Folder, type FolderIdOptions, type Lens, type ListAssetChildrenOptions, type ListAssetsOptions, type ListEventsOptions, type MetadataItem, type ModerateTextOptions, type MoveAssetOptions, type MoveFolderOptions, type MultipartUploadOptions, type MultipartUploadPartOptions, type ProcessingOptions, type RequestOptions, type RetrieveAssetOptions, type RetryAssetOptions, type SubmitAssetOptions, type TypedEvent, type UpdateAssetOptions, type UpdateFolderOptions, type UploadAssetPartOptions, type VerifyWebhookSignatureOptions, type WebhookEventPayload };
+export { type Asset, type GetAssetChildrenResponse as AssetChildrenPage, type AssetContentOptions, type GetAssetsPageResponse as AssetPage, type AssetSearchQuery, type AssetSearchResponse, type AssetSearchResult, type AssetStatus, type AssetType, type AssetVisibility, CalmLensClient, type CalmLensClientOptions, type CalmLensErrorDetails, type CdnAssetUrlOptions, type CdnServeOptions, type ClassificationCategoryReport, type ClassificationReport, type CreateAssetSignedUrlOptions, type CreateFolderOptions, type CreateMultipartUploadPartOptions, type DeleteAssetContentOptions, type DeleteAssetOptions, type EnsureLensOptions, type EnsureLensesOptions, type EventCategory, type EventFact, type EventFactValues, type EventFacts, type EventSeverity, type EventType, type GetEventsResponse as EventsPage, type Folder, type FolderIdOptions, type Lens, type ListAssetChildrenOptions, type ListAssetsOptions, type ListEventsOptions, type MetadataItem, type ModerateTextOptions, type MoveAssetOptions, type MoveFolderOptions, type MultipartUploadOptions, type MultipartUploadPartOptions, type ProcessingOptions, type RequestOptions, type RetrieveAssetOptions, type RetryAssetOptions, type SubmitAssetOptions, type TypedEvent, type UpdateAssetOptions, type UpdateFolderOptions, type UploadAssetPartOptions, type VerifyWebhookSignatureOptions, type WebhookEventPayload };

package/cjs/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_CalmLensUtils = require("./CalmLensUtils-CJ6o7KRU.js");
+const require_CalmLensUtils = require("./CalmLensUtils-CArkVfj0.js");
 let zod = require("zod");
 zod = require_CalmLensUtils.__toESM(zod);
 require("zod/v4");
@@ -244,6 +244,42 @@ function generateMediaTestCode(signal, projectId) {
 	return `Calm Lens test ${[...suffix].map((character) => HEX_WORDS[Number.parseInt(character, 16)]).join(" ")} ${signal.replace(/[.-]/g, " ")} end test`;
 }
 //#endregion
+//#region ../shared/src/CryptoUtils.ts
+const encoder = new TextEncoder();
+/** Lowercase hex of `bytes`, two characters per byte. */
+const bytesToHex = (bytes) => Array.from(bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes), (byte) => byte.toString(16).padStart(2, "0")).join("");
+(function() {
+	var _ref = require_CalmLensUtils._asyncToGenerator(function* (value) {
+		return bytesToHex(yield crypto.subtle.digest("SHA-256", encoder.encode(value)));
+	});
+	return function sha256Hex(_x) {
+		return _ref.apply(this, arguments);
+	};
+})();
+/** HMAC-SHA256 of `message` keyed with `secret` (both UTF-8 encoded), as lowercase hex. */
+const hmacSha256Hex = function() {
+	var _ref2 = require_CalmLensUtils._asyncToGenerator(function* (secret, message) {
+		const key = yield crypto.subtle.importKey("raw", encoder.encode(secret), {
+			name: "HMAC",
+			hash: "SHA-256"
+		}, false, ["sign"]);
+		return bytesToHex(yield crypto.subtle.sign("HMAC", key, encoder.encode(message)));
+	});
+	return function hmacSha256Hex(_x2, _x3) {
+		return _ref2.apply(this, arguments);
+	};
+}();
+/**
+* Compares two strings without leaking, through timing, where they first differ. Strings of
+* different lengths are unequal immediately (the length itself is not secret here).
+*/
+const timingSafeEqual = (a, b) => {
+	if (a.length !== b.length) return false;
+	let difference = 0;
+	for (let index = 0; index < a.length; index++) difference |= a.charCodeAt(index) ^ b.charCodeAt(index);
+	return difference === 0;
+};
+//#endregion
 //#region src/client/CalmLensWebhooks.ts
 const WEBHOOK_DELIVERY_HEADER = "x-calmlens-delivery";
 const WEBHOOK_TIMESTAMP_HEADER = "x-calmlens-timestamp";
@@ -268,39 +304,18 @@ const toWebhookEventPayload = (event) => {
 		}
 	};
 };
-const encoder = new TextEncoder();
-const hmacSha256Hex = function() {
-	var _ref = require_CalmLensUtils._asyncToGenerator(function* (secret, message) {
-		const key = yield crypto.subtle.importKey("raw", encoder.encode(secret), {
-			name: "HMAC",
-			hash: "SHA-256"
-		}, false, ["sign"]);
-		const signature = yield crypto.subtle.sign("HMAC", key, encoder.encode(message));
-		return Array.from(new Uint8Array(signature), (byte) => byte.toString(16).padStart(2, "0")).join("");
-	});
-	return function hmacSha256Hex(_x, _x2) {
-		return _ref.apply(this, arguments);
-	};
-}();
-/** Constant-time comparison of two strings of the same length. */
-const timingSafeEqual = (a, b) => {
-	if (a.length !== b.length) return false;
-	let diff = 0;
-	for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
-	return diff === 0;
-};
 /** `v1=<hex HMAC-SHA256 of "<timestamp>.<body>">`, the `x-calmlens-signature` header value. */
 const createWebhookSignatureHeader = function() {
-	var _ref2 = require_CalmLensUtils._asyncToGenerator(function* (secret, timestamp, body) {
+	var _ref = require_CalmLensUtils._asyncToGenerator(function* (secret, timestamp, body) {
 		return `v1=${yield hmacSha256Hex(secret, `${timestamp}.${body}`)}`;
 	});
-	return function createWebhookSignatureHeader(_x3, _x4, _x5) {
-		return _ref2.apply(this, arguments);
+	return function createWebhookSignatureHeader(_x, _x2, _x3) {
+		return _ref.apply(this, arguments);
 	};
 }();
 /** Headers for one signed delivery of `body`. */
 const createWebhookHeaders = function() {
-	var _ref3 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+	var _ref2 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 		var _options$timestampSec;
 		const timestamp = (_options$timestampSec = options.timestampSeconds) !== null && _options$timestampSec !== void 0 ? _options$timestampSec : Math.floor(Date.now() / 1e3);
 		return {
@@ -310,8 +325,8 @@ const createWebhookHeaders = function() {
 			[WEBHOOK_SIGNATURE_HEADER]: yield createWebhookSignatureHeader(options.secret, timestamp, options.body)
 		};
 	});
-	return function createWebhookHeaders(_x6) {
-		return _ref3.apply(this, arguments);
+	return function createWebhookHeaders(_x4) {
+		return _ref2.apply(this, arguments);
 	};
 }();
 /**
@@ -319,7 +334,7 @@ const createWebhookHeaders = function() {
 * `"<x-calmlens-timestamp>.<raw body>"`, and the timestamp must be within `toleranceSeconds`
 * (default 300) of now. Returns `false` for anything missing or malformed.
 */
-function verifyWebhookSignature(_x7) {
+function verifyWebhookSignature(_x5) {
 	return _verifyWebhookSignature.apply(this, arguments);
 }
 function _verifyWebhookSignature() {
@@ -427,12 +442,6 @@ const prepareSubmitAssetOptions = (options) => {
 	}
 	return options;
 };
-const appendCdnSelector = (url, options) => {
-	if (options.lens && options.transform) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Specify either a lens or a transform, not both" });
-	if (options.lens) return `${url}/@${encodeURIComponent(options.lens)}`;
-	if (!options.transform) return url;
-	return `${url}/${encodeURI(options.transform.replace(/^\/+/, ""))}`;
-};
 const getEnsureLensCacheKey = (options) => {
 	var _options$description, _options$transforms;
 	return require_CalmLensUtils.stringifyJsonCanonical({
@@ -514,6 +523,7 @@ const createApi = (options) => {
 	return new api_def.Api({
 		name: "Calm Lens",
 		baseUrl: options.baseUrl,
+		config: { queryHandling: { stringify: require_CalmLensUtils.stringifyQuery } },
 		middleware: [
 			(0, api_def.RequestCoalescingMiddleware)(),
 			{ beforeSend: (context) => {
@@ -645,12 +655,32 @@ const createEndpoints = (api) => {
 		method: "post",
 		path: "/assets/:assetId/retry"
 	});
+	const deleteAsset = api.endpoint().paramsOf().responseOf().build({
+		id: "deleteAsset",
+		method: "delete",
+		path: "/assets/:assetId"
+	});
+	const deleteAssetContent = api.endpoint().paramsOf().responseOf().build({
+		id: "deleteAssetContent",
+		method: "delete",
+		path: "/assets/:assetId/content"
+	});
 	const getEvents = api.endpoint().paramsOf().queryOf().responseOf().build({
 		id: "getEvents",
 		method: "get",
 		path: "/projects/:projectId/events"
 	});
-	return {
+	const ensureLens = api.endpoint().bodyOf().paramsOf().responseOf().build({
+		id: "ensureLens",
+		method: "put",
+		path: "/lenses/:lensIdentifier"
+	});
+	const ensureLenses = api.endpoint().bodyOf().paramsOf().responseOf().build({
+		id: "ensureLenses",
+		method: "put",
+		path: "/projects/:projectId/lenses"
+	});
+	return encodePathParams({
 		getFolders,
 		getFolder,
 		postFolder,
@@ -667,18 +697,23 @@ const createEndpoints = (api) => {
 		postAssetPart,
 		moveAsset,
 		retryAsset,
-		ensureLens: api.endpoint().bodyOf().paramsOf().responseOf().build({
-			id: "ensureLens",
-			method: "put",
-			path: "/lenses/:lensIdentifier"
-		}),
-		ensureLenses: api.endpoint().bodyOf().paramsOf().responseOf().build({
-			id: "ensureLenses",
-			method: "put",
-			path: "/projects/:projectId/lenses"
-		}),
+		deleteAsset,
+		deleteAssetContent,
+		ensureLens,
+		ensureLenses,
 		getEvents
-	};
+	});
+};
+/**
+* api-def inserts `/:param` values into the path verbatim, so every endpoint encodes its path
+* params here: an ID can never add path segments, a query string or a fragment.
+*/
+const encodePathParams = (endpoints) => {
+	for (const endpoint of Object.values(endpoints)) {
+		const submit = endpoint.submit.bind(endpoint);
+		endpoint.submit = (config) => submit(require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, config), {}, { params: config.params && Object.fromEntries(Object.entries(config.params).map(([key, value]) => [key, require_CalmLensUtils.encodePathSegment(value, key)])) }));
+	}
+	return endpoints;
 };
 var CalmLensClient = class CalmLensClient {
 	/**
@@ -804,7 +839,7 @@ var CalmLensClient = class CalmLensClient {
 				isFinal: String((_part$isFinal2 = part.isFinal) !== null && _part$isFinal2 !== void 0 ? _part$isFinal2 : false)
 			});
 			setOptionalQueryValue(query, "sizeInBytes", (_part$sizeInBytes2 = part.sizeInBytes) !== null && _part$sizeInBytes2 !== void 0 ? _part$sizeInBytes2 : require_CalmLensUtils.getAssetPayloadByteLength(part));
-			const url = `${_this2.options.baseUrl.replace(/\/$/, "")}/assets/${encodeURIComponent(assetId)}/part?${query}`;
+			const url = `${_this2.options.baseUrl.replace(/\/$/, "")}/assets/${require_CalmLensUtils.encodePathSegment(assetId, "Asset ID")}/part?${query}`;
 			const response = yield _this2.getUploadFetch()(url, {
 				method: "POST",
 				headers: {
@@ -879,8 +914,8 @@ var CalmLensClient = class CalmLensClient {
 				let { assetIdentifier } = _ref4, options = require_CalmLensUtils._objectWithoutProperties(_ref4, _excluded3);
 				if (!assetIdentifier) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset identifier is required" });
 				const resource = (_options$resource = options.resource) !== null && _options$resource !== void 0 ? _options$resource : "content";
-				const url = `${this.options.cdnBaseUrl.replace(/\/$/, "")}/assets/${encodeURIComponent(this.options.projectId)}/${encodeURIComponent(assetIdentifier)}/${resource}`;
-				return appendCdnSelector(url, options);
+				const url = `${this.options.cdnBaseUrl.replace(/\/$/, "")}/assets/${encodeURIComponent(this.options.projectId)}/${require_CalmLensUtils.encodePathSegment(assetIdentifier, "Asset identifier")}/${resource}`;
+				return require_CalmLensUtils.appendCdnSelector(url, options);
 			},
 			/**
 			* Fetch asset content or previews from the CDN.
@@ -931,14 +966,14 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with paginated assets
 			*/
 			list: function() {
-				var _ref9 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref9 = require_CalmLensUtils._asyncToGenerator(function* (options = {}) {
 					var _options$pageIndex;
 					return (yield _this5.endpoints.getAssetsPage.submit({
 						params: { projectId: _this5.options.projectId },
 						query: require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, options), {}, { pageIndex: (_options$pageIndex = options.pageIndex) !== null && _options$pageIndex !== void 0 ? _options$pageIndex : 0 })
 					})).data;
 				});
-				return function list(_x7) {
+				return function list() {
 					return _ref9.apply(this, arguments);
 				};
 			}(),
@@ -952,7 +987,7 @@ var CalmLensClient = class CalmLensClient {
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					return (yield _this5.endpoints.getAsset.submit({ params: { assetId } })).data;
 				});
-				return function retrieve(_x8) {
+				return function retrieve(_x7) {
 					return _ref10.apply(this, arguments);
 				};
 			}(),
@@ -965,7 +1000,7 @@ var CalmLensClient = class CalmLensClient {
 						body
 					})).data;
 				});
-				return function update(_x9) {
+				return function update(_x8) {
 					return _ref12.apply(this, arguments);
 				};
 			}(),
@@ -976,7 +1011,7 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with paginated child assets
 			*/
 			listChildren: function() {
-				var _ref14 = require_CalmLensUtils._asyncToGenerator(function* (_ref13) {
+				var _ref14 = require_CalmLensUtils._asyncToGenerator(function* (_ref13 = {}) {
 					var _options$pageIndex2;
 					let { assetId } = _ref13, options = require_CalmLensUtils._objectWithoutProperties(_ref13, _excluded6);
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
@@ -985,7 +1020,7 @@ var CalmLensClient = class CalmLensClient {
 						query: require_CalmLensUtils._objectSpread2(require_CalmLensUtils._objectSpread2({}, options), {}, { pageIndex: (_options$pageIndex2 = options.pageIndex) !== null && _options$pageIndex2 !== void 0 ? _options$pageIndex2 : 0 })
 					})).data;
 				});
-				return function listChildren(_x10) {
+				return function listChildren() {
 					return _ref14.apply(this, arguments);
 				};
 			}(),
@@ -1005,7 +1040,7 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: true }
 					})).data;
 				});
-				return function create(_x11) {
+				return function create(_x9) {
 					return _ref15.apply(this, arguments);
 				};
 			}(),
@@ -1027,7 +1062,7 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: false }
 					})).data;
 				});
-				return function moderate(_x12) {
+				return function moderate(_x10) {
 					return _ref16.apply(this, arguments);
 				};
 			}(),
@@ -1056,7 +1091,7 @@ var CalmLensClient = class CalmLensClient {
 					}
 					return yield _this5.submitRawAssetPart(assetId, part, (_this$multipartUpload = _this5.multipartUploadQueues.get(assetId)) !== null && _this$multipartUpload !== void 0 ? _this$multipartUpload : false);
 				});
-				return function uploadPart(_x13) {
+				return function uploadPart(_x11) {
 					return _ref17.apply(this, arguments);
 				};
 			}(),
@@ -1081,7 +1116,7 @@ var CalmLensClient = class CalmLensClient {
 						params: { assetId }
 					})).data;
 				});
-				return function createSignedUrl(_x14) {
+				return function createSignedUrl(_x12) {
 					return _ref19.apply(this, arguments);
 				};
 			}(),
@@ -1093,7 +1128,7 @@ var CalmLensClient = class CalmLensClient {
 						body: { folderId }
 					})).data;
 				});
-				return function move(_x15) {
+				return function move(_x13) {
 					return _ref20.apply(this, arguments);
 				};
 			}(),
@@ -1106,9 +1141,33 @@ var CalmLensClient = class CalmLensClient {
 					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
 					return (yield _this5.endpoints.retryAsset.submit({ params: { assetId } })).data;
 				});
-				return function retry(_x16) {
+				return function retry(_x14) {
 					return _ref21.apply(this, arguments);
 				};
+			}(),
+			/**
+			* Removes an asset's stored content (source, preview and retained extracted text) while
+			* keeping the asset record, metadata and moderation report. The returned asset has
+			* `storageDeletedAt` set; the CDN no longer serves it.
+			*/
+			deleteContent: function() {
+				var _ref22 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
+					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
+					return (yield _this5.endpoints.deleteAssetContent.submit({ params: { assetId } })).data;
+				});
+				return function deleteContent(_x15) {
+					return _ref22.apply(this, arguments);
+				};
+			}(),
+			/** Deletes an asset record together with its stored content. */
+			delete: function() {
+				var _ref23 = require_CalmLensUtils._asyncToGenerator(function* ({ assetId }) {
+					if (!assetId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
+					yield _this5.endpoints.deleteAsset.submit({ params: { assetId } });
+				});
+				return function _delete(_x16) {
+					return _ref23.apply(this, arguments);
+				};
 			}()
 		};
 	}
@@ -1121,14 +1180,14 @@ var CalmLensClient = class CalmLensClient {
 		* reshaped as `{ id, type, createdAt, projectId, data }`.
 		*/
 list: function() {
-			var _ref22 = require_CalmLensUtils._asyncToGenerator(function* (options = {}) {
+			var _ref24 = require_CalmLensUtils._asyncToGenerator(function* (options = {}) {
 				return (yield _this6.endpoints.getEvents.submit({
 					params: { projectId: _this6.options.projectId },
 					query: options
 				})).data;
 			});
 			return function list() {
-				return _ref22.apply(this, arguments);
+				return _ref24.apply(this, arguments);
 			};
 		}() };
 	}
@@ -1136,36 +1195,36 @@ list: function() {
 		var _this7 = this;
 		return {
 			list: function() {
-				var _ref23 = require_CalmLensUtils._asyncToGenerator(function* () {
+				var _ref25 = require_CalmLensUtils._asyncToGenerator(function* () {
 					return (yield _this7.endpoints.getFolders.submit({ params: { projectId: _this7.options.projectId } })).data.folders;
 				});
 				return function list() {
-					return _ref23.apply(this, arguments);
+					return _ref25.apply(this, arguments);
 				};
 			}(),
 			retrieve: function() {
-				var _ref24 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
+				var _ref26 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.getFolder.submit({ params: { folderId } })).data;
 				});
 				return function retrieve(_x17) {
-					return _ref24.apply(this, arguments);
+					return _ref26.apply(this, arguments);
 				};
 			}(),
 			create: function() {
-				var _ref25 = require_CalmLensUtils._asyncToGenerator(function* (options) {
+				var _ref27 = require_CalmLensUtils._asyncToGenerator(function* (options) {
 					return (yield _this7.endpoints.postFolder.submit({
 						params: { projectId: _this7.options.projectId },
 						body: options
 					})).data;
 				});
 				return function create(_x18) {
-					return _ref25.apply(this, arguments);
+					return _ref27.apply(this, arguments);
 				};
 			}(),
 			update: function() {
-				var _ref27 = require_CalmLensUtils._asyncToGenerator(function* (_ref26) {
-					let { folderId } = _ref26, body = require_CalmLensUtils._objectWithoutProperties(_ref26, _excluded8);
+				var _ref29 = require_CalmLensUtils._asyncToGenerator(function* (_ref28) {
+					let { folderId } = _ref28, body = require_CalmLensUtils._objectWithoutProperties(_ref28, _excluded8);
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.patchFolder.submit({
 						params: { folderId },
@@ -1173,20 +1232,20 @@ list: function() {
 					})).data;
 				});
 				return function update(_x19) {
-					return _ref27.apply(this, arguments);
+					return _ref29.apply(this, arguments);
 				};
 			}(),
 			delete: function() {
-				var _ref28 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
+				var _ref30 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId }) {
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					yield _this7.endpoints.deleteFolder.submit({ params: { folderId } });
 				});
 				return function _delete(_x20) {
-					return _ref28.apply(this, arguments);
+					return _ref30.apply(this, arguments);
 				};
 			}(),
 			move: function() {
-				var _ref29 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId, parentId }) {
+				var _ref31 = require_CalmLensUtils._asyncToGenerator(function* ({ folderId, parentId }) {
 					if (!folderId) throw require_CalmLensUtils.calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.moveFolder.submit({
 						params: { folderId },
@@ -1194,7 +1253,7 @@ list: function() {
 					})).data;
 				});
 				return function move(_x21) {
-					return _ref29.apply(this, arguments);
+					return _ref31.apply(this, arguments);
 				};
 			}()
 		};

package/cjs/testing.d.ts

@@ -1,4 +1,4 @@
-import { A as GetEventsResponse, C as UpdateAssetOptions, D as GetAssetChildrenResponse, F as Folder, G as AssetStatus, N as AssetBinaryPayloadInput, O as GetAssetResponse, P as Lens, S as SubmitAssetOptions, T as UploadAssetPartOptions, W as Asset, a as CreateAssetSignedUrlOptions, b as RetrieveAssetOptions, c as EnsureLensOptions, d as ListAssetChildrenOptions, f as ListAssetsOptions, g as MoveFolderOptions, h as MoveAssetOptions, i as CdnServeOptions, j as PostAssetSignedUrlResponse, k as GetAssetsPageResponse, l as EnsureLensesOptions, m as ModerateTextOptions, n as CalmLensClientOptions, o as CreateFolderOptions, p as ListEventsOptions, r as CdnAssetUrlOptions, u as FolderIdOptions, w as UpdateFolderOptions, x as RetryAssetOptions } from "./CalmLensTypes-B7hr0SBv.js";
+import { A as GetAssetResponse, C as RetryAssetOptions, D as UploadAssetPartOptions, E as UpdateFolderOptions, F as AssetBinaryPayloadInput, I as Lens, K as Asset, L as Folder, M as GetEventsResponse, N as PostAssetSignedUrlResponse, S as RetrieveAssetOptions, T as UpdateAssetOptions, _ as MoveAssetOptions, a as CreateAssetSignedUrlOptions, c as DeleteAssetContentOptions, d as EnsureLensesOptions, f as FolderIdOptions, g as ModerateTextOptions, h as ListEventsOptions, i as CdnServeOptions, j as GetAssetsPageResponse, k as GetAssetChildrenResponse, l as DeleteAssetOptions, m as ListAssetsOptions, n as CalmLensClientOptions, o as CreateFolderOptions, p as ListAssetChildrenOptions, q as AssetStatus, r as CdnAssetUrlOptions, u as EnsureLensOptions, v as MoveFolderOptions, w as SubmitAssetOptions } from "./CalmLensTypes-CZqyni4p.js";
 import * as zod from "zod";
 //#region ../shared/src/Permissions.d.ts
 declare const GRANT_SCHEMA: zod.ZodObject<{
@@ -107,7 +107,7 @@ interface MockCalmLensClientOptions extends CalmLensClientOptions {
   };
 }
 /** A `MockCalmLensClient` method, named like its path on the client. */
-type MockCalmLensOperation = "assets.list" | "assets.retrieve" | "assets.update" | "assets.listChildren" | "assets.create" | "assets.moderate" | "assets.uploadPart" | "assets.createSignedUrl" | "assets.move" | "assets.retry" | "text.moderate" | "cdn.serve" | "events.list" | "folders.list" | "folders.retrieve" | "folders.create" | "folders.update" | "folders.delete" | "folders.move" | "ensureLens" | "ensureLenses";
+type MockCalmLensOperation = "assets.list" | "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;
@@ -145,6 +145,7 @@ export declare class MockCalmLensClient {
   }): void;
   /** Calls recorded for one operation, oldest first. */
   callsTo(operation: MockCalmLensOperation): MockCalmLensCall[];
+  private findOwnAsset;
   private begin;
   get cdn(): {
     getAssetUrl: ({ assetIdentifier, ...options }: CdnAssetUrlOptions) => string;
@@ -158,9 +159,9 @@ export declare class MockCalmLensClient {
     moderate: (options: ModerateTextOptions) => Promise<Asset>;
   };
   get assets(): {
-    list: (options: ListAssetsOptions) => Promise<GetAssetsPageResponse>;
+    list: (options?: ListAssetsOptions) => Promise<GetAssetsPageResponse>;
     retrieve: (options: RetrieveAssetOptions) => Promise<GetAssetResponse>;
-    listChildren: (childrenOptions: ListAssetChildrenOptions) => Promise<GetAssetChildrenResponse>;
+    listChildren: (childrenOptions?: ListAssetChildrenOptions) => Promise<GetAssetChildrenResponse>;
     update: (options: UpdateAssetOptions) => Promise<Asset>;
     create: (options: SubmitAssetOptions) => Promise<Asset>;
     moderate: (options: SubmitAssetOptions) => Promise<Asset>;
@@ -168,6 +169,8 @@ export declare class MockCalmLensClient {
     createSignedUrl: (signedUrlOptions: CreateAssetSignedUrlOptions) => Promise<PostAssetSignedUrlResponse>;
     move: (options: MoveAssetOptions) => Promise<Asset>;
     retry: (options: RetryAssetOptions) => Promise<Asset>;
+    deleteContent: (options: DeleteAssetContentOptions) => Promise<Asset>;
+    delete: (options: DeleteAssetOptions) => Promise<void>;
   };
   get folders(): {
     list: () => Promise<Folder[]>;