@decartai/sdk 0.0.68 → 0.1.0

package/dist/realtime/types.d.ts

@@ -1,5 +1,29 @@
 //#region src/realtime/types.d.ts
 
+type GenerationEndedMessage = GenerationEnded & {
+  type: "generation_ended";
+};
+type QueuePositionMessage = {
+  type: "queue_position";
+  position: number;
+  queue_size: number;
+};
+type QueuePosition = {
+  position: number;
+  queueSize: number;
+};
 type ConnectionState = "connecting" | "connected" | "generating" | "disconnected" | "reconnecting";
+type GenerationTick = {
+  seconds: number;
+};
+type GenerationEnded = {
+  seconds: number;
+  reason: string;
+};
+type ImageSetOptions = {
+  prompt?: string | null;
+  enhance?: boolean;
+  timeout?: number;
+};
 //#endregion
-export { ConnectionState };
+export { ConnectionState, GenerationEnded, GenerationEndedMessage, GenerationTick, ImageSetOptions, QueuePosition, QueuePositionMessage };

package/dist/shared/model.d.ts

@@ -318,11 +318,17 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
 };
 type ModelInputSchemas = typeof modelInputSchemas;
+type ModelFps = number | {
+  max?: number;
+  min?: number;
+  ideal?: number;
+  exact?: number;
+};
 type ModelDefinition<T extends Model = Model> = {
   name: T;
   urlPath: string;
   queueUrlPath?: string;
-  fps: number;
+  fps: ModelFps;
   width: number;
   height: number;
   inputSchema: T extends keyof ModelInputSchemas ? ModelInputSchemas[T] : z.ZodTypeAny;
@@ -341,6 +347,7 @@ type CustomModelDefinition = Omit<ModelDefinition, "name" | "inputSchema"> & {
  * Requires `queueUrlPath` to distinguish from realtime definitions of the same model name.
  */
 type ImageModelDefinition = ModelDefinition<ImageModels> & {
+  fps: number;
   queueUrlPath: string;
 };
 /**
@@ -349,6 +356,7 @@ type ImageModelDefinition = ModelDefinition<ImageModels> & {
  * Requires `queueUrlPath` to distinguish from realtime definitions of the same model name.
  */
 type VideoModelDefinition = ModelDefinition<VideoModels> & {
+  fps: number;
   queueUrlPath: string;
 };
 type ModelKind = "realtime" | "video" | "image";
@@ -386,6 +394,7 @@ declare const models: {
    *   - `"lucy-restyle-2"` - Video restyling
    */
   video: <T extends VideoModels>(model: T) => ModelDefinition<T> & {
+    fps: number;
     queueUrlPath: string;
   };
   /**
@@ -395,6 +404,7 @@ declare const models: {
    *   - `"lucy-image-2"` - Image-to-image editing
    */
   image: <T extends ImageModels>(model: T) => ModelDefinition<T> & {
+    fps: number;
     queueUrlPath: string;
   };
 };

package/dist/shared/model.js

@@ -1,6 +1,5 @@
 import { createModelNotFoundError } from "../utils/errors.js";
 import { z } from "zod";
-
 //#region src/shared/model.ts
 const CANONICAL_MODEL_NAMES = [
 	"lucy-2.1",
@@ -195,11 +194,20 @@ const modelInputSchemas = {
 	"lucy-pro-i2i": imageEditSchema,
 	"lucy-restyle-v2v": restyleSchema
 };
+function resolveFpsNumber(fps, fallback = 30) {
+	if (typeof fps === "number") return fps;
+	return fps.ideal ?? fps.max ?? fps.exact ?? fps.min ?? fallback;
+}
 const modelDefinitionSchema = z.object({
 	name: z.string(),
 	urlPath: z.string(),
 	queueUrlPath: z.string().optional(),
-	fps: z.number().min(1),
+	fps: z.union([z.number().min(1), z.object({
+		max: z.number().min(1).optional(),
+		min: z.number().min(1).optional(),
+		ideal: z.number().min(1).optional(),
+		exact: z.number().min(1).optional()
+	})]),
 	width: z.number().min(1),
 	height: z.number().min(1),
 	inputSchema: z.any().optional()
@@ -209,7 +217,10 @@ const _models = {
 		"lucy-2.1": {
 			urlPath: "/v1/stream",
 			name: "lucy-2.1",
-			fps: 20,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1088,
 			height: 624,
 			inputSchema: z.object({})
@@ -217,7 +228,10 @@ const _models = {
 		"lucy-2.1-vton": {
 			urlPath: "/v1/stream",
 			name: "lucy-2.1-vton",
-			fps: 20,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1088,
 			height: 624,
 			inputSchema: z.object({})
@@ -225,7 +239,10 @@ const _models = {
 		"lucy-vton-2": {
 			urlPath: "/v1/stream",
 			name: "lucy-vton-2",
-			fps: 20,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1088,
 			height: 624,
 			inputSchema: z.object({})
@@ -233,7 +250,10 @@ const _models = {
 		"lucy-restyle-2": {
 			urlPath: "/v1/stream",
 			name: "lucy-restyle-2",
-			fps: 22,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1280,
 			height: 704,
 			inputSchema: z.object({})
@@ -241,7 +261,10 @@ const _models = {
 		"lucy-latest": {
 			urlPath: "/v1/stream",
 			name: "lucy-latest",
-			fps: 20,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1088,
 			height: 624,
 			inputSchema: z.object({})
@@ -249,7 +272,10 @@ const _models = {
 		"lucy-vton-latest": {
 			urlPath: "/v1/stream",
 			name: "lucy-vton-latest",
-			fps: 20,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1088,
 			height: 624,
 			inputSchema: z.object({})
@@ -257,7 +283,10 @@ const _models = {
 		"lucy-restyle-latest": {
 			urlPath: "/v1/stream",
 			name: "lucy-restyle-latest",
-			fps: 22,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1280,
 			height: 704,
 			inputSchema: z.object({})
@@ -265,7 +294,10 @@ const _models = {
 		mirage_v2: {
 			urlPath: "/v1/stream",
 			name: "mirage_v2",
-			fps: 22,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1280,
 			height: 704,
 			inputSchema: z.object({})
@@ -273,7 +305,10 @@ const _models = {
 		"lucy-vton": {
 			urlPath: "/v1/stream",
 			name: "lucy-vton",
-			fps: 20,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1088,
 			height: 624,
 			inputSchema: z.object({})
@@ -281,7 +316,10 @@ const _models = {
 		"lucy-2.1-vton-2": {
 			urlPath: "/v1/stream",
 			name: "lucy-2.1-vton-2",
-			fps: 20,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
 			width: 1088,
 			height: 624,
 			inputSchema: z.object({})
@@ -479,6 +517,5 @@ const models = {
 		return modelDefinition;
 	}
 };
-
 //#endregion
-export { isCanonicalModel, isImageModel, isModel, isRealtimeModel, isVideoModel, listModels, modelAliases, modelDefinitionSchema, models, resolveCanonicalModelAlias, resolveModelAlias };
+export { isCanonicalModel, isImageModel, isModel, isRealtimeModel, isVideoModel, listModels, modelAliases, modelDefinitionSchema, models, resolveCanonicalModelAlias, resolveFpsNumber, resolveModelAlias };

package/dist/shared/request.js

@@ -1,6 +1,5 @@
 import { createInvalidInputError } from "../utils/errors.js";
 import { buildUserAgent } from "../utils/user-agent.js";
-
 //#region src/shared/request.ts
 /**
 * Type guard to check if a value is a React Native file object.
@@ -46,6 +45,5 @@ function buildFormData(inputs) {
 	else formData.append(key, String(value));
 	return formData;
 }
-
 //#endregion
-export { buildAuthHeaders, buildFormData, fileInputToBlob };
+export { buildAuthHeaders, buildFormData, fileInputToBlob };

package/dist/shared/types.js

@@ -1,5 +1,4 @@
 import { z } from "zod";
-
 //#region src/shared/types.ts
 const modelStateSchema = z.object({
 	prompt: z.object({
@@ -12,6 +11,5 @@ const modelStateSchema = z.object({
 		z.string()
 	]).optional()
 });
-
 //#endregion
-export { modelStateSchema };
+export { modelStateSchema };

package/dist/tokens/client.js

@@ -1,6 +1,5 @@
 import { createSDKError } from "../utils/errors.js";
 import { buildAuthHeaders } from "../shared/request.js";
-
 //#region src/tokens/client.ts
 const createTokensClient = (opts) => {
 	const { baseUrl, apiKey, integration } = opts;
@@ -25,6 +24,5 @@ const createTokensClient = (opts) => {
 	};
 	return { create };
 };
-
 //#endregion
-export { createTokensClient };
+export { createTokensClient };

package/dist/utils/env.js

@@ -4,6 +4,5 @@ const readEnv = (env) => {
 	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 };
+export { readEnv };

package/dist/utils/errors.js

@@ -79,6 +79,5 @@ function createQueueStatusError(message, status) {
 function createQueueResultError(message, status) {
 	return createSDKError(ERROR_CODES.QUEUE_RESULT_ERROR, message, { status });
 }
-
 //#endregion
-export { ERROR_CODES, classifyWebrtcError, createInvalidApiKeyError, createInvalidBaseUrlError, createInvalidInputError, createModelNotFoundError, createQueueResultError, createQueueStatusError, createQueueSubmitError, createSDKError };
+export { ERROR_CODES, classifyWebrtcError, createInvalidApiKeyError, createInvalidBaseUrlError, createInvalidInputError, createModelNotFoundError, createQueueResultError, createQueueStatusError, createQueueSubmitError, createSDKError };

package/dist/utils/logger.js

@@ -32,6 +32,5 @@ function createConsoleLogger(minLevel = "warn") {
 		error: (msg, data) => log("error", msg, data)
 	};
 }
-
 //#endregion
-export { createConsoleLogger, noopLogger };
+export { createConsoleLogger, noopLogger };

package/dist/utils/media.js

@@ -0,0 +1,43 @@
+//#region src/utils/media.ts
+async function blobToBase64(blob) {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.onloadend = () => {
+			const result = reader.result;
+			if (typeof result !== "string") {
+				reject(/* @__PURE__ */ new Error("FileReader did not return a string"));
+				return;
+			}
+			const base64 = result.split(",")[1];
+			if (!base64) {
+				reject(/* @__PURE__ */ new Error("Invalid data URL format"));
+				return;
+			}
+			resolve(base64);
+		};
+		reader.onerror = reject;
+		reader.readAsDataURL(blob);
+	});
+}
+async function imageToBase64(image) {
+	if (typeof image === "string") {
+		let url = null;
+		try {
+			url = new URL(image);
+		} catch {}
+		if (url?.protocol === "data:") {
+			const [, base64] = image.split(",", 2);
+			if (!base64) throw new Error("Invalid data URL image");
+			return base64;
+		}
+		if (url?.protocol === "http:" || url?.protocol === "https:") {
+			const response = await fetch(image);
+			if (!response.ok) throw new Error(`Failed to fetch image: ${response.status} ${response.statusText}`);
+			return blobToBase64(await response.blob());
+		}
+		return image;
+	}
+	return blobToBase64(image);
+}
+//#endregion
+export { imageToBase64 };

package/dist/utils/platform.js

@@ -0,0 +1,13 @@
+//#region src/utils/platform.ts
+function isDesktopSafari() {
+	const g = globalThis;
+	const ua = g?.navigator?.userAgent ?? "";
+	const platform = g?.navigator?.platform ?? "";
+	const maxTouchPoints = g?.navigator?.maxTouchPoints ?? 0;
+	if (!/^((?!chrome|chromium|crios|fxios|edg|firefox|opr|opera|android).)*safari/i.test(ua)) return false;
+	if (/iPad|iPhone|iPod/.test(ua)) return false;
+	if (platform === "MacIntel" && maxTouchPoints > 1) return false;
+	return true;
+}
+//#endregion
+export { isDesktopSafari };

package/dist/utils/user-agent.js

@@ -1,5 +1,4 @@
 import { VERSION } from "../version.js";
-
 //#region src/utils/user-agent.ts
 function getRuntimeEnvironment(globalThisAny = globalThis) {
 	if (globalThisAny.window) return "runtime/browser";
@@ -27,6 +26,5 @@ function buildUserAgent(integration, globalThisAny = globalThis) {
 		getRuntimeEnvironment(globalThisAny)
 	].join(" ");
 }
-
 //#endregion
-export { buildUserAgent };
+export { buildUserAgent };

package/dist/version.js

@@ -5,6 +5,5 @@
 * Falls back to '0.0.0-dev' in development.
 */
 const VERSION = typeof __PACKAGE_VERSION__ !== "undefined" ? __PACKAGE_VERSION__ : "0.0.0-dev";
-
 //#endregion
-export { VERSION };
+export { VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decartai/sdk",
-  "version": "0.0.68",
+  "version": "0.1.0",
   "description": "Decart's JavaScript SDK",
   "type": "module",
   "license": "MIT",
@@ -43,6 +43,7 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
+    "livekit-client": "^2.0.0",
     "mitt": "^3.0.1",
     "p-retry": "^6.2.1",
     "zod": "^4.0.17"