connectbase-client 0.3.0 → 0.3.2

package/dist/index.d.mts

@@ -392,6 +392,28 @@ interface RenameFileResponse {
 interface FetchFilesResponse {
     files: FileItem[];
 }
+/**
+ * 경로 기반 업로드 옵션
+ */
+interface UploadByPathOptions {
+    /** true면 기존 파일 덮어쓰기 (기본값: true) */
+    overwrite?: boolean;
+}
+/**
+ * 경로로 파일 조회 응답
+ */
+interface GetFileByPathResponse {
+    id: string;
+    name: string;
+    path: string;
+    type: string;
+    mime_type: string;
+    size: number;
+    url: string;
+    parent_id?: string;
+    created_at: string;
+    updated_at: string;
+}
 
 declare class StorageAPI {
     private http;
@@ -436,6 +458,51 @@ declare class StorageAPI {
      * 이미지 파일 여부 확인
      */
     isImageFile(file: FileItem): boolean;
+    /**
+     * 경로 기반 파일 업로드 (Firebase Storage 스타일)
+     *
+     * 같은 경로에 파일이 이미 존재하면 덮어쓰기합니다.
+     * URL이 변경되지 않아 고정 URL이 필요한 경우에 유용합니다.
+     *
+     * @example
+     * ```ts
+     * // 프로필 이미지 업로드 (항상 같은 URL 유지)
+     * const result = await storage.uploadByPath(
+     *   storageId,
+     *   '/profiles/user123/avatar.png',
+     *   file
+     * )
+     * console.log(result.url) // 항상 동일한 URL
+     *
+     * // 같은 경로로 다시 업로드하면 파일만 교체
+     * await storage.uploadByPath(storageId, '/profiles/user123/avatar.png', newFile)
+     * ```
+     */
+    uploadByPath(storageId: string, path: string, file: File, options?: UploadByPathOptions): Promise<UploadFileResponse>;
+    /**
+     * 경로로 파일 조회
+     *
+     * @example
+     * ```ts
+     * const file = await storage.getByPath(storageId, '/profiles/user123/avatar.png')
+     * console.log(file.url) // 파일의 공개 URL
+     * ```
+     */
+    getByPath(storageId: string, path: string): Promise<GetFileByPathResponse>;
+    /**
+     * 경로로 파일 URL 가져오기
+     *
+     * 파일이 존재하지 않으면 null 반환
+     *
+     * @example
+     * ```ts
+     * const url = await storage.getUrlByPath(storageId, '/profiles/user123/avatar.png')
+     * if (url) {
+     *   console.log('이미지 URL:', url)
+     * }
+     * ```
+     */
+    getUrlByPath(storageId: string, path: string): Promise<string | null>;
 }
 
 /**
@@ -2996,6 +3063,83 @@ declare class GameAPI {
     private getHeaders;
 }
 
+interface GoogleConnectionStatus {
+    is_connected: boolean;
+    email?: string;
+    adsense_account_id?: string;
+}
+interface AdReportSummary {
+    total_earnings: number;
+    total_impressions: number;
+    total_clicks: number;
+    ctr: number;
+    cpc: number;
+    rpm: number;
+}
+interface DailyReport {
+    date: string;
+    earnings: number;
+    impressions: number;
+    clicks: number;
+    ctr: number;
+}
+interface AdReportResponse {
+    summary: AdReportSummary;
+    daily: DailyReport[];
+}
+declare class AdsAPI {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * API Key 인증 시 /v1/public 접두사 반환
+     */
+    private getPublicPrefix;
+    /**
+     * AdSense 연결 상태 확인
+     *
+     * @returns 연결 상태, 이메일, AdSense 계정 ID
+     *
+     * @example
+     * ```typescript
+     * const status = await cb.ads.getConnectionStatus()
+     * if (status.is_connected) {
+     *     console.log('연결됨:', status.email)
+     * }
+     * ```
+     */
+    getConnectionStatus(): Promise<GoogleConnectionStatus>;
+    /**
+     * AdSense 리포트 조회 (일별 데이터 + 요약)
+     *
+     * @param startDate - 시작일 (YYYY-MM-DD), 미지정 시 최근 30일
+     * @param endDate - 종료일 (YYYY-MM-DD), 미지정 시 최근 30일
+     * @returns 요약 + 일별 데이터
+     *
+     * @example
+     * ```typescript
+     * const report = await cb.ads.getReport('2025-01-01', '2025-01-31')
+     * console.log('총 수익:', report.summary.total_earnings)
+     * report.daily.forEach(day => {
+     *     console.log(`${day.date}: $${day.earnings}`)
+     * })
+     * ```
+     */
+    getReport(startDate?: string, endDate?: string): Promise<AdReportResponse>;
+    /**
+     * 최근 30일 AdSense 요약 조회
+     *
+     * @returns 30일 합산 수익, 노출, 클릭, CTR, CPC, RPM
+     *
+     * @example
+     * ```typescript
+     * const summary = await cb.ads.getReportSummary()
+     * console.log(`총 수익: $${summary.total_earnings}`)
+     * console.log(`RPM: $${summary.rpm}`)
+     * ```
+     */
+    getReportSummary(): Promise<AdReportSummary>;
+}
+
 /**
  * WebTransport-based Game Client
  *
@@ -3271,6 +3415,10 @@ declare class ConnectBase {
      * 게임 API (실시간 멀티플레이어)
      */
     readonly game: GameAPI;
+    /**
+     * 광고 API (Google AdSense)
+     */
+    readonly ads: AdsAPI;
     constructor(config?: ConnectBaseConfig);
     /**
      * 수동으로 토큰 설정 (기존 토큰으로 세션 복원 시)
@@ -3286,4 +3434,4 @@ declare class ConnectBase {
     updateConfig(config: Partial<ConnectBaseConfig>): void;
 }
 
-export { ApiError, type ApiKeyItem, type AppStatsResponse, AuthError, type AuthSettingsResponse, type BillingCycle, type BillingKeyResponse, type BulkCreateResponse, type BulkError, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateChannelRequest, type CreateColumnRequest, type CreateDataRequest, type CreateFolderRequest, type CreateFolderResponse, type CreatePlaylistRequest, type CreateSubscriptionRequest, type CreateTableRequest, type DataItem, type DataType, type DeleteWhereResponse, type DeviceInfo, type EnabledProviderInfo, type EnabledProvidersResponse, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type FetchApiKeysResponse, type FetchDataResponse, type FetchFilesResponse, type FileItem, GameAPI, type GameAction, type GameClientConfig, type GameConnectionState, type GameConnectionStatus, type GameDelta, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GetAuthorizationURLResponse, type GuestMemberSignInResponse, type HistoryResponse, type ICEServer, type ICEServersResponse, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinRoomRequest, type JoinRoomResponse, type ListBillingKeysResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MessageHandler, type MoveFileRequest, type OAuthCallbackResponse, type OAuthProvider, type PauseSubscriptionRequest, type PaymentDetail, type PaymentStatus, type PeerInfo, type PlayerEvent, type Playlist, type PlaylistItem, type PongMessage, type PreparePaymentRequest, type PreparePaymentResponse, type PushPlatform, type QualityProgress, type QueryOptions, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RenameFileRequest, type RenameFileResponse, type RoomInfo, type RoomStats, type RoomsResponse, type SendOptions, type ServerMessage, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type StateChange, type StateChangeHandler, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamMessage, type StreamOptions, type StreamSession, type StreamTokenCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type TableSchema, type TranscodeStatus, type TransportType, type UpdateApiKeyRequest, type UpdateApiKeyResponse, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateDataRequest, type UpdateSubscriptionRequest, type UpdateVideoRequest, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type Video, type VideoComment, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoVisibility, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, isWebTransportSupported };
+export { type AdReportResponse, type AdReportSummary, AdsAPI, ApiError, type ApiKeyItem, type AppStatsResponse, AuthError, type AuthSettingsResponse, type BillingCycle, type BillingKeyResponse, type BulkCreateResponse, type BulkError, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateChannelRequest, type CreateColumnRequest, type CreateDataRequest, type CreateFolderRequest, type CreateFolderResponse, type CreatePlaylistRequest, type CreateSubscriptionRequest, type CreateTableRequest, type DailyReport, type DataItem, type DataType, type DeleteWhereResponse, type DeviceInfo, type EnabledProviderInfo, type EnabledProvidersResponse, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type FetchApiKeysResponse, type FetchDataResponse, type FetchFilesResponse, type FileItem, GameAPI, type GameAction, type GameClientConfig, type GameConnectionState, type GameConnectionStatus, type GameDelta, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type GuestMemberSignInResponse, type HistoryResponse, type ICEServer, type ICEServersResponse, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinRoomRequest, type JoinRoomResponse, type ListBillingKeysResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MessageHandler, type MoveFileRequest, type OAuthCallbackResponse, type OAuthProvider, type PauseSubscriptionRequest, type PaymentDetail, type PaymentStatus, type PeerInfo, type PlayerEvent, type Playlist, type PlaylistItem, type PongMessage, type PreparePaymentRequest, type PreparePaymentResponse, type PushPlatform, type QualityProgress, type QueryOptions, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RenameFileRequest, type RenameFileResponse, type RoomInfo, type RoomStats, type RoomsResponse, type SendOptions, type ServerMessage, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type StateChange, type StateChangeHandler, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamMessage, type StreamOptions, type StreamSession, type StreamTokenCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type TableSchema, type TranscodeStatus, type TransportType, type UpdateApiKeyRequest, type UpdateApiKeyResponse, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateDataRequest, type UpdateSubscriptionRequest, type UpdateVideoRequest, type UploadByPathOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type Video, type VideoComment, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoVisibility, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, isWebTransportSupported };

package/dist/index.d.ts

@@ -392,6 +392,28 @@ interface RenameFileResponse {
 interface FetchFilesResponse {
     files: FileItem[];
 }
+/**
+ * 경로 기반 업로드 옵션
+ */
+interface UploadByPathOptions {
+    /** true면 기존 파일 덮어쓰기 (기본값: true) */
+    overwrite?: boolean;
+}
+/**
+ * 경로로 파일 조회 응답
+ */
+interface GetFileByPathResponse {
+    id: string;
+    name: string;
+    path: string;
+    type: string;
+    mime_type: string;
+    size: number;
+    url: string;
+    parent_id?: string;
+    created_at: string;
+    updated_at: string;
+}
 
 declare class StorageAPI {
     private http;
@@ -436,6 +458,51 @@ declare class StorageAPI {
      * 이미지 파일 여부 확인
      */
     isImageFile(file: FileItem): boolean;
+    /**
+     * 경로 기반 파일 업로드 (Firebase Storage 스타일)
+     *
+     * 같은 경로에 파일이 이미 존재하면 덮어쓰기합니다.
+     * URL이 변경되지 않아 고정 URL이 필요한 경우에 유용합니다.
+     *
+     * @example
+     * ```ts
+     * // 프로필 이미지 업로드 (항상 같은 URL 유지)
+     * const result = await storage.uploadByPath(
+     *   storageId,
+     *   '/profiles/user123/avatar.png',
+     *   file
+     * )
+     * console.log(result.url) // 항상 동일한 URL
+     *
+     * // 같은 경로로 다시 업로드하면 파일만 교체
+     * await storage.uploadByPath(storageId, '/profiles/user123/avatar.png', newFile)
+     * ```
+     */
+    uploadByPath(storageId: string, path: string, file: File, options?: UploadByPathOptions): Promise<UploadFileResponse>;
+    /**
+     * 경로로 파일 조회
+     *
+     * @example
+     * ```ts
+     * const file = await storage.getByPath(storageId, '/profiles/user123/avatar.png')
+     * console.log(file.url) // 파일의 공개 URL
+     * ```
+     */
+    getByPath(storageId: string, path: string): Promise<GetFileByPathResponse>;
+    /**
+     * 경로로 파일 URL 가져오기
+     *
+     * 파일이 존재하지 않으면 null 반환
+     *
+     * @example
+     * ```ts
+     * const url = await storage.getUrlByPath(storageId, '/profiles/user123/avatar.png')
+     * if (url) {
+     *   console.log('이미지 URL:', url)
+     * }
+     * ```
+     */
+    getUrlByPath(storageId: string, path: string): Promise<string | null>;
 }
 
 /**
@@ -2996,6 +3063,83 @@ declare class GameAPI {
     private getHeaders;
 }
 
+interface GoogleConnectionStatus {
+    is_connected: boolean;
+    email?: string;
+    adsense_account_id?: string;
+}
+interface AdReportSummary {
+    total_earnings: number;
+    total_impressions: number;
+    total_clicks: number;
+    ctr: number;
+    cpc: number;
+    rpm: number;
+}
+interface DailyReport {
+    date: string;
+    earnings: number;
+    impressions: number;
+    clicks: number;
+    ctr: number;
+}
+interface AdReportResponse {
+    summary: AdReportSummary;
+    daily: DailyReport[];
+}
+declare class AdsAPI {
+    private http;
+    constructor(http: HttpClient);
+    /**
+     * API Key 인증 시 /v1/public 접두사 반환
+     */
+    private getPublicPrefix;
+    /**
+     * AdSense 연결 상태 확인
+     *
+     * @returns 연결 상태, 이메일, AdSense 계정 ID
+     *
+     * @example
+     * ```typescript
+     * const status = await cb.ads.getConnectionStatus()
+     * if (status.is_connected) {
+     *     console.log('연결됨:', status.email)
+     * }
+     * ```
+     */
+    getConnectionStatus(): Promise<GoogleConnectionStatus>;
+    /**
+     * AdSense 리포트 조회 (일별 데이터 + 요약)
+     *
+     * @param startDate - 시작일 (YYYY-MM-DD), 미지정 시 최근 30일
+     * @param endDate - 종료일 (YYYY-MM-DD), 미지정 시 최근 30일
+     * @returns 요약 + 일별 데이터
+     *
+     * @example
+     * ```typescript
+     * const report = await cb.ads.getReport('2025-01-01', '2025-01-31')
+     * console.log('총 수익:', report.summary.total_earnings)
+     * report.daily.forEach(day => {
+     *     console.log(`${day.date}: $${day.earnings}`)
+     * })
+     * ```
+     */
+    getReport(startDate?: string, endDate?: string): Promise<AdReportResponse>;
+    /**
+     * 최근 30일 AdSense 요약 조회
+     *
+     * @returns 30일 합산 수익, 노출, 클릭, CTR, CPC, RPM
+     *
+     * @example
+     * ```typescript
+     * const summary = await cb.ads.getReportSummary()
+     * console.log(`총 수익: $${summary.total_earnings}`)
+     * console.log(`RPM: $${summary.rpm}`)
+     * ```
+     */
+    getReportSummary(): Promise<AdReportSummary>;
+}
+
 /**
  * WebTransport-based Game Client
  *
@@ -3271,6 +3415,10 @@ declare class ConnectBase {
      * 게임 API (실시간 멀티플레이어)
      */
     readonly game: GameAPI;
+    /**
+     * 광고 API (Google AdSense)
+     */
+    readonly ads: AdsAPI;
     constructor(config?: ConnectBaseConfig);
     /**
      * 수동으로 토큰 설정 (기존 토큰으로 세션 복원 시)
@@ -3286,4 +3434,4 @@ declare class ConnectBase {
     updateConfig(config: Partial<ConnectBaseConfig>): void;
 }
 
-export { ApiError, type ApiKeyItem, type AppStatsResponse, AuthError, type AuthSettingsResponse, type BillingCycle, type BillingKeyResponse, type BulkCreateResponse, type BulkError, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateChannelRequest, type CreateColumnRequest, type CreateDataRequest, type CreateFolderRequest, type CreateFolderResponse, type CreatePlaylistRequest, type CreateSubscriptionRequest, type CreateTableRequest, type DataItem, type DataType, type DeleteWhereResponse, type DeviceInfo, type EnabledProviderInfo, type EnabledProvidersResponse, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type FetchApiKeysResponse, type FetchDataResponse, type FetchFilesResponse, type FileItem, GameAPI, type GameAction, type GameClientConfig, type GameConnectionState, type GameConnectionStatus, type GameDelta, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GetAuthorizationURLResponse, type GuestMemberSignInResponse, type HistoryResponse, type ICEServer, type ICEServersResponse, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinRoomRequest, type JoinRoomResponse, type ListBillingKeysResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MessageHandler, type MoveFileRequest, type OAuthCallbackResponse, type OAuthProvider, type PauseSubscriptionRequest, type PaymentDetail, type PaymentStatus, type PeerInfo, type PlayerEvent, type Playlist, type PlaylistItem, type PongMessage, type PreparePaymentRequest, type PreparePaymentResponse, type PushPlatform, type QualityProgress, type QueryOptions, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RenameFileRequest, type RenameFileResponse, type RoomInfo, type RoomStats, type RoomsResponse, type SendOptions, type ServerMessage, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type StateChange, type StateChangeHandler, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamMessage, type StreamOptions, type StreamSession, type StreamTokenCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type TableSchema, type TranscodeStatus, type TransportType, type UpdateApiKeyRequest, type UpdateApiKeyResponse, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateDataRequest, type UpdateSubscriptionRequest, type UpdateVideoRequest, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type Video, type VideoComment, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoVisibility, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, isWebTransportSupported };
+export { type AdReportResponse, type AdReportSummary, AdsAPI, ApiError, type ApiKeyItem, type AppStatsResponse, AuthError, type AuthSettingsResponse, type BillingCycle, type BillingKeyResponse, type BulkCreateResponse, type BulkError, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type Channel, type ChannelMembership, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type CreateApiKeyRequest, type CreateApiKeyResponse, type CreateChannelRequest, type CreateColumnRequest, type CreateDataRequest, type CreateFolderRequest, type CreateFolderResponse, type CreatePlaylistRequest, type CreateSubscriptionRequest, type CreateTableRequest, type DailyReport, type DataItem, type DataType, type DeleteWhereResponse, type DeviceInfo, type EnabledProviderInfo, type EnabledProvidersResponse, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type FetchApiKeysResponse, type FetchDataResponse, type FetchFilesResponse, type FileItem, GameAPI, type GameAction, type GameClientConfig, type GameConnectionState, type GameConnectionStatus, type GameDelta, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type GuestMemberSignInResponse, type HistoryResponse, type ICEServer, type ICEServersResponse, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinRoomRequest, type JoinRoomResponse, type ListBillingKeysResponse, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MessageHandler, type MoveFileRequest, type OAuthCallbackResponse, type OAuthProvider, type PauseSubscriptionRequest, type PaymentDetail, type PaymentStatus, type PeerInfo, type PlayerEvent, type Playlist, type PlaylistItem, type PongMessage, type PreparePaymentRequest, type PreparePaymentResponse, type PushPlatform, type QualityProgress, type QueryOptions, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RenameFileRequest, type RenameFileResponse, type RoomInfo, type RoomStats, type RoomsResponse, type SendOptions, type ServerMessage, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type StateChange, type StateChangeHandler, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamMessage, type StreamOptions, type StreamSession, type StreamTokenCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type TableSchema, type TranscodeStatus, type TransportType, type UpdateApiKeyRequest, type UpdateApiKeyResponse, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateDataRequest, type UpdateSubscriptionRequest, type UpdateVideoRequest, type UploadByPathOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type Video, type VideoComment, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoVisibility, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, isWebTransportSupported };

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AdsAPI: () => AdsAPI,
   ApiError: () => ApiError,
   AuthError: () => AuthError,
   ConnectBase: () => ConnectBase,
@@ -707,6 +708,75 @@ var StorageAPI = class {
   isImageFile(file) {
     return file.mime_type?.startsWith("image/") || false;
   }
+  /**
+   * 경로 기반 파일 업로드 (Firebase Storage 스타일)
+   *
+   * 같은 경로에 파일이 이미 존재하면 덮어쓰기합니다.
+   * URL이 변경되지 않아 고정 URL이 필요한 경우에 유용합니다.
+   *
+   * @example
+   * ```ts
+   * // 프로필 이미지 업로드 (항상 같은 URL 유지)
+   * const result = await storage.uploadByPath(
+   *   storageId,
+   *   '/profiles/user123/avatar.png',
+   *   file
+   * )
+   * console.log(result.url) // 항상 동일한 URL
+   *
+   * // 같은 경로로 다시 업로드하면 파일만 교체
+   * await storage.uploadByPath(storageId, '/profiles/user123/avatar.png', newFile)
+   * ```
+   */
+  async uploadByPath(storageId, path, file, options) {
+    const prefix = this.getPublicPrefix();
+    const formData = new FormData();
+    formData.append("file", file);
+    const overwrite = options?.overwrite !== false;
+    formData.append("overwrite", overwrite.toString());
+    const cleanPath = path.startsWith("/") ? path.slice(1) : path;
+    return this.http.post(
+      `${prefix}/storages/files/${storageId}/path/${cleanPath}`,
+      formData
+    );
+  }
+  /**
+   * 경로로 파일 조회
+   *
+   * @example
+   * ```ts
+   * const file = await storage.getByPath(storageId, '/profiles/user123/avatar.png')
+   * console.log(file.url) // 파일의 공개 URL
+   * ```
+   */
+  async getByPath(storageId, path) {
+    const prefix = this.getPublicPrefix();
+    const cleanPath = path.startsWith("/") ? path.slice(1) : path;
+    return this.http.get(
+      `${prefix}/storages/files/${storageId}/path/${cleanPath}`
+    );
+  }
+  /**
+   * 경로로 파일 URL 가져오기
+   *
+   * 파일이 존재하지 않으면 null 반환
+   *
+   * @example
+   * ```ts
+   * const url = await storage.getUrlByPath(storageId, '/profiles/user123/avatar.png')
+   * if (url) {
+   *   console.log('이미지 URL:', url)
+   * }
+   * ```
+   */
+  async getUrlByPath(storageId, path) {
+    try {
+      const file = await this.getByPath(storageId, path);
+      return file.url || null;
+    } catch {
+      return null;
+    }
+  }
 };
 
 // src/api/api-key.ts
@@ -2280,7 +2350,10 @@ var PaymentAPI = class {
    */
   async cancel(paymentId, data) {
     const prefix = this.getPublicPrefix();
-    return this.http.post(`${prefix}/payments/${paymentId}/cancel`, data);
+    return this.http.post(`${prefix}/payments/cancel`, {
+      payment_id: paymentId,
+      ...data
+    });
   }
   /**
    * 주문 ID로 결제 조회
@@ -2337,7 +2410,7 @@ var SubscriptionAPI = class {
    */
   async issueBillingKey() {
     const prefix = this.getPublicPrefix();
-    return this.http.post(`${prefix}/subscriptions/billing-keys/issue`, {});
+    return this.http.post(`${prefix}/subscriptions/billing-keys`, {});
   }
   /**
    * 빌링키 등록 확인
@@ -3848,6 +3921,78 @@ var GameAPI = class {
   }
 };
 
+// src/api/ads.ts
+var AdsAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * API Key 인증 시 /v1/public 접두사 반환
+   */
+  getPublicPrefix() {
+    return this.http.hasApiKey() ? "/v1/public" : "/v1";
+  }
+  /**
+   * AdSense 연결 상태 확인
+   *
+   * @returns 연결 상태, 이메일, AdSense 계정 ID
+   *
+   * @example
+   * ```typescript
+   * const status = await cb.ads.getConnectionStatus()
+   * if (status.is_connected) {
+   *     console.log('연결됨:', status.email)
+   * }
+   * ```
+   */
+  async getConnectionStatus() {
+    const prefix = this.getPublicPrefix();
+    return this.http.get(`${prefix}/ads/connection`);
+  }
+  /**
+   * AdSense 리포트 조회 (일별 데이터 + 요약)
+   *
+   * @param startDate - 시작일 (YYYY-MM-DD), 미지정 시 최근 30일
+   * @param endDate - 종료일 (YYYY-MM-DD), 미지정 시 최근 30일
+   * @returns 요약 + 일별 데이터
+   *
+   * @example
+   * ```typescript
+   * const report = await cb.ads.getReport('2025-01-01', '2025-01-31')
+   * console.log('총 수익:', report.summary.total_earnings)
+   * report.daily.forEach(day => {
+   *     console.log(`${day.date}: $${day.earnings}`)
+   * })
+   * ```
+   */
+  async getReport(startDate, endDate) {
+    const prefix = this.getPublicPrefix();
+    const params = new URLSearchParams();
+    if (startDate) params.set("start", startDate);
+    if (endDate) params.set("end", endDate);
+    const query = params.toString();
+    return this.http.get(
+      `${prefix}/ads/reports${query ? `?${query}` : ""}`
+    );
+  }
+  /**
+   * 최근 30일 AdSense 요약 조회
+   *
+   * @returns 30일 합산 수익, 노출, 클릭, CTR, CPC, RPM
+   *
+   * @example
+   * ```typescript
+   * const summary = await cb.ads.getReportSummary()
+   * console.log(`총 수익: $${summary.total_earnings}`)
+   * console.log(`RPM: $${summary.rpm}`)
+   * ```
+   */
+  async getReportSummary() {
+    const prefix = this.getPublicPrefix();
+    return this.http.get(`${prefix}/ads/reports/summary`);
+  }
+};
+
 // src/api/game-transport.ts
 var WebTransportTransport = class {
   constructor(config, onMessage, onClose, onError) {
@@ -4479,6 +4624,7 @@ var ConnectBase = class {
     this.push = new PushAPI(this.http);
     this.video = new VideoAPI(this.http, config.videoUrl || DEFAULT_VIDEO_URL);
     this.game = new GameAPI(this.http, config.gameUrl || DEFAULT_GAME_URL);
+    this.ads = new AdsAPI(this.http);
   }
   /**
    * 수동으로 토큰 설정 (기존 토큰으로 세션 복원 시)
@@ -4502,6 +4648,7 @@ var ConnectBase = class {
 var index_default = ConnectBase;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AdsAPI,
   ApiError,
   AuthError,
   ConnectBase,