@decartai/sdk 0.1.12 → 0.1.14

package/dist/shared/model.js

@@ -1,4 +1,5 @@
 import { createModelNotFoundError } from "../utils/errors.js";
+import { globalInstanceSchema } from "../utils/runtime.js";
 import { z } from "zod";
 //#region src/shared/model.ts
 const CANONICAL_MODEL_NAMES = [
@@ -35,7 +36,6 @@ const canonicalModelSchema = z.enum(CANONICAL_MODEL_NAMES);
 * Old names still work but will log a deprecation warning.
 */
 const modelAliases = {
-	mirage_v2: "lucy-restyle-2",
 	"lucy-2.1-vton-2": "lucy-vton-2",
 	"lucy-pro-v2v": "lucy-clip",
 	"lucy-restyle-v2v": "lucy-restyle-2",
@@ -58,7 +58,6 @@ const realtimeModels = z.union([
 	z.literal("lucy-latest"),
 	z.literal("lucy-vton-latest"),
 	z.literal("lucy-restyle-latest"),
-	z.literal("mirage_v2"),
 	z.literal("lucy-2.1-vton-2")
 ]);
 const videoModels = z.union([
@@ -124,10 +123,10 @@ function resolveCanonicalModelAlias(model) {
 	return parsedModel.success ? parsedModel.data : void 0;
 }
 const fileInputSchema = z.union([
-	z.instanceof(File),
-	z.instanceof(Blob),
-	z.instanceof(ReadableStream),
-	z.instanceof(URL),
+	globalInstanceSchema("File"),
+	globalInstanceSchema("Blob"),
+	globalInstanceSchema("ReadableStream"),
+	globalInstanceSchema("URL"),
 	z.url(),
 	z.object({
 		uri: z.string(),
@@ -230,9 +229,12 @@ const _models = {
 		"lucy-2.5": {
 			urlPath: "/v1/stream",
 			name: "lucy-2.5",
-			fps: 20,
-			width: 1088,
-			height: 624,
+			fps: {
+				ideal: 30,
+				max: 30
+			},
+			width: 1280,
+			height: 720,
 			inputSchema: z.object({})
 		},
 		"lucy-vton-2": {
@@ -301,17 +303,6 @@ const _models = {
 			height: 704,
 			inputSchema: z.object({})
 		},
-		mirage_v2: {
-			urlPath: "/v1/stream",
-			name: "mirage_v2",
-			fps: {
-				ideal: 30,
-				max: 30
-			},
-			width: 1280,
-			height: 704,
-			inputSchema: z.object({})
-		},
 		"lucy-2.1-vton-2": {
 			urlPath: "/v1/stream",
 			name: "lucy-2.1-vton-2",
@@ -377,8 +368,8 @@ const _models = {
 			queueUrlPath: "/v1/jobs/lucy-2.5",
 			name: "lucy-2.5",
 			fps: 20,
-			width: 1088,
-			height: 624,
+			width: 1280,
+			height: 720,
 			inputSchema: modelInputSchemas["lucy-2.5"]
 		},
 		"lucy-vton-2": {

package/dist/shared/request.js

@@ -1,4 +1,5 @@
 import { createInvalidInputError } from "../utils/errors.js";
+import { isGlobalInstance } from "../utils/runtime.js";
 import { buildUserAgent } from "../utils/user-agent.js";
 //#region src/shared/request.ts
 /**
@@ -13,9 +14,9 @@ function isReactNativeFile(value) {
 */
 async function fileInputToBlob(input) {
 	if (isReactNativeFile(input)) return 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) {
+	if (isGlobalInstance(input, "Blob") || isGlobalInstance(input, "File")) return input;
+	if (isGlobalInstance(input, "ReadableStream")) return new Response(input).blob();
+	if (typeof input === "string" || isGlobalInstance(input, "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);
@@ -40,7 +41,7 @@ function buildAuthHeaders(options = {}) {
 function buildFormData(inputs) {
 	const formData = new FormData();
 	for (const [key, value] of Object.entries(inputs)) if (value !== void 0 && value !== null) if (isReactNativeFile(value)) formData.append(key, value);
-	else if (value instanceof Blob) formData.append(key, value);
+	else if (isGlobalInstance(value, "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;

package/dist/shared/types.d.ts

@@ -6,7 +6,7 @@ declare const modelStateSchema: z.ZodObject<{
     text: z.ZodString;
     enhance: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>>;
-  image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Blob, Blob>, z.ZodCustom<File, File>, z.ZodString]>>;
+  image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodString]>>;
   passthrough: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type ModelState = z.infer<typeof modelStateSchema>;

package/dist/shared/types.js

@@ -1,3 +1,4 @@
+import { globalInstanceSchema } from "../utils/runtime.js";
 import { z } from "zod";
 //#region src/shared/types.ts
 const modelStateSchema = z.object({
@@ -6,8 +7,8 @@ const modelStateSchema = z.object({
 		enhance: z.boolean().optional().default(true)
 	}).optional(),
 	image: z.union([
-		z.instanceof(Blob),
-		z.instanceof(File),
+		globalInstanceSchema("Blob"),
+		globalInstanceSchema("File"),
 		z.string()
 	]).optional(),
 	passthrough: z.boolean().optional()

package/dist/utils/errors.d.ts

@@ -20,6 +20,9 @@ declare const ERROR_CODES: {
   readonly FILES_UPLOAD_ERROR: "FILES_UPLOAD_ERROR";
   readonly FILES_GET_ERROR: "FILES_GET_ERROR";
   readonly FILES_DELETE_ERROR: "FILES_DELETE_ERROR";
+  readonly REACT_NATIVE_SETUP_REQUIRED: "REACT_NATIVE_SETUP_REQUIRED";
+  readonly UNSUPPORTED_PLATFORM_FEATURE: "UNSUPPORTED_PLATFORM_FEATURE";
+  readonly LIVEKIT_INITIALIZATION_ERROR: "LIVEKIT_INITIALIZATION_ERROR";
   readonly WEBRTC_WEBSOCKET_ERROR: "WEBRTC_WEBSOCKET_ERROR";
   readonly WEBRTC_ICE_ERROR: "WEBRTC_ICE_ERROR";
   readonly WEBRTC_TIMEOUT_ERROR: "WEBRTC_TIMEOUT_ERROR";

package/dist/utils/errors.js

@@ -14,6 +14,9 @@ const ERROR_CODES = {
 	FILES_UPLOAD_ERROR: "FILES_UPLOAD_ERROR",
 	FILES_GET_ERROR: "FILES_GET_ERROR",
 	FILES_DELETE_ERROR: "FILES_DELETE_ERROR",
+	REACT_NATIVE_SETUP_REQUIRED: "REACT_NATIVE_SETUP_REQUIRED",
+	UNSUPPORTED_PLATFORM_FEATURE: "UNSUPPORTED_PLATFORM_FEATURE",
+	LIVEKIT_INITIALIZATION_ERROR: "LIVEKIT_INITIALIZATION_ERROR",
 	WEBRTC_WEBSOCKET_ERROR: "WEBRTC_WEBSOCKET_ERROR",
 	WEBRTC_ICE_ERROR: "WEBRTC_ICE_ERROR",
 	WEBRTC_TIMEOUT_ERROR: "WEBRTC_TIMEOUT_ERROR",
@@ -34,6 +37,18 @@ function createInvalidApiKeyError() {
 function createInvalidBaseUrlError(url) {
 	return createSDKError(ERROR_CODES.INVALID_BASE_URL, `Invalid base URL${url ? `: ${url}` : ""}`);
 }
+function createReactNativeSetupRequiredError(missing) {
+	return createSDKError(ERROR_CODES.REACT_NATIVE_SETUP_REQUIRED, "React Native realtime requires @livekit/react-native registerGlobals() before calling Decart realtime APIs.", { missing });
+}
+function createUnsupportedPlatformFeatureError(feature, platform) {
+	return createSDKError(ERROR_CODES.UNSUPPORTED_PLATFORM_FEATURE, `${feature} is not supported on ${platform}.`, {
+		feature,
+		platform
+	});
+}
+function createLiveKitInitializationError(message, cause) {
+	return createSDKError(ERROR_CODES.LIVEKIT_INITIALIZATION_ERROR, message, void 0, cause);
+}
 function createWebrtcWebsocketError(error) {
 	return createSDKError(ERROR_CODES.WEBRTC_WEBSOCKET_ERROR, "WebSocket connection failed", void 0, error);
 }
@@ -83,4 +98,4 @@ 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, createLiveKitInitializationError, createModelNotFoundError, createQueueResultError, createQueueStatusError, createQueueSubmitError, createReactNativeSetupRequiredError, createSDKError, createUnsupportedPlatformFeatureError };

package/dist/utils/platform.js

@@ -1,4 +1,20 @@
 //#region src/utils/platform.ts
+const REACT_NATIVE_REALTIME_GLOBALS = [
+	"LiveKitReactNativeGlobal",
+	"RTCPeerConnection",
+	"MediaStream",
+	"MediaStreamTrack",
+	"DOMException",
+	"ReadableStream",
+	"WritableStream",
+	"TransformStream",
+	"URL",
+	"URLSearchParams"
+];
+function missingReactNativeRealtimeGlobals() {
+	const g = globalThis;
+	return REACT_NATIVE_REALTIME_GLOBALS.filter((name) => g[name] === void 0);
+}
 function isDesktopSafari() {
 	const g = globalThis;
 	const ua = g?.navigator?.userAgent ?? "";
@@ -10,4 +26,4 @@ function isDesktopSafari() {
 	return true;
 }
 //#endregion
-export { isDesktopSafari };
+export { isDesktopSafari, missingReactNativeRealtimeGlobals };

package/dist/utils/runtime.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+//#region src/utils/runtime.ts
+/** Safely test a platform-provided constructor without evaluating a missing global. */
+function isGlobalInstance(value, name) {
+	const runtimeConstructor = globalThis[name];
+	return typeof runtimeConstructor === "function" && value instanceof runtimeConstructor;
+}
+/** Zod schema for values whose constructor may not exist in every runtime. */
+function globalInstanceSchema(name) {
+	return z.custom((value) => isGlobalInstance(value, name), { message: `Expected ${name}` });
+}
+//#endregion
+export { globalInstanceSchema, isGlobalInstance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decartai/sdk",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "Decart's JavaScript SDK",
   "type": "module",
   "license": "MIT",
@@ -20,9 +20,15 @@
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.js",
+  "react-native": "./dist/index.react-native.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./dist/index.react-native.js",
+      "browser": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -43,7 +49,7 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "livekit-client": "^2.0.0",
+    "livekit-client": "~2.20.1",
     "mitt": "^3.0.1",
     "p-retry": "^6.2.1",
     "zod": "^4.0.17"
@@ -53,6 +59,7 @@
     "dev": "tsdown --watch",
     "dev:example": "vite dev --port 3000",
     "test": "vitest unit",
+    "test:package": "node tests/built-package.mjs",
     "test:e2e": "vitest e2e",
     "test:e2e:realtime": "vitest --config vitest.config.e2e-realtime.ts",
     "typecheck": "tsc --noEmit",

package/dist/realtime/observability/glass-to-glass.d.ts

@@ -1,41 +0,0 @@
-//#region src/realtime/observability/glass-to-glass.d.ts
-
-/**
- * Aggregated glass-to-glass metrics. TTFF (startup) and mid-stream (steady
- * state) are measured separately — they differ by an order of magnitude and the
- * cold-start frames must not pollute the steady-state numbers.
- */
-type G2GMetrics = {
-  /**
-   * Time-to-first-frame (ms): from the connect attempt start to the first
-   * rendered model output. A one-shot startup metric, ~seconds. Null until the
-   * first frame arrives.
-   */
-  ttffMs: number | null;
-  /**
-   * Median mid-stream (steady-state) glass-to-glass latency (ms), excluding the
-   * warm-up after the first frame. Null until past warm-up. This is the
-   * per-frame responsiveness, distinct from `ttffMs`.
-   */
-  medianMs: number | null;
-  /** p90 mid-stream glass-to-glass latency (ms), or null until past warm-up. */
-  p90Ms: number | null;
-  /** Mid-stream latency samples in the window (post-warm-up). */
-  sampleCount: number;
-  /**
-   * End-to-end frame drop ratio (0–1): seqs stamped but never rendered, over
-   * recent post-warm-up outcomes. Null until enough frames have completed the
-   * round trip — short sessions/probes may never produce it.
-   */
-  dropRatio: number | null;
-};
-/**
- * Matches outgoing stamp times to incoming render times. Shared by the stamp
- * pump (writer) and the marker reader (matcher); owned by `RealtimeObservability`.
- *
- * Tracks two latencies: TTFF (start → first frame) and mid-stream median (steady
- * state, after a warm-up). Call `markStart()` at the beginning of each connect
- * attempt so TTFF measures the full setup→first-frame wait.
- */
-//#endregion
-export { G2GMetrics };

package/dist/realtime/preflight.d.ts

@@ -1,59 +0,0 @@
-import { CustomModelDefinition, ModelDefinition } from "../shared/model.js";
-import { ConnectionQuality } from "./observability/connection-quality.js";
-
-//#region src/realtime/preflight.d.ts
-
-/**
- * SDK-only connectivity preflight — run before `realtime.connect()` to decide
- * whether to show the integration. Spins up a throwaway `RTCPeerConnection`
- * against public STUN (no session, no inference) to check whether WebRTC can
- * leave the network over UDP and roughly how laggy the path is. It does not
- * measure throughput — use the in-session `connectionQuality` signal for that.
- */
-type ConnectivityTransport = "udp" | "relay" | "failed";
-type ConnectivityMetrics = {
-  /** "udp" = direct UDP works · "relay" = will need TURN (unverified SDK-only) · "failed" = no connectivity. */
-  transport: ConnectivityTransport;
-  /** Approximate network round-trip time (ms) from time-to-first STUN candidate (or real RTT in deep mode), or null. */
-  rttMs: number | null;
-  /** Active-probe only: measured mid-stream (steady-state) glass-to-glass latency (ms), or null. */
-  g2gMs?: number | null;
-  /** Active-probe only: time-to-first-frame (ms) — startup latency to the first rendered model frame, or null. */
-  ttffMs?: number | null;
-  /** Active-probe only: end-to-end frame drop ratio (0–1), or null. */
-  g2gDropRatio?: number | null;
-  /** Active-probe only: server's view of upstream jitter (ms), or null. */
-  upstreamJitterMs?: number | null;
-  /** Active-probe only: server-reported upstream packet loss (0–1), or null. */
-  packetLoss?: number | null;
-  /** Active-probe only: number of glass-to-glass samples collected. */
-  sampleCount?: number;
-};
-type ConnectivityReport = {
-  /** Pre-connect quality on the same `good → critical` scale as the in-session signal — you decide what to do. */
-  quality: ConnectionQuality;
-  metrics: ConnectivityMetrics;
-  /** Human-readable explanations for any non-"good" verdict. */
-  reasons: string[];
-};
-type CheckConnectivityOptions = {
-  /** Override the ICE servers used for the probe. Defaults to public STUN. */
-  iceServers?: RTCIceServer[];
-  /** Abort candidate gathering after this long. Defaults to config. */
-  iceGatherTimeoutMs?: number;
-  /** Abort the probe early. */
-  signal?: AbortSignal;
-  /**
-   * Opt-in "deep" probe: instead of the STUN-only network check, briefly open a
-   * real session with a synthetic source, measure true glass-to-glass latency,
-   * then tear it down. Requires `model`. Costs a short GPU session.
-   */
-  deep?: boolean;
-  /** Required when `deep`: the realtime model to probe (latency is model-specific). */
-  model?: ModelDefinition | CustomModelDefinition;
-  /** Deep-probe duration (ms). Defaults to config. */
-  durationMs?: number;
-};
-/** Realtime `connect` injected by the SDK root so the active probe can open a session. */
-//#endregion
-export { CheckConnectivityOptions, ConnectivityMetrics, ConnectivityReport, ConnectivityTransport };