@nimbleflux/fluxbase-sdk 2026.3.6 → 2026.3.7-rc.10

package/dist/index.cjs

@@ -7,6 +7,7 @@ var FluxbaseFetch = class {
     this.isRefreshing = false;
     this.refreshPromise = null;
     this.anonKey = null;
+    this.beforeRequestCallback = null;
     this.baseUrl = baseUrl.replace(/\/$/, "");
     this.defaultHeaders = {
       "Content-Type": "application/json",
@@ -22,6 +23,14 @@ var FluxbaseFetch = class {
   setRefreshTokenCallback(callback) {
     this.refreshTokenCallback = callback;
   }
+  /**
+   * Register a callback to be called before every request.
+   * The callback receives the headers object and can modify it in place.
+   * This is useful for dynamically injecting headers at request time.
+   */
+  setBeforeRequestCallback(callback) {
+    this.beforeRequestCallback = callback;
+  }
   /**
    * Set the anon key for fallback authentication
    * When setAuthToken(null) is called, the Authorization header will be
@@ -43,6 +52,18 @@ var FluxbaseFetch = class {
       delete this.defaultHeaders["Authorization"];
     }
   }
+  /**
+   * Set a custom header on all requests
+   */
+  setHeader(name, value) {
+    this.defaultHeaders[name] = value;
+  }
+  /**
+   * Remove a custom header
+   */
+  removeHeader(name) {
+    delete this.defaultHeaders[name];
+  }
   /**
    * Make an HTTP request
    */
@@ -55,15 +76,23 @@ var FluxbaseFetch = class {
   async requestInternal(path, options, isRetry) {
     const url = `${this.baseUrl}${path}`;
     const headers = { ...this.defaultHeaders, ...options.headers };
+    if (this.beforeRequestCallback) {
+      this.beforeRequestCallback(headers);
+    }
     const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? this.timeout);
+    const timeoutId = setTimeout(
+      () => controller.abort(),
+      options.timeout ?? this.timeout
+    );
     if (this.debug) {
       console.log(`[Fluxbase SDK] ${options.method} ${url}`, options.body);
     }
     try {
       const isFormData = options.body && (options.body.constructor?.name === "FormData" || options.body instanceof FormData);
       const requestHeaders = isFormData ? Object.fromEntries(
-        Object.entries(headers).filter(([key]) => key.toLowerCase() !== "content-type")
+        Object.entries(headers).filter(
+          ([key]) => key.toLowerCase() !== "content-type"
+        )
       ) : headers;
       const response = await fetch(url, {
         method: options.method,
@@ -159,7 +188,11 @@ var FluxbaseFetch = class {
    * POST request that returns response with headers (for POST-based queries with count)
    */
   async postWithHeaders(path, body, options = {}) {
-    return this.requestWithHeaders(path, { ...options, method: "POST", body });
+    return this.requestWithHeaders(path, {
+      ...options,
+      method: "POST",
+      body
+    });
   }
   /**
    * Make an HTTP request and return response with headers
@@ -173,15 +206,23 @@ var FluxbaseFetch = class {
   async requestWithHeadersInternal(path, options, isRetry) {
     const url = `${this.baseUrl}${path}`;
     const headers = { ...this.defaultHeaders, ...options.headers };
+    if (this.beforeRequestCallback) {
+      this.beforeRequestCallback(headers);
+    }
     const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? this.timeout);
+    const timeoutId = setTimeout(
+      () => controller.abort(),
+      options.timeout ?? this.timeout
+    );
     if (this.debug) {
       console.log(`[Fluxbase SDK] ${options.method} ${url}`, options.body);
     }
     try {
       const isFormData = options.body && (options.body.constructor?.name === "FormData" || options.body instanceof FormData);
       const requestHeaders = isFormData ? Object.fromEntries(
-        Object.entries(headers).filter(([key]) => key.toLowerCase() !== "content-type")
+        Object.entries(headers).filter(
+          ([key]) => key.toLowerCase() !== "content-type"
+        )
       ) : headers;
       const response = await fetch(url, {
         method: options.method,
@@ -262,6 +303,9 @@ var FluxbaseFetch = class {
   async head(path, options = {}) {
     const url = `${this.baseUrl}${path}`;
     const headers = { ...this.defaultHeaders, ...options.headers };
+    if (this.beforeRequestCallback) {
+      this.beforeRequestCallback(headers);
+    }
     const response = await fetch(url, {
       method: "HEAD",
       headers
@@ -274,9 +318,15 @@ var FluxbaseFetch = class {
   async getBlob(path, options = {}) {
     const url = `${this.baseUrl}${path}`;
     const headers = { ...this.defaultHeaders, ...options.headers };
+    if (this.beforeRequestCallback) {
+      this.beforeRequestCallback(headers);
+    }
     delete headers["Content-Type"];
     const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? this.timeout);
+    const timeoutId = setTimeout(
+      () => controller.abort(),
+      options.timeout ?? this.timeout
+    );
     if (this.debug) {
       console.log(`[Fluxbase SDK] GET (blob) ${url}`);
     }
@@ -2510,7 +2560,11 @@ var StorageBucket = class {
       }
       let response;
       if (options?.onUploadProgress) {
-        response = await this.uploadWithProgress(path, formData, options.onUploadProgress);
+        response = await this.uploadWithProgress(
+          path,
+          formData,
+          options.onUploadProgress
+        );
       } else {
         response = await this.fetch.request(
           `/api/v1/storage/${this.bucketName}/${path}`,
@@ -2618,7 +2672,10 @@ var StorageBucket = class {
   async uploadStream(path, stream, size, options) {
     try {
       if (size <= 0) {
-        return { data: null, error: new Error("size must be a positive number") };
+        return {
+          data: null,
+          error: new Error("size must be a positive number")
+        };
       }
       const headers = {
         ...this.fetch["defaultHeaders"],
@@ -2665,7 +2722,9 @@ var StorageBucket = class {
       );
       if (!response.ok) {
         const errorData = await response.json().catch(() => ({ error: response.statusText }));
-        throw new Error(errorData.error || `Upload failed: ${response.statusText}`);
+        throw new Error(
+          errorData.error || `Upload failed: ${response.statusText}`
+        );
       }
       const result = await response.json();
       return {
@@ -3064,7 +3123,10 @@ var StorageBucket = class {
               return { data: null, error: new Error("Upload aborted") };
             }
             const chunkController = new AbortController();
-            const timeoutId = setTimeout(() => chunkController.abort(), chunkTimeout);
+            const timeoutId = setTimeout(
+              () => chunkController.abort(),
+              chunkTimeout
+            );
             if (options?.signal) {
               options.signal.addEventListener(
                 "abort",
@@ -3271,6 +3333,42 @@ var StorageBucket = class {
       return { data: null, error };
     }
   }
+  /**
+   * Copy a file to a new path
+   *
+   * @param fromPath - Source file path
+   * @param toPath - Destination file path
+   * @returns Promise resolving to { data, error } tuple
+   */
+  async copy(fromPath, toPath) {
+    try {
+      const data = await this.fetch.post(
+        `/api/v1/storage/${this.bucketName}/copy`,
+        { from_path: fromPath, to_path: toPath }
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Move a file to a new path
+   *
+   * @param fromPath - Source file path
+   * @param toPath - Destination file path
+   * @returns Promise resolving to { data, error } tuple
+   */
+  async move(fromPath, toPath) {
+    try {
+      const data = await this.fetch.post(
+        `/api/v1/storage/${this.bucketName}/move`,
+        { from_path: fromPath, to_path: toPath }
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
   /**
    * Get a public URL for a file
    * @param path - The file path
@@ -3393,50 +3491,6 @@ var StorageBucket = class {
       return { data: null, error };
     }
   }
-  /**
-   * Move a file to a new location
-   * @param fromPath - Current file path
-   * @param toPath - New file path
-   */
-  async move(fromPath, toPath) {
-    try {
-      await this.fetch.post(
-        `/api/v1/storage/${this.bucketName}/move`,
-        {
-          from_path: fromPath,
-          to_path: toPath
-        }
-      );
-      return {
-        data: { message: "Successfully moved" },
-        error: null
-      };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Copy a file to a new location
-   * @param fromPath - Source file path
-   * @param toPath - Destination file path
-   */
-  async copy(fromPath, toPath) {
-    try {
-      await this.fetch.post(
-        `/api/v1/storage/${this.bucketName}/copy`,
-        {
-          from_path: fromPath,
-          to_path: toPath
-        }
-      );
-      return {
-        data: { path: toPath },
-        error: null
-      };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
   /**
    * Share a file with another user (RLS)
    * @param path - The file path
@@ -4263,25 +4317,6 @@ var AppSettingsManager = class {
       request
     );
   }
-  /**
-   * Reset all application settings to defaults
-   *
-   * This will delete all custom settings and return to default values.
-   *
-   * @returns Promise resolving to AppSettings - Default settings
-   *
-   * @example
-   * ```typescript
-   * const defaults = await client.admin.settings.app.reset()
-   * console.log('Settings reset to defaults:', defaults)
-   * ```
-   */
-  async reset() {
-    return await this.fetch.post(
-      "/api/v1/admin/app/settings/reset",
-      {}
-    );
-  }
   /**
    * Enable user signup
    *
@@ -4877,6 +4912,14 @@ var AppSettingsManager = class {
     );
     return response.value;
   }
+  /**
+   * Reset all application settings to their default values
+   *
+   * @returns Promise resolving to the default app settings
+   */
+  async reset() {
+    return this.fetch.post("/api/v1/admin/app/settings/reset", {});
+  }
 };
 var EmailTemplateManager = class {
   constructor(fetch2) {
@@ -5130,6 +5173,59 @@ var EmailSettingsManager = class {
   async setProvider(provider) {
     return await this.update({ provider });
   }
+  // Tenant-scoped methods
+  /**
+   * Get tenant-level email settings (resolved through cascade)
+   *
+   * Returns email settings resolved for the current tenant context,
+   * including source information for each field.
+   *
+   * @returns Promise resolving to TenantEmailProviderSettings
+   */
+  async getForTenant() {
+    return await this.fetch.get(
+      "/api/v1/admin/email/settings/tenant"
+    );
+  }
+  /**
+   * Update tenant-level email settings
+   *
+   * Only provided fields are updated. These override instance-level defaults.
+   *
+   * @param request - Settings to update
+   * @returns Promise resolving to TenantEmailProviderSettings
+   */
+  async updateForTenant(request) {
+    return await this.fetch.put(
+      "/api/v1/admin/email/settings/tenant",
+      request
+    );
+  }
+  /**
+   * Delete a tenant-level email setting override
+   *
+   * Removes the tenant override for a specific field, reverting to the instance default.
+   *
+   * @param field - The field name to remove the override for
+   * @returns Promise resolving to TenantEmailProviderSettings
+   */
+  async deleteTenantOverride(field) {
+    return await this.fetch.delete(
+      `/api/v1/admin/email/settings/tenant/${field}`
+    );
+  }
+  /**
+   * Test tenant-level email configuration
+   *
+   * @param recipientEmail - Email address to send the test email to
+   * @returns Promise resolving to TestEmailSettingsResponse
+   */
+  async testForTenant(recipientEmail) {
+    return await this.fetch.post(
+      "/api/v1/admin/email/settings/tenant/test",
+      { recipient_email: recipientEmail }
+    );
+  }
 };
 var FluxbaseSettings = class {
   constructor(fetch2) {
@@ -6130,7 +6226,10 @@ var ClientKeysManager = class {
    * ```
    */
   async create(request) {
-    return await this.fetch.post("/api/v1/client-keys", request);
+    return await this.fetch.post(
+      "/api/v1/client-keys",
+      request
+    );
   }
   /**
    * List all client keys for the authenticated user
@@ -6180,7 +6279,10 @@ var ClientKeysManager = class {
    * ```
    */
   async update(keyId, updates) {
-    return await this.fetch.patch(`/api/v1/client-keys/${keyId}`, updates);
+    return await this.fetch.patch(
+      `/api/v1/client-keys/${keyId}`,
+      updates
+    );
   }
   /**
    * Revoke a client key
@@ -6197,7 +6299,10 @@ var ClientKeysManager = class {
    * ```
    */
   async revoke(keyId) {
-    return await this.fetch.post(`/api/v1/client-keys/${keyId}/revoke`, {});
+    return await this.fetch.post(
+      `/api/v1/client-keys/${keyId}/revoke`,
+      {}
+    );
   }
   /**
    * Delete a client key
@@ -6214,7 +6319,9 @@ var ClientKeysManager = class {
    * ```
    */
   async delete(keyId) {
-    return await this.fetch.delete(`/api/v1/client-keys/${keyId}`);
+    return await this.fetch.delete(
+      `/api/v1/client-keys/${keyId}`
+    );
   }
 };
 var APIKeysManager = ClientKeysManager;
@@ -6289,7 +6396,10 @@ var WebhooksManager = class {
    * ```
    */
   async update(webhookId, updates) {
-    return await this.fetch.patch(`/api/v1/webhooks/${webhookId}`, updates);
+    return await this.fetch.patch(
+      `/api/v1/webhooks/${webhookId}`,
+      updates
+    );
   }
   /**
    * Delete a webhook
@@ -6304,7 +6414,9 @@ var WebhooksManager = class {
    * ```
    */
   async delete(webhookId) {
-    return await this.fetch.delete(`/api/v1/webhooks/${webhookId}`);
+    return await this.fetch.delete(
+      `/api/v1/webhooks/${webhookId}`
+    );
   }
   /**
    * Test a webhook by sending a test payload
@@ -6324,7 +6436,10 @@ var WebhooksManager = class {
    * ```
    */
   async test(webhookId) {
-    return await this.fetch.post(`/api/v1/webhooks/${webhookId}/test`, {});
+    return await this.fetch.post(
+      `/api/v1/webhooks/${webhookId}/test`,
+      {}
+    );
   }
   /**
    * List webhook delivery history
@@ -6371,7 +6486,10 @@ var InvitationsManager = class {
    * ```
    */
   async create(request) {
-    return await this.fetch.post("/api/v1/admin/invitations", request);
+    return await this.fetch.post(
+      "/api/v1/admin/invitations",
+      request
+    );
   }
   /**
    * List all invitations (admin only)
@@ -6424,7 +6542,9 @@ var InvitationsManager = class {
    * ```
    */
   async validate(token) {
-    return await this.fetch.get(`/api/v1/invitations/${token}/validate`);
+    return await this.fetch.get(
+      `/api/v1/invitations/${token}/validate`
+    );
   }
   /**
    * Accept an invitation and create a new user (public endpoint)
@@ -6446,7 +6566,10 @@ var InvitationsManager = class {
    * ```
    */
   async accept(token, request) {
-    return await this.fetch.post(`/api/v1/invitations/${token}/accept`, request);
+    return await this.fetch.post(
+      `/api/v1/invitations/${token}/accept`,
+      request
+    );
   }
   /**
    * Revoke an invitation (admin only)
@@ -6461,7 +6584,9 @@ var InvitationsManager = class {
    * ```
    */
   async revoke(token) {
-    return await this.fetch.delete(`/api/v1/admin/invitations/${token}`);
+    return await this.fetch.delete(
+      `/api/v1/admin/invitations/${token}`
+    );
   }
 };
 var FluxbaseManagement = class {
@@ -7383,24 +7508,14 @@ var FluxbaseAdminJobs = class _FluxbaseAdminJobs {
   /**
    * Create a new job function
    *
-   * @param request - Job function configuration and code
-   * @returns Promise resolving to { data, error } tuple with created job function metadata
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.jobs.create({
-   *   name: 'process-data',
-   *   code: 'export async function handler(req) { return { success: true } }',
-   *   enabled: true,
-   *   timeout_seconds: 300
-   * })
-   * ```
+   * @param params - Job function configuration
+   * @returns Promise resolving to { data, error } tuple with created job function
    */
-  async create(request) {
+  async create(params) {
     try {
       const data = await this.fetch.post(
         "/api/v1/admin/jobs/functions",
-        request
+        params
       );
       return { data, error: null };
     } catch (error) {
@@ -7481,50 +7596,42 @@ var FluxbaseAdminJobs = class _FluxbaseAdminJobs {
     }
   }
   /**
-   * Update an existing job function
+   * Delete a job function
    *
    * @param namespace - Namespace
    * @param name - Job function name
-   * @param updates - Fields to update
-   * @returns Promise resolving to { data, error } tuple with updated job function metadata
+   * @returns Promise resolving to { data, error } tuple
    *
    * @example
    * ```typescript
-   * const { data, error } = await client.admin.jobs.update('default', 'process-data', {
-   *   enabled: false,
-   *   timeout_seconds: 600
-   * })
+   * const { data, error } = await client.admin.jobs.delete('default', 'process-data')
    * ```
    */
-  async update(namespace, name, updates) {
+  async delete(namespace, name) {
     try {
-      const data = await this.fetch.put(
-        `/api/v1/admin/jobs/functions/${namespace}/${name}`,
-        updates
+      await this.fetch.delete(
+        `/api/v1/admin/jobs/functions/${namespace}/${name}`
       );
-      return { data, error: null };
+      return { data: null, error: null };
     } catch (error) {
       return { data: null, error };
     }
   }
   /**
-   * Delete a job function
+   * Update an existing job function
    *
    * @param namespace - Namespace
    * @param name - Job function name
-   * @returns Promise resolving to { data, error } tuple
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.jobs.delete('default', 'process-data')
-   * ```
+   * @param updates - Fields to update
+   * @returns Promise resolving to { data, error } tuple with updated job function
    */
-  async delete(namespace, name) {
+  async update(namespace, name, updates) {
     try {
-      await this.fetch.delete(
-        `/api/v1/admin/jobs/functions/${namespace}/${name}`
+      const data = await this.fetch.put(
+        `/api/v1/admin/jobs/functions/${namespace}/${name}`,
+        updates
       );
-      return { data: null, error: null };
+      return { data, error: null };
     } catch (error) {
       return { data: null, error };
     }
@@ -8039,18 +8146,10 @@ var FluxbaseAdminAI = class {
     }
   }
   /**
-   * Get details of a specific provider
+   * Get details of a specific AI provider
    *
    * @param id - Provider ID
    * @returns Promise resolving to { data, error } tuple with provider details
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.getProvider('uuid')
-   * if (data) {
-   *   console.log('Provider:', data.display_name)
-   * }
-   * ```
    */
   async getProvider(id) {
     try {
@@ -8065,39 +8164,24 @@ var FluxbaseAdminAI = class {
   /**
    * Create a new AI provider
    *
-   * @param request - Provider configuration
+   * @param params - Provider configuration including name, provider_type, and optional config
    * @returns Promise resolving to { data, error } tuple with created provider
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.createProvider({
-   *   name: 'openai-main',
-   *   display_name: 'OpenAI (Main)',
-   *   provider_type: 'openai',
-   *   is_default: true,
-   *   config: {
-   *     api_key: 'sk-...',
-   *     model: 'gpt-4-turbo',
-   *   }
-   * })
-   * ```
    */
-  async createProvider(request) {
+  async createProvider(params) {
     try {
-      const normalizedConfig = {};
-      if (request.config) {
-        for (const [key, value] of Object.entries(request.config)) {
-          if (value !== void 0 && value !== null) {
-            normalizedConfig[key] = String(value);
-          }
-        }
+      const body = {
+        name: params.name,
+        provider_type: params.provider_type
+      };
+      if (params.display_name !== void 0)
+        body.display_name = params.display_name;
+      if (params.is_default !== void 0) body.is_default = params.is_default;
+      if (params.config) {
+        body.config = normalizeConfig(params.config);
       }
       const data = await this.fetch.post(
         "/api/v1/admin/ai/providers",
-        {
-          ...request,
-          config: normalizedConfig
-        }
+        body
       );
       return { data, error: null };
     } catch (error) {
@@ -8110,34 +8194,16 @@ var FluxbaseAdminAI = class {
    * @param id - Provider ID
    * @param updates - Fields to update
    * @returns Promise resolving to { data, error } tuple with updated provider
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.updateProvider('uuid', {
-   *   display_name: 'Updated Name',
-   *   config: {
-   *     api_key: 'new-key',
-   *     model: 'gpt-4-turbo',
-   *   },
-   *   enabled: true,
-   * })
-   * ```
    */
   async updateProvider(id, updates) {
     try {
-      let normalizedUpdates = updates;
+      const body = { ...updates };
       if (updates.config) {
-        const normalizedConfig = {};
-        for (const [key, value] of Object.entries(updates.config)) {
-          if (value !== void 0 && value !== null) {
-            normalizedConfig[key] = String(value);
-          }
-        }
-        normalizedUpdates = { ...updates, config: normalizedConfig };
+        body.config = normalizeConfig(updates.config);
       }
       const data = await this.fetch.put(
         `/api/v1/admin/ai/providers/${id}`,
-        normalizedUpdates
+        body
       );
       return { data, error: null };
     } catch (error) {
@@ -8145,15 +8211,10 @@ var FluxbaseAdminAI = class {
     }
   }
   /**
-   * Set a provider as the default
+   * Set a provider as the default provider
    *
    * @param id - Provider ID
    * @returns Promise resolving to { data, error } tuple with updated provider
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.setDefaultProvider('uuid')
-   * ```
    */
   async setDefaultProvider(id) {
     try {
@@ -8167,15 +8228,10 @@ var FluxbaseAdminAI = class {
     }
   }
   /**
-   * Delete a provider
+   * Delete an AI provider
    *
    * @param id - Provider ID
    * @returns Promise resolving to { data, error } tuple
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.deleteProvider('uuid')
-   * ```
    */
   async deleteProvider(id) {
     try {
@@ -8189,31 +8245,24 @@ var FluxbaseAdminAI = class {
    * Set a provider as the embedding provider
    *
    * @param id - Provider ID
-   * @returns Promise resolving to { data, error } tuple
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.setEmbeddingProvider('uuid')
-   * ```
+   * @returns Promise resolving to { data, error } tuple with updated provider
    */
   async setEmbeddingProvider(id) {
     try {
-      const data = await this.fetch.put(`/api/v1/admin/ai/providers/${id}/embedding`, {});
+      const data = await this.fetch.put(
+        `/api/v1/admin/ai/providers/${id}/embedding`,
+        {}
+      );
       return { data, error: null };
     } catch (error) {
       return { data: null, error };
     }
   }
   /**
-   * Clear explicit embedding provider preference (revert to default)
+   * Clear the embedding provider assignment for a provider
    *
-   * @param id - Provider ID to clear
+   * @param id - Provider ID
    * @returns Promise resolving to { data, error } tuple
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.clearEmbeddingProvider('uuid')
-   * ```
    */
   async clearEmbeddingProvider(id) {
     try {
@@ -8226,308 +8275,6 @@ var FluxbaseAdminAI = class {
     }
   }
   // ============================================================================
-  // KNOWLEDGE BASE MANAGEMENT (RAG)
-  // ============================================================================
-  /**
-   * List all knowledge bases
-   *
-   * @returns Promise resolving to { data, error } tuple with array of knowledge base summaries
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.listKnowledgeBases()
-   * if (data) {
-   *   console.log('Knowledge bases:', data.map(kb => kb.name))
-   * }
-   * ```
-   */
-  async listKnowledgeBases() {
-    try {
-      const response = await this.fetch.get("/api/v1/admin/ai/knowledge-bases");
-      return { data: response.knowledge_bases || [], error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Get a specific knowledge base
-   *
-   * @param id - Knowledge base ID
-   * @returns Promise resolving to { data, error } tuple with knowledge base details
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.getKnowledgeBase('uuid')
-   * if (data) {
-   *   console.log('Knowledge base:', data.name)
-   * }
-   * ```
-   */
-  async getKnowledgeBase(id) {
-    try {
-      const data = await this.fetch.get(
-        `/api/v1/admin/ai/knowledge-bases/${id}`
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Create a new knowledge base
-   *
-   * @param request - Knowledge base configuration
-   * @returns Promise resolving to { data, error } tuple with created knowledge base
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.createKnowledgeBase({
-   *   name: 'product-docs',
-   *   description: 'Product documentation',
-   *   chunk_size: 512,
-   *   chunk_overlap: 50,
-   * })
-   * ```
-   */
-  async createKnowledgeBase(request) {
-    try {
-      const data = await this.fetch.post(
-        "/api/v1/admin/ai/knowledge-bases",
-        request
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Update an existing knowledge base
-   *
-   * @param id - Knowledge base ID
-   * @param updates - Fields to update
-   * @returns Promise resolving to { data, error } tuple with updated knowledge base
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.updateKnowledgeBase('uuid', {
-   *   description: 'Updated description',
-   *   enabled: true,
-   * })
-   * ```
-   */
-  async updateKnowledgeBase(id, updates) {
-    try {
-      const data = await this.fetch.put(
-        `/api/v1/admin/ai/knowledge-bases/${id}`,
-        updates
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Delete a knowledge base
-   *
-   * @param id - Knowledge base ID
-   * @returns Promise resolving to { data, error } tuple
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.deleteKnowledgeBase('uuid')
-   * ```
-   */
-  async deleteKnowledgeBase(id) {
-    try {
-      await this.fetch.delete(`/api/v1/admin/ai/knowledge-bases/${id}`);
-      return { data: null, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
-  // DOCUMENT MANAGEMENT
-  // ============================================================================
-  /**
-   * List documents in a knowledge base
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @returns Promise resolving to { data, error } tuple with array of documents
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.listDocuments('kb-uuid')
-   * if (data) {
-   *   console.log('Documents:', data.map(d => d.title))
-   * }
-   * ```
-   */
-  async listDocuments(knowledgeBaseId) {
-    try {
-      const response = await this.fetch.get(`/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/documents`);
-      return { data: response.documents || [], error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Get a specific document
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param documentId - Document ID
-   * @returns Promise resolving to { data, error } tuple with document details
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.getDocument('kb-uuid', 'doc-uuid')
-   * ```
-   */
-  async getDocument(knowledgeBaseId, documentId) {
-    try {
-      const data = await this.fetch.get(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/documents/${documentId}`
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Add a document to a knowledge base
-   *
-   * Document will be chunked and embedded asynchronously.
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param request - Document content and metadata
-   * @returns Promise resolving to { data, error } tuple with document ID
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.addDocument('kb-uuid', {
-   *   title: 'Getting Started Guide',
-   *   content: 'This is the content of the document...',
-   *   metadata: { category: 'guides' },
-   * })
-   * if (data) {
-   *   console.log('Document ID:', data.document_id)
-   * }
-   * ```
-   */
-  async addDocument(knowledgeBaseId, request) {
-    try {
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/documents`,
-        request
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Upload a document file to a knowledge base
-   *
-   * Supported file types: PDF, TXT, MD, HTML, CSV, DOCX, XLSX, RTF, EPUB, JSON
-   * Maximum file size: 50MB
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param file - File to upload (File or Blob)
-   * @param title - Optional document title (defaults to filename without extension)
-   * @returns Promise resolving to { data, error } tuple with upload result
-   *
-   * @example
-   * ```typescript
-   * // Browser
-   * const fileInput = document.getElementById('file') as HTMLInputElement
-   * const file = fileInput.files?.[0]
-   * if (file) {
-   *   const { data, error } = await client.admin.ai.uploadDocument('kb-uuid', file)
-   *   if (data) {
-   *     console.log('Document ID:', data.document_id)
-   *     console.log('Extracted length:', data.extracted_length)
-   *   }
-   * }
-   *
-   * // Node.js (with node-fetch or similar)
-   * import { Blob } from 'buffer'
-   * const content = await fs.readFile('document.pdf')
-   * const blob = new Blob([content], { type: 'application/pdf' })
-   * const { data, error } = await client.admin.ai.uploadDocument('kb-uuid', blob, 'My Document')
-   * ```
-   */
-  async uploadDocument(knowledgeBaseId, file, title) {
-    try {
-      const formData = new FormData();
-      formData.append("file", file);
-      if (title) {
-        formData.append("title", title);
-      }
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/documents/upload`,
-        formData
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Delete a document from a knowledge base
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param documentId - Document ID
-   * @returns Promise resolving to { data, error } tuple
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.deleteDocument('kb-uuid', 'doc-uuid')
-   * ```
-   */
-  async deleteDocument(knowledgeBaseId, documentId) {
-    try {
-      await this.fetch.delete(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/documents/${documentId}`
-      );
-      return { data: null, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Search a knowledge base
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param query - Search query
-   * @param options - Search options
-   * @returns Promise resolving to { data, error } tuple with search results
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.searchKnowledgeBase('kb-uuid', 'how to reset password', {
-   *   max_chunks: 5,
-   *   threshold: 0.7,
-   * })
-   * if (data) {
-   *   console.log('Results:', data.results.map(r => r.content))
-   * }
-   * ```
-   */
-  async searchKnowledgeBase(knowledgeBaseId, query, options) {
-    try {
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/search`,
-        {
-          query,
-          max_chunks: options?.max_chunks,
-          threshold: options?.threshold
-        }
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
   // CHATBOT KNOWLEDGE BASE LINKING
   // ============================================================================
   /**
@@ -8544,482 +8291,63 @@ var FluxbaseAdminAI = class {
    * }
    * ```
    */
-  async listChatbotKnowledgeBases(chatbotId) {
-    try {
-      const response = await this.fetch.get(`/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases`);
-      return { data: response.knowledge_bases || [], error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Link a knowledge base to a chatbot
-   *
-   * @param chatbotId - Chatbot ID
-   * @param request - Link configuration
-   * @returns Promise resolving to { data, error } tuple with link details
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.linkKnowledgeBase('chatbot-uuid', {
-   *   knowledge_base_id: 'kb-uuid',
-   *   priority: 1,
-   *   max_chunks: 5,
-   *   similarity_threshold: 0.7,
-   * })
-   * ```
-   */
-  async linkKnowledgeBase(chatbotId, request) {
-    try {
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases`,
-        request
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Update a chatbot-knowledge base link
-   *
-   * @param chatbotId - Chatbot ID
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param updates - Fields to update
-   * @returns Promise resolving to { data, error } tuple with updated link
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.updateChatbotKnowledgeBase(
-   *   'chatbot-uuid',
-   *   'kb-uuid',
-   *   { max_chunks: 10, enabled: true }
-   * )
-   * ```
-   */
-  async updateChatbotKnowledgeBase(chatbotId, knowledgeBaseId, updates) {
-    try {
-      const data = await this.fetch.put(
-        `/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases/${knowledgeBaseId}`,
-        updates
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Unlink a knowledge base from a chatbot
-   *
-   * @param chatbotId - Chatbot ID
-   * @param knowledgeBaseId - Knowledge base ID
-   * @returns Promise resolving to { data, error } tuple
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.unlinkKnowledgeBase('chatbot-uuid', 'kb-uuid')
-   * ```
-   */
-  async unlinkKnowledgeBase(chatbotId, knowledgeBaseId) {
-    try {
-      await this.fetch.delete(
-        `/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases/${knowledgeBaseId}`
-      );
-      return { data: null, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
-  // DOCUMENT UPDATE AND BULK DELETE
-  // ============================================================================
-  /**
-   * Update a document in a knowledge base
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param documentId - Document ID
-   * @param updates - Fields to update
-   * @returns Promise resolving to { data, error } tuple with updated document
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.updateDocument('kb-uuid', 'doc-uuid', {
-   *   title: 'Updated Title',
-   *   tags: ['updated', 'tag'],
-   *   metadata: { category: 'updated' },
-   * })
-   * ```
-   */
-  async updateDocument(knowledgeBaseId, documentId, updates) {
-    try {
-      const data = await this.fetch.patch(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/documents/${documentId}`,
-        updates
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Delete documents from a knowledge base by filter
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param filter - Filter criteria for deletion
-   * @returns Promise resolving to { data, error } tuple with deletion count
-   *
-   * @example
-   * ```typescript
-   * // Delete by tags
-   * const { data, error } = await client.admin.ai.deleteDocumentsByFilter('kb-uuid', {
-   *   tags: ['deprecated', 'archive'],
-   * })
-   *
-   * // Delete by metadata
-   * const { data, error } = await client.admin.ai.deleteDocumentsByFilter('kb-uuid', {
-   *   metadata: { source: 'legacy-system' },
-   * })
-   *
-   * if (data) {
-   *   console.log(`Deleted ${data.deleted_count} documents`)
-   * }
-   * ```
-   */
-  async deleteDocumentsByFilter(knowledgeBaseId, filter) {
-    try {
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/documents/delete-by-filter`,
-        filter
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
-  // KNOWLEDGE BASE CAPABILITIES
-  // ============================================================================
-  /**
-   * Get knowledge base system capabilities
-   *
-   * Returns information about OCR support, supported file types, etc.
-   *
-   * @returns Promise resolving to { data, error } tuple with capabilities
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.getCapabilities()
-   * if (data) {
-   *   console.log('OCR available:', data.ocr_available)
-   *   console.log('Supported types:', data.supported_file_types)
-   * }
-   * ```
-   */
-  async getCapabilities() {
-    try {
-      const data = await this.fetch.get(
-        "/api/v1/admin/ai/knowledge-bases/capabilities"
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
-  // KNOWLEDGE GRAPH / ENTITIES
-  // ============================================================================
-  /**
-   * List entities in a knowledge base
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param entityType - Optional entity type filter
-   * @returns Promise resolving to { data, error } tuple with array of entities
-   *
-   * @example
-   * ```typescript
-   * // List all entities
-   * const { data, error } = await client.admin.ai.listEntities('kb-uuid')
-   *
-   * // Filter by type
-   * const { data, error } = await client.admin.ai.listEntities('kb-uuid', 'person')
-   *
-   * if (data) {
-   *   console.log('Entities:', data.map(e => e.name))
-   * }
-   * ```
-   */
-  async listEntities(knowledgeBaseId, entityType) {
-    try {
-      const params = entityType ? `?entity_type=${entityType}` : "";
-      const response = await this.fetch.get(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/entities${params}`
-      );
-      return { data: response.entities || [], error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Search for entities in a knowledge base
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param query - Search query
-   * @param types - Optional entity type filters
-   * @returns Promise resolving to { data, error } tuple with matching entities
-   *
-   * @example
-   * ```typescript
-   * // Search all entity types
-   * const { data, error } = await client.admin.ai.searchEntities('kb-uuid', 'John')
-   *
-   * // Search specific types
-   * const { data, error } = await client.admin.ai.searchEntities('kb-uuid', 'Apple', ['organization', 'product'])
-   *
-   * if (data) {
-   *   console.log('Found entities:', data.map(e => `${e.name} (${e.entity_type})`))
-   * }
-   * ```
-   */
-  async searchEntities(knowledgeBaseId, query, types) {
-    try {
-      const params = new URLSearchParams({ query });
-      if (types && types.length > 0) {
-        params.append("types", types.join(","));
-      }
-      const response = await this.fetch.get(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/entities/search?${params.toString()}`
-      );
-      return { data: response.entities || [], error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Get relationships for a specific entity
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param entityId - Entity ID
-   * @returns Promise resolving to { data, error } tuple with entity relationships
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.getEntityRelationships('kb-uuid', 'entity-uuid')
-   * if (data) {
-   *   console.log('Relationships:', data.map(r => `${r.relationship_type} -> ${r.target_entity?.name}`))
-   * }
-   * ```
-   */
-  async getEntityRelationships(knowledgeBaseId, entityId) {
-    try {
-      const response = await this.fetch.get(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/entities/${entityId}/relationships`
-      );
-      return { data: response.relationships || [], error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Get the knowledge graph for a knowledge base
-   *
-   * Returns all entities and relationships for visualization.
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @returns Promise resolving to { data, error } tuple with graph data
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.getKnowledgeGraph('kb-uuid')
-   * if (data) {
-   *   console.log('Graph:', data.entity_count, 'entities,', data.relationship_count, 'relationships')
-   *   // Use with visualization libraries like D3.js, Cytoscape.js, etc.
-   * }
-   * ```
-   */
-  async getKnowledgeGraph(knowledgeBaseId) {
-    try {
-      const data = await this.fetch.get(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/graph`
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
-  // KNOWLEDGE BASE REVERSE LOOKUP
-  // ============================================================================
-  /**
-   * List all chatbots that use a specific knowledge base
-   *
-   * Reverse lookup to find which chatbots are linked to a knowledge base.
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @returns Promise resolving to { data, error } tuple with array of chatbot summaries
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.listChatbotsUsingKB('kb-uuid')
-   * if (data) {
-   *   console.log('Used by chatbots:', data.map(c => c.name))
-   * }
-   * ```
-   */
-  async listChatbotsUsingKB(knowledgeBaseId) {
-    try {
-      const response = await this.fetch.get(`/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/chatbots`);
-      return { data: response.chatbots || [], error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
-  // TABLE EXPORT
-  // ============================================================================
-  /**
-   * Export a database table to a knowledge base
-   *
-   * The table schema will be exported as a markdown document and indexed.
-   * Optionally filter which columns to export for security or relevance.
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param options - Export options including column selection
-   * @returns Promise resolving to { data, error } tuple with export result
-   *
-   * @example
-   * ```typescript
-   * // Export all columns
-   * const { data, error } = await client.admin.ai.exportTable('kb-uuid', {
-   *   schema: 'public',
-   *   table: 'users',
-   *   include_foreign_keys: true,
-   * })
-   *
-   * // Export specific columns (recommended for sensitive data)
-   * const { data, error } = await client.admin.ai.exportTable('kb-uuid', {
-   *   schema: 'public',
-   *   table: 'users',
-   *   columns: ['id', 'name', 'email', 'created_at'],
-   * })
-   * ```
-   */
-  async exportTable(knowledgeBaseId, options) {
-    try {
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/tables/export`,
-        options
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  /**
-   * Get detailed table information including columns
-   *
-   * Use this to discover available columns before exporting.
-   *
-   * @param schema - Schema name (e.g., 'public')
-   * @param table - Table name
-   * @returns Promise resolving to { data, error } tuple with table details
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.getTableDetails('public', 'users')
-   * if (data) {
-   *   console.log('Columns:', data.columns.map(c => c.name))
-   *   console.log('Primary key:', data.primary_key)
-   * }
-   * ```
-   */
-  async getTableDetails(schema, table) {
-    try {
-      const data = await this.fetch.get(
-        `/api/v1/admin/ai/tables/${schema}/${table}`
-      );
-      return { data, error: null };
-    } catch (error) {
-      return { data: null, error };
-    }
-  }
-  // ============================================================================
-  // TABLE EXPORT PRESETS
-  // ============================================================================
-  /**
-   * Create a table export preset
-   *
-   * Saves a table export configuration for easy re-export. Use triggerTableExportSync
-   * to re-export when the schema changes.
-   *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param config - Export preset configuration
-   * @returns Promise resolving to { data, error } tuple with created preset
-   *
-   * @example
-   * ```typescript
-   * const { data, error } = await client.admin.ai.createTableExportSync('kb-uuid', {
-   *   schema_name: 'public',
-   *   table_name: 'products',
-   *   columns: ['id', 'name', 'description', 'price'],
-   *   include_foreign_keys: true,
-   *   export_now: true, // Trigger initial export
-   * })
-   * ```
-   */
-  async createTableExportSync(knowledgeBaseId, config) {
-    try {
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/sync-configs`,
-        config
-      );
-      return { data, error: null };
+  async listChatbotKnowledgeBases(chatbotId) {
+    try {
+      const response = await this.fetch.get(`/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases`);
+      return { data: response.knowledge_bases || [], error: null };
     } catch (error) {
       return { data: null, error };
     }
   }
   /**
-   * List table export presets for a knowledge base
+   * Link a knowledge base to a chatbot
    *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @returns Promise resolving to { data, error } tuple with array of presets
+   * @param chatbotId - Chatbot ID
+   * @param request - Link configuration
+   * @returns Promise resolving to { data, error } tuple with link details
    *
    * @example
    * ```typescript
-   * const { data, error } = await client.admin.ai.listTableExportSyncs('kb-uuid')
-   * if (data) {
-   *   data.forEach(config => {
-   *     console.log(`${config.schema_name}.${config.table_name}`)
-   *   })
-   * }
+   * const { data, error } = await client.admin.ai.linkKnowledgeBase('chatbot-uuid', {
+   *   knowledge_base_id: 'kb-uuid',
+   *   priority: 1,
+   *   max_chunks: 5,
+   *   similarity_threshold: 0.7,
+   * })
    * ```
    */
-  async listTableExportSyncs(knowledgeBaseId) {
+  async linkKnowledgeBase(chatbotId, request) {
     try {
-      const response = await this.fetch.get(`/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/sync-configs`);
-      return { data: response.sync_configs || [], error: null };
+      const data = await this.fetch.post(
+        `/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases`,
+        request
+      );
+      return { data, error: null };
     } catch (error) {
       return { data: null, error };
     }
   }
   /**
-   * Update a table export preset
+   * Update a chatbot-knowledge base link
    *
+   * @param chatbotId - Chatbot ID
    * @param knowledgeBaseId - Knowledge base ID
-   * @param syncId - Preset ID
    * @param updates - Fields to update
-   * @returns Promise resolving to { data, error } tuple with updated preset
+   * @returns Promise resolving to { data, error } tuple with updated link
    *
    * @example
    * ```typescript
-   * const { data, error } = await client.admin.ai.updateTableExportSync('kb-uuid', 'sync-id', {
-   *   columns: ['id', 'name', 'email', 'updated_at'],
-   * })
+   * const { data, error } = await client.admin.ai.updateChatbotKnowledgeBase(
+   *   'chatbot-uuid',
+   *   'kb-uuid',
+   *   { max_chunks: 10, enabled: true }
+   * )
    * ```
    */
-  async updateTableExportSync(knowledgeBaseId, syncId, updates) {
+  async updateChatbotKnowledgeBase(chatbotId, knowledgeBaseId, updates) {
     try {
-      const data = await this.fetch.patch(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/sync-configs/${syncId}`,
+      const data = await this.fetch.put(
+        `/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases/${knowledgeBaseId}`,
         updates
       );
       return { data, error: null };
@@ -9028,50 +8356,52 @@ var FluxbaseAdminAI = class {
     }
   }
   /**
-   * Delete a table export sync configuration
+   * Unlink a knowledge base from a chatbot
    *
+   * @param chatbotId - Chatbot ID
    * @param knowledgeBaseId - Knowledge base ID
-   * @param syncId - Sync config ID
    * @returns Promise resolving to { data, error } tuple
    *
    * @example
    * ```typescript
-   * const { data, error } = await client.admin.ai.deleteTableExportSync('kb-uuid', 'sync-id')
+   * const { data, error } = await client.admin.ai.unlinkKnowledgeBase('chatbot-uuid', 'kb-uuid')
    * ```
    */
-  async deleteTableExportSync(knowledgeBaseId, syncId) {
+  async unlinkKnowledgeBase(chatbotId, knowledgeBaseId) {
     try {
       await this.fetch.delete(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/sync-configs/${syncId}`
+        `/api/v1/admin/ai/chatbots/${chatbotId}/knowledge-bases/${knowledgeBaseId}`
       );
       return { data: null, error: null };
     } catch (error) {
       return { data: null, error };
     }
   }
+  // ============================================================================
+  // TABLE DETAILS
+  // ============================================================================
   /**
-   * Manually trigger a table export sync
+   * Get detailed table information including columns
    *
-   * Immediately re-exports the table to the knowledge base,
-   * regardless of the sync mode.
+   * Use this to discover available columns before exporting.
    *
-   * @param knowledgeBaseId - Knowledge base ID
-   * @param syncId - Sync config ID
-   * @returns Promise resolving to { data, error } tuple with export result
+   * @param schema - Schema name (e.g., 'public')
+   * @param table - Table name
+   * @returns Promise resolving to { data, error } tuple with table details
    *
    * @example
    * ```typescript
-   * const { data, error } = await client.admin.ai.triggerTableExportSync('kb-uuid', 'sync-id')
+   * const { data, error } = await client.admin.ai.getTableDetails('public', 'users')
    * if (data) {
-   *   console.log('Exported document:', data.document_id)
+   *   console.log('Columns:', data.columns.map(c => c.name))
+   *   console.log('Primary key:', data.primary_key)
    * }
    * ```
    */
-  async triggerTableExportSync(knowledgeBaseId, syncId) {
+  async getTableDetails(schema, table) {
     try {
-      const data = await this.fetch.post(
-        `/api/v1/admin/ai/knowledge-bases/${knowledgeBaseId}/sync-configs/${syncId}/trigger`,
-        {}
+      const data = await this.fetch.get(
+        `/api/v1/admin/ai/tables/${schema}/${table}`
       );
       return { data, error: null };
     } catch (error) {
@@ -9079,6 +8409,14 @@ var FluxbaseAdminAI = class {
     }
   }
 };
+function normalizeConfig(config) {
+  const result = {};
+  for (const [key, value] of Object.entries(config)) {
+    if (value === void 0 || value === null) continue;
+    result[key] = String(value);
+  }
+  return result;
+}
 
 // src/admin-rpc.ts
 var FluxbaseAdminRPC = class {
@@ -9593,19 +8931,18 @@ var FluxbaseAdminStorage = class {
     });
   }
   /**
-   * Generate a signed URL for temporary access
+   * Generate a signed URL for a private object
    *
    * @param bucket - Bucket name
    * @param key - Object key (path)
-   * @param expiresIn - Expiration time in seconds
+   * @param expiresIn - URL expiration time in seconds
    * @returns Signed URL and expiration info
    *
    * @example
    * ```typescript
    * const { data } = await admin.storage.generateSignedUrl('my-bucket', 'file.pdf', 3600);
    * if (data) {
-   *   console.log(`Download at: ${data.url}`);
-   *   console.log(`Expires in: ${data.expires_in} seconds`);
+   *   window.open(data.url);
    * }
    * ```
    */
@@ -9613,7 +8950,7 @@ var FluxbaseAdminStorage = class {
     return wrapAsync(async () => {
       const encodedKey = key.split("/").map((s) => encodeURIComponent(s)).join("/");
       return await this.fetch.post(
-        `/api/v1/storage/${encodeURIComponent(bucket)}/${encodedKey}/signed-url`,
+        `/api/v1/storage/${encodeURIComponent(bucket)}/sign/${encodedKey}`,
         { expires_in: expiresIn }
       );
     });
@@ -9732,53 +9069,318 @@ var FluxbaseAdminRealtime = class {
    * ```typescript
    * const status = await client.admin.realtime.getStatus('public', 'products')
    *
-   * if (status.realtime_enabled) {
-   *   console.log('Events:', status.events.join(', '))
-   *   console.log('Excluded:', status.excluded_columns?.join(', ') || 'none')
-   * } else {
-   *   console.log('Realtime not enabled')
+   * if (status.realtime_enabled) {
+   *   console.log('Events:', status.events.join(', '))
+   *   console.log('Excluded:', status.excluded_columns?.join(', ') || 'none')
+   * } else {
+   *   console.log('Realtime not enabled')
+   * }
+   * ```
+   */
+  async getStatus(schema, table) {
+    return await this.fetch.get(
+      `/api/v1/admin/realtime/tables/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`
+    );
+  }
+  /**
+   * Update realtime configuration for a table
+   *
+   * Modifies the events or excluded columns for a realtime-enabled table
+   * without recreating the trigger.
+   *
+   * @param schema - Schema name
+   * @param table - Table name
+   * @param config - New configuration
+   * @returns Promise resolving to success message
+   *
+   * @example
+   * ```typescript
+   * // Change which events are tracked
+   * await client.admin.realtime.updateConfig('public', 'products', {
+   *   events: ['INSERT', 'UPDATE'] // Stop tracking deletes
+   * })
+   *
+   * // Update excluded columns
+   * await client.admin.realtime.updateConfig('public', 'posts', {
+   *   exclude: ['raw_content', 'search_vector']
+   * })
+   *
+   * // Clear excluded columns
+   * await client.admin.realtime.updateConfig('public', 'posts', {
+   *   exclude: [] // Include all columns again
+   * })
+   * ```
+   */
+  async updateConfig(schema, table, config) {
+    return await this.fetch.patch(
+      `/api/v1/admin/realtime/tables/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`,
+      config
+    );
+  }
+};
+
+// src/admin-service-keys.ts
+var ServiceKeysManager = class {
+  constructor(fetch2) {
+    this.fetch = fetch2;
+  }
+  /**
+   * List all service keys
+   *
+   * @returns List of service keys
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.admin.serviceKeys.list()
+   * ```
+   */
+  async list() {
+    try {
+      const data = await this.fetch.get("/api/v1/admin/service-keys");
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Get a service key by ID
+   *
+   * @param id - Service key ID
+   * @returns Service key details
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.admin.serviceKeys.get('key-id')
+   * ```
+   */
+  async get(id) {
+    try {
+      const data = await this.fetch.get(`/api/v1/admin/service-keys/${id}`);
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Create a new service key
+   *
+   * The full key value is only returned once - store it securely!
+   *
+   * @param request - Key creation options
+   * @returns Created key with full key value
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.admin.serviceKeys.create({
+   *   name: 'Production API Key',
+   *   key_type: 'service',
+   *   scopes: ['*'],
+   *   rate_limit_per_minute: 1000
+   * })
+   *
+   * if (data) {
+   *   // Store data.key securely - it won't be shown again!
+   *   console.log('Key created:', data.key)
+   * }
+   * ```
+   */
+  async create(request) {
+    try {
+      const data = await this.fetch.post(
+        "/api/v1/admin/service-keys",
+        request
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Update a service key
+   *
+   * @param id - Service key ID
+   * @param request - Update options
+   * @returns Updated key
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.admin.serviceKeys.update('key-id', {
+   *   name: 'New Name',
+   *   rate_limit_per_minute: 2000
+   * })
+   * ```
+   */
+  async update(id, request) {
+    try {
+      const data = await this.fetch.put(
+        `/api/v1/admin/service-keys/${id}`,
+        request
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Delete a service key permanently
+   *
+   * @param id - Service key ID
+   * @returns Success or error
+   *
+   * @example
+   * ```typescript
+   * const { error } = await client.admin.serviceKeys.delete('key-id')
+   * ```
+   */
+  async delete(id) {
+    try {
+      await this.fetch.delete(`/api/v1/admin/service-keys/${id}`);
+      return { error: null };
+    } catch (error) {
+      return { error };
+    }
+  }
+  /**
+   * Disable a service key (temporarily)
+   *
+   * @param id - Service key ID
+   * @returns Success or error
+   *
+   * @example
+   * ```typescript
+   * const { error } = await client.admin.serviceKeys.disable('key-id')
+   * ```
+   */
+  async disable(id) {
+    try {
+      await this.fetch.post(`/api/v1/admin/service-keys/${id}/disable`, {});
+      return { error: null };
+    } catch (error) {
+      return { error };
+    }
+  }
+  /**
+   * Enable a disabled service key
+   *
+   * @param id - Service key ID
+   * @returns Success or error
+   *
+   * @example
+   * ```typescript
+   * const { error } = await client.admin.serviceKeys.enable('key-id')
+   * ```
+   */
+  async enable(id) {
+    try {
+      await this.fetch.post(`/api/v1/admin/service-keys/${id}/enable`, {});
+      return { error: null };
+    } catch (error) {
+      return { error };
+    }
+  }
+  /**
+   * Revoke a service key permanently (emergency)
+   *
+   * Use for immediate revocation when a key is compromised.
+   *
+   * @param id - Service key ID
+   * @param request - Revocation options
+   * @returns Success or error
+   *
+   * @example
+   * ```typescript
+   * const { error } = await client.admin.serviceKeys.revoke('key-id', {
+   *   reason: 'Key was compromised'
+   * })
+   * ```
+   */
+  async revoke(id, request) {
+    try {
+      const body = request?.reason ? new URLSearchParams({ reason: request.reason }) : {};
+      await this.fetch.post(`/api/v1/admin/service-keys/${id}/revoke`, body);
+      return { error: null };
+    } catch (error) {
+      return { error };
+    }
+  }
+  /**
+   * Deprecate a service key (graceful rotation)
+   *
+   * Marks the key for removal but keeps it active during grace period.
+   *
+   * @param id - Service key ID
+   * @param request - Deprecation options
+   * @returns Deprecation details
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.admin.serviceKeys.deprecate('key-id', {
+   *   reason: 'Rotating to new key',
+   *   grace_period_hours: 48
+   * })
+   * ```
+   */
+  async deprecate(id, request) {
+    try {
+      const params = new URLSearchParams();
+      if (request?.grace_period_hours) {
+        params.set("grace_period_hours", String(request.grace_period_hours));
+      }
+      const body = request?.grace_period_hours ? Object.fromEntries(params) : {};
+      const data = await this.fetch.post(`/api/v1/admin/service-keys/${id}/deprecate`, body);
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Rotate a service key (create replacement)
+   *
+   * Creates a new key with the same settings and deprecates the old one.
+   * The new key is returned with its full value.
+   *
+   * @param id - Service key ID to rotate
+   * @returns New key with full key value
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.admin.serviceKeys.rotate('old-key-id')
+   *
+   * if (data) {
+   *   console.log('New key:', data.key)
+   *   console.log('Old key deprecated at:', data.deprecated_at)
    * }
    * ```
    */
-  async getStatus(schema, table) {
-    return await this.fetch.get(
-      `/api/v1/admin/realtime/tables/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`
-    );
+  async rotate(id) {
+    try {
+      const data = await this.fetch.post(
+        `/api/v1/admin/service-keys/${id}/rotate`,
+        {}
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
   }
   /**
-   * Update realtime configuration for a table
-   *
-   * Modifies the events or excluded columns for a realtime-enabled table
-   * without recreating the trigger.
+   * Get revocation history for a service key
    *
-   * @param schema - Schema name
-   * @param table - Table name
-   * @param config - New configuration
-   * @returns Promise resolving to success message
+   * @param id - Service key ID
+   * @returns Revocation history
    *
    * @example
    * ```typescript
-   * // Change which events are tracked
-   * await client.admin.realtime.updateConfig('public', 'products', {
-   *   events: ['INSERT', 'UPDATE'] // Stop tracking deletes
-   * })
-   *
-   * // Update excluded columns
-   * await client.admin.realtime.updateConfig('public', 'posts', {
-   *   exclude: ['raw_content', 'search_vector']
-   * })
-   *
-   * // Clear excluded columns
-   * await client.admin.realtime.updateConfig('public', 'posts', {
-   *   exclude: [] // Include all columns again
-   * })
+   * const { data, error } = await client.admin.serviceKeys.getRevocationHistory('key-id')
    * ```
    */
-  async updateConfig(schema, table, config) {
-    return await this.fetch.patch(
-      `/api/v1/admin/realtime/tables/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`,
-      config
-    );
+  async getRevocationHistory(id) {
+    try {
+      const data = await this.fetch.get(`/api/v1/admin/service-keys/${id}/revocations`);
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
   }
 };
 
@@ -9800,6 +9402,7 @@ var FluxbaseAdmin = class {
     this.rpc = new FluxbaseAdminRPC(fetch2);
     this.storage = new FluxbaseAdminStorage(fetch2);
     this.realtime = new FluxbaseAdminRealtime(fetch2);
+    this.serviceKeys = new ServiceKeysManager(fetch2);
   }
   /**
    * Set admin authentication token
@@ -9845,31 +9448,6 @@ var FluxbaseAdmin = class {
     });
   }
   // ============================================================================
-  // Email
-  // ============================================================================
-  /**
-   * Send an email
-   *
-   * @param request - Email details (to, subject, html/text)
-   *
-   * @example
-   * ```typescript
-   * const { error } = await admin.sendEmail({
-   *   to: 'user@example.com',
-   *   subject: 'Hello',
-   *   html: '<p>Your message here</p>'
-   * });
-   * if (!error) {
-   *   console.log('Email sent');
-   * }
-   * ```
-   */
-  async sendEmail(request) {
-    return wrapAsyncVoid(async () => {
-      await this.fetch.post("/api/v1/admin/email/send", request);
-    });
-  }
-  // ============================================================================
   // Admin Authentication
   // ============================================================================
   /**
@@ -11624,6 +11202,228 @@ var FluxbaseBranching = class {
   }
 };
 
+// src/tenant.ts
+var FluxbaseTenant = class {
+  constructor(fetch2) {
+    this.fetch = fetch2;
+  }
+  /**
+   * List all tenants (instance admin only)
+   *
+   * @returns Promise with tenants list or error
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.list()
+   * ```
+   */
+  async list() {
+    try {
+      const data = await this.fetch.get("/api/v1/admin/tenants");
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * List tenants the current user has access to
+   *
+   * @returns Promise with tenants and user's role in each
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.listMine()
+   * // data: [{ id: '...', slug: 'acme', name: 'Acme', my_role: 'tenant_admin', status: 'active' }]
+   * ```
+   */
+  async listMine() {
+    try {
+      const data = await this.fetch.get("/api/v1/admin/tenants/mine");
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Get a tenant by ID
+   *
+   * @param id - Tenant ID
+   * @returns Promise with tenant details or error
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.get('tenant-id')
+   * ```
+   */
+  async get(id) {
+    try {
+      const data = await this.fetch.get(`/api/v1/admin/tenants/${id}`);
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Create a new tenant (instance admin only)
+   *
+   * This creates a new isolated database for the tenant.
+   *
+   * @param options - Tenant creation options
+   * @returns Promise with created tenant or error
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.create({
+   *   slug: 'acme-corp',
+   *   name: 'Acme Corporation',
+   *   metadata: { plan: 'enterprise' }
+   * })
+   * ```
+   */
+  async create(options) {
+    try {
+      const data = await this.fetch.post("/api/v1/admin/tenants", options);
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Update a tenant (tenant admin only)
+   *
+   * @param id - Tenant ID
+   * @param options - Update options
+   * @returns Promise with updated tenant or error
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.update('tenant-id', {
+   *   name: 'New Name'
+   * })
+   * ```
+   */
+  async update(id, options) {
+    try {
+      const data = await this.fetch.patch(`/api/v1/admin/tenants/${id}`, options);
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Delete a tenant (instance admin only)
+   *
+   * This permanently deletes the tenant's database and all its data.
+   * Cannot delete the default tenant.
+   *
+   * @param id - Tenant ID
+   * @returns Promise that resolves when deleted
+   *
+   * @example
+   * ```typescript
+   * const { error } = await client.tenant.delete('tenant-id')
+   * ```
+   */
+  async delete(id) {
+    try {
+      await this.fetch.delete(`/api/v1/admin/tenants/${id}`);
+      return { data: void 0, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Migrate a tenant database to the latest schema (instance admin only)
+   *
+   * @param id - Tenant ID
+   * @returns Promise with migration status or error
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.migrate('tenant-id')
+   * // data: { status: 'migrated' }
+   * ```
+   */
+  async migrate(id) {
+    try {
+      const data = await this.fetch.post(
+        `/api/v1/admin/tenants/${id}/migrate`,
+        {}
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * List admins of a tenant
+   *
+   * @param tenantId - Tenant ID
+   * @returns Promise with admin list or error
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.listAdmins('tenant-id')
+   * // data: [{ id: '...', tenant_id: '...', user_id: '...', email: 'admin@example.com' }]
+   * ```
+   */
+  async listAdmins(tenantId) {
+    try {
+      const data = await this.fetch.get(
+        `/api/v1/admin/tenants/${tenantId}/admins`
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Assign an admin to a tenant (tenant admin only)
+   *
+   * @param tenantId - Tenant ID
+   * @param options - Admin assignment options
+   * @returns Promise with created assignment or error
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.tenant.assignAdmin('tenant-id', {
+   *   user_id: 'user-id'
+   * })
+   * ```
+   */
+  async assignAdmin(tenantId, options) {
+    try {
+      const data = await this.fetch.post(
+        `/api/v1/admin/tenants/${tenantId}/admins`,
+        options
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+  /**
+   * Remove an admin from a tenant (tenant admin only)
+   *
+   * @param tenantId - Tenant ID
+   * @param userId - User ID
+   * @returns Promise that resolves when removed
+   *
+   * @example
+   * ```typescript
+   * const { error } = await client.tenant.removeAdmin('tenant-id', 'user-id')
+   * ```
+   */
+  async removeAdmin(tenantId, userId) {
+    try {
+      await this.fetch.delete(`/api/v1/admin/tenants/${tenantId}/admins/${userId}`);
+      return { data: void 0, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
+};
+
 // src/query-builder.ts
 var URL_LENGTH_THRESHOLD = 4096;
 var QueryBuilder = class {
@@ -12915,7 +12715,7 @@ var SchemaQueryBuilder = class {
 };
 
 // src/client.ts
-var FluxbaseClient = class {
+var FluxbaseClient = class _FluxbaseClient {
   /**
    * Create a new Fluxbase client instance
    *
@@ -12935,6 +12735,7 @@ var FluxbaseClient = class {
   constructor(fluxbaseUrl, fluxbaseKey, options) {
     this.fluxbaseUrl = fluxbaseUrl;
     this.fluxbaseKey = fluxbaseKey;
+    this.options = options;
     const headers = {
       apikey: fluxbaseKey,
       Authorization: `Bearer ${fluxbaseKey}`,
@@ -12987,6 +12788,7 @@ var FluxbaseClient = class {
       waitForCompletion: rpcInstance.waitForCompletion.bind(rpcInstance)
     });
     this.rpc = rpcCallable;
+    this.tenant = new FluxbaseTenant(this.fetch);
     this.setupAuthSync();
   }
   /**
@@ -13092,6 +12894,96 @@ var FluxbaseClient = class {
     this.fetch.setAuthToken(token);
     this.realtime.setAuth(token);
   }
+  /**
+   * Get the current tenant ID
+   *
+   * Returns the tenant ID from X-FB-Tenant header or JWT claim, or default tenant.
+   *
+   * @returns The current tenant ID, or undefined if not set
+   *
+   * @category Multi-Tenancy
+   */
+  getTenantId() {
+    return this._tenantId;
+  }
+  /**
+   * Set the tenant context for all subsequent requests
+   *
+   * This adds the X-FB-Tenant header to all HTTP requests and updates
+   * the realtime connection to filter by tenant.
+   *
+   * @param tenantId - The tenant ID to use for scoping
+   *
+   * @example
+   * ```typescript
+   * // Switch to a specific tenant
+   * client.setTenant('tenant-uuid-here')
+   *
+   * // All subsequent requests will be scoped to this tenant
+   * const { data } = await client.from('users').select('*').execute()
+   * ```
+   *
+   * @category Multi-Tenancy
+   */
+  setTenant(tenantId) {
+    this._tenantId = tenantId;
+    if (tenantId) {
+      this.fetch.setHeader("X-FB-Tenant", tenantId);
+    } else {
+      this.fetch.removeHeader("X-FB-Tenant");
+    }
+  }
+  /**
+   * Register a callback that is called before every request.
+   * The callback receives the headers object and can modify it in place.
+   * This is useful for dynamically injecting headers at request time
+   * (e.g., reading tenant context from an external store).
+   *
+   * The callback runs after static headers are merged, so it can override them.
+   *
+   * @param callback - A function that receives the headers object, or null to remove
+   *
+   * @category Advanced
+   */
+  setBeforeRequestCallback(callback) {
+    this.fetch.setBeforeRequestCallback(callback);
+  }
+  /**
+   * Create a new client scoped to a specific tenant
+   *
+   * This returns a new client instance with the tenant context set.
+   * The original client is not modified.
+   *
+   * @param tenantId - The tenant ID to scope to
+   * @returns A new FluxbaseClient instance scoped to the tenant
+   *
+   * @example
+   * ```typescript
+   * // Create a tenant-scoped client
+   * const tenantClient = client.forTenant('tenant-uuid')
+   *
+   * // Use the scoped client for tenant-specific operations
+   * const { data } = await tenantClient.from('users').select('*').execute()
+   * ```
+   *
+   * @category Multi-Tenancy
+   */
+  forTenant(tenantId) {
+    const options = {
+      ...this.options,
+      headers: {
+        ...this.options?.headers,
+        "X-FB-Tenant": tenantId
+      }
+    };
+    const scopedClient = new _FluxbaseClient(
+      this.fluxbaseUrl,
+      this.fluxbaseKey,
+      options
+    );
+    scopedClient._tenantId = tenantId;
+    return scopedClient;
+  }
   /**
    * Create or get a realtime channel (Supabase-compatible)
    *
@@ -13258,6 +13150,7 @@ exports.FluxbaseRPC = FluxbaseRPC;
 exports.FluxbaseRealtime = FluxbaseRealtime;
 exports.FluxbaseSettings = FluxbaseSettings;
 exports.FluxbaseStorage = FluxbaseStorage;
+exports.FluxbaseTenant = FluxbaseTenant;
 exports.FluxbaseVector = FluxbaseVector;
 exports.ImpersonationManager = ImpersonationManager;
 exports.InvitationsManager = InvitationsManager;
@@ -13266,6 +13159,7 @@ exports.QueryBuilder = QueryBuilder;
 exports.RealtimeChannel = RealtimeChannel;
 exports.SchemaQueryBuilder = SchemaQueryBuilder;
 exports.SecretsManager = SecretsManager;
+exports.ServiceKeysManager = ServiceKeysManager;
 exports.SettingsClient = SettingsClient;
 exports.StorageBucket = StorageBucket;
 exports.SystemSettingsManager = SystemSettingsManager;