connectbase-client 5.12.5 → 5.13.0

package/dist/index.d.mts

@@ -4146,16 +4146,19 @@ interface MatchResult {
     rating_change: number;
     played_at: string;
 }
+/**
+ * `joinVoiceChannel()` 응답 — game-server 의 PTT(Push-To-Talk) 방 참가 확인.
+ *
+ * 실시간 오디오는 이 응답이 아니라 별도 WebSocket
+ * (`GET /v1/game/:appID/voice/ws?player_id=&room_id=`)으로 전송된다. `cb.webrtc.connect()`
+ * (webrtc-server 의 SDP/ICE 시그널링)와는 무관한 별개 경로다 — 과거 문서/타입이 `id`/`name`/
+ * `type`/`members`/`webrtc_room_id` 등을 포함하는 것처럼 기술했으나, 실제 서버 응답에는
+ * 존재하지 않아 항상 `undefined`였다(platform-issue 019fe5bb).
+ */
 interface VoiceChannel {
-    id: string;
     room_id: string;
-    name: string;
-    type: "global" | "team" | "proximity" | "private" | "spectator";
-    team_id?: string;
-    max_members: number;
-    members: Record<string, VoiceMember>;
-    webrtc_room_id: string;
-    created_at: string;
+    player_id: string;
+    status: string;
 }
 interface VoiceMember {
     player_id: string;
@@ -5141,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>;
@@ -5170,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<{
@@ -5239,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()`) */
@@ -5456,6 +5484,10 @@ declare class NativeAPI {
          * 이미지 읽기 (데스크톱 전용, Data URL 반환)
          */
         readImage: () => Promise<string | null>;
+        /**
+         * 클립보드에 특정 형식(MIME 타입, 예: 'text/plain', 'image/png')의 데이터가 있는지 확인 (데스크톱 전용)
+         */
+        has: (format: string) => Promise<boolean>;
     };
     /**
      * 크로스 플랫폼 파일 시스템 API
@@ -5570,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
      */
@@ -5581,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
@@ -5588,6 +5674,7 @@ declare class NativeAPI {
     system: {
         getInfo: () => Promise<SystemInfo | null>;
         getMemory: () => Promise<MemoryInfo | null>;
+        getCPU: () => Promise<CPUInfo | null>;
     };
     /**
      * 모바일 전용 생체인증 API

package/dist/index.d.ts

@@ -4146,16 +4146,19 @@ interface MatchResult {
     rating_change: number;
     played_at: string;
 }
+/**
+ * `joinVoiceChannel()` 응답 — game-server 의 PTT(Push-To-Talk) 방 참가 확인.
+ *
+ * 실시간 오디오는 이 응답이 아니라 별도 WebSocket
+ * (`GET /v1/game/:appID/voice/ws?player_id=&room_id=`)으로 전송된다. `cb.webrtc.connect()`
+ * (webrtc-server 의 SDP/ICE 시그널링)와는 무관한 별개 경로다 — 과거 문서/타입이 `id`/`name`/
+ * `type`/`members`/`webrtc_room_id` 등을 포함하는 것처럼 기술했으나, 실제 서버 응답에는
+ * 존재하지 않아 항상 `undefined`였다(platform-issue 019fe5bb).
+ */
 interface VoiceChannel {
-    id: string;
     room_id: string;
-    name: string;
-    type: "global" | "team" | "proximity" | "private" | "spectator";
-    team_id?: string;
-    max_members: number;
-    members: Record<string, VoiceMember>;
-    webrtc_room_id: string;
-    created_at: string;
+    player_id: string;
+    status: string;
 }
 interface VoiceMember {
     player_id: string;
@@ -5141,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>;
@@ -5170,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<{
@@ -5239,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()`) */
@@ -5456,6 +5484,10 @@ declare class NativeAPI {
          * 이미지 읽기 (데스크톱 전용, Data URL 반환)
          */
         readImage: () => Promise<string | null>;
+        /**
+         * 클립보드에 특정 형식(MIME 타입, 예: 'text/plain', 'image/png')의 데이터가 있는지 확인 (데스크톱 전용)
+         */
+        has: (format: string) => Promise<boolean>;
     };
     /**
      * 크로스 플랫폼 파일 시스템 API
@@ -5570,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
      */
@@ -5581,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
@@ -5588,6 +5674,7 @@ declare class NativeAPI {
     system: {
         getInfo: () => Promise<SystemInfo | null>;
         getMemory: () => Promise<MemoryInfo | null>;
+        getCPU: () => Promise<CPUInfo | null>;
     };
     /**
      * 모바일 전용 생체인증 API