@decartai/sdk 0.0.18 → 0.0.20

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { ImageModels, Model, ModelDefinition, RealTimeModels, VideoModels, models } from "./shared/model.js";
 import { FileInput, ProcessOptions } from "./process/types.js";
 import { ProcessClient } from "./process/client.js";
+import { JobStatus, JobStatusResponse, JobSubmitResponse, QueueJobResult, QueueSubmitAndPollOptions, QueueSubmitOptions } from "./queue/types.js";
+import { QueueClient } from "./queue/client.js";
 import { DecartSDKError, ERROR_CODES } from "./utils/errors.js";
 import { RealTimeClient, RealTimeClientConnectOptions, RealTimeClientInitialState } from "./realtime/client.js";
 import { ModelState } from "./shared/types.js";
@@ -30,6 +32,44 @@ declare const createDecartClient: (options: DecartClientOptions) => {
    * ```
    */
   process: ProcessClient;
+  /**
+   * Client for queue-based async video and image generation.
+   * Jobs are submitted and processed asynchronously.
+   *
+   * @example
+   * ```ts
+   * const client = createDecartClient({ apiKey: "your-api-key" });
+   *
+   * // Option 1: Submit and poll automatically
+   * const result = await client.queue.submitAndPoll({
+   *   model: models.video("lucy-pro-t2v"),
+   *   prompt: "A beautiful sunset over the ocean",
+   *   onStatusChange: (job) => console.log(`Job ${job.job_id}: ${job.status}`)
+   * });
+   *
+   * // Option 2: Submit and poll manually
+   * const job = await client.queue.submit({
+   *   model: models.video("lucy-pro-t2v"),
+   *   prompt: "A beautiful sunset over the ocean"
+   * });
+   *
+   * // Poll until completion
+   * while (true) {
+   *   const status = await client.queue.status(job.job_id);
+   *   console.log(`Job ${status.job_id}: ${status.status}`);
+   *
+   *   if (status.status === "completed") {
+   *     const blob = await client.queue.result(job.job_id);
+   *     break;
+   *   }
+   *   if (status.status === "failed") {
+   *     throw new Error("Job failed");
+   *   }
+   *   await new Promise(resolve => setTimeout(resolve, 1500));
+   * }
+   * ```
+   */
+  queue: QueueClient;
 };
 //#endregion
-export { DecartClientOptions, type DecartSDKError, ERROR_CODES, type FileInput, type ImageModels, type Model, type ModelDefinition, type ModelState, type ProcessClient, type ProcessOptions, type RealTimeClient, type RealTimeClientConnectOptions, type RealTimeClientInitialState, type RealTimeModels, type VideoModels, createDecartClient, models };
+export { DecartClientOptions, type DecartSDKError, ERROR_CODES, type FileInput, type ImageModels, type JobStatus, type JobStatusResponse, type JobSubmitResponse, type Model, type ModelDefinition, type ModelState, type ProcessClient, type ProcessOptions, type QueueClient, type QueueJobResult, type QueueSubmitAndPollOptions, type QueueSubmitOptions, type RealTimeClient, type RealTimeClientConnectOptions, type RealTimeClientInitialState, type RealTimeModels, type VideoModels, createDecartClient, models };

package/dist/index.js

@@ -1,5 +1,6 @@
 import { ERROR_CODES, createInvalidApiKeyError, createInvalidBaseUrlError } from "./utils/errors.js";
 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 { z } from "zod";
@@ -29,9 +30,15 @@ const createDecartClient = (options) => {
 		apiKey,
 		integration
 	});
+	const queue = createQueueClient({
+		baseUrl,
+		apiKey,
+		integration
+	});
 	return {
 		realtime,
-		process
+		process,
+		queue
 	};
 };
 

package/dist/process/client.js

@@ -1,5 +1,6 @@
 import { createInvalidInputError } from "../utils/errors.js";
-import { fileInputToBlob, sendRequest } from "./request.js";
+import { fileInputToBlob } from "../shared/request.js";
+import { sendRequest } from "./request.js";
 
 //#region src/process/client.ts
 const createProcessClient = (opts) => {

package/dist/process/request.js

@@ -1,31 +1,13 @@
-import { createInvalidInputError, createSDKError } from "../utils/errors.js";
-import { buildUserAgent } from "../utils/user-agent.js";
+import { createSDKError } from "../utils/errors.js";
+import { buildAuthHeaders, buildFormData } from "../shared/request.js";
 
 //#region src/process/request.ts
-async function fileInputToBlob(input) {
-	if (input instanceof Blob || input instanceof File) return input;
-	if (input instanceof ReadableStream) return new Response(input).blob();
-	if (typeof input === "string" || input instanceof URL) {
-		const url = typeof input === "string" ? input : input.toString();
-		if (!url.startsWith("http://") && !url.startsWith("https://")) throw createInvalidInputError("URL must start with http:// or https://");
-		const response = await fetch(url);
-		if (!response.ok) throw createInvalidInputError(`Failed to fetch file from URL: ${response.statusText}`);
-		return response.blob();
-	}
-	throw createInvalidInputError("Invalid file input type");
-}
 async function sendRequest({ baseUrl, apiKey, model, inputs, signal, integration }) {
-	const formData = new FormData();
-	for (const [key, value] of Object.entries(inputs)) if (value !== void 0 && value !== null) if (value instanceof Blob) formData.append(key, value);
-	else if (typeof value === "object" && value !== null) formData.append(key, JSON.stringify(value));
-	else formData.append(key, String(value));
+	const formData = buildFormData(inputs);
 	const endpoint = `${baseUrl}${model.urlPath}`;
 	const response = await fetch(endpoint, {
 		method: "POST",
-		headers: {
-			"X-API-KEY": apiKey,
-			"User-Agent": buildUserAgent(integration)
-		},
+		headers: buildAuthHeaders(apiKey, integration),
 		body: formData,
 		signal
 	});
@@ -37,4 +19,4 @@ async function sendRequest({ baseUrl, apiKey, model, inputs, signal, integration
 }
 
 //#endregion
-export { fileInputToBlob, sendRequest };
+export { sendRequest };

package/dist/process/types.d.ts

@@ -142,4 +142,4 @@ type ProcessOptions<T extends ModelDefinition = ModelDefinition> = {
   signal?: AbortSignal;
 } & MergeDocumentedInputs<T>;
 //#endregion
-export { FileInput, ProcessOptions };
+export { FileInput, InferModelInputs, ModelSpecificInputs, ProcessInputs, ProcessOptions };

package/dist/queue/client.d.ts

@@ -0,0 +1,65 @@
+import { ModelDefinition } from "../shared/model.js";
+import { JobStatusResponse, JobSubmitResponse, QueueJobResult, QueueSubmitAndPollOptions, QueueSubmitOptions } from "./types.js";
+
+//#region src/queue/client.d.ts
+type QueueClient = {
+  /**
+   * Submit a job to the queue for async processing.
+   * Returns immediately with job_id and initial status.
+   *
+   * @example
+   * ```ts
+   * const job = await client.queue.submit({
+   *   model: models.video("lucy-pro-t2v"),
+   *   prompt: "A cat playing piano"
+   * });
+   * console.log(job.job_id); // "job_abc123"
+   * ```
+   */
+  submit: <T extends ModelDefinition>(options: QueueSubmitOptions<T>) => Promise<JobSubmitResponse>;
+  /**
+   * Get the current status of a job.
+   *
+   * @example
+   * ```ts
+   * const status = await client.queue.status("job_abc123");
+   * console.log(status.status); // "pending" | "processing" | "completed" | "failed"
+   * ```
+   */
+  status: (jobId: string) => Promise<JobStatusResponse>;
+  /**
+   * Get the result of a completed job.
+   * Should only be called when job status is "completed".
+   *
+   * @example
+   * ```ts
+   * const blob = await client.queue.result("job_abc123");
+   * videoElement.src = URL.createObjectURL(blob);
+   * ```
+   */
+  result: (jobId: string) => Promise<Blob>;
+  /**
+   * Submit a job and automatically poll until completion.
+   * Returns a result object with status (does not throw on failure).
+   *
+   * @example
+   * ```ts
+   * const result = await client.queue.submitAndPoll({
+   *   model: models.video("lucy-pro-t2v"),
+   *   prompt: "A beautiful sunset",
+   *   onStatusChange: (job) => {
+   *     console.log(`Job ${job.job_id}: ${job.status}`);
+   *   }
+   * });
+   *
+   * if (result.status === "completed") {
+   *   videoElement.src = URL.createObjectURL(result.data);
+   * } else {
+   *   console.error("Job failed:", result.error);
+   * }
+   * ```
+   */
+  submitAndPoll: <T extends ModelDefinition>(options: QueueSubmitAndPollOptions<T>) => Promise<QueueJobResult>;
+};
+//#endregion
+export { QueueClient };

package/dist/queue/client.js

@@ -0,0 +1,73 @@
+import { createInvalidInputError } from "../utils/errors.js";
+import { fileInputToBlob } from "../shared/request.js";
+import { pollUntilComplete } from "./polling.js";
+import { getJobContent, getJobStatus, submitJob } from "./request.js";
+
+//#region src/queue/client.ts
+const createQueueClient = (opts) => {
+	const { apiKey, baseUrl, integration } = opts;
+	const submit = async (options) => {
+		const { model, signal,...inputs } = options;
+		const parsedInputs = model.inputSchema.safeParse(inputs);
+		if (!parsedInputs.success) throw createInvalidInputError(`Invalid inputs for ${model.name}: ${parsedInputs.error.message}`);
+		const processedInputs = {};
+		for (const [key, value] of Object.entries(parsedInputs.data)) if (key === "data" || key === "start" || key === "end") processedInputs[key] = await fileInputToBlob(value);
+		else processedInputs[key] = value;
+		return submitJob({
+			baseUrl,
+			apiKey,
+			model,
+			inputs: processedInputs,
+			signal,
+			integration
+		});
+	};
+	const status = async (jobId) => {
+		return getJobStatus({
+			baseUrl,
+			apiKey,
+			jobId,
+			integration
+		});
+	};
+	const result = async (jobId) => {
+		return getJobContent({
+			baseUrl,
+			apiKey,
+			jobId,
+			integration
+		});
+	};
+	const submitAndPoll = async (options) => {
+		const { onStatusChange, signal,...submitOptions } = options;
+		const job = await submit(submitOptions);
+		if (onStatusChange) onStatusChange(job);
+		return pollUntilComplete({
+			checkStatus: () => getJobStatus({
+				baseUrl,
+				apiKey,
+				jobId: job.job_id,
+				signal,
+				integration
+			}),
+			getContent: () => getJobContent({
+				baseUrl,
+				apiKey,
+				jobId: job.job_id,
+				signal,
+				integration
+			}),
+			onStatusChange,
+			signal
+		});
+	};
+	return {
+		submit,
+		status,
+		result,
+		submitAndPoll
+	};
+};
+
+//#endregion
+export { createQueueClient };

package/dist/queue/polling.js

@@ -0,0 +1,35 @@
+//#region src/queue/polling.ts
+const POLLING_DEFAULTS = {
+	interval: 1500,
+	initialDelay: 500
+};
+/**
+* Sleep for a given number of milliseconds.
+*/
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+* Poll until the job is completed or failed.
+* No timeout - backend returns "failed" after 10 minutes.
+*/
+async function pollUntilComplete({ checkStatus, getContent, onStatusChange, signal }) {
+	await sleep(POLLING_DEFAULTS.initialDelay);
+	while (true) {
+		if (signal?.aborted) throw new Error("Polling aborted");
+		const status = await checkStatus();
+		if (onStatusChange) onStatusChange(status);
+		if (status.status === "completed") return {
+			status: "completed",
+			data: await getContent()
+		};
+		if (status.status === "failed") return {
+			status: "failed",
+			error: "Job failed"
+		};
+		await sleep(POLLING_DEFAULTS.interval);
+	}
+}
+
+//#endregion
+export { pollUntilComplete };

package/dist/queue/request.js

@@ -0,0 +1,61 @@
+import { createQueueResultError, createQueueStatusError, createQueueSubmitError } from "../utils/errors.js";
+import { buildAuthHeaders, buildFormData } from "../shared/request.js";
+
+//#region src/queue/request.ts
+/**
+* Submit a job to the queue.
+* POST /v1/jobs/{model}
+*/
+async function submitJob({ baseUrl, apiKey, model, inputs, signal, integration }) {
+	const formData = buildFormData(inputs);
+	if (!model.queueUrlPath) throw createQueueSubmitError(`Model ${model.name} does not support queue processing`, 400);
+	const endpoint = `${baseUrl}${model.queueUrlPath}`;
+	const response = await fetch(endpoint, {
+		method: "POST",
+		headers: buildAuthHeaders(apiKey, integration),
+		body: formData,
+		signal
+	});
+	if (!response.ok) {
+		const errorText = await response.text().catch(() => "Unknown error");
+		throw createQueueSubmitError(`Failed to submit job: ${response.status} - ${errorText}`, response.status);
+	}
+	return response.json();
+}
+/**
+* Get the status of a job.
+* GET /v1/jobs/{job_id}
+*/
+async function getJobStatus({ baseUrl, apiKey, jobId, signal, integration }) {
+	const endpoint = `${baseUrl}/v1/jobs/${jobId}`;
+	const response = await fetch(endpoint, {
+		method: "GET",
+		headers: buildAuthHeaders(apiKey, integration),
+		signal
+	});
+	if (!response.ok) {
+		const errorText = await response.text().catch(() => "Unknown error");
+		throw createQueueStatusError(`Failed to get job status: ${response.status} - ${errorText}`, response.status);
+	}
+	return response.json();
+}
+/**
+* Get the content/result of a completed job.
+* GET /v1/jobs/{job_id}/content
+*/
+async function getJobContent({ baseUrl, apiKey, jobId, signal, integration }) {
+	const endpoint = `${baseUrl}/v1/jobs/${jobId}/content`;
+	const response = await fetch(endpoint, {
+		method: "GET",
+		headers: buildAuthHeaders(apiKey, integration),
+		signal
+	});
+	if (!response.ok) {
+		const errorText = await response.text().catch(() => "Unknown error");
+		throw createQueueResultError(`Failed to get job content: ${response.status} - ${errorText}`, response.status);
+	}
+	return response.blob();
+}
+
+//#endregion
+export { getJobContent, getJobStatus, submitJob };

package/dist/queue/types.d.ts

@@ -0,0 +1,79 @@
+import { ModelDefinition } from "../shared/model.js";
+import { FileInput, InferModelInputs, ModelSpecificInputs, ProcessInputs } from "../process/types.js";
+
+//#region src/queue/types.d.ts
+
+/**
+ * Job status values returned by the queue API.
+ */
+type JobStatus = "pending" | "processing" | "completed" | "failed";
+/**
+ * Response from POST /v1/jobs/{model} - job submission.
+ */
+type JobSubmitResponse = {
+  job_id: string;
+  status: JobStatus;
+};
+/**
+ * Response from GET /v1/jobs/{job_id} - job status check.
+ */
+type JobStatusResponse = {
+  job_id: string;
+  status: JobStatus;
+};
+/**
+ * Result from submitAndPoll - discriminated union for success/failure.
+ */
+type QueueJobResult = {
+  status: "completed";
+  data: Blob;
+} | {
+  status: "failed";
+  error: string;
+};
+/**
+ * Queue-specific inputs extending ProcessInputs.
+ * Re-exports ProcessInputs fields with queue-specific documentation.
+ */
+interface QueueInputs extends ProcessInputs {
+  /**
+   * The data to use for generation (for image-to-image and video-to-video).
+   */
+  data?: FileInput;
+  /**
+   * The start frame image (for first-last-frame models).
+   */
+  start?: FileInput;
+  /**
+   * The end frame image (for first-last-frame models).
+   */
+  end?: FileInput;
+}
+type ModelSpecificQueueInputs<T extends ModelDefinition> = QueueInputs & ModelSpecificInputs<T>;
+type PickDocumentedInputs<T extends ModelDefinition> = Pick<ModelSpecificQueueInputs<T>, keyof ModelSpecificQueueInputs<T> & keyof InferModelInputs<T>>;
+type MergeDocumentedInputs<T extends ModelDefinition> = PickDocumentedInputs<T> & InferModelInputs<T>;
+/**
+ * Options for queue.submit() - submit a job for async processing.
+ */
+type QueueSubmitOptions<T extends ModelDefinition = ModelDefinition> = {
+  /**
+   * The model definition to use.
+   */
+  model: T;
+  /**
+   * Optional `AbortSignal` for canceling the request.
+   */
+  signal?: AbortSignal;
+} & MergeDocumentedInputs<T>;
+/**
+ * Options for queue.submitAndPoll() - submit and wait for completion.
+ */
+type QueueSubmitAndPollOptions<T extends ModelDefinition = ModelDefinition> = QueueSubmitOptions<T> & {
+  /**
+   * Callback invoked when job status changes during polling.
+   * Receives the full job status response object.
+   */
+  onStatusChange?: (job: JobStatusResponse) => void;
+};
+//#endregion
+export { JobStatus, JobStatusResponse, JobSubmitResponse, QueueJobResult, QueueSubmitAndPollOptions, QueueSubmitOptions };

package/dist/realtime/client.d.ts

@@ -15,6 +15,7 @@ declare const realTimeClientConnectOptionsSchema: z.ZodObject<{
   model: z.ZodObject<{
     name: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"mirage">, z.ZodLiteral<"mirage_v2">, z.ZodLiteral<"lucy_v2v_720p_rt">]>, z.ZodUnion<readonly [z.ZodLiteral<"lucy-dev-i2v">, z.ZodLiteral<"lucy-fast-v2v">, z.ZodLiteral<"lucy-pro-t2v">, z.ZodLiteral<"lucy-pro-i2v">, z.ZodLiteral<"lucy-pro-v2v">, z.ZodLiteral<"lucy-pro-flf2v">, z.ZodLiteral<"lucy-motion">]>, z.ZodUnion<readonly [z.ZodLiteral<"lucy-pro-t2i">, z.ZodLiteral<"lucy-pro-i2i">]>]>;
     urlPath: z.ZodString;
+    queueUrlPath: z.ZodOptional<z.ZodString>;
     fps: z.ZodNumber;
     width: z.ZodNumber;
     height: z.ZodNumber;
@@ -39,12 +40,12 @@ type RealTimeClient = {
     enhance
   }?: {
     enhance?: boolean;
-  }) => void;
+  }) => Promise<void>;
   isConnected: () => boolean;
   getConnectionState: () => "connected" | "connecting" | "disconnected";
   disconnect: () => void;
-  on: (event: keyof Events, listener: (...args: Events[keyof Events][]) => void) => void;
-  off: (event: keyof Events, listener: (...args: Events[keyof Events][]) => void) => void;
+  on: <K extends keyof Events>(event: K, listener: (data: Events[K]) => void) => void;
+  off: <K extends keyof Events>(event: K, listener: (data: Events[K]) => void) => void;
   sessionId: string;
 };
 //#endregion

package/dist/realtime/methods.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
 
 //#region src/realtime/methods.ts
+const PROMPT_TIMEOUT_MS = 15 * 1e3;
 const realtimeMethods = (webrtcManager) => {
-	const setPrompt = (prompt, { enhance } = {}) => {
+	const setPrompt = async (prompt, { enhance } = {}) => {
 		const parsedInput = z.object({
 			prompt: z.string().min(1),
 			enhance: z.boolean().optional().default(true)
@@ -11,11 +12,30 @@ const realtimeMethods = (webrtcManager) => {
 			enhance
 		});
 		if (!parsedInput.success) throw parsedInput.error;
-		webrtcManager.sendMessage({
-			type: "prompt",
-			prompt: parsedInput.data.prompt,
-			enhance_prompt: parsedInput.data.enhance
-		});
+		const emitter = webrtcManager.getWebsocketMessageEmitter();
+		let promptAckListener;
+		let timeoutId;
+		try {
+			const ackPromise = new Promise((resolve, reject) => {
+				promptAckListener = (promptAckMessage) => {
+					if (promptAckMessage.prompt === parsedInput.data.prompt) if (promptAckMessage.success) resolve();
+					else reject(promptAckMessage.error);
+				};
+				emitter.on("promptAck", promptAckListener);
+			});
+			webrtcManager.sendMessage({
+				type: "prompt",
+				prompt: parsedInput.data.prompt,
+				enhance_prompt: parsedInput.data.enhance
+			});
+			const timeoutPromise = new Promise((_, reject) => {
+				timeoutId = setTimeout(() => reject(/* @__PURE__ */ new Error("Prompt timed out")), PROMPT_TIMEOUT_MS);
+			});
+			await Promise.race([ackPromise, timeoutPromise]);
+		} finally {
+			if (promptAckListener) emitter.off("promptAck", promptAckListener);
+			if (timeoutId) clearTimeout(timeoutId);
+		}
 	};
 	return { setPrompt };
 };

package/dist/realtime/webrtc-connection.js

@@ -1,4 +1,5 @@
 import { buildUserAgent } from "../utils/user-agent.js";
+import mitt from "mitt";
 
 //#region src/realtime/webrtc-connection.ts
 const ICE_SERVERS = [{ urls: "stun:stun.l.google.com:19302" }];
@@ -8,6 +9,7 @@ var WebRTCConnection = class {
 	localStream = null;
 	connectionReject = null;
 	state = "disconnected";
+	websocketMessagesEmitter = mitt();
 	constructor(callbacks = {}) {
 		this.callbacks = callbacks;
 	}
@@ -105,6 +107,9 @@ var WebRTCConnection = class {
 					if (turnConfig) await this.setupNewPeerConnection(turnConfig);
 					break;
 				}
+				case "prompt_ack":
+					this.websocketMessagesEmitter.emit("promptAck", msg);
+					break;
 			}
 		} catch (error) {
 			console.error("[WebRTC] Error:", error);

package/dist/realtime/webrtc-manager.js

@@ -55,6 +55,9 @@ var WebRTCManager = class {
 	getConnectionState() {
 		return this.connection.state;
 	}
+	getWebsocketMessageEmitter() {
+		return this.connection.websocketMessagesEmitter;
+	}
 };
 
 //#endregion

package/dist/shared/model.d.ts

@@ -93,6 +93,7 @@ type ModelInputSchemas = typeof modelInputSchemas;
 type ModelDefinition<T extends Model = Model> = {
   name: T;
   urlPath: string;
+  queueUrlPath?: string;
   fps: number;
   width: number;
   height: number;

package/dist/shared/model.js

@@ -116,6 +116,7 @@ const modelInputSchemas = {
 const modelDefinitionSchema = z.object({
 	name: modelSchema,
 	urlPath: z.string(),
+	queueUrlPath: z.string().optional(),
 	fps: z.number().min(1),
 	width: z.number().min(1),
 	height: z.number().min(1),
@@ -151,6 +152,7 @@ const _models = {
 	image: {
 		"lucy-pro-t2i": {
 			urlPath: "/v1/generate/lucy-pro-t2i",
+			queueUrlPath: "/v1/jobs/lucy-pro-t2i",
 			name: "lucy-pro-t2i",
 			fps: 25,
 			width: 1280,
@@ -159,6 +161,7 @@ const _models = {
 		},
 		"lucy-pro-i2i": {
 			urlPath: "/v1/generate/lucy-pro-i2i",
+			queueUrlPath: "/v1/jobs/lucy-pro-i2i",
 			name: "lucy-pro-i2i",
 			fps: 25,
 			width: 1280,
@@ -169,6 +172,7 @@ const _models = {
 	video: {
 		"lucy-dev-i2v": {
 			urlPath: "/v1/generate/lucy-dev-i2v",
+			queueUrlPath: "/v1/jobs/lucy-dev-i2v",
 			name: "lucy-dev-i2v",
 			fps: 25,
 			width: 1280,
@@ -177,6 +181,7 @@ const _models = {
 		},
 		"lucy-fast-v2v": {
 			urlPath: "/v1/generate/lucy-fast-v2v",
+			queueUrlPath: "/v1/jobs/lucy-fast-v2v",
 			name: "lucy-fast-v2v",
 			fps: 25,
 			width: 1280,
@@ -185,6 +190,7 @@ const _models = {
 		},
 		"lucy-pro-t2v": {
 			urlPath: "/v1/generate/lucy-pro-t2v",
+			queueUrlPath: "/v1/jobs/lucy-pro-t2v",
 			name: "lucy-pro-t2v",
 			fps: 25,
 			width: 1280,
@@ -193,6 +199,7 @@ const _models = {
 		},
 		"lucy-pro-i2v": {
 			urlPath: "/v1/generate/lucy-pro-i2v",
+			queueUrlPath: "/v1/jobs/lucy-pro-i2v",
 			name: "lucy-pro-i2v",
 			fps: 25,
 			width: 1280,
@@ -201,6 +208,7 @@ const _models = {
 		},
 		"lucy-pro-v2v": {
 			urlPath: "/v1/generate/lucy-pro-v2v",
+			queueUrlPath: "/v1/jobs/lucy-pro-v2v",
 			name: "lucy-pro-v2v",
 			fps: 25,
 			width: 1280,
@@ -209,6 +217,7 @@ const _models = {
 		},
 		"lucy-pro-flf2v": {
 			urlPath: "/v1/generate/lucy-pro-flf2v",
+			queueUrlPath: "/v1/jobs/lucy-pro-flf2v",
 			name: "lucy-pro-flf2v",
 			fps: 25,
 			width: 1280,
@@ -217,6 +226,7 @@ const _models = {
 		},
 		"lucy-motion": {
 			urlPath: "/v1/generate/lucy-motion",
+			queueUrlPath: "/v1/jobs/lucy-motion",
 			name: "lucy-motion",
 			fps: 25,
 			width: 1280,

package/dist/shared/request.js

@@ -0,0 +1,41 @@
+import { createInvalidInputError } from "../utils/errors.js";
+import { buildUserAgent } from "../utils/user-agent.js";
+
+//#region src/shared/request.ts
+/**
+* Convert various file input types to a Blob.
+*/
+async function fileInputToBlob(input) {
+	if (input instanceof Blob || input instanceof File) return input;
+	if (input instanceof ReadableStream) return new Response(input).blob();
+	if (typeof input === "string" || input instanceof URL) {
+		const url = typeof input === "string" ? input : input.toString();
+		if (!url.startsWith("http://") && !url.startsWith("https://")) throw createInvalidInputError("URL must start with http:// or https://");
+		const response = await fetch(url);
+		if (!response.ok) throw createInvalidInputError(`Failed to fetch file from URL: ${response.statusText}`);
+		return response.blob();
+	}
+	throw createInvalidInputError("Invalid file input type");
+}
+/**
+* Build common headers for API requests.
+*/
+function buildAuthHeaders(apiKey, integration) {
+	return {
+		"X-API-KEY": apiKey,
+		"User-Agent": buildUserAgent(integration)
+	};
+}
+/**
+* Build FormData from inputs object.
+*/
+function buildFormData(inputs) {
+	const formData = new FormData();
+	for (const [key, value] of Object.entries(inputs)) if (value !== void 0 && value !== null) if (value instanceof Blob) formData.append(key, value);
+	else if (typeof value === "object" && value !== null) formData.append(key, JSON.stringify(value));
+	else formData.append(key, String(value));
+	return formData;
+}
+
+//#endregion
+export { buildAuthHeaders, buildFormData, fileInputToBlob };

package/dist/utils/errors.d.ts

@@ -13,6 +13,10 @@ declare const ERROR_CODES: {
   readonly INVALID_INPUT: "INVALID_INPUT";
   readonly INVALID_OPTIONS: "INVALID_OPTIONS";
   readonly MODEL_NOT_FOUND: "MODEL_NOT_FOUND";
+  readonly QUEUE_SUBMIT_ERROR: "QUEUE_SUBMIT_ERROR";
+  readonly QUEUE_STATUS_ERROR: "QUEUE_STATUS_ERROR";
+  readonly QUEUE_RESULT_ERROR: "QUEUE_RESULT_ERROR";
+  readonly JOB_NOT_COMPLETED: "JOB_NOT_COMPLETED";
 };
 //#endregion
 export { DecartSDKError, ERROR_CODES };

package/dist/utils/errors.js

@@ -6,7 +6,11 @@ const ERROR_CODES = {
 	PROCESSING_ERROR: "PROCESSING_ERROR",
 	INVALID_INPUT: "INVALID_INPUT",
 	INVALID_OPTIONS: "INVALID_OPTIONS",
-	MODEL_NOT_FOUND: "MODEL_NOT_FOUND"
+	MODEL_NOT_FOUND: "MODEL_NOT_FOUND",
+	QUEUE_SUBMIT_ERROR: "QUEUE_SUBMIT_ERROR",
+	QUEUE_STATUS_ERROR: "QUEUE_STATUS_ERROR",
+	QUEUE_RESULT_ERROR: "QUEUE_RESULT_ERROR",
+	JOB_NOT_COMPLETED: "JOB_NOT_COMPLETED"
 };
 function createSDKError(code, message, data, cause) {
 	return {
@@ -31,6 +35,15 @@ function createInvalidInputError(message) {
 function createModelNotFoundError(model) {
 	return createSDKError(ERROR_CODES.MODEL_NOT_FOUND, `Model ${model} not found`);
 }
+function createQueueSubmitError(message, status) {
+	return createSDKError(ERROR_CODES.QUEUE_SUBMIT_ERROR, message, { status });
+}
+function createQueueStatusError(message, status) {
+	return createSDKError(ERROR_CODES.QUEUE_STATUS_ERROR, message, { status });
+}
+function createQueueResultError(message, status) {
+	return createSDKError(ERROR_CODES.QUEUE_RESULT_ERROR, message, { status });
+}
 
 //#endregion
-export { ERROR_CODES, createInvalidApiKeyError, createInvalidBaseUrlError, createInvalidInputError, createModelNotFoundError, createSDKError, createWebrtcError };
+export { ERROR_CODES, createInvalidApiKeyError, createInvalidBaseUrlError, createInvalidInputError, createModelNotFoundError, createQueueResultError, createQueueStatusError, createQueueSubmitError, createSDKError, createWebrtcError };

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.18";
+const VERSION = "0.0.20";
 
 //#endregion
 export { VERSION };

package/package.json

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