@xmaxai/sdk 1.0.1 → 1.0.3

package/dist/react/index.cjs

@@ -119,6 +119,8 @@ var enUS = {
   "errors.sessionJoinInfoIncomplete": "session does not contain complete RTC join info",
   "errors.sessionUidMissing": "session does not contain sessionUid",
   "errors.refImageMissing": "missing reference image",
+  "errors.imageCheckMissingUrl": "image check response missing url",
+  "errors.imageCheckUnsafe": "image did not pass safety check",
   "errors.captureStreamUnsupported": "captureStream is not supported in this browser",
   "errors.videoTrackMissing": "failed to create video track from file",
   "errors.imageTrackMissing": "failed to create video track from image file",
@@ -175,6 +177,8 @@ var zhCN = {
   "errors.sessionJoinInfoIncomplete": "session \u7F3A\u5C11\u5B8C\u6574\u7684 RTC \u8FDB\u623F\u4FE1\u606F",
   "errors.sessionUidMissing": "session \u7F3A\u5C11 sessionUid",
   "errors.refImageMissing": "\u7F3A\u5C11\u53C2\u8003\u56FE",
+  "errors.imageCheckMissingUrl": "\u56FE\u7247\u68C0\u67E5\u54CD\u5E94\u7F3A\u5C11 url",
+  "errors.imageCheckUnsafe": "\u56FE\u7247\u672A\u901A\u8FC7\u5B89\u5168\u68C0\u67E5",
   "errors.captureStreamUnsupported": "\u5F53\u524D\u6D4F\u89C8\u5668\u4E0D\u652F\u6301 captureStream",
   "errors.videoTrackMissing": "\u672A\u80FD\u4ECE\u89C6\u9891\u6587\u4EF6\u521B\u5EFA video track",
   "errors.imageTrackMissing": "\u672A\u80FD\u4ECE\u56FE\u7247\u6587\u4EF6\u521B\u5EFA video track",
@@ -280,148 +284,13 @@ function createSDKI18n(input) {
   };
 }
 
-// src/shared/browser-toast.ts
-var TOAST_ROOT_ID = "Xmax-sdk-toast-root";
-var TOAST_DURATION_MS = 3e3;
-var toastSeed = 0;
-var timeoutMap = /* @__PURE__ */ new Map();
-var elementMap = /* @__PURE__ */ new Map();
-function ensureToastRoot() {
-  if (typeof document === "undefined") {
-    return null;
-  }
-  let root = document.getElementById(TOAST_ROOT_ID);
-  if (root) {
-    return root;
-  }
-  root = document.createElement("div");
-  root.id = TOAST_ROOT_ID;
-  root.setAttribute("aria-live", "polite");
-  Object.assign(root.style, {
-    position: "fixed",
-    left: "50%",
-    top: "24px",
-    transform: "translateX(-50%)",
-    zIndex: "3000",
-    display: "flex",
-    flexDirection: "column",
-    alignItems: "center",
-    gap: "12px",
-    pointerEvents: "none"
-  });
-  document.body.appendChild(root);
-  return root;
-}
-function createIcon(type) {
-  const icon = document.createElement("span");
-  icon.setAttribute("aria-hidden", "true");
-  icon.innerHTML = type === "success" ? '<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12" fill="none"><path d="M10 3L4.5 8.5 2 6" stroke="#4ade80" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>' : '<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12" fill="none"><circle cx="6" cy="6" r="5" stroke="#f87171" stroke-width="1.5"/><path d="M4 4l4 4M8 4L4 8" stroke="#f87171" stroke-width="1.5" stroke-linecap="round"/></svg>';
-  Object.assign(icon.style, {
-    display: "inline-flex",
-    width: "12px",
-    height: "12px",
-    flexShrink: "0"
-  });
-  return icon;
-}
-function clearToastTimer(id) {
-  const timer = timeoutMap.get(id);
-  if (timer) {
-    window.clearTimeout(timer);
-    timeoutMap.delete(id);
-  }
-}
-function destroyToast(id) {
-  if (!id) {
-    timeoutMap.forEach((timer) => window.clearTimeout(timer));
-    timeoutMap.clear();
-    elementMap.forEach((element2) => element2.remove());
-    elementMap.clear();
-    const root2 = typeof document !== "undefined" ? document.getElementById(TOAST_ROOT_ID) : null;
-    root2?.remove();
-    return;
-  }
-  clearToastTimer(id);
-  const element = elementMap.get(id);
-  element?.remove();
-  elementMap.delete(id);
-  const root = typeof document !== "undefined" ? document.getElementById(TOAST_ROOT_ID) : null;
-  if (root && !root.childElementCount) {
-    root.remove();
-  }
-}
-function showToast(type, message, options) {
-  const root = ensureToastRoot();
-  if (!root) {
-    return "";
-  }
-  const id = options?.key || `toast-${Date.now()}-${++toastSeed}`;
-  clearToastTimer(id);
-  elementMap.get(id)?.remove();
-  const isMobile = typeof window !== "undefined" && window.matchMedia("(max-width: 768px)").matches;
-  const textSize = isMobile ? "12px" : "14px";
-  const toast = document.createElement("div");
-  toast.setAttribute("role", "status");
-  Object.assign(toast.style, {
-    pointerEvents: "auto",
-    display: "flex",
-    alignItems: "center",
-    gap: "12px",
-    minWidth: "240px",
-    padding: "16px",
-    borderRadius: "12px",
-    border: "1px solid rgba(255, 255, 255, 0.20)",
-    background: "rgba(0, 0, 0, 0.80)",
-    boxShadow: "0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1)",
-    fontFamily: "Rubik, ui-sans-serif, system-ui, sans-serif",
-    fontSize: textSize,
-    fontWeight: "400",
-    lineHeight: "14px"
-  });
-  const content = document.createElement("span");
-  content.textContent = message;
-  Object.assign(content.style, {
-    paddingRight: "0px",
-    textAlign: "center",
-    color: "#ffffff",
-    fontFamily: "Rubik, ui-sans-serif, system-ui, sans-serif",
-    fontSize: textSize,
-    fontWeight: "400",
-    lineHeight: "14px"
-  });
-  toast.appendChild(createIcon(type));
-  toast.appendChild(content);
-  root.appendChild(toast);
-  elementMap.set(id, toast);
-  const timer = window.setTimeout(() => {
-    destroyToast(id);
-  }, options?.duration ?? TOAST_DURATION_MS);
-  timeoutMap.set(id, timer);
-  return id;
-}
-var browserToast = {
-  success(message, options) {
-    return showToast("success", message, options);
-  },
-  error(message, options) {
-    return showToast("error", message, options);
-  },
-  destroy(id) {
-    destroyToast(id);
-  }
-};
-
 // src/shared/error-utils.ts
 function notifyError(error, notifier, fallbackMessage) {
   const resolved = error instanceof Error ? error : Object.assign(new Error(fallbackMessage), { cause: error });
-  if (!resolved.__XmaxNotified) {
+  if (!resolved.__XmaxNotified && notifier) {
     resolved.__XmaxNotified = true;
     const message = resolved.message || fallbackMessage;
-    if (notifier) {
-      notifier(message, error);
-    } else if (typeof window !== "undefined" && typeof document !== "undefined") {
-      browserToast.error(message);
-    }
+    notifier(message, error);
   }
   return resolved;
 }
@@ -483,7 +352,7 @@ var XmaxOpenClient = class {
     }
     throw notifyError(error, this.onError, message);
   }
-  /** Stop heartbeat, abort in-flight API requests, and suppress error toasts during teardown. */
+  /** Stop heartbeat, abort in-flight API requests, and suppress error notifications during teardown. */
   beginTeardown() {
     this.suppressErrorNotification = true;
     this.stopHeartbeat();
@@ -643,6 +512,23 @@ var XmaxOpenClient = class {
   async uploadVideo(file) {
     return this.uploadObject(file, "video/");
   }
+  /**
+   * Upload an image then run Playground-style `/cos/image/check`.
+   * Returns the checked URL. Existing {@link uploadImage} is unchanged.
+   */
+  async uploadAndCheckImage(file) {
+    const uploaded = await this.uploadImage(file);
+    const data = await this.request("POST", "/cos/image/check", {
+      url: uploaded.url
+    });
+    if (!data?.url) {
+      this.throwError(this.i18n.t("errors.imageCheckMissingUrl"));
+    }
+    if (data.safe === false) {
+      this.throwError(this.i18n.t("errors.imageCheckUnsafe"));
+    }
+    return data.url;
+  }
   startHeartbeat(sessionUid, intervalMs = 1e4, onHeartbeat, onError) {
     this.stopHeartbeat();
     const heartbeat = async () => {
@@ -1455,45 +1341,6 @@ var _RtcManager = class _RtcManager {
       sentFrameRate: this.lastObservedSentFrameRate
     });
   }
-  /** @deprecated Use {@link ensurePublishedInputBeforeStart}. */
-  async waitForRtcOutboundBeforeStart(options) {
-    const timeoutMs = options?.timeoutMs ?? PUBLISH_READY_TIMEOUT_MS;
-    const publishAgeMs = this.publishStartedAtMs > 0 ? performance.now() - this.publishStartedAtMs : 0;
-    const localFramesPromise = publishAgeMs >= PUBLISH_WARM_SKIP_MS ? Promise.resolve({ ready: true, frameCount: 0, elapsedMs: 0 }) : this.waitForPublishedInputFrames({
-      minFrames: PUBLISH_START_MIN_FRAMES,
-      timeoutMs: PUBLISH_START_FRAME_TIMEOUT_MS
-    });
-    const [, rtcReady] = await Promise.all([
-      localFramesPromise,
-      this.waitForLocalPublishReady({ timeoutMs })
-    ]);
-    return rtcReady;
-  }
-  /** @deprecated Use {@link waitForRtcOutboundBeforeStart}. */
-  async waitForPublishedInputFramesBeforeStart() {
-    const waitOptions = this.resolveInputFrameWaitOptions();
-    const waitTasks = [
-      this.waitForLocalPublishReady({ timeoutMs: PUBLISH_READY_TIMEOUT_MS })
-    ];
-    if (waitOptions) {
-      waitTasks.push(
-        this.waitForMinPublishDuration(waitOptions.minPublishMs),
-        this.waitForPublishedInputFrames({
-          minFrames: waitOptions.minFrames,
-          timeoutMs: waitOptions.timeoutMs
-        })
-      );
-    }
-    const [rtcResult, ...rest] = await Promise.all(waitTasks);
-    const rtcSend = rtcResult;
-    const frameResult = waitOptions ? rest[1] : { ready: true, frameCount: 0, elapsedMs: 0 };
-    return {
-      ...frameResult,
-      rtcSendReady: rtcSend.ready,
-      rtcSendReason: rtcSend.reason,
-      rtcSendElapsedMs: rtcSend.elapsedSincePublishMs
-    };
-  }
   async waitForMinPublishDuration(minMs) {
     if (minMs <= 0 || this.publishStartedAtMs <= 0) {
       return;
@@ -2457,17 +2304,6 @@ function shouldSampleAtMediaTime(lastMediaTimeS, mediaTimeS) {
   }
   return mediaTimeS > lastMediaTimeS + MEDIA_TIME_EPSILON_S;
 }
-function sampleCanvasFingerprint(ctx, width, height) {
-  const points = [
-    [0, 0],
-    [Math.max(0, (width >> 1) - 1), Math.max(0, (height >> 1) - 1)],
-    [Math.max(0, width - 1), Math.max(0, height - 1)]
-  ];
-  return points.map(([x, y]) => {
-    const data = ctx.getImageData(x, y, 1, 1).data;
-    return `${data[0]},${data[1]},${data[2]}`;
-  }).join("|");
-}
 async function applyPublishTrackConstraints(track, width, height) {
   if (typeof track.applyConstraints !== "function") {
     return;
@@ -2540,12 +2376,6 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
   let lastDrawMediaTimeS = -1;
   let videoFrameCallbackId = null;
   let rafId = null;
-  const logPublishFrames = options.logPublishFrames ?? false;
-  let publishFrameIndex = 0;
-  let lastPublishWallMs = 0;
-  let lastPublishMediaTimeS = -1;
-  let publishFramesInWindow = 0;
-  let publishWindowStartMs = 0;
   const drawFrame = () => {
     if (destroyed) {
       return;
@@ -2559,52 +2389,13 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
       sourceHeight
     );
   };
-  const logPublishedFrame = (mediaTimeS, presentedFrames) => {
-    if (!logPublishFrames) {
-      return;
-    }
-    publishFrameIndex += 1;
-    const wallNowMs = performance.now();
-    const wallDeltaMs = lastPublishWallMs > 0 ? wallNowMs - lastPublishWallMs : 0;
-    const mediaDeltaS = lastPublishMediaTimeS >= 0 ? mediaTimeS - lastPublishMediaTimeS : 0;
-    lastPublishWallMs = wallNowMs;
-    lastPublishMediaTimeS = mediaTimeS;
-    publishFramesInWindow += 1;
-    if (publishWindowStartMs === 0) {
-      publishWindowStartMs = wallNowMs;
-    }
-    const fingerprint = sampleCanvasFingerprint(ctx, outputWidth, outputHeight);
-    console.warn("[upload-video \u2192 publishFrame]", {
-      frameIndex: publishFrameIndex,
-      mediaTimeS: Number(mediaTimeS.toFixed(4)),
-      mediaDeltaS: Number(mediaDeltaS.toFixed(4)),
-      wallDeltaMs: Number(wallDeltaMs.toFixed(1)),
-      effectiveFps: wallDeltaMs > 0 ? Number((1e3 / wallDeltaMs).toFixed(1)) : null,
-      presentedFrames,
-      size: `${outputWidth}\xD7${outputHeight}`,
-      fingerprint
-    });
-    const windowElapsedMs = wallNowMs - publishWindowStartMs;
-    if (windowElapsedMs >= 1e3) {
-      console.warn("[upload-video \u2192 publishFps]", {
-        framesInLast1s: publishFramesInWindow,
-        avgFps: Number((publishFramesInWindow / (windowElapsedMs / 1e3)).toFixed(2)),
-        videoCurrentTime: Number(videoEl.currentTime.toFixed(4)),
-        videoPaused: videoEl.paused,
-        videoReadyState: videoEl.readyState
-      });
-      publishFramesInWindow = 0;
-      publishWindowStartMs = wallNowMs;
-    }
-  };
-  const onPlaybackSample = (mediaTimeS, presentedFrames) => {
+  const onPlaybackSample = (mediaTimeS) => {
     if (destroyed || !shouldSampleAtMediaTime(lastDrawMediaTimeS, mediaTimeS)) {
       return;
     }
     lastDrawMediaTimeS = mediaTimeS;
     lastAdvanceAt = Date.now();
     drawFrame();
-    logPublishedFrame(mediaTimeS, presentedFrames);
   };
   const schedulePlaybackWatch = () => {
     if (destroyed) {
@@ -2613,7 +2404,7 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
     const video = videoEl;
     if (video.requestVideoFrameCallback) {
       videoFrameCallbackId = video.requestVideoFrameCallback((_now, metadata) => {
-        onPlaybackSample(metadata.mediaTime, metadata.presentedFrames);
+        onPlaybackSample(metadata.mediaTime);
         schedulePlaybackWatch();
       });
       return;
@@ -2624,7 +2415,6 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
     });
   };
   drawFrame();
-  logPublishedFrame(videoEl.currentTime);
   schedulePlaybackWatch();
   const ensurePlaying = () => {
     if (destroyed) {
@@ -2646,18 +2436,6 @@ async function createVideoFileStream(fileOrUrl, options = {}) {
   videoEl.addEventListener("ended", ensurePlaying);
   videoEl.addEventListener("stalled", ensurePlaying);
   videoEl.addEventListener("waiting", ensurePlaying);
-  if (logPublishFrames) {
-    const logPlaybackEvent = (eventName) => {
-      console.warn("[upload-video \u2192 playbackEvent]", {
-        event: eventName,
-        currentTime: Number(videoEl.currentTime.toFixed(4)),
-        readyState: videoEl.readyState,
-        paused: videoEl.paused
-      });
-    };
-    videoEl.addEventListener("waiting", () => logPlaybackEvent("waiting"));
-    videoEl.addEventListener("stalled", () => logPlaybackEvent("stalled"));
-  }
   const healthIntervalMs = options.healthIntervalMs ?? 3e3;
   let healthTimer = null;
   if (options.onHealthReport) {
@@ -3155,18 +2933,9 @@ function XmaxProvider({ config, children }) {
   const detachRemoteContainer = react.useCallback(() => {
     rtcManagerRef.current?.setRemoteVideoContainer(null);
   }, []);
-  const notifyUserError = react.useCallback((message, error) => {
-    if (externalOnError) {
-      externalOnError(message, error);
-      return;
-    }
-    if (typeof window !== "undefined" && typeof document !== "undefined") {
-      browserToast.error(message);
-    }
-  }, [externalOnError]);
   const reportError = react.useCallback((error, fallbackMessage) => {
-    return notifyError(error, notifyUserError, fallbackMessage ?? sdkI18n.t("errors.requestFailed"));
-  }, [notifyUserError, sdkI18n]);
+    return notifyError(error, externalOnError, fallbackMessage ?? sdkI18n.t("errors.requestFailed"));
+  }, [externalOnError, sdkI18n]);
   const rtcManagerRef = react.useRef(null);
   if (!rtcManagerRef.current) {
     rtcManagerRef.current = new RtcManager({
@@ -3195,11 +2964,11 @@ function XmaxProvider({ config, children }) {
       baseUrl: config.baseUrl,
       locale: config.locale,
       i18n: sdkI18n,
-      onError: notifyUserError
+      onError: externalOnError
     });
     clientRef.current = created;
     return created;
-  }, [config.apiKey, config.authToken, config.baseUrl, config.locale, notifyUserError, sdkI18n]);
+  }, [config.apiKey, config.authToken, config.baseUrl, config.locale, externalOnError, sdkI18n]);
   const ensureConnected = react.useCallback(async () => {
     const client = getClient();
     const rtc = rtcManagerRef.current;
@@ -3609,11 +3378,6 @@ function XmaxProvider({ config, children }) {
     if (!activeTaskUid) {
       return;
     }
-    console.log("[Xmax] sendTracks", {
-      taskUid: activeTaskUid,
-      targetSize: sessionTargetSize,
-      tracks: options.tracks
-    });
     try {
       const event = createTracksRtcRoomEvent({
         userId: rtc.snapshot.userId ?? void 0,
@@ -3666,9 +3430,6 @@ function XmaxProvider({ config, children }) {
       debugLogRef.current("lifecycle", "warn", "remote output stalled", info);
     };
   }, []);
-  const changeModel = react.useCallback(async () => {
-    return;
-  }, []);
   const bindLocalView = react.useCallback((el) => {
     localContainerRef.current = el;
     rtcManagerRef.current?.setLocalVideoContainer(el);
@@ -3711,7 +3472,6 @@ function XmaxProvider({ config, children }) {
     start,
     sendTracks,
     stop,
-    changeModel,
     bindLocalView,
     bindRemoteView
   }), [
@@ -3736,7 +3496,6 @@ function XmaxProvider({ config, children }) {
     start,
     sendTracks,
     stop,
-    changeModel,
     bindLocalView,
     bindRemoteView
   ]);