connectbase-client 4.4.1 → 5.1.0

package/dist/index.mjs

@@ -116,6 +116,123 @@ var AdsAPI = class {
   }
 };
 
+// src/types/error.ts
+var ApiError = class extends Error {
+  constructor(statusCode, message, code, details) {
+    super(message);
+    this.statusCode = statusCode;
+    this.name = "ApiError";
+    this.code = code;
+    this.details = details;
+  }
+  /**
+   * `JSON.stringify(err)` 가 `{}` 로 찍히지 않게 한다.
+   *
+   * 표준 `Error` 는 message/stack 이 non-enumerable 이라 JSON 직렬화 시 빈 객체가
+   * 된다. 로그를 `JSON.stringify` 로 남기는 소비자에게는 "에러 정보가 아무것도 안
+   * 온다"로 보여, 실제로는 있는 정보까지 없는 것으로 오진하게 만든다
+   * (platform-issue 019fa21c).
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      code: this.code,
+      statusCode: this.statusCode,
+      details: this.details
+    };
+  }
+};
+var AIError = class extends Error {
+  constructor(init) {
+    super(init.message || init.code || "AI request failed");
+    this.name = "AIError";
+    this.code = init.code || "stream_failed";
+    this.retryable = init.retryable ?? isRetryableAICode(this.code);
+    this.status = init.status;
+    this.provider = init.provider;
+    this.model = init.model;
+    this.retryAfter = init.retryAfter;
+    this.detailCode = init.detailCode;
+    this.sessionId = init.sessionId;
+  }
+  /** `JSON.stringify(err)` 가 `{}` 가 되지 않도록 한다 (ApiError.toJSON 참조). */
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      retryable: this.retryable,
+      status: this.status,
+      provider: this.provider,
+      model: this.model,
+      retryAfter: this.retryAfter,
+      detailCode: this.detailCode,
+      sessionId: this.sessionId
+    };
+  }
+};
+function isRetryableAICode(code) {
+  return code === "provider_timeout" || code === "service_unavailable" || code === "rate_limit_exceeded" || code === "stream_failed";
+}
+function toAIError(payload, fallback) {
+  if (payload instanceof AIError) return payload;
+  const p = typeof payload === "object" && payload !== null ? payload : {};
+  const str = (v) => typeof v === "string" && v !== "" ? v : void 0;
+  const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
+  const documented = str(p.error) ?? str(p.code) ?? fallback?.code;
+  const sub = str(p.detail_code) ?? str(p.detailCode) ?? str(p.code);
+  const code = documented ?? "stream_failed";
+  const detailCode = sub && sub !== code ? sub : void 0;
+  const message = str(p.message) ?? (payload instanceof Error ? payload.message : void 0) ?? fallback?.message ?? code;
+  return new AIError({
+    code,
+    message,
+    retryable: typeof p.retryable === "boolean" ? p.retryable : void 0,
+    status: num(p.status) ?? num(p.statusCode) ?? fallback?.status,
+    provider: str(p.provider),
+    model: str(p.model),
+    retryAfter: num(p.retry_after_seconds) ?? num(p.retryAfter),
+    detailCode,
+    sessionId: str(p.session_id) ?? str(p.sessionId) ?? fallback?.sessionId
+  });
+}
+var AuthError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "AuthError";
+  }
+};
+var GameError = class extends Error {
+  constructor(init) {
+    super(init.message || init.code || "GameError");
+    this.name = "GameError";
+    this.code = init.code || "UNKNOWN";
+    this.phase = init.phase;
+    this.feature = init.feature;
+    this.roomId = init.roomId;
+    this.scriptId = init.scriptId;
+    this.originClientId = init.originClientId;
+    this.requested = init.requested;
+    this.available = init.available;
+  }
+  /** `JSON.stringify(err)` 가 `{}` 가 되지 않도록 한다 (ApiError.toJSON 참조). */
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      phase: this.phase,
+      feature: this.feature,
+      roomId: this.roomId,
+      scriptId: this.scriptId,
+      originClientId: this.originClientId,
+      requested: this.requested,
+      available: this.available
+    };
+  }
+};
+
 // src/api/ai.ts
 var AIAPI = class {
   constructor(http) {
@@ -180,13 +297,24 @@ var AIAPI = class {
         signal
       });
       if (!response.ok) {
-        const errorData = await response.json().catch(() => ({ error: "Stream request failed" }));
-        callbacks.onError?.(errorData.error || "Stream request failed");
+        const errorData = await response.json().catch(() => ({ error: "stream_failed" }));
+        callbacks.onError?.(
+          toAIError(errorData, {
+            message: "Stream request failed",
+            status: response.status
+          })
+        );
         return;
       }
       reader = response.body?.getReader();
       if (!reader) {
-        callbacks.onError?.("ReadableStream not supported");
+        callbacks.onError?.(
+          new AIError({
+            code: "stream_failed",
+            message: "ReadableStream not supported",
+            retryable: false
+          })
+        );
         return;
       }
       const decoder = new TextDecoder();
@@ -207,9 +335,7 @@ var AIAPI = class {
           try {
             const event = JSON.parse(data);
             if (event.error) {
-              callbacks.onError?.(
-                event.message || event.error || "stream error"
-              );
+              callbacks.onError?.(toAIError(event));
               return;
             }
             if (event.type === "sources" && event.sources) {
@@ -1194,34 +1320,48 @@ var AnalyticsAPI = class {
   }
 };
 
-// src/types/error.ts
-var ApiError = class extends Error {
-  constructor(statusCode, message, code, details) {
-    super(message);
-    this.statusCode = statusCode;
-    this.name = "ApiError";
-    this.code = code;
-    this.details = details;
+// src/api/app-members.ts
+var AppMembersAPI = class {
+  constructor(http) {
+    this.http = http;
   }
-};
-var AuthError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "AuthError";
+  ensureServerAuth(method) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        `cb.appMembers.${method}() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["app_member:read"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uC790\uAE30 \uC815\uBCF4\uB294 cb.auth.getMe() \uB97C \uC4F0\uC138\uC694.`
+      );
+    }
   }
-};
-var GameError = class extends Error {
-  constructor(init) {
-    super(init.message || init.code || "GameError");
-    this.name = "GameError";
-    this.code = init.code || "UNKNOWN";
-    this.phase = init.phase;
-    this.feature = init.feature;
-    this.roomId = init.roomId;
-    this.scriptId = init.scriptId;
-    this.originClientId = init.originClientId;
-    this.requested = init.requested;
-    this.available = init.available;
+  /**
+   * 앱 멤버 목록을 조회한다 (이메일 포함). (management_scope: `app_member:read`)
+   *
+   * @param appId 앱 ID
+   * @param options 페이지네이션 및 `search`(닉네임·이메일 부분 일치)
+   */
+  async list(appId, options = {}) {
+    this.ensureServerAuth("list");
+    const query = new URLSearchParams();
+    if (options.page !== void 0) query.set("page", String(options.page));
+    if (options.pageSize !== void 0)
+      query.set("page_size", String(options.pageSize));
+    const search = options.search?.trim();
+    if (search) query.set("search", search);
+    const qs = query.toString();
+    return this.http.get(
+      `/v1/apps/${appId}/app-members${qs ? `?${qs}` : ""}`
+    );
+  }
+  /**
+   * 앱 멤버 상세를 조회한다 (이메일 + 로그인 수단 포함). (management_scope: `app_member:read`)
+   *
+   * @param appId 앱 ID
+   * @param memberId 멤버 ID
+   */
+  async get(appId, memberId) {
+    this.ensureServerAuth("get");
+    return this.http.get(
+      `/v1/apps/${appId}/app-members/${memberId}`
+    );
   }
 };
 
@@ -6748,9 +6888,16 @@ var RealtimeAPI = class {
     });
     this.pendingRequests.clear();
     this.subscriptions.clear();
-    this.streamSessions.forEach((session) => {
+    this.streamSessions.forEach((session, sessionId) => {
       if (session.handlers.onError) {
-        session.handlers.onError(new Error("Connection closed"));
+        session.handlers.onError(
+          new AIError({
+            code: "service_unavailable",
+            message: "\uC2E4\uC2DC\uAC04 \uC5F0\uACB0\uC774 \uC885\uB8CC\uB418\uC5B4 AI \uC2A4\uD2B8\uB9AC\uBC0D\uC774 \uC911\uB2E8\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC7AC\uC5F0\uACB0 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694.",
+            retryable: true,
+            sessionId
+          })
+        );
       }
     });
     this.streamSessions.clear();
@@ -7015,17 +7162,26 @@ var RealtimeAPI = class {
         signal
       });
       if (!response.ok) {
-        const errData = await response.json().catch(() => ({ error: "Stream request failed" }));
+        const errData = await response.json().catch(() => ({ error: "stream_failed" }));
         handlers.onError?.(
-          new Error(
-            errData.error || errData.message || "Stream request failed"
-          )
+          toAIError(errData, {
+            message: "Stream request failed",
+            sessionId,
+            status: response.status
+          })
         );
         return;
       }
       reader = response.body?.getReader();
       if (!reader) {
-        handlers.onError?.(new Error("ReadableStream not supported"));
+        handlers.onError?.(
+          new AIError({
+            code: "stream_failed",
+            message: "ReadableStream not supported",
+            retryable: false,
+            sessionId
+          })
+        );
         return;
       }
       const decoder = new TextDecoder();
@@ -7052,9 +7208,7 @@ var RealtimeAPI = class {
           try {
             const ev = JSON.parse(data);
             if (ev.error) {
-              handlers.onError?.(
-                new Error(ev.message || ev.error || "stream error")
-              );
+              handlers.onError?.(toAIError(ev, { sessionId }));
               return;
             }
             if (ev.type === "tool_start") {
@@ -7098,7 +7252,14 @@ var RealtimeAPI = class {
     } catch (err) {
       const aborted = signal.aborted || err instanceof DOMException && err.name === "AbortError" || typeof err === "object" && err !== null && err.name === "AbortError";
       if (!aborted) {
-        handlers.onError?.(err instanceof Error ? err : new Error(String(err)));
+        handlers.onError?.(
+          new AIError({
+            code: "service_unavailable",
+            message: err instanceof Error ? err.message : String(err) || "AI \uC2A4\uD2B8\uB9AC\uBC0D \uC694\uCCAD\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4",
+            retryable: true,
+            sessionId
+          })
+        );
       }
     } finally {
       this.sseSessions.delete(sessionId);
@@ -7736,12 +7897,11 @@ var RealtimeAPI = class {
         break;
       }
       case "stream_error": {
-        const data = msg.data;
         if (msg.request_id) {
           for (const [sessionId, session] of this.streamSessions) {
             if (session.requestId === msg.request_id) {
               if (session.handlers.onError) {
-                session.handlers.onError(new Error(data.message));
+                session.handlers.onError(toAIError(msg.data, { sessionId }));
               }
               this.streamSessions.delete(sessionId);
               break;
@@ -7814,9 +7974,16 @@ var RealtimeAPI = class {
     }
     this.ws = null;
     this._connectionId = null;
-    this.streamSessions.forEach((session) => {
+    this.streamSessions.forEach((session, sessionId) => {
       if (session.handlers.onError) {
-        session.handlers.onError(new Error("Connection lost"));
+        session.handlers.onError(
+          new AIError({
+            code: "service_unavailable",
+            message: "\uC2E4\uC2DC\uAC04 \uC5F0\uACB0\uC774 \uB04A\uACA8 AI \uC2A4\uD2B8\uB9AC\uBC0D\uC774 \uC911\uB2E8\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC7AC\uC5F0\uACB0 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694.",
+            retryable: true,
+            sessionId
+          })
+        );
       }
     });
     this.streamSessions.clear();
@@ -11273,13 +11440,26 @@ var HttpClient = class {
         this.emitError(err2);
         throw err2;
       }
-      const message = typeof rawError === "string" ? rawError : errorData.message || "Unknown error";
-      const legacyDetails = retryAfterSeconds !== void 0 ? { retry_after_seconds: retryAfterSeconds } : void 0;
+      const flatMessage = typeof errorData.message === "string" && errorData.message !== "" ? errorData.message : void 0;
+      const explicitCode = typeof errorData.code === "string" && errorData.code !== "" ? errorData.code : void 0;
+      const errorIsCode = typeof rawError === "string" && /^[a-z][a-z0-9_]*$/.test(rawError);
+      const message = flatMessage ?? (typeof rawError === "string" && rawError !== "" ? rawError : "Unknown error");
+      const code = explicitCode ?? (errorIsCode ? rawError : void 0);
+      const legacyDetails = {};
+      if (retryAfterSeconds !== void 0) {
+        legacyDetails.retry_after_seconds = retryAfterSeconds;
+      }
+      if (typeof errorData.provider === "string") {
+        legacyDetails.provider = errorData.provider;
+      }
+      if (typeof errorData.model === "string") {
+        legacyDetails.model = errorData.model;
+      }
       const err = new ApiError(
         response.status,
         message,
-        void 0,
-        legacyDetails
+        code,
+        Object.keys(legacyDetails).length > 0 ? legacyDetails : void 0
       );
       this.emitError(err);
       throw err;
@@ -12163,6 +12343,7 @@ var ConnectBase = class {
     this.subscription = new SubscriptionAPI(this.http);
     this.push = new PushAPI(this.http);
     this.roles = new RolesAPI(this.http);
+    this.appMembers = new AppMembersAPI(this.http);
     this.video = new VideoAPI(
       this.http,
       config.videoUrl || env("CB_VIDEO_URL") || DEFAULT_VIDEO_URL
@@ -12257,9 +12438,11 @@ var ConnectBase = class {
 var index_default = ConnectBase;
 export {
   AIAPI,
+  AIError,
   AUTH_MEMBER_ID_TOKEN,
   AdsAPI,
   ApiError,
+  AppMembersAPI,
   AuthError,
   ConnectBase,
   EndpointAPI,
@@ -12276,5 +12459,6 @@ export {
   detectInAppBrowser,
   escapeToExternalBrowser,
   isWebTransportSupported,
+  toAIError,
   toCreateRoomWire
 };

package/package.json

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