@calmlens/sdk 0.14.0 → 0.16.0

package/cjs/testing.js

@@ -21,9 +21,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_CalmLensVersion = require("./CalmLensVersion-Bs0DreBV.js");
-const require_CalmLensWebhooks = require("./CalmLensWebhooks-6thkvr_F.js");
-const require_CalmLensUtils = require("./CalmLensUtils-DNdmYeX6.js");
+const require_CalmLensVersion = require("./CalmLensVersion-CrlGk2gX.js");
+const require_CalmLensWebhooks = require("./CalmLensWebhooks-C2VrleZm.js");
+const require_CalmLensUtils = require("./CalmLensUtils-DvhY8-cU.js");
 let zod = require("zod");
 zod = __toESM(zod);
 require("zod/v4");
@@ -379,10 +379,10 @@ const HEX_WORDS = [
 	"foxtrot"
 ];
 /** Read this aloud, or render it as large, high-contrast text in a video frame. */
-function generateMediaTestCode(signal, projectId) {
+function generateMediaTestCode(signal, testInputKey) {
 	if (!MEDIA_TEST_SIGNALS.includes(signal)) throw new Error("Unsupported media test signal");
-	const suffix = projectId.slice(-8).toLowerCase();
-	if (!/^[a-f0-9]{8}$/.test(suffix)) throw new Error("Expected a project ID with an eight-character hexadecimal suffix");
+	const suffix = testInputKey.toLowerCase();
+	if (!/^[a-f0-9]{8}$/.test(suffix)) throw new Error("Expected an eight-character hexadecimal test input key");
 	return `Calm Lens test ${[...suffix].map((character) => HEX_WORDS[Number.parseInt(character, 16)]).join(" ")} ${signal.replace(/[.-]/g, " ")} end test`;
 }
 //#endregion
@@ -581,18 +581,43 @@ const inferAssetType = (options) => {
 	return "file";
 };
 const createPage = (items, query) => {
-	const pageIndex = query.pageIndex ?? 0;
 	const pageSize = query.pageSize ?? 10;
-	if (!Number.isInteger(pageIndex) || pageIndex < 0) throw require_CalmLensVersion.invalidArgument("pageIndex must be a non-negative integer");
-	if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) throw require_CalmLensVersion.invalidArgument("pageSize must be an integer from 1 to 100");
-	const start = pageIndex * pageSize;
+	if (!Number.isInteger(pageSize) || pageSize < 1 || pageSize > 100) throw require_CalmLensVersion.invalidArgument("Invalid page size");
+	const ordering = query.ordering?.length ? [...query.ordering] : [{
+		field: "createdAt",
+		direction: "DESC"
+	}];
+	if (ordering.some(({ field }) => field !== "createdAt" && field !== "id")) throw require_CalmLensVersion.invalidArgument("Invalid ordering");
+	if (!ordering.some(({ field }) => field === "id")) ordering.push({
+		field: "id",
+		direction: ordering[0].direction
+	});
+	let remaining = orderItems(items, ordering);
+	if (query.cursor) {
+		let values;
+		try {
+			values = JSON.parse(atob(query.cursor));
+			if (!Array.isArray(values) || values.length !== ordering.length || values.some((value, i) => ordering[i].field === "id" ? typeof value !== "string" : typeof value !== "number" || !Number.isFinite(value))) throw new Error();
+		} catch {
+			throw require_CalmLensVersion.invalidArgument("Invalid cursor");
+		}
+		remaining = remaining.filter((item) => {
+			for (const [i, rule] of ordering.entries()) {
+				const result = compareValues(item[rule.field], values[i]);
+				if (result) return rule.direction === "DESC" ? result < 0 : result > 0;
+			}
+			return false;
+		});
+	}
+	const pageItems = remaining.slice(0, pageSize);
+	const hasMore = remaining.length > pageSize;
+	const last = pageItems.at(-1);
 	return {
-		items: items.slice(start, start + pageSize),
-		total: items.length,
-		pageIndex,
+		items: pageItems,
 		pageSize,
-		ordering: query.ordering ?? [],
-		hasMore: start + pageSize < items.length
+		hasMore,
+		ordering,
+		nextCursor: hasMore && last ? btoa(JSON.stringify(ordering.map(({ field }) => last[field]))) : null
 	};
 };
 const compareValues = (left, right) => {
@@ -930,10 +955,12 @@ var MockCalmLensServerClient = class {
 		}
 	}
 	async *iteratePages(listPage) {
-		for (let pageIndex = 0;; pageIndex++) {
-			const page = await listPage(pageIndex);
+		let cursor;
+		for (;;) {
+			const page = await listPage(cursor);
 			yield* page.items;
-			if (!page.hasMore || page.items.length === 0) return;
+			if (!page.nextCursor || !page.hasMore || page.items.length === 0) return;
+			cursor = page.nextCursor;
 		}
 	}
 	get text() {
@@ -982,14 +1009,11 @@ var MockCalmLensServerClient = class {
 				let assets = await this.databaseStorage.listAssets(this.projectId);
 				if (options.folderId !== void 0) assets = assets.filter((asset) => (asset.folderId ?? null) === options.folderId);
 				assets = filterAssets(assets, options.filter);
-				return createPage(orderItems(assets, options.ordering), {
-					...options,
-					pageIndex: options.pageIndex ?? 0
-				});
+				return createPage(assets, options);
 			},
-			iterate: (options = {}) => this.iteratePages((pageIndex) => this.assets.list({
+			iterate: (options = {}) => this.iteratePages((cursor) => this.assets.list({
 				...options,
-				pageIndex
+				cursor
 			})),
 			retrieve: async (options) => {
 				this.begin("assets.retrieve", options);
@@ -1000,16 +1024,13 @@ var MockCalmLensServerClient = class {
 				const { assetId, ...options } = childrenOptions;
 				require_CalmLensUtils.encodePathSegment(assetId, "Asset ID");
 				const assets = await this.databaseStorage.listAssets(this.projectId);
-				return createPage(orderItems(assets.filter((asset) => asset.parentId === assetId), options.ordering), {
-					...options,
-					pageIndex: options.pageIndex ?? 0
-				});
+				return createPage(assets.filter((asset) => asset.parentId === assetId), options);
 			},
 			iterateChildren: (options) => {
 				require_CalmLensUtils.encodePathSegment(options?.assetId, "Asset ID");
-				return this.iteratePages((pageIndex) => this.assets.listChildren({
+				return this.iteratePages((cursor) => this.assets.listChildren({
 					...options,
-					pageIndex
+					cursor
 				}));
 			},
 			update: async (options) => {

package/esm/{CalmLensConnection-DrCOL9h9.js → CalmLensConnection-DYo5U2L0.js}

@@ -1,5 +1,5 @@
-import { c as invalidArgument, o as CalmLensError, s as SDK_ERROR_CODES, u as API_ERROR_CODES } from "./CalmLensVersion-DPnL_Ebv.js";
-import { a as stringifyQuery, b as getRejectedUploadMimeTypeError, d as CalmLensTransport, g as validateAssetPayload, h as getAssetPayloadByteLength, i as randomUuid, m as assetToData, v as MAX_IMAGE_UPLOAD_BYTES, x as isRejectedUploadMimeType, y as MIN_MULTIPART_IMAGE_UPLOAD_BYTES } from "./CalmLensUtils-BQo79TA1.js";
+import { c as invalidArgument, o as CalmLensError, s as SDK_ERROR_CODES, u as API_ERROR_CODES } from "./CalmLensVersion-CchG7NWy.js";
+import { a as stringifyQuery, b as getRejectedUploadMimeTypeError, d as CalmLensTransport, g as validateAssetPayload, h as getAssetPayloadByteLength, i as randomUuid, m as assetToData, v as MAX_IMAGE_UPLOAD_BYTES, x as isRejectedUploadMimeType, y as MIN_MULTIPART_IMAGE_UPLOAD_BYTES } from "./CalmLensUtils-BDtpOfho.js";
 //#region src/client/CalmLensConnection.ts
 const DEFAULT_TIMEOUT_MS = 12e4;
 const DEFAULT_MAX_RETRIES = 2;

package/esm/{CalmLensUtils-BQo79TA1.js → CalmLensUtils-BDtpOfho.js}

@@ -1,4 +1,4 @@
-import { c as invalidArgument, l as invalidConfig, n as getUserAgent, o as CalmLensError, r as isBrowserRuntime, s as SDK_ERROR_CODES, u as API_ERROR_CODES } from "./CalmLensVersion-DPnL_Ebv.js";
+import { c as invalidArgument, l as invalidConfig, n as getUserAgent, o as CalmLensError, r as isBrowserRuntime, s as SDK_ERROR_CODES, u as API_ERROR_CODES } from "./CalmLensVersion-CchG7NWy.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([

package/esm/{CalmLensVersion-DPnL_Ebv.js → CalmLensVersion-CchG7NWy.js}

@@ -1,6 +1,7 @@
 //#region src/client/CalmLensErrorCodes.ts
 /** Error codes the CalmLens API documents, by name. */
 const API_ERROR_CODES = {
+	INVALID_CURSOR: "validation/invalid-cursor",
 	MISSING_TOKEN: "auth/missing-token",
 	INVALID_API_KEY: "auth/invalid-api-key",
 	API_KEY_PROJECT_MISMATCH: "auth/project-mismatch",
@@ -63,6 +64,10 @@ const API_ERROR_CODES = {
 };
 /** The HTTP status and default message the API returns with each documented error code. */
 const API_ERROR_DEFINITIONS = {
+	"validation/invalid-cursor": {
+		status: 400,
+		message: "The cursor is invalid or belongs to a different query."
+	},
 	"auth/missing-token": {
 		status: 401,
 		message: "Authentication required. Send your project API key in the X-Api-Key header."
@@ -390,7 +395,7 @@ const invalidConfig = (message) => new CalmLensError(SDK_ERROR_CODES.INVALID_CON
 //#endregion
 //#region src/client/CalmLensVersion.ts
 /** This SDK's version, from its package.json. */
-const SDK_VERSION = "0.14.0";
+const SDK_VERSION = "0.16.0";
 const runtimeName = () => {
 	const runtime = globalThis;
 	if (isReactNativeRuntime()) return "react-native";

package/esm/{CalmLensWebhooks-CWlD-f_P.js → CalmLensWebhooks-B7nQMCHx.js}

@@ -1,5 +1,5 @@
-import { c as invalidArgument, o as CalmLensError, s as SDK_ERROR_CODES } from "./CalmLensVersion-DPnL_Ebv.js";
-import { n as encodePathSegment } from "./CalmLensUtils-BQo79TA1.js";
+import { c as invalidArgument, o as CalmLensError, s as SDK_ERROR_CODES } from "./CalmLensVersion-CchG7NWy.js";
+import { n as encodePathSegment } from "./CalmLensUtils-BDtpOfho.js";
 //#region ../shared/src/JsonUtils.ts
 const stringifyJsonCanonical = (value) => JSON.stringify(value, (_key, nestedValue) => {
 	if (!nestedValue || typeof nestedValue !== "object" || Array.isArray(nestedValue)) return nestedValue;
@@ -124,7 +124,7 @@ async function verifyWebhookSignature(options) {
 /**
 * Verifies a webhook delivery and parses its body. Throws `sdk/invalid-webhook-signature`
 * when the signature or timestamp does not verify, and `sdk/invalid-webhook-payload` when a
-* verified body is not a webhook event. Narrow the result on `type` for typed `data.facts`.
+* verified body is not a webhook event. Unknown event types, fact values and fields remain available.
 *
 * Event types and fact keys added to CalmLens after this SDK version are returned as they are,
 * so keep a default branch when you switch on `type`.
@@ -141,7 +141,7 @@ async function parseWebhookEvent(options) {
 		});
 	}
 	const candidate = event;
-	if (!candidate || typeof candidate !== "object" || typeof candidate.id !== "string" || typeof candidate.type !== "string" || typeof candidate.projectId !== "string" || !candidate.data || typeof candidate.data !== "object") throw new CalmLensError(SDK_ERROR_CODES.INVALID_WEBHOOK_PAYLOAD, { message: "Webhook body is not a CalmLens event" });
+	if (!candidate || typeof candidate !== "object" || typeof candidate.id !== "string" || typeof candidate.type !== "string" || typeof candidate.projectId !== "string" || !candidate.data || typeof candidate.data !== "object" || Array.isArray(candidate.data)) throw new CalmLensError(SDK_ERROR_CODES.INVALID_WEBHOOK_PAYLOAD, { message: "Webhook body is not a CalmLens event" });
 	return event;
 }
 //#endregion