@baasix/sdk 0.1.5 → 0.1.7

package/dist/index.d.cts

@@ -365,6 +365,43 @@ declare class PermissionsModule {
      * ```
      */
     reloadCache(): Promise<void>;
+    /**
+     * Export all permissions (admin only)
+     *
+     * @example
+     * ```typescript
+     * const exported = await baasix.permissions.export();
+     * // Save to file or transfer
+     * ```
+     */
+    export(): Promise<{
+        permissions: Permission[];
+        exportedAt: string;
+        version: string;
+    }>;
+    /**
+     * Import permissions from exported data (admin only)
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.permissions.import(exportedData, {
+     *   overwrite: true
+     * });
+     * console.log('Imported:', result.imported, 'permissions');
+     * ```
+     */
+    import(data: {
+        permissions: Array<Partial<Permission>>;
+    }, options?: {
+        overwrite?: boolean;
+    }): Promise<{
+        imported: number;
+        skipped: number;
+        errors: Array<{
+            permission: Partial<Permission>;
+            error: string;
+        }>;
+    }>;
 }
 
 interface SettingsModuleConfig {
@@ -432,6 +469,55 @@ declare class SettingsModule {
      * ```
      */
     set<T>(key: string, value: T): Promise<Settings>;
+    /**
+     * Get settings by application URL (useful for multi-tenant apps)
+     *
+     * @example
+     * ```typescript
+     * const settings = await baasix.settings.getByAppUrl('https://myapp.example.com');
+     * ```
+     */
+    getByAppUrl(appUrl: string): Promise<Settings>;
+    /**
+     * Get email branding settings for the current tenant
+     *
+     * @example
+     * ```typescript
+     * const branding = await baasix.settings.getBranding();
+     * console.log(branding.logo, branding.primaryColor);
+     * ```
+     */
+    getBranding(): Promise<Record<string, unknown>>;
+    /**
+     * Test email configuration by sending a test email
+     *
+     * @example
+     * ```typescript
+     * await baasix.settings.testEmail('admin@example.com');
+     * ```
+     */
+    testEmail(to: string): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Reload settings cache (admin only)
+     *
+     * @example
+     * ```typescript
+     * await baasix.settings.reload();
+     * ```
+     */
+    reload(): Promise<void>;
+    /**
+     * Delete tenant settings (admin only, multi-tenant)
+     *
+     * @example
+     * ```typescript
+     * await baasix.settings.deleteTenant();
+     * ```
+     */
+    deleteTenant(): Promise<void>;
 }
 
 interface ReportsModuleConfig {
@@ -771,6 +857,163 @@ declare class WorkflowsModule {
      * ```
      */
     duplicate(id: string, overrides?: Partial<Omit<Workflow, "id" | "createdAt" | "updatedAt">>): Promise<Workflow>;
+    /**
+     * Execute a specific node in a workflow
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.workflows.executeNode(
+     *   'workflow-uuid',
+     *   'node-id',
+     *   { inputData: 'value' }
+     * );
+     * ```
+     */
+    executeNode(workflowId: string, nodeId: string, triggerData?: Record<string, unknown>): Promise<WorkflowExecution>;
+    /**
+     * Get execution logs for a specific execution
+     *
+     * @example
+     * ```typescript
+     * const logs = await baasix.workflows.getExecutionLogs(
+     *   'workflow-uuid',
+     *   'execution-uuid'
+     * );
+     * ```
+     */
+    getExecutionLogs(workflowId: string, executionId: string): Promise<Array<{
+        timestamp: string;
+        level: string;
+        message: string;
+        nodeId?: string;
+    }>>;
+    /**
+     * Get workflow statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = await baasix.workflows.getStats('workflow-uuid');
+     * console.log(stats.totalExecutions, stats.successRate);
+     * ```
+     */
+    getStats(id: string): Promise<{
+        totalExecutions: number;
+        successCount: number;
+        failedCount: number;
+        successRate: number;
+        avgExecutionTime: number;
+    }>;
+    /**
+     * Validate a workflow definition
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.workflows.validate({
+     *   name: 'My Workflow',
+     *   nodes: [...],
+     *   edges: [...]
+     * });
+     * if (result.valid) {
+     *   console.log('Workflow is valid');
+     * } else {
+     *   console.log('Errors:', result.errors);
+     * }
+     * ```
+     */
+    validate(workflow: Partial<Workflow>): Promise<{
+        valid: boolean;
+        errors?: Array<{
+            path: string;
+            message: string;
+        }>;
+    }>;
+    /**
+     * Export a single workflow
+     *
+     * @example
+     * ```typescript
+     * const exported = await baasix.workflows.export('workflow-uuid');
+     * // Save to file or transfer
+     * ```
+     */
+    export(id: string): Promise<Workflow & {
+        exportedAt: string;
+        version: string;
+    }>;
+    /**
+     * Export multiple workflows
+     *
+     * @example
+     * ```typescript
+     * // Export all workflows
+     * const exported = await baasix.workflows.exportAll();
+     *
+     * // Export specific workflows
+     * const exported = await baasix.workflows.exportAll({
+     *   ids: ['workflow-1', 'workflow-2']
+     * });
+     * ```
+     */
+    exportAll(options?: {
+        ids?: string[];
+        includeInactive?: boolean;
+    }): Promise<{
+        workflows: Array<Workflow & {
+            exportedAt: string;
+        }>;
+        exportedAt: string;
+        version: string;
+    }>;
+    /**
+     * Preview workflow import without applying changes
+     *
+     * @example
+     * ```typescript
+     * const preview = await baasix.workflows.importPreview(file);
+     * console.log('Will import:', preview.workflows.length, 'workflows');
+     * console.log('Conflicts:', preview.conflicts);
+     * ```
+     */
+    importPreview(file: File | {
+        uri: string;
+        name: string;
+        type: string;
+    }): Promise<{
+        workflows: Array<{
+            name: string;
+            id?: string;
+            isNew: boolean;
+        }>;
+        conflicts: Array<{
+            name: string;
+            existingId: string;
+        }>;
+    }>;
+    /**
+     * Import workflows from a file
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.workflows.import(file, {
+     *   overwrite: true
+     * });
+     * console.log('Imported:', result.imported, 'workflows');
+     * ```
+     */
+    import(file: File | {
+        uri: string;
+        name: string;
+        type: string;
+    }, options?: {
+        overwrite?: boolean;
+    }): Promise<{
+        imported: number;
+        skipped: number;
+        errors: Array<{
+            name: string;
+            error: string;
+        }>;
+    }>;
 }
 
 interface SocketOptions {

package/dist/index.d.ts

@@ -365,6 +365,43 @@ declare class PermissionsModule {
      * ```
      */
     reloadCache(): Promise<void>;
+    /**
+     * Export all permissions (admin only)
+     *
+     * @example
+     * ```typescript
+     * const exported = await baasix.permissions.export();
+     * // Save to file or transfer
+     * ```
+     */
+    export(): Promise<{
+        permissions: Permission[];
+        exportedAt: string;
+        version: string;
+    }>;
+    /**
+     * Import permissions from exported data (admin only)
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.permissions.import(exportedData, {
+     *   overwrite: true
+     * });
+     * console.log('Imported:', result.imported, 'permissions');
+     * ```
+     */
+    import(data: {
+        permissions: Array<Partial<Permission>>;
+    }, options?: {
+        overwrite?: boolean;
+    }): Promise<{
+        imported: number;
+        skipped: number;
+        errors: Array<{
+            permission: Partial<Permission>;
+            error: string;
+        }>;
+    }>;
 }
 
 interface SettingsModuleConfig {
@@ -432,6 +469,55 @@ declare class SettingsModule {
      * ```
      */
     set<T>(key: string, value: T): Promise<Settings>;
+    /**
+     * Get settings by application URL (useful for multi-tenant apps)
+     *
+     * @example
+     * ```typescript
+     * const settings = await baasix.settings.getByAppUrl('https://myapp.example.com');
+     * ```
+     */
+    getByAppUrl(appUrl: string): Promise<Settings>;
+    /**
+     * Get email branding settings for the current tenant
+     *
+     * @example
+     * ```typescript
+     * const branding = await baasix.settings.getBranding();
+     * console.log(branding.logo, branding.primaryColor);
+     * ```
+     */
+    getBranding(): Promise<Record<string, unknown>>;
+    /**
+     * Test email configuration by sending a test email
+     *
+     * @example
+     * ```typescript
+     * await baasix.settings.testEmail('admin@example.com');
+     * ```
+     */
+    testEmail(to: string): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Reload settings cache (admin only)
+     *
+     * @example
+     * ```typescript
+     * await baasix.settings.reload();
+     * ```
+     */
+    reload(): Promise<void>;
+    /**
+     * Delete tenant settings (admin only, multi-tenant)
+     *
+     * @example
+     * ```typescript
+     * await baasix.settings.deleteTenant();
+     * ```
+     */
+    deleteTenant(): Promise<void>;
 }
 
 interface ReportsModuleConfig {
@@ -771,6 +857,163 @@ declare class WorkflowsModule {
      * ```
      */
     duplicate(id: string, overrides?: Partial<Omit<Workflow, "id" | "createdAt" | "updatedAt">>): Promise<Workflow>;
+    /**
+     * Execute a specific node in a workflow
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.workflows.executeNode(
+     *   'workflow-uuid',
+     *   'node-id',
+     *   { inputData: 'value' }
+     * );
+     * ```
+     */
+    executeNode(workflowId: string, nodeId: string, triggerData?: Record<string, unknown>): Promise<WorkflowExecution>;
+    /**
+     * Get execution logs for a specific execution
+     *
+     * @example
+     * ```typescript
+     * const logs = await baasix.workflows.getExecutionLogs(
+     *   'workflow-uuid',
+     *   'execution-uuid'
+     * );
+     * ```
+     */
+    getExecutionLogs(workflowId: string, executionId: string): Promise<Array<{
+        timestamp: string;
+        level: string;
+        message: string;
+        nodeId?: string;
+    }>>;
+    /**
+     * Get workflow statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = await baasix.workflows.getStats('workflow-uuid');
+     * console.log(stats.totalExecutions, stats.successRate);
+     * ```
+     */
+    getStats(id: string): Promise<{
+        totalExecutions: number;
+        successCount: number;
+        failedCount: number;
+        successRate: number;
+        avgExecutionTime: number;
+    }>;
+    /**
+     * Validate a workflow definition
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.workflows.validate({
+     *   name: 'My Workflow',
+     *   nodes: [...],
+     *   edges: [...]
+     * });
+     * if (result.valid) {
+     *   console.log('Workflow is valid');
+     * } else {
+     *   console.log('Errors:', result.errors);
+     * }
+     * ```
+     */
+    validate(workflow: Partial<Workflow>): Promise<{
+        valid: boolean;
+        errors?: Array<{
+            path: string;
+            message: string;
+        }>;
+    }>;
+    /**
+     * Export a single workflow
+     *
+     * @example
+     * ```typescript
+     * const exported = await baasix.workflows.export('workflow-uuid');
+     * // Save to file or transfer
+     * ```
+     */
+    export(id: string): Promise<Workflow & {
+        exportedAt: string;
+        version: string;
+    }>;
+    /**
+     * Export multiple workflows
+     *
+     * @example
+     * ```typescript
+     * // Export all workflows
+     * const exported = await baasix.workflows.exportAll();
+     *
+     * // Export specific workflows
+     * const exported = await baasix.workflows.exportAll({
+     *   ids: ['workflow-1', 'workflow-2']
+     * });
+     * ```
+     */
+    exportAll(options?: {
+        ids?: string[];
+        includeInactive?: boolean;
+    }): Promise<{
+        workflows: Array<Workflow & {
+            exportedAt: string;
+        }>;
+        exportedAt: string;
+        version: string;
+    }>;
+    /**
+     * Preview workflow import without applying changes
+     *
+     * @example
+     * ```typescript
+     * const preview = await baasix.workflows.importPreview(file);
+     * console.log('Will import:', preview.workflows.length, 'workflows');
+     * console.log('Conflicts:', preview.conflicts);
+     * ```
+     */
+    importPreview(file: File | {
+        uri: string;
+        name: string;
+        type: string;
+    }): Promise<{
+        workflows: Array<{
+            name: string;
+            id?: string;
+            isNew: boolean;
+        }>;
+        conflicts: Array<{
+            name: string;
+            existingId: string;
+        }>;
+    }>;
+    /**
+     * Import workflows from a file
+     *
+     * @example
+     * ```typescript
+     * const result = await baasix.workflows.import(file, {
+     *   overwrite: true
+     * });
+     * console.log('Imported:', result.imported, 'workflows');
+     * ```
+     */
+    import(file: File | {
+        uri: string;
+        name: string;
+        type: string;
+    }, options?: {
+        overwrite?: boolean;
+    }): Promise<{
+        imported: number;
+        skipped: number;
+        errors: Array<{
+            name: string;
+            error: string;
+        }>;
+    }>;
 }
 
 interface SocketOptions {