@calmlens/sdk 0.8.0 → 0.9.0

package/esm/{CalmLensUtils-BZsX8yeO.js → CalmLensUtils-Bnikzonc.js}

@@ -412,6 +412,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);
@@ -427,5 +428,45 @@ 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
-export { getRawBase64 as _, SDK_ERRORS as a, _objectSpread2 as b, MAX_IMAGE_UPLOAD_BYTES as c, isRejectedUploadMimeType as d, PUBLIC_ERROR_CODES as f, getAssetPayloadByteLength as g, assetToData as h, CalmLensError as i, MIN_MULTIPART_IMAGE_UPLOAD_BYTES as l, assetDataToUint8Array as m, validateClientOptions as n, calmLensError as o, stringifyJsonCanonical as p, _objectWithoutProperties as r, DOMAIN as s, toTextAssetOptions as t, getRejectedUploadMimeTypeError as u, validateAssetPayload as v, _asyncToGenerator as y };
+export { _objectSpread2 as C, _asyncToGenerator as S, assetDataToUint8Array as _, validateClientOptions as a, getRawBase64 as b, SDK_ERRORS as c, MAX_IMAGE_UPLOAD_BYTES as d, MIN_MULTIPART_IMAGE_UPLOAD_BYTES as f, stringifyJsonCanonical as g, PUBLIC_ERROR_CODES as h, toTextAssetOptions as i, calmLensError as l, isRejectedUploadMimeType as m, encodePathSegment as n, _objectWithoutProperties as o, getRejectedUploadMimeTypeError as p, stringifyQuery as r, CalmLensError as s, appendCdnSelector as t, DOMAIN as u, assetToData as v, validateAssetPayload as x, getAssetPayloadByteLength as y };

package/esm/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/esm/index.js

@@ -1,4 +1,4 @@
-import { _ as getRawBase64, a as SDK_ERRORS, b as _objectSpread2, c as MAX_IMAGE_UPLOAD_BYTES, d as isRejectedUploadMimeType, f as PUBLIC_ERROR_CODES, g as getAssetPayloadByteLength, h as assetToData, i as CalmLensError, l as MIN_MULTIPART_IMAGE_UPLOAD_BYTES, n as validateClientOptions, o as calmLensError, p as stringifyJsonCanonical, r as _objectWithoutProperties, s as DOMAIN, t as toTextAssetOptions, u as getRejectedUploadMimeTypeError, v as validateAssetPayload, y as _asyncToGenerator } from "./CalmLensUtils-BZsX8yeO.js";
+import { C as _objectSpread2, S as _asyncToGenerator, a as validateClientOptions, b as getRawBase64, c as SDK_ERRORS, d as MAX_IMAGE_UPLOAD_BYTES, f as MIN_MULTIPART_IMAGE_UPLOAD_BYTES, g as stringifyJsonCanonical, h as PUBLIC_ERROR_CODES, i as toTextAssetOptions, l as calmLensError, m as isRejectedUploadMimeType, n as encodePathSegment, o as _objectWithoutProperties, p as getRejectedUploadMimeTypeError, r as stringifyQuery, s as CalmLensError, t as appendCdnSelector, u as DOMAIN, v as assetToData, x as validateAssetPayload, y as getAssetPayloadByteLength } from "./CalmLensUtils-Bnikzonc.js";
 import * as zod from "zod";
 import "zod/v4";
 import { Api, FetchRequestBackend, RequestCoalescingMiddleware, RequestEvent, getErrorResponse, isRequestError } from "api-def";
@@ -242,6 +242,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 = _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 = _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";
@@ -266,39 +302,18 @@ const toWebhookEventPayload = (event) => {
 		}
 	};
 };
-const encoder = new TextEncoder();
-const hmacSha256Hex = function() {
-	var _ref = _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 = _asyncToGenerator(function* (secret, timestamp, body) {
+	var _ref = _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 = _asyncToGenerator(function* (options) {
+	var _ref2 = _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 {
@@ -308,8 +323,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);
 	};
 }();
 /**
@@ -317,7 +332,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() {
@@ -425,12 +440,6 @@ const prepareSubmitAssetOptions = (options) => {
 	}
 	return options;
 };
-const appendCdnSelector = (url, options) => {
-	if (options.lens && options.transform) throw 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 stringifyJsonCanonical({
@@ -512,6 +521,7 @@ const createApi = (options) => {
 	return new Api({
 		name: "Calm Lens",
 		baseUrl: options.baseUrl,
+		config: { queryHandling: { stringify: stringifyQuery } },
 		middleware: [
 			RequestCoalescingMiddleware(),
 			{ beforeSend: (context) => {
@@ -643,12 +653,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,
@@ -665,18 +695,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(_objectSpread2(_objectSpread2({}, config), {}, { params: config.params && Object.fromEntries(Object.entries(config.params).map(([key, value]) => [key, encodePathSegment(value, key)])) }));
+	}
+	return endpoints;
 };
 var CalmLensClient = class CalmLensClient {
 	/**
@@ -802,7 +837,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 : getAssetPayloadByteLength(part));
-			const url = `${_this2.options.baseUrl.replace(/\/$/, "")}/assets/${encodeURIComponent(assetId)}/part?${query}`;
+			const url = `${_this2.options.baseUrl.replace(/\/$/, "")}/assets/${encodePathSegment(assetId, "Asset ID")}/part?${query}`;
 			const response = yield _this2.getUploadFetch()(url, {
 				method: "POST",
 				headers: {
@@ -877,7 +912,7 @@ var CalmLensClient = class CalmLensClient {
 				let { assetIdentifier } = _ref4, options = _objectWithoutProperties(_ref4, _excluded3);
 				if (!assetIdentifier) throw 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}`;
+				const url = `${this.options.cdnBaseUrl.replace(/\/$/, "")}/assets/${encodeURIComponent(this.options.projectId)}/${encodePathSegment(assetIdentifier, "Asset identifier")}/${resource}`;
 				return appendCdnSelector(url, options);
 			},
 			/**
@@ -929,14 +964,14 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with paginated assets
 			*/
 			list: function() {
-				var _ref9 = _asyncToGenerator(function* (options) {
+				var _ref9 = _asyncToGenerator(function* (options = {}) {
 					var _options$pageIndex;
 					return (yield _this5.endpoints.getAssetsPage.submit({
 						params: { projectId: _this5.options.projectId },
 						query: _objectSpread2(_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);
 				};
 			}(),
@@ -950,7 +985,7 @@ var CalmLensClient = class CalmLensClient {
 					if (!assetId) throw 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);
 				};
 			}(),
@@ -963,7 +998,7 @@ var CalmLensClient = class CalmLensClient {
 						body
 					})).data;
 				});
-				return function update(_x9) {
+				return function update(_x8) {
 					return _ref12.apply(this, arguments);
 				};
 			}(),
@@ -974,7 +1009,7 @@ var CalmLensClient = class CalmLensClient {
 			* @returns Promise with paginated child assets
 			*/
 			listChildren: function() {
-				var _ref14 = _asyncToGenerator(function* (_ref13) {
+				var _ref14 = _asyncToGenerator(function* (_ref13 = {}) {
 					var _options$pageIndex2;
 					let { assetId } = _ref13, options = _objectWithoutProperties(_ref13, _excluded6);
 					if (!assetId) throw calmLensError({ id: "upload/invalid-payload" }, { message: "Asset ID is required" });
@@ -983,7 +1018,7 @@ var CalmLensClient = class CalmLensClient {
 						query: _objectSpread2(_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);
 				};
 			}(),
@@ -1003,7 +1038,7 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: true }
 					})).data;
 				});
-				return function create(_x11) {
+				return function create(_x9) {
 					return _ref15.apply(this, arguments);
 				};
 			}(),
@@ -1025,7 +1060,7 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: false }
 					})).data;
 				});
-				return function moderate(_x12) {
+				return function moderate(_x10) {
 					return _ref16.apply(this, arguments);
 				};
 			}(),
@@ -1054,7 +1089,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);
 				};
 			}(),
@@ -1079,7 +1114,7 @@ var CalmLensClient = class CalmLensClient {
 						params: { assetId }
 					})).data;
 				});
-				return function createSignedUrl(_x14) {
+				return function createSignedUrl(_x12) {
 					return _ref19.apply(this, arguments);
 				};
 			}(),
@@ -1091,7 +1126,7 @@ var CalmLensClient = class CalmLensClient {
 						body: { folderId }
 					})).data;
 				});
-				return function move(_x15) {
+				return function move(_x13) {
 					return _ref20.apply(this, arguments);
 				};
 			}(),
@@ -1104,9 +1139,33 @@ var CalmLensClient = class CalmLensClient {
 					if (!assetId) throw 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 = _asyncToGenerator(function* ({ assetId }) {
+					if (!assetId) throw 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 = _asyncToGenerator(function* ({ assetId }) {
+					if (!assetId) throw 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);
+				};
 			}()
 		};
 	}
@@ -1119,14 +1178,14 @@ var CalmLensClient = class CalmLensClient {
 		* reshaped as `{ id, type, createdAt, projectId, data }`.
 		*/
 list: function() {
-			var _ref22 = _asyncToGenerator(function* (options = {}) {
+			var _ref24 = _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);
 			};
 		}() };
 	}
@@ -1134,36 +1193,36 @@ list: function() {
 		var _this7 = this;
 		return {
 			list: function() {
-				var _ref23 = _asyncToGenerator(function* () {
+				var _ref25 = _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 = _asyncToGenerator(function* ({ folderId }) {
+				var _ref26 = _asyncToGenerator(function* ({ folderId }) {
 					if (!folderId) throw 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 = _asyncToGenerator(function* (options) {
+				var _ref27 = _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 = _asyncToGenerator(function* (_ref26) {
-					let { folderId } = _ref26, body = _objectWithoutProperties(_ref26, _excluded8);
+				var _ref29 = _asyncToGenerator(function* (_ref28) {
+					let { folderId } = _ref28, body = _objectWithoutProperties(_ref28, _excluded8);
 					if (!folderId) throw calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.patchFolder.submit({
 						params: { folderId },
@@ -1171,20 +1230,20 @@ list: function() {
 					})).data;
 				});
 				return function update(_x19) {
-					return _ref27.apply(this, arguments);
+					return _ref29.apply(this, arguments);
 				};
 			}(),
 			delete: function() {
-				var _ref28 = _asyncToGenerator(function* ({ folderId }) {
+				var _ref30 = _asyncToGenerator(function* ({ folderId }) {
 					if (!folderId) throw 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 = _asyncToGenerator(function* ({ folderId, parentId }) {
+				var _ref31 = _asyncToGenerator(function* ({ folderId, parentId }) {
 					if (!folderId) throw calmLensError({ id: "upload/invalid-payload" }, { message: "Folder ID is required" });
 					return (yield _this7.endpoints.moveFolder.submit({
 						params: { folderId },
@@ -1192,7 +1251,7 @@ list: function() {
 					})).data;
 				});
 				return function move(_x21) {
-					return _ref29.apply(this, arguments);
+					return _ref31.apply(this, arguments);
 				};
 			}()
 		};

package/esm/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[]>;