@calmlens/sdk 0.16.2 → 0.17.1

package/esm/react.js

@@ -0,0 +1,343 @@
+"use client";
+import { _ as getMediaState, a as getMediaAspectRatio, b as ICONS, c as describeUploadItem, d as formatMessage, f as getDropzoneHint, g as resolveMessages, h as getUploadItemOutcome, i as resolveTheme, l as describeUploader, m as getUploadItemMessage, n as CALMLENS_STYLES_ID, o as getMediaLoadKey, p as getMediaUnavailableMessage, r as CALMLENS_THEME, s as DEFAULT_MESSAGES, t as CALMLENS_STYLES, u as formatBytes, v as pickMediaSource, x as ICON_ATTRIBUTES, y as resolveMediaProps } from "./ui-Ca_SpJXf.js";
+import { i as createProgressFetch, r as isFileAccepted, t as UploadController } from "./UploadController-txp5NuzH.js";
+import { n as useOwnController, r as useUploadSnapshot, t as useCalmLensUpload$1 } from "./ReactUpload-D6yBCkcw.js";
+import { t as createUploadController } from "./BrowserUpload-D7-zNmc0.js";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+// src/react.tsx
+/**
+* Uploads files through an upload preset and re-renders as each one uploads and is checked. Use
+* it to build your own upload UI; `CalmLensUploader` is built on it. Uploads still running when
+* the component unmounts are cancelled.
+*/
+const useCalmLensUpload = (options) => useCalmLensUpload$1(options);
+const joinClassNames = (...names) => names.filter(Boolean).join(" ");
+const Icon = ({ name }) => {
+	const { "stroke-width": strokeWidth, "stroke-linecap": strokeLinecap, "stroke-linejoin": strokeLinejoin, "aria-hidden": ariaHidden, ...rest } = ICON_ATTRIBUTES;
+	return /* @__PURE__ */ jsx("svg", {
+		...rest,
+		strokeWidth,
+		strokeLinecap,
+		strokeLinejoin,
+		"aria-hidden": ariaHidden,
+		children: /* @__PURE__ */ jsx("path", { d: ICONS[name] })
+	});
+};
+/**
+* The components' stylesheet, rendered with them: React hoists it into the document head, on the
+* server as well as in the browser, and adds it once however many components render.
+*/
+const CalmLensStyles = ({ unstyled }) => unstyled ? null : /* @__PURE__ */ jsx("style", {
+	href: CALMLENS_STYLES_ID,
+	precedence: "calmlens",
+	children: CALMLENS_STYLES
+});
+/**
+* A drop zone and file list that uploads through an upload preset, shows each file's progress
+* and moderation decision, and reports finished uploads to `onUploaded`.
+*/
+function CalmLensUploader({ disabled, capture, messages: overrides, unstyled, controller: external, className, style, ...options }) {
+	const own = useOwnController(options, !external);
+	const upload = useUploadSnapshot(external ?? own);
+	const { accept, multiple } = upload.controller.options;
+	const messages = useMemo(() => resolveMessages(overrides), [overrides]);
+	const view = describeUploader(upload, upload.controller.options, messages);
+	const [dragging, setDragging] = useState(false);
+	const input = useRef(null);
+	const openPicker = () => {
+		if (!disabled) input.current?.click();
+	};
+	const onDragOver = (event) => {
+		event.preventDefault();
+		if (!disabled) setDragging(true);
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: joinClassNames("calmlens-uploader", className),
+		style,
+		children: [
+			/* @__PURE__ */ jsx(CalmLensStyles, { unstyled }),
+			view.showDropzone && /* @__PURE__ */ jsxs("div", {
+				className: "calmlens-dropzone",
+				"data-dragging": dragging || void 0,
+				"data-disabled": disabled || void 0,
+				onClick: openPicker,
+				onDragOver,
+				onDragEnter: onDragOver,
+				onDragLeave: (event) => {
+					if (!event.currentTarget.contains(event.relatedTarget)) setDragging(false);
+				},
+				onDrop: (event) => {
+					event.preventDefault();
+					setDragging(false);
+					if (!disabled) upload.addFiles(event.dataTransfer.files);
+				},
+				onPaste: (event) => {
+					if (!disabled && event.clipboardData.files.length) upload.addFiles(event.clipboardData.files);
+				},
+				children: [
+					/* @__PURE__ */ jsx("span", {
+						className: "calmlens-dropzone__icon",
+						children: /* @__PURE__ */ jsx(Icon, { name: "upload" })
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "calmlens-dropzone__text",
+						children: [/* @__PURE__ */ jsx("p", {
+							className: "calmlens-dropzone__title",
+							children: dragging ? messages.dropzoneTitleDragging : messages.dropzoneTitle
+						}), view.hint && /* @__PURE__ */ jsx("p", {
+							className: "calmlens-dropzone__hint",
+							children: view.hint
+						})]
+					}),
+					/* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: "calmlens-button",
+						"data-variant": "outline",
+						disabled,
+						onClick: (event) => {
+							event.stopPropagation();
+							openPicker();
+						},
+						children: view.chooseLabel
+					})
+				]
+			}),
+			/* @__PURE__ */ jsx("input", {
+				ref: input,
+				type: "file",
+				hidden: true,
+				accept,
+				multiple,
+				capture,
+				disabled,
+				onChange: (event) => {
+					if (event.target.files) upload.addFiles(event.target.files);
+					event.target.value = "";
+				}
+			}),
+			upload.items.length > 0 && /* @__PURE__ */ jsx("ul", {
+				className: "calmlens-uploads",
+				children: upload.items.map((item) => {
+					const itemView = describeUploadItem(item, messages);
+					return /* @__PURE__ */ jsxs("li", {
+						className: "calmlens-upload",
+						"data-stage": item.stage,
+						"data-outcome": itemView.outcome,
+						children: [
+							item.previewUrl ? /* @__PURE__ */ jsx("img", {
+								className: "calmlens-upload__thumb",
+								src: item.previewUrl,
+								alt: ""
+							}) : /* @__PURE__ */ jsx("span", {
+								className: "calmlens-upload__thumb",
+								"data-kind": "file",
+								"aria-hidden": "true",
+								dangerouslySetInnerHTML: { __html: itemView.fileIcon }
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "calmlens-upload__body",
+								children: [
+									/* @__PURE__ */ jsx("span", {
+										className: "calmlens-upload__name",
+										children: item.file.name
+									}),
+									/* @__PURE__ */ jsx("span", {
+										className: "calmlens-upload__size",
+										children: itemView.size
+									}),
+									itemView.busy && /* @__PURE__ */ jsx("div", {
+										className: "calmlens-progress",
+										role: "progressbar",
+										"aria-label": itemView.message,
+										"aria-valuemin": 0,
+										"aria-valuemax": 100,
+										"aria-valuenow": itemView.progressPercent,
+										children: /* @__PURE__ */ jsx("div", {
+											className: "calmlens-progress__bar",
+											style: itemView.progressPercent === void 0 ? void 0 : { width: `${itemView.progressPercent}%` }
+										})
+									}),
+									itemView.message && /* @__PURE__ */ jsx("p", {
+										className: "calmlens-upload__message",
+										role: "status",
+										children: itemView.message
+									})
+								]
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "calmlens-upload__actions",
+								children: [
+									!view.showDropzone && /* @__PURE__ */ jsx("button", {
+										type: "button",
+										className: "calmlens-button",
+										"data-variant": "outline",
+										"data-size": "small",
+										disabled,
+										onClick: openPicker,
+										children: messages.chooseAnother
+									}),
+									itemView.canRetry && /* @__PURE__ */ jsx("button", {
+										type: "button",
+										className: "calmlens-icon-button",
+										"aria-label": messages.retry,
+										title: messages.retry,
+										onClick: () => upload.retry(item.key),
+										children: /* @__PURE__ */ jsx(Icon, { name: "retry" })
+									}),
+									/* @__PURE__ */ jsx("button", {
+										type: "button",
+										className: "calmlens-icon-button",
+										"aria-label": itemView.removeLabel,
+										title: itemView.removeLabel,
+										onClick: () => upload.remove(item.key),
+										children: /* @__PURE__ */ jsx(Icon, { name: "remove" })
+									})
+								]
+							})
+						]
+					}, item.key);
+				})
+			})
+		]
+	});
+}
+/**
+* Shows an asset from the CalmLens CDN with responsive widths and a blurred placeholder while
+* it loads. Age-restricted assets stay behind the placeholder and a reveal button until
+* `ageConfirmed` is set; blocked and purged assets show an unavailable notice.
+*/
+function CalmLensMedia(input) {
+	const { asset: _asset, projectId, assetId, status, contentRemoved, type, resource, lens, transform, widths, url, placeholder, placeholderHash, placeholderUrl: customPlaceholderUrl, cdnBaseUrl, viewerClaims, alt = "", aspectRatio, width, height, sizes, averageColor, fit, position, lazy = true, fetchPriority, controls = true, messages: overrides, unstyled, onReveal, className, style, ...attributes } = resolveMediaProps(input);
+	const messages = useMemo(() => resolveMessages(overrides), [overrides]);
+	const state = getMediaState({
+		asset: _asset,
+		projectId,
+		assetId,
+		status,
+		contentRemoved,
+		type,
+		resource,
+		lens,
+		transform,
+		widths,
+		url,
+		placeholder,
+		placeholderHash,
+		placeholderUrl: customPlaceholderUrl,
+		cdnBaseUrl,
+		viewerClaims
+	});
+	const loadKey = getMediaLoadKey(state);
+	const [load, setLoad] = useState({
+		key: loadKey,
+		state: "loading"
+	});
+	const current = load.key === loadKey ? load : {
+		key: loadKey,
+		state: "loading"
+	};
+	const image = useRef(null);
+	useEffect(() => {
+		if (image.current?.complete && image.current.naturalWidth > 0) setLoad({
+			key: loadKey,
+			state: "loaded"
+		});
+	}, [loadKey]);
+	const ratio = getMediaAspectRatio({
+		aspectRatio,
+		width,
+		height
+	});
+	const kind = current.state === "error" ? "unavailable" : state.kind;
+	const placeholderUrl = state.kind === "audio" || state.kind === "unavailable" ? void 0 : state.placeholderUrl;
+	const showPlaceholder = placeholderUrl && (state.kind === "gated" || state.kind === "image" && current.state !== "loaded");
+	return /* @__PURE__ */ jsxs("figure", {
+		...attributes,
+		className: joinClassNames("calmlens-media", className),
+		"data-kind": state.kind,
+		"data-state": current.state,
+		"data-sized": ratio ? "" : void 0,
+		style: {
+			aspectRatio: ratio,
+			backgroundColor: averageColor,
+			"--calmlens-fit": fit,
+			"--calmlens-position": position,
+			...style
+		},
+		children: [
+			/* @__PURE__ */ jsx(CalmLensStyles, { unstyled }),
+			showPlaceholder && /* @__PURE__ */ jsx("img", {
+				className: "calmlens-media__placeholder",
+				src: placeholderUrl,
+				alt: "",
+				"aria-hidden": "true"
+			}),
+			state.kind === "image" && current.state !== "error" && /* @__PURE__ */ jsx("img", {
+				ref: image,
+				className: "calmlens-media__content",
+				src: state.src,
+				srcSet: state.srcSet,
+				sizes,
+				alt,
+				width,
+				height,
+				loading: lazy ? "lazy" : void 0,
+				decoding: "async",
+				fetchPriority,
+				onLoad: () => setLoad({
+					key: loadKey,
+					state: "loaded"
+				}),
+				onError: () => setLoad({
+					key: loadKey,
+					state: "error"
+				})
+			}, loadKey),
+			state.kind === "video" && current.state !== "error" && /* @__PURE__ */ jsx("video", {
+				className: "calmlens-media__content",
+				src: state.src,
+				controls,
+				playsInline: true,
+				preload: "metadata",
+				"aria-label": alt || void 0,
+				onError: () => setLoad({
+					key: loadKey,
+					state: "error"
+				})
+			}),
+			state.kind === "audio" && current.state !== "error" && /* @__PURE__ */ jsx("audio", {
+				className: "calmlens-media__content",
+				src: state.src,
+				controls,
+				preload: "metadata",
+				"aria-label": alt || void 0,
+				onError: () => setLoad({
+					key: loadKey,
+					state: "error"
+				})
+			}),
+			state.kind === "gated" && /* @__PURE__ */ jsxs("figcaption", {
+				className: "calmlens-media__notice",
+				children: [
+					/* @__PURE__ */ jsx("strong", { children: messages.sensitiveTitle }),
+					/* @__PURE__ */ jsx("p", { children: messages.sensitiveBody }),
+					onReveal && /* @__PURE__ */ jsx("button", {
+						type: "button",
+						className: "calmlens-button",
+						onClick: onReveal,
+						children: messages.reveal
+					})
+				]
+			}),
+			kind === "unavailable" && /* @__PURE__ */ jsx("figcaption", {
+				className: "calmlens-media__notice",
+				children: /* @__PURE__ */ jsxs("p", { children: [/* @__PURE__ */ jsx(Icon, { name: "unavailable" }), /* @__PURE__ */ jsx("span", {
+					className: "calmlens-media__label",
+					children: getMediaUnavailableMessage(state, messages)
+				})] })
+			})
+		]
+	});
+}
+export { CALMLENS_STYLES, CALMLENS_THEME, CalmLensMedia, CalmLensUploader, DEFAULT_MESSAGES, ICONS, ICON_ATTRIBUTES, UploadController, createProgressFetch, createUploadController, describeUploadItem, describeUploader, formatBytes, formatMessage, getDropzoneHint, getMediaAspectRatio, getMediaLoadKey, getMediaState, getMediaUnavailableMessage, getUploadItemMessage, getUploadItemOutcome, isFileAccepted, pickMediaSource, resolveMediaProps, resolveMessages, resolveTheme, useCalmLensUpload };

package/esm/server.d.ts

@@ -1,192 +1,9 @@
-import { $ as SearchAssetsOptions, A as DeleteAssetContentOptions, At as AssetSearchQuery, B as Lens, C as CdnAssetUrlOptions, Ct as EventType, D as CreateAssetSignedUrlOptions, Dt as Order, E as ConnectionOptions, Et as CursorPage, F as IdempotencyOptions, Ft as ImageData, G as ModerateTextOptions, H as ListAssetChildrenOptions, I as ImageTransform, It as MetadataItem, J as MultipartUploadOptions, K as MoveAssetOptions, L as ImageTransformOptions, Lt as PreviewImage, M as EnsureLensOptions, Mt as AssetSafetyHold, N as EnsureLensesOptions, Nt as AssetSafetyHoldReason, O as CreateFolderOptions, Ot as LensType, P as FolderIdOptions, Pt as ExtractedText, Q as RetryAssetOptions, R as IterateAssetChildrenOptions, Rt as ProcessingOptions, S as CalmLensServerClientOptions, St as EventSeverity, T as CdnTransform, Tt as Folder, U as ListAssetsOptions, V as LensTransform, W as ListEventsOptions, X as RequestOptions, Y as MultipartUploadPartOptions, Z as RetrieveAssetOptions, _ as AssetSearchResponse, _t as TypedEvent, a as AssetChildrenPage, at as UpdateFolderOptions, b as AssetVisibility, bt as EventFactValues, c as AssetContentRemovalReason, ct as UploadedAsset, d as AssetModerationAction, dt as WebhookHeadersInput, et as SignUploadTokenOptions, f as AssetModerationStatus, ft as WebhookPayloadInput, g as AssetReviewerAction, gt as EventAsset, h as AssetProcessingStatus, i as AssetChecksums, it as UpdateAssetOptions, j as DeleteAssetOptions, k as CreateMultipartUploadPartOptions, kt as AssetSearchMatchField, l as AssetContentStatus, lt as VerifyWebhookSignatureOptions, m as AssetProcessing, mt as PostAssetSignedUrlResponse, nt as SignedUrl, o as AssetContent, ot as UploadAssetPartOptions, p as AssetPage, pt as GetEventsResponse, q as MoveFolderOptions, r as Asset, rt as SubmitAssetOptions, s as AssetContentOptions, st as UploadPresetSubmitAssetOptions, t as ReceivedWebhookEventPayload, tt as SignedUploadToken, u as AssetModeration, ut as WaitForAssetDecisionOptions, v as AssetSearchResult, vt as EventCategory, w as CdnServeOptions, x as CalmLensAppClientOptions, xt as EventFacts, y as AssetType, yt as EventFact, z as IterateAssetsOptions } from "./WebhookPayload-CJoIkGBD.js";
-import { _ as ApiErrorCode, a as DetectedPerson, c as ProcessingFeatureStage, d as CALMLENS_ERROR_CODES, f as CalmLensError, g as SdkErrorCode, h as CalmLensErrorOptions, i as DetectedFace, l as ProcessingFeatures, m as CalmLensErrorDetails, n as AgeRange, o as ProcessingFeatureId, p as CalmLensErrorCode, r as BoundingBox, s as ProcessingFeatureResults, t as FlaggedContentPolicy, u as SDK_VERSION } from "./index-C9Xw1aid.js";
-import { a as ClassificationNotEvaluatedReason, c as FlaggedContentAction, i as ClassificationLabel, l as Likelihood, n as ClassificationCategory, o as ClassificationQualifierResults, r as ClassificationCategoryReport, s as ClassificationReport, t as ClassificationCategories, u as ModerationQualifier } from "./Classification-BNhgwGEm-DmA9VEuE.js";
-//#region src/client/CalmLensServerClient.d.ts
-interface LensCache {
-  readonly ensuredLenses: Map<string, Lens>;
-  readonly pendingEnsureLenses: Map<string, Promise<void>>;
-}
-declare const inspectSymbol: unique symbol;
-/**
- * The CalmLens API client for your server, authenticated with a project API key. Create one per
- * project and reuse it; it holds no connections. Every method takes one options object and
- * throws `CalmLensError` on failure. Browsers and apps upload with `CalmLensAppClient` instead.
- */
-declare class CalmLensServerClient {
-  #private;
-  /**
-   * Verifies that a webhook delivery came from CalmLens: checks the `v1=` HMAC-SHA256 in
-   * `x-calmlens-signature` over `"<x-calmlens-timestamp>.<raw body>"` and rejects timestamps
-   * more than `toleranceSeconds` (default 300) from now, which stops replayed deliveries.
-   * Also exported as `verifyWebhookSignature`; `parseWebhookEvent` verifies and parses.
-   *
-   * @example
-   * ```ts
-   * const payload = await request.text();
-   * const isValid = await CalmLensServerClient.verifyWebhookSignature({
-   *   payload,
-   *   headers: request.headers,
-   *   secret: process.env.CALMLENS_WEBHOOK_SECRET!,
-   * });
-   * ```
-   */
-  static verifyWebhookSignature(options: VerifyWebhookSignatureOptions): Promise<boolean>;
-  constructor(options: CalmLensServerClientOptions, lenses?: LensCache);
-  /**
-   * A client with different cancellation, deadlines or retries for the calls made through it,
-   * sharing this client's credentials and lens cache. This client is unchanged.
-   */
-  withRequestOptions(options: RequestOptions): CalmLensServerClient;
-  /** Keeps the API key out of `console.log`, `util.inspect` and `JSON.stringify`. */
-  [inspectSymbol](): string;
-  toJSON(): {
-    projectId: string;
-    baseUrl: string;
-    cdnBaseUrl: string;
-  };
-  private get projectPath();
-  private request;
-  private submitAsset;
-  get cdn(): {
-    /**
-     * Builds a CDN URL for asset content or a preview, without a request. Private assets
-     * need a signed URL (`assets.createSignedUrl`) or an authenticated request.
-     */
-    getAssetUrl: ({ assetIdentifier, ...options }: CdnAssetUrlOptions) => string;
-    /**
-     * Fetches asset content or a preview from the CDN with the client's API key, and returns
-     * the `Response` as soon as headers arrive, so the body streams. Non-2xx responses are
-     * returned, not thrown; `timeoutMs` covers only the wait for headers.
-     */
-    serve: ({ assetIdentifier, init, ...urlOptions }: CdnServeOptions) => Promise<Response>;
-  };
-  get text(): {
-    /**
-     * Moderates text and waits for the decision. Sends `text` as `text/plain` content named
-     * `text` unless you pass `name`.
-     */
-    moderate: (options: ModerateTextOptions) => Promise<Asset>;
-  };
-  /** Assets: uploads, moderation and management. */
-  get assets(): {
-    /** Searches accessible assets by keyword or a natural-language description. */
-    search: (options: Partial<AssetSearchQuery> & {
-      query: string;
-    }) => Promise<AssetSearchResponse>;
-    /** Lists one page of the project's assets, with optional filter and ordering. */
-    list: (options?: ListAssetsOptions) => Promise<AssetPage>;
-    /**
-     * Yields every asset matching `options`, fetching pages as needed. The cursor keeps the position
-     * stable when other assets are inserted or deleted.
-     */
-    iterate: (options?: IterateAssetsOptions) => AsyncGenerator<Asset, void, undefined>;
-    /** Retrieves an asset with its status and moderation report. */
-    retrieve: ({ assetId }: RetrieveAssetOptions) => Promise<Asset>;
-    /** Updates an asset's editable fields. */
-    update: ({ assetId, ...body }: UpdateAssetOptions) => Promise<Asset>;
-    /** Lists one page of the assets extracted from a website or multimedia document. */
-    listChildren: ({ assetId, ...options }?: ListAssetChildrenOptions) => Promise<AssetChildrenPage>;
-    /** Yields every child of an asset, fetching pages as needed. */
-    iterateChildren: (options: IterateAssetChildrenOptions) => AsyncGenerator<Asset, void, undefined>;
-    /**
-     * Uploads an asset and queues it for moderation, returning immediately with processing
-     * status `processing` (or `uploading` for the first multipart part). Retried safely with an
-     * `Idempotency-Key`.
-     */
-    create: (options: SubmitAssetOptions) => Promise<Asset>;
-    /**
-     * Uploads an asset and waits for its moderation decision. Audio and video still finish
-     * in the background. Retried safely with an `Idempotency-Key`.
-     */
-    moderate: (options: SubmitAssetOptions) => Promise<Asset>;
-    /**
-     * Uploads the next part of a multipart upload. The upload's queue mode, chosen when it
-     * started, applies when the final part arrives; pass `queue` to override it.
-     */
-    uploadPart: ({ assetId, ...options }: UploadAssetPartOptions) => Promise<Asset>;
-    /**
-     * Creates a short-lived signed CDN URL, so browsers can load private content without
-     * an API key.
-     */
-    createSignedUrl: ({ assetId, ...options }: CreateAssetSignedUrlOptions) => Promise<PostAssetSignedUrlResponse>;
-    /** Moves an asset into a folder, or to the project root with `folderId: null`. */
-    move: ({ assetId, folderId }: MoveAssetOptions) => Promise<Asset>;
-    /**
-     * Processes an asset that failed (processing status `failed`) again. It returns to
-     * `processing` and is
-     * moderated like a new upload; its content must still be stored.
-     */
-    retry: ({ assetId }: RetryAssetOptions) => Promise<Asset>;
-    /**
-     * Waits until an asset's `moderation.status` is `approved` or `rejected`, or its
-     * `processing.status` is `failed`, and returns that asset, checking every few seconds. Rejects with `sdk/timeout` if there is no
-     * decision within `timeoutMs` (default 60000). Webhooks report decisions without polling.
-     */
-    waitForDecision: ({ assetId, ...options }: WaitForAssetDecisionOptions) => 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>;
-  };
-  /**
-   * Signs upload tokens on your server, so a browser or app can upload through an upload preset
-   * that requires one. Signing happens locally with your API key: it makes no request.
-   */
-  get uploadTokens(): {
-    /**
-     * Signs a single-use token for one upload through `uploadPresetId`. Give `token` to the
-     * browser or app, which passes it to `CalmLensAppClient` as `token`.
-     */
-    sign: (options: SignUploadTokenOptions) => Promise<SignedUploadToken>;
-  };
-  private buildAssets;
-  get events(): {
-    /**
-     * Lists project events after a cursor, oldest first. Call without `after` to get a cursor
-     * for "now", then poll with the returned `cursor`. Webhook deliveries carry the same events
-     * reshaped as `{ id, type, createdAt, projectId, data }`.
-     */
-    list: (options?: ListEventsOptions) => Promise<GetEventsResponse>;
-    /**
-     * Yields pages of events after `after` until no more are waiting. Save each page's
-     * `cursor` to resume later. Without `after`, yields one empty page whose cursor is "now".
-     */
-    pages: (options?: ListEventsOptions) => AsyncGenerator<GetEventsResponse, void, undefined>;
-  };
-  private iterateEventPages;
-  private iteratePages;
-  get folders(): {
-    /** Lists every folder in the project. */
-    list: () => Promise<Folder[]>;
-    retrieve: ({ folderId }: FolderIdOptions) => Promise<Folder>;
-    /** Creates a folder at the project root or inside `parentId`. */
-    create: (options: CreateFolderOptions) => Promise<Folder>;
-    update: ({ folderId, ...body }: UpdateFolderOptions) => Promise<Folder>;
-    /** Deletes an empty folder; throws `folder/not-empty` otherwise. */
-    delete: ({ folderId }: FolderIdOptions) => Promise<void>;
-    /** Moves a folder under `parentId`, or to the project root with `parentId: null`. */
-    move: ({ folderId, parentId }: MoveFolderOptions) => Promise<Folder>;
-  };
-  /**
-   * Create a named lens at any positive version, or update it with a greater version.
-   * Supplying the same definition and version is idempotent.
-   */
-  ensureLens(options: EnsureLensOptions): Promise<Lens>;
-  /**
-   * Create or update several named lenses. New definitions are sent in one API request, or in
-   * consecutive requests of at most {@link ENSURE_LENSES_MAX_PER_REQUEST} definitions, in order.
-   * Each lens follows the same versioning and idempotency rules as ensureLens().
-   */
-  ensureLenses({ lenses }: EnsureLensesOptions): Promise<Lens[]>;
-  private submitEnsureLenses;
-  private submitEnsureLensesChunk;
-}
-//#endregion
-//#region src/client/CalmLensWebhooks.d.ts
+import { a as selectModerationContextItems, i as ModerationContextItem, n as MODERATION_CONTEXT_USED_CHARACTERS, o as HashList, r as MODERATION_CONTEXT_USED_ITEMS, s as HashListEntry, t as ModerationContext } from "./ModerationContext-9lGm-Mna-CcmbRnOy.js";
+import { $ as IterateAssetsOptions, $t as ExtractedText, A as ClassifyTextOptions, At as WebhookPayloadInput, B as EnsureLensesOptions, Bt as EventSeverity, C as BatchAssetsResponse, Ct as UploadAssetPartOptions, D as CdnResource, Dt as ViewerClaims, E as CdnAssetUrlOptions, Et as VerifyWebhookSignatureOptions, F as CreateMultipartUploadPartOptions, Ft as TypedEvent, G as HashListEntryIdOptions, Gt as Order, H as FolderIdOptions, I as DecideAssetOptions, It as EventCategory, J as HashListPage, Jt as AssetSearchQuery, K as HashListEntryPage, Kt as LensType, L as DeleteAssetContentOptions, Lt as EventFact, M as CreateAssetSignedUrlOptions, Mt as GetEventsResponse, N as CreateFolderOptions, O as CdnServeOptions, Ot as WaitForAssetDecisionOptions, P as CreateHashListOptions, Pt as EventAsset, Q as IterateAssetChildrenOptions, Qt as AssetSafetyHoldReason, R as DeleteAssetOptions, Rt as EventFactValues, S as BatchAssetsOptions, St as UpdateHashListOptions, T as CalmLensServerClientOptions, Tt as UploadedAsset, Ut as Folder, V as ExplainAssetOptions, Vt as EventType, W as GetAssetUrlOptions, Wt as CursorPage, X as ImageTransform, Xt as AssetImage, Y as IdempotencyOptions, Z as ImageTransformOptions, Zt as AssetSafetyHold, _ as AssetSearchResult, _t as SignedUploadToken, a as AssetClassification, b as AssetUploadStatus, bt as UpdateAssetOptions, c as AssetContent, ct as MoveAssetOptions, d as AssetContentStatus, dt as MultipartUploadPartOptions, en as FileMetadata, et as Lens, f as AssetModeration, ft as RequestOptions, g as AssetSearchResponse, gt as SignUploadTokenOptions, h as AssetPage, ht as SearchAssetsOptions, i as AssetChildrenPage, it as ListEventsOptions, j as ConnectionOptions, jt as AssetBatchOperation, k as CdnTransform, kt as WebhookHeadersInput, l as AssetContentOptions, lt as MoveFolderOptions, m as AssetModerationStatus, mt as RetryAssetOptions, n as Asset, nn as ProcessingOptions, nt as ListAssetChildrenOptions, o as AssetClassificationFailureReason, ot as ListHashListEntriesOptions, p as AssetModerationDecision, pt as RetrieveAssetOptions, q as HashListIdOptions, qt as AssetSearchMatchField, r as AssetChecksums, rt as ListAssetsOptions, s as AssetClassificationStatus, st as ListHashListsOptions, t as AddHashListEntryOptions, tn as MetadataItem, tt as LensTransform, u as AssetContentRemovalReason, ut as MultipartUploadOptions, v as AssetType, vt as SignedUrl, w as CalmLensAppClientOptions, wt as UploadPresetSubmitAssetOptions, x as AssetVisibility, xt as UpdateFolderOptions, y as AssetUpload, yt as SubmitAssetOptions, z as EnsureLensOptions, zt as EventFacts } from "./CalmLensTypes-9Vt16pc7.js";
+import { a as CalmLensErrorCode, c as SdkErrorCode, i as CalmLensError, l as ApiErrorCode, o as CalmLensErrorDetails, r as CALMLENS_ERROR_CODES, s as CalmLensErrorOptions, t as ReceivedWebhookEventPayload } from "./WebhookPayload-2aL31v0J.js";
+import { a as ProcessingFeatureId, c as ProcessingFeatures, d as getAssetUrl, i as DetectedPerson, l as SDK_VERSION, n as BoundingBox, o as ProcessingFeatureResults, r as DetectedFace, s as ProcessingFeatureStage, t as AgeRange, u as DEFAULT_CDN_BASE_URL } from "./index-CI4BzN4W.js";
+import { a as ClassificationNotEvaluatedReason, c as ModerationQualifier, i as ClassificationLabel, l as PolicyAction, n as ClassificationCategory, o as ClassificationQualifierResults, r as ClassificationCategoryReport, s as Likelihood, t as ClassificationCategories } from "./Classification-94kSYWZw-CMnQKW13.js";
+import { t as CalmLensServerClient } from "./CalmLensServerClient-JtP687a3.js";
 export declare const WEBHOOK_DELIVERY_HEADER = "x-calmlens-delivery";
 export declare const WEBHOOK_TIMESTAMP_HEADER = "x-calmlens-timestamp";
 export declare const WEBHOOK_SIGNATURE_HEADER = "x-calmlens-signature";
@@ -208,5 +25,9 @@ export declare function verifyWebhookSignature(options: VerifyWebhookSignatureOp
  * so keep a default branch when you switch on `type`.
  */
 export declare function parseWebhookEvent(options: VerifyWebhookSignatureOptions): Promise<ReceivedWebhookEventPayload>;
-//#endregion
-export { type AgeRange, type ApiErrorCode, type Asset, type AssetChecksums, type AssetChildrenPage, type AssetContent, type AssetContentOptions, type AssetContentRemovalReason, type AssetContentStatus, type AssetModeration, type AssetModerationAction, type AssetModerationStatus, type AssetPage, type AssetProcessing, type AssetProcessingStatus, type AssetReviewerAction, type AssetSafetyHold, type AssetSafetyHoldReason, type AssetSearchMatchField, type AssetSearchQuery, type AssetSearchResponse, type AssetSearchResult, type AssetType, type AssetVisibility, type BoundingBox, CALMLENS_ERROR_CODES, type CalmLensAppClientOptions, CalmLensError, type CalmLensErrorCode, type CalmLensErrorDetails, type CalmLensErrorOptions, CalmLensServerClient, type CalmLensServerClientOptions, type CdnAssetUrlOptions, type CdnServeOptions, type CdnTransform, type ClassificationCategories, type ClassificationCategory, type ClassificationCategoryReport, type ClassificationLabel, type ClassificationNotEvaluatedReason, type ClassificationQualifierResults, type ClassificationReport, type ConnectionOptions, type CreateAssetSignedUrlOptions, type CreateFolderOptions, type CreateMultipartUploadPartOptions, type CursorPage, type DeleteAssetContentOptions, type DeleteAssetOptions, type DetectedFace, type DetectedPerson, type EnsureLensOptions, type EnsureLensesOptions, type EventAsset, type EventCategory, type EventFact, type EventFactValues, type EventFacts, type EventSeverity, type EventType, type GetEventsResponse as EventsPage, type ExtractedText, type FlaggedContentAction, type FlaggedContentPolicy, type Folder, type FolderIdOptions, type IdempotencyOptions, type ImageData, type ImageTransform, type ImageTransformOptions, type IterateAssetChildrenOptions, type IterateAssetsOptions, type Lens, type LensTransform, type LensType, type Likelihood, type ListAssetChildrenOptions, type ListAssetsOptions, type ListEventsOptions, type MetadataItem, type ModerateTextOptions, type ModerationQualifier, type MoveAssetOptions, type MoveFolderOptions, type MultipartUploadOptions, type MultipartUploadPartOptions, type Order, type PreviewImage, type ProcessingFeatureId, type ProcessingFeatureResults, type ProcessingFeatureStage, type ProcessingFeatures, type ProcessingOptions, type RequestOptions, type RetrieveAssetOptions, type RetryAssetOptions, SDK_VERSION, type SdkErrorCode, type SearchAssetsOptions, type SignUploadTokenOptions, type SignedUploadToken, type SignedUrl, type SubmitAssetOptions, type TypedEvent, type UpdateAssetOptions, type UpdateFolderOptions, type UploadAssetPartOptions, type UploadPresetSubmitAssetOptions, type UploadedAsset, type VerifyWebhookSignatureOptions, type WaitForAssetDecisionOptions, type ReceivedWebhookEventPayload as WebhookEventPayload, type WebhookHeadersInput, type WebhookPayloadInput };
+/**
+ * Whether a webhook event is a test send from the portal or the CLI rather than a real event: it
+ * carries the registered `{ key: "test", value: true }` fact.
+ */
+export declare const isTestWebhookEvent: (event: Pick<ReceivedWebhookEventPayload, "facts">) => boolean;
+export { type AddHashListEntryOptions, type AgeRange, type ApiErrorCode, type Asset, type AssetBatchOperation, type AssetChecksums, type AssetChildrenPage, type AssetClassification, type AssetClassificationFailureReason, type AssetClassificationStatus, type AssetContent, type AssetContentOptions, type AssetContentRemovalReason, type AssetContentStatus, type AssetImage, type AssetModeration, type AssetModerationDecision, type AssetModerationStatus, type AssetPage, type AssetSafetyHold, type AssetSafetyHoldReason, type AssetSearchMatchField, type AssetSearchQuery, type AssetSearchResponse, type AssetSearchResult, type AssetType, type AssetUpload, type AssetUploadStatus, type AssetVisibility, type BatchAssetsOptions, type BatchAssetsResponse, type BoundingBox, CALMLENS_ERROR_CODES, type CalmLensAppClientOptions, CalmLensError, type CalmLensErrorCode, type CalmLensErrorDetails, type CalmLensErrorOptions, CalmLensServerClient, type CalmLensServerClientOptions, type CdnAssetUrlOptions, type CdnResource, type CdnServeOptions, type CdnTransform, type ClassificationCategories, type ClassificationCategory, type ClassificationCategoryReport, type ClassificationLabel, type ClassificationNotEvaluatedReason, type ClassificationQualifierResults, type ClassifyTextOptions, type ConnectionOptions, type CreateAssetSignedUrlOptions, type CreateFolderOptions, type CreateHashListOptions, type CreateMultipartUploadPartOptions, type CursorPage, DEFAULT_CDN_BASE_URL, type DecideAssetOptions, type DeleteAssetContentOptions, type DeleteAssetOptions, type DetectedFace, type DetectedPerson, type EnsureLensOptions, type EnsureLensesOptions, type EventAsset, type EventCategory, type EventFact, type EventFactValues, type EventFacts, type EventSeverity, type EventType, type GetEventsResponse as EventsPage, type ExplainAssetOptions, type ExtractedText, type FileMetadata, type Folder, type FolderIdOptions, type GetAssetUrlOptions, type HashList, type HashListEntry, type HashListEntryIdOptions, type HashListEntryPage, type HashListIdOptions, type HashListPage, type IdempotencyOptions, type ImageTransform, type ImageTransformOptions, type IterateAssetChildrenOptions, type IterateAssetsOptions, type Lens, type LensTransform, type LensType, type Likelihood, type ListAssetChildrenOptions, type ListAssetsOptions, type ListEventsOptions, type ListHashListEntriesOptions, type ListHashListsOptions, MODERATION_CONTEXT_USED_CHARACTERS, MODERATION_CONTEXT_USED_ITEMS, type MetadataItem, type ModerationContext, type ModerationContextItem, type ModerationQualifier, type MoveAssetOptions, type MoveFolderOptions, type MultipartUploadOptions, type MultipartUploadPartOptions, type Order, type PolicyAction, type ProcessingFeatureId, type ProcessingFeatureResults, type ProcessingFeatureStage, type ProcessingFeatures, type ProcessingOptions, type RequestOptions, type RetrieveAssetOptions, type RetryAssetOptions, SDK_VERSION, type SdkErrorCode, type SearchAssetsOptions, type SignUploadTokenOptions, type SignedUploadToken, type SignedUrl, type SubmitAssetOptions, type TypedEvent, type UpdateAssetOptions, type UpdateFolderOptions, type UpdateHashListOptions, type UploadAssetPartOptions, type UploadPresetSubmitAssetOptions, type UploadedAsset, type VerifyWebhookSignatureOptions, type ViewerClaims, type WaitForAssetDecisionOptions, type ReceivedWebhookEventPayload as WebhookEventPayload, type WebhookHeadersInput, type WebhookPayloadInput, getAssetUrl, selectModerationContextItems };