connectbase-client 3.35.0 → 3.35.2

package/dist/index.d.mts

@@ -96,10 +96,10 @@ interface AbortOptions {
  * Recent API calls breadcrumb buffer — SDK 디버깅 / platform issue 발행 시 자동 첨부.
  *
  * **저장 정책 (PII 보호):**
- *   - method, path (query string strip), status, duration_ms, timestamp 만 저장
+ *   - method, path (query string 전체 strip), status, duration_ms, timestamp 만 저장
  *   - body / response body / 인증 토큰 미저장
- *   - URL 내 secret-like 패턴 (key=, token=, password=) 자동 redact
- *   - `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 는 path 만 (쿼리 strip)
+ *   - 쿼리스트링은 키 단위 redact 가 아니라 통째로 제거 (토큰/PII 누출 가능성 0)
+ *   - 따라서 `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 도 path 만 보존
  */
 interface RecentApiCall {
     method: string;
@@ -187,7 +187,7 @@ declare class HttpClient {
     private refreshLockedUntil;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     private recentCalls;
     /**
@@ -280,6 +280,13 @@ declare class HttpClient {
      * Base URL 반환
      */
     getBaseUrl(): string;
+    /**
+     * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
+     *
+     * 콘솔(앱 소유자 JWT) 경로를 호출하기 전에 appId 유무를 확인하기 위한 public 접근자.
+     * private `config` 필드를 access-modifier 관통 cast 없이 노출한다.
+     */
+    getAppId(): string | undefined;
     private refreshAccessToken;
     /**
      * 새로고침/탭 재개 시 HttpOnly cookie 만으로 access token 을 복구한다.
@@ -7974,6 +7981,9 @@ declare class EndpointAPI {
      * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
      * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
      *
+     * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+     * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+     *
      * @example ComfyUI 결과 폴링
      * ```typescript
      * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -7981,7 +7991,8 @@ declare class EndpointAPI {
      * const filename = await cb.endpoint.pollUntil<string>(
      *     "comfyui-main",
      *     { path: `/history/${promptId}` },
-     *     (data: Hist) => {
+     *     (body) => {
+     *         const data = body as Hist
      *         const entry = data[promptId]
      *         if (!entry) return undefined // 아직 큐에 있음
      *         for (const out of Object.values(entry.outputs)) {
@@ -8024,7 +8035,7 @@ declare class EndpointAPI {
      * ```
      */
     connectWebSocket(label: string, opts?: ConnectWebSocketOptions): Promise<WebSocket>;
-    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: any, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
+    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: unknown, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
 }
 /**
  * EndpointAPI.call 의 init 인자.

package/dist/index.d.ts

@@ -96,10 +96,10 @@ interface AbortOptions {
  * Recent API calls breadcrumb buffer — SDK 디버깅 / platform issue 발행 시 자동 첨부.
  *
  * **저장 정책 (PII 보호):**
- *   - method, path (query string strip), status, duration_ms, timestamp 만 저장
+ *   - method, path (query string 전체 strip), status, duration_ms, timestamp 만 저장
  *   - body / response body / 인증 토큰 미저장
- *   - URL 내 secret-like 패턴 (key=, token=, password=) 자동 redact
- *   - `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 는 path 만 (쿼리 strip)
+ *   - 쿼리스트링은 키 단위 redact 가 아니라 통째로 제거 (토큰/PII 누출 가능성 0)
+ *   - 따라서 `/v1/auth/*`, `/v1/oauth/token` 등 민감 endpoint 도 path 만 보존
  */
 interface RecentApiCall {
     method: string;
@@ -187,7 +187,7 @@ declare class HttpClient {
     private refreshLockedUntil;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     private recentCalls;
     /**
@@ -280,6 +280,13 @@ declare class HttpClient {
      * Base URL 반환
      */
     getBaseUrl(): string;
+    /**
+     * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
+     *
+     * 콘솔(앱 소유자 JWT) 경로를 호출하기 전에 appId 유무를 확인하기 위한 public 접근자.
+     * private `config` 필드를 access-modifier 관통 cast 없이 노출한다.
+     */
+    getAppId(): string | undefined;
     private refreshAccessToken;
     /**
      * 새로고침/탭 재개 시 HttpOnly cookie 만으로 access token 을 복구한다.
@@ -7974,6 +7981,9 @@ declare class EndpointAPI {
      * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
      * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
      *
+     * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+     * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+     *
      * @example ComfyUI 결과 폴링
      * ```typescript
      * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -7981,7 +7991,8 @@ declare class EndpointAPI {
      * const filename = await cb.endpoint.pollUntil<string>(
      *     "comfyui-main",
      *     { path: `/history/${promptId}` },
-     *     (data: Hist) => {
+     *     (body) => {
+     *         const data = body as Hist
      *         const entry = data[promptId]
      *         if (!entry) return undefined // 아직 큐에 있음
      *         for (const out of Object.values(entry.outputs)) {
@@ -8024,7 +8035,7 @@ declare class EndpointAPI {
      * ```
      */
     connectWebSocket(label: string, opts?: ConnectWebSocketOptions): Promise<WebSocket>;
-    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: any, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
+    pollUntil<T>(label: string, init: EndpointCallInit, predicate: (body: unknown, res: Response) => T | undefined | Promise<T | undefined>, opts?: PollUntilOptions): Promise<T>;
 }
 /**
  * EndpointAPI.call 의 init 인자.

package/dist/index.js

@@ -184,7 +184,7 @@ var HttpClient = class {
     this.refreshLockedUntil = 0;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     this.recentCalls = new RecentCallsBuffer();
     /**
@@ -380,6 +380,15 @@ var HttpClient = class {
   getBaseUrl() {
     return this.config.baseUrl;
   }
+  /**
+   * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
+   *
+   * 콘솔(앱 소유자 JWT) 경로를 호출하기 전에 appId 유무를 확인하기 위한 public 접근자.
+   * private `config` 필드를 access-modifier 관통 cast 없이 노출한다.
+   */
+  getAppId() {
+    return this.config.appId;
+  }
   async refreshAccessToken() {
     if (this.isRefreshing) {
       return this.refreshPromise;
@@ -843,13 +852,14 @@ var AuthAPI = class {
       return;
     }
     if (typeof window === "undefined") return;
+    const bridge = window;
     if (memberId) {
-      if (typeof window.__cbSetMember === "function") {
-        window.__cbSetMember(memberId);
+      if (typeof bridge.__cbSetMember === "function") {
+        bridge.__cbSetMember(memberId);
       }
     } else {
-      if (typeof window.__cbClearMember === "function") {
-        window.__cbClearMember();
+      if (typeof bridge.__cbClearMember === "function") {
+        bridge.__cbClearMember();
       }
     }
   }
@@ -895,6 +905,15 @@ var AuthAPI = class {
       data,
       { skipAuth: true }
     );
+    assertShape(
+      response,
+      {
+        access_token: { type: "string" },
+        refresh_token: { type: "string" },
+        member_id: { type: "string-or-number" }
+      },
+      "auth.signUpMember"
+    );
     this.http.setTokens(response.access_token, response.refresh_token);
     this.notifyVisitorTracker(response.member_id);
     return response;
@@ -1125,6 +1144,14 @@ var AuthAPI = class {
             {},
             { headers: { "Authorization": `Bearer ${storedData.refreshToken}` }, skipAuth: true }
           );
+          assertShape(
+            refreshed,
+            {
+              access_token: { type: "string" },
+              refresh_token: { type: "string" }
+            },
+            "auth.signInAsGuestMember.reissue"
+          );
           this.http.setTokens(refreshed.access_token, refreshed.refresh_token);
           this.storeGuestMemberTokens(refreshed.access_token, refreshed.refresh_token, storedData.memberId);
           this.notifyVisitorTracker(storedData.memberId);
@@ -1145,6 +1172,15 @@ var AuthAPI = class {
       {},
       { skipAuth: true }
     );
+    assertShape(
+      response,
+      {
+        access_token: { type: "string" },
+        refresh_token: { type: "string" },
+        member_id: { type: "string-or-number" }
+      },
+      "auth.signInAsGuestMember.new"
+    );
     this.http.setTokens(response.access_token, response.refresh_token);
     this.storeGuestMemberTokens(response.access_token, response.refresh_token, response.member_id);
     this.notifyVisitorTracker(response.member_id);
@@ -1331,7 +1367,7 @@ var DatabaseAPI = class {
    * appId 가 설정되어 있어야 콘솔 경로를 호출할 수 있습니다 (validation_schema set/delete).
    */
   requireAppId() {
-    const appId = this.http.config?.appId;
+    const appId = this.http.getAppId();
     if (!appId) {
       throw new Error(
         "setValidationSchema/deleteValidationSchema \uB294 \uCF58\uC194 (JWT) \uC778\uC99D\uC774 \uD544\uC694\uD558\uBA70 ConnectBase config \uC5D0 appId \uAC00 \uC124\uC815\uB418\uC5B4\uC57C \uD569\uB2C8\uB2E4."
@@ -9084,6 +9120,9 @@ var EndpointAPI = class {
    * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
    * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
    *
+   * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+   * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+   *
    * @example ComfyUI 결과 폴링
    * ```typescript
    * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -9091,7 +9130,8 @@ var EndpointAPI = class {
    * const filename = await cb.endpoint.pollUntil<string>(
    *     "comfyui-main",
    *     { path: `/history/${promptId}` },
-   *     (data: Hist) => {
+   *     (body) => {
+   *         const data = body as Hist
    *         const entry = data[promptId]
    *         if (!entry) return undefined // 아직 큐에 있음
    *         for (const out of Object.values(entry.outputs)) {
@@ -9658,13 +9698,14 @@ var AnalyticsAPI = class {
   setMemberId(memberId) {
     this.memberId = memberId || null;
     if (typeof window !== "undefined") {
+      const bridge = window;
       if (memberId) {
-        if (typeof window.__cbSetMember === "function") {
-          window.__cbSetMember(memberId);
+        if (typeof bridge.__cbSetMember === "function") {
+          bridge.__cbSetMember(memberId);
         }
       } else {
-        if (typeof window.__cbClearMember === "function") {
-          window.__cbClearMember();
+        if (typeof bridge.__cbClearMember === "function") {
+          bridge.__cbClearMember();
         }
       }
     }
@@ -9929,7 +9970,8 @@ var AnalyticsAPI = class {
   }
   isDNT() {
     if (typeof navigator === "undefined") return false;
-    return navigator.doNotTrack === "1" || navigator.globalPrivacyControl === true;
+    const gpc = navigator.globalPrivacyControl;
+    return navigator.doNotTrack === "1" || gpc === true;
   }
   createBaseEvent(type) {
     return {

package/dist/index.mjs

@@ -138,7 +138,7 @@ var HttpClient = class {
     this.refreshLockedUntil = 0;
     /**
      * 최근 API 호출 breadcrumb (PII strip 후 저장). platform_issue 발행 시 자동 첨부 가능.
-     * `client.support.getRecentCalls()` 로 외부 노출.
+     * `client.support.getRecentApiCalls()` 로 외부 노출.
      */
     this.recentCalls = new RecentCallsBuffer();
     /**
@@ -334,6 +334,15 @@ var HttpClient = class {
   getBaseUrl() {
     return this.config.baseUrl;
   }
+  /**
+   * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
+   *
+   * 콘솔(앱 소유자 JWT) 경로를 호출하기 전에 appId 유무를 확인하기 위한 public 접근자.
+   * private `config` 필드를 access-modifier 관통 cast 없이 노출한다.
+   */
+  getAppId() {
+    return this.config.appId;
+  }
   async refreshAccessToken() {
     if (this.isRefreshing) {
       return this.refreshPromise;
@@ -797,13 +806,14 @@ var AuthAPI = class {
       return;
     }
     if (typeof window === "undefined") return;
+    const bridge = window;
     if (memberId) {
-      if (typeof window.__cbSetMember === "function") {
-        window.__cbSetMember(memberId);
+      if (typeof bridge.__cbSetMember === "function") {
+        bridge.__cbSetMember(memberId);
       }
     } else {
-      if (typeof window.__cbClearMember === "function") {
-        window.__cbClearMember();
+      if (typeof bridge.__cbClearMember === "function") {
+        bridge.__cbClearMember();
       }
     }
   }
@@ -849,6 +859,15 @@ var AuthAPI = class {
       data,
       { skipAuth: true }
     );
+    assertShape(
+      response,
+      {
+        access_token: { type: "string" },
+        refresh_token: { type: "string" },
+        member_id: { type: "string-or-number" }
+      },
+      "auth.signUpMember"
+    );
     this.http.setTokens(response.access_token, response.refresh_token);
     this.notifyVisitorTracker(response.member_id);
     return response;
@@ -1079,6 +1098,14 @@ var AuthAPI = class {
             {},
             { headers: { "Authorization": `Bearer ${storedData.refreshToken}` }, skipAuth: true }
           );
+          assertShape(
+            refreshed,
+            {
+              access_token: { type: "string" },
+              refresh_token: { type: "string" }
+            },
+            "auth.signInAsGuestMember.reissue"
+          );
           this.http.setTokens(refreshed.access_token, refreshed.refresh_token);
           this.storeGuestMemberTokens(refreshed.access_token, refreshed.refresh_token, storedData.memberId);
           this.notifyVisitorTracker(storedData.memberId);
@@ -1099,6 +1126,15 @@ var AuthAPI = class {
       {},
       { skipAuth: true }
     );
+    assertShape(
+      response,
+      {
+        access_token: { type: "string" },
+        refresh_token: { type: "string" },
+        member_id: { type: "string-or-number" }
+      },
+      "auth.signInAsGuestMember.new"
+    );
     this.http.setTokens(response.access_token, response.refresh_token);
     this.storeGuestMemberTokens(response.access_token, response.refresh_token, response.member_id);
     this.notifyVisitorTracker(response.member_id);
@@ -1285,7 +1321,7 @@ var DatabaseAPI = class {
    * appId 가 설정되어 있어야 콘솔 경로를 호출할 수 있습니다 (validation_schema set/delete).
    */
   requireAppId() {
-    const appId = this.http.config?.appId;
+    const appId = this.http.getAppId();
     if (!appId) {
       throw new Error(
         "setValidationSchema/deleteValidationSchema \uB294 \uCF58\uC194 (JWT) \uC778\uC99D\uC774 \uD544\uC694\uD558\uBA70 ConnectBase config \uC5D0 appId \uAC00 \uC124\uC815\uB418\uC5B4\uC57C \uD569\uB2C8\uB2E4."
@@ -9038,6 +9074,9 @@ var EndpointAPI = class {
    * predicate 는 같은 Response 를 한 번만 읽을 수 있으므로, 헬퍼 내부에서
    * `res.clone().json()` 형태로 안전하게 파싱한 뒤 호출자에게 전달.
    *
+   * predicate 의 `body` 는 `unknown` 으로 전달되므로, 호출자가 자신의 응답
+   * 스키마로 narrowing 한 뒤 사용한다 (런타임 검증 책임은 호출자에게 있음).
+   *
    * @example ComfyUI 결과 폴링
    * ```typescript
    * type Hist = Record<string, { outputs: Record<string, { images?: { filename: string }[] }> }>
@@ -9045,7 +9084,8 @@ var EndpointAPI = class {
    * const filename = await cb.endpoint.pollUntil<string>(
    *     "comfyui-main",
    *     { path: `/history/${promptId}` },
-   *     (data: Hist) => {
+   *     (body) => {
+   *         const data = body as Hist
    *         const entry = data[promptId]
    *         if (!entry) return undefined // 아직 큐에 있음
    *         for (const out of Object.values(entry.outputs)) {
@@ -9612,13 +9652,14 @@ var AnalyticsAPI = class {
   setMemberId(memberId) {
     this.memberId = memberId || null;
     if (typeof window !== "undefined") {
+      const bridge = window;
       if (memberId) {
-        if (typeof window.__cbSetMember === "function") {
-          window.__cbSetMember(memberId);
+        if (typeof bridge.__cbSetMember === "function") {
+          bridge.__cbSetMember(memberId);
         }
       } else {
-        if (typeof window.__cbClearMember === "function") {
-          window.__cbClearMember();
+        if (typeof bridge.__cbClearMember === "function") {
+          bridge.__cbClearMember();
         }
       }
     }
@@ -9883,7 +9924,8 @@ var AnalyticsAPI = class {
   }
   isDNT() {
     if (typeof navigator === "undefined") return false;
-    return navigator.doNotTrack === "1" || navigator.globalPrivacyControl === true;
+    const gpc = navigator.globalPrivacyControl;
+    return navigator.doNotTrack === "1" || gpc === true;
   }
   createBaseEvent(type) {
     return {

package/package.json

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