@calmlens/sdk 0.16.3 → 0.18.0

package/cjs/CalmLensUtils-o171ownK.js

@@ -1,699 +0,0 @@
-const require_CalmLensVersion = require("./CalmLensVersion-DwhgxQK5.js");
-//#region src/contract/SharedConstants-Dn7ZJF5S.js
-const MAX_IMAGE_UPLOAD_BYTES = /* @__PURE__ */ (() => 20971520)();
-const MIN_MULTIPART_IMAGE_UPLOAD_BYTES = /* @__PURE__ */ (() => 10485760)();
-const REJECTED_UPLOAD_MIME_TYPE_SET = /* @__PURE__ */ new Set([
-	"application/octet-stream",
-	"multipart/form-data",
-	"multipart/mixed",
-	"multipart/alternative",
-	"multipart/related",
-	"multipart/signed",
-	"multipart/encrypted"
-]);
-const normalizeUploadMimeType = (mimeType) => mimeType.toLowerCase().split(";")[0]?.trim() || mimeType.toLowerCase().trim();
-const isRejectedUploadMimeType = (mimeType) => REJECTED_UPLOAD_MIME_TYPE_SET.has(normalizeUploadMimeType(mimeType));
-const getRejectedUploadMimeTypeError = (mimeType) => `${normalizeUploadMimeType(mimeType)} is not a valid upload file type. Uploads must use a concrete file MIME type that CalmLens can store and process, such as image/png, image/jpeg, application/pdf, or text/plain.`;
-const DOMAIN = "calmlens.com";
-//#endregion
-//#region src/contract/AssetPayload.js
-const uint8ArrayInputToNumbers = (value) => {
-	if (Array.isArray(value)) return value;
-	return Array.from(value);
-};
-const bufferInputToBytes = (value) => {
-	if (value instanceof ArrayBuffer) return new Uint8Array(value);
-	return Uint8Array.from(value);
-};
-const BASE64_PART_BOUNDARY_ERROR = "Invalid base64 part. For multipart uploads, split the original bytes first, then base64-encode each part. Do not split one full base64 string into substrings.";
-const MULTIPART_PART_TOO_SMALL_ERROR = `Multipart upload parts must be at least 5MiB except the final part.`;
-const getRawBase64 = (value) => {
-	const markerIndex = value.indexOf(";base64,");
-	if (markerIndex === -1) return value;
-	return value.slice(markerIndex + 8);
-};
-const validateBase64PayloadString = (payload, options) => {
-	const raw = getRawBase64(payload.base64).replace(/\s/g, "");
-	if (options?.multipart && raw.length % 4 !== 0) return {
-		ok: false,
-		error: BASE64_PART_BOUNDARY_ERROR
-	};
-	return { ok: true };
-};
-const isReadableStream = (value) => typeof value === "object" && value !== null && "getReader" in value && typeof value.getReader === "function";
-const assetToData = (payload) => {
-	if ("plainText" in payload && payload.plainText !== void 0) return new TextEncoder().encode(payload.plainText);
-	if ("data" in payload && payload.data) return payload.data;
-	if ("buffer" in payload) {
-		if (payload.buffer instanceof ArrayBuffer) return payload.buffer;
-		return bufferInputToBytes(payload.buffer);
-	}
-	if (payload.uint8Array !== void 0) return Uint8Array.from(uint8ArrayInputToNumbers(payload.uint8Array));
-	if (payload.base64 === void 0) throw new Error("Invalid asset payload");
-	const raw = getRawBase64(payload.base64);
-	if (typeof Buffer !== "undefined") return Uint8Array.from(Buffer.from(raw, "base64"));
-	const binary = atob(raw);
-	return Uint8Array.from(binary, (char) => char.charCodeAt(0));
-};
-const assetDataToUint8Array = async (data) => {
-	if (data instanceof Response) return new Uint8Array(await data.arrayBuffer());
-	if (isReadableStream(data)) return new Uint8Array(await new Response(data).arrayBuffer());
-	if (data instanceof Blob) return new Uint8Array(await data.arrayBuffer());
-	if (data instanceof ArrayBuffer) return new Uint8Array(data);
-	return data;
-};
-const getAssetPayloadByteLength = (payload) => {
-	if ("plainText" in payload && payload.plainText !== void 0) return new TextEncoder().encode(payload.plainText).byteLength;
-	if ("data" in payload && payload.data) {
-		if (payload.data instanceof Blob) return payload.data.size;
-		if (payload.data instanceof Response) {
-			const contentLength = payload.data.headers.get("content-length");
-			return contentLength ? Number(contentLength) : void 0;
-		}
-		return;
-	}
-	if ("buffer" in payload && payload.buffer) return payload.buffer.byteLength;
-	if (payload.uint8Array !== void 0) {
-		if (Array.isArray(payload.uint8Array)) return payload.uint8Array.length;
-		return payload.uint8Array.byteLength;
-	}
-	if (payload.base64 === void 0) return;
-	const raw = getRawBase64(payload.base64).replace(/\s/g, "");
-	const padding = raw.endsWith("==") ? 2 : raw.endsWith("=") ? 1 : 0;
-	return Math.max(0, Math.floor(raw.length * 3 / 4) - padding);
-};
-const validateAssetPayload = (payload, options) => {
-	if ("base64" in payload && payload.base64 !== void 0) {
-		const validation = validateBase64PayloadString(payload, options);
-		if (!validation.ok) return {
-			ok: false,
-			error: validation.error
-		};
-	}
-	const byteLength = getAssetPayloadByteLength(payload);
-	if (options?.multipart && !options.isFinal && byteLength !== void 0 && byteLength < 5242880) return {
-		ok: false,
-		error: MULTIPART_PART_TOO_SMALL_ERROR
-	};
-	return { ok: true };
-};
-//#endregion
-//#region src/client/CalmLensTransport.ts
-/** Retry delays grow from this base, doubling per attempt, with jitter. */
-const RETRY_BASE_DELAY_MS = 500;
-const RETRY_MAX_DELAY_MS = 8e3;
-/** A `Retry-After` longer than this is returned to the caller instead of waited out. */
-const RETRY_AFTER_MAX_MS = 6e4;
-const RETRYABLE_STATUSES = /* @__PURE__ */ new Set([
-	429,
-	502,
-	503,
-	504
-]);
-const timeoutReason = () => {
-	const reason = /* @__PURE__ */ new Error("The operation timed out.");
-	reason.name = "TimeoutError";
-	return reason;
-};
-/**
-* Links the callers' signals and a per-attempt deadline. `AbortSignal.any` holds its sources
-* weakly, so a long-lived caller signal doesn't collect a listener per streamed response;
-* runtimes without it get explicit listeners that `release` removes.
-*/
-const createAttemptSignal = (signals, timeoutMs) => {
-	const callers = signals.filter((signal) => signal !== void 0);
-	const deadline = new AbortController();
-	let timedOut = false;
-	let signal;
-	let onAbort;
-	if (typeof AbortSignal.any === "function") signal = AbortSignal.any([...callers, deadline.signal]);
-	else {
-		const controller = new AbortController();
-		signal = controller.signal;
-		onAbort = (event) => controller.abort(event.target.reason);
-		for (const source of [...callers, deadline.signal]) if (source.aborted) controller.abort(source.reason);
-		else source.addEventListener("abort", onAbort, { once: true });
-	}
-	let timer = timeoutMs === void 0 ? void 0 : setTimeout(() => {
-		timedOut = true;
-		deadline.abort(timeoutReason());
-	}, timeoutMs);
-	return {
-		signal,
-		isTimedOut: () => timedOut,
-		isCancelled: () => callers.some((caller) => caller.aborted),
-		clearDeadline: () => {
-			if (timer !== void 0) clearTimeout(timer);
-			timer = void 0;
-		},
-		release: () => {
-			if (timer !== void 0) clearTimeout(timer);
-			timer = void 0;
-			if (onAbort) for (const caller of callers) caller.removeEventListener("abort", onAbort);
-		}
-	};
-};
-/**
-* A redirect the SDK must not follow: it would send the API key to another origin. Browsers report
-* a manual redirect as an opaque response; other runtimes return the 3xx with its Location.
-*/
-const isRedirect = (response) => response.type === "opaqueredirect" || response.status >= 300 && response.status < 400 && response.headers.has("location");
-/** Turns anything thrown while sending or reading a request into a `CalmLensError`. */
-const toFailure = (cause, attempt) => {
-	if (require_CalmLensVersion.CalmLensError.isCalmLensError(cause)) return cause;
-	if (attempt.isCancelled()) return new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.CANCELLED, {
-		message: "Request cancelled",
-		cause
-	});
-	if (attempt.isTimedOut()) return new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.TIMEOUT, {
-		message: "Request timed out",
-		cause
-	});
-	return new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.TRANSPORT_ERROR, {
-		message: "Request failed",
-		cause
-	});
-};
-const sleep = (ms, signal) => new Promise((resolve, reject) => {
-	if (signal?.aborted) {
-		reject(new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.CANCELLED, { message: "Request cancelled" }));
-		return;
-	}
-	const onAbort = () => {
-		clearTimeout(timer);
-		reject(new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.CANCELLED, { message: "Request cancelled" }));
-	};
-	const timer = setTimeout(() => {
-		signal?.removeEventListener("abort", onAbort);
-		resolve();
-	}, ms);
-	signal?.addEventListener("abort", onAbort, { once: true });
-});
-/** Exponential backoff with jitter: half the delay is fixed, the other half random. */
-const getRetryDelayMs = (attempt, random = Math.random) => {
-	const delay = Math.min(RETRY_MAX_DELAY_MS, RETRY_BASE_DELAY_MS * 2 ** attempt);
-	return Math.round(delay / 2 + random() * (delay / 2));
-};
-/** Parses `Retry-After` as seconds or an HTTP date, in seconds from `now`. */
-const parseRetryAfter = (value, now = Date.now()) => {
-	if (!value) return void 0;
-	const trimmed = value.trim();
-	if (/^\d+$/.test(trimmed)) return Number(trimmed);
-	const date = Date.parse(trimmed);
-	if (Number.isNaN(date)) return void 0;
-	return Math.max(0, Math.ceil((date - now) / 1e3));
-};
-/** Bodies that can be sent again unchanged. Streams are consumed by the first attempt. */
-const isReplayableBody = (body) => body === void 0 || body === null || typeof body === "string" || body instanceof Blob || body instanceof ArrayBuffer || ArrayBuffer.isView(body) || body instanceof URLSearchParams;
-const isApiErrorPayload = (value) => !!value && typeof value === "object" && typeof value.code === "string";
-/** Reads at most `limit` bytes of a body, failing with `sdk/response-too-large` beyond that. */
-const readBody = async (response, limit) => {
-	const declared = Number(response.headers.get("content-length"));
-	const tooLarge = () => new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.RESPONSE_TOO_LARGE, {
-		message: `Response body exceeds ${limit} bytes`,
-		status: response.status,
-		requestId: response.headers.get("x-request-id") ?? void 0,
-		headers: response.headers
-	});
-	if (Number.isFinite(declared) && declared > limit) {
-		await response.body?.cancel().catch(() => {});
-		throw tooLarge();
-	}
-	if (!response.body) return /* @__PURE__ */ new Uint8Array(0);
-	const reader = response.body.getReader();
-	const chunks = [];
-	let total = 0;
-	for (;;) {
-		const { done, value } = await reader.read();
-		if (done) break;
-		total += value.byteLength;
-		if (total > limit) {
-			await reader.cancel().catch(() => {});
-			throw tooLarge();
-		}
-		chunks.push(value);
-	}
-	const bytes = new Uint8Array(total);
-	let offset = 0;
-	for (const chunk of chunks) {
-		bytes.set(chunk, offset);
-		offset += chunk.byteLength;
-	}
-	return bytes;
-};
-const responseInfo = (response) => ({
-	status: response.status,
-	requestId: response.headers.get("x-request-id") ?? void 0,
-	headers: response.headers,
-	retryAfter: parseRetryAfter(response.headers.get("retry-after"))
-});
-/** The `CalmLensError` for a non-2xx response whose body has been read. */
-const toHttpError = (response, bytes) => {
-	let data;
-	try {
-		data = JSON.parse(new TextDecoder().decode(bytes));
-	} catch {}
-	if (isApiErrorPayload(data)) {
-		const { code, message, details, traceId } = data;
-		return new require_CalmLensVersion.CalmLensError(code, {
-			message: message ?? code,
-			...responseInfo(response),
-			details: details || traceId ? {
-				...details,
-				...traceId ? { traceId } : {}
-			} : void 0
-		});
-	}
-	return new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.HTTP_ERROR, {
-		message: `HTTP ${response.status}`,
-		...responseInfo(response)
-	});
-};
-/** Sends requests with the client's credentials, deadlines, retries and response limits. */
-var CalmLensTransport = class {
-	constructor(settings) {
-		this.settings = settings;
-	}
-	headersFor(request) {
-		const headers = new Headers(request.init?.headers);
-		for (const [name, value] of Object.entries(request.headers ?? {})) headers.set(name, value);
-		if (!headers.has("accept") && request.deadline === "body") headers.set("accept", "application/json");
-		if (this.settings.apiKey) headers.set("x-api-key", this.settings.apiKey);
-		if (!require_CalmLensVersion.isBrowserRuntime()) headers.set("user-agent", require_CalmLensVersion.getUserAgent());
-		if (request.idempotencyKey) headers.set("idempotency-key", request.idempotencyKey);
-		return Object.fromEntries(headers.entries());
-	}
-	canRetry(request) {
-		return this.settings.maxRetries > 0 && (request.method === "GET" || request.method === "HEAD" || !!request.idempotencyKey) && isReplayableBody(request.body);
-	}
-	/**
-	* Sends a request and returns the response, retrying transport failures, 429, 502–504 and
-	* `idempotency/request-in-progress` when the request is safe to repeat. Non-2xx responses
-	* throw unless `allowHttpErrors` is set. Call `release` once the body has been read.
-	*/
-	async send(request, { allowHttpErrors = false } = {}) {
-		const fetchImpl = request.fetch ?? this.settings.fetch;
-		const retryable = this.canRetry(request);
-		const headers = this.headersFor(request);
-		for (let attemptNumber = 0;; attemptNumber++) {
-			const canRetryAgain = retryable && attemptNumber < this.settings.maxRetries;
-			const attempt = createAttemptSignal([this.settings.signal, request.init?.signal ?? void 0], request.timeoutMs);
-			let response;
-			try {
-				if (attempt.signal.aborted) throw attempt.signal.reason;
-				response = await fetchImpl(request.url, {
-					...request.init,
-					method: request.method,
-					headers,
-					body: request.body,
-					redirect: "manual",
-					signal: attempt.signal,
-					duplex: "half"
-				});
-				if (isRedirect(response)) {
-					await response.body?.cancel().catch(() => {});
-					throw new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.TRANSPORT_ERROR, { message: `Unexpected redirect (HTTP ${response.status})` });
-				}
-			} catch (cause) {
-				attempt.release();
-				const failure = toFailure(cause, attempt);
-				if (canRetryAgain && failure.code === require_CalmLensVersion.SDK_ERROR_CODES.TRANSPORT_ERROR) {
-					await sleep(getRetryDelayMs(attemptNumber), this.settings.signal);
-					continue;
-				}
-				throw failure;
-			}
-			if (request.deadline === "headers") attempt.clearDeadline();
-			if (response.ok) return {
-				response,
-				attempt
-			};
-			if (allowHttpErrors) {
-				const retryAfter = parseRetryAfter(response.headers.get("retry-after"));
-				const delayMs = retryAfter !== void 0 ? retryAfter * 1e3 : getRetryDelayMs(attemptNumber);
-				if (!canRetryAgain || !RETRYABLE_STATUSES.has(response.status) || delayMs > RETRY_AFTER_MAX_MS) return {
-					response,
-					attempt
-				};
-				attempt.release();
-				await response.body?.cancel().catch(() => {});
-				await sleep(delayMs, this.settings.signal);
-				continue;
-			}
-			let error;
-			try {
-				error = toHttpError(response, await readBody(response, this.settings.maxResponseBytes));
-			} catch (cause) {
-				error = toFailure(cause, attempt);
-			} finally {
-				attempt.release();
-			}
-			const retryDelayMs = error.retryAfter !== void 0 ? error.retryAfter * 1e3 : getRetryDelayMs(attemptNumber);
-			if (canRetryAgain && retryDelayMs <= RETRY_AFTER_MAX_MS && (error.status !== void 0 && RETRYABLE_STATUSES.has(error.status) || error.code === require_CalmLensVersion.API_ERROR_CODES.IDEMPOTENT_REQUEST_IN_PROGRESS)) {
-				await sleep(retryDelayMs, this.settings.signal);
-				continue;
-			}
-			throw error;
-		}
-	}
-	/** Sends a request and parses its JSON response body. */
-	async json(request) {
-		const { response, attempt } = await this.send(request);
-		try {
-			const bytes = await readBody(response, this.settings.maxResponseBytes);
-			if (bytes.byteLength === 0 && (response.status === 204 || request.method === "DELETE")) return;
-			try {
-				return JSON.parse(new TextDecoder().decode(bytes));
-			} catch (cause) {
-				throw new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.INVALID_RESPONSE, {
-					message: `Invalid JSON response (HTTP ${response.status})`,
-					...responseInfo(response),
-					cause
-				});
-			}
-		} catch (cause) {
-			throw toFailure(cause, attempt);
-		} finally {
-			attempt.release();
-		}
-	}
-};
-//#endregion
-//#region src/client/CalmLensUtils.ts
-const assertHttpUrl = (name, value) => {
-	if (value === void 0) return;
-	let url;
-	try {
-		url = new URL(value);
-	} catch {}
-	if (!url || url.protocol !== "https:" && url.protocol !== "http:") throw require_CalmLensVersion.invalidConfig(`${name} must be an absolute http(s) URL`);
-};
-const assertInteger = (name, value, minimum) => {
-	if (value !== void 0 && (!Number.isSafeInteger(value) || value < minimum)) throw require_CalmLensVersion.invalidConfig(minimum === 0 ? `${name} must be a non-negative integer` : `${name} must be a positive integer`);
-};
-const configPathSegment = (value, name) => {
-	try {
-		encodePathSegment(value, name);
-	} catch (error) {
-		throw require_CalmLensVersion.invalidConfig(error.message.replace(/^\[calmlens\] /, ""));
-	}
-};
-/** Checks the options both clients share: where requests go and how they're sent. */
-const validateConnectionOptions = (options) => {
-	if ("requestBackend" in options) throw require_CalmLensVersion.invalidConfig("requestBackend is no longer supported; pass a fetch implementation as fetch");
-	validateRequestOptions(options);
-	assertInteger("maxResponseBytes", options.maxResponseBytes, 1);
-	for (const name of ["fetch", "uploadFetch"]) if (options[name] !== void 0 && typeof options[name] !== "function") throw require_CalmLensVersion.invalidConfig(`${name} must be a function`);
-	assertHttpUrl("baseUrl", options.baseUrl);
-};
-/**
-* Checks server client options before the client sets anything up. `CalmLensServerClient` and
-* `MockCalmLensServerClient` share it so both reject the same configuration.
-*/
-const validateServerClientOptions = (options) => {
-	if (!options || typeof options !== "object") throw require_CalmLensVersion.invalidConfig("Client options are required");
-	if (!options.apiKey || typeof options.apiKey !== "string") throw require_CalmLensVersion.invalidConfig("API key is required");
-	if (!options.projectId) throw require_CalmLensVersion.invalidConfig("Project ID is required");
-	configPathSegment(options.projectId, "Project ID");
-	validateConnectionOptions(options);
-	if (options.cdnFetch !== void 0 && typeof options.cdnFetch !== "function") throw require_CalmLensVersion.invalidConfig("cdnFetch must be a function");
-	assertHttpUrl("cdnBaseUrl", options.cdnBaseUrl);
-};
-/** Checks app client options before the client sets anything up. */
-const validateAppClientOptions = (options) => {
-	if (!options || typeof options !== "object") throw require_CalmLensVersion.invalidConfig("Client options are required");
-	if ("apiKey" in options && options.apiKey !== void 0) throw require_CalmLensVersion.invalidConfig("CalmLensAppClient never takes an API key, which anyone using the browser or app could read. Upload through uploadPresetId, and keep the API key in CalmLensServerClient on your server.");
-	if (!options.uploadPresetId) throw require_CalmLensVersion.invalidConfig("Upload preset ID is required");
-	configPathSegment(options.uploadPresetId, "Upload preset ID");
-	if (options.token !== void 0 && typeof options.token !== "string" && typeof options.token !== "function") throw require_CalmLensVersion.invalidConfig("token must be a string or a function that returns one");
-	validateConnectionOptions(options);
-};
-/** Checks the options `withRequestOptions` accepts. */
-const validateRequestOptions = (options) => {
-	assertInteger("timeoutMs", options.timeoutMs, 1);
-	assertInteger("uploadTimeoutMs", options.uploadTimeoutMs, 1);
-	assertInteger("maxRetries", options.maxRetries, 0);
-};
-const toTextAssetOptions = ({ text, name, ...options }) => {
-	if (typeof text !== "string" || !text.trim()) throw new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.API_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Text to moderate must be a non-empty string" });
-	return {
-		...options,
-		name: name ?? "text",
-		content: {
-			plainText: text,
-			type: "text/plain"
-		}
-	};
-};
-/**
-* A random UUID v4. React Native has no `crypto` global, so this falls back to
-* `crypto.getRandomValues` and then to `Math.random`; the SDK only uses it for idempotency keys,
-* which need to be unique rather than secret.
-*/
-const randomUuid = () => {
-	const crypto = globalThis.crypto;
-	if (typeof crypto?.randomUUID === "function") return crypto.randomUUID();
-	const bytes = /* @__PURE__ */ new Uint8Array(16);
-	if (typeof crypto?.getRandomValues === "function") crypto.getRandomValues(bytes);
-	else for (let index = 0; index < bytes.length; index++) bytes[index] = Math.random() * 256;
-	bytes[6] = bytes[6] & 15 | 64;
-	bytes[8] = bytes[8] & 63 | 128;
-	const hex = Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
-	return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-};
-/**
-* 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 require_CalmLensVersion.invalidArgument(`${name} is required`);
-	if (value === "." || value === "..") throw require_CalmLensVersion.invalidArgument(`${name} cannot be "." or ".."`);
-	return encodeURIComponent(value);
-};
-const TRANSFORM_TYPE_PATTERN = /^[A-Za-z0-9_]+$/;
-/** Percent-encodes everything except RFC 3986 unreserved characters (`A-Z a-z 0-9 - . _ ~`). */
-const encodeTransformComponent = (value) => encodeURIComponent(value).replace(/[!'()*]/g, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
-const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const appendTransformOptions = (pairs, key, value) => {
-	if (value === void 0 || value === null) return;
-	if (isPlainObject(value)) {
-		for (const child of Object.keys(value).sort()) appendTransformOptions(pairs, `${key}[${child}]`, value[child]);
-		return;
-	}
-	let text;
-	if (typeof value === "string") text = value;
-	else if (typeof value === "boolean") text = String(value);
-	else if (typeof value === "number" && Number.isFinite(value)) text = String(value);
-	else throw require_CalmLensVersion.invalidArgument(`Transform option "${key}" must be a string, number, boolean or object`);
-	pairs.push(`${encodeTransformComponent(key)}=${encodeTransformComponent(text)}`);
-};
-/**
-* Serializes structured transforms as a CDN selector, such as
-* `imageTransform[format=png,width=1024]`. Option keys are sorted so equal transforms share a
-* URL; nested keys (`border[color]`) and values are percent-encoded.
-*/
-const serializeTransform = (transform) => {
-	const steps = Array.isArray(transform) ? transform : [transform];
-	if (steps.length === 0) throw require_CalmLensVersion.invalidArgument("Transform needs at least one step");
-	return steps.map((step) => {
-		if (!isPlainObject(step)) throw require_CalmLensVersion.invalidArgument("Transform steps must be objects");
-		if (typeof step.type !== "string" || !TRANSFORM_TYPE_PATTERN.test(step.type)) throw require_CalmLensVersion.invalidArgument("Transform type must contain only letters, digits and underscores");
-		if (step.options !== void 0 && step.options !== null && !isPlainObject(step.options)) throw require_CalmLensVersion.invalidArgument("Transform options must be an object");
-		const pairs = [];
-		for (const key of Object.keys(step.options ?? {}).sort()) appendTransformOptions(pairs, key, step.options[key]);
-		return `${step.type}[${pairs.join(",")}]`;
-	}).join(",");
-};
-/** Returns the selector string the API and CDN accept for a string or structured transform. */
-const transformSelector = (transform) => transform === void 0 || typeof transform === "string" ? transform : serializeTransform(transform);
-/** Appends a CDN lens (`/@name`) followed by any direct transform selector to an asset URL. */
-const appendCdnSelector = (url, options) => {
-	if (options.lens) url = `${url}/@${encodePathSegment(options.lens, "Lens")}`;
-	if (!options.transform) return url;
-	if (typeof options.transform !== "string") return `${url}${options.lens ? "," : "/"}${serializeTransform(options.transform)}`;
-	const transform = options.transform.replace(/^\/+/, "");
-	if (transform.includes("..") || transform.includes("?") || transform.includes("#")) throw require_CalmLensVersion.invalidArgument("Transform cannot contain \"..\", \"?\" or \"#\"");
-	return `${url}${options.lens ? "," : "/"}${encodeURI(transform).replace(/%5B/g, "[").replace(/%5D/g, "]")}`;
-};
-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("&");
-};
-/**
-* Whether an asset has a moderation decision (`moderation.status` `approved` or `rejected`) or
-* failed processing; `assets.waitForDecision` returns at the first such state.
-*/
-const isAssetDecided = (asset) => asset.moderation.status === "approved" || asset.moderation.status === "rejected" || asset.processing.status === "failed";
-const DECISION_POLL_FIRST_DELAY_MS = 500;
-const DECISION_POLL_MAX_DELAY_MS = 5e3;
-const DEFAULT_DECISION_TIMEOUT_MS = 6e4;
-/**
-* Retrieves an asset until it has a decision, waiting 0.5s between checks and 1.5 times longer
-* each time, up to 5s. Rejects with `sdk/timeout` once `timeoutMs` passes without one.
-*/
-const pollForDecision = async (retrieve, { timeoutMs = DEFAULT_DECISION_TIMEOUT_MS, signal }, sleep, now = Date.now) => {
-	if (!Number.isFinite(timeoutMs) || timeoutMs < 0) throw require_CalmLensVersion.invalidArgument("timeoutMs must be a non-negative number");
-	const deadline = now() + timeoutMs;
-	let delay = DECISION_POLL_FIRST_DELAY_MS;
-	for (;;) {
-		if (signal?.aborted) throw new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.CANCELLED, { message: "Request cancelled" });
-		const asset = await retrieve();
-		if (isAssetDecided(asset)) return asset;
-		const remaining = deadline - now();
-		if (remaining <= 0) throw new require_CalmLensVersion.CalmLensError(require_CalmLensVersion.SDK_ERROR_CODES.TIMEOUT, {
-			message: `Asset ${asset.id} had no moderation decision after ${timeoutMs}ms (processing ${asset.processing.status}, moderation ${asset.moderation.status})`,
-			details: {
-				assetId: asset.id,
-				processingStatus: asset.processing.status,
-				moderationStatus: asset.moderation.status
-			}
-		});
-		await sleep(Math.min(delay, remaining), signal);
-		delay = Math.min(DECISION_POLL_MAX_DELAY_MS, delay * 1.5);
-	}
-};
-//#endregion
-Object.defineProperty(exports, "CalmLensTransport", {
-	enumerable: true,
-	get: function() {
-		return CalmLensTransport;
-	}
-});
-Object.defineProperty(exports, "DOMAIN", {
-	enumerable: true,
-	get: function() {
-		return DOMAIN;
-	}
-});
-Object.defineProperty(exports, "MAX_IMAGE_UPLOAD_BYTES", {
-	enumerable: true,
-	get: function() {
-		return MAX_IMAGE_UPLOAD_BYTES;
-	}
-});
-Object.defineProperty(exports, "MIN_MULTIPART_IMAGE_UPLOAD_BYTES", {
-	enumerable: true,
-	get: function() {
-		return MIN_MULTIPART_IMAGE_UPLOAD_BYTES;
-	}
-});
-Object.defineProperty(exports, "appendCdnSelector", {
-	enumerable: true,
-	get: function() {
-		return appendCdnSelector;
-	}
-});
-Object.defineProperty(exports, "assetDataToUint8Array", {
-	enumerable: true,
-	get: function() {
-		return assetDataToUint8Array;
-	}
-});
-Object.defineProperty(exports, "assetToData", {
-	enumerable: true,
-	get: function() {
-		return assetToData;
-	}
-});
-Object.defineProperty(exports, "encodePathSegment", {
-	enumerable: true,
-	get: function() {
-		return encodePathSegment;
-	}
-});
-Object.defineProperty(exports, "getAssetPayloadByteLength", {
-	enumerable: true,
-	get: function() {
-		return getAssetPayloadByteLength;
-	}
-});
-Object.defineProperty(exports, "getRejectedUploadMimeTypeError", {
-	enumerable: true,
-	get: function() {
-		return getRejectedUploadMimeTypeError;
-	}
-});
-Object.defineProperty(exports, "isRejectedUploadMimeType", {
-	enumerable: true,
-	get: function() {
-		return isRejectedUploadMimeType;
-	}
-});
-Object.defineProperty(exports, "pollForDecision", {
-	enumerable: true,
-	get: function() {
-		return pollForDecision;
-	}
-});
-Object.defineProperty(exports, "randomUuid", {
-	enumerable: true,
-	get: function() {
-		return randomUuid;
-	}
-});
-Object.defineProperty(exports, "sleep", {
-	enumerable: true,
-	get: function() {
-		return sleep;
-	}
-});
-Object.defineProperty(exports, "stringifyQuery", {
-	enumerable: true,
-	get: function() {
-		return stringifyQuery;
-	}
-});
-Object.defineProperty(exports, "toTextAssetOptions", {
-	enumerable: true,
-	get: function() {
-		return toTextAssetOptions;
-	}
-});
-Object.defineProperty(exports, "transformSelector", {
-	enumerable: true,
-	get: function() {
-		return transformSelector;
-	}
-});
-Object.defineProperty(exports, "validateAppClientOptions", {
-	enumerable: true,
-	get: function() {
-		return validateAppClientOptions;
-	}
-});
-Object.defineProperty(exports, "validateAssetPayload", {
-	enumerable: true,
-	get: function() {
-		return validateAssetPayload;
-	}
-});
-Object.defineProperty(exports, "validateRequestOptions", {
-	enumerable: true,
-	get: function() {
-		return validateRequestOptions;
-	}
-});
-Object.defineProperty(exports, "validateServerClientOptions", {
-	enumerable: true,
-	get: function() {
-		return validateServerClientOptions;
-	}
-});