connectbase-client 6.14.0 → 6.16.0

package/dist/index.js

@@ -291,7 +291,7 @@ var RealtimeConnectionError = class extends Error {
     this.name = "RealtimeConnectionError";
     this.code = init.code || "unknown";
     this.closeCode = init.closeCode;
-    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code);
+    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code, init.closeCode);
     this.details = init.details;
     this.retryAfterMs = init.retryAfterMs;
   }
@@ -308,8 +308,8 @@ var RealtimeConnectionError = class extends Error {
     };
   }
 };
-function isRetryableRealtimeRejection(code) {
-  return code === "connection_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
+function isRetryableRealtimeRejection(code, closeCode) {
+  return closeCode === 4429 || closeCode === 4500 || closeCode === 4503 || code === "connection_limit_exceeded" || code === "rate_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
 }
 var RealtimeRequestError = class extends Error {
   constructor(init) {
@@ -3807,6 +3807,20 @@ var REALTIME_CLOSING_NOTICE_CODES = /* @__PURE__ */ new Set([
 ]);
 var CLOSE_CODE_TOKEN_EXPIRED = 4401;
 var CLOSE_CODE_MEMBER_REVOKED = 4403;
+function toRealtimeRejection(msg) {
+  if (msg.type !== "error" || msg.request_id || typeof msg.close_code !== "number") {
+    return null;
+  }
+  const details = msg.details;
+  return new RealtimeConnectionError({
+    code: typeof msg.code === "string" ? msg.code : void 0,
+    message: typeof msg.message === "string" ? msg.message : void 0,
+    closeCode: msg.close_code,
+    retryable: typeof msg.retryable === "boolean" ? msg.retryable : void 0,
+    details: details && typeof details === "object" && !Array.isArray(details) ? details : void 0,
+    retryAfterMs: typeof msg.retry_after_ms === "number" && msg.retry_after_ms > 0 ? msg.retry_after_ms : void 0
+  });
+}
 var DatabaseAPI = class {
   constructor(http) {
     this.realtimeWs = null;
@@ -4749,18 +4763,13 @@ var DatabaseAPI = class {
       ticket = await this.realtimeTicket();
     } catch (e) {
       if (e instanceof WsTicketError) {
-        if (e.status === 429 && this.realtimeOptions) {
-          this.attemptRealtimeReconnect();
-        } else {
-          this.setRealtimeState("disconnected");
-        }
         const err = new RealtimeConnectionError({
           code: e.code,
           message: e.message,
           closeCode: 4e3 + e.status,
           retryAfterMs: e.retryAfterMs
         });
-        this.realtimeOnError?.(err);
+        this.handleRealtimeRejection(err);
         throw err;
       }
       throw e;
@@ -4794,10 +4803,14 @@ var DatabaseAPI = class {
       this.realtimeOptions.accessToken
     );
     if (this.realtimeTokenRefresh) url += "&token_refresh=1";
+    url += "&reject_mode=close";
     return new Promise((resolve, reject) => {
       try {
-        this.realtimeWs = new WebSocket(url);
+        const ws = new WebSocket(url);
+        this.realtimeWs = ws;
         let settled = false;
+        let accepted = false;
+        let rejection = null;
         const connectTimeout = setTimeout(() => {
           if (!settled) {
             settled = true;
@@ -4809,7 +4822,8 @@ var DatabaseAPI = class {
             reject(new Error("Connection timeout"));
           }
         }, REALTIME_CONNECT_TIMEOUT_MS);
-        this.realtimeWs.onopen = () => {
+        const accept = () => {
+          accepted = true;
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
@@ -4822,15 +4836,28 @@ var DatabaseAPI = class {
           this.resubscribeAll();
           resolve();
         };
-        this.realtimeWs.onmessage = (event) => {
+        ws.onopen = () => {
+          ws.send(JSON.stringify({ type: "ping", timestamp: Date.now() }));
+        };
+        ws.onmessage = (event) => {
+          let msg;
           try {
-            const msg = JSON.parse(event.data);
-            this.handleRealtimeMessage(msg);
+            msg = JSON.parse(event.data);
           } catch {
             this.debugLog("Failed to parse realtime message");
+            return;
+          }
+          if (!accepted) {
+            const rejected = toRealtimeRejection(msg);
+            if (rejected) {
+              rejection = rejected;
+              return;
+            }
+            accept();
           }
+          this.handleRealtimeMessage(msg);
         };
-        this.realtimeWs.onclose = (event) => {
+        ws.onclose = (event) => {
           this.debugLog(
             `Database realtime disconnected (code=${event?.code}, reason=${event?.reason})`
           );
@@ -4839,12 +4866,25 @@ var DatabaseAPI = class {
           this.clearRealtimeAuthRetry();
           const notice = this.realtimeCloseNotice;
           this.realtimeCloseNotice = null;
+          const code = event?.code;
+          if (!accepted && code >= 4e3 && code <= 4999) {
+            const err = rejection ?? new RealtimeConnectionError({
+              code: event.reason || void 0,
+              closeCode: code
+            });
+            if (!settled) {
+              settled = true;
+              clearTimeout(connectTimeout);
+              reject(err);
+            }
+            this.handleRealtimeRejection(err);
+            return;
+          }
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
             reject(new Error("Connection closed during handshake"));
           }
-          const code = event?.code;
           if (this.realtimeOptions && this.realtimeState !== "disconnected" && (code === CLOSE_CODE_MEMBER_REVOKED || code === CLOSE_CODE_TOKEN_EXPIRED && !this.http.canRefreshMemberToken(
             this.realtimeOptions.accessToken
           ))) {
@@ -4862,7 +4902,7 @@ var DatabaseAPI = class {
             this.attemptRealtimeReconnect();
           }
         };
-        this.realtimeWs.onerror = () => {
+        ws.onerror = () => {
           this.debugLog("Database realtime error");
           this.realtimeOnError?.(new Error("WebSocket connection error"));
         };
@@ -4872,6 +4912,21 @@ var DatabaseAPI = class {
       }
     });
   }
+  /**
+   * 서버가 연결을 거부했다(티켓 발급 거부, 또는 reject_mode=close 로 받은 업그레이드 거부). cb.realtime 과 같은 규칙이다 —
+   * 다시 해서 될 거부(`retryable`: 일시 장애, 속도 제한, 동시접속 한도, 만료된 티켓)는 서버가 알려 준 시각(`retryAfterMs`)
+   * 이후로 재연결을 이어 가고, 아니면(자격증명, 멤버 폐기, 할당량) 멈추고 `onRealtimeError` 로 알린다. 재시도를 다 써도
+   * 거부되면 마지막 거부를 알린다.
+   */
+  handleRealtimeRejection(err) {
+    if (!this.realtimeOptions || this.realtimeState === "disconnected") return;
+    if (err.retryable) {
+      this.attemptRealtimeReconnect(err);
+      return;
+    }
+    this.setRealtimeState("disconnected");
+    this.realtimeOnError?.(err);
+  }
   /**
    * 서버에 subscribe 메시지를 보내고 서버 subscription_id를 반환하는 Promise
    */
@@ -5044,21 +5099,25 @@ var DatabaseAPI = class {
         break;
     }
   }
-  attemptRealtimeReconnect() {
+  /**
+   * 지수 백오프로 다시 붙는다. cause 는 이번 시도를 끝낸 서버의 거부다 — 알려 준 재시도 시각(`retryAfterMs`)보다 일찍 다시
+   * 하지 않고, 재시도를 다 쓰면 일반 오류 대신 그 거부를 알린다.
+   */
+  attemptRealtimeReconnect(cause) {
     const maxRetries = this.realtimeOptions?.maxRetries ?? 5;
     const retryInterval = this.realtimeOptions?.retryInterval ?? 1e3;
     if (this.realtimeRetryCount >= maxRetries) {
       this.setRealtimeState("disconnected");
       this.realtimeOnError?.(
-        new Error("Realtime connection lost. Max retries exceeded.")
+        cause ?? new Error("Realtime connection lost. Max retries exceeded.")
       );
       return;
     }
     this.setRealtimeState("connecting");
     this.realtimeRetryCount++;
-    const delay = Math.min(
-      retryInterval * 2 ** (this.realtimeRetryCount - 1),
-      3e4
+    const delay = Math.max(
+      Math.min(retryInterval * 2 ** (this.realtimeRetryCount - 1), 3e4),
+      cause?.retryAfterMs ?? 0
     );
     this.debugLog(
       `Reconnecting in ${delay}ms (attempt ${this.realtimeRetryCount}/${maxRetries})`
@@ -12563,6 +12622,29 @@ var StorageAPI = class {
   getFileUrl(file) {
     return file.url || null;
   }
+  /**
+   * 경로 주소 만들기 — 파일을 경로로 읽는 고정 주소 (요청을 보내지 않는다)
+   *
+   * 돌려주는 주소는 그 경로의 파일로 리다이렉트된다. 인증 헤더가 필요 없어 `<img src>`, `fetch()`,
+   * 기준 주소 + 상대 경로 로딩에 쓸 수 있다. 파일의 `url`(직접 주소)에는 경로가 들어 있지 않으므로,
+   * 한 폴더의 파일들을 상대 경로로 읽으려면 이 주소를 기준으로 쓴다.
+   *
+   * 대상은 주소만 알면 읽히는 스토리지(`server_write`, `public_read`, `shared`)다. `private` 스토리지는 404 이고
+   * 응답의 `url`(서명 주소)을 써야 한다.
+   *
+   * @example
+   * ```typescript
+   * const base = cb.storage.getPathUrl(storageId, `/l2d/rigs/${rigId}/`)
+   * const meta = await (await fetch(base + 'meta.json')).json()
+   * img.src = base + 'base.webp'
+   * ```
+   */
+  getPathUrl(storageId, path) {
+    const encoded = path.split("/").filter(
+      (segment, index, all) => segment !== "" || index === all.length - 1
+    ).map((segment) => encodeURIComponent(segment)).join("/");
+    return `${this.http.getBaseUrl()}/v1/file-path/${storageId}/${encoded}`;
+  }
   /**
    * 이미지 파일 여부 확인
    */
@@ -13550,8 +13632,8 @@ var SupportAPI = class {
   }
 };
 function detectSdkVersion() {
-  if ("6.14.0") {
-    return "6.14.0";
+  if ("6.16.0") {
+    return "6.16.0";
   }
   return "unknown";
 }
@@ -15138,6 +15220,43 @@ var WebRTCAPI = class _WebRTCAPI {
       baseUrl: this.webrtcUrl
     });
   }
+  /**
+   * SFU 방 입장 토큰 발급
+   *
+   * `connect()` 는 미디어가 브라우저끼리 직접(P2P) 오가서 상대에게 IP 가 보이고 참가자가 많은 방을 만들 수 없다.
+   * SFU 는 서버가 미디어를 받아 나눠 주는 방식이라 참가자끼리 IP 를 보지 못하고 수십 명 방이 가능하다.
+   * 이 메서드는 채널 정책(인증, 역할, 정원)을 서버에서 판정한 입장 토큰을 돌려주고, 미디어 연결은 앱이
+   * `livekit-client` 로 직접 한다(SDK 는 `livekit-client` 를 포함하지 않는다).
+   *
+   * @example
+   * ```typescript
+   * import { Room } from 'livekit-client'
+   *
+   * const sfu = await cb.webrtc.getSFUToken({ roomId: 'voice:fanmeeting-1', publish: true })
+   * const room = new Room()
+   * await room.connect(sfu.url, sfu.token)
+   * if (sfu.can_publish) {
+   *     await room.localParticipant.setMicrophoneEnabled(true)
+   * }
+   * ```
+   */
+  async getSFUToken(options) {
+    if (!this.appId) {
+      throw new Error(
+        "WebRTC getSFUToken \uC5D0\uB294 appId \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. ConnectBase \uCD08\uAE30\uD654 \uC2DC appId \uB97C \uC124\uC815\uD558\uC138\uC694."
+      );
+    }
+    return this.http.post(
+      `/v1/apps/${this.appId}/sfu/token`,
+      {
+        room_id: options.roomId,
+        publish: options.publish,
+        name: options.name,
+        device: options.device
+      },
+      { baseUrl: this.webrtcUrl }
+    );
+  }
   /**
    * 앱의 WebRTC 통계 조회
    */

package/dist/index.mjs

@@ -238,7 +238,7 @@ var RealtimeConnectionError = class extends Error {
     this.name = "RealtimeConnectionError";
     this.code = init.code || "unknown";
     this.closeCode = init.closeCode;
-    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code);
+    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code, init.closeCode);
     this.details = init.details;
     this.retryAfterMs = init.retryAfterMs;
   }
@@ -255,8 +255,8 @@ var RealtimeConnectionError = class extends Error {
     };
   }
 };
-function isRetryableRealtimeRejection(code) {
-  return code === "connection_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
+function isRetryableRealtimeRejection(code, closeCode) {
+  return closeCode === 4429 || closeCode === 4500 || closeCode === 4503 || code === "connection_limit_exceeded" || code === "rate_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
 }
 var RealtimeRequestError = class extends Error {
   constructor(init) {
@@ -3754,6 +3754,20 @@ var REALTIME_CLOSING_NOTICE_CODES = /* @__PURE__ */ new Set([
 ]);
 var CLOSE_CODE_TOKEN_EXPIRED = 4401;
 var CLOSE_CODE_MEMBER_REVOKED = 4403;
+function toRealtimeRejection(msg) {
+  if (msg.type !== "error" || msg.request_id || typeof msg.close_code !== "number") {
+    return null;
+  }
+  const details = msg.details;
+  return new RealtimeConnectionError({
+    code: typeof msg.code === "string" ? msg.code : void 0,
+    message: typeof msg.message === "string" ? msg.message : void 0,
+    closeCode: msg.close_code,
+    retryable: typeof msg.retryable === "boolean" ? msg.retryable : void 0,
+    details: details && typeof details === "object" && !Array.isArray(details) ? details : void 0,
+    retryAfterMs: typeof msg.retry_after_ms === "number" && msg.retry_after_ms > 0 ? msg.retry_after_ms : void 0
+  });
+}
 var DatabaseAPI = class {
   constructor(http) {
     this.realtimeWs = null;
@@ -4696,18 +4710,13 @@ var DatabaseAPI = class {
       ticket = await this.realtimeTicket();
     } catch (e) {
       if (e instanceof WsTicketError) {
-        if (e.status === 429 && this.realtimeOptions) {
-          this.attemptRealtimeReconnect();
-        } else {
-          this.setRealtimeState("disconnected");
-        }
         const err = new RealtimeConnectionError({
           code: e.code,
           message: e.message,
           closeCode: 4e3 + e.status,
           retryAfterMs: e.retryAfterMs
         });
-        this.realtimeOnError?.(err);
+        this.handleRealtimeRejection(err);
         throw err;
       }
       throw e;
@@ -4741,10 +4750,14 @@ var DatabaseAPI = class {
       this.realtimeOptions.accessToken
     );
     if (this.realtimeTokenRefresh) url += "&token_refresh=1";
+    url += "&reject_mode=close";
     return new Promise((resolve, reject) => {
       try {
-        this.realtimeWs = new WebSocket(url);
+        const ws = new WebSocket(url);
+        this.realtimeWs = ws;
         let settled = false;
+        let accepted = false;
+        let rejection = null;
         const connectTimeout = setTimeout(() => {
           if (!settled) {
             settled = true;
@@ -4756,7 +4769,8 @@ var DatabaseAPI = class {
             reject(new Error("Connection timeout"));
           }
         }, REALTIME_CONNECT_TIMEOUT_MS);
-        this.realtimeWs.onopen = () => {
+        const accept = () => {
+          accepted = true;
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
@@ -4769,15 +4783,28 @@ var DatabaseAPI = class {
           this.resubscribeAll();
           resolve();
         };
-        this.realtimeWs.onmessage = (event) => {
+        ws.onopen = () => {
+          ws.send(JSON.stringify({ type: "ping", timestamp: Date.now() }));
+        };
+        ws.onmessage = (event) => {
+          let msg;
           try {
-            const msg = JSON.parse(event.data);
-            this.handleRealtimeMessage(msg);
+            msg = JSON.parse(event.data);
           } catch {
             this.debugLog("Failed to parse realtime message");
+            return;
+          }
+          if (!accepted) {
+            const rejected = toRealtimeRejection(msg);
+            if (rejected) {
+              rejection = rejected;
+              return;
+            }
+            accept();
           }
+          this.handleRealtimeMessage(msg);
         };
-        this.realtimeWs.onclose = (event) => {
+        ws.onclose = (event) => {
           this.debugLog(
             `Database realtime disconnected (code=${event?.code}, reason=${event?.reason})`
           );
@@ -4786,12 +4813,25 @@ var DatabaseAPI = class {
           this.clearRealtimeAuthRetry();
           const notice = this.realtimeCloseNotice;
           this.realtimeCloseNotice = null;
+          const code = event?.code;
+          if (!accepted && code >= 4e3 && code <= 4999) {
+            const err = rejection ?? new RealtimeConnectionError({
+              code: event.reason || void 0,
+              closeCode: code
+            });
+            if (!settled) {
+              settled = true;
+              clearTimeout(connectTimeout);
+              reject(err);
+            }
+            this.handleRealtimeRejection(err);
+            return;
+          }
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
             reject(new Error("Connection closed during handshake"));
           }
-          const code = event?.code;
           if (this.realtimeOptions && this.realtimeState !== "disconnected" && (code === CLOSE_CODE_MEMBER_REVOKED || code === CLOSE_CODE_TOKEN_EXPIRED && !this.http.canRefreshMemberToken(
             this.realtimeOptions.accessToken
           ))) {
@@ -4809,7 +4849,7 @@ var DatabaseAPI = class {
             this.attemptRealtimeReconnect();
           }
         };
-        this.realtimeWs.onerror = () => {
+        ws.onerror = () => {
           this.debugLog("Database realtime error");
           this.realtimeOnError?.(new Error("WebSocket connection error"));
         };
@@ -4819,6 +4859,21 @@ var DatabaseAPI = class {
       }
     });
   }
+  /**
+   * 서버가 연결을 거부했다(티켓 발급 거부, 또는 reject_mode=close 로 받은 업그레이드 거부). cb.realtime 과 같은 규칙이다 —
+   * 다시 해서 될 거부(`retryable`: 일시 장애, 속도 제한, 동시접속 한도, 만료된 티켓)는 서버가 알려 준 시각(`retryAfterMs`)
+   * 이후로 재연결을 이어 가고, 아니면(자격증명, 멤버 폐기, 할당량) 멈추고 `onRealtimeError` 로 알린다. 재시도를 다 써도
+   * 거부되면 마지막 거부를 알린다.
+   */
+  handleRealtimeRejection(err) {
+    if (!this.realtimeOptions || this.realtimeState === "disconnected") return;
+    if (err.retryable) {
+      this.attemptRealtimeReconnect(err);
+      return;
+    }
+    this.setRealtimeState("disconnected");
+    this.realtimeOnError?.(err);
+  }
   /**
    * 서버에 subscribe 메시지를 보내고 서버 subscription_id를 반환하는 Promise
    */
@@ -4991,21 +5046,25 @@ var DatabaseAPI = class {
         break;
     }
   }
-  attemptRealtimeReconnect() {
+  /**
+   * 지수 백오프로 다시 붙는다. cause 는 이번 시도를 끝낸 서버의 거부다 — 알려 준 재시도 시각(`retryAfterMs`)보다 일찍 다시
+   * 하지 않고, 재시도를 다 쓰면 일반 오류 대신 그 거부를 알린다.
+   */
+  attemptRealtimeReconnect(cause) {
     const maxRetries = this.realtimeOptions?.maxRetries ?? 5;
     const retryInterval = this.realtimeOptions?.retryInterval ?? 1e3;
     if (this.realtimeRetryCount >= maxRetries) {
       this.setRealtimeState("disconnected");
       this.realtimeOnError?.(
-        new Error("Realtime connection lost. Max retries exceeded.")
+        cause ?? new Error("Realtime connection lost. Max retries exceeded.")
       );
       return;
     }
     this.setRealtimeState("connecting");
     this.realtimeRetryCount++;
-    const delay = Math.min(
-      retryInterval * 2 ** (this.realtimeRetryCount - 1),
-      3e4
+    const delay = Math.max(
+      Math.min(retryInterval * 2 ** (this.realtimeRetryCount - 1), 3e4),
+      cause?.retryAfterMs ?? 0
     );
     this.debugLog(
       `Reconnecting in ${delay}ms (attempt ${this.realtimeRetryCount}/${maxRetries})`
@@ -12510,6 +12569,29 @@ var StorageAPI = class {
   getFileUrl(file) {
     return file.url || null;
   }
+  /**
+   * 경로 주소 만들기 — 파일을 경로로 읽는 고정 주소 (요청을 보내지 않는다)
+   *
+   * 돌려주는 주소는 그 경로의 파일로 리다이렉트된다. 인증 헤더가 필요 없어 `<img src>`, `fetch()`,
+   * 기준 주소 + 상대 경로 로딩에 쓸 수 있다. 파일의 `url`(직접 주소)에는 경로가 들어 있지 않으므로,
+   * 한 폴더의 파일들을 상대 경로로 읽으려면 이 주소를 기준으로 쓴다.
+   *
+   * 대상은 주소만 알면 읽히는 스토리지(`server_write`, `public_read`, `shared`)다. `private` 스토리지는 404 이고
+   * 응답의 `url`(서명 주소)을 써야 한다.
+   *
+   * @example
+   * ```typescript
+   * const base = cb.storage.getPathUrl(storageId, `/l2d/rigs/${rigId}/`)
+   * const meta = await (await fetch(base + 'meta.json')).json()
+   * img.src = base + 'base.webp'
+   * ```
+   */
+  getPathUrl(storageId, path) {
+    const encoded = path.split("/").filter(
+      (segment, index, all) => segment !== "" || index === all.length - 1
+    ).map((segment) => encodeURIComponent(segment)).join("/");
+    return `${this.http.getBaseUrl()}/v1/file-path/${storageId}/${encoded}`;
+  }
   /**
    * 이미지 파일 여부 확인
    */
@@ -13497,8 +13579,8 @@ var SupportAPI = class {
   }
 };
 function detectSdkVersion() {
-  if ("6.14.0") {
-    return "6.14.0";
+  if ("6.16.0") {
+    return "6.16.0";
   }
   return "unknown";
 }
@@ -15085,6 +15167,43 @@ var WebRTCAPI = class _WebRTCAPI {
       baseUrl: this.webrtcUrl
     });
   }
+  /**
+   * SFU 방 입장 토큰 발급
+   *
+   * `connect()` 는 미디어가 브라우저끼리 직접(P2P) 오가서 상대에게 IP 가 보이고 참가자가 많은 방을 만들 수 없다.
+   * SFU 는 서버가 미디어를 받아 나눠 주는 방식이라 참가자끼리 IP 를 보지 못하고 수십 명 방이 가능하다.
+   * 이 메서드는 채널 정책(인증, 역할, 정원)을 서버에서 판정한 입장 토큰을 돌려주고, 미디어 연결은 앱이
+   * `livekit-client` 로 직접 한다(SDK 는 `livekit-client` 를 포함하지 않는다).
+   *
+   * @example
+   * ```typescript
+   * import { Room } from 'livekit-client'
+   *
+   * const sfu = await cb.webrtc.getSFUToken({ roomId: 'voice:fanmeeting-1', publish: true })
+   * const room = new Room()
+   * await room.connect(sfu.url, sfu.token)
+   * if (sfu.can_publish) {
+   *     await room.localParticipant.setMicrophoneEnabled(true)
+   * }
+   * ```
+   */
+  async getSFUToken(options) {
+    if (!this.appId) {
+      throw new Error(
+        "WebRTC getSFUToken \uC5D0\uB294 appId \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. ConnectBase \uCD08\uAE30\uD654 \uC2DC appId \uB97C \uC124\uC815\uD558\uC138\uC694."
+      );
+    }
+    return this.http.post(
+      `/v1/apps/${this.appId}/sfu/token`,
+      {
+        room_id: options.roomId,
+        publish: options.publish,
+        name: options.name,
+        device: options.device
+      },
+      { baseUrl: this.webrtcUrl }
+    );
+  }
   /**
    * 앱의 WebRTC 통계 조회
    */

package/package.json

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