@xmaxai/sdk 0.1.0 → 1.0.1

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 import { S as SDKLocale, a as SDKI18n, b as XmaxOpenClient } from './rtc-manager-gYDkADGw.cjs';
 export { A as ACTIVE_STATUS, C as ClientOptions, c as CosSts, L as LocalPublishReadyResult, M as MEDIA_TIME_EPSILON_S, d as MEDIA_TIME_LOOP_JUMP_S, e as MOBILE_PUBLISH_MAX_WIDTH_PX, f as ModelExtra, P as PUBLISH_COLD_FRAME_TIMEOUT_MS, g as PUBLISH_COLD_MIN_FRAMES, h as PUBLISH_COLD_WARMUP_MS, i as PUBLISH_START_FRAME_TIMEOUT_MS, j as PUBLISH_START_MIN_FRAMES, k as PUBLISH_WARM_SKIP_MS, l as RTC_PUBLISH_FPS, m as RTC_PUBLISH_FPS_MOBILE, n as RTC_PUBLISH_FPS_WEB, o as RTC_PUBLISH_FRAME_INTERVAL_MS, p as RTC_PUBLISH_FRAME_INTERVAL_S, q as RemoteSeiReceivedPayload, r as ResolveRtcPublishFpsOptions, s as RtcJoinInfo, t as RtcLogEntry, u as RtcManager, R as RtcStateSnapshot, v as SDKMessages, w as Session, x as StsCredentials, U as UploadImageResult, y as UploadVideoResult, z as XMAX_OPEN_API_BASE_URLS, B as XMAX_OPEN_API_PRODUCTION_BASE_URL, D as XmaxLogEntry, E as XmaxSdkRegion, F as createSDKI18n, G as getDefaultMessages, H as isMobilePublishEnvironment, I as resolveRtcPublishFps, J as resolveRtcPublishFrameIntervalS } from './rtc-manager-gYDkADGw.cjs';
-export { D as DragTrackController, a as DragTrackControllerOptions, N as NativeCameraStream, O as OpenNativeCameraStreamOptions, R as RealtimeConnectOptions, b as RealtimeInitialState, c as RealtimeModel, d as RealtimePrewarmHandle, e as RealtimePromptState, f as RealtimeRestartOptions, g as RealtimeSession, h as RealtimeSetImageOptions, i as RealtimeSetInput, j as RealtimeSetModeOptions, k as RemoteViewHost, X as XmaxClient, l as XmaxClientFiles, m as XmaxClientOptions, n as XmaxRealtimeSession, o as createDragTrackController, p as createNativeCameraStream, q as createRemoteViewHost, r as createXmaxClient, s as getContentRect, t as mapTargetPointToCanvas, u as mapViewportPointToCoordinateSpace, v as models, w as observeDragSurfaceVideoSync, x as openNativeCameraStream, y as syncDragSurfaceToVideo } from './index-Dai62Sos.cjs';
+export { D as DragTrackController, a as DragTrackControllerOptions, N as NativeCameraStream, O as OpenNativeCameraStreamOptions, R as RealtimeConnectOptions, b as RealtimeInitialState, c as RealtimeModel, d as RealtimePrewarmHandle, e as RealtimePromptState, f as RealtimeRestartOptions, g as RealtimeSession, h as RealtimeSetImageOptions, i as RealtimeSetInput, j as RealtimeSetModeOptions, k as RemoteViewHost, X as XmaxClient, l as XmaxClientFiles, m as XmaxClientOptions, n as XmaxRealtimeSession, o as createDragTrackController, p as createNativeCameraStream, q as createRemoteViewHost, r as createXmaxClient, s as getContentRect, t as mapTargetPointToCanvas, u as mapViewportPointToCoordinateSpace, v as models, w as observeDragSurfaceVideoSync, x as openNativeCameraStream, y as syncDragSurfaceToVideo } from './index-Dg1ElHAj.cjs';
 
 /**
  * Open API business error codes (46xxx) mapped to user-facing messages.
- * Source: Open API v1 error code tables. Codes not listed here fall back to a
- * generic retry message (see `errors.requestRetry`).
+ * Source: Open API v1 error code tables. Codes not listed here fall back to the
+ * backend `message` when present, otherwise a generic retry message for Open
+ * API endpoints (see `errors.requestRetry`).
  */
 type LocalizedMessage = Record<SDKLocale, string>;
 declare const API_ERROR_MESSAGES: Record<string, LocalizedMessage>;
@@ -24,6 +25,8 @@ type StartRtcRoomEvent = {
         ref_image_path?: string;
         ref_image?: string;
         static_generate?: boolean;
+        /** MoX instant — COS URL of the source still; preferred over under-bitrate RTC frames. */
+        static_image_path?: string;
     } & Record<string, unknown>;
 };
 type StopRtcRoomEvent = {
@@ -52,6 +55,8 @@ declare function createStartRtcRoomEvent(input: {
     refImage?: string;
     /** MoX instant — static image generation that follows drag tracks. */
     staticGenerate?: boolean;
+    /** MoX instant — COS URL of the source still (`static_image_path`). */
+    staticImagePath?: string;
     extraParams?: Record<string, unknown>;
 }): StartRtcRoomEvent;
 declare function createStopRtcRoomEvent(input: {

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import { S as SDKLocale, a as SDKI18n, b as XmaxOpenClient } from './rtc-manager-gYDkADGw.js';
 export { A as ACTIVE_STATUS, C as ClientOptions, c as CosSts, L as LocalPublishReadyResult, M as MEDIA_TIME_EPSILON_S, d as MEDIA_TIME_LOOP_JUMP_S, e as MOBILE_PUBLISH_MAX_WIDTH_PX, f as ModelExtra, P as PUBLISH_COLD_FRAME_TIMEOUT_MS, g as PUBLISH_COLD_MIN_FRAMES, h as PUBLISH_COLD_WARMUP_MS, i as PUBLISH_START_FRAME_TIMEOUT_MS, j as PUBLISH_START_MIN_FRAMES, k as PUBLISH_WARM_SKIP_MS, l as RTC_PUBLISH_FPS, m as RTC_PUBLISH_FPS_MOBILE, n as RTC_PUBLISH_FPS_WEB, o as RTC_PUBLISH_FRAME_INTERVAL_MS, p as RTC_PUBLISH_FRAME_INTERVAL_S, q as RemoteSeiReceivedPayload, r as ResolveRtcPublishFpsOptions, s as RtcJoinInfo, t as RtcLogEntry, u as RtcManager, R as RtcStateSnapshot, v as SDKMessages, w as Session, x as StsCredentials, U as UploadImageResult, y as UploadVideoResult, z as XMAX_OPEN_API_BASE_URLS, B as XMAX_OPEN_API_PRODUCTION_BASE_URL, D as XmaxLogEntry, E as XmaxSdkRegion, F as createSDKI18n, G as getDefaultMessages, H as isMobilePublishEnvironment, I as resolveRtcPublishFps, J as resolveRtcPublishFrameIntervalS } from './rtc-manager-gYDkADGw.js';
-export { D as DragTrackController, a as DragTrackControllerOptions, N as NativeCameraStream, O as OpenNativeCameraStreamOptions, R as RealtimeConnectOptions, b as RealtimeInitialState, c as RealtimeModel, d as RealtimePrewarmHandle, e as RealtimePromptState, f as RealtimeRestartOptions, g as RealtimeSession, h as RealtimeSetImageOptions, i as RealtimeSetInput, j as RealtimeSetModeOptions, k as RemoteViewHost, X as XmaxClient, l as XmaxClientFiles, m as XmaxClientOptions, n as XmaxRealtimeSession, o as createDragTrackController, p as createNativeCameraStream, q as createRemoteViewHost, r as createXmaxClient, s as getContentRect, t as mapTargetPointToCanvas, u as mapViewportPointToCoordinateSpace, v as models, w as observeDragSurfaceVideoSync, x as openNativeCameraStream, y as syncDragSurfaceToVideo } from './index-BIUk_kvb.js';
+export { D as DragTrackController, a as DragTrackControllerOptions, N as NativeCameraStream, O as OpenNativeCameraStreamOptions, R as RealtimeConnectOptions, b as RealtimeInitialState, c as RealtimeModel, d as RealtimePrewarmHandle, e as RealtimePromptState, f as RealtimeRestartOptions, g as RealtimeSession, h as RealtimeSetImageOptions, i as RealtimeSetInput, j as RealtimeSetModeOptions, k as RemoteViewHost, X as XmaxClient, l as XmaxClientFiles, m as XmaxClientOptions, n as XmaxRealtimeSession, o as createDragTrackController, p as createNativeCameraStream, q as createRemoteViewHost, r as createXmaxClient, s as getContentRect, t as mapTargetPointToCanvas, u as mapViewportPointToCoordinateSpace, v as models, w as observeDragSurfaceVideoSync, x as openNativeCameraStream, y as syncDragSurfaceToVideo } from './index-Cw8C8LbO.js';
 
 /**
  * Open API business error codes (46xxx) mapped to user-facing messages.
- * Source: Open API v1 error code tables. Codes not listed here fall back to a
- * generic retry message (see `errors.requestRetry`).
+ * Source: Open API v1 error code tables. Codes not listed here fall back to the
+ * backend `message` when present, otherwise a generic retry message for Open
+ * API endpoints (see `errors.requestRetry`).
  */
 type LocalizedMessage = Record<SDKLocale, string>;
 declare const API_ERROR_MESSAGES: Record<string, LocalizedMessage>;
@@ -24,6 +25,8 @@ type StartRtcRoomEvent = {
         ref_image_path?: string;
         ref_image?: string;
         static_generate?: boolean;
+        /** MoX instant — COS URL of the source still; preferred over under-bitrate RTC frames. */
+        static_image_path?: string;
     } & Record<string, unknown>;
 };
 type StopRtcRoomEvent = {
@@ -52,6 +55,8 @@ declare function createStartRtcRoomEvent(input: {
     refImage?: string;
     /** MoX instant — static image generation that follows drag tracks. */
     staticGenerate?: boolean;
+    /** MoX instant — COS URL of the source still (`static_image_path`). */
+    staticImagePath?: string;
     extraParams?: Record<string, unknown>;
 }): StartRtcRoomEvent;
 declare function createStopRtcRoomEvent(input: {

package/dist/index.js

@@ -1,10 +1,10 @@
-export { RealtimePrewarmHandle, RealtimeSession, createRemoteViewHost, createXmaxClient, observeDragSurfaceVideoSync, resolveRefImageUrl, syncDragSurfaceToVideo } from './chunk-74ZZWUPI.js';
-import { requestCameraMediaStream } from './chunk-67XSD3QJ.js';
-export { ACTIVE_STATUS, PREVIEW_CONTAIN_ATTR, PREVIEW_COVER_ATTR, PREVIEW_OUTPUT_LAYOUT_ATTR, PREVIEW_UPLOAD_FIT_ATTR, PREVIEW_UPLOAD_LAYOUT_ATTR, PUBLISH_COLD_FRAME_TIMEOUT_MS, PUBLISH_COLD_MIN_FRAMES, PUBLISH_COLD_WARMUP_MS, PUBLISH_START_FRAME_TIMEOUT_MS, PUBLISH_START_MIN_FRAMES, PUBLISH_WARM_SKIP_MS, RtcManager, XMAX_OPEN_API_BASE_URLS, XMAX_OPEN_API_PRODUCTION_BASE_URL, XmaxOpenClient, applyUploadPreviewMediaLayout, classifyCameraAccessError, createDragTrackController, createNativeCameraStream, createStartRtcRoomEvent, createStopRtcRoomEvent, createTaskUid, createTracksRtcRoomEvent, getCameraEnvironmentIssue, getContentRect, isCameraAccessError, mapTargetPointToCanvas, mapViewportPointToCoordinateSpace, models, observeUploadPreviewMediaLayout, openNativeCameraStream, requestCameraMediaStream, stabilizeCameraVideoTrack } from './chunk-67XSD3QJ.js';
-import { computeCenterCropRect, drawSourceCenterCrop } from './chunk-EGNRAZ5U.js';
-export { createVideoFileStream } from './chunk-EGNRAZ5U.js';
-import { createSDKI18n, resolveUploadVideoSize, resolveRtcPublishFps, mountCaptureVideo } from './chunk-PLU2YVAS.js';
-export { API_ERROR_MESSAGES, DEFAULT_SESSION_TARGET_SIZE, MEDIA_TIME_EPSILON_S, MEDIA_TIME_LOOP_JUMP_S, MOBILE_PUBLISH_MAX_WIDTH_PX, PREVIEW_CONTAINER_ASPECT_RATIO, RTC_PUBLISH_FPS, RTC_PUBLISH_FPS_MOBILE, RTC_PUBLISH_FPS_WEB, RTC_PUBLISH_FRAME_INTERVAL_MS, RTC_PUBLISH_FRAME_INTERVAL_S, createSDKI18n, getDefaultMessages, isMobilePublishEnvironment, resolveAdaptiveRtcVideoSize, resolveApiErrorMessage, resolvePreviewAspectRatio, resolveRtcPublishFps, resolveRtcPublishFrameIntervalS, resolveSessionTargetSize, resolveUploadPublishSize, resolveUploadVideoSize } from './chunk-PLU2YVAS.js';
+export { RealtimePrewarmHandle, RealtimeSession, createRemoteViewHost, createXmaxClient, observeDragSurfaceVideoSync, resolveRefImageUrl, syncDragSurfaceToVideo } from './chunk-VLJZ56PT.js';
+import { requestCameraMediaStream } from './chunk-V4NR6CPP.js';
+export { ACTIVE_STATUS, PREVIEW_CONTAIN_ATTR, PREVIEW_COVER_ATTR, PREVIEW_OUTPUT_LAYOUT_ATTR, PREVIEW_UPLOAD_FIT_ATTR, PREVIEW_UPLOAD_LAYOUT_ATTR, PUBLISH_COLD_FRAME_TIMEOUT_MS, PUBLISH_COLD_MIN_FRAMES, PUBLISH_COLD_WARMUP_MS, PUBLISH_START_FRAME_TIMEOUT_MS, PUBLISH_START_MIN_FRAMES, PUBLISH_WARM_SKIP_MS, RtcManager, XMAX_OPEN_API_BASE_URLS, XMAX_OPEN_API_PRODUCTION_BASE_URL, XmaxOpenClient, applyUploadPreviewMediaLayout, classifyCameraAccessError, createDragTrackController, createNativeCameraStream, createStartRtcRoomEvent, createStopRtcRoomEvent, createTaskUid, createTracksRtcRoomEvent, getCameraEnvironmentIssue, getContentRect, isCameraAccessError, mapTargetPointToCanvas, mapViewportPointToCoordinateSpace, models, observeUploadPreviewMediaLayout, openNativeCameraStream, requestCameraMediaStream, stabilizeCameraVideoTrack } from './chunk-V4NR6CPP.js';
+import { computeCenterCropRect, drawSourceCenterCrop } from './chunk-4YHBCQ2C.js';
+export { createVideoFileStream } from './chunk-4YHBCQ2C.js';
+import { createSDKI18n, resolveUploadVideoSize, resolveRtcPublishFps, mountCaptureVideo } from './chunk-LCPC56BK.js';
+export { API_ERROR_MESSAGES, DEFAULT_SESSION_TARGET_SIZE, MEDIA_TIME_EPSILON_S, MEDIA_TIME_LOOP_JUMP_S, MOBILE_PUBLISH_MAX_WIDTH_PX, PREVIEW_CONTAINER_ASPECT_RATIO, RTC_PUBLISH_FPS, RTC_PUBLISH_FPS_MOBILE, RTC_PUBLISH_FPS_WEB, RTC_PUBLISH_FRAME_INTERVAL_MS, RTC_PUBLISH_FRAME_INTERVAL_S, createSDKI18n, getDefaultMessages, isMobilePublishEnvironment, resolveAdaptiveRtcVideoSize, resolveApiErrorMessage, resolvePreviewAspectRatio, resolveRtcPublishFps, resolveRtcPublishFrameIntervalS, resolveSessionTargetSize, resolveUploadPublishSize, resolveUploadVideoSize } from './chunk-LCPC56BK.js';
 
 // src/rtc/image-file-stream.ts
 function loadImageElement(url, crossOrigin) {
@@ -143,7 +143,7 @@ async function createMediaFileStream(fileOrUrl, options = {}) {
     return createImageFileStream(fileOrUrl, options);
   }
   if (isVideoMediaFile(fileOrUrl)) {
-    const { createVideoFileStream: createVideoFileStream2 } = await import('./video-file-stream-UXJ6TNIB.js');
+    const { createVideoFileStream: createVideoFileStream2 } = await import('./video-file-stream-K7GQMIJ5.js');
     return createVideoFileStream2(fileOrUrl, options);
   }
   const i18n = options.i18n ?? createSDKI18n();

package/dist/react/index.cjs

@@ -539,7 +539,8 @@ var XmaxOpenClient = class {
         return p.data;
       }
       const mappedMessage = resolveApiErrorMessage(p.code, this.i18n.locale);
-      const errorMessage = mappedMessage ?? this.i18n.t("errors.requestRetry");
+      const backendMessage = typeof p.message === "string" && p.message.trim() ? p.message.trim() : void 0;
+      const errorMessage = mappedMessage ?? backendMessage ?? this.i18n.t("errors.requestRetry");
       throw new Error(errorMessage);
     } catch (error) {
       if (this.isAbortError(error)) {
@@ -691,6 +692,7 @@ function createStartRtcRoomEvent(input) {
   const resolvedPrompt = input.prompt?.trim() ?? "";
   const refImagePath = input.refImagePath?.trim() || input.refImage?.trim() || void 0;
   const useRefImage = !!refImagePath;
+  const staticImagePath = input.staticImagePath?.trim() || void 0;
   return {
     event: "start",
     user_id: input.userId?.trim() || void 0,
@@ -702,7 +704,9 @@ function createStartRtcRoomEvent(input) {
       prompt: resolvedPrompt,
       ref_image_path: useRefImage ? refImagePath : void 0,
       ref_image: useRefImage ? refImagePath : void 0,
-      static_generate: input.staticGenerate === void 0 ? void 0 : input.staticGenerate,
+      // Instant-only — omit when false/undefined so non-instant starts never carry leftover flags.
+      static_generate: input.staticGenerate === true ? true : void 0,
+      static_image_path: staticImagePath,
       ...input.extraParams ?? {}
     }
   };
@@ -1103,7 +1107,7 @@ var _RtcManager = class _RtcManager {
     this.lastRemoteSei = null;
     this.lastRemoteSeiUserId = null;
     this.hasLoggedSeiSendFailure = false;
-    if (previousExpectedRemoteSei !== this.expectedRemoteSei && this.remoteVideoUserId) {
+    if (previousExpectedRemoteSei !== this.expectedRemoteSei && this.remoteVideoUserId && !this.preserveRemoteDom) {
       this.pendingRemoteVideoUserId = this.remoteVideoUserId;
       this.remoteVideoUserId = null;
     }
@@ -3935,6 +3939,7 @@ function drawNeon(ctx, segs, container, targetSize, dpr, fitMode, mirrored) {
 }
 var DragTrackController = class {
   constructor(container, options) {
+    this.strokeActive = false;
     this.activePointers = /* @__PURE__ */ new Map();
     this.lastTargetPoints = /* @__PURE__ */ new Map();
     this.segQueue = [];
@@ -3944,11 +3949,12 @@ var DragTrackController = class {
     this.resizeObserver = null;
     this.container = container;
     this.onTracks = options.onTracks;
+    this.onStrokeStart = options.onStrokeStart;
+    this.onStrokeEnd = options.onStrokeEnd;
     this.targetSize = options.targetSize;
     this.fitMode = options.fitMode ?? "cover";
     this.mirrored = options.mirrored ?? false;
     this.enabled = options.enabled ?? true;
-    this.emitEmptyTracksWhenIdle = options.emitEmptyTracksWhenIdle ?? false;
     this.canvas = document.createElement("canvas");
     this.canvas.className = "Xmax-drag-track-canvas";
     this.canvas.style.cssText = "position:absolute;inset:0;z-index:21;width:100%;height:100%;pointer-events:none;";
@@ -3962,32 +3968,12 @@ var DragTrackController = class {
     this.bindResizeObserver();
     this.bindPointerEvents();
     this.applyInteractionStyle();
-    if (this.enabled && this.emitEmptyTracksWhenIdle) {
-      this.startSampling();
-    }
   }
   setEnabled(enabled) {
     this.enabled = enabled;
     this.applyInteractionStyle();
     if (!enabled) {
-      this.finishStroke({ stopIdleSampling: true });
-      return;
-    }
-    if (this.emitEmptyTracksWhenIdle && this.activePointers.size === 0) {
-      this.startSampling();
-    }
-  }
-  setEmitEmptyTracksWhenIdle(emitEmptyTracksWhenIdle) {
-    if (this.emitEmptyTracksWhenIdle === emitEmptyTracksWhenIdle) {
-      return;
-    }
-    this.emitEmptyTracksWhenIdle = emitEmptyTracksWhenIdle;
-    if (emitEmptyTracksWhenIdle && this.enabled && this.activePointers.size === 0) {
-      this.startSampling();
-      return;
-    }
-    if (!emitEmptyTracksWhenIdle && this.activePointers.size === 0) {
-      this.stopSampling();
+      this.finishStroke();
     }
   }
   setTargetSize(targetSize) {
@@ -4000,7 +3986,7 @@ var DragTrackController = class {
     this.mirrored = mirrored;
   }
   destroy() {
-    this.finishStroke({ stopIdleSampling: true });
+    this.finishStroke();
     this.unbindPointerEvents();
     this.unbindResizeObserver();
     this.canvas.remove();
@@ -4117,7 +4103,7 @@ var DragTrackController = class {
       return;
     }
     const tracks = this.collectCurrentTracks();
-    if (!tracks.length && !this.emitEmptyTracksWhenIdle) {
+    if (!tracks.length) {
       return;
     }
     this.sampleInFlight = true;
@@ -4135,14 +4121,17 @@ var DragTrackController = class {
       this.flushTracks();
     }, 30);
   }
-  finishStroke(options) {
-    const stopIdleSampling = options?.stopIdleSampling ?? !this.emitEmptyTracksWhenIdle;
-    if (stopIdleSampling) {
-      this.stopSampling();
-    }
+  finishStroke(emitEnd = false) {
+    const wasActive = this.strokeActive;
+    this.strokeActive = false;
+    this.stopSampling();
     this.stopDrawLoop();
     this.segQueue.length = 0;
     this.clearCanvas();
+    if (emitEnd && wasActive && this.onStrokeEnd) {
+      Promise.resolve(this.onStrokeEnd()).catch(() => {
+      });
+    }
   }
   handlePointerDown(e) {
     if (!this.enabled) {
@@ -4166,6 +4155,12 @@ var DragTrackController = class {
     if (targetPoint) {
       this.lastTargetPoints.set(e.pointerId, targetPoint);
     }
+    const strokeWasActive = this.strokeActive;
+    this.strokeActive = true;
+    if (!strokeWasActive && this.onStrokeStart) {
+      Promise.resolve(this.onStrokeStart()).catch(() => {
+      });
+    }
     this.startDrawLoop();
     this.startSampling();
   }
@@ -4198,7 +4193,7 @@ var DragTrackController = class {
     } catch {
     }
     if (this.activePointers.size === 0) {
-      this.finishStroke();
+      this.finishStroke(true);
     }
   }
   handlePointerCancel(e) {
@@ -4208,7 +4203,7 @@ var DragTrackController = class {
     this.activePointers.delete(e.pointerId);
     this.lastTargetPoints.delete(e.pointerId);
     if (this.activePointers.size === 0) {
-      this.finishStroke();
+      this.finishStroke(true);
     }
   }
 };