@xmaxai/sdk 0.1.0

package/dist/react/index.d.cts

@@ -0,0 +1,112 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { S as SDKLocale, a as SDKI18n, X as XmaxErrorNotifier, R as RtcStateSnapshot, U as UploadImageResult } from '../rtc-manager-gYDkADGw.cjs';
+
+type InputSource = 'none' | 'camera' | 'video';
+type XmaxSeiGateState = {
+    expectedSei: string | null;
+    sei: string | null;
+    userId: string | null;
+    matched: boolean;
+};
+type XmaxSnapshot = {
+    sessionUid: string | null;
+    rtc: RtcStateSnapshot;
+    inputSource: InputSource;
+    isCameraOn: boolean;
+    isRecording: boolean;
+    isGenerating: boolean;
+    isOutputVerifying: boolean;
+    hasResult: boolean;
+    outputEnabled: boolean;
+    dragEnabled: boolean;
+    showOutputVideo: boolean;
+    localVideoSize: {
+        width: number;
+        height: number;
+    } | null;
+    sessionTargetSize: [number, number] | null;
+    seiGate: XmaxSeiGateState;
+};
+type XmaxConfig = {
+    apiKey: string;
+    /** Open API base URL, e.g. XMAX_OPEN_API_PRODUCTION_BASE_URL */
+    baseUrl: string;
+    authToken?: string;
+    model?: string;
+    heartbeatIntervalMs?: number;
+    locale?: SDKLocale;
+    i18n?: SDKI18n;
+    onError?: XmaxErrorNotifier;
+    /** Extra structured logs for upload-video freeze / output drop investigations. */
+    debug?: boolean;
+    onLog?: (entry: {
+        scope: 'client' | 'rtc';
+        level: 'info' | 'success' | 'warn' | 'error';
+        message: string;
+        data?: unknown;
+    }) => void;
+};
+type XmaxContextValue = {
+    snapshot: XmaxSnapshot;
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    openCamera: (options?: {
+        size?: [number, number];
+    }) => Promise<void>;
+    closeCamera: () => Promise<void>;
+    loadVideoFile: (file: File, options?: {
+        size?: [number, number];
+    }) => Promise<{
+        url: string;
+        width: number;
+        height: number;
+        /** Canvas capture stream — same pixels sent to RTC; use as preview srcObject. */
+        previewStream: MediaStream;
+        videoEl: HTMLVideoElement;
+        /** Session size after SDK 832-rule processing */
+        targetSize: [number, number];
+    } | null>;
+    clearInput: () => Promise<void>;
+    uploadImage: (file: File) => Promise<UploadImageResult>;
+    setRefImage: (input: File | string) => Promise<string>;
+    start: (options: {
+        size?: [number, number];
+        prompt?: string;
+        model: string;
+        /** When set (including `null`), overrides stored ref image for this start event. */
+        refImage?: string | null;
+        extraParams?: Record<string, unknown>;
+    }) => Promise<void>;
+    sendTracks: (options: {
+        tracks: Array<[number, number]>;
+    }) => Promise<void>;
+    stop: () => Promise<void>;
+    /** @deprecated Mode switching is handled by stop + start with new prompt/refImage. */
+    changeModel: () => Promise<void>;
+    bindLocalView: (el: HTMLElement | null) => void;
+    bindRemoteView: (el: HTMLElement | null) => void;
+};
+
+declare function XmaxProvider({ config, children }: {
+    config: XmaxConfig;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useXmax(): XmaxContextValue;
+
+declare function XmaxView({ kind, className, style, }: {
+    kind: 'local' | 'remote';
+    className?: string;
+    style?: React.CSSProperties;
+}): react.JSX.Element;
+
+declare function DragTrackSurface({ enabled, targetSize, onTracks, className, style, fitMode, }: {
+    enabled: boolean;
+    targetSize: [number, number];
+    onTracks: (tracks: Array<[number, number]>) => void | Promise<void>;
+    className?: string;
+    style?: React.CSSProperties;
+    fitMode?: 'contain' | 'cover';
+}): react.JSX.Element;
+
+export { DragTrackSurface, type InputSource, type XmaxConfig, type XmaxContextValue, XmaxProvider, type XmaxSeiGateState, type XmaxSnapshot, XmaxView, useXmax };

package/dist/react/index.d.ts

@@ -0,0 +1,112 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { S as SDKLocale, a as SDKI18n, X as XmaxErrorNotifier, R as RtcStateSnapshot, U as UploadImageResult } from '../rtc-manager-gYDkADGw.js';
+
+type InputSource = 'none' | 'camera' | 'video';
+type XmaxSeiGateState = {
+    expectedSei: string | null;
+    sei: string | null;
+    userId: string | null;
+    matched: boolean;
+};
+type XmaxSnapshot = {
+    sessionUid: string | null;
+    rtc: RtcStateSnapshot;
+    inputSource: InputSource;
+    isCameraOn: boolean;
+    isRecording: boolean;
+    isGenerating: boolean;
+    isOutputVerifying: boolean;
+    hasResult: boolean;
+    outputEnabled: boolean;
+    dragEnabled: boolean;
+    showOutputVideo: boolean;
+    localVideoSize: {
+        width: number;
+        height: number;
+    } | null;
+    sessionTargetSize: [number, number] | null;
+    seiGate: XmaxSeiGateState;
+};
+type XmaxConfig = {
+    apiKey: string;
+    /** Open API base URL, e.g. XMAX_OPEN_API_PRODUCTION_BASE_URL */
+    baseUrl: string;
+    authToken?: string;
+    model?: string;
+    heartbeatIntervalMs?: number;
+    locale?: SDKLocale;
+    i18n?: SDKI18n;
+    onError?: XmaxErrorNotifier;
+    /** Extra structured logs for upload-video freeze / output drop investigations. */
+    debug?: boolean;
+    onLog?: (entry: {
+        scope: 'client' | 'rtc';
+        level: 'info' | 'success' | 'warn' | 'error';
+        message: string;
+        data?: unknown;
+    }) => void;
+};
+type XmaxContextValue = {
+    snapshot: XmaxSnapshot;
+    connect: () => Promise<void>;
+    disconnect: () => Promise<void>;
+    openCamera: (options?: {
+        size?: [number, number];
+    }) => Promise<void>;
+    closeCamera: () => Promise<void>;
+    loadVideoFile: (file: File, options?: {
+        size?: [number, number];
+    }) => Promise<{
+        url: string;
+        width: number;
+        height: number;
+        /** Canvas capture stream — same pixels sent to RTC; use as preview srcObject. */
+        previewStream: MediaStream;
+        videoEl: HTMLVideoElement;
+        /** Session size after SDK 832-rule processing */
+        targetSize: [number, number];
+    } | null>;
+    clearInput: () => Promise<void>;
+    uploadImage: (file: File) => Promise<UploadImageResult>;
+    setRefImage: (input: File | string) => Promise<string>;
+    start: (options: {
+        size?: [number, number];
+        prompt?: string;
+        model: string;
+        /** When set (including `null`), overrides stored ref image for this start event. */
+        refImage?: string | null;
+        extraParams?: Record<string, unknown>;
+    }) => Promise<void>;
+    sendTracks: (options: {
+        tracks: Array<[number, number]>;
+    }) => Promise<void>;
+    stop: () => Promise<void>;
+    /** @deprecated Mode switching is handled by stop + start with new prompt/refImage. */
+    changeModel: () => Promise<void>;
+    bindLocalView: (el: HTMLElement | null) => void;
+    bindRemoteView: (el: HTMLElement | null) => void;
+};
+
+declare function XmaxProvider({ config, children }: {
+    config: XmaxConfig;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useXmax(): XmaxContextValue;
+
+declare function XmaxView({ kind, className, style, }: {
+    kind: 'local' | 'remote';
+    className?: string;
+    style?: React.CSSProperties;
+}): react.JSX.Element;
+
+declare function DragTrackSurface({ enabled, targetSize, onTracks, className, style, fitMode, }: {
+    enabled: boolean;
+    targetSize: [number, number];
+    onTracks: (tracks: Array<[number, number]>) => void | Promise<void>;
+    className?: string;
+    style?: React.CSSProperties;
+    fitMode?: 'contain' | 'cover';
+}): react.JSX.Element;
+
+export { DragTrackSurface, type InputSource, type XmaxConfig, type XmaxContextValue, XmaxProvider, type XmaxSeiGateState, type XmaxSnapshot, XmaxView, useXmax };