@decartai/sdk 0.0.47 → 0.0.49

package/dist/utils/errors.js

@@ -2,7 +2,6 @@
 const ERROR_CODES = {
 	INVALID_API_KEY: "INVALID_API_KEY",
 	INVALID_BASE_URL: "INVALID_BASE_URL",
-	WEB_RTC_ERROR: "WEB_RTC_ERROR",
 	PROCESSING_ERROR: "PROCESSING_ERROR",
 	INVALID_INPUT: "INVALID_INPUT",
 	INVALID_OPTIONS: "INVALID_OPTIONS",
@@ -11,7 +10,12 @@ const ERROR_CODES = {
 	QUEUE_STATUS_ERROR: "QUEUE_STATUS_ERROR",
 	QUEUE_RESULT_ERROR: "QUEUE_RESULT_ERROR",
 	JOB_NOT_COMPLETED: "JOB_NOT_COMPLETED",
-	TOKEN_CREATE_ERROR: "TOKEN_CREATE_ERROR"
+	TOKEN_CREATE_ERROR: "TOKEN_CREATE_ERROR",
+	WEBRTC_WEBSOCKET_ERROR: "WEBRTC_WEBSOCKET_ERROR",
+	WEBRTC_ICE_ERROR: "WEBRTC_ICE_ERROR",
+	WEBRTC_TIMEOUT_ERROR: "WEBRTC_TIMEOUT_ERROR",
+	WEBRTC_SERVER_ERROR: "WEBRTC_SERVER_ERROR",
+	WEBRTC_SIGNALING_ERROR: "WEBRTC_SIGNALING_ERROR"
 };
 function createSDKError(code, message, data, cause) {
 	return {
@@ -27,8 +31,38 @@ function createInvalidApiKeyError() {
 function createInvalidBaseUrlError(url) {
 	return createSDKError(ERROR_CODES.INVALID_BASE_URL, `Invalid base URL${url ? `: ${url}` : ""}`);
 }
-function createWebrtcError(error) {
-	return createSDKError(ERROR_CODES.WEB_RTC_ERROR, "WebRTC error", { cause: error });
+function createWebrtcWebsocketError(error) {
+	return createSDKError(ERROR_CODES.WEBRTC_WEBSOCKET_ERROR, "WebSocket connection failed", void 0, error);
+}
+function createWebrtcIceError(error) {
+	return createSDKError(ERROR_CODES.WEBRTC_ICE_ERROR, "ICE connection failed", void 0, error);
+}
+function createWebrtcTimeoutError(phase, timeoutMs, cause) {
+	const hasTimeout = typeof timeoutMs === "number" && Number.isFinite(timeoutMs);
+	return createSDKError(ERROR_CODES.WEBRTC_TIMEOUT_ERROR, hasTimeout ? `${phase} timed out after ${timeoutMs}ms` : `${phase} timed out`, hasTimeout ? {
+		phase,
+		timeoutMs
+	} : { phase }, cause);
+}
+function createWebrtcServerError(message) {
+	return createSDKError(ERROR_CODES.WEBRTC_SERVER_ERROR, message);
+}
+function createWebrtcSignalingError(error) {
+	return createSDKError(ERROR_CODES.WEBRTC_SIGNALING_ERROR, "Signaling error", void 0, error);
+}
+/**
+* Classify a raw WebRTC error into a specific SDK error based on its message.
+*/
+function classifyWebrtcError(error) {
+	const msg = error.message.toLowerCase();
+	if (error.source === "server") return createWebrtcServerError(error.message);
+	if (msg.includes("websocket")) return createWebrtcWebsocketError(error);
+	if (msg.includes("ice connection failed")) return createWebrtcIceError(error);
+	if (msg.includes("timeout") || msg.includes("timed out")) {
+		const timeoutMatch = msg.match(/(\d+)\s*ms/);
+		return createWebrtcTimeoutError("connection", timeoutMatch ? Number.parseInt(timeoutMatch[1], 10) : void 0, error);
+	}
+	return createWebrtcSignalingError(error);
 }
 function createInvalidInputError(message) {
 	return createSDKError(ERROR_CODES.INVALID_INPUT, message);
@@ -47,4 +81,4 @@ function createQueueResultError(message, status) {
 }
 
 //#endregion
-export { ERROR_CODES, createInvalidApiKeyError, createInvalidBaseUrlError, createInvalidInputError, createModelNotFoundError, createQueueResultError, createQueueStatusError, createQueueSubmitError, createSDKError, createWebrtcError };
+export { ERROR_CODES, classifyWebrtcError, createInvalidApiKeyError, createInvalidBaseUrlError, createInvalidInputError, createModelNotFoundError, createQueueResultError, createQueueStatusError, createQueueSubmitError, createSDKError };

package/dist/utils/logger.d.ts

@@ -0,0 +1,18 @@
+//#region src/utils/logger.d.ts
+type LogLevel = "debug" | "info" | "warn" | "error";
+type Logger = {
+  debug: (message: string, data?: Record<string, unknown>) => void;
+  info: (message: string, data?: Record<string, unknown>) => void;
+  warn: (message: string, data?: Record<string, unknown>) => void;
+  error: (message: string, data?: Record<string, unknown>) => void;
+};
+/** A logger that discards all messages. Zero overhead. */
+declare const noopLogger: Logger;
+/**
+ * Creates a console-based logger that only logs messages at or above the given level.
+ *
+ * @param minLevel - Minimum log level to output. Default: "warn".
+ */
+declare function createConsoleLogger(minLevel?: LogLevel): Logger;
+//#endregion
+export { LogLevel, Logger, createConsoleLogger, noopLogger };

package/dist/utils/logger.js

@@ -0,0 +1,37 @@
+//#region src/utils/logger.ts
+/** A logger that discards all messages. Zero overhead. */
+const noopLogger = {
+	debug() {},
+	info() {},
+	warn() {},
+	error() {}
+};
+const LOG_LEVELS = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+/**
+* Creates a console-based logger that only logs messages at or above the given level.
+*
+* @param minLevel - Minimum log level to output. Default: "warn".
+*/
+function createConsoleLogger(minLevel = "warn") {
+	const threshold = LOG_LEVELS[minLevel];
+	const log = (level, message, data) => {
+		if (LOG_LEVELS[level] < threshold) return;
+		const prefix = "[DecartSDK]";
+		if (data) console[level](prefix, message, data);
+		else console[level](prefix, message);
+	};
+	return {
+		debug: (msg, data) => log("debug", msg, data),
+		info: (msg, data) => log("info", msg, data),
+		warn: (msg, data) => log("warn", msg, data),
+		error: (msg, data) => log("error", msg, data)
+	};
+}
+
+//#endregion
+export { createConsoleLogger, noopLogger };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decartai/sdk",
-  "version": "0.0.47",
+  "version": "0.0.49",
   "description": "Decart's JavaScript SDK",
   "type": "module",
   "license": "MIT",
@@ -32,13 +32,15 @@
     "@biomejs/biome": "2.3.8",
     "@types/bun": "^1.3.3",
     "@types/node": "^22.15.17",
+    "@vitest/browser-playwright": "^4",
     "bumpp": "^10.1.0",
     "msw": "^2.11.3",
     "pkg-pr-new": "^0.0.56",
+    "playwright": "^1.58.2",
     "tsdown": "^0.14.1",
     "typescript": "^5.8.3",
     "vite": "^7.1.2",
-    "vitest": "^3.1.3"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "mitt": "^3.0.1",
@@ -51,6 +53,7 @@
     "dev:example": "vite dev --port 3000",
     "test": "vitest unit",
     "test:e2e": "vitest e2e",
+    "test:e2e:realtime": "vitest --config vitest.config.e2e-realtime.ts",
     "typecheck": "tsc --noEmit",
     "format": "biome format --write",
     "format:check": "biome check",