connectbase-client 5.12.6 → 6.0.0

package/dist/index.mjs

@@ -5306,6 +5306,15 @@ var NativeAPI = class {
           return window.NativeBridge.clipboard.readImage();
         }
         return null;
+      },
+      /**
+       * 클립보드에 특정 형식(MIME 타입, 예: 'text/plain', 'image/png')의 데이터가 있는지 확인 (데스크톱 전용)
+       */
+      has: async (format) => {
+        if (window.NativeBridge?.clipboard?.has) {
+          return window.NativeBridge.clipboard.has(format);
+        }
+        return false;
       }
     };
     /**
@@ -5344,25 +5353,33 @@ var NativeAPI = class {
       saveFile: async (content, filename, options) => {
         const platform = this.getPlatform();
         if (platform === "desktop" && window.NativeBridge?.filesystem) {
-          const result = await window.NativeBridge.filesystem.showSaveDialog?.({
-            defaultPath: filename,
-            filters: options?.filters
-          });
-          if (result?.canceled || !result?.filePath) return false;
-          const textContent = content instanceof Blob ? await content.text() : content;
-          const writeResult = await window.NativeBridge.filesystem.writeFile(
-            result.filePath,
-            textContent
-          );
-          return writeResult.success;
+          try {
+            const result = await window.NativeBridge.filesystem.showSaveDialog?.({
+              defaultPath: filename,
+              filters: options?.filters
+            });
+            if (result?.canceled || !result?.filePath) return false;
+            const textContent = content instanceof Blob ? await content.text() : content;
+            const writeResult = await window.NativeBridge.filesystem.writeFile(
+              result.filePath,
+              textContent
+            );
+            return writeResult.success;
+          } catch {
+            return false;
+          }
         }
         if (platform === "mobile" && window.NativeBridge?.filesystem) {
-          const textContent = content instanceof Blob ? await content.text() : content;
-          const result = await window.NativeBridge.filesystem.writeFile(
-            filename,
-            textContent
-          );
-          return result.success;
+          try {
+            const textContent = content instanceof Blob ? await content.text() : content;
+            const result = await window.NativeBridge.filesystem.writeFile(
+              filename,
+              textContent
+            );
+            return result.success;
+          } catch {
+            return false;
+          }
         }
         const blob = content instanceof Blob ? content : new Blob([content], { type: "text/plain" });
         const url = URL.createObjectURL(blob);
@@ -5378,8 +5395,12 @@ var NativeAPI = class {
        */
       readFile: async (path) => {
         if (window.NativeBridge?.filesystem?.readFile) {
-          const result = await window.NativeBridge.filesystem.readFile(path);
-          return result.success ? result.content ?? null : null;
+          try {
+            const result = await window.NativeBridge.filesystem.readFile(path);
+            return result.success ? result.content ?? null : null;
+          } catch {
+            return null;
+          }
         }
         return null;
       },
@@ -5403,7 +5424,11 @@ var NativeAPI = class {
       takePicture: async (options) => {
         const platform = this.getPlatform();
         if (platform === "mobile" && window.NativeBridge?.camera) {
-          return window.NativeBridge.camera.takePicture(options);
+          try {
+            return await window.NativeBridge.camera.takePicture(options);
+          } catch {
+            return null;
+          }
         }
         return new Promise((resolve) => {
           const input = document.createElement("input");
@@ -5440,7 +5465,11 @@ var NativeAPI = class {
       pickImage: async (options) => {
         const platform = this.getPlatform();
         if (platform === "mobile" && window.NativeBridge?.camera) {
-          return window.NativeBridge.camera.pickImage(options);
+          try {
+            return await window.NativeBridge.camera.pickImage(options);
+          } catch {
+            return null;
+          }
         }
         return new Promise((resolve) => {
           const input = document.createElement("input");
@@ -5583,7 +5612,11 @@ var NativeAPI = class {
        */
       getToken: async () => {
         if (this.getPlatform() === "mobile" && window.NativeBridge?.push) {
-          return window.NativeBridge.push.getToken();
+          try {
+            return await window.NativeBridge.push.getToken();
+          } catch {
+            return null;
+          }
         }
         return null;
       },
@@ -5594,8 +5627,12 @@ var NativeAPI = class {
       /** 로컬 알림 예약 (패키징 앱 전용) */
       scheduleLocal: async (options) => {
         if (this.getPlatform() === "mobile" && window.NativeBridge?.push) {
-          const result = await window.NativeBridge.push.scheduleLocal(options);
-          return result.notificationId;
+          try {
+            const result = await window.NativeBridge.push.scheduleLocal(options);
+            return result.notificationId;
+          } catch {
+            return null;
+          }
         }
         return null;
       },
@@ -5603,8 +5640,12 @@ var NativeAPI = class {
       setBadgeCount: async (count) => {
         const setter = window.NativeBridge?.push?.setBadgeCount;
         if (!setter) return false;
-        const result = await setter(count);
-        return result.success;
+        try {
+          const result = await setter(count);
+          return result.success;
+        } catch {
+          return false;
+        }
       }
     };
     /**
@@ -5623,12 +5664,12 @@ var NativeAPI = class {
         if (platform === "mobile" && window.NativeBridge?.push?.scheduleLocal) {
           const granted = await this.notification.requestPermission();
           if (!granted) return false;
-          await window.NativeBridge.push.scheduleLocal({
+          const notificationId = await this.push.scheduleLocal({
             title: options.title,
             body: options.body,
             trigger: null
           });
-          return true;
+          return notificationId !== null;
         }
         if (!("Notification" in window)) return false;
         if (Notification.permission !== "granted") {
@@ -5648,8 +5689,12 @@ var NativeAPI = class {
       requestPermission: async () => {
         const platform = this.getPlatform();
         if (platform === "mobile" && window.NativeBridge?.push) {
-          const result = await window.NativeBridge.push.requestPermission();
-          return result.granted;
+          try {
+            const result = await window.NativeBridge.push.requestPermission();
+            return result.granted;
+          } catch {
+            return false;
+          }
         }
         if (!("Notification" in window)) return false;
         const permission = await Notification.requestPermission();
@@ -5670,13 +5715,77 @@ var NativeAPI = class {
           return result.success;
         }
         if (platform === "mobile" && window.NativeBridge?.browser) {
-          const result = await window.NativeBridge.browser.openExternal(url);
-          return result.success;
+          try {
+            const result = await window.NativeBridge.browser.openExternal(url);
+            return result.success;
+          } catch {
+            return false;
+          }
         }
         window.open(url, "_blank");
         return true;
       }
     };
+    /**
+     * 모바일 전용: 네이티브 인앱 브라우저 세션으로 여는 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 로 계속 진행
+     * }
+     * ```
+     */
+    this.oauth = {
+      /**
+       * OAuth 인가 URL 을 네이티브 인앱 브라우저 세션으로 열고 콜백 URL 을 기다린다.
+       * callbackScheme 을 생략하면 이 패키징 앱의 스킴(getCallbackScheme())을 사용한다.
+       * 사용자가 취소했거나 미지원 플랫폼이면 null.
+       */
+      signIn: async (authUrl, callbackScheme) => {
+        const bridge = window.NativeBridge;
+        if (this.getPlatform() !== "mobile" || !bridge?.oauth) return null;
+        const scheme = callbackScheme ?? bridge.oauth.getCallbackScheme();
+        try {
+          return await bridge.oauth.signIn(authUrl, scheme);
+        } catch {
+          return null;
+        }
+      },
+      /** 이 패키징 앱의 OAuth 콜백 URL 스킴(`<scheme>://oauth/callback`). 미지원 플랫폼은 null (동기) */
+      getCallbackScheme: () => {
+        if (this.getPlatform() !== "mobile" || !window.NativeBridge?.oauth) {
+          return null;
+        }
+        return window.NativeBridge.oauth.getCallbackScheme();
+      }
+    };
+    /**
+     * 모바일 전용: 패키징 앱에 연결된 Connect Base Storage 로 파일 업로드.
+     * 콘솔 패키징 설정에서 "파일 저장 위치" 를 Connect Base Storage 로 선택한 경우에만 지원한다.
+     */
+    this.connectbase = {
+      uploadFile: async (uri, filename, mimeType) => {
+        if (this.getPlatform() !== "mobile" || !window.NativeBridge?.connectbase) {
+          return null;
+        }
+        try {
+          return await window.NativeBridge.connectbase.uploadFile(
+            uri,
+            filename,
+            mimeType
+          );
+        } catch {
+          return null;
+        }
+      }
+    };
     /**
      * 데스크톱 전용 창 제어 API
      */
@@ -5713,6 +5822,36 @@ var NativeAPI = class {
             await document.exitFullscreen();
           }
         }
+      },
+      isFullScreen: async () => {
+        if (window.NativeBridge?.window) {
+          return await window.NativeBridge.window.isFullScreen() ?? false;
+        }
+        return !!document.fullscreenElement;
+      },
+      /** 창 크기 설정 (데스크톱 전용) */
+      setSize: async (width, height) => {
+        await window.NativeBridge?.window?.setSize(width, height);
+      },
+      /** 창 크기 조회 (데스크톱 전용, 미지원 플랫폼은 null) */
+      getSize: async () => {
+        return await window.NativeBridge?.window?.getSize() ?? null;
+      },
+      /** 창 위치 설정 (데스크톱 전용) */
+      setPosition: async (x, y) => {
+        await window.NativeBridge?.window?.setPosition(x, y);
+      },
+      /** 창 위치 조회 (데스크톱 전용, 미지원 플랫폼은 null) */
+      getPosition: async () => {
+        return await window.NativeBridge?.window?.getPosition() ?? null;
+      },
+      /** 화면 중앙으로 이동 (데스크톱 전용) */
+      center: async () => {
+        await window.NativeBridge?.window?.center();
+      },
+      /** 항상 위에 표시 설정 (데스크톱 전용) */
+      setAlwaysOnTop: async (flag) => {
+        await window.NativeBridge?.window?.setAlwaysOnTop(flag);
       }
     };
     /**
@@ -5730,6 +5869,12 @@ var NativeAPI = class {
           return window.NativeBridge.system.getMemory();
         }
         return null;
+      },
+      getCPU: async () => {
+        if (window.NativeBridge?.system) {
+          return window.NativeBridge.system.getCPU();
+        }
+        return null;
       }
     };
     /**
@@ -5738,13 +5883,21 @@ var NativeAPI = class {
     this.biometric = {
       isAvailable: async () => {
         if (window.NativeBridge?.biometric) {
-          return window.NativeBridge.biometric.isAvailable();
+          try {
+            return await window.NativeBridge.biometric.isAvailable();
+          } catch {
+            return null;
+          }
         }
         return null;
       },
       authenticate: async (options) => {
         if (window.NativeBridge?.biometric) {
-          return window.NativeBridge.biometric.authenticate(options);
+          try {
+            return await window.NativeBridge.biometric.authenticate(options);
+          } catch {
+            return null;
+          }
         }
         return null;
       }
@@ -5755,26 +5908,38 @@ var NativeAPI = class {
     this.secureStore = {
       setItem: async (key, value) => {
         if (window.NativeBridge?.secureStore) {
-          const result = await window.NativeBridge.secureStore.setItem(
-            key,
-            value
-          );
-          return result.success;
+          try {
+            const result = await window.NativeBridge.secureStore.setItem(
+              key,
+              value
+            );
+            return result.success;
+          } catch {
+            return false;
+          }
         }
         localStorage.setItem(key, value);
         return true;
       },
       getItem: async (key) => {
         if (window.NativeBridge?.secureStore) {
-          const result = await window.NativeBridge.secureStore.getItem(key);
-          return result.value;
+          try {
+            const result = await window.NativeBridge.secureStore.getItem(key);
+            return result.value;
+          } catch {
+            return null;
+          }
         }
         return localStorage.getItem(key);
       },
       deleteItem: async (key) => {
         if (window.NativeBridge?.secureStore) {
-          const result = await window.NativeBridge.secureStore.deleteItem(key);
-          return result.success;
+          try {
+            const result = await window.NativeBridge.secureStore.deleteItem(key);
+            return result.success;
+          } catch {
+            return false;
+          }
         }
         localStorage.removeItem(key);
         return true;
@@ -5786,15 +5951,23 @@ var NativeAPI = class {
     this.admob = {
       showInterstitial: async () => {
         if (window.NativeBridge?.admob) {
-          const result = await window.NativeBridge.admob.showInterstitial();
-          return result.shown;
+          try {
+            const result = await window.NativeBridge.admob.showInterstitial();
+            return result.shown;
+          } catch {
+            return false;
+          }
         }
         return false;
       },
       showRewarded: async () => {
         if (window.NativeBridge?.admob) {
-          const result = await window.NativeBridge.admob.showRewarded();
-          return result.rewarded;
+          try {
+            const result = await window.NativeBridge.admob.showRewarded();
+            return result.rewarded;
+          } catch {
+            return false;
+          }
         }
         return false;
       }
@@ -7714,9 +7887,35 @@ var RealtimeAPI = class {
     return this.state;
   }
   /**
-   * 연결 여부 확인
+   * pub/sub 사용 가능 여부.
+   *
+   * WebSocket 으로 연결됐을 때만 true 다. SSE fallback 모드에서는 `subscribe` /
+   * `sendMessage` / `setPresence` / typing 이 전부 예외를 던지므로, 여기서 true 를
+   * 반환하면 앱이 "연결됨"으로 오판하고 아무것도 오가지 않는 채 조용히 멈춘다
+   * (platform-issue 01a01e6a-3cb1).
+   *
+   * AI 스트리밍만 필요하다면 {@link isStreamReady} 를, 다운그레이드 여부를 알고 싶다면
+   * {@link isDegraded} 를 쓴다.
    */
   isConnected() {
+    return this.state === "connected" && this.activeTransport === "ws";
+  }
+  /**
+   * SSE fallback 으로 다운그레이드된 상태인지 여부.
+   *
+   * true 면 연결은 살아 있지만 단방향이라 `realtime.stream()` 만 동작한다. 사용자에게
+   * "제한된 네트워크라 일부 기능을 쓸 수 없다" 고 안내할 지점이다.
+   */
+  isDegraded() {
+    return this.sseFallbackActive;
+  }
+  /**
+   * AI 스트리밍(`realtime.stream()`) 사용 가능 여부.
+   *
+   * WS 든 SSE fallback 이든 연결만 서 있으면 true 다. 종전 `isConnected()` 와 같은
+   * 판정이므로, 스트리밍 게이팅에 `isConnected()` 를 쓰던 코드는 이쪽으로 옮긴다.
+   */
+  isStreamReady() {
     return this.state === "connected";
   }
   /**
@@ -10847,7 +11046,7 @@ var VideoAPI = class {
 };
 
 // src/api/webrtc.ts
-var WebRTCAPI = class {
+var WebRTCAPI = class _WebRTCAPI {
   constructor(http, webrtcUrl, appId) {
     this.ws = null;
     this.state = "disconnected";
@@ -10859,6 +11058,16 @@ var WebRTCAPI = class {
     this.reconnectAttempts = 0;
     this.maxReconnectAttempts = 5;
     this.reconnectTimeout = null;
+    /**
+     * 시그널링 소켓의 세대(generation) 토큰.
+     *
+     * 소켓을 열 때마다 1 증가하며, 각 핸들러는 자기가 열릴 때의 세대를 클로저에 담아둔다.
+     * 세대가 밀린 핸들러는 "옛 소켓의 지연 이벤트" 이므로 인스턴스 상태를 건드리지 않는다.
+     * 참조(`this.ws`)만 끊는 것으로는 부족하다 — 핸들러 클로저가 인스턴스를 캡처하고 있어
+     * close 이벤트가 뒤늦게 도착하면 새 연결을 'disconnected' 로 덮어쓰고 새로 만든 피어
+     * 연결까지 정리해버린다.
+     */
+    this.wsGeneration = 0;
     // 현재 연결 정보
     this.currentRoomId = null;
     this.currentPeerId = null;
@@ -10931,15 +11140,23 @@ var WebRTCAPI = class {
   connectWebSocket() {
     return new Promise((resolve, reject) => {
       const wsUrl = this.buildWebSocketUrl();
-      this.ws = new WebSocket(wsUrl);
+      const generation = ++this.wsGeneration;
+      const ws = new WebSocket(wsUrl);
+      this.ws = ws;
+      const isStale = () => this.wsGeneration !== generation;
       const timeout = setTimeout(() => {
+        if (isStale()) return;
         if (this.state === "connecting") {
-          this.ws?.close();
+          ws.close();
           reject(new Error("\uC5F0\uACB0 \uC2DC\uAC04 \uCD08\uACFC"));
         }
       }, 1e4);
-      this.ws.onopen = () => {
+      ws.onopen = () => {
         clearTimeout(timeout);
+        if (isStale()) {
+          ws.close(1e3, "superseded");
+          return;
+        }
         this.reconnectAttempts = 0;
         this.sendSignaling({
           type: "join",
@@ -10950,7 +11167,8 @@ var WebRTCAPI = class {
           }
         });
       };
-      this.ws.onmessage = async (event) => {
+      ws.onmessage = async (event) => {
+        if (isStale()) return;
         try {
           const msg = JSON.parse(event.data);
           await this.handleSignalingMessage(msg, resolve, reject);
@@ -10958,13 +11176,15 @@ var WebRTCAPI = class {
           console.error("Failed to parse signaling message:", error);
         }
       };
-      this.ws.onerror = (event) => {
+      ws.onerror = (event) => {
         clearTimeout(timeout);
+        if (isStale()) return;
         console.error("WebSocket error:", event);
         this.emitError(new Error("WebSocket \uC5F0\uACB0 \uC624\uB958"));
       };
-      this.ws.onclose = (event) => {
+      ws.onclose = (event) => {
         clearTimeout(timeout);
+        if (isStale()) return;
         if (this.state === "connecting") {
           reject(new Error("\uC5F0\uACB0\uC774 \uC885\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4"));
         }
@@ -10972,6 +11192,19 @@ var WebRTCAPI = class {
       };
     });
   }
+  /**
+   * 소켓에 붙은 핸들러를 전부 떼어낸다.
+   *
+   * `this.ws = null` 로 참조만 끊으면 클로저가 살아남아 close 이벤트가 계속 들어온다.
+   * 세대 토큰이 그 이벤트를 무시해주긴 하지만, 핸들러 자체를 떼면 인스턴스 참조가 끊겨
+   * 소켓이 GC 될 때까지 인스턴스를 붙잡고 있지 않는다.
+   */
+  static detachSocket(ws) {
+    ws.onopen = null;
+    ws.onmessage = null;
+    ws.onerror = null;
+    ws.onclose = null;
+  }
   buildWebSocketUrl() {
     const wsBase = this.webrtcUrl.replace("https://", "wss://").replace("http://", "ws://");
     const publicKey = this.http.getPublicKey();
@@ -11182,19 +11415,76 @@ var WebRTCAPI = class {
       clearTimeout(this.reconnectTimeout);
       this.reconnectTimeout = null;
     }
-    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
-      this.sendSignaling({ type: "leave" });
-      this.ws.close(1e3, "User disconnected");
+    this.reconnectAttempts = 0;
+    this.wsGeneration++;
+    const ws = this.ws;
+    this.ws = null;
+    if (ws) {
+      _WebRTCAPI.detachSocket(ws);
+      if (ws.readyState === WebSocket.OPEN) {
+        try {
+          ws.send(JSON.stringify({ type: "leave" }));
+        } catch {
+        }
+        ws.close(1e3, "User disconnected");
+      } else if (ws.readyState === WebSocket.CONNECTING) {
+        ws.close();
+      }
     }
     this.peerConnections.forEach((pc) => pc.close());
     this.peerConnections.clear();
     this.remoteStreams.clear();
-    this.ws = null;
     this.currentRoomId = null;
     this.currentPeerId = null;
     this.localStream = null;
     this.setState("disconnected");
   }
+  /**
+   * 현재 세션의 룸을 교체한다.
+   *
+   * `disconnect()` 후 곧바로 `connect()` 하는 패턴을 안전하게 감싼 것이다. 옛 소켓의
+   * close 이벤트가 새 연결의 'connecting' 구간에 떨어져도 세대 토큰이 걸러낸다.
+   * 생략한 옵션은 현재 세션 값을 그대로 이어받는다.
+   *
+   * @example
+   * ```typescript
+   * await cb.webrtc.switchRoom('channel:room-b')
+   * ```
+   */
+  async switchRoom(roomId, options = {}) {
+    const localStream = options.localStream ?? this.localStream ?? void 0;
+    const userId = options.userId ?? this.currentUserId ?? void 0;
+    const isBroadcaster = options.isBroadcaster ?? this.isBroadcaster;
+    this.disconnect();
+    await this.connect({ roomId, userId, isBroadcaster, localStream });
+  }
+  /**
+   * 소켓, 룸, 이벤트 리스너, 피어 연결을 **독립적으로** 갖는 새 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() {
+    return new _WebRTCAPI(this.http, this.webrtcUrl, this.appId);
+  }
   /**
    * 현재 연결 상태 조회
    */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "connectbase-client",
-	"version": "5.12.6",
+	"version": "6.0.0",
 	"description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
 	"repository": {
 		"type": "git",