@calmlens/sdk 0.10.1 → 0.12.0

package/esm/app.d.ts

@@ -0,0 +1,43 @@
+import { $ as SearchAssetsOptions, A as DeleteAssetContentOptions, At as AssetSafetyHold, B as Lens, C as CdnAssetUrlOptions, Ct as EventType, D as CreateAssetSignedUrlOptions, Dt as AssetSearchMatchField, E as ConnectionOptions, Et as LensType, F as IdempotencyOptions, Ft as MetadataItem, G as ModerateTextOptions, H as ListAssetChildrenOptions, I as ImageTransform, It as PreviewImage, J as MultipartUploadOptions, K as MoveAssetOptions, L as ImageTransformOptions, Lt as ProcessingOptions, M as EnsureLensOptions, Mt as DocumentData, N as EnsureLensesOptions, Nt as ExtractedText, O as CreateFolderOptions, Ot as AssetSearchQuery, P as FolderIdOptions, Pt as ImageData, Q as RetryAssetOptions, R as IterateAssetChildrenOptions, S as CalmLensServerClientOptions, St as EventSeverity, T as CdnTransform, Tt as Page, U as ListAssetsOptions, V as LensTransform, W as ListEventsOptions, X as RequestOptions, Y as MultipartUploadPartOptions, Z as RetrieveAssetOptions, _ as AssetSearchResult, _t as TypedEvent, a as ClassificationLabel, at as UpdateFolderOptions, b as AssetVisibility, bt as EventFactValues, c as ClassificationReport, ct as UploadedAsset, d as Asset, dt as WebhookPayloadInput, et as SignUploadTokenOptions, f as AssetChecksums, ft as GetEventsResponse, g as AssetSearchResponse, gt as EventAsset, h as AssetPage, i as ClassificationCategoryReport, it as UpdateAssetOptions, j as DeleteAssetOptions, jt as AssetSafetyHoldReason, k as CreateMultipartUploadPartOptions, l as Likelihood, lt as VerifyWebhookSignatureOptions, m as AssetContentOptions, mt as Folder, n as ClassificationCategories, nt as SignedUrl, o as ClassificationNotEvaluatedReason, ot as UploadAssetPartOptions, p as AssetChildrenPage, q as MoveFolderOptions, r as ClassificationCategory, rt as SubmitAssetOptions, s as ClassificationQualifierResults, st as UploadPresetSubmitAssetOptions, t as WebhookEventPayload, tt as SignedUploadToken, u as ModerationQualifier, ut as WebhookHeadersInput, v as AssetStatus, vt as EventCategory, w as CdnServeOptions, wt as Order, x as CalmLensAppClientOptions, xt as EventFacts, y as AssetType, yt as EventFact, z as IterateAssetsOptions } from "./WebhookPayload-Cgb32aSH.js";
+import { _ as ProcessingFeatureStage, a as CalmLensErrorDetails, c as ApiErrorCode, d as AgeRange, f as BoundingBox, g as ProcessingFeatureResults, h as ProcessingFeatureId, i as CalmLensErrorCode, l as FlaggedContentAction, m as DetectedPerson, n as CALMLENS_ERROR_CODES, o as CalmLensErrorOptions, p as DetectedFace, r as CalmLensError, s as SdkErrorCode, t as SDK_VERSION, u as FlaggedContentPolicy, v as ProcessingFeatures } from "./index-BgmWj3KL.js";
+//#region src/client/CalmLensAppClient.d.ts
+declare const inspectSymbol: unique symbol;
+/**
+ * The CalmLens client for browsers and React Native apps. It uploads through an upload preset,
+ * with an upload token from your server when the preset requires one, and never holds an API
+ * key. It can upload (`assets.create`, `assets.moderate`, `assets.uploadPart`) and check its own
+ * uploads (`assets.retrieve`). Every method throws `CalmLensError` on failure.
+ */
+declare class CalmLensAppClient {
+  #private;
+  constructor(options: CalmLensAppClientOptions);
+  /** Keeps tokens out of `console.log`, `util.inspect` and `JSON.stringify`. */
+  [inspectSymbol](): string;
+  toJSON(): {
+    uploadPresetId: string;
+    baseUrl: string;
+  };
+  private get uploadsPath();
+  /** A fresh token for a new upload, when the client has one. */
+  private newUploadToken;
+  /** The `Authorization` header for an upload this client started. */
+  private authHeaders;
+  /** Uploads with a new token, kept for the upload's parts and status checks. */
+  private submit;
+  /** Uploads through the client's upload preset and checks those uploads. */
+  get assets(): {
+    /** Uploads a file and queues it for moderation. */
+    create: (options: UploadPresetSubmitAssetOptions) => Promise<UploadedAsset>;
+    /** Uploads a file and waits for its moderation decision. */
+    moderate: (options: UploadPresetSubmitAssetOptions) => Promise<UploadedAsset>;
+    /**
+     * Uploads the next part of a multipart upload this client started. The upload's queue
+     * mode, chosen when it started, applies when the final part arrives.
+     */
+    uploadPart: ({ assetId, ...options }: UploadAssetPartOptions) => Promise<UploadedAsset>;
+    /** Checks an upload this client made. `status` is present when the preset shows decisions. */
+    retrieve: ({ assetId }: RetrieveAssetOptions) => Promise<UploadedAsset>;
+  };
+}
+//#endregion
+export { type AgeRange, type ApiErrorCode, type Asset, type AssetChecksums, type AssetChildrenPage, type AssetContentOptions, type AssetPage, type AssetSafetyHold, type AssetSafetyHoldReason, type AssetSearchMatchField, type AssetSearchQuery, type AssetSearchResponse, type AssetSearchResult, type AssetStatus, type AssetType, type AssetVisibility, type BoundingBox, CALMLENS_ERROR_CODES, CalmLensAppClient, type CalmLensAppClientOptions, CalmLensError, type CalmLensErrorCode, type CalmLensErrorDetails, type CalmLensErrorOptions, 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 DeleteAssetContentOptions, type DeleteAssetOptions, type DetectedFace, type DetectedPerson, type DocumentData, 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 Page, 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 WebhookEventPayload, type WebhookHeadersInput, type WebhookPayloadInput };

package/esm/app.js

@@ -0,0 +1,87 @@
+import { a as invalidConfig, i as invalidArgument, n as CalmLensError, t as CALMLENS_ERROR_CODES } from "./CalmLensError-CihGG26K.js";
+import { t as SDK_VERSION } from "./src-CJhrILvM.js";
+import { n as encodePathSegment, s as validateAppClientOptions } from "./CalmLensUtils-Cx32j2zt.js";
+import { o as prepareSubmitAssetOptions, r as expectUploadedAsset, s as resolveConnectionOptions, t as CalmLensConnection } from "./CalmLensConnection-wLNy0OIP.js";
+//#region src/client/CalmLensAppClient.ts
+const inspectSymbol = Symbol.for("nodejs.util.inspect.custom");
+/**
+* The CalmLens client for browsers and React Native apps. It uploads through an upload preset,
+* with an upload token from your server when the preset requires one, and never holds an API
+* key. It can upload (`assets.create`, `assets.moderate`, `assets.uploadPart`) and check its own
+* uploads (`assets.retrieve`). Every method throws `CalmLensError` on failure.
+*/
+var CalmLensAppClient = class {
+	#uploadPresetId;
+	#token;
+	/** The token each upload started with, for its parts and status checks. */
+	#uploadTokens = /* @__PURE__ */ new Map();
+	#connection;
+	constructor(options) {
+		validateAppClientOptions(options);
+		const { token, uploadPresetId, ...rest } = options;
+		this.#uploadPresetId = uploadPresetId;
+		this.#token = token;
+		this.#connection = new CalmLensConnection(resolveConnectionOptions(rest));
+	}
+	/** Keeps tokens out of `console.log`, `util.inspect` and `JSON.stringify`. */
+	[inspectSymbol]() {
+		return `CalmLensAppClient { uploadPresetId: ${JSON.stringify(this.#uploadPresetId)}, baseUrl: ${JSON.stringify(this.#connection.options.baseUrl)} }`;
+	}
+	toJSON() {
+		return {
+			uploadPresetId: this.#uploadPresetId,
+			baseUrl: this.#connection.options.baseUrl
+		};
+	}
+	get uploadsPath() {
+		return `/upload-presets/${encodeURIComponent(this.#uploadPresetId)}/assets`;
+	}
+	/** A fresh token for a new upload, when the client has one. */
+	async newUploadToken() {
+		const token = typeof this.#token === "function" ? await this.#token() : this.#token;
+		if (token !== void 0 && (typeof token !== "string" || !token)) throw invalidConfig("token must return a non-empty string");
+		return token;
+	}
+	/** The `Authorization` header for an upload this client started. */
+	authHeaders(assetId) {
+		const token = this.#uploadTokens.get(assetId);
+		return token ? { Authorization: `Bearer ${token}` } : {};
+	}
+	/** Uploads with a new token, kept for the upload's parts and status checks. */
+	async submit(options, queue) {
+		if (!options || typeof options !== "object") throw invalidArgument("Upload options are required");
+		if (!("content" in options) && !("part" in options)) throw invalidArgument("Uploads through an upload preset need content or a part");
+		prepareSubmitAssetOptions(options);
+		const token = await this.newUploadToken();
+		const data = await this.#connection.submitRawUpload(this.uploadsPath, options, queue, token ? { Authorization: `Bearer ${token}` } : {});
+		const uploaded = expectUploadedAsset(data);
+		if (token) this.#uploadTokens.set(uploaded.id, token);
+		return uploaded;
+	}
+	/** Uploads through the client's upload preset and checks those uploads. */
+	get assets() {
+		return {
+			/** Uploads a file and queues it for moderation. */
+			create: (options) => this.submit(options, true),
+			/** Uploads a file and waits for its moderation decision. */
+			moderate: (options) => this.submit(options, false),
+			/**
+			* Uploads the next part of a multipart upload this client started. The upload's queue
+			* mode, chosen when it started, applies when the final part arrives.
+			*/
+			uploadPart: async ({ assetId, ...options }) => {
+				const encodedAssetId = encodePathSegment(assetId, "Asset ID");
+				const data = await this.#connection.uploadPart(`${this.uploadsPath}/${encodedAssetId}/part`, options, this.authHeaders(assetId));
+				return expectUploadedAsset(data);
+			},
+			/** Checks an upload this client made. `status` is present when the preset shows decisions. */
+			retrieve: async ({ assetId }) => {
+				const encodedAssetId = encodePathSegment(assetId, "Asset ID");
+				const data = await this.#connection.json("GET", `${this.uploadsPath}/${encodedAssetId}`, { headers: this.authHeaders(assetId) });
+				return expectUploadedAsset(data);
+			}
+		};
+	}
+};
+//#endregion
+export { CALMLENS_ERROR_CODES, CalmLensAppClient, CalmLensError, SDK_VERSION };

package/esm/index-BgmWj3KL.d.ts

@@ -0,0 +1,350 @@
+import "./WebhookPayload-Cgb32aSH.js";
+import * as zod from "zod";
+//#region ../shared/src/ProcessingFeatures.d.ts
+/**
+ * Optional analyses a request can turn on with `processingOptions.features.<id>`. The catalog is
+ * the single source for the request and result schemas, cache keys and metering. Features are
+ * chosen per request only; there is no project-level default.
+ */
+/** How mature a feature is. Beta results may change shape. */
+declare const PROCESSING_FEATURE_STAGES: readonly ["beta", "ga"];
+type ProcessingFeatureStage = (typeof PROCESSING_FEATURE_STAGES)[number];
+declare const PROCESSING_FEATURE_IDS: readonly ["ocr", "personDetection", "faceDetection"];
+type ProcessingFeatureId = (typeof PROCESSING_FEATURE_IDS)[number];
+declare const PROCESSING_FEATURES_SCHEMA: zod.ZodObject<{
+  ocr: zod.ZodOptional<zod.ZodNullable<zod.ZodObject<{
+    enabled: zod.ZodBoolean;
+  }, zod.core.$strict>>>;
+  personDetection: zod.ZodOptional<zod.ZodNullable<zod.ZodObject<{
+    enabled: zod.ZodBoolean;
+  }, zod.core.$strict>>>;
+  faceDetection: zod.ZodOptional<zod.ZodNullable<zod.ZodObject<{
+    enabled: zod.ZodBoolean;
+    ageEstimation: zod.ZodOptional<zod.ZodBoolean>;
+  }, zod.core.$strict>>>;
+}, zod.core.$strict>;
+type ProcessingFeatures = zod.infer<typeof PROCESSING_FEATURES_SCHEMA>;
+/** Position and size as fractions of the image width and height, from 0 to 1. */
+declare const BOUNDING_BOX_SCHEMA: zod.ZodObject<{
+  left: zod.ZodNumber;
+  top: zod.ZodNumber;
+  width: zod.ZodNumber;
+  height: zod.ZodNumber;
+}, zod.core.$strict>;
+type BoundingBox = zod.infer<typeof BOUNDING_BOX_SCHEMA>;
+declare const AGE_RANGE_SCHEMA: zod.ZodObject<{
+  low: zod.ZodNumber;
+  high: zod.ZodNumber;
+}, zod.core.$strict>;
+type AgeRange = zod.infer<typeof AGE_RANGE_SCHEMA>;
+declare const DETECTED_PERSON_SCHEMA: zod.ZodObject<{
+  box: zod.ZodObject<{
+    left: zod.ZodNumber;
+    top: zod.ZodNumber;
+    width: zod.ZodNumber;
+    height: zod.ZodNumber;
+  }, zod.core.$strict>;
+  confidence: zod.ZodNumber;
+}, zod.core.$strict>;
+type DetectedPerson = zod.infer<typeof DETECTED_PERSON_SCHEMA>;
+declare const DETECTED_FACE_SCHEMA: zod.ZodObject<{
+  box: zod.ZodObject<{
+    left: zod.ZodNumber;
+    top: zod.ZodNumber;
+    width: zod.ZodNumber;
+    height: zod.ZodNumber;
+  }, zod.core.$strict>;
+  confidence: zod.ZodNumber;
+  ageRange: zod.ZodOptional<zod.ZodObject<{
+    low: zod.ZodNumber;
+    high: zod.ZodNumber;
+  }, zod.core.$strict>>;
+}, zod.core.$strict>;
+type DetectedFace = zod.infer<typeof DETECTED_FACE_SCHEMA>;
+declare const PROCESSING_FEATURE_RESULTS_SCHEMA: zod.ZodObject<{
+  personDetection: zod.ZodOptional<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+    status: zod.ZodLiteral<"evaluated">;
+    stage: zod.ZodEnum<{
+      beta: "beta";
+      ga: "ga";
+    }>;
+    people: zod.ZodArray<zod.ZodObject<{
+      box: zod.ZodObject<{
+        left: zod.ZodNumber;
+        top: zod.ZodNumber;
+        width: zod.ZodNumber;
+        height: zod.ZodNumber;
+      }, zod.core.$strict>;
+      confidence: zod.ZodNumber;
+    }, zod.core.$strict>>;
+  }, zod.core.$strict>, zod.ZodObject<{
+    status: zod.ZodLiteral<"not-evaluated">;
+    stage: zod.ZodEnum<{
+      beta: "beta";
+      ga: "ga";
+    }>;
+    reason: zod.ZodEnum<{
+      "not-supported": "not-supported";
+      unavailable: "unavailable";
+    }>;
+  }, zod.core.$strict>], "status">>;
+  faceDetection: zod.ZodOptional<zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+    status: zod.ZodLiteral<"evaluated">;
+    stage: zod.ZodEnum<{
+      beta: "beta";
+      ga: "ga";
+    }>;
+    faces: zod.ZodArray<zod.ZodObject<{
+      box: zod.ZodObject<{
+        left: zod.ZodNumber;
+        top: zod.ZodNumber;
+        width: zod.ZodNumber;
+        height: zod.ZodNumber;
+      }, zod.core.$strict>;
+      confidence: zod.ZodNumber;
+      ageRange: zod.ZodOptional<zod.ZodObject<{
+        low: zod.ZodNumber;
+        high: zod.ZodNumber;
+      }, zod.core.$strict>>;
+    }, zod.core.$strict>>;
+  }, zod.core.$strict>, zod.ZodObject<{
+    status: zod.ZodLiteral<"not-evaluated">;
+    stage: zod.ZodEnum<{
+      beta: "beta";
+      ga: "ga";
+    }>;
+    reason: zod.ZodEnum<{
+      "not-supported": "not-supported";
+      unavailable: "unavailable";
+    }>;
+  }, zod.core.$strict>], "status">>;
+}, zod.core.$strict>;
+type ProcessingFeatureResults = zod.infer<typeof PROCESSING_FEATURE_RESULTS_SCHEMA>;
+//#endregion
+//#region ../shared/src/Project.d.ts
+declare const FLAGGED_CONTENT_ACTION_SCHEMA: zod.ZodEnum<{
+  alert: "alert";
+  hide: "hide";
+  ignore: "ignore";
+  purge: "purge";
+}>;
+type FlaggedContentAction = zod.infer<typeof FLAGGED_CONTENT_ACTION_SCHEMA>;
+declare const FLAGGED_CONTENT_POLICY_SCHEMA: zod.ZodObject<{
+  action: zod.ZodEnum<{
+    alert: "alert";
+    hide: "hide";
+    ignore: "ignore";
+    purge: "purge";
+  }>;
+}, zod.core.$strip>;
+type FlaggedContentPolicy = zod.infer<typeof FLAGGED_CONTENT_POLICY_SCHEMA>;
+//#endregion
+//#region src/client/CalmLensErrorCodes.d.ts
+/** Error codes the CalmLens API documents, by name. */
+declare const API_ERROR_CODES: {
+  readonly MISSING_TOKEN: "auth/missing-token";
+  readonly INVALID_API_KEY: "auth/invalid-api-key";
+  readonly API_KEY_PROJECT_MISMATCH: "auth/project-mismatch";
+  readonly API_KEY_NOT_ACCEPTED: "auth/api-key-not-accepted";
+  readonly FILE_TOO_LARGE: "upload/file-too-large";
+  readonly IMAGE_REQUIRES_MULTIPART_UPLOAD: "upload/image-requires-multipart-upload";
+  readonly MULTIPART_IMAGE_TOO_SMALL: "upload/multipart-image-too-small";
+  readonly MULTIPART_IMAGE_TOO_LARGE: "upload/multipart-image-too-large";
+  readonly IMAGE_EXCEEDED_MAX_DIMENSIONS: "upload/image-exceeded-max-dimensions";
+  readonly UPLOAD_LIMIT_EXCEEDED: "upload/limit-exceeded";
+  readonly INVALID_UPLOAD_MIME_TYPE: "upload/invalid-mime-type";
+  readonly INVALID_EVENT_CURSOR: "events/invalid-cursor";
+  readonly INVALID_UPLOAD_PAYLOAD: "upload/invalid-payload";
+  readonly USE_UPLOAD_PART: "upload/use-upload-part";
+  readonly UPLOAD_NOT_OPEN: "upload/not-open";
+  readonly INVALID_UPLOAD_PART_NUMBER: "upload/invalid-part-number";
+  readonly UPLOAD_MISSING: "upload/missing";
+  readonly UPLOAD_SIZE_MISMATCH: "upload/size-mismatch";
+  readonly INVALID_IDEMPOTENCY_KEY: "idempotency/invalid-key";
+  readonly IDEMPOTENCY_KEY_REUSED: "idempotency/key-reused";
+  readonly IDEMPOTENT_REQUEST_IN_PROGRESS: "idempotency/request-in-progress";
+  readonly ASSET_NOT_FOUND: "asset/not-found";
+  readonly PROJECT_NOT_FOUND: "project/not-found";
+  readonly ASSET_UPDATE_FAILED: "asset/update-failed";
+  readonly ASSET_SAFETY_HELD: "asset/safety-held";
+  readonly ASSET_NOT_RETRYABLE: "asset/not-retryable";
+  readonly ASSET_CONTENT_UNAVAILABLE: "asset/content-unavailable";
+  readonly SUPPORT_TICKET_NOT_FOUND: "support/ticket-not-found";
+  readonly DUPLICATE_EXTERNAL_ID: "asset/duplicate-external-id";
+  readonly FOLDER_NOT_FOUND: "folder/not-found";
+  readonly DUPLICATE_FOLDER_NAME: "folder/duplicate-name";
+  readonly FOLDER_NOT_EMPTY: "folder/not-empty";
+  readonly FOLDER_PARENT_CYCLE: "folder/parent-cycle";
+  readonly LENS_VERSION_CONFLICT: "lens/version-conflict";
+  readonly UPLOAD_PRESET_NOT_FOUND: "upload-preset/not-found";
+  readonly UPLOAD_PRESET_DISABLED: "upload-preset/disabled";
+  readonly UPLOAD_PRESET_TOKEN_REQUIRED: "upload-preset/token-required";
+  readonly UPLOAD_PRESET_CONTENT_TYPE_NOT_ALLOWED: "upload-preset/content-type-not-allowed";
+  readonly UPLOAD_PRESET_TOO_LARGE: "upload-preset/too-large";
+  readonly UPLOAD_PRESET_DAILY_LIMIT_REACHED: "upload-preset/daily-limit-reached";
+  readonly UPLOAD_PRESET_ORIGIN_NOT_ALLOWED: "upload-preset/origin-not-allowed";
+  readonly UPLOAD_PRESET_FIELD_NOT_ALLOWED: "upload-preset/field-not-allowed";
+  readonly UPLOAD_TOKEN_INVALID: "upload-token/invalid";
+  readonly UPLOAD_TOKEN_EXPIRED: "upload-token/expired";
+  readonly UPLOAD_TOKEN_USED: "upload-token/used";
+};
+type ApiErrorCode = (typeof API_ERROR_CODES)[keyof typeof API_ERROR_CODES];
+//#endregion
+//#region src/client/CalmLensError.d.ts
+type CalmLensErrorDetails = Record<string, unknown>;
+/** Codes for failures the SDK detects itself, before or instead of an API error response. */
+declare const SDK_ERROR_CODES: {
+  /** The request could not be completed: DNS, TLS, a refused or reset connection, a truncated body. */
+  readonly TRANSPORT_ERROR: "sdk/transport-error";
+  /** The request did not finish within `timeoutMs`. */
+  readonly TIMEOUT: "sdk/timeout";
+  /** The caller's `AbortSignal` cancelled the request. */
+  readonly CANCELLED: "sdk/cancelled";
+  /** A successful response whose body is not the JSON the operation returns. */
+  readonly INVALID_RESPONSE: "sdk/invalid-response";
+  /** An HTTP failure without a CalmLens error body, for example from a proxy. */
+  readonly HTTP_ERROR: "sdk/http-error";
+  /** A response body larger than `maxResponseBytes`. */
+  readonly RESPONSE_TOO_LARGE: "sdk/response-too-large";
+  /** A method argument is missing or invalid, for example an empty asset ID. */
+  readonly INVALID_ARGUMENT: "sdk/invalid-argument";
+  /** The client options are invalid, for example a missing API key. */
+  readonly INVALID_CONFIG: "sdk/invalid-config";
+  /** No `fetch` implementation is available in this runtime. */
+  readonly NO_FETCH: "sdk/no-fetch";
+  /** A webhook delivery whose signature or timestamp did not verify. */
+  readonly INVALID_WEBHOOK_SIGNATURE: "sdk/invalid-webhook-signature";
+  /** A verified webhook delivery whose body is not a webhook event. */
+  readonly INVALID_WEBHOOK_PAYLOAD: "sdk/invalid-webhook-payload";
+};
+type SdkErrorCode = (typeof SDK_ERROR_CODES)[keyof typeof SDK_ERROR_CODES];
+/** Every error code the SDK can throw: the documented API codes and the SDK's own `sdk/*` codes. */
+declare const CALMLENS_ERROR_CODES: {
+  readonly MISSING_TOKEN: "auth/missing-token";
+  readonly INVALID_API_KEY: "auth/invalid-api-key";
+  readonly API_KEY_PROJECT_MISMATCH: "auth/project-mismatch";
+  readonly API_KEY_NOT_ACCEPTED: "auth/api-key-not-accepted";
+  readonly FILE_TOO_LARGE: "upload/file-too-large";
+  readonly IMAGE_REQUIRES_MULTIPART_UPLOAD: "upload/image-requires-multipart-upload";
+  readonly MULTIPART_IMAGE_TOO_SMALL: "upload/multipart-image-too-small";
+  readonly MULTIPART_IMAGE_TOO_LARGE: "upload/multipart-image-too-large";
+  readonly IMAGE_EXCEEDED_MAX_DIMENSIONS: "upload/image-exceeded-max-dimensions";
+  readonly UPLOAD_LIMIT_EXCEEDED: "upload/limit-exceeded";
+  readonly INVALID_UPLOAD_MIME_TYPE: "upload/invalid-mime-type";
+  readonly INVALID_EVENT_CURSOR: "events/invalid-cursor";
+  readonly INVALID_UPLOAD_PAYLOAD: "upload/invalid-payload";
+  readonly USE_UPLOAD_PART: "upload/use-upload-part";
+  readonly UPLOAD_NOT_OPEN: "upload/not-open";
+  readonly INVALID_UPLOAD_PART_NUMBER: "upload/invalid-part-number";
+  readonly UPLOAD_MISSING: "upload/missing";
+  readonly UPLOAD_SIZE_MISMATCH: "upload/size-mismatch";
+  readonly INVALID_IDEMPOTENCY_KEY: "idempotency/invalid-key";
+  readonly IDEMPOTENCY_KEY_REUSED: "idempotency/key-reused";
+  readonly IDEMPOTENT_REQUEST_IN_PROGRESS: "idempotency/request-in-progress";
+  readonly ASSET_NOT_FOUND: "asset/not-found";
+  readonly PROJECT_NOT_FOUND: "project/not-found";
+  readonly ASSET_UPDATE_FAILED: "asset/update-failed";
+  readonly ASSET_SAFETY_HELD: "asset/safety-held";
+  readonly ASSET_NOT_RETRYABLE: "asset/not-retryable";
+  readonly ASSET_CONTENT_UNAVAILABLE: "asset/content-unavailable";
+  readonly SUPPORT_TICKET_NOT_FOUND: "support/ticket-not-found";
+  readonly DUPLICATE_EXTERNAL_ID: "asset/duplicate-external-id";
+  readonly FOLDER_NOT_FOUND: "folder/not-found";
+  readonly DUPLICATE_FOLDER_NAME: "folder/duplicate-name";
+  readonly FOLDER_NOT_EMPTY: "folder/not-empty";
+  readonly FOLDER_PARENT_CYCLE: "folder/parent-cycle";
+  readonly LENS_VERSION_CONFLICT: "lens/version-conflict";
+  readonly UPLOAD_PRESET_NOT_FOUND: "upload-preset/not-found";
+  readonly UPLOAD_PRESET_DISABLED: "upload-preset/disabled";
+  readonly UPLOAD_PRESET_TOKEN_REQUIRED: "upload-preset/token-required";
+  readonly UPLOAD_PRESET_CONTENT_TYPE_NOT_ALLOWED: "upload-preset/content-type-not-allowed";
+  readonly UPLOAD_PRESET_TOO_LARGE: "upload-preset/too-large";
+  readonly UPLOAD_PRESET_DAILY_LIMIT_REACHED: "upload-preset/daily-limit-reached";
+  readonly UPLOAD_PRESET_ORIGIN_NOT_ALLOWED: "upload-preset/origin-not-allowed";
+  readonly UPLOAD_PRESET_FIELD_NOT_ALLOWED: "upload-preset/field-not-allowed";
+  readonly UPLOAD_TOKEN_INVALID: "upload-token/invalid";
+  readonly UPLOAD_TOKEN_EXPIRED: "upload-token/expired";
+  readonly UPLOAD_TOKEN_USED: "upload-token/used";
+  /** The request could not be completed: DNS, TLS, a refused or reset connection, a truncated body. */
+  readonly TRANSPORT_ERROR: "sdk/transport-error";
+  /** The request did not finish within `timeoutMs`. */
+  readonly TIMEOUT: "sdk/timeout";
+  /** The caller's `AbortSignal` cancelled the request. */
+  readonly CANCELLED: "sdk/cancelled";
+  /** A successful response whose body is not the JSON the operation returns. */
+  readonly INVALID_RESPONSE: "sdk/invalid-response";
+  /** An HTTP failure without a CalmLens error body, for example from a proxy. */
+  readonly HTTP_ERROR: "sdk/http-error";
+  /** A response body larger than `maxResponseBytes`. */
+  readonly RESPONSE_TOO_LARGE: "sdk/response-too-large";
+  /** A method argument is missing or invalid, for example an empty asset ID. */
+  readonly INVALID_ARGUMENT: "sdk/invalid-argument";
+  /** The client options are invalid, for example a missing API key. */
+  readonly INVALID_CONFIG: "sdk/invalid-config";
+  /** No `fetch` implementation is available in this runtime. */
+  readonly NO_FETCH: "sdk/no-fetch";
+  /** A webhook delivery whose signature or timestamp did not verify. */
+  readonly INVALID_WEBHOOK_SIGNATURE: "sdk/invalid-webhook-signature";
+  /** A verified webhook delivery whose body is not a webhook event. */
+  readonly INVALID_WEBHOOK_PAYLOAD: "sdk/invalid-webhook-payload";
+};
+/**
+ * A known error code. API validation codes (`validation/*`) and codes added to the API after
+ * this SDK version are still delivered as plain strings, so compare against `string`.
+ */
+type CalmLensErrorCode = ApiErrorCode | SdkErrorCode;
+interface CalmLensErrorOptions {
+  message?: string;
+  status?: number;
+  details?: CalmLensErrorDetails;
+  cause?: unknown;
+  /** The `X-Request-Id` response header. */
+  requestId?: string;
+  /** The response headers, when there was a response. */
+  headers?: Headers;
+  /** Seconds to wait before retrying, from the `Retry-After` response header. */
+  retryAfter?: number;
+}
+/**
+ * Every failure the SDK reports, whether the API returned an error or the request never
+ * completed. Branch on `code`; `status`, `requestId`, `headers` and `retryAfter` describe the
+ * HTTP response when there was one, and `cause` holds the underlying error.
+ *
+ * `instanceof CalmLensError` and `CalmLensError.isCalmLensError(value)` both recognise errors
+ * from any copy of the SDK, so they work when ESM and CommonJS builds are loaded side by side.
+ */
+declare class CalmLensError extends Error {
+  /** A stable identifier such as `asset/not-found` or `sdk/timeout`. */
+  readonly code: CalmLensErrorCode | (string & {});
+  /** The HTTP status, when the API responded. */
+  readonly status?: number;
+  /** Structured diagnostics from the API, such as validation issues and `traceId`. */
+  readonly details?: CalmLensErrorDetails;
+  /** The `X-Request-Id` response header. Include it when you contact support. */
+  readonly requestId?: string;
+  /** The response headers, when the API responded. */
+  readonly headers?: Headers;
+  /** Seconds to wait before retrying, from the `Retry-After` response header. */
+  readonly retryAfter?: number;
+  constructor(code: CalmLensErrorCode | (string & {}) | {
+    id: string;
+    defaultMessage?: string;
+  }, options?: CalmLensErrorOptions);
+  /** True for any `CalmLensError`, including one created by another copy or build of the SDK. */
+  static isCalmLensError(value: unknown): value is CalmLensError;
+  static [Symbol.hasInstance](value: unknown): boolean;
+  /** The resource does not exist or is not visible to this API key. */
+  isNotFound(): boolean;
+  /**
+   * Whether repeating the same request may succeed: transport failures, throttling (429),
+   * gateway errors (502, 503, 504) and idempotent requests still in progress. Only repeat a
+   * create or upload with the same `idempotencyKey`.
+   */
+  isRetryable(): boolean;
+}
+//#endregion
+//#region src/client/CalmLensVersion.d.ts
+/** This SDK's version, from its package.json. */
+declare const SDK_VERSION: string;
+//#endregion
+export { ProcessingFeatureStage as _, CalmLensErrorDetails as a, ApiErrorCode as c, AgeRange as d, BoundingBox as f, ProcessingFeatureResults as g, ProcessingFeatureId as h, CalmLensErrorCode as i, FlaggedContentAction as l, DetectedPerson as m, CALMLENS_ERROR_CODES as n, CalmLensErrorOptions as o, DetectedFace as p, CalmLensError as r, SdkErrorCode as s, SDK_VERSION as t, FlaggedContentPolicy as u, ProcessingFeatures as v };