@decartai/sdk 0.0.50 → 0.0.52

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { LogLevel, Logger, createConsoleLogger, noopLogger } from "./utils/logger.js";
-import { ImageModelDefinition, ImageModels, Model, ModelDefinition, RealTimeModels, VideoModelDefinition, VideoModels, isImageModel, isRealtimeModel, isVideoModel, models } from "./shared/model.js";
+import { CustomModelDefinition, ImageModelDefinition, ImageModels, Model, ModelDefinition, RealTimeModels, VideoModelDefinition, VideoModels, isImageModel, isRealtimeModel, isVideoModel, models } from "./shared/model.js";
 import { FileInput, ProcessOptions, ReactNativeFile } from "./process/types.js";
 import { ProcessClient } from "./process/client.js";
 import { JobStatus, JobStatusResponse, JobSubmitResponse, QueueJobResult, QueueSubmitAndPollOptions, QueueSubmitOptions } from "./queue/types.js";
@@ -19,6 +19,7 @@ type DecartClientOptions = {
   proxy: string;
   apiKey?: never;
   baseUrl?: string;
+  realtimeBaseUrl?: string;
   integration?: string;
   logger?: Logger;
   telemetry?: boolean;
@@ -26,6 +27,7 @@ type DecartClientOptions = {
   proxy?: never;
   apiKey?: string;
   baseUrl?: string;
+  realtimeBaseUrl?: string;
   integration?: string;
   logger?: Logger;
   telemetry?: boolean;
@@ -37,6 +39,7 @@ type DecartClientOptions = {
  * @param options.proxy - URL of the proxy server. When set, the client will use the proxy instead of direct API access and apiKey is not required.
  * @param options.apiKey - API key for authentication.
  * @param options.baseUrl - Override the default API base URL.
+ * @param options.realtimeBaseUrl - Override the default WebSocket base URL for realtime connections.
  * @param options.integration - Optional integration identifier.
  *
  * @example
@@ -128,4 +131,4 @@ declare const createDecartClient: (options?: DecartClientOptions) => {
   tokens: TokensClient;
 };
 //#endregion
-export { type ConnectionPhase, type ConnectionState, type CreateTokenOptions, type CreateTokenResponse, DecartClientOptions, type DecartSDKError, type DiagnosticEvent, type DiagnosticEventName, type DiagnosticEvents, ERROR_CODES, type FileInput, type IceCandidateEvent, type IceStateEvent, type ImageModelDefinition, type ImageModels, type JobStatus, type JobStatusResponse, type JobSubmitResponse, type LogLevel, type Logger, type Model, type ModelDefinition, type ModelState, type PeerConnectionStateEvent, type PhaseTimingEvent, type ProcessClient, type ProcessOptions, type QueueClient, type QueueJobResult, type QueueSubmitAndPollOptions, type QueueSubmitOptions, type ReactNativeFile, type RealTimeClient, type RealTimeClientConnectOptions, type RealTimeClientInitialState, type Events as RealTimeEvents, type RealTimeModels, type RealTimeSubscribeClient, type ReconnectEvent, type SelectedCandidatePairEvent, type SetInput, type SignalingStateEvent, type SubscribeEvents, type SubscribeOptions, type TokensClient, type VideoModelDefinition, type VideoModels, type VideoStallEvent, type WebRTCStats, createConsoleLogger, createDecartClient, isImageModel, isRealtimeModel, isVideoModel, models, noopLogger };
+export { type ConnectionPhase, type ConnectionState, type CreateTokenOptions, type CreateTokenResponse, type CustomModelDefinition, DecartClientOptions, type DecartSDKError, type DiagnosticEvent, type DiagnosticEventName, type DiagnosticEvents, ERROR_CODES, type FileInput, type IceCandidateEvent, type IceStateEvent, type ImageModelDefinition, type ImageModels, type JobStatus, type JobStatusResponse, type JobSubmitResponse, type LogLevel, type Logger, type Model, type ModelDefinition, type ModelState, type PeerConnectionStateEvent, type PhaseTimingEvent, type ProcessClient, type ProcessOptions, type QueueClient, type QueueJobResult, type QueueSubmitAndPollOptions, type QueueSubmitOptions, type ReactNativeFile, type RealTimeClient, type RealTimeClientConnectOptions, type RealTimeClientInitialState, type Events as RealTimeEvents, type RealTimeModels, type RealTimeSubscribeClient, type ReconnectEvent, type SelectedCandidatePairEvent, type SetInput, type SignalingStateEvent, type SubscribeEvents, type SubscribeOptions, type TokensClient, type VideoModelDefinition, type VideoModels, type VideoStallEvent, type WebRTCStats, createConsoleLogger, createDecartClient, isImageModel, isRealtimeModel, isVideoModel, models, noopLogger };

package/dist/index.js

@@ -14,7 +14,8 @@ const decartClientOptionsSchema = z.object({
 	apiKey: z.string().min(1).optional(),
 	baseUrl: z.url().optional(),
 	proxy: proxySchema.optional(),
-	integration: z.string().optional()
+	integration: z.string().optional(),
+	realtimeBaseUrl: z.url().optional()
 }).refine((data) => {
 	const hasProxy = !!data.proxy;
 	const hasApiKey = !!data.apiKey;
@@ -27,6 +28,7 @@ const decartClientOptionsSchema = z.object({
 * @param options.proxy - URL of the proxy server. When set, the client will use the proxy instead of direct API access and apiKey is not required.
 * @param options.apiKey - API key for authentication.
 * @param options.baseUrl - Override the default API base URL.
+* @param options.realtimeBaseUrl - Override the default WebSocket base URL for realtime connections.
 * @param options.integration - Optional integration identifier.
 *
 * @example
@@ -46,7 +48,7 @@ const createDecartClient = (options = {}) => {
 	if (!parsedOptions.success) {
 		const issue = parsedOptions.error.issues[0];
 		if (issue.path.includes("apiKey")) throw createInvalidApiKeyError();
-		if (issue.path.includes("baseUrl")) throw createInvalidBaseUrlError(issue.path.includes("baseUrl") ? options.baseUrl : void 0);
+		if (issue.path.includes("baseUrl") || issue.path.includes("realtimeBaseUrl")) throw createInvalidBaseUrlError(options[issue.path.includes("realtimeBaseUrl") ? "realtimeBaseUrl" : "baseUrl"]);
 		if (issue.path.includes("proxy")) throw createInvalidBaseUrlError(issue.path.includes("proxy") ? options.proxy : void 0);
 		throw parsedOptions.error;
 	}
@@ -61,7 +63,7 @@ const createDecartClient = (options = {}) => {
 	const telemetryEnabled = "telemetry" in options && options.telemetry === false ? false : true;
 	return {
 		realtime: createRealTimeClient({
-			baseUrl: "wss://api3.decart.ai",
+			baseUrl: parsedOptions.data.realtimeBaseUrl || "wss://api3.decart.ai",
 			apiKey: apiKey || "",
 			integration,
 			logger,

package/dist/realtime/client.d.ts

@@ -1,3 +1,4 @@
+import { CustomModelDefinition, ModelDefinition } from "../shared/model.js";
 import { DecartSDKError } from "../utils/errors.js";
 import { DiagnosticEvent } from "./diagnostics.js";
 import { ConnectionState } from "./types.js";
@@ -18,7 +19,7 @@ type OnRemoteStreamFn = (stream: MediaStream) => void;
 type RealTimeClientInitialState = z.infer<typeof realTimeClientInitialStateSchema>;
 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.ZodLiteral<"lucy_2_rt">, z.ZodLiteral<"live_avatar">]>, 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.ZodLiteral<"lucy-restyle-v2v">]>, z.ZodUnion<readonly [z.ZodLiteral<"lucy-pro-t2i">, z.ZodLiteral<"lucy-pro-i2i">]>]>;
+    name: z.ZodString;
     urlPath: z.ZodString;
     queueUrlPath: z.ZodOptional<z.ZodString>;
     fps: z.ZodNumber;
@@ -36,7 +37,9 @@ declare const realTimeClientConnectOptionsSchema: z.ZodObject<{
   }, z.core.$strip>>;
   customizeOffer: z.ZodOptional<z.ZodCustom<z.core.$InferInnerFunctionTypeAsync<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>, z.core.$InferInnerFunctionTypeAsync<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>>>;
 }, z.core.$strip>;
-type RealTimeClientConnectOptions = z.infer<typeof realTimeClientConnectOptionsSchema>;
+type RealTimeClientConnectOptions = Omit<z.infer<typeof realTimeClientConnectOptionsSchema>, "model"> & {
+  model: ModelDefinition | CustomModelDefinition;
+};
 type Events = {
   connectionChange: ConnectionState;
   error: DecartSDKError;

package/dist/realtime/webrtc-connection.js

@@ -98,6 +98,14 @@ var WebRTCConnection = class {
 					durationMs: performance.now() - promptStart,
 					success: true
 				});
+			} else if (localStream) {
+				const nullStart = performance.now();
+				await Promise.race([this.setImageBase64(null, { prompt: null }), connectAbort]);
+				this.emitDiagnostic("phaseTiming", {
+					phase: "initial-prompt",
+					durationMs: performance.now() - nullStart,
+					success: true
+				});
 			}
 			const handshakeStart = performance.now();
 			await this.setupNewPeerConnection();

package/dist/shared/model.d.ts

@@ -154,6 +154,14 @@ type ModelDefinition<T extends Model = Model> = {
   height: number;
   inputSchema: T extends keyof ModelInputSchemas ? ModelInputSchemas[T] : z.ZodTypeAny;
 };
+/**
+ * A model definition with an arbitrary (non-registry) model name.
+ * Use this when providing your own model configuration.
+ */
+type CustomModelDefinition = Omit<ModelDefinition, "name" | "inputSchema"> & {
+  name: string;
+  inputSchema?: z.ZodTypeAny;
+};
 /**
  * Type alias for model definitions that support synchronous processing.
  * Only image models support the sync/process API.
@@ -189,4 +197,4 @@ declare const models: {
   image: <T extends ImageModels>(model: T) => ModelDefinition<T>;
 };
 //#endregion
-export { ImageModelDefinition, ImageModels, Model, ModelDefinition, ModelInputSchemas, RealTimeModels, VideoModelDefinition, VideoModels, isImageModel, isRealtimeModel, isVideoModel, models };
+export { CustomModelDefinition, ImageModelDefinition, ImageModels, Model, ModelDefinition, ModelInputSchemas, RealTimeModels, VideoModelDefinition, VideoModels, isImageModel, isRealtimeModel, isVideoModel, models };

package/dist/shared/model.js

@@ -139,7 +139,7 @@ const modelInputSchemas = {
 	}).refine((data) => data.prompt !== void 0 !== (data.reference_image !== void 0), { message: "Must provide either 'prompt' or 'reference_image', but not both" }).refine((data) => !(data.reference_image !== void 0 && data.enhance_prompt !== void 0), { message: "'enhance_prompt' is only valid when using 'prompt', not 'reference_image'" })
 };
 const modelDefinitionSchema = z.object({
-	name: modelSchema,
+	name: z.string(),
 	urlPath: z.string(),
 	queueUrlPath: z.string().optional(),
 	fps: z.number().min(1),

package/package.json

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