connectbase-client 0.5.2 → 0.6.1

package/dist/index.d.mts

@@ -276,6 +276,254 @@ interface BulkError {
 interface DeleteWhereResponse {
     deleted: number;
 }
+interface SecurityRule {
+    id: string;
+    app_id: string;
+    table_name: string;
+    rules: Record<string, unknown>;
+    is_active: boolean;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+}
+interface CreateSecurityRuleRequest {
+    table_name: string;
+    rules: Record<string, unknown>;
+    is_active?: boolean;
+    priority?: number;
+}
+interface UpdateSecurityRuleRequest {
+    rules?: Record<string, unknown>;
+    is_active?: boolean;
+    priority?: number;
+}
+interface TableIndex {
+    id: string;
+    name: string;
+    fields: string[];
+    unique: boolean;
+    sparse: boolean;
+    created_at: string;
+}
+interface CreateIndexRequest {
+    name: string;
+    fields: string[];
+    unique?: boolean;
+    sparse?: boolean;
+}
+interface IndexAnalysis {
+    recommendations: IndexRecommendation[];
+    slow_queries: SlowQueryInfo[];
+    existing_indexes: TableIndex[];
+    summary: {
+        total_queries: number;
+        slow_query_count: number;
+        avg_response_time: number;
+        index_utilization: number;
+        recommended_count: number;
+    };
+}
+interface IndexRecommendation {
+    fields: string[];
+    reason: string;
+    estimated_improvement: string;
+    priority: string;
+    query_count: number;
+    avg_query_time: number;
+}
+interface SlowQueryInfo {
+    pattern: string;
+    count: number;
+    avg_time: number;
+}
+type RelationType = 'one-to-one' | 'one-to-many' | 'many-to-many';
+interface TableRelation {
+    id: string;
+    app_id: string;
+    source_table: string;
+    source_field: string;
+    target_table: string;
+    target_field: string;
+    relation_type: RelationType;
+    alias: string;
+    cascade_delete: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface CreateRelationRequest {
+    source_table: string;
+    source_field: string;
+    target_table: string;
+    target_field?: string;
+    relation_type: RelationType;
+    alias?: string;
+    cascade_delete?: boolean;
+}
+interface PopulateOption {
+    field: string;
+    from?: string;
+    as?: string;
+    select?: string[];
+    limit?: number;
+    orderBy?: string;
+    order?: 'asc' | 'desc';
+    populate?: PopulateOption[];
+}
+type TriggerEvent = 'create' | 'update' | 'delete' | 'all';
+type TriggerHandlerType = 'function' | 'workflow' | 'webhook';
+interface Trigger {
+    id: string;
+    app_id: string;
+    name: string;
+    table_name: string;
+    event: TriggerEvent;
+    condition?: Record<string, unknown>;
+    handler_type: TriggerHandlerType;
+    handler_id?: string;
+    handler_url?: string;
+    is_active: boolean;
+    order: number;
+    created_at: string;
+    updated_at: string;
+}
+interface CreateTriggerRequest {
+    name: string;
+    table_name: string;
+    event: TriggerEvent;
+    handler_type: TriggerHandlerType;
+    handler_id?: string;
+    handler_url?: string;
+    condition?: Record<string, unknown>;
+    is_active?: boolean;
+    order?: number;
+}
+interface UpdateTriggerRequest {
+    name?: string;
+    event?: TriggerEvent;
+    handler_type?: TriggerHandlerType;
+    handler_id?: string;
+    handler_url?: string;
+    condition?: Record<string, unknown>;
+    is_active?: boolean;
+    order?: number;
+}
+interface AggregateStage {
+    match?: Record<string, unknown>;
+    group?: {
+        _id: string | Record<string, unknown>;
+        [key: string]: unknown;
+    };
+    sort?: Record<string, 1 | -1>;
+    limit?: number;
+    skip?: number;
+    project?: Record<string, unknown>;
+    unwind?: string;
+    count?: string;
+    lookup?: {
+        from: string;
+        local_field: string;
+        foreign_field: string;
+        as: string;
+    };
+}
+interface AggregateResult {
+    results: Record<string, unknown>[];
+    total: number;
+}
+interface SearchOptions {
+    case_sensitive?: boolean;
+    whole_word?: boolean;
+    fuzzy?: boolean;
+    fuzzy_distance?: number;
+    highlight?: boolean;
+    limit?: number;
+    offset?: number;
+    min_score?: number;
+}
+interface SearchResult {
+    id: string;
+    data: Record<string, unknown>;
+    score: number;
+    highlights?: Record<string, string>;
+}
+interface SearchResponse {
+    results: SearchResult[];
+    total: number;
+}
+interface GeoPoint {
+    latitude: number;
+    longitude: number;
+}
+interface GeoNear {
+    center: GeoPoint;
+    max_distance: number;
+    min_distance?: number;
+}
+interface GeoWithin {
+    box: {
+        bottom_left: GeoPoint;
+        top_right: GeoPoint;
+    };
+}
+interface GeoPolygon {
+    points: GeoPoint[];
+}
+interface GeoQuery {
+    near?: GeoNear;
+    within?: GeoWithin;
+    polygon?: GeoPolygon;
+}
+interface GeoResult {
+    id: string;
+    data: Record<string, unknown>;
+    distance: number;
+}
+interface GeoResponse {
+    results: GeoResult[];
+    total: number;
+}
+type AtomicOperatorType = 'increment' | 'serverTimestamp' | 'deleteField' | 'arrayUnion' | 'arrayRemove' | 'arrayPush' | 'min' | 'max' | 'objectMerge' | 'objectSet' | 'geoPoint';
+interface AtomicOperator {
+    type: AtomicOperatorType;
+    value?: unknown;
+}
+interface BatchOperation {
+    type: 'create' | 'update' | 'delete';
+    table: string;
+    doc_id?: string;
+    data?: Record<string, unknown>;
+    operators?: Record<string, AtomicOperator>;
+}
+interface TransactionRead {
+    table: string;
+    doc_id: string;
+    alias?: string;
+}
+interface TransactionWrite {
+    type: 'create' | 'update' | 'delete';
+    table: string;
+    doc_id?: string;
+    data?: Record<string, unknown>;
+    operators?: Record<string, AtomicOperator>;
+    precondition?: {
+        version?: number;
+        exists?: boolean;
+    };
+}
+interface TTLConfig {
+    table_name: string;
+    field: string;
+    enabled: boolean;
+}
+interface RetentionPolicy {
+    table_name: string;
+    retention_days: number;
+    date_field?: string;
+    action: 'delete' | 'archive';
+    archive_table?: string;
+    schedule?: string;
+    enabled: boolean;
+}
 
 declare class DatabaseAPI {
     private http;
@@ -344,6 +592,121 @@ declare class DatabaseAPI {
      * 조건에 맞는 데이터 삭제
      */
     deleteWhere(tableId: string, where: WhereCondition): Promise<DeleteWhereResponse>;
+    /**
+     * 집계 파이프라인 실행 (MongoDB 스타일)
+     */
+    aggregate(tableId: string, pipeline: AggregateStage[]): Promise<AggregateResult>;
+    /**
+     * 전문 검색
+     */
+    search(tableId: string, query: string, fields: string[], options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * 자동완성 검색
+     */
+    autocomplete(tableId: string, query: string, field: string, options?: {
+        limit?: number;
+    }): Promise<SearchResponse>;
+    /**
+     * 지리 쿼리 (반경, 박스, 폴리곤)
+     */
+    geoQuery(tableId: string, field: string, query: GeoQuery, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<GeoResponse>;
+    /**
+     * 배치 쓰기 (여러 테이블 다중 문서 원자적 처리)
+     */
+    batch(operations: BatchOperation[]): Promise<{
+        results: Record<string, unknown>[];
+    }>;
+    /**
+     * 트랜잭션 실행 (읽기 → 쓰기 ACID)
+     */
+    transaction(reads: TransactionRead[], writes: TransactionWrite[]): Promise<{
+        results: Record<string, unknown>;
+    }>;
+    /**
+     * 데이터 조회 시 릴레이션 로딩 (JOIN)
+     */
+    getDataWithPopulate(tableId: string, options: QueryOptions & {
+        populate: PopulateOption[];
+    }): Promise<FetchDataResponse>;
+    /**
+     * 보안 규칙 목록 조회
+     */
+    listSecurityRules(appId: string): Promise<SecurityRule[]>;
+    /**
+     * 보안 규칙 생성
+     */
+    createSecurityRule(appId: string, data: CreateSecurityRuleRequest): Promise<SecurityRule>;
+    /**
+     * 보안 규칙 수정
+     */
+    updateSecurityRule(appId: string, ruleId: string, data: UpdateSecurityRuleRequest): Promise<SecurityRule>;
+    /**
+     * 보안 규칙 삭제
+     */
+    deleteSecurityRule(appId: string, ruleId: string): Promise<void>;
+    /**
+     * 테이블 인덱스 목록 조회
+     */
+    listIndexes(appId: string, tableId: string): Promise<TableIndex[]>;
+    /**
+     * 인덱스 생성
+     */
+    createIndex(appId: string, tableId: string, data: CreateIndexRequest): Promise<TableIndex>;
+    /**
+     * 인덱스 삭제
+     */
+    deleteIndex(appId: string, tableId: string, indexId: string): Promise<void>;
+    /**
+     * 인덱스 분석 및 추천
+     */
+    analyzeIndexes(appId: string, tableId: string): Promise<IndexAnalysis>;
+    /**
+     * 테이블 릴레이션 목록 조회
+     */
+    listRelations(appId: string, tableId: string): Promise<TableRelation[]>;
+    /**
+     * 릴레이션 생성
+     */
+    createRelation(appId: string, tableId: string, data: CreateRelationRequest): Promise<TableRelation>;
+    /**
+     * 릴레이션 삭제
+     */
+    deleteRelation(appId: string, tableId: string, relationName: string): Promise<void>;
+    /**
+     * 트리거 목록 조회
+     */
+    listTriggers(appId: string): Promise<Trigger[]>;
+    /**
+     * 트리거 생성
+     */
+    createTrigger(appId: string, data: CreateTriggerRequest): Promise<Trigger>;
+    /**
+     * 트리거 수정
+     */
+    updateTrigger(appId: string, triggerId: string, data: UpdateTriggerRequest): Promise<Trigger>;
+    /**
+     * 트리거 삭제
+     */
+    deleteTrigger(appId: string, triggerId: string): Promise<void>;
+    /**
+     * TTL 정책 설정
+     */
+    setTTL(appId: string, config: TTLConfig): Promise<TTLConfig>;
+    /**
+     * TTL 정책 조회
+     */
+    getTTL(appId: string, tableName: string): Promise<TTLConfig>;
+    /**
+     * 보관 정책 설정
+     */
+    setRetentionPolicy(appId: string, policy: RetentionPolicy): Promise<RetentionPolicy>;
+    /**
+     * 보관 정책 조회
+     */
+    getRetentionPolicy(appId: string, tableName: string): Promise<RetentionPolicy>;
 }
 
 interface FileItem {
@@ -1063,11 +1426,14 @@ declare class RealtimeAPI {
      *
      * @example
      * ```typescript
+     * // 브라우저에서 사용
+     * const outputEl = document.getElementById('ai-output')
+     *
      * const session = await client.realtime.stream(
      *     [{ role: 'user', content: '안녕하세요' }],
      *     {
      *         onToken: (token) => {
-     *             process.stdout.write(token) // 실시간 출력
+     *             outputEl.textContent += token // 실시간 출력
      *         },
      *         onDone: (result) => {
      *             console.log('완료:', result.fullText)
@@ -1076,7 +1442,7 @@ declare class RealtimeAPI {
      *             console.error('에러:', error)
      *         }
      *     },
-     *     { model: 'gemini-2.0-flash', temperature: 0.7 }
+     *     { provider: 'gemini', model: 'gemini-2.0-flash', temperature: 0.7 }
      * )
      *
      * // 필요 시 중지
@@ -3629,4 +3995,4 @@ declare class ConnectBase {
     updateConfig(config: Partial<ConnectBaseConfig>): void;
 }
 
-export { type AdReportResponse, type AdReportSummary, AdsAPI, ApiError, type ApiKeyItem, type AppStatsResponse, AuthError, type AuthSettingsResponse, type BatchSetPageMetaRequest, 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 ListPageMetasResponse, 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 PageMetaResponse, 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 SetPageMetaRequest, 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 ValidateResponse, 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, type AggregateResult, type AggregateStage, ApiError, type ApiKeyItem, type AppStatsResponse, type AtomicOperator, type AtomicOperatorType, AuthError, type AuthSettingsResponse, type BatchOperation, type BatchSetPageMetaRequest, 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 CreateIndexRequest, type CreatePlaylistRequest, type CreateRelationRequest, type CreateSecurityRuleRequest, type CreateSubscriptionRequest, type CreateTableRequest, type CreateTriggerRequest, 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 GeoNear, type GeoPoint, type GeoPolygon, type GeoQuery, type GeoResponse, type GeoResult, type GeoWithin, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type GuestMemberSignInResponse, type HistoryResponse, type ICEServer, type ICEServersResponse, type IndexAnalysis, type IndexRecommendation, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinRoomRequest, type JoinRoomResponse, type ListBillingKeysResponse, type ListPageMetasResponse, 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 PageMetaResponse, type PauseSubscriptionRequest, type PaymentDetail, type PaymentStatus, type PeerInfo, type PlayerEvent, type Playlist, type PlaylistItem, type PongMessage, type PopulateOption, type PreparePaymentRequest, type PreparePaymentResponse, type PushPlatform, type QualityProgress, type QueryOptions, type RealtimeConnectOptions, type RealtimeMessage, type RegisterDeviceRequest, type RelationType, type RenameFileRequest, type RenameFileResponse, type RetentionPolicy, type RoomInfo, type RoomStats, type RoomsResponse, type SearchOptions, type SearchResponse, type SearchResult, type SecurityRule, type SendOptions, type ServerMessage, type SetPageMetaRequest, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type SlowQueryInfo, 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 TTLConfig, type TableIndex, type TableRelation, type TableSchema, type TransactionRead, type TransactionWrite, type TranscodeStatus, type TransportType, type Trigger, type TriggerEvent, type TriggerHandlerType, type UpdateApiKeyRequest, type UpdateApiKeyResponse, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateDataRequest, type UpdateSecurityRuleRequest, type UpdateSubscriptionRequest, type UpdateTriggerRequest, type UpdateVideoRequest, type UploadByPathOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type ValidateResponse, 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 };