connectbase-client 3.36.0 → 3.38.0

package/dist/index.d.mts

@@ -4932,6 +4932,24 @@ interface SendToMembersPayload {
     /** ISO8601 형식 예약 발송 시각. 미지정 시 즉시 발송. */
     scheduledAt?: string;
 }
+/**
+ * `cb.push.sendToTopic` 페이로드. 백엔드 `dto.SendPushToTopicRequest` 에 매핑되며,
+ * topic_name 은 메서드 인자로 받아 SDK 가 채운다. (members 발송과 달리 대상은 토픽 구독자 전체)
+ */
+interface SendToTopicPayload {
+    title: string;
+    body: string;
+    imageUrl?: string;
+    data?: Record<string, unknown>;
+    /** 'ios' | 'android' | 'web' 중 선택. 빈 배열/미지정 시 전체 플랫폼 발송. */
+    platforms?: Array<'ios' | 'android' | 'web'>;
+    /** TTL(초). 기본 86400 (24h). */
+    ttlSeconds?: number;
+    priority?: 'normal' | 'high';
+    clickAction?: string;
+    /** ISO8601 형식 예약 발송 시각. 미지정 시 즉시 발송. */
+    scheduledAt?: string;
+}
 /**
  * 발송 결과. 백엔드 `dto.SendResultResponse` 와 1:1 매핑.
  */
@@ -5106,6 +5124,33 @@ declare class PushAPI {
      * ```
      */
     sendToMembers(appId: string, memberIds: string[], payload: SendToMembersPayload): Promise<SendPushResult>;
+    /**
+     * 토픽 구독자 전체에게 푸시 알림을 발송한다 (서버 사이드 전용).
+     *
+     * 백엔드 라우트 `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)
+     * ```
+     */
+    sendToTopic(appId: string, topicName: string, payload: SendToTopicPayload): Promise<SendPushResult>;
     /**
      * 브라우저 고유 ID 생성 (localStorage에 저장)
      */
@@ -5421,6 +5466,35 @@ interface SuperChat {
     };
     created_at: string;
 }
+type SuperChatType = 'super_chat' | 'super_thanks' | 'super_sticker' | 'tip';
+/** sendSuperChat 옵션 — videoId 또는 liveId 중 하나로 대상을 지정한다. */
+interface SendSuperChatOptions {
+    /** 대상 영상 ID (videoId 또는 liveId 중 하나 필수) */
+    videoId?: string;
+    /** 대상 라이브 ID */
+    liveId?: string;
+    /** 슈퍼챗 종류 (기본 'super_thanks') */
+    type?: SuperChatType;
+    message?: string;
+    /** ISO 통화 코드 (기본 'USD') */
+    currency?: string;
+    stickerId?: string;
+}
+/**
+ * 슈퍼챗 전송 응답. `client_secret` 으로 결제(Stripe PaymentIntent)를 확정해야
+ * 슈퍼챗이 노출된다.
+ */
+interface SendSuperChatResponse {
+    super_chat_id: string;
+    client_secret: string;
+    amount: number;
+    currency: string;
+    platform_fee: number;
+    creator_amount: number;
+    display_duration: number;
+    color: string;
+    highlighted: boolean;
+}
 
 declare class VideoProcessingError extends Error {
     video?: Video;
@@ -5540,15 +5614,18 @@ declare class VideoAPI {
      */
     unsubscribeChannel(channelId: string): Promise<void>;
     /**
-     * Create a playlist
+     * Create a playlist for a channel.
+     * 백엔드는 `POST /v1/public/playlists` 에 body 로 `channel_id` 를 받는다 (AppMember 인증).
      */
     createPlaylist(channelId: string, data: CreatePlaylistRequest): Promise<Playlist>;
     /**
-     * Get playlists for a channel
+     * Get a channel's public playlists.
+     * 백엔드는 `GET /v1/public/playlists/public?channel_id=` 로 공개 플레이리스트를 반환한다.
      */
     getPlaylists(channelId: string): Promise<Playlist[]>;
     /**
-     * Get playlist items
+     * Get playlist items.
+     * 백엔드는 별도 items 라우트가 없고 `GET /v1/public/playlists/:id` 응답에 items 를 포함한다.
      */
     getPlaylistItems(playlistId: string): Promise<PlaylistItem[]>;
     /**
@@ -5635,9 +5712,17 @@ declare class VideoAPI {
      */
     cancelMembership(_channelId: string, membershipId: string): Promise<void>;
     /**
-     * Send a super chat
+     * Send a super chat to a channel.
+     *
+     * 백엔드는 `POST /v1/public/super-chats` 에 `channel_id`/`type`/`amount` 를 요구하고,
+     * `video_id` 또는 `live_id` 중 하나로 대상을 지정한다 (AppMember 인증 필수).
+     * 응답의 `client_secret` 으로 결제(Stripe)를 확정해야 슈퍼챗이 노출된다.
+     *
+     * @param channelId 슈퍼챗을 받을 채널 ID
+     * @param amount 금액(최소 단위 정수)
+     * @param options videoId 또는 liveId 중 하나로 대상 지정 + 종류/메시지/통화
      */
-    sendSuperChat(videoId: string, amount: number, message?: string, currency?: string): Promise<SuperChat>;
+    sendSuperChat(channelId: string, amount: number, options?: SendSuperChatOptions): Promise<SendSuperChatResponse>;
     /**
      * Get super chats for a video
      */
@@ -9020,4 +9105,4 @@ declare class ConnectBase {
     updateConfig(config: Partial<ConnectBaseConfig>): void;
 }
 
-export { AIAPI, type AIChatRequest, type AIChatResponse, type AIChatStreamCallbacks, type AIChatStreamOptions, type AIMessage, type AISource, type AIStreamChunk, type AITool, type AIToolCall, type AIToolEvent, AUTH_MEMBER_ID_TOKEN, type AckMessagesRequest, type AdMobDailyReport, type AdMobReportResponse, type AdMobReportSummary, type AdReportResponse, type AdReportSummary, type AdmobConnectionInfo, AdsAPI, type AdsenseConnectionInfo, type AgenticSearchProgress, type AggregateResult, type AggregateStage, type AnalyticsConfig, type AnalyticsEvent, ApiError, type ApiErrorDetail, type AppStatsResponse, type ArchivePolicy, type AtomicOperator, type AtomicOperatorType, AuthError, type AuthSettingsResponse, type BackupInfo, type BatchOperation, type BatchOperationResult, type BatchSetPageMetaRequest, type BatchWriteResult, type BillingCycle, type BillingKeyResponse, type BiometricInfo, type BiometricResult, type BulkCreateResponse, type BulkError, type CPUInfo, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChannelStats, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type CompleteUploadRequest, type CompleteUploadResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type ConsentOptions, type ConsumeMessagesResponse, type ConsumeOptions, type CopyTableRequest, type CopyTableResponse, type CreateBackupRequest, type CreateChannelRequest, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreateColumnRequest, type CreateDataRequest, type CreateDocumentRequest, type CreateFolderRequest, type CreateFolderResponse, type CreateGeoIndexRequest, type CreateIndexRequest, type CreateLobbyRequest, type CreatePlaylistRequest, type CreatePublicKeyRequest, type CreatePublicKeyResponse, type CreateRelationRequest, type CreateRoomResult, type CreateSearchIndexRequest, type CreateSecurityRuleRequest, type CreateSubscriptionRequest, type CreateTableRequest, type CreateTriggerRequest, type CreateVideoStorageRequest, type DailyReport, type DataItem, type DataType, type DatabaseChange, type DatabaseChangeMessage, type DatabaseChangeType, type DatabaseRealtimeConnectOptions, type DatabaseRealtimeFilter, type DatabaseRealtimeHandlers, type DatabaseRealtimeSubscription, type DatabaseSnapshot, type DatabaseSnapshotMessage, type DatabaseSubscribeOptions, type DeleteWhereResponse, type DeviceInfo, type DocumentResponse, type EnabledProviderInfo, type EnabledProvidersResponse, EndpointAPI, type EndpointCallInit, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type ExportDataRequest, type ExportDataResponse, type FetchDataResponse, type FetchFilesResponse, type FetchPublicKeysResponse, type FileItem, type FileStats, GameAPI, type GameAction, type GameClientConfig, type GameConfig, GameConfigAPI, type GameConfigPatch, type GameConnectionState, type GameConnectionStatus, type GameDelta, GameError, type GameErrorCode, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GenerateUploadURLByPathRequest, type GenerateUploadURLRequest, type GenerateUploadURLResponse, type GeoBoundingBox, type GeoIndex, type GeoNear, type GeoPoint, type GeoPolygon, type GeoQuery, type GeoResponse, type GeoResult, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type GuestMemberSignInResponse, GuestSessionConflictError, type HistoryResponse, type ICEServer, type ICEServersResponse, type ImageResult, type ImportDataRequest, type ImportDataResponse, type IndexAnalysis, type IndexRecommendation, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinQueueRequest, type JoinRoomRequest, type JoinRoomResponse, type KnowledgeSearchRequest, type KnowledgeSearchResponse, type KnowledgeSearchResult, type LeaderboardEntry, type LeaderboardListResponse, type LeaderboardScoreEntry, type LifecyclePolicy, type ListBillingKeysResponse, type ListDocumentsResponse, type ListPageMetasOptions, type ListPageMetasResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type LobbyInfo, type LobbyInvite, type LobbyMember, type LobbyVisibility, type MatchResult, type MatchmakingTicket, type MatchqueueListResponse, type MatchqueueTicket, type MemberInfoResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MemoryInfo, type MessageHandler, type MigrateDataRequest, type MigrateDataResponse, type MoveFileRequest, type NackMessageRequest, NativeAPI, type OAuthCallbackResponse, type OAuthProvider, type OpenDialogOptions, type OpenDialogResult, type PageMetaResponse, type PartyInfo, type PartyInvite, type PartyMember, type PauseSubscriptionRequest, type PaymentDetail, type PaymentProvider, type PaymentStatus, type PeerInfo, type Platform, type PlayerEvent, type PlayerStats, type Playlist, type PlaylistItem, type PollUntilOptions, type PongMessage, type PopulateOption, type Position, type PreparePaymentRequest, type PreparePaymentResponse, type PresenceChangeHandler, type PresenceInfo, type PresenceSetOptions, type PresenceStatus, type PresenceStatusResult, type PublicKeyItem, type PublishBatchRequest, type PublishBatchResponse, type PublishMessageRequest, type PublishMessageResponse, type PushPlatform, type QualityProgress, type QueryOptions, type QueueInfoResponse, type QueueMessage, type ReadReceiptHandler, type ReadReceiptInfo, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RelationType, type RenameFileRequest, type RenameFileResponse, type ReplayHighlight, type ReplayInfo, type ReplayPlayerInfo, type RestoreBackupRequest, type RestoreBackupResponse, type RetentionPolicy, type RoomInfo, type RoomStaleMessage, type RoomSummary, type RoomsResponse, type SaveDialogOptions, type SaveDialogResult, type ScriptDetailResponse, type ScriptListResponse, type ScriptMeta, type ScriptVersion, type ScriptVersionListResponse, type SearchIndex, type SearchOptions, type SearchResponse, type SearchResult, type SecurityRule, type SendOptions, type ServerMessage, SessionManager, type SetPageMetaRequest, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type SlowQueryInfo, type SpectatorInfo, type SpectatorPlayerState, type SpectatorState, type StateChange, type StateChangeHandler, type StorageUploadOptions, type StreamContentPart, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamImageURLPart, type StreamMessage, type StreamOptions, type StreamSession, type StreamTextPart, type StreamTokenCallback, type StreamToolCallCallback, type StreamToolResultCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type SystemInfo, type TTLConfig, type TableAccessLevel, type TableColumnDef, type TableIndex, type TableRelation, type TableSchema, type TableSchemaDefinition, type TokenPersistence, type TransactionRead, type TransactionResult, type TransactionWrite, type TransactionWriteResult, type TranscodeStatus, type TransportType, type Trigger, type TriggerEvent, type TriggerHandlerType, type TypingChangeHandler, type TypingInfo, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateCustomDataRequest, type UpdateCustomDataResponse, type UpdateDataRequest, type UpdateDocumentRequest, type UpdateLobbyRequest, type UpdatePublicKeyRequest, type UpdatePublicKeyResponse, type UpdateSecurityRuleRequest, type UpdateSubscriptionRequest, type UpdateTriggerRequest, type UpdateVideoRequest, type UpdateVideoStorageRequest, type UploadByPathOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type ValidateResponse, type ValidationSchema, type ValidationSchemaField, type ValidationStateTransitions, type Video, type VideoComment, type VideoCompleteUploadResponse, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoStorage, type VideoStorageListResponse, type VideoVisibility, type VoiceChannel, type VoiceMember, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, detectInAppBrowser, escapeToExternalBrowser, isWebTransportSupported, toCreateRoomWire };
+export { AIAPI, type AIChatRequest, type AIChatResponse, type AIChatStreamCallbacks, type AIChatStreamOptions, type AIMessage, type AISource, type AIStreamChunk, type AITool, type AIToolCall, type AIToolEvent, AUTH_MEMBER_ID_TOKEN, type AckMessagesRequest, type AdMobDailyReport, type AdMobReportResponse, type AdMobReportSummary, type AdReportResponse, type AdReportSummary, type AdmobConnectionInfo, AdsAPI, type AdsenseConnectionInfo, type AgenticSearchProgress, type AggregateResult, type AggregateStage, type AnalyticsConfig, type AnalyticsEvent, ApiError, type ApiErrorDetail, type AppStatsResponse, type ArchivePolicy, type AtomicOperator, type AtomicOperatorType, AuthError, type AuthSettingsResponse, type BackupInfo, type BatchOperation, type BatchOperationResult, type BatchSetPageMetaRequest, type BatchWriteResult, type BillingCycle, type BillingKeyResponse, type BiometricInfo, type BiometricResult, type BulkCreateResponse, type BulkError, type CPUInfo, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChannelStats, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type CompleteUploadRequest, type CompleteUploadResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type ConsentOptions, type ConsumeMessagesResponse, type ConsumeOptions, type CopyTableRequest, type CopyTableResponse, type CreateBackupRequest, type CreateChannelRequest, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreateColumnRequest, type CreateDataRequest, type CreateDocumentRequest, type CreateFolderRequest, type CreateFolderResponse, type CreateGeoIndexRequest, type CreateIndexRequest, type CreateLobbyRequest, type CreatePlaylistRequest, type CreatePublicKeyRequest, type CreatePublicKeyResponse, type CreateRelationRequest, type CreateRoomResult, type CreateSearchIndexRequest, type CreateSecurityRuleRequest, type CreateSubscriptionRequest, type CreateTableRequest, type CreateTriggerRequest, type CreateVideoStorageRequest, type DailyReport, type DataItem, type DataType, type DatabaseChange, type DatabaseChangeMessage, type DatabaseChangeType, type DatabaseRealtimeConnectOptions, type DatabaseRealtimeFilter, type DatabaseRealtimeHandlers, type DatabaseRealtimeSubscription, type DatabaseSnapshot, type DatabaseSnapshotMessage, type DatabaseSubscribeOptions, type DeleteWhereResponse, type DeviceInfo, type DocumentResponse, type EnabledProviderInfo, type EnabledProvidersResponse, EndpointAPI, type EndpointCallInit, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type ExportDataRequest, type ExportDataResponse, type FetchDataResponse, type FetchFilesResponse, type FetchPublicKeysResponse, type FileItem, type FileStats, GameAPI, type GameAction, type GameClientConfig, type GameConfig, GameConfigAPI, type GameConfigPatch, type GameConnectionState, type GameConnectionStatus, type GameDelta, GameError, type GameErrorCode, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GenerateUploadURLByPathRequest, type GenerateUploadURLRequest, type GenerateUploadURLResponse, type GeoBoundingBox, type GeoIndex, type GeoNear, type GeoPoint, type GeoPolygon, type GeoQuery, type GeoResponse, type GeoResult, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type GuestMemberSignInResponse, GuestSessionConflictError, type HistoryResponse, type ICEServer, type ICEServersResponse, type ImageResult, type ImportDataRequest, type ImportDataResponse, type IndexAnalysis, type IndexRecommendation, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinQueueRequest, type JoinRoomRequest, type JoinRoomResponse, type KnowledgeSearchRequest, type KnowledgeSearchResponse, type KnowledgeSearchResult, type LeaderboardEntry, type LeaderboardListResponse, type LeaderboardScoreEntry, type LifecyclePolicy, type ListBillingKeysResponse, type ListDocumentsResponse, type ListPageMetasOptions, type ListPageMetasResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type LobbyInfo, type LobbyInvite, type LobbyMember, type LobbyVisibility, type MatchResult, type MatchmakingTicket, type MatchqueueListResponse, type MatchqueueTicket, type MemberInfoResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MemoryInfo, type MessageHandler, type MigrateDataRequest, type MigrateDataResponse, type MoveFileRequest, type NackMessageRequest, NativeAPI, type OAuthCallbackResponse, type OAuthProvider, type OpenDialogOptions, type OpenDialogResult, type PageMetaResponse, type PartyInfo, type PartyInvite, type PartyMember, type PauseSubscriptionRequest, type PaymentDetail, type PaymentProvider, type PaymentStatus, type PeerInfo, type Platform, type PlayerEvent, type PlayerStats, type Playlist, type PlaylistItem, type PollUntilOptions, type PongMessage, type PopulateOption, type Position, type PreparePaymentRequest, type PreparePaymentResponse, type PresenceChangeHandler, type PresenceInfo, type PresenceSetOptions, type PresenceStatus, type PresenceStatusResult, type PublicKeyItem, type PublishBatchRequest, type PublishBatchResponse, type PublishMessageRequest, type PublishMessageResponse, type PushPlatform, type QualityProgress, type QueryOptions, type QueueInfoResponse, type QueueMessage, type ReadReceiptHandler, type ReadReceiptInfo, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RelationType, type RenameFileRequest, type RenameFileResponse, type ReplayHighlight, type ReplayInfo, type ReplayPlayerInfo, type RestoreBackupRequest, type RestoreBackupResponse, type RetentionPolicy, type RoomInfo, type RoomStaleMessage, type RoomSummary, type RoomsResponse, type SaveDialogOptions, type SaveDialogResult, type ScriptDetailResponse, type ScriptListResponse, type ScriptMeta, type ScriptVersion, type ScriptVersionListResponse, type SearchIndex, type SearchOptions, type SearchResponse, type SearchResult, type SecurityRule, type SendOptions, type SendSuperChatOptions, type SendSuperChatResponse, type ServerMessage, SessionManager, type SetPageMetaRequest, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type SlowQueryInfo, type SpectatorInfo, type SpectatorPlayerState, type SpectatorState, type StateChange, type StateChangeHandler, type StorageUploadOptions, type StreamContentPart, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamImageURLPart, type StreamMessage, type StreamOptions, type StreamSession, type StreamTextPart, type StreamTokenCallback, type StreamToolCallCallback, type StreamToolResultCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type SuperChatType, type SystemInfo, type TTLConfig, type TableAccessLevel, type TableColumnDef, type TableIndex, type TableRelation, type TableSchema, type TableSchemaDefinition, type TokenPersistence, type TransactionRead, type TransactionResult, type TransactionWrite, type TransactionWriteResult, type TranscodeStatus, type TransportType, type Trigger, type TriggerEvent, type TriggerHandlerType, type TypingChangeHandler, type TypingInfo, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateCustomDataRequest, type UpdateCustomDataResponse, type UpdateDataRequest, type UpdateDocumentRequest, type UpdateLobbyRequest, type UpdatePublicKeyRequest, type UpdatePublicKeyResponse, type UpdateSecurityRuleRequest, type UpdateSubscriptionRequest, type UpdateTriggerRequest, type UpdateVideoRequest, type UpdateVideoStorageRequest, type UploadByPathOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type ValidateResponse, type ValidationSchema, type ValidationSchemaField, type ValidationStateTransitions, type Video, type VideoComment, type VideoCompleteUploadResponse, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoStorage, type VideoStorageListResponse, type VideoVisibility, type VoiceChannel, type VoiceMember, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, detectInAppBrowser, escapeToExternalBrowser, isWebTransportSupported, toCreateRoomWire };

package/dist/index.d.ts

@@ -4932,6 +4932,24 @@ interface SendToMembersPayload {
     /** ISO8601 형식 예약 발송 시각. 미지정 시 즉시 발송. */
     scheduledAt?: string;
 }
+/**
+ * `cb.push.sendToTopic` 페이로드. 백엔드 `dto.SendPushToTopicRequest` 에 매핑되며,
+ * topic_name 은 메서드 인자로 받아 SDK 가 채운다. (members 발송과 달리 대상은 토픽 구독자 전체)
+ */
+interface SendToTopicPayload {
+    title: string;
+    body: string;
+    imageUrl?: string;
+    data?: Record<string, unknown>;
+    /** 'ios' | 'android' | 'web' 중 선택. 빈 배열/미지정 시 전체 플랫폼 발송. */
+    platforms?: Array<'ios' | 'android' | 'web'>;
+    /** TTL(초). 기본 86400 (24h). */
+    ttlSeconds?: number;
+    priority?: 'normal' | 'high';
+    clickAction?: string;
+    /** ISO8601 형식 예약 발송 시각. 미지정 시 즉시 발송. */
+    scheduledAt?: string;
+}
 /**
  * 발송 결과. 백엔드 `dto.SendResultResponse` 와 1:1 매핑.
  */
@@ -5106,6 +5124,33 @@ declare class PushAPI {
      * ```
      */
     sendToMembers(appId: string, memberIds: string[], payload: SendToMembersPayload): Promise<SendPushResult>;
+    /**
+     * 토픽 구독자 전체에게 푸시 알림을 발송한다 (서버 사이드 전용).
+     *
+     * 백엔드 라우트 `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)
+     * ```
+     */
+    sendToTopic(appId: string, topicName: string, payload: SendToTopicPayload): Promise<SendPushResult>;
     /**
      * 브라우저 고유 ID 생성 (localStorage에 저장)
      */
@@ -5421,6 +5466,35 @@ interface SuperChat {
     };
     created_at: string;
 }
+type SuperChatType = 'super_chat' | 'super_thanks' | 'super_sticker' | 'tip';
+/** sendSuperChat 옵션 — videoId 또는 liveId 중 하나로 대상을 지정한다. */
+interface SendSuperChatOptions {
+    /** 대상 영상 ID (videoId 또는 liveId 중 하나 필수) */
+    videoId?: string;
+    /** 대상 라이브 ID */
+    liveId?: string;
+    /** 슈퍼챗 종류 (기본 'super_thanks') */
+    type?: SuperChatType;
+    message?: string;
+    /** ISO 통화 코드 (기본 'USD') */
+    currency?: string;
+    stickerId?: string;
+}
+/**
+ * 슈퍼챗 전송 응답. `client_secret` 으로 결제(Stripe PaymentIntent)를 확정해야
+ * 슈퍼챗이 노출된다.
+ */
+interface SendSuperChatResponse {
+    super_chat_id: string;
+    client_secret: string;
+    amount: number;
+    currency: string;
+    platform_fee: number;
+    creator_amount: number;
+    display_duration: number;
+    color: string;
+    highlighted: boolean;
+}
 
 declare class VideoProcessingError extends Error {
     video?: Video;
@@ -5540,15 +5614,18 @@ declare class VideoAPI {
      */
     unsubscribeChannel(channelId: string): Promise<void>;
     /**
-     * Create a playlist
+     * Create a playlist for a channel.
+     * 백엔드는 `POST /v1/public/playlists` 에 body 로 `channel_id` 를 받는다 (AppMember 인증).
      */
     createPlaylist(channelId: string, data: CreatePlaylistRequest): Promise<Playlist>;
     /**
-     * Get playlists for a channel
+     * Get a channel's public playlists.
+     * 백엔드는 `GET /v1/public/playlists/public?channel_id=` 로 공개 플레이리스트를 반환한다.
      */
     getPlaylists(channelId: string): Promise<Playlist[]>;
     /**
-     * Get playlist items
+     * Get playlist items.
+     * 백엔드는 별도 items 라우트가 없고 `GET /v1/public/playlists/:id` 응답에 items 를 포함한다.
      */
     getPlaylistItems(playlistId: string): Promise<PlaylistItem[]>;
     /**
@@ -5635,9 +5712,17 @@ declare class VideoAPI {
      */
     cancelMembership(_channelId: string, membershipId: string): Promise<void>;
     /**
-     * Send a super chat
+     * Send a super chat to a channel.
+     *
+     * 백엔드는 `POST /v1/public/super-chats` 에 `channel_id`/`type`/`amount` 를 요구하고,
+     * `video_id` 또는 `live_id` 중 하나로 대상을 지정한다 (AppMember 인증 필수).
+     * 응답의 `client_secret` 으로 결제(Stripe)를 확정해야 슈퍼챗이 노출된다.
+     *
+     * @param channelId 슈퍼챗을 받을 채널 ID
+     * @param amount 금액(최소 단위 정수)
+     * @param options videoId 또는 liveId 중 하나로 대상 지정 + 종류/메시지/통화
      */
-    sendSuperChat(videoId: string, amount: number, message?: string, currency?: string): Promise<SuperChat>;
+    sendSuperChat(channelId: string, amount: number, options?: SendSuperChatOptions): Promise<SendSuperChatResponse>;
     /**
      * Get super chats for a video
      */
@@ -9020,4 +9105,4 @@ declare class ConnectBase {
     updateConfig(config: Partial<ConnectBaseConfig>): void;
 }
 
-export { AIAPI, type AIChatRequest, type AIChatResponse, type AIChatStreamCallbacks, type AIChatStreamOptions, type AIMessage, type AISource, type AIStreamChunk, type AITool, type AIToolCall, type AIToolEvent, AUTH_MEMBER_ID_TOKEN, type AckMessagesRequest, type AdMobDailyReport, type AdMobReportResponse, type AdMobReportSummary, type AdReportResponse, type AdReportSummary, type AdmobConnectionInfo, AdsAPI, type AdsenseConnectionInfo, type AgenticSearchProgress, type AggregateResult, type AggregateStage, type AnalyticsConfig, type AnalyticsEvent, ApiError, type ApiErrorDetail, type AppStatsResponse, type ArchivePolicy, type AtomicOperator, type AtomicOperatorType, AuthError, type AuthSettingsResponse, type BackupInfo, type BatchOperation, type BatchOperationResult, type BatchSetPageMetaRequest, type BatchWriteResult, type BillingCycle, type BillingKeyResponse, type BiometricInfo, type BiometricResult, type BulkCreateResponse, type BulkError, type CPUInfo, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChannelStats, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type CompleteUploadRequest, type CompleteUploadResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type ConsentOptions, type ConsumeMessagesResponse, type ConsumeOptions, type CopyTableRequest, type CopyTableResponse, type CreateBackupRequest, type CreateChannelRequest, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreateColumnRequest, type CreateDataRequest, type CreateDocumentRequest, type CreateFolderRequest, type CreateFolderResponse, type CreateGeoIndexRequest, type CreateIndexRequest, type CreateLobbyRequest, type CreatePlaylistRequest, type CreatePublicKeyRequest, type CreatePublicKeyResponse, type CreateRelationRequest, type CreateRoomResult, type CreateSearchIndexRequest, type CreateSecurityRuleRequest, type CreateSubscriptionRequest, type CreateTableRequest, type CreateTriggerRequest, type CreateVideoStorageRequest, type DailyReport, type DataItem, type DataType, type DatabaseChange, type DatabaseChangeMessage, type DatabaseChangeType, type DatabaseRealtimeConnectOptions, type DatabaseRealtimeFilter, type DatabaseRealtimeHandlers, type DatabaseRealtimeSubscription, type DatabaseSnapshot, type DatabaseSnapshotMessage, type DatabaseSubscribeOptions, type DeleteWhereResponse, type DeviceInfo, type DocumentResponse, type EnabledProviderInfo, type EnabledProvidersResponse, EndpointAPI, type EndpointCallInit, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type ExportDataRequest, type ExportDataResponse, type FetchDataResponse, type FetchFilesResponse, type FetchPublicKeysResponse, type FileItem, type FileStats, GameAPI, type GameAction, type GameClientConfig, type GameConfig, GameConfigAPI, type GameConfigPatch, type GameConnectionState, type GameConnectionStatus, type GameDelta, GameError, type GameErrorCode, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GenerateUploadURLByPathRequest, type GenerateUploadURLRequest, type GenerateUploadURLResponse, type GeoBoundingBox, type GeoIndex, type GeoNear, type GeoPoint, type GeoPolygon, type GeoQuery, type GeoResponse, type GeoResult, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type GuestMemberSignInResponse, GuestSessionConflictError, type HistoryResponse, type ICEServer, type ICEServersResponse, type ImageResult, type ImportDataRequest, type ImportDataResponse, type IndexAnalysis, type IndexRecommendation, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinQueueRequest, type JoinRoomRequest, type JoinRoomResponse, type KnowledgeSearchRequest, type KnowledgeSearchResponse, type KnowledgeSearchResult, type LeaderboardEntry, type LeaderboardListResponse, type LeaderboardScoreEntry, type LifecyclePolicy, type ListBillingKeysResponse, type ListDocumentsResponse, type ListPageMetasOptions, type ListPageMetasResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type LobbyInfo, type LobbyInvite, type LobbyMember, type LobbyVisibility, type MatchResult, type MatchmakingTicket, type MatchqueueListResponse, type MatchqueueTicket, type MemberInfoResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MemoryInfo, type MessageHandler, type MigrateDataRequest, type MigrateDataResponse, type MoveFileRequest, type NackMessageRequest, NativeAPI, type OAuthCallbackResponse, type OAuthProvider, type OpenDialogOptions, type OpenDialogResult, type PageMetaResponse, type PartyInfo, type PartyInvite, type PartyMember, type PauseSubscriptionRequest, type PaymentDetail, type PaymentProvider, type PaymentStatus, type PeerInfo, type Platform, type PlayerEvent, type PlayerStats, type Playlist, type PlaylistItem, type PollUntilOptions, type PongMessage, type PopulateOption, type Position, type PreparePaymentRequest, type PreparePaymentResponse, type PresenceChangeHandler, type PresenceInfo, type PresenceSetOptions, type PresenceStatus, type PresenceStatusResult, type PublicKeyItem, type PublishBatchRequest, type PublishBatchResponse, type PublishMessageRequest, type PublishMessageResponse, type PushPlatform, type QualityProgress, type QueryOptions, type QueueInfoResponse, type QueueMessage, type ReadReceiptHandler, type ReadReceiptInfo, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RelationType, type RenameFileRequest, type RenameFileResponse, type ReplayHighlight, type ReplayInfo, type ReplayPlayerInfo, type RestoreBackupRequest, type RestoreBackupResponse, type RetentionPolicy, type RoomInfo, type RoomStaleMessage, type RoomSummary, type RoomsResponse, type SaveDialogOptions, type SaveDialogResult, type ScriptDetailResponse, type ScriptListResponse, type ScriptMeta, type ScriptVersion, type ScriptVersionListResponse, type SearchIndex, type SearchOptions, type SearchResponse, type SearchResult, type SecurityRule, type SendOptions, type ServerMessage, SessionManager, type SetPageMetaRequest, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type SlowQueryInfo, type SpectatorInfo, type SpectatorPlayerState, type SpectatorState, type StateChange, type StateChangeHandler, type StorageUploadOptions, type StreamContentPart, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamImageURLPart, type StreamMessage, type StreamOptions, type StreamSession, type StreamTextPart, type StreamTokenCallback, type StreamToolCallCallback, type StreamToolResultCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type SystemInfo, type TTLConfig, type TableAccessLevel, type TableColumnDef, type TableIndex, type TableRelation, type TableSchema, type TableSchemaDefinition, type TokenPersistence, type TransactionRead, type TransactionResult, type TransactionWrite, type TransactionWriteResult, type TranscodeStatus, type TransportType, type Trigger, type TriggerEvent, type TriggerHandlerType, type TypingChangeHandler, type TypingInfo, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateCustomDataRequest, type UpdateCustomDataResponse, type UpdateDataRequest, type UpdateDocumentRequest, type UpdateLobbyRequest, type UpdatePublicKeyRequest, type UpdatePublicKeyResponse, type UpdateSecurityRuleRequest, type UpdateSubscriptionRequest, type UpdateTriggerRequest, type UpdateVideoRequest, type UpdateVideoStorageRequest, type UploadByPathOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type ValidateResponse, type ValidationSchema, type ValidationSchemaField, type ValidationStateTransitions, type Video, type VideoComment, type VideoCompleteUploadResponse, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoStorage, type VideoStorageListResponse, type VideoVisibility, type VoiceChannel, type VoiceMember, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, detectInAppBrowser, escapeToExternalBrowser, isWebTransportSupported, toCreateRoomWire };
+export { AIAPI, type AIChatRequest, type AIChatResponse, type AIChatStreamCallbacks, type AIChatStreamOptions, type AIMessage, type AISource, type AIStreamChunk, type AITool, type AIToolCall, type AIToolEvent, AUTH_MEMBER_ID_TOKEN, type AckMessagesRequest, type AdMobDailyReport, type AdMobReportResponse, type AdMobReportSummary, type AdReportResponse, type AdReportSummary, type AdmobConnectionInfo, AdsAPI, type AdsenseConnectionInfo, type AgenticSearchProgress, type AggregateResult, type AggregateStage, type AnalyticsConfig, type AnalyticsEvent, ApiError, type ApiErrorDetail, type AppStatsResponse, type ArchivePolicy, type AtomicOperator, type AtomicOperatorType, AuthError, type AuthSettingsResponse, type BackupInfo, type BatchOperation, type BatchOperationResult, type BatchSetPageMetaRequest, type BatchWriteResult, type BillingCycle, type BillingKeyResponse, type BiometricInfo, type BiometricResult, type BulkCreateResponse, type BulkError, type CPUInfo, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChannelStats, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type CompleteUploadRequest, type CompleteUploadResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type ConsentOptions, type ConsumeMessagesResponse, type ConsumeOptions, type CopyTableRequest, type CopyTableResponse, type CreateBackupRequest, type CreateChannelRequest, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreateColumnRequest, type CreateDataRequest, type CreateDocumentRequest, type CreateFolderRequest, type CreateFolderResponse, type CreateGeoIndexRequest, type CreateIndexRequest, type CreateLobbyRequest, type CreatePlaylistRequest, type CreatePublicKeyRequest, type CreatePublicKeyResponse, type CreateRelationRequest, type CreateRoomResult, type CreateSearchIndexRequest, type CreateSecurityRuleRequest, type CreateSubscriptionRequest, type CreateTableRequest, type CreateTriggerRequest, type CreateVideoStorageRequest, type DailyReport, type DataItem, type DataType, type DatabaseChange, type DatabaseChangeMessage, type DatabaseChangeType, type DatabaseRealtimeConnectOptions, type DatabaseRealtimeFilter, type DatabaseRealtimeHandlers, type DatabaseRealtimeSubscription, type DatabaseSnapshot, type DatabaseSnapshotMessage, type DatabaseSubscribeOptions, type DeleteWhereResponse, type DeviceInfo, type DocumentResponse, type EnabledProviderInfo, type EnabledProvidersResponse, EndpointAPI, type EndpointCallInit, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type ExportDataRequest, type ExportDataResponse, type FetchDataResponse, type FetchFilesResponse, type FetchPublicKeysResponse, type FileItem, type FileStats, GameAPI, type GameAction, type GameClientConfig, type GameConfig, GameConfigAPI, type GameConfigPatch, type GameConnectionState, type GameConnectionStatus, type GameDelta, GameError, type GameErrorCode, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GenerateUploadURLByPathRequest, type GenerateUploadURLRequest, type GenerateUploadURLResponse, type GeoBoundingBox, type GeoIndex, type GeoNear, type GeoPoint, type GeoPolygon, type GeoQuery, type GeoResponse, type GeoResult, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type GuestMemberSignInResponse, GuestSessionConflictError, type HistoryResponse, type ICEServer, type ICEServersResponse, type ImageResult, type ImportDataRequest, type ImportDataResponse, type IndexAnalysis, type IndexRecommendation, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinQueueRequest, type JoinRoomRequest, type JoinRoomResponse, type KnowledgeSearchRequest, type KnowledgeSearchResponse, type KnowledgeSearchResult, type LeaderboardEntry, type LeaderboardListResponse, type LeaderboardScoreEntry, type LifecyclePolicy, type ListBillingKeysResponse, type ListDocumentsResponse, type ListPageMetasOptions, type ListPageMetasResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type LobbyInfo, type LobbyInvite, type LobbyMember, type LobbyVisibility, type MatchResult, type MatchmakingTicket, type MatchqueueListResponse, type MatchqueueTicket, type MemberInfoResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MemoryInfo, type MessageHandler, type MigrateDataRequest, type MigrateDataResponse, type MoveFileRequest, type NackMessageRequest, NativeAPI, type OAuthCallbackResponse, type OAuthProvider, type OpenDialogOptions, type OpenDialogResult, type PageMetaResponse, type PartyInfo, type PartyInvite, type PartyMember, type PauseSubscriptionRequest, type PaymentDetail, type PaymentProvider, type PaymentStatus, type PeerInfo, type Platform, type PlayerEvent, type PlayerStats, type Playlist, type PlaylistItem, type PollUntilOptions, type PongMessage, type PopulateOption, type Position, type PreparePaymentRequest, type PreparePaymentResponse, type PresenceChangeHandler, type PresenceInfo, type PresenceSetOptions, type PresenceStatus, type PresenceStatusResult, type PublicKeyItem, type PublishBatchRequest, type PublishBatchResponse, type PublishMessageRequest, type PublishMessageResponse, type PushPlatform, type QualityProgress, type QueryOptions, type QueueInfoResponse, type QueueMessage, type ReadReceiptHandler, type ReadReceiptInfo, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RelationType, type RenameFileRequest, type RenameFileResponse, type ReplayHighlight, type ReplayInfo, type ReplayPlayerInfo, type RestoreBackupRequest, type RestoreBackupResponse, type RetentionPolicy, type RoomInfo, type RoomStaleMessage, type RoomSummary, type RoomsResponse, type SaveDialogOptions, type SaveDialogResult, type ScriptDetailResponse, type ScriptListResponse, type ScriptMeta, type ScriptVersion, type ScriptVersionListResponse, type SearchIndex, type SearchOptions, type SearchResponse, type SearchResult, type SecurityRule, type SendOptions, type SendSuperChatOptions, type SendSuperChatResponse, type ServerMessage, SessionManager, type SetPageMetaRequest, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type SlowQueryInfo, type SpectatorInfo, type SpectatorPlayerState, type SpectatorState, type StateChange, type StateChangeHandler, type StorageUploadOptions, type StreamContentPart, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamImageURLPart, type StreamMessage, type StreamOptions, type StreamSession, type StreamTextPart, type StreamTokenCallback, type StreamToolCallCallback, type StreamToolResultCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type SuperChatType, type SystemInfo, type TTLConfig, type TableAccessLevel, type TableColumnDef, type TableIndex, type TableRelation, type TableSchema, type TableSchemaDefinition, type TokenPersistence, type TransactionRead, type TransactionResult, type TransactionWrite, type TransactionWriteResult, type TranscodeStatus, type TransportType, type Trigger, type TriggerEvent, type TriggerHandlerType, type TypingChangeHandler, type TypingInfo, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateCustomDataRequest, type UpdateCustomDataResponse, type UpdateDataRequest, type UpdateDocumentRequest, type UpdateLobbyRequest, type UpdatePublicKeyRequest, type UpdatePublicKeyResponse, type UpdateSecurityRuleRequest, type UpdateSubscriptionRequest, type UpdateTriggerRequest, type UpdateVideoRequest, type UpdateVideoStorageRequest, type UploadByPathOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type ValidateResponse, type ValidationSchema, type ValidationSchemaField, type ValidationStateTransitions, type Video, type VideoComment, type VideoCompleteUploadResponse, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoStorage, type VideoStorageListResponse, type VideoVisibility, type VoiceChannel, type VoiceMember, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, detectInAppBrowser, escapeToExternalBrowser, isWebTransportSupported, toCreateRoomWire };

package/dist/index.js

@@ -6201,6 +6201,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에 저장)
@@ -6720,31 +6769,37 @@ var VideoAPI = class {
   }
   // ========== Playlist Operations ==========
   /**
-   * Create a playlist
+   * Create a playlist for a channel.
+   * 백엔드는 `POST /v1/public/playlists` 에 body 로 `channel_id` 를 받는다 (AppMember 인증).
    */
   async createPlaylist(channelId, data) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/channels/${channelId}/playlists`, data);
+    return this.videoFetch("POST", `${prefix}/playlists`, {
+      ...data,
+      channel_id: channelId
+    });
   }
   /**
-   * Get playlists for a channel
+   * Get a channel's public playlists.
+   * 백엔드는 `GET /v1/public/playlists/public?channel_id=` 로 공개 플레이리스트를 반환한다.
    */
   async getPlaylists(channelId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/channels/${channelId}/playlists`
+      `${prefix}/playlists/public?channel_id=${encodeURIComponent(channelId)}`
     );
     return response.playlists;
   }
   /**
-   * Get playlist items
+   * Get playlist items.
+   * 백엔드는 별도 items 라우트가 없고 `GET /v1/public/playlists/:id` 응답에 items 를 포함한다.
    */
   async getPlaylistItems(playlistId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/playlists/${playlistId}/items`
+      `${prefix}/playlists/${playlistId}`
     );
     return response.items;
   }
@@ -6909,14 +6964,27 @@ var VideoAPI = class {
   }
   // ========== Super Chat Operations ==========
   /**
-   * Send a super chat
+   * Send a super chat to a channel.
+   *
+   * 백엔드는 `POST /v1/public/super-chats` 에 `channel_id`/`type`/`amount` 를 요구하고,
+   * `video_id` 또는 `live_id` 중 하나로 대상을 지정한다 (AppMember 인증 필수).
+   * 응답의 `client_secret` 으로 결제(Stripe)를 확정해야 슈퍼챗이 노출된다.
+   *
+   * @param channelId 슈퍼챗을 받을 채널 ID
+   * @param amount 금액(최소 단위 정수)
+   * @param options videoId 또는 liveId 중 하나로 대상 지정 + 종류/메시지/통화
    */
-  async sendSuperChat(videoId, amount, message, currency) {
+  async sendSuperChat(channelId, amount, options) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/videos/${videoId}/super-chats`, {
+    return this.videoFetch("POST", `${prefix}/super-chats`, {
+      channel_id: channelId,
+      type: options?.type ?? "super_thanks",
       amount,
-      message,
-      currency: currency || "USD"
+      video_id: options?.videoId,
+      live_id: options?.liveId,
+      currency: options?.currency ?? "USD",
+      message: options?.message,
+      sticker_id: options?.stickerId
     });
   }
   /**

package/dist/index.mjs

@@ -6155,6 +6155,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에 저장)
@@ -6674,31 +6723,37 @@ var VideoAPI = class {
   }
   // ========== Playlist Operations ==========
   /**
-   * Create a playlist
+   * Create a playlist for a channel.
+   * 백엔드는 `POST /v1/public/playlists` 에 body 로 `channel_id` 를 받는다 (AppMember 인증).
    */
   async createPlaylist(channelId, data) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/channels/${channelId}/playlists`, data);
+    return this.videoFetch("POST", `${prefix}/playlists`, {
+      ...data,
+      channel_id: channelId
+    });
   }
   /**
-   * Get playlists for a channel
+   * Get a channel's public playlists.
+   * 백엔드는 `GET /v1/public/playlists/public?channel_id=` 로 공개 플레이리스트를 반환한다.
    */
   async getPlaylists(channelId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/channels/${channelId}/playlists`
+      `${prefix}/playlists/public?channel_id=${encodeURIComponent(channelId)}`
     );
     return response.playlists;
   }
   /**
-   * Get playlist items
+   * Get playlist items.
+   * 백엔드는 별도 items 라우트가 없고 `GET /v1/public/playlists/:id` 응답에 items 를 포함한다.
    */
   async getPlaylistItems(playlistId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/playlists/${playlistId}/items`
+      `${prefix}/playlists/${playlistId}`
     );
     return response.items;
   }
@@ -6863,14 +6918,27 @@ var VideoAPI = class {
   }
   // ========== Super Chat Operations ==========
   /**
-   * Send a super chat
+   * Send a super chat to a channel.
+   *
+   * 백엔드는 `POST /v1/public/super-chats` 에 `channel_id`/`type`/`amount` 를 요구하고,
+   * `video_id` 또는 `live_id` 중 하나로 대상을 지정한다 (AppMember 인증 필수).
+   * 응답의 `client_secret` 으로 결제(Stripe)를 확정해야 슈퍼챗이 노출된다.
+   *
+   * @param channelId 슈퍼챗을 받을 채널 ID
+   * @param amount 금액(최소 단위 정수)
+   * @param options videoId 또는 liveId 중 하나로 대상 지정 + 종류/메시지/통화
    */
-  async sendSuperChat(videoId, amount, message, currency) {
+  async sendSuperChat(channelId, amount, options) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/videos/${videoId}/super-chats`, {
+    return this.videoFetch("POST", `${prefix}/super-chats`, {
+      channel_id: channelId,
+      type: options?.type ?? "super_thanks",
       amount,
-      message,
-      currency: currency || "USD"
+      video_id: options?.videoId,
+      live_id: options?.liveId,
+      currency: options?.currency ?? "USD",
+      message: options?.message,
+      sticker_id: options?.stickerId
     });
   }
   /**

package/package.json

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