@calmlens/sdk 0.9.0 → 0.10.0

package/esm/CalmLensUtils-Bnikzonc.js

@@ -1,472 +0,0 @@
-import { ErrorCode } from "sendable-error";
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/typeof.js
-function _typeof(o) {
-	"@babel/helpers - typeof";
-	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
-		return typeof o;
-	} : function(o) {
-		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
-	}, _typeof(o);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPrimitive.js
-function toPrimitive(t, r) {
-	if ("object" != _typeof(t) || !t) return t;
-	var e = t[Symbol.toPrimitive];
-	if (void 0 !== e) {
-		var i = e.call(t, r || "default");
-		if ("object" != _typeof(i)) return i;
-		throw new TypeError("@@toPrimitive must return a primitive value.");
-	}
-	return ("string" === r ? String : Number)(t);
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/toPropertyKey.js
-function toPropertyKey(t) {
-	var i = toPrimitive(t, "string");
-	return "symbol" == _typeof(i) ? i : i + "";
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/defineProperty.js
-function _defineProperty(e, r, t) {
-	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
-		value: t,
-		enumerable: !0,
-		configurable: !0,
-		writable: !0
-	}) : e[r] = t, e;
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/objectSpread2.js
-function ownKeys(e, r) {
-	var t = Object.keys(e);
-	if (Object.getOwnPropertySymbols) {
-		var o = Object.getOwnPropertySymbols(e);
-		r && (o = o.filter(function(r) {
-			return Object.getOwnPropertyDescriptor(e, r).enumerable;
-		})), t.push.apply(t, o);
-	}
-	return t;
-}
-function _objectSpread2(e) {
-	for (var r = 1; r < arguments.length; r++) {
-		var t = null != arguments[r] ? arguments[r] : {};
-		r % 2 ? ownKeys(Object(t), !0).forEach(function(r) {
-			_defineProperty(e, r, t[r]);
-		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r) {
-			Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
-		});
-	}
-	return e;
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/asyncToGenerator.js
-function asyncGeneratorStep(n, t, e, r, o, a, c) {
-	try {
-		var i = n[a](c), u = i.value;
-	} catch (n) {
-		e(n);
-		return;
-	}
-	i.done ? t(u) : Promise.resolve(u).then(r, o);
-}
-function _asyncToGenerator(n) {
-	return function() {
-		var t = this, e = arguments;
-		return new Promise(function(r, o) {
-			var a = n.apply(t, e);
-			function _next(n) {
-				asyncGeneratorStep(a, r, o, _next, _throw, "next", n);
-			}
-			function _throw(n) {
-				asyncGeneratorStep(a, r, o, _next, _throw, "throw", n);
-			}
-			_next(void 0);
-		});
-	};
-}
-//#endregion
-//#region ../shared/src/AssetPayload.ts
-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 === null || options === void 0 ? void 0 : 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 = function() {
-	var _ref = _asyncToGenerator(function* (data) {
-		if (data instanceof Response) return new Uint8Array(yield data.arrayBuffer());
-		if (isReadableStream(data)) return new Uint8Array(yield new Response(data).arrayBuffer());
-		if (data instanceof Blob) return new Uint8Array(yield data.arrayBuffer());
-		if (data instanceof ArrayBuffer) return new Uint8Array(data);
-		return data;
-	});
-	return function assetDataToUint8Array(_x) {
-		return _ref.apply(this, arguments);
-	};
-}();
-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 === null || options === void 0 ? void 0 : options.multipart) && !options.isFinal && byteLength !== void 0 && byteLength < 5242880) return {
-		ok: false,
-		error: MULTIPART_PART_TOO_SMALL_ERROR
-	};
-	return { ok: true };
-};
-//#endregion
-//#region ../shared/src/JsonUtils.ts
-const stringifyJsonCanonical = (value) => JSON.stringify(value, (_key, nestedValue) => {
-	if (!nestedValue || typeof nestedValue !== "object" || Array.isArray(nestedValue)) return nestedValue;
-	return Object.fromEntries(Object.keys(nestedValue).sort().map((key) => [key, nestedValue[key]]));
-});
-//#endregion
-//#region ../shared/src/PublicErrorCodes.ts
-const PUBLIC_ERROR_CODES = {
-	MISSING_TOKEN: new ErrorCode({
-		id: "auth/missing-token",
-		defaultMessage: "Authentication required. Send your project API key in the X-Api-Key header.",
-		status: 401
-	}),
-	INVALID_API_KEY: new ErrorCode({
-		id: "auth/invalid-api-key",
-		defaultMessage: "The API key is invalid, revoked or expired. Create a key under Developer → API Keys.",
-		status: 401
-	}),
-	API_KEY_PROJECT_MISMATCH: new ErrorCode({
-		id: "auth/project-mismatch",
-		defaultMessage: "This API key belongs to a different project. Use a key created for the project that owns this resource.",
-		status: 403
-	}),
-	API_KEY_NOT_ACCEPTED: new ErrorCode({
-		id: "auth/api-key-not-accepted",
-		defaultMessage: "API keys are only accepted by the public API at /v1.",
-		status: 403
-	}),
-	FILE_TOO_LARGE: new ErrorCode({
-		id: "upload/file-too-large",
-		defaultMessage: "File size exceeds limit. Maximum direct image size is 10MB, audio/video size is 50MiB, and other files is 5GB.",
-		status: 400
-	}),
-	IMAGE_REQUIRES_MULTIPART_UPLOAD: new ErrorCode({
-		id: "upload/image-requires-multipart-upload",
-		defaultMessage: "Images of 10MB or more must use a multipart upload.",
-		status: 400
-	}),
-	MULTIPART_IMAGE_TOO_SMALL: new ErrorCode({
-		id: "upload/multipart-image-too-small",
-		defaultMessage: "Multipart image uploads must total at least 10MB.",
-		status: 400
-	}),
-	MULTIPART_IMAGE_TOO_LARGE: new ErrorCode({
-		id: "upload/multipart-image-too-large",
-		defaultMessage: "Multipart image uploads cannot exceed 20MB.",
-		status: 400
-	}),
-	IMAGE_EXCEEDED_MAX_DIMENSIONS: new ErrorCode({
-		id: "upload/image-exceeded-max-dimensions",
-		defaultMessage: "Image exceeds maximum dimensions. Maximum dimensions are 12,000px.",
-		status: 400
-	}),
-	UPLOAD_LIMIT_EXCEEDED: new ErrorCode({
-		id: "upload/limit-exceeded",
-		defaultMessage: "Upload limit exceeded. You have used all your free uploads. Please upgrade to Plus or Pro for unlimited uploads.",
-		status: 403
-	}),
-	INVALID_UPLOAD_MIME_TYPE: new ErrorCode({
-		id: "upload/invalid-mime-type",
-		defaultMessage: "Upload file type is not supported. 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.",
-		status: 400
-	}),
-	INVALID_EVENT_CURSOR: new ErrorCode({
-		id: "events/invalid-cursor",
-		defaultMessage: "The events cursor is invalid. Use the cursor from a previous response, or omit it to start from now.",
-		status: 400
-	}),
-	INVALID_UPLOAD_PAYLOAD: new ErrorCode({
-		id: "upload/invalid-payload",
-		defaultMessage: "Upload payload is invalid.",
-		status: 400
-	}),
-	USE_UPLOAD_PART: new ErrorCode({
-		id: "upload/use-upload-part",
-		defaultMessage: "Use uploadPart for multipart upload parts after the first part",
-		status: 409
-	}),
-	UPLOAD_NOT_OPEN: new ErrorCode({
-		id: "upload/not-open",
-		defaultMessage: "Asset is not accepting additional parts",
-		status: 409
-	}),
-	INVALID_UPLOAD_PART_NUMBER: new ErrorCode({
-		id: "upload/invalid-part-number",
-		defaultMessage: "Multipart upload part number is invalid.",
-		status: 409
-	}),
-	UPLOAD_MISSING: new ErrorCode({
-		id: "upload/missing",
-		defaultMessage: "Multipart upload state is missing",
-		status: 409
-	}),
-	ASSET_NOT_FOUND: new ErrorCode({
-		id: "asset/not-found",
-		defaultMessage: "Asset not found",
-		status: 404
-	}),
-	PROJECT_NOT_FOUND: new ErrorCode({
-		id: "project/not-found",
-		defaultMessage: "Project not found",
-		status: 404
-	}),
-	ASSET_UPDATE_FAILED: new ErrorCode({
-		id: "asset/update-failed",
-		defaultMessage: "Failed to update asset",
-		status: 500
-	}),
-	ASSET_SAFETY_HELD: new ErrorCode({
-		id: "asset/safety-held",
-		defaultMessage: "Asset access is restricted by a safety hold.",
-		status: 423
-	}),
-	ASSET_NOT_RETRYABLE: new ErrorCode({
-		id: "asset/not-retryable",
-		defaultMessage: "Only assets that failed to process (status error) can be retried.",
-		status: 409
-	}),
-	ASSET_CONTENT_UNAVAILABLE: new ErrorCode({
-		id: "asset/content-unavailable",
-		defaultMessage: "This asset's content is no longer stored, so it can't be processed again. Upload it again instead.",
-		status: 409
-	}),
-	SUPPORT_TICKET_NOT_FOUND: new ErrorCode({
-		id: "support/ticket-not-found",
-		defaultMessage: "Support ticket not found.",
-		status: 404
-	}),
-	DUPLICATE_EXTERNAL_ID: new ErrorCode({
-		id: "asset/duplicate-external-id",
-		defaultMessage: "An asset with this externalId already exists in the project.",
-		status: 409
-	}),
-	FOLDER_NOT_FOUND: new ErrorCode({
-		id: "folder/not-found",
-		defaultMessage: "Folder not found",
-		status: 404
-	}),
-	DUPLICATE_FOLDER_NAME: new ErrorCode({
-		id: "folder/duplicate-name",
-		defaultMessage: "A folder with this name already exists in this location.",
-		status: 409
-	}),
-	FOLDER_NOT_EMPTY: new ErrorCode({
-		id: "folder/not-empty",
-		defaultMessage: "Folder must be empty before it can be deleted.",
-		status: 409
-	}),
-	FOLDER_PARENT_CYCLE: new ErrorCode({
-		id: "folder/parent-cycle",
-		defaultMessage: "A folder cannot be moved inside itself or one of its descendants.",
-		status: 409
-	}),
-	LENS_VERSION_CONFLICT: new ErrorCode({
-		id: "lens/version-conflict",
-		defaultMessage: "Lens updates require a version greater than the current version.",
-		status: 409
-	})
-};
-PUBLIC_ERROR_CODES.MISSING_TOKEN, PUBLIC_ERROR_CODES.INVALID_API_KEY, PUBLIC_ERROR_CODES.API_KEY_PROJECT_MISMATCH;
-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) => {
-	var _mimeType$toLowerCase;
-	return ((_mimeType$toLowerCase = mimeType.toLowerCase().split(";")[0]) === null || _mimeType$toLowerCase === void 0 ? void 0 : _mimeType$toLowerCase.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/client/CalmLensError.ts
-const SDK_ERRORS = { NO_CDN_FETCH: {
-	id: "sdk/no-cdn-fetch",
-	defaultMessage: "No fetch implementation is available for CDN requests"
-} };
-var CalmLensError = class extends Error {
-	constructor(errorCode, options) {
-		var _ref, _options$message;
-		const code = "getId" in errorCode ? errorCode.getId() : errorCode.id;
-		const defaultMessage = "getDefaultMessage" in errorCode ? errorCode.getDefaultMessage() : errorCode.defaultMessage;
-		super(`[calmlens] ${(_ref = (_options$message = options === null || options === void 0 ? void 0 : options.message) !== null && _options$message !== void 0 ? _options$message : defaultMessage) !== null && _ref !== void 0 ? _ref : code}`, { cause: options === null || options === void 0 ? void 0 : options.cause });
-		this.name = "CalmLensError";
-		this.code = code;
-		this.details = options === null || options === void 0 ? void 0 : options.details;
-		this.status = options === null || options === void 0 ? void 0 : options.status;
-	}
-};
-const calmLensError = (errorCode, options) => new CalmLensError(errorCode, options);
-//#endregion
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/objectWithoutPropertiesLoose.js
-function _objectWithoutPropertiesLoose(r, e) {
-	if (null == r) return {};
-	var t = {};
-	for (var n in r) if ({}.hasOwnProperty.call(r, n)) {
-		if (e.includes(n)) continue;
-		t[n] = r[n];
-	}
-	return t;
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.153.0/helpers/esm/objectWithoutProperties.js
-function _objectWithoutProperties(e, t) {
-	if (null == e) return {};
-	var o, r, i = _objectWithoutPropertiesLoose(e, t);
-	if (Object.getOwnPropertySymbols) {
-		var s = Object.getOwnPropertySymbols(e);
-		for (r = 0; r < s.length; r++) o = s[r], t.includes(o) || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]);
-	}
-	return i;
-}
-//#endregion
-//#region src/client/CalmLensUtils.ts
-const _excluded = ["text", "name"];
-const invalidOptions = (message) => calmLensError({ id: "upload/invalid-payload" }, { message });
-const assertHttpUrl = (name, value) => {
-	if (value === void 0) return;
-	let url;
-	try {
-		url = new URL(value);
-	} catch (_unused) {}
-	if (!url || url.protocol !== "https:" && url.protocol !== "http:") throw invalidOptions(`${name} must be an absolute http(s) URL`);
-};
-/**
-* Checks client options before the client sets anything up. `CalmLensClient` and
-* `MockCalmLensClient` share it so both reject the same configuration.
-*/
-const validateClientOptions = (options) => {
-	if (!options || typeof options !== "object") throw invalidOptions("Client options are required");
-	if (!options.apiKey) throw invalidOptions("API key is required");
-	if (!options.projectId) throw invalidOptions("Project ID is required");
-	encodePathSegment(options.projectId, "Project ID");
-	if (options.timeoutMs !== void 0 && (!Number.isSafeInteger(options.timeoutMs) || options.timeoutMs <= 0)) throw invalidOptions("timeoutMs must be a positive integer");
-	assertHttpUrl("baseUrl", options.baseUrl);
-	assertHttpUrl("cdnBaseUrl", options.cdnBaseUrl);
-};
-const toTextAssetOptions = (_ref) => {
-	let { text, name } = _ref, options = _objectWithoutProperties(_ref, _excluded);
-	if (typeof text !== "string" || !text.trim()) throw calmLensError(PUBLIC_ERROR_CODES.INVALID_UPLOAD_PAYLOAD, { message: "Text to moderate must be a non-empty string" });
-	return _objectSpread2(_objectSpread2({}, options), {}, {
-		name: name !== null && name !== void 0 ? name : "text",
-		content: {
-			plainText: text,
-			type: "text/plain"
-		}
-	});
-};
-/**
-* Encodes an identifier as one URL path segment. `.` and `..` are rejected because URL
-* resolution would treat them as relative segments and send the request to another route.
-*/
-const encodePathSegment = (value, name) => {
-	if (typeof value !== "string" || !value) throw invalidOptions(`${name} is required`);
-	if (value === "." || value === "..") throw invalidOptions(`${name} cannot be "." or ".."`);
-	return encodeURIComponent(value);
-};
-/** Appends a CDN lens (`/@name`) or direct transform selector to an asset URL. */
-const appendCdnSelector = (url, options) => {
-	if (options.lens && options.transform) throw invalidOptions("Specify either a lens or a transform, not both");
-	if (options.lens) return `${url}/@${encodePathSegment(options.lens, "Lens")}`;
-	if (!options.transform) return url;
-	const transform = options.transform.replace(/^\/+/, "");
-	if (transform.includes("..") || transform.includes("?") || transform.includes("#")) throw invalidOptions("Transform cannot contain \"..\", \"?\" or \"#\"");
-	return `${url}/${encodeURI(transform)}`;
-};
-const appendQueryValue = (parts, key, value) => {
-	if (value === void 0 || value === null) return;
-	if (Array.isArray(value)) {
-		for (const [index, item] of value.entries()) appendQueryValue(parts, `${key}[${index}]`, item);
-		return;
-	}
-	if (typeof value === "object") {
-		for (const [field, item] of Object.entries(value)) appendQueryValue(parts, `${key}[${field}]`, item);
-		return;
-	}
-	parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
-};
-/**
-* Serialises a query object the way the API parses it (qs bracket notation), for example
-* `ordering[0][field]=createdAt&ordering[0][direction]=DESC`. Every key and value is
-* percent-encoded and missing values are omitted.
-*/
-const stringifyQuery = (query) => {
-	const parts = [];
-	for (const [key, value] of Object.entries(query)) appendQueryValue(parts, key, value);
-	return parts.join("&");
-};
-//#endregion
-export { _objectSpread2 as C, _asyncToGenerator as S, assetDataToUint8Array as _, validateClientOptions as a, getRawBase64 as b, SDK_ERRORS as c, MAX_IMAGE_UPLOAD_BYTES as d, MIN_MULTIPART_IMAGE_UPLOAD_BYTES as f, stringifyJsonCanonical as g, PUBLIC_ERROR_CODES as h, toTextAssetOptions as i, calmLensError as l, isRejectedUploadMimeType as m, encodePathSegment as n, _objectWithoutProperties as o, getRejectedUploadMimeTypeError as p, stringifyQuery as r, CalmLensError as s, appendCdnSelector as t, DOMAIN as u, assetToData as v, validateAssetPayload as x, getAssetPayloadByteLength as y };