@giaeulate/baas-sdk 1.3.0 → 1.4.0

package/dist/index.d.cts

@@ -59,8 +59,10 @@ declare class HttpClient {
     apiKey: string;
     keyType: KeyType;
     token: string | null;
+    refreshToken: string | null;
     private environment;
     private _onForceLogout;
+    private _refreshing;
     constructor(url?: string, apiKey?: string, options?: ClientOptions);
     /** SECURITY: a service_role key bypasses RLS and grants admin over every
      *  tenant. If it ends up in a browser bundle, anyone can extract it. Warn
@@ -71,6 +73,15 @@ declare class HttpClient {
      * Persists to both the in-memory property and localStorage so getDynamicToken() works.
      */
     setToken(token: string | null): void;
+    /** Persist the rotating refresh token (used by auto-refresh on 401). In the
+     *  browser the server also sets an HttpOnly `baas_refresh` cookie, so storing
+     *  it here is mainly for non-cookie clients (React Native). */
+    setRefreshToken(token: string | null): void;
+    private getRefreshToken;
+    /** Attempts a single token refresh, deduped across concurrent 401s. Sends the
+     *  stored refresh token (falls back to the HttpOnly cookie in browsers). */
+    private tryRefresh;
+    private doRefresh;
     /**
      * Register a callback invoked on forced logout (401).
      * Use this in React Native instead of the default window.location redirect.
@@ -85,7 +96,7 @@ declare class HttpClient {
     /**
      * Core HTTP request method - DRY principle
      */
-    protected request<T = any>(endpoint: string, options?: RequestOptions): Promise<T>;
+    protected request<T = any>(endpoint: string, options?: RequestOptions, _isRetry?: boolean): Promise<T>;
     protected get<T = any>(endpoint: string): Promise<T>;
     protected post<T = any>(endpoint: string, body?: unknown): Promise<T>;
     protected put<T = any>(endpoint: string, body?: unknown): Promise<T>;
@@ -242,6 +253,7 @@ interface MFASetupResponse {
 }
 interface AuthModule {
     login(email: string, password: string): Promise<any>;
+    refresh(): Promise<any>;
     logout(): Promise<void>;
     verifyMFA(mfaToken: string, code: string): Promise<any>;
     verifyMFAWithRecoveryCode(mfaToken: string, recoveryCode: string): Promise<any>;
@@ -357,6 +369,8 @@ interface StorageBucket {
     id: string;
     name: string;
     is_public: boolean;
+    /** Per-bucket upload cap in bytes (absent = no bucket-specific cap). */
+    max_bytes?: number;
     created_at: string;
 }
 interface StorageModule {
@@ -373,11 +387,12 @@ interface StorageModule {
     }>;
     /** Delete a file by ID. */
     deleteFile(fileId: string): Promise<void>;
-    /** Create a new bucket. */
-    createBucket(name: string, isPublic?: boolean): Promise<StorageBucket>;
-    /** Update mutable bucket fields (is_public). */
+    /** Create a new bucket. maxBytes sets a per-bucket upload cap (omit for none). */
+    createBucket(name: string, isPublic?: boolean, maxBytes?: number): Promise<StorageBucket>;
+    /** Update mutable bucket fields (is_public, max_bytes). */
     updateBucket(bucketId: string, opts: {
         isPublic?: boolean;
+        maxBytes?: number;
     }): Promise<StorageBucket>;
     /** List all buckets. */
     listBuckets(): Promise<StorageBucket[]>;
@@ -517,21 +532,26 @@ interface EnvVarsModule {
  */
 
 interface EmailConfig {
+    id?: string;
     provider: string;
     smtp_host?: string;
     smtp_port?: number;
     smtp_user?: string;
     smtp_password?: string;
+    smtp_secure?: boolean;
     sendgrid_api_key?: string;
     resend_api_key?: string;
     from_email: string;
     from_name?: string;
+    label?: string;
+    is_default?: boolean;
 }
 interface EmailTemplate {
     name: string;
     subject: string;
     text_body?: string;
     html_body?: string;
+    email_config_id?: string | null;
 }
 interface SendEmailInput {
     to: string[];
@@ -539,12 +559,16 @@ interface SendEmailInput {
     text_body?: string;
     html_body?: string;
     template_id?: string;
+    config_id?: string;
     template_data?: Record<string, any>;
 }
 interface EmailModule {
     send(input: SendEmailInput): Promise<any>;
     getConfig(): Promise<any>;
+    listConfigs(): Promise<any>;
     saveConfig(config: EmailConfig): Promise<any>;
+    setDefaultConfig(id: string): Promise<any>;
+    deleteConfig(id: string): Promise<any>;
     createTemplate(template: EmailTemplate): Promise<any>;
     listTemplates(): Promise<any>;
     getTemplate(id: string): Promise<any>;
@@ -632,6 +656,7 @@ interface AuditModule {
     exportLogs(format: 'csv' | 'json', options?: AuditLogsOptions): Promise<any>;
     purgePreview(olderThanDays: number): Promise<any>;
     purge(olderThanDays: number): Promise<any>;
+    clearAll(): Promise<any>;
 }
 
 /**
@@ -709,14 +734,26 @@ interface BranchesModule {
 }
 
 /**
- * Realtime Module - WebSocket subscriptions
+ * Realtime Module - WebSocket subscriptions (CDC tables, Broadcast, Presence)
  */
 
 interface Subscription {
     unsubscribe: () => void;
 }
+interface PresenceHandle {
+    leave: () => void;
+}
 interface RealtimeModule {
-    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>): Promise<Subscription>;
+    /** Subscribe to table changes. `filter` narrows delivery per-subscription
+     *  (PostgREST-style "op.value" specs, e.g. { status: 'eq.pending' }). */
+    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>, filter?: Record<string, string>): Promise<Subscription>;
+    /** Subscribe to an ephemeral Broadcast channel (no DB, no RLS). */
+    subscribeBroadcast(channel: string, callback: (payload: any) => void): Promise<Subscription>;
+    /** Publish a message to a Broadcast channel. */
+    broadcast(channel: string, payload: unknown): void;
+    /** Join a Presence channel with an arbitrary state object. The callback
+     *  receives sync/join/leave events with the member list. */
+    subscribePresence(channel: string, state: unknown, callback: (msg: any) => void): Promise<PresenceHandle>;
 }
 
 /**
@@ -728,6 +765,7 @@ interface ApiKeysModule {
     list(): Promise<any>;
     revoke(keyId: string): Promise<any>;
     delete(keyId: string): Promise<any>;
+    setBrand(keyId: string, emailConfigId: string): Promise<any>;
     getInstanceToken(): Promise<any>;
     regenerateInstanceToken(): Promise<any>;
 }
@@ -937,7 +975,7 @@ declare class BaasClient extends HttpClient {
     listStorageFiles(): Promise<StorageFile[]>;
     getStorageFile(fileId: string): Promise<StorageFileWithUrl>;
     deleteStorageFile(fileId: string): Promise<void>;
-    createStorageBucket(name: string, isPublic?: boolean): Promise<StorageBucket>;
+    createStorageBucket(name: string, isPublic?: boolean, maxBytes?: number): Promise<StorageBucket>;
     listStorageBuckets(): Promise<StorageBucket[]>;
     getStorageBucket(bucketId: string): Promise<StorageBucket>;
     deleteStorageBucket(bucketId: string): Promise<void>;
@@ -947,6 +985,7 @@ declare class BaasClient extends HttpClient {
     listApiKeys(): Promise<any>;
     revokeApiKey(keyId: string): Promise<any>;
     deleteApiKey(keyId: string): Promise<any>;
+    setApiKeyBrand(keyId: string, emailConfigId: string): Promise<any>;
     getInstanceToken(): Promise<any>;
     regenerateInstanceToken(): Promise<any>;
     createBackup(options?: any): Promise<any>;
@@ -970,7 +1009,10 @@ declare class BaasClient extends HttpClient {
     generateMigration(tableName: string, changes: any[]): Promise<any>;
     sendEmail(input: any): Promise<any>;
     getEmailConfig(): Promise<any>;
+    listEmailConfigs(): Promise<any>;
     saveEmailConfig(config: any): Promise<any>;
+    setDefaultEmailConfig(id: string): Promise<any>;
+    deleteEmailConfig(id: string): Promise<any>;
     createEmailTemplate(template: any): Promise<any>;
     listEmailTemplates(): Promise<any>;
     getEmailTemplate(id: string): Promise<any>;
@@ -1018,7 +1060,8 @@ declare class BaasClient extends HttpClient {
     exportAuditLogs(format: 'csv' | 'json', options?: any): Promise<any>;
     previewPurgeAuditLogs(olderThanDays: number): Promise<any>;
     purgeAuditLogs(olderThanDays: number): Promise<any>;
-    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>): Promise<Subscription>;
+    clearAllAuditLogs(): Promise<any>;
+    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>, filter?: Record<string, string>): Promise<Subscription>;
     getEnvironmentStatus(): Promise<EnvironmentStatus>;
     initTestEnvironment(): Promise<any>;
     promoteTestToProd(): Promise<PromoteResult>;

package/dist/index.d.ts

@@ -59,8 +59,10 @@ declare class HttpClient {
     apiKey: string;
     keyType: KeyType;
     token: string | null;
+    refreshToken: string | null;
     private environment;
     private _onForceLogout;
+    private _refreshing;
     constructor(url?: string, apiKey?: string, options?: ClientOptions);
     /** SECURITY: a service_role key bypasses RLS and grants admin over every
      *  tenant. If it ends up in a browser bundle, anyone can extract it. Warn
@@ -71,6 +73,15 @@ declare class HttpClient {
      * Persists to both the in-memory property and localStorage so getDynamicToken() works.
      */
     setToken(token: string | null): void;
+    /** Persist the rotating refresh token (used by auto-refresh on 401). In the
+     *  browser the server also sets an HttpOnly `baas_refresh` cookie, so storing
+     *  it here is mainly for non-cookie clients (React Native). */
+    setRefreshToken(token: string | null): void;
+    private getRefreshToken;
+    /** Attempts a single token refresh, deduped across concurrent 401s. Sends the
+     *  stored refresh token (falls back to the HttpOnly cookie in browsers). */
+    private tryRefresh;
+    private doRefresh;
     /**
      * Register a callback invoked on forced logout (401).
      * Use this in React Native instead of the default window.location redirect.
@@ -85,7 +96,7 @@ declare class HttpClient {
     /**
      * Core HTTP request method - DRY principle
      */
-    protected request<T = any>(endpoint: string, options?: RequestOptions): Promise<T>;
+    protected request<T = any>(endpoint: string, options?: RequestOptions, _isRetry?: boolean): Promise<T>;
     protected get<T = any>(endpoint: string): Promise<T>;
     protected post<T = any>(endpoint: string, body?: unknown): Promise<T>;
     protected put<T = any>(endpoint: string, body?: unknown): Promise<T>;
@@ -242,6 +253,7 @@ interface MFASetupResponse {
 }
 interface AuthModule {
     login(email: string, password: string): Promise<any>;
+    refresh(): Promise<any>;
     logout(): Promise<void>;
     verifyMFA(mfaToken: string, code: string): Promise<any>;
     verifyMFAWithRecoveryCode(mfaToken: string, recoveryCode: string): Promise<any>;
@@ -357,6 +369,8 @@ interface StorageBucket {
     id: string;
     name: string;
     is_public: boolean;
+    /** Per-bucket upload cap in bytes (absent = no bucket-specific cap). */
+    max_bytes?: number;
     created_at: string;
 }
 interface StorageModule {
@@ -373,11 +387,12 @@ interface StorageModule {
     }>;
     /** Delete a file by ID. */
     deleteFile(fileId: string): Promise<void>;
-    /** Create a new bucket. */
-    createBucket(name: string, isPublic?: boolean): Promise<StorageBucket>;
-    /** Update mutable bucket fields (is_public). */
+    /** Create a new bucket. maxBytes sets a per-bucket upload cap (omit for none). */
+    createBucket(name: string, isPublic?: boolean, maxBytes?: number): Promise<StorageBucket>;
+    /** Update mutable bucket fields (is_public, max_bytes). */
     updateBucket(bucketId: string, opts: {
         isPublic?: boolean;
+        maxBytes?: number;
     }): Promise<StorageBucket>;
     /** List all buckets. */
     listBuckets(): Promise<StorageBucket[]>;
@@ -517,21 +532,26 @@ interface EnvVarsModule {
  */
 
 interface EmailConfig {
+    id?: string;
     provider: string;
     smtp_host?: string;
     smtp_port?: number;
     smtp_user?: string;
     smtp_password?: string;
+    smtp_secure?: boolean;
     sendgrid_api_key?: string;
     resend_api_key?: string;
     from_email: string;
     from_name?: string;
+    label?: string;
+    is_default?: boolean;
 }
 interface EmailTemplate {
     name: string;
     subject: string;
     text_body?: string;
     html_body?: string;
+    email_config_id?: string | null;
 }
 interface SendEmailInput {
     to: string[];
@@ -539,12 +559,16 @@ interface SendEmailInput {
     text_body?: string;
     html_body?: string;
     template_id?: string;
+    config_id?: string;
     template_data?: Record<string, any>;
 }
 interface EmailModule {
     send(input: SendEmailInput): Promise<any>;
     getConfig(): Promise<any>;
+    listConfigs(): Promise<any>;
     saveConfig(config: EmailConfig): Promise<any>;
+    setDefaultConfig(id: string): Promise<any>;
+    deleteConfig(id: string): Promise<any>;
     createTemplate(template: EmailTemplate): Promise<any>;
     listTemplates(): Promise<any>;
     getTemplate(id: string): Promise<any>;
@@ -632,6 +656,7 @@ interface AuditModule {
     exportLogs(format: 'csv' | 'json', options?: AuditLogsOptions): Promise<any>;
     purgePreview(olderThanDays: number): Promise<any>;
     purge(olderThanDays: number): Promise<any>;
+    clearAll(): Promise<any>;
 }
 
 /**
@@ -709,14 +734,26 @@ interface BranchesModule {
 }
 
 /**
- * Realtime Module - WebSocket subscriptions
+ * Realtime Module - WebSocket subscriptions (CDC tables, Broadcast, Presence)
  */
 
 interface Subscription {
     unsubscribe: () => void;
 }
+interface PresenceHandle {
+    leave: () => void;
+}
 interface RealtimeModule {
-    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>): Promise<Subscription>;
+    /** Subscribe to table changes. `filter` narrows delivery per-subscription
+     *  (PostgREST-style "op.value" specs, e.g. { status: 'eq.pending' }). */
+    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>, filter?: Record<string, string>): Promise<Subscription>;
+    /** Subscribe to an ephemeral Broadcast channel (no DB, no RLS). */
+    subscribeBroadcast(channel: string, callback: (payload: any) => void): Promise<Subscription>;
+    /** Publish a message to a Broadcast channel. */
+    broadcast(channel: string, payload: unknown): void;
+    /** Join a Presence channel with an arbitrary state object. The callback
+     *  receives sync/join/leave events with the member list. */
+    subscribePresence(channel: string, state: unknown, callback: (msg: any) => void): Promise<PresenceHandle>;
 }
 
 /**
@@ -728,6 +765,7 @@ interface ApiKeysModule {
     list(): Promise<any>;
     revoke(keyId: string): Promise<any>;
     delete(keyId: string): Promise<any>;
+    setBrand(keyId: string, emailConfigId: string): Promise<any>;
     getInstanceToken(): Promise<any>;
     regenerateInstanceToken(): Promise<any>;
 }
@@ -937,7 +975,7 @@ declare class BaasClient extends HttpClient {
     listStorageFiles(): Promise<StorageFile[]>;
     getStorageFile(fileId: string): Promise<StorageFileWithUrl>;
     deleteStorageFile(fileId: string): Promise<void>;
-    createStorageBucket(name: string, isPublic?: boolean): Promise<StorageBucket>;
+    createStorageBucket(name: string, isPublic?: boolean, maxBytes?: number): Promise<StorageBucket>;
     listStorageBuckets(): Promise<StorageBucket[]>;
     getStorageBucket(bucketId: string): Promise<StorageBucket>;
     deleteStorageBucket(bucketId: string): Promise<void>;
@@ -947,6 +985,7 @@ declare class BaasClient extends HttpClient {
     listApiKeys(): Promise<any>;
     revokeApiKey(keyId: string): Promise<any>;
     deleteApiKey(keyId: string): Promise<any>;
+    setApiKeyBrand(keyId: string, emailConfigId: string): Promise<any>;
     getInstanceToken(): Promise<any>;
     regenerateInstanceToken(): Promise<any>;
     createBackup(options?: any): Promise<any>;
@@ -970,7 +1009,10 @@ declare class BaasClient extends HttpClient {
     generateMigration(tableName: string, changes: any[]): Promise<any>;
     sendEmail(input: any): Promise<any>;
     getEmailConfig(): Promise<any>;
+    listEmailConfigs(): Promise<any>;
     saveEmailConfig(config: any): Promise<any>;
+    setDefaultEmailConfig(id: string): Promise<any>;
+    deleteEmailConfig(id: string): Promise<any>;
     createEmailTemplate(template: any): Promise<any>;
     listEmailTemplates(): Promise<any>;
     getEmailTemplate(id: string): Promise<any>;
@@ -1018,7 +1060,8 @@ declare class BaasClient extends HttpClient {
     exportAuditLogs(format: 'csv' | 'json', options?: any): Promise<any>;
     previewPurgeAuditLogs(olderThanDays: number): Promise<any>;
     purgeAuditLogs(olderThanDays: number): Promise<any>;
-    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>): Promise<Subscription>;
+    clearAllAuditLogs(): Promise<any>;
+    subscribe<T = any>(table: string, action: RealtimeAction, callback: RealtimeCallback<T>, filter?: Record<string, string>): Promise<Subscription>;
     getEnvironmentStatus(): Promise<EnvironmentStatus>;
     initTestEnvironment(): Promise<any>;
     promoteTestToProd(): Promise<PromoteResult>;