@e-techsolutions/e-baas-sdk 1.0.3 → 1.0.4

package/README.md

@@ -22,6 +22,7 @@ const ebaas = createClient('https://your-project.e-baas.apiservices.app.br', 'yo
 
 - **Authentication** - Email/password and OAuth providers (Google, GitHub, Facebook)
 - **Database** - PostgreSQL with real-time subscriptions and RPC support
+- **Custom Database** - Use your own PostgreSQL database with automatic detection
 - **Storage** - File uploads with CDN integration and image transformations
 - **Realtime** - WebSocket subscriptions for live data updates
 - **Edge Functions** - Serverless functions with dual runtime (Node.js VM + Deno) and native SDK integration
@@ -90,6 +91,47 @@ const { data, error } = await ebaas.rpc('get_user_stats', {
 });
 ```
 
+### Custom Database
+
+```typescript
+// Configure with automatic custom database detection
+const ebaas = createClient(url, key, {
+  database: {
+    workspaceId: 'your-workspace-id',
+    autoDetectCustomDatabase: true
+  }
+});
+
+// Configure custom database credentials
+const credentials = {
+  host: 'your-postgres-host.com',
+  port: 5432,
+  database: 'your_custom_db',
+  username: 'db_user',
+  password: 'db_password',
+  schema: 'custom_schema',
+  sslEnabled: true
+};
+
+// Test connection
+const testResult = await ebaas.database.testCustomConnection(credentials);
+if (testResult.success) {
+  await ebaas.database.configureCustomDatabase(credentials);
+}
+
+// Check status
+const status = ebaas.getCustomDatabaseStatus();
+console.log('Using custom database:', status.hasConfig);
+
+// Use with different schema
+const data = await ebaas.database
+  .schema('custom_schema')
+  .from('users')
+  .select('*');
+```
+
+For detailed information about custom database features, see [Custom Database Guide](./CUSTOM_DATABASE_GUIDE.md).
+
 ### Storage
 
 ```typescript

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { HttpClient as HttpClient$1, EBaaSError as EBaaSError$1 } from 'infra';
+import { AxiosRequestConfig } from 'axios';
 import { SelectOptions as SelectOptions$1, InsertOptions as InsertOptions$1, UpdateOptions as UpdateOptions$1, DeleteOptions as DeleteOptions$1 } from 'infra/types/common';
 import { Socket } from 'socket.io-client';
 import { EventEmitter } from 'eventemitter3';
-import { AxiosRequestConfig } from 'axios';
 
 interface HttpClientConfig {
     url: string;
@@ -47,6 +47,15 @@ declare class EBaaSError extends Error {
     toString(): string;
 }
 
+interface CustomDatabaseCredentials {
+    host: string;
+    port: number;
+    database: string;
+    username: string;
+    password: string;
+    schema?: string;
+    sslEnabled?: boolean;
+}
 interface EBaaSClientOptions {
     supabaseUrl: string;
     supabaseKey: string;
@@ -62,6 +71,11 @@ interface EBaaSClientOptions {
         global?: {
             headers?: Record<string, string>;
         };
+        database?: {
+            customCredentials?: CustomDatabaseCredentials;
+            autoDetectCustomDatabase?: boolean;
+            workspaceId?: string;
+        };
     };
 }
 interface DatabaseFilters {
@@ -167,11 +181,89 @@ declare class AuthClient {
     private handleAuthError;
 }
 
+interface CustomDatabaseConfig {
+    id: string;
+    postgresHost: string;
+    postgresPort: number;
+    postgresDatabase: string;
+    postgresUsername: string;
+    postgresSchema: string;
+    sslEnabled: boolean;
+    lastConnectionTest: string;
+    isActive: boolean;
+}
+interface CustomDatabaseDetectionResult {
+    hasCustomDatabase: boolean;
+    config?: CustomDatabaseConfig;
+    credentials?: CustomDatabaseCredentials;
+}
+declare class CustomDatabaseManager {
+    private httpClient;
+    private workspaceId?;
+    private detectedConfig?;
+    constructor(httpClient: HttpClient, workspaceId?: string);
+    /**
+     * Detecta automaticamente se o workspace usa banco customizado
+     */
+    detectCustomDatabase(): Promise<CustomDatabaseDetectionResult>;
+    /**
+     * Testa conexão com banco customizado
+     */
+    testConnection(credentials: CustomDatabaseCredentials): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Configura credenciais customizadas para o workspace
+     */
+    configureCustomDatabase(credentials: CustomDatabaseCredentials): Promise<CustomDatabaseConfig>;
+    /**
+     * Remove configuração de banco customizado
+     */
+    removeCustomDatabase(): Promise<void>;
+    /**
+     * Retorna a configuração detectada em cache
+     */
+    getDetectedConfig(): CustomDatabaseDetectionResult | undefined;
+    /**
+     * Verifica se tem configuração customizada em cache
+     */
+    hasCustomDatabase(): boolean;
+    /**
+     * Retorna as credenciais customizadas se disponíveis
+     */
+    getCustomCredentials(): CustomDatabaseCredentials | undefined;
+    /**
+     * Atualiza o workspace ID
+     */
+    setWorkspaceId(workspaceId: string): void;
+    /**
+     * Retorna o workspace ID atual
+     */
+    getWorkspaceId(): string | undefined;
+    /**
+     * Retorna informações sobre o status do banco customizado
+     */
+    getStatus(): {
+        workspaceId?: string;
+        hasConfig: boolean;
+        lastDetection?: Date;
+        configDetails?: {
+            host: string;
+            port: number;
+            database: string;
+            schema: string;
+            sslEnabled: boolean;
+        };
+    };
+}
+
 declare class QueryBuilder<T = any> {
     private httpClient;
     private table;
+    private schema?;
     private query;
-    constructor(httpClient: HttpClient$1, table: string);
+    constructor(httpClient: HttpClient$1, table: string, schema?: string);
     select(columns?: string, options?: SelectOptions$1): this;
     insert(data: Partial<T> | Partial<T>[], options?: InsertOptions$1): Promise<{
         data: T[] | null;
@@ -220,10 +312,59 @@ declare class QueryBuilder<T = any> {
 
 declare class DatabaseClient {
     private httpClient;
-    constructor(httpClient: HttpClient$1);
+    private customDatabaseManager;
+    private currentSchema?;
+    constructor(httpClient: HttpClient$1, workspaceId?: string);
     from(table: string): QueryBuilder;
     rpc(fn: string, args?: Record<string, any>): Promise<any>;
     schema(schema: string): DatabaseClient;
+    /**
+     * Detecta automaticamente se o workspace usa banco customizado
+     */
+    detectCustomDatabase(): Promise<CustomDatabaseDetectionResult>;
+    /**
+     * Testa conexão com credenciais customizadas
+     */
+    testCustomConnection(credentials: CustomDatabaseCredentials): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Configura banco customizado para o workspace
+     */
+    configureCustomDatabase(credentials: CustomDatabaseCredentials): Promise<CustomDatabaseConfig>;
+    /**
+     * Remove configuração de banco customizado
+     */
+    removeCustomDatabase(): Promise<void>;
+    /**
+     * Verifica se o workspace está usando banco customizado
+     */
+    isUsingCustomDatabase(): boolean;
+    /**
+     * Retorna informações sobre o banco customizado
+     */
+    getCustomDatabaseStatus(): {
+        workspaceId?: string;
+        hasConfig: boolean;
+        lastDetection?: Date;
+        configDetails?: {
+            host: string;
+            port: number;
+            database: string;
+            schema: string;
+            sslEnabled: boolean;
+        };
+    };
+    /**
+     * Atualiza o workspace ID (útil quando o usuário troca de workspace)
+     */
+    setWorkspaceId(workspaceId: string): void;
+    /**
+     * Inicializa a detecção automática do banco customizado
+     * Deve ser chamado após a autenticação se autoDetectCustomDatabase estiver habilitado
+     */
+    initialize(): Promise<void>;
 }
 
 interface StorageFile {
@@ -604,6 +745,7 @@ declare class EBaaSClient {
     readonly realtime: RealtimeClient;
     readonly functions: FunctionsClient;
     private httpClient;
+    private options?;
     constructor(supabaseUrl: string, supabaseKey: string, options?: EBaaSClientOptions['options']);
     from(table: string): QueryBuilder<any>;
     rpc(fn: string, args?: Record<string, any>): Promise<any>;
@@ -613,10 +755,37 @@ declare class EBaaSClient {
         data: any;
         error: EBaaSError | null;
     }>;
+    /**
+     * Inicializa a detecção automática de banco customizado
+     */
+    private initializeCustomDatabase;
+    /**
+     * Atualiza o workspace ID para todos os módulos que precisam
+     */
+    setWorkspaceId(workspaceId: string): Promise<void>;
+    /**
+     * Configura credenciais customizadas diretamente
+     */
+    configureCustomDatabase(credentials: CustomDatabaseCredentials): Promise<void>;
+    /**
+     * Retorna informações sobre o banco customizado
+     */
+    getCustomDatabaseStatus(): {
+        workspaceId?: string;
+        hasConfig: boolean;
+        lastDetection?: Date;
+        configDetails?: {
+            host: string;
+            port: number;
+            database: string;
+            schema: string;
+            sslEnabled: boolean;
+        };
+    };
 }
 declare function createClient(supabaseUrl: string, supabaseKey: string, options?: EBaaSClientOptions['options']): EBaaSClient;
 
 declare const version = "1.0.0";
 
-export { AuthClient, DatabaseClient, EBaaSClient, EBaaSError, FunctionsClient, HttpClient, QueryBuilder, RealtimeChannel, RealtimeClient, StorageBucket, StorageClient, createClient, version };
-export type { AuthResponse, AuthSession, AuthUser, BroadcastFilter, Bucket, BucketOptions, ChannelSubscription, DatabaseFilters, DeleteOptions, EBaaSClientOptions, EdgeFunction, FunctionDeployOptions, FunctionInvokeOptions, FunctionListResponse, FunctionResponse, InsertOptions, OAuthProvider, PostgresChangesFilter, PresenceFilter, PresenceState, QueryOptions, RealtimeClientOptions, RealtimeEvent, SelectOptions, SignInData, SignUpData, StorageDownloadOptions, StorageFile, StorageListOptions, StorageUploadOptions, StorageUsage, UpdateOptions };
+export { AuthClient, CustomDatabaseManager, DatabaseClient, EBaaSClient, EBaaSError, FunctionsClient, HttpClient, QueryBuilder, RealtimeChannel, RealtimeClient, StorageBucket, StorageClient, createClient, version };
+export type { AuthResponse, AuthSession, AuthUser, BroadcastFilter, Bucket, BucketOptions, ChannelSubscription, CustomDatabaseConfig, CustomDatabaseCredentials, CustomDatabaseDetectionResult, DatabaseFilters, DeleteOptions, EBaaSClientOptions, EdgeFunction, FunctionDeployOptions, FunctionInvokeOptions, FunctionListResponse, FunctionResponse, InsertOptions, OAuthProvider, PostgresChangesFilter, PresenceFilter, PresenceState, QueryOptions, RealtimeClientOptions, RealtimeEvent, SelectOptions, SignInData, SignUpData, StorageDownloadOptions, StorageFile, StorageListOptions, StorageUploadOptions, StorageUsage, UpdateOptions };