@calmlens/sdk 0.8.1 → 0.9.1

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

@@ -266,6 +266,26 @@ const PUBLIC_ERROR_CODES = {
 		defaultMessage: "Multipart upload state is missing",
 		status: 409
 	}),
+	UPLOAD_SIZE_MISMATCH: new ErrorCode({
+		id: "upload/size-mismatch",
+		defaultMessage: "The uploaded parts do not add up to the totalSizeInBytes declared when the multipart upload started.",
+		status: 400
+	}),
+	INVALID_IDEMPOTENCY_KEY: new ErrorCode({
+		id: "idempotency/invalid-key",
+		defaultMessage: "The Idempotency-Key header must be 1 to 255 printable ASCII characters, such as a UUID.",
+		status: 400
+	}),
+	IDEMPOTENCY_KEY_REUSED: new ErrorCode({
+		id: "idempotency/key-reused",
+		defaultMessage: "This Idempotency-Key was already used for a different request. Use a new key for each distinct request.",
+		status: 409
+	}),
+	IDEMPOTENT_REQUEST_IN_PROGRESS: new ErrorCode({
+		id: "idempotency/request-in-progress",
+		defaultMessage: "A request with this Idempotency-Key is still being processed. Retry after the Retry-After delay to receive its result.",
+		status: 409
+	}),
 	ASSET_NOT_FOUND: new ErrorCode({
 		id: "asset/not-found",
 		defaultMessage: "Asset not found",
@@ -412,6 +432,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 +448,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-O1xk_Ts0.js";
 import * as zod from "zod";
 import "zod/v4";
 import { Api, FetchRequestBackend, RequestCoalescingMiddleware, RequestEvent, getErrorResponse, isRequestError } from "api-def";
@@ -440,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({
@@ -527,6 +521,7 @@ const createApi = (options) => {
 	return new Api({
 		name: "Calm Lens",
 		baseUrl: options.baseUrl,
+		config: { queryHandling: { stringify: stringifyQuery } },
 		middleware: [
 			RequestCoalescingMiddleware(),
 			{ beforeSend: (context) => {
@@ -658,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,
@@ -680,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 {
 	/**
@@ -817,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: {
@@ -892,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);
 			},
 			/**
@@ -944,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);
 				};
 			}(),
@@ -965,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);
 				};
 			}(),
@@ -978,7 +998,7 @@ var CalmLensClient = class CalmLensClient {
 						body
 					})).data;
 				});
-				return function update(_x9) {
+				return function update(_x8) {
 					return _ref12.apply(this, arguments);
 				};
 			}(),
@@ -989,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" });
@@ -998,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);
 				};
 			}(),
@@ -1018,7 +1038,7 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: true }
 					})).data;
 				});
-				return function create(_x11) {
+				return function create(_x9) {
 					return _ref15.apply(this, arguments);
 				};
 			}(),
@@ -1040,7 +1060,7 @@ var CalmLensClient = class CalmLensClient {
 						query: { queue: false }
 					})).data;
 				});
-				return function moderate(_x12) {
+				return function moderate(_x10) {
 					return _ref16.apply(this, arguments);
 				};
 			}(),
@@ -1069,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);
 				};
 			}(),
@@ -1094,7 +1114,7 @@ var CalmLensClient = class CalmLensClient {
 						params: { assetId }
 					})).data;
 				});
-				return function createSignedUrl(_x14) {
+				return function createSignedUrl(_x12) {
 					return _ref19.apply(this, arguments);
 				};
 			}(),
@@ -1106,7 +1126,7 @@ var CalmLensClient = class CalmLensClient {
 						body: { folderId }
 					})).data;
 				});
-				return function move(_x15) {
+				return function move(_x13) {
 					return _ref20.apply(this, arguments);
 				};
 			}(),
@@ -1119,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);
+				};
 			}()
 		};
 	}
@@ -1134,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);
 			};
 		}() };
 	}
@@ -1149,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 },
@@ -1186,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 },
@@ -1207,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[]>;