connectbase-client 3.37.0 → 3.39.0

package/dist/index.js

@@ -32,7 +32,6 @@ __export(index_exports, {
   GameError: () => GameError,
   GameRoom: () => GameRoom,
   GameRoomTransport: () => GameRoomTransport,
-  GuestSessionConflictError: () => GuestSessionConflictError,
   NativeAPI: () => NativeAPI,
   SessionManager: () => SessionManager,
   VideoProcessingError: () => VideoProcessingError,
@@ -60,15 +59,6 @@ var AuthError = class extends Error {
     this.name = "AuthError";
   }
 };
-var GuestSessionConflictError = class extends Error {
-  constructor() {
-    super(
-      "signInAsGuestMember refused: an active non-guest session is present in this client. Pass { allowOverrideExistingSession: true } to explicitly replace it, or call signOut() first."
-    );
-    this.code = "GUEST_SESSION_CONFLICT";
-    this.name = "GuestSessionConflictError";
-  }
-};
 var GameError = class extends Error {
   constructor(init) {
     super(init.message || init.code || "GameError");
@@ -822,21 +812,9 @@ function assertShape(value, shape, endpoint) {
 }
 
 // src/api/auth.ts
-var GUEST_MEMBER_TOKEN_KEY_PREFIX = "cb_guest_";
-function credentialToStorageKeyHash(credential) {
-  let hash = 0;
-  for (let i = 0; i < credential.length; i++) {
-    const char = credential.charCodeAt(i);
-    hash = (hash << 5) - hash + char;
-    hash = hash & hash;
-  }
-  return Math.abs(hash).toString(36);
-}
 var AuthAPI = class {
   constructor(http) {
     this.http = http;
-    this.guestMemberLoginPromise = null;
-    this.cachedGuestMemberTokenKey = null;
     this.analytics = null;
   }
   /**
@@ -870,9 +848,7 @@ var AuthAPI = class {
    * @example
    * ```typescript
    * const settings = await client.auth.getAuthSettings()
-   * if (settings.allow_guest_login) {
-   *     await client.auth.signInAsGuestMember()
-   * } else if (settings.allow_id_password_login) {
+   * if (settings.allow_id_password_login) {
    *     // 로그인 폼 표시
    * } else if (settings.enabled_oauth_providers.includes('GOOGLE')) {
    *     // 구글 소셜 로그인 버튼 표시
@@ -950,66 +926,6 @@ var AuthAPI = class {
     this.notifyVisitorTracker(response.member_id);
     return response;
   }
-  /**
-   * 앱 멤버 게스트 가입
-   * API Key로 인증된 앱에 게스트 멤버로 가입합니다.
-   * 실시간 채팅 등에서 JWT 토큰 기반 인증이 필요할 때 사용합니다.
-   * 로컬 스토리지에 저장된 토큰이 있으면 기존 계정으로 재로그인을 시도합니다.
-   * 동시 호출 시 중복 요청 방지 (race condition 방지)
-   *
-   * **활성 세션 가드 (3.22.0+)**
-   * OAuth/email/username 로 이미 로그인된 세션이 살아있는 채 이 메서드가 호출되면
-   * 메인 토큰 슬롯이 silent 로 게스트 토큰으로 덮어써져 사용자가 둔갑되는 회귀가
-   * 있었다 (platform-issue 019e6c5d). 이를 막기 위해 활성 비-게스트 세션이 감지되면
-   * 기본적으로 `GuestSessionConflictError` 를 던진다. 명시적으로 교체하려면
-   * `{ allowOverrideExistingSession: true }` 를 전달하거나 먼저 `signOut()` 을 호출할 것.
-   *
-   * @example
-   * ```typescript
-   * const guest = await client.auth.signInAsGuestMember()
-   * await client.realtime.connect({ accessToken: guest.access_token })
-   *
-   * // 활성 세션을 명시적으로 교체 (예: "게스트로 계속" 버튼)
-   * await client.auth.signInAsGuestMember({ allowOverrideExistingSession: true })
-   * ```
-   */
-  async signInAsGuestMember(opts) {
-    if (this.guestMemberLoginPromise) {
-      return this.guestMemberLoginPromise;
-    }
-    if (!opts?.allowOverrideExistingSession && this.hasActiveNonGuestSession()) {
-      throw new GuestSessionConflictError();
-    }
-    this.guestMemberLoginPromise = this.executeGuestMemberLogin();
-    try {
-      return await this.guestMemberLoginPromise;
-    } finally {
-      this.guestMemberLoginPromise = null;
-    }
-  }
-  /**
-   * 현재 in-memory access token 이 "게스트 토큰이 아닌 다른 세션" 으로 판단되는지 확인.
-   *
-   * 판별 규칙:
-   *   - access token 자체가 없으면 false (어떤 세션도 없음)
-   *   - access token 이 만료됐으면 false (재로그인이 필요한 dead 상태)
-   *   - persistence='none' 인 경우: 토큰은 메모리에만 존재. 우리는 그 토큰이
-   *     게스트인지 회원인지 분별할 메타가 메모리에 없다 → 보수적으로 true 처리.
-   *     (회원이 가지고 있던 세션을 게스트가 덮어쓰는 게 더 큰 사고이므로
-   *      false-positive < silent overwrite.)
-   *   - persistence='localStorage'|'sessionStorage' 인 경우: 저장된 게스트 토큰과
-   *     현재 access token 이 일치하면 게스트 세션(false), 다르면 비-게스트(true).
-   */
-  hasActiveNonGuestSession() {
-    const access = this.http.getAccessToken();
-    if (!access) return false;
-    if (this.isTokenExpired(access)) return false;
-    const stored = this.getStoredGuestMemberTokens();
-    if (!stored) {
-      return true;
-    }
-    return stored.accessToken !== access;
-  }
   /**
    * 현재 로그인한 멤버 정보 조회
    * custom_data를 포함한 멤버 정보를 반환합니다.
@@ -1106,124 +1022,6 @@ var AuthAPI = class {
       this.notifyVisitorTracker(null);
     }
   }
-  /**
-   * 저장된 게스트 멤버 토큰 삭제
-   */
-  clearGuestMemberTokens() {
-    const storage = this.http.getPersistenceStorage();
-    if (!storage) return;
-    storage.removeItem(this.getGuestMemberTokenKey());
-  }
-  // ===== Private Methods =====
-  async executeGuestMemberLogin() {
-    const storedData = this.getStoredGuestMemberTokens();
-    if (storedData) {
-      if (!this.isTokenExpired(storedData.accessToken)) {
-        try {
-          this.http.setTokens(storedData.accessToken, storedData.refreshToken);
-          const memberInfo = await this.http.get(
-            "/v1/public/app-members/me"
-          );
-          if (memberInfo.is_active) {
-            this.notifyVisitorTracker(memberInfo.member_id);
-            return {
-              member_id: memberInfo.member_id,
-              access_token: storedData.accessToken,
-              refresh_token: storedData.refreshToken
-            };
-          }
-          this.clearGuestMemberTokens();
-        } catch {
-          this.http.clearTokens();
-        }
-      }
-      if (storedData.refreshToken && !this.isTokenExpired(storedData.refreshToken)) {
-        try {
-          const refreshed = await this.http.post(
-            "/v1/auth/re-issue",
-            {},
-            { 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);
-          return {
-            member_id: storedData.memberId,
-            access_token: refreshed.access_token,
-            refresh_token: refreshed.refresh_token
-          };
-        } catch {
-          this.clearGuestMemberTokens();
-        }
-      } else {
-        this.clearGuestMemberTokens();
-      }
-    }
-    const response = await this.http.post(
-      "/v1/public/app-members",
-      {},
-      { 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);
-    return response;
-  }
-  isTokenExpired(token) {
-    try {
-      const payload = JSON.parse(atob(token.split(".")[1]));
-      const currentTime = Date.now() / 1e3;
-      return payload.exp < currentTime;
-    } catch {
-      return true;
-    }
-  }
-  getGuestMemberTokenKey() {
-    if (this.cachedGuestMemberTokenKey) {
-      return this.cachedGuestMemberTokenKey;
-    }
-    const credential = this.http.getCredential();
-    if (!credential) {
-      this.cachedGuestMemberTokenKey = `${GUEST_MEMBER_TOKEN_KEY_PREFIX}default`;
-    } else {
-      const keyHash = credentialToStorageKeyHash(credential);
-      this.cachedGuestMemberTokenKey = `${GUEST_MEMBER_TOKEN_KEY_PREFIX}${keyHash}`;
-    }
-    return this.cachedGuestMemberTokenKey;
-  }
-  getStoredGuestMemberTokens() {
-    const storage = this.http.getPersistenceStorage();
-    if (!storage) return null;
-    const stored = storage.getItem(this.getGuestMemberTokenKey());
-    if (!stored) return null;
-    try {
-      return JSON.parse(stored);
-    } catch {
-      return null;
-    }
-  }
-  storeGuestMemberTokens(accessToken, refreshToken, memberId) {
-    const storage = this.http.getPersistenceStorage();
-    if (!storage) return;
-    storage.setItem(this.getGuestMemberTokenKey(), JSON.stringify({ accessToken, refreshToken, memberId }));
-  }
 };
 
 // src/api/database.ts
@@ -6201,6 +5999,55 @@ var PushAPI = class {
     };
     return this.http.post(`/v1/apps/${appId}/push/send`, body);
   }
+  /**
+   * 토픽 구독자 전체에게 푸시 알림을 발송한다 (서버 사이드 전용).
+   *
+   * 백엔드 라우트 `POST /v1/apps/:appID/push/send-to-topic` 는 콘솔 JWT, User Secret Key(`cb_sk_`),
+   * 또는 service_role 토큰(`ctx.cbAdmin`)을 받는다. `sendToMembers` 와 동일하게 브라우저 SDK 의
+   * Public Key(`cb_pk_`) **단독** 인스턴스에서는 호출이 차단되며, 위임 Bearer 토큰을 가진
+   * 인스턴스(`ctx.cbAdmin`/`ctx.cb`)는 cb_pk_ 가 앱 식별용으로만 실리므로 허용된다.
+   *
+   * 정기 알림(일일 리마인더 등)을 ConnectBase Function 스케줄러에서 `ctx.cbAdmin` 으로 발송하는
+   * 것이 대표 유스케이스다 — 시크릿 키를 콘솔에서 별도로 발급해 함수 secret 에 넣을 필요가 없다.
+   *
+   * @param appId 발송 대상 앱 ID.
+   * @param topicName 발송 대상 토픽 이름 (예: 'daily-0900').
+   * @param payload 푸시 내용/옵션.
+   *
+   * @example
+   * ```ts
+   * // ConnectBase Function (service_role=true) — 시크릿 키 없이 ctx.cbAdmin 으로 토픽 발송
+   * const result = await ctx.cbAdmin.push.sendToTopic(ctx.appId, 'daily-0900', {
+   *     title: '오늘의 학습 리마인더',
+   *     body: '잊지 말고 학습을 이어가세요!',
+   *     data: { route: '/today' },
+   * })
+   * console.log(result.message_id, result.sent_count)
+   * ```
+   */
+  async sendToTopic(appId, topicName, payload) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        "cb.push.sendToTopic() \uB294 User Secret Key(cb_sk_), \uCF58\uC194 JWT, \uB610\uB294 service_role(ctx.cbAdmin) \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 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694."
+      );
+    }
+    if (!topicName) {
+      throw new Error("cb.push.sendToTopic(): topicName \uC774 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4.");
+    }
+    const body = {
+      topic_name: topicName,
+      title: payload.title,
+      body: payload.body,
+      ...payload.imageUrl !== void 0 ? { image_url: payload.imageUrl } : {},
+      ...payload.data !== void 0 ? { data: payload.data } : {},
+      ...payload.platforms !== void 0 ? { platforms: payload.platforms } : {},
+      ...payload.ttlSeconds !== void 0 ? { ttl: payload.ttlSeconds } : {},
+      ...payload.priority !== void 0 ? { priority: payload.priority } : {},
+      ...payload.clickAction !== void 0 ? { click_action: payload.clickAction } : {},
+      ...payload.scheduledAt !== void 0 ? { scheduled_at: payload.scheduledAt } : {}
+    };
+    return this.http.post(`/v1/apps/${appId}/push/send-to-topic`, body);
+  }
   // ============ Helper Methods ============
   /**
    * 브라우저 고유 ID 생성 (localStorage에 저장)
@@ -11338,7 +11185,6 @@ var index_default = ConnectBase;
   GameError,
   GameRoom,
   GameRoomTransport,
-  GuestSessionConflictError,
   NativeAPI,
   SessionManager,
   VideoProcessingError,

package/dist/index.mjs

@@ -14,15 +14,6 @@ var AuthError = class extends Error {
     this.name = "AuthError";
   }
 };
-var GuestSessionConflictError = class extends Error {
-  constructor() {
-    super(
-      "signInAsGuestMember refused: an active non-guest session is present in this client. Pass { allowOverrideExistingSession: true } to explicitly replace it, or call signOut() first."
-    );
-    this.code = "GUEST_SESSION_CONFLICT";
-    this.name = "GuestSessionConflictError";
-  }
-};
 var GameError = class extends Error {
   constructor(init) {
     super(init.message || init.code || "GameError");
@@ -776,21 +767,9 @@ function assertShape(value, shape, endpoint) {
 }
 
 // src/api/auth.ts
-var GUEST_MEMBER_TOKEN_KEY_PREFIX = "cb_guest_";
-function credentialToStorageKeyHash(credential) {
-  let hash = 0;
-  for (let i = 0; i < credential.length; i++) {
-    const char = credential.charCodeAt(i);
-    hash = (hash << 5) - hash + char;
-    hash = hash & hash;
-  }
-  return Math.abs(hash).toString(36);
-}
 var AuthAPI = class {
   constructor(http) {
     this.http = http;
-    this.guestMemberLoginPromise = null;
-    this.cachedGuestMemberTokenKey = null;
     this.analytics = null;
   }
   /**
@@ -824,9 +803,7 @@ var AuthAPI = class {
    * @example
    * ```typescript
    * const settings = await client.auth.getAuthSettings()
-   * if (settings.allow_guest_login) {
-   *     await client.auth.signInAsGuestMember()
-   * } else if (settings.allow_id_password_login) {
+   * if (settings.allow_id_password_login) {
    *     // 로그인 폼 표시
    * } else if (settings.enabled_oauth_providers.includes('GOOGLE')) {
    *     // 구글 소셜 로그인 버튼 표시
@@ -904,66 +881,6 @@ var AuthAPI = class {
     this.notifyVisitorTracker(response.member_id);
     return response;
   }
-  /**
-   * 앱 멤버 게스트 가입
-   * API Key로 인증된 앱에 게스트 멤버로 가입합니다.
-   * 실시간 채팅 등에서 JWT 토큰 기반 인증이 필요할 때 사용합니다.
-   * 로컬 스토리지에 저장된 토큰이 있으면 기존 계정으로 재로그인을 시도합니다.
-   * 동시 호출 시 중복 요청 방지 (race condition 방지)
-   *
-   * **활성 세션 가드 (3.22.0+)**
-   * OAuth/email/username 로 이미 로그인된 세션이 살아있는 채 이 메서드가 호출되면
-   * 메인 토큰 슬롯이 silent 로 게스트 토큰으로 덮어써져 사용자가 둔갑되는 회귀가
-   * 있었다 (platform-issue 019e6c5d). 이를 막기 위해 활성 비-게스트 세션이 감지되면
-   * 기본적으로 `GuestSessionConflictError` 를 던진다. 명시적으로 교체하려면
-   * `{ allowOverrideExistingSession: true }` 를 전달하거나 먼저 `signOut()` 을 호출할 것.
-   *
-   * @example
-   * ```typescript
-   * const guest = await client.auth.signInAsGuestMember()
-   * await client.realtime.connect({ accessToken: guest.access_token })
-   *
-   * // 활성 세션을 명시적으로 교체 (예: "게스트로 계속" 버튼)
-   * await client.auth.signInAsGuestMember({ allowOverrideExistingSession: true })
-   * ```
-   */
-  async signInAsGuestMember(opts) {
-    if (this.guestMemberLoginPromise) {
-      return this.guestMemberLoginPromise;
-    }
-    if (!opts?.allowOverrideExistingSession && this.hasActiveNonGuestSession()) {
-      throw new GuestSessionConflictError();
-    }
-    this.guestMemberLoginPromise = this.executeGuestMemberLogin();
-    try {
-      return await this.guestMemberLoginPromise;
-    } finally {
-      this.guestMemberLoginPromise = null;
-    }
-  }
-  /**
-   * 현재 in-memory access token 이 "게스트 토큰이 아닌 다른 세션" 으로 판단되는지 확인.
-   *
-   * 판별 규칙:
-   *   - access token 자체가 없으면 false (어떤 세션도 없음)
-   *   - access token 이 만료됐으면 false (재로그인이 필요한 dead 상태)
-   *   - persistence='none' 인 경우: 토큰은 메모리에만 존재. 우리는 그 토큰이
-   *     게스트인지 회원인지 분별할 메타가 메모리에 없다 → 보수적으로 true 처리.
-   *     (회원이 가지고 있던 세션을 게스트가 덮어쓰는 게 더 큰 사고이므로
-   *      false-positive < silent overwrite.)
-   *   - persistence='localStorage'|'sessionStorage' 인 경우: 저장된 게스트 토큰과
-   *     현재 access token 이 일치하면 게스트 세션(false), 다르면 비-게스트(true).
-   */
-  hasActiveNonGuestSession() {
-    const access = this.http.getAccessToken();
-    if (!access) return false;
-    if (this.isTokenExpired(access)) return false;
-    const stored = this.getStoredGuestMemberTokens();
-    if (!stored) {
-      return true;
-    }
-    return stored.accessToken !== access;
-  }
   /**
    * 현재 로그인한 멤버 정보 조회
    * custom_data를 포함한 멤버 정보를 반환합니다.
@@ -1060,124 +977,6 @@ var AuthAPI = class {
       this.notifyVisitorTracker(null);
     }
   }
-  /**
-   * 저장된 게스트 멤버 토큰 삭제
-   */
-  clearGuestMemberTokens() {
-    const storage = this.http.getPersistenceStorage();
-    if (!storage) return;
-    storage.removeItem(this.getGuestMemberTokenKey());
-  }
-  // ===== Private Methods =====
-  async executeGuestMemberLogin() {
-    const storedData = this.getStoredGuestMemberTokens();
-    if (storedData) {
-      if (!this.isTokenExpired(storedData.accessToken)) {
-        try {
-          this.http.setTokens(storedData.accessToken, storedData.refreshToken);
-          const memberInfo = await this.http.get(
-            "/v1/public/app-members/me"
-          );
-          if (memberInfo.is_active) {
-            this.notifyVisitorTracker(memberInfo.member_id);
-            return {
-              member_id: memberInfo.member_id,
-              access_token: storedData.accessToken,
-              refresh_token: storedData.refreshToken
-            };
-          }
-          this.clearGuestMemberTokens();
-        } catch {
-          this.http.clearTokens();
-        }
-      }
-      if (storedData.refreshToken && !this.isTokenExpired(storedData.refreshToken)) {
-        try {
-          const refreshed = await this.http.post(
-            "/v1/auth/re-issue",
-            {},
-            { 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);
-          return {
-            member_id: storedData.memberId,
-            access_token: refreshed.access_token,
-            refresh_token: refreshed.refresh_token
-          };
-        } catch {
-          this.clearGuestMemberTokens();
-        }
-      } else {
-        this.clearGuestMemberTokens();
-      }
-    }
-    const response = await this.http.post(
-      "/v1/public/app-members",
-      {},
-      { 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);
-    return response;
-  }
-  isTokenExpired(token) {
-    try {
-      const payload = JSON.parse(atob(token.split(".")[1]));
-      const currentTime = Date.now() / 1e3;
-      return payload.exp < currentTime;
-    } catch {
-      return true;
-    }
-  }
-  getGuestMemberTokenKey() {
-    if (this.cachedGuestMemberTokenKey) {
-      return this.cachedGuestMemberTokenKey;
-    }
-    const credential = this.http.getCredential();
-    if (!credential) {
-      this.cachedGuestMemberTokenKey = `${GUEST_MEMBER_TOKEN_KEY_PREFIX}default`;
-    } else {
-      const keyHash = credentialToStorageKeyHash(credential);
-      this.cachedGuestMemberTokenKey = `${GUEST_MEMBER_TOKEN_KEY_PREFIX}${keyHash}`;
-    }
-    return this.cachedGuestMemberTokenKey;
-  }
-  getStoredGuestMemberTokens() {
-    const storage = this.http.getPersistenceStorage();
-    if (!storage) return null;
-    const stored = storage.getItem(this.getGuestMemberTokenKey());
-    if (!stored) return null;
-    try {
-      return JSON.parse(stored);
-    } catch {
-      return null;
-    }
-  }
-  storeGuestMemberTokens(accessToken, refreshToken, memberId) {
-    const storage = this.http.getPersistenceStorage();
-    if (!storage) return;
-    storage.setItem(this.getGuestMemberTokenKey(), JSON.stringify({ accessToken, refreshToken, memberId }));
-  }
 };
 
 // src/api/database.ts
@@ -6155,6 +5954,55 @@ var PushAPI = class {
     };
     return this.http.post(`/v1/apps/${appId}/push/send`, body);
   }
+  /**
+   * 토픽 구독자 전체에게 푸시 알림을 발송한다 (서버 사이드 전용).
+   *
+   * 백엔드 라우트 `POST /v1/apps/:appID/push/send-to-topic` 는 콘솔 JWT, User Secret Key(`cb_sk_`),
+   * 또는 service_role 토큰(`ctx.cbAdmin`)을 받는다. `sendToMembers` 와 동일하게 브라우저 SDK 의
+   * Public Key(`cb_pk_`) **단독** 인스턴스에서는 호출이 차단되며, 위임 Bearer 토큰을 가진
+   * 인스턴스(`ctx.cbAdmin`/`ctx.cb`)는 cb_pk_ 가 앱 식별용으로만 실리므로 허용된다.
+   *
+   * 정기 알림(일일 리마인더 등)을 ConnectBase Function 스케줄러에서 `ctx.cbAdmin` 으로 발송하는
+   * 것이 대표 유스케이스다 — 시크릿 키를 콘솔에서 별도로 발급해 함수 secret 에 넣을 필요가 없다.
+   *
+   * @param appId 발송 대상 앱 ID.
+   * @param topicName 발송 대상 토픽 이름 (예: 'daily-0900').
+   * @param payload 푸시 내용/옵션.
+   *
+   * @example
+   * ```ts
+   * // ConnectBase Function (service_role=true) — 시크릿 키 없이 ctx.cbAdmin 으로 토픽 발송
+   * const result = await ctx.cbAdmin.push.sendToTopic(ctx.appId, 'daily-0900', {
+   *     title: '오늘의 학습 리마인더',
+   *     body: '잊지 말고 학습을 이어가세요!',
+   *     data: { route: '/today' },
+   * })
+   * console.log(result.message_id, result.sent_count)
+   * ```
+   */
+  async sendToTopic(appId, topicName, payload) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        "cb.push.sendToTopic() \uB294 User Secret Key(cb_sk_), \uCF58\uC194 JWT, \uB610\uB294 service_role(ctx.cbAdmin) \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 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694."
+      );
+    }
+    if (!topicName) {
+      throw new Error("cb.push.sendToTopic(): topicName \uC774 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4.");
+    }
+    const body = {
+      topic_name: topicName,
+      title: payload.title,
+      body: payload.body,
+      ...payload.imageUrl !== void 0 ? { image_url: payload.imageUrl } : {},
+      ...payload.data !== void 0 ? { data: payload.data } : {},
+      ...payload.platforms !== void 0 ? { platforms: payload.platforms } : {},
+      ...payload.ttlSeconds !== void 0 ? { ttl: payload.ttlSeconds } : {},
+      ...payload.priority !== void 0 ? { priority: payload.priority } : {},
+      ...payload.clickAction !== void 0 ? { click_action: payload.clickAction } : {},
+      ...payload.scheduledAt !== void 0 ? { scheduled_at: payload.scheduledAt } : {}
+    };
+    return this.http.post(`/v1/apps/${appId}/push/send-to-topic`, body);
+  }
   // ============ Helper Methods ============
   /**
    * 브라우저 고유 ID 생성 (localStorage에 저장)
@@ -11291,7 +11139,6 @@ export {
   GameError,
   GameRoom,
   GameRoomTransport,
-  GuestSessionConflictError,
   NativeAPI,
   SessionManager,
   VideoProcessingError,

package/package.json

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