@calmlens/sdk 0.16.3 → 0.18.0

package/bin/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/cjs/BrowserUpload-BT091eOB.d.ts

@@ -0,0 +1,11 @@
+import { F as UploadItem$1, I as UploadSnapshot$1, M as UploadController, N as UploadControllerOptions$1, O as CalmLensUpload$1, P as UploadFile, f as UploaderProps$1 } from "./ui-wIiMfqMB.js";
+import { t as UseCalmLensUploadResult$1 } from "./ReactUpload-CAyCsyG6.js";
+type UploadItem<F extends UploadFile = File> = UploadItem$1<F>;
+type CalmLensUpload<F extends UploadFile = File> = CalmLensUpload$1<F>;
+type UploadSnapshot<F extends UploadFile = File> = UploadSnapshot$1<F>;
+type UploadControllerOptions<F extends UploadFile = File> = UploadControllerOptions$1<F>;
+type UploaderProps<F extends UploadFile = File> = UploaderProps$1<F>;
+type UseCalmLensUploadResult<F extends UploadFile = File> = UseCalmLensUploadResult$1<F>;
+/** Creates an upload queue for the browser components, such as one a form starts on submit. */
+declare const createUploadController: <F extends UploadFile = File>(options: UploadControllerOptions<F>) => UploadController<F>;
+export { UploaderProps as a, UploadSnapshot as i, UploadControllerOptions as n, UseCalmLensUploadResult as o, UploadItem as r, createUploadController as s, CalmLensUpload as t };

package/cjs/BrowserUpload-CQwXEGFv.js

@@ -0,0 +1,10 @@
+const require_UploadController = require("./UploadController-BGO1eyzb.js");
+// src/ui/BrowserUpload.ts
+/** Creates an upload queue for the browser components, such as one a form starts on submit. */
+const createUploadController = (options) => require_UploadController.createUploadController(options);
+Object.defineProperty(exports, "createUploadController", {
+	enumerable: true,
+	get: function() {
+		return createUploadController;
+	}
+});

package/cjs/CalmLensAppClient-CHQGu-Do.js

@@ -0,0 +1,89 @@
+const require_ModerationContextLimits = require("./ModerationContextLimits-DelWfmiJ.js");
+const require_CalmLensConnection = require("./CalmLensConnection-B8Bu2j3y.js");
+// 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.classify`, `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) {
+		require_ModerationContextLimits.validateAppClientOptions(options);
+		const { token, uploadPresetId, ...rest } = options;
+		this.#uploadPresetId = uploadPresetId;
+		this.#token = token;
+		this.#connection = new require_CalmLensConnection.CalmLensConnection(require_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 require_ModerationContextLimits.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 require_ModerationContextLimits.invalidArgument("Upload options are required");
+		if (!("content" in options) && !("part" in options)) throw require_ModerationContextLimits.invalidArgument("Uploads through an upload preset need content or a part");
+		require_CalmLensConnection.prepareSubmitAssetOptions(options, { deferUploadChecks: this.#connection.deferUploadChecks });
+		const token = await this.newUploadToken();
+		const data = await this.#connection.submitRawUpload(this.uploadsPath, options, queue, token ? { Authorization: `Bearer ${token}` } : {});
+		const uploaded = require_CalmLensConnection.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. */
+			classify: (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 = require_ModerationContextLimits.encodePathSegment(assetId, "Asset ID");
+				const data = await this.#connection.uploadPart(`${this.uploadsPath}/${encodedAssetId}/part`, options, this.authHeaders(assetId));
+				return require_CalmLensConnection.expectUploadedAsset(data);
+			},
+			/** Checks an upload this client made. `status` is present when the preset shows decisions. */
+			retrieve: async ({ assetId }) => {
+				const encodedAssetId = require_ModerationContextLimits.encodePathSegment(assetId, "Asset ID");
+				const data = await this.#connection.json("GET", `${this.uploadsPath}/${encodedAssetId}`, { headers: this.authHeaders(assetId) });
+				return require_CalmLensConnection.expectUploadedAsset(data);
+			}
+		};
+	}
+};
+Object.defineProperty(exports, "CalmLensAppClient", {
+	enumerable: true,
+	get: function() {
+		return CalmLensAppClient;
+	}
+});

package/cjs/CalmLensAppClient-CV_K26Ce.d.ts

@@ -0,0 +1,40 @@
+import { Ct as UploadAssetPartOptions, Tt as UploadedAsset, pt as RetrieveAssetOptions, w as CalmLensAppClientOptions, wt as UploadPresetSubmitAssetOptions } from "./CalmLensTypes-9Vt16pc7.js";
+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.classify`, `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. */
+    classify: (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>;
+  };
+}
+export { CalmLensAppClient as t };