@decartai/sdk 0.0.21 → 0.0.22

package/dist/index.d.ts

@@ -10,12 +10,29 @@ import { z } from "zod";
 
 //#region src/index.d.ts
 declare const decartClientOptionsSchema: z.ZodObject<{
-  apiKey: z.ZodString;
+  apiKey: z.ZodOptional<z.ZodString>;
   baseUrl: z.ZodOptional<z.ZodURL>;
   integration: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type DecartClientOptions = z.infer<typeof decartClientOptionsSchema>;
-declare const createDecartClient: (options: DecartClientOptions) => {
+/**
+ * Create a Decart API client.
+ *
+ * @param options - Configuration options
+ * @param options.apiKey - API key for authentication. Defaults to the DECART_API_KEY environment variable.
+ * @param options.baseUrl - Override the default API base URL.
+ * @param options.integration - Optional integration identifier.
+ *
+ * @example
+ * ```ts
+ * // Option 1: Explicit API key
+ * const client = createDecartClient({ apiKey: "your-api-key" });
+ *
+ * // Option 2: Using DECART_API_KEY environment variable
+ * const client = createDecartClient();
+ * ```
+ */
+declare const createDecartClient: (options?: DecartClientOptions) => {
   realtime: {
     connect: (stream: MediaStream, options: RealTimeClientConnectOptions) => Promise<RealTimeClient>;
   };

package/dist/index.js

@@ -3,23 +3,44 @@ import { createProcessClient } from "./process/client.js";
 import { createQueueClient } from "./queue/client.js";
 import { models } from "./shared/model.js";
 import { createRealTimeClient } from "./realtime/client.js";
+import { readEnv } from "./utils/env.js";
 import { z } from "zod";
 
 //#region src/index.ts
 const decartClientOptionsSchema = z.object({
-	apiKey: z.string().min(1),
+	apiKey: z.string().min(1).optional(),
 	baseUrl: z.url().optional(),
 	integration: z.string().optional()
 });
-const createDecartClient = (options) => {
-	const parsedOptions = decartClientOptionsSchema.safeParse(options);
+/**
+* Create a Decart API client.
+*
+* @param options - Configuration options
+* @param options.apiKey - API key for authentication. Defaults to the DECART_API_KEY environment variable.
+* @param options.baseUrl - Override the default API base URL.
+* @param options.integration - Optional integration identifier.
+*
+* @example
+* ```ts
+* // Option 1: Explicit API key
+* const client = createDecartClient({ apiKey: "your-api-key" });
+*
+* // Option 2: Using DECART_API_KEY environment variable
+* const client = createDecartClient();
+* ```
+*/
+const createDecartClient = (options = {}) => {
+	const apiKey = options.apiKey ?? readEnv("DECART_API_KEY");
+	if (!apiKey) throw createInvalidApiKeyError();
+	const parsedOptions = decartClientOptionsSchema.safeParse({
+		...options,
+		apiKey
+	});
 	if (!parsedOptions.success) {
-		const issue = parsedOptions.error.issues[0];
-		if (issue.path.includes("apiKey")) throw createInvalidApiKeyError();
-		if (issue.path.includes("baseUrl")) throw createInvalidBaseUrlError(options.baseUrl);
+		if (parsedOptions.error.issues[0].path.includes("baseUrl")) throw createInvalidBaseUrlError(options.baseUrl);
 		throw parsedOptions.error;
 	}
-	const { baseUrl = "https://api.decart.ai", apiKey, integration } = parsedOptions.data;
+	const { baseUrl = "https://api.decart.ai", integration } = parsedOptions.data;
 	const realtime = createRealTimeClient({
 		baseUrl: "wss://api3.decart.ai",
 		apiKey,

package/dist/utils/env.js

@@ -0,0 +1,9 @@
+//#region src/utils/env.ts
+const readEnv = (env) => {
+	const globalThisAny = globalThis;
+	if (typeof globalThisAny.process !== "undefined") return globalThisAny.process.env?.[env]?.trim();
+	if (typeof globalThisAny.Deno !== "undefined") return globalThisAny.Deno.env?.get?.(env)?.trim();
+};
+
+//#endregion
+export { readEnv };

package/dist/utils/errors.js

@@ -21,7 +21,7 @@ function createSDKError(code, message, data, cause) {
 	};
 }
 function createInvalidApiKeyError() {
-	return createSDKError(ERROR_CODES.INVALID_API_KEY, "API key is required and must be a non-empty string");
+	return createSDKError(ERROR_CODES.INVALID_API_KEY, "Missing API key. Pass `apiKey` to createDecartClient() or set the DECART_API_KEY environment variable.");
 }
 function createInvalidBaseUrlError(url) {
 	return createSDKError(ERROR_CODES.INVALID_BASE_URL, `Invalid base URL${url ? `: ${url}` : ""}`);

package/dist/version.js

@@ -4,7 +4,7 @@
 * Injected at build time from package.json.
 * Falls back to '0.0.0-dev' in development.
 */
-const VERSION = "0.0.21";
+const VERSION = "0.0.22";
 
 //#endregion
 export { VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decartai/sdk",
-  "version": "0.0.21",
+  "version": "0.0.22",
   "description": "Decart's JavaScript SDK",
   "type": "module",
   "license": "MIT",