connectbase-client 5.12.6 → 6.0.0

package/dist/index.d.mts

@@ -5144,6 +5144,14 @@ interface NativeBridgeInterface {
             rewarded: boolean;
         }>;
     };
+    /** 모바일 전용: 네이티브 인앱 브라우저 세션으로 여는 OAuth (ASWebAuthenticationSession/Custom Tabs) */
+    oauth?: {
+        signIn: (authUrl: string, callbackScheme: string) => Promise<{
+            url: string;
+        }>;
+        /** 이 패키징 앱의 OAuth 콜백 URL 스킴 (`<scheme>://oauth/callback`). 동기 함수 */
+        getCallbackScheme: () => string;
+    };
     system?: {
         getInfo: () => Promise<SystemInfo>;
         getMemory: () => Promise<MemoryInfo>;
@@ -5173,6 +5181,7 @@ interface NativeBridgeInterface {
         readImage: () => Promise<string | null>;
         writeImage: (dataURL: string) => Promise<void>;
         clear: () => Promise<void>;
+        has: (format: string) => Promise<boolean>;
     };
     shell?: {
         openExternal: (url: string) => Promise<{
@@ -5242,6 +5251,22 @@ interface NativeBridgeInterface {
         getAppDir?: () => Promise<string>;
     };
     onDeepLink?: (callback: (url: string) => void) => () => void;
+    /** 모바일 전용: 앱에 연결된 Connect Base Storage 로 파일 업로드 (file_storage.type=connectbase 일 때만 존재) */
+    connectbase?: {
+        uploadFile: (uri: string, filename?: string, mimeType?: string) => Promise<{
+            id: string;
+            name: string;
+            url: string;
+            path: string;
+            storageId: string;
+        }>;
+    };
+    /**
+     * 데스크톱 전용: 저수준 이벤트 구독 (`off` 는 해당 채널의 모든 리스너를 제거한다 — 콜백
+     * 단위 해제가 아니다). `deep-link` 는 `onDeepLink` 로도 동일하게 구독할 수 있다.
+     */
+    on?: (channel: "deep-link" | "window-focus" | "window-blur" | "update-available" | "update-downloaded", callback: (...args: unknown[]) => void) => void;
+    off?: (channel: "deep-link" | "window-focus" | "window-blur" | "update-available" | "update-downloaded") => void;
 }
 type Platform = "web" | "mobile" | "desktop";
 /** 패키징 앱 정보 (`cb.native.getAppInfo()`) */
@@ -5459,6 +5484,10 @@ declare class NativeAPI {
          * 이미지 읽기 (데스크톱 전용, Data URL 반환)
          */
         readImage: () => Promise<string | null>;
+        /**
+         * 클립보드에 특정 형식(MIME 타입, 예: 'text/plain', 'image/png')의 데이터가 있는지 확인 (데스크톱 전용)
+         */
+        has: (format: string) => Promise<boolean>;
     };
     /**
      * 크로스 플랫폼 파일 시스템 API
@@ -5573,6 +5602,47 @@ declare class NativeAPI {
          */
         openExternal: (url: string) => Promise<boolean>;
     };
+    /**
+     * 모바일 전용: 네이티브 인앱 브라우저 세션으로 여는 OAuth
+     *
+     * WebView 안에서 소셜 로그인 팝업을 열면 세션/쿠키가 격리돼 실패하는 경우가 많다.
+     * 패키징 앱(RN)에서는 시스템 브라우저 세션(iOS ASWebAuthenticationSession /
+     * Android Custom Tabs)으로 열고 앱 URL 스킴 콜백으로 결과를 받는다.
+     * 웹/데스크톱에서는 지원하지 않는다 — 일반 팝업/리다이렉트 OAuth 플로우를 쓸 것.
+     *
+     * @example
+     * ```typescript
+     * if (cb.native.getPlatform() === 'mobile') {
+     *   const result = await cb.native.oauth.signIn(authorizeUrl)
+     *   if (result) window.location.href = result.url // 콜백 URL 로 계속 진행
+     * }
+     * ```
+     */
+    oauth: {
+        /**
+         * OAuth 인가 URL 을 네이티브 인앱 브라우저 세션으로 열고 콜백 URL 을 기다린다.
+         * callbackScheme 을 생략하면 이 패키징 앱의 스킴(getCallbackScheme())을 사용한다.
+         * 사용자가 취소했거나 미지원 플랫폼이면 null.
+         */
+        signIn: (authUrl: string, callbackScheme?: string) => Promise<{
+            url: string;
+        } | null>;
+        /** 이 패키징 앱의 OAuth 콜백 URL 스킴(`<scheme>://oauth/callback`). 미지원 플랫폼은 null (동기) */
+        getCallbackScheme: () => string | null;
+    };
+    /**
+     * 모바일 전용: 패키징 앱에 연결된 Connect Base Storage 로 파일 업로드.
+     * 콘솔 패키징 설정에서 "파일 저장 위치" 를 Connect Base Storage 로 선택한 경우에만 지원한다.
+     */
+    connectbase: {
+        uploadFile: (uri: string, filename?: string, mimeType?: string) => Promise<{
+            id: string;
+            name: string;
+            url: string;
+            path: string;
+            storageId: string;
+        } | null>;
+    };
     /**
      * 데스크톱 전용 창 제어 API
      */
@@ -5584,6 +5654,19 @@ declare class NativeAPI {
         isMaximized: () => Promise<boolean>;
         setTitle: (title: string) => Promise<void>;
         setFullScreen: (flag: boolean) => Promise<void>;
+        isFullScreen: () => Promise<boolean>;
+        /** 창 크기 설정 (데스크톱 전용) */
+        setSize: (width: number, height: number) => Promise<void>;
+        /** 창 크기 조회 (데스크톱 전용, 미지원 플랫폼은 null) */
+        getSize: () => Promise<[number, number] | null>;
+        /** 창 위치 설정 (데스크톱 전용) */
+        setPosition: (x: number, y: number) => Promise<void>;
+        /** 창 위치 조회 (데스크톱 전용, 미지원 플랫폼은 null) */
+        getPosition: () => Promise<[number, number] | null>;
+        /** 화면 중앙으로 이동 (데스크톱 전용) */
+        center: () => Promise<void>;
+        /** 항상 위에 표시 설정 (데스크톱 전용) */
+        setAlwaysOnTop: (flag: boolean) => Promise<void>;
     };
     /**
      * 데스크톱 전용 시스템 정보 API
@@ -5591,6 +5674,7 @@ declare class NativeAPI {
     system: {
         getInfo: () => Promise<SystemInfo | null>;
         getMemory: () => Promise<MemoryInfo | null>;
+        getCPU: () => Promise<CPUInfo | null>;
     };
     /**
      * 모바일 전용 생체인증 API
@@ -7319,9 +7403,31 @@ declare class RealtimeAPI {
      */
     getState(): ConnectionState;
     /**
-     * 연결 여부 확인
+     * pub/sub 사용 가능 여부.
+     *
+     * WebSocket 으로 연결됐을 때만 true 다. SSE fallback 모드에서는 `subscribe` /
+     * `sendMessage` / `setPresence` / typing 이 전부 예외를 던지므로, 여기서 true 를
+     * 반환하면 앱이 "연결됨"으로 오판하고 아무것도 오가지 않는 채 조용히 멈춘다
+     * (platform-issue 01a01e6a-3cb1).
+     *
+     * AI 스트리밍만 필요하다면 {@link isStreamReady} 를, 다운그레이드 여부를 알고 싶다면
+     * {@link isDegraded} 를 쓴다.
      */
     isConnected(): boolean;
+    /**
+     * SSE fallback 으로 다운그레이드된 상태인지 여부.
+     *
+     * true 면 연결은 살아 있지만 단방향이라 `realtime.stream()` 만 동작한다. 사용자에게
+     * "제한된 네트워크라 일부 기능을 쓸 수 없다" 고 안내할 지점이다.
+     */
+    isDegraded(): boolean;
+    /**
+     * AI 스트리밍(`realtime.stream()`) 사용 가능 여부.
+     *
+     * WS 든 SSE fallback 이든 연결만 서 있으면 true 다. 종전 `isConnected()` 와 같은
+     * 판정이므로, 스트리밍 게이팅에 `isConnected()` 를 쓰던 코드는 이쪽으로 옮긴다.
+     */
+    isStreamReady(): boolean;
     /**
      * 상태 변경 핸들러 등록
      */
@@ -9963,6 +10069,14 @@ interface ICEServer {
 /** ICE 서버 목록 응답 */
 interface ICEServersResponse {
     ice_servers: ICEServer[];
+    /**
+     * ephemeral TURN 자격증명의 만료 시각(Unix epoch 초).
+     *
+     * 서버가 `TURN_SHARED_SECRET` 으로 시간제한 자격증명을 발급한 경우에만 0 이 아니다.
+     * STUN 전용 구성에서는 0 — 만료가 없다는 뜻이다. 통화가 길어질 수 있으면 이 시각
+     * 전에 `getICEServers()` 를 다시 불러 새 자격증명을 받는다.
+     */
+    expires_at?: number;
 }
 /**
  * 채널별 통계 (룸 ID 의 `channel:room` 컨벤션 기준 집계).
@@ -10038,6 +10152,16 @@ declare class WebRTCAPI {
     private reconnectAttempts;
     private maxReconnectAttempts;
     private reconnectTimeout;
+    /**
+     * 시그널링 소켓의 세대(generation) 토큰.
+     *
+     * 소켓을 열 때마다 1 증가하며, 각 핸들러는 자기가 열릴 때의 세대를 클로저에 담아둔다.
+     * 세대가 밀린 핸들러는 "옛 소켓의 지연 이벤트" 이므로 인스턴스 상태를 건드리지 않는다.
+     * 참조(`this.ws`)만 끊는 것으로는 부족하다 — 핸들러 클로저가 인스턴스를 캡처하고 있어
+     * close 이벤트가 뒤늦게 도착하면 새 연결을 'disconnected' 로 덮어쓰고 새로 만든 피어
+     * 연결까지 정리해버린다.
+     */
+    private wsGeneration;
     private currentRoomId;
     private currentPeerId;
     private currentUserId;
@@ -10074,6 +10198,14 @@ declare class WebRTCAPI {
      */
     connect(options: WebRTCConnectOptions): Promise<void>;
     private connectWebSocket;
+    /**
+     * 소켓에 붙은 핸들러를 전부 떼어낸다.
+     *
+     * `this.ws = null` 로 참조만 끊으면 클로저가 살아남아 close 이벤트가 계속 들어온다.
+     * 세대 토큰이 그 이벤트를 무시해주긴 하지만, 핸들러 자체를 떼면 인스턴스 참조가 끊겨
+     * 소켓이 GC 될 때까지 인스턴스를 붙잡고 있지 않는다.
+     */
+    private static detachSocket;
     private buildWebSocketUrl;
     private handleSignalingMessage;
     private createPeerConnection;
@@ -10088,6 +10220,44 @@ declare class WebRTCAPI {
      * WebRTC 연결 해제
      */
     disconnect(): void;
+    /**
+     * 현재 세션의 룸을 교체한다.
+     *
+     * `disconnect()` 후 곧바로 `connect()` 하는 패턴을 안전하게 감싼 것이다. 옛 소켓의
+     * close 이벤트가 새 연결의 'connecting' 구간에 떨어져도 세대 토큰이 걸러낸다.
+     * 생략한 옵션은 현재 세션 값을 그대로 이어받는다.
+     *
+     * @example
+     * ```typescript
+     * await cb.webrtc.switchRoom('channel:room-b')
+     * ```
+     */
+    switchRoom(roomId: string, options?: Omit<WebRTCConnectOptions, "roomId">): Promise<void>;
+    /**
+     * 소켓, 룸, 이벤트 리스너, 피어 연결을 **독립적으로** 갖는 새 WebRTC 세션을 만든다.
+     *
+     * `cb.webrtc` 는 인스턴스 하나에 소켓 하나/룸 하나라, 한 앱에 WebRTC 기능이 둘 이상이면
+     * (예: 공간 음성채팅 + 1:1 통화) 서로 연결을 뺏고 이벤트가 교차한다. 기능마다 세션을
+     * 하나씩 만들면 각자의 소켓과 핸들러를 갖는다.
+     *
+     * 인증 정보(HttpClient)와 서버 주소, appId 는 부모와 공유한다.
+     *
+     * @example
+     * ```typescript
+     * const voice = cb.webrtc.createSession()
+     * const call = cb.webrtc.createSession()
+     *
+     * voice.onRemoteStream((peerId, stream) => attachToSpatialAudio(peerId, stream))
+     * call.onRemoteStream((peerId, stream) => showCallScreen(stream))
+     *
+     * await voice.connect({ roomId: 'voice:lobby', localStream: mic })
+     * await call.connect({ roomId: 'call:alice-bob', localStream: mic })
+     *
+     * // 각 세션은 독립적으로 끊는다
+     * call.disconnect()
+     * ```
+     */
+    createSession(): WebRTCAPI;
     /**
      * 현재 연결 상태 조회
      */

package/dist/index.d.ts

@@ -5144,6 +5144,14 @@ interface NativeBridgeInterface {
             rewarded: boolean;
         }>;
     };
+    /** 모바일 전용: 네이티브 인앱 브라우저 세션으로 여는 OAuth (ASWebAuthenticationSession/Custom Tabs) */
+    oauth?: {
+        signIn: (authUrl: string, callbackScheme: string) => Promise<{
+            url: string;
+        }>;
+        /** 이 패키징 앱의 OAuth 콜백 URL 스킴 (`<scheme>://oauth/callback`). 동기 함수 */
+        getCallbackScheme: () => string;
+    };
     system?: {
         getInfo: () => Promise<SystemInfo>;
         getMemory: () => Promise<MemoryInfo>;
@@ -5173,6 +5181,7 @@ interface NativeBridgeInterface {
         readImage: () => Promise<string | null>;
         writeImage: (dataURL: string) => Promise<void>;
         clear: () => Promise<void>;
+        has: (format: string) => Promise<boolean>;
     };
     shell?: {
         openExternal: (url: string) => Promise<{
@@ -5242,6 +5251,22 @@ interface NativeBridgeInterface {
         getAppDir?: () => Promise<string>;
     };
     onDeepLink?: (callback: (url: string) => void) => () => void;
+    /** 모바일 전용: 앱에 연결된 Connect Base Storage 로 파일 업로드 (file_storage.type=connectbase 일 때만 존재) */
+    connectbase?: {
+        uploadFile: (uri: string, filename?: string, mimeType?: string) => Promise<{
+            id: string;
+            name: string;
+            url: string;
+            path: string;
+            storageId: string;
+        }>;
+    };
+    /**
+     * 데스크톱 전용: 저수준 이벤트 구독 (`off` 는 해당 채널의 모든 리스너를 제거한다 — 콜백
+     * 단위 해제가 아니다). `deep-link` 는 `onDeepLink` 로도 동일하게 구독할 수 있다.
+     */
+    on?: (channel: "deep-link" | "window-focus" | "window-blur" | "update-available" | "update-downloaded", callback: (...args: unknown[]) => void) => void;
+    off?: (channel: "deep-link" | "window-focus" | "window-blur" | "update-available" | "update-downloaded") => void;
 }
 type Platform = "web" | "mobile" | "desktop";
 /** 패키징 앱 정보 (`cb.native.getAppInfo()`) */
@@ -5459,6 +5484,10 @@ declare class NativeAPI {
          * 이미지 읽기 (데스크톱 전용, Data URL 반환)
          */
         readImage: () => Promise<string | null>;
+        /**
+         * 클립보드에 특정 형식(MIME 타입, 예: 'text/plain', 'image/png')의 데이터가 있는지 확인 (데스크톱 전용)
+         */
+        has: (format: string) => Promise<boolean>;
     };
     /**
      * 크로스 플랫폼 파일 시스템 API
@@ -5573,6 +5602,47 @@ declare class NativeAPI {
          */
         openExternal: (url: string) => Promise<boolean>;
     };
+    /**
+     * 모바일 전용: 네이티브 인앱 브라우저 세션으로 여는 OAuth
+     *
+     * WebView 안에서 소셜 로그인 팝업을 열면 세션/쿠키가 격리돼 실패하는 경우가 많다.
+     * 패키징 앱(RN)에서는 시스템 브라우저 세션(iOS ASWebAuthenticationSession /
+     * Android Custom Tabs)으로 열고 앱 URL 스킴 콜백으로 결과를 받는다.
+     * 웹/데스크톱에서는 지원하지 않는다 — 일반 팝업/리다이렉트 OAuth 플로우를 쓸 것.
+     *
+     * @example
+     * ```typescript
+     * if (cb.native.getPlatform() === 'mobile') {
+     *   const result = await cb.native.oauth.signIn(authorizeUrl)
+     *   if (result) window.location.href = result.url // 콜백 URL 로 계속 진행
+     * }
+     * ```
+     */
+    oauth: {
+        /**
+         * OAuth 인가 URL 을 네이티브 인앱 브라우저 세션으로 열고 콜백 URL 을 기다린다.
+         * callbackScheme 을 생략하면 이 패키징 앱의 스킴(getCallbackScheme())을 사용한다.
+         * 사용자가 취소했거나 미지원 플랫폼이면 null.
+         */
+        signIn: (authUrl: string, callbackScheme?: string) => Promise<{
+            url: string;
+        } | null>;
+        /** 이 패키징 앱의 OAuth 콜백 URL 스킴(`<scheme>://oauth/callback`). 미지원 플랫폼은 null (동기) */
+        getCallbackScheme: () => string | null;
+    };
+    /**
+     * 모바일 전용: 패키징 앱에 연결된 Connect Base Storage 로 파일 업로드.
+     * 콘솔 패키징 설정에서 "파일 저장 위치" 를 Connect Base Storage 로 선택한 경우에만 지원한다.
+     */
+    connectbase: {
+        uploadFile: (uri: string, filename?: string, mimeType?: string) => Promise<{
+            id: string;
+            name: string;
+            url: string;
+            path: string;
+            storageId: string;
+        } | null>;
+    };
     /**
      * 데스크톱 전용 창 제어 API
      */
@@ -5584,6 +5654,19 @@ declare class NativeAPI {
         isMaximized: () => Promise<boolean>;
         setTitle: (title: string) => Promise<void>;
         setFullScreen: (flag: boolean) => Promise<void>;
+        isFullScreen: () => Promise<boolean>;
+        /** 창 크기 설정 (데스크톱 전용) */
+        setSize: (width: number, height: number) => Promise<void>;
+        /** 창 크기 조회 (데스크톱 전용, 미지원 플랫폼은 null) */
+        getSize: () => Promise<[number, number] | null>;
+        /** 창 위치 설정 (데스크톱 전용) */
+        setPosition: (x: number, y: number) => Promise<void>;
+        /** 창 위치 조회 (데스크톱 전용, 미지원 플랫폼은 null) */
+        getPosition: () => Promise<[number, number] | null>;
+        /** 화면 중앙으로 이동 (데스크톱 전용) */
+        center: () => Promise<void>;
+        /** 항상 위에 표시 설정 (데스크톱 전용) */
+        setAlwaysOnTop: (flag: boolean) => Promise<void>;
     };
     /**
      * 데스크톱 전용 시스템 정보 API
@@ -5591,6 +5674,7 @@ declare class NativeAPI {
     system: {
         getInfo: () => Promise<SystemInfo | null>;
         getMemory: () => Promise<MemoryInfo | null>;
+        getCPU: () => Promise<CPUInfo | null>;
     };
     /**
      * 모바일 전용 생체인증 API
@@ -7319,9 +7403,31 @@ declare class RealtimeAPI {
      */
     getState(): ConnectionState;
     /**
-     * 연결 여부 확인
+     * pub/sub 사용 가능 여부.
+     *
+     * WebSocket 으로 연결됐을 때만 true 다. SSE fallback 모드에서는 `subscribe` /
+     * `sendMessage` / `setPresence` / typing 이 전부 예외를 던지므로, 여기서 true 를
+     * 반환하면 앱이 "연결됨"으로 오판하고 아무것도 오가지 않는 채 조용히 멈춘다
+     * (platform-issue 01a01e6a-3cb1).
+     *
+     * AI 스트리밍만 필요하다면 {@link isStreamReady} 를, 다운그레이드 여부를 알고 싶다면
+     * {@link isDegraded} 를 쓴다.
      */
     isConnected(): boolean;
+    /**
+     * SSE fallback 으로 다운그레이드된 상태인지 여부.
+     *
+     * true 면 연결은 살아 있지만 단방향이라 `realtime.stream()` 만 동작한다. 사용자에게
+     * "제한된 네트워크라 일부 기능을 쓸 수 없다" 고 안내할 지점이다.
+     */
+    isDegraded(): boolean;
+    /**
+     * AI 스트리밍(`realtime.stream()`) 사용 가능 여부.
+     *
+     * WS 든 SSE fallback 이든 연결만 서 있으면 true 다. 종전 `isConnected()` 와 같은
+     * 판정이므로, 스트리밍 게이팅에 `isConnected()` 를 쓰던 코드는 이쪽으로 옮긴다.
+     */
+    isStreamReady(): boolean;
     /**
      * 상태 변경 핸들러 등록
      */
@@ -9963,6 +10069,14 @@ interface ICEServer {
 /** ICE 서버 목록 응답 */
 interface ICEServersResponse {
     ice_servers: ICEServer[];
+    /**
+     * ephemeral TURN 자격증명의 만료 시각(Unix epoch 초).
+     *
+     * 서버가 `TURN_SHARED_SECRET` 으로 시간제한 자격증명을 발급한 경우에만 0 이 아니다.
+     * STUN 전용 구성에서는 0 — 만료가 없다는 뜻이다. 통화가 길어질 수 있으면 이 시각
+     * 전에 `getICEServers()` 를 다시 불러 새 자격증명을 받는다.
+     */
+    expires_at?: number;
 }
 /**
  * 채널별 통계 (룸 ID 의 `channel:room` 컨벤션 기준 집계).
@@ -10038,6 +10152,16 @@ declare class WebRTCAPI {
     private reconnectAttempts;
     private maxReconnectAttempts;
     private reconnectTimeout;
+    /**
+     * 시그널링 소켓의 세대(generation) 토큰.
+     *
+     * 소켓을 열 때마다 1 증가하며, 각 핸들러는 자기가 열릴 때의 세대를 클로저에 담아둔다.
+     * 세대가 밀린 핸들러는 "옛 소켓의 지연 이벤트" 이므로 인스턴스 상태를 건드리지 않는다.
+     * 참조(`this.ws`)만 끊는 것으로는 부족하다 — 핸들러 클로저가 인스턴스를 캡처하고 있어
+     * close 이벤트가 뒤늦게 도착하면 새 연결을 'disconnected' 로 덮어쓰고 새로 만든 피어
+     * 연결까지 정리해버린다.
+     */
+    private wsGeneration;
     private currentRoomId;
     private currentPeerId;
     private currentUserId;
@@ -10074,6 +10198,14 @@ declare class WebRTCAPI {
      */
     connect(options: WebRTCConnectOptions): Promise<void>;
     private connectWebSocket;
+    /**
+     * 소켓에 붙은 핸들러를 전부 떼어낸다.
+     *
+     * `this.ws = null` 로 참조만 끊으면 클로저가 살아남아 close 이벤트가 계속 들어온다.
+     * 세대 토큰이 그 이벤트를 무시해주긴 하지만, 핸들러 자체를 떼면 인스턴스 참조가 끊겨
+     * 소켓이 GC 될 때까지 인스턴스를 붙잡고 있지 않는다.
+     */
+    private static detachSocket;
     private buildWebSocketUrl;
     private handleSignalingMessage;
     private createPeerConnection;
@@ -10088,6 +10220,44 @@ declare class WebRTCAPI {
      * WebRTC 연결 해제
      */
     disconnect(): void;
+    /**
+     * 현재 세션의 룸을 교체한다.
+     *
+     * `disconnect()` 후 곧바로 `connect()` 하는 패턴을 안전하게 감싼 것이다. 옛 소켓의
+     * close 이벤트가 새 연결의 'connecting' 구간에 떨어져도 세대 토큰이 걸러낸다.
+     * 생략한 옵션은 현재 세션 값을 그대로 이어받는다.
+     *
+     * @example
+     * ```typescript
+     * await cb.webrtc.switchRoom('channel:room-b')
+     * ```
+     */
+    switchRoom(roomId: string, options?: Omit<WebRTCConnectOptions, "roomId">): Promise<void>;
+    /**
+     * 소켓, 룸, 이벤트 리스너, 피어 연결을 **독립적으로** 갖는 새 WebRTC 세션을 만든다.
+     *
+     * `cb.webrtc` 는 인스턴스 하나에 소켓 하나/룸 하나라, 한 앱에 WebRTC 기능이 둘 이상이면
+     * (예: 공간 음성채팅 + 1:1 통화) 서로 연결을 뺏고 이벤트가 교차한다. 기능마다 세션을
+     * 하나씩 만들면 각자의 소켓과 핸들러를 갖는다.
+     *
+     * 인증 정보(HttpClient)와 서버 주소, appId 는 부모와 공유한다.
+     *
+     * @example
+     * ```typescript
+     * const voice = cb.webrtc.createSession()
+     * const call = cb.webrtc.createSession()
+     *
+     * voice.onRemoteStream((peerId, stream) => attachToSpatialAudio(peerId, stream))
+     * call.onRemoteStream((peerId, stream) => showCallScreen(stream))
+     *
+     * await voice.connect({ roomId: 'voice:lobby', localStream: mic })
+     * await call.connect({ roomId: 'call:alice-bob', localStream: mic })
+     *
+     * // 각 세션은 독립적으로 끊는다
+     * call.disconnect()
+     * ```
+     */
+    createSession(): WebRTCAPI;
     /**
      * 현재 연결 상태 조회
      */