@fluxbase/sdk 2026.1.1-rc.9 → 2026.1.2

package/dist/index.cjs

@@ -5034,6 +5034,148 @@ var SettingsClient = class {
       `/api/v1/settings/secret/${encodeURIComponent(key)}`
     );
   }
+  // ============================================================================
+  // User Settings (non-encrypted, with system fallback support)
+  // These methods mirror the edge function secrets helper pattern for regular settings
+  // ============================================================================
+  /**
+   * Get a setting with user -> system fallback
+   *
+   * First checks for a user-specific setting, then falls back to system default.
+   * Returns both the value and the source ("user" or "system").
+   *
+   * @param key - Setting key (e.g., 'theme', 'notifications.email')
+   * @returns Promise resolving to UserSettingWithSource with value and source
+   * @throws Error if setting doesn't exist in either user or system
+   *
+   * @example
+   * ```typescript
+   * // Get theme with fallback to system default
+   * const { value, source } = await client.settings.getSetting('theme')
+   * console.log(value)   // { mode: 'dark' }
+   * console.log(source)  // 'system' (from system default)
+   *
+   * // After user sets their own theme
+   * const { value, source } = await client.settings.getSetting('theme')
+   * console.log(source)  // 'user' (user's own setting)
+   * ```
+   */
+  async getSetting(key) {
+    return await this.fetch.get(
+      `/api/v1/settings/user/${encodeURIComponent(key)}`
+    );
+  }
+  /**
+   * Get only the user's own setting (no fallback to system)
+   *
+   * Returns the user's own setting for this key, or throws if not found.
+   * Use this when you specifically want to check if the user has set a value.
+   *
+   * @param key - Setting key
+   * @returns Promise resolving to UserSetting
+   * @throws Error if user has no setting with this key
+   *
+   * @example
+   * ```typescript
+   * // Check if user has set their own theme
+   * try {
+   *   const setting = await client.settings.getUserSetting('theme')
+   *   console.log('User theme:', setting.value)
+   * } catch (e) {
+   *   console.log('User has not set a theme')
+   * }
+   * ```
+   */
+  async getUserSetting(key) {
+    return await this.fetch.get(
+      `/api/v1/settings/user/own/${encodeURIComponent(key)}`
+    );
+  }
+  /**
+   * Get a system-level setting (no user override)
+   *
+   * Returns the system default for this key, ignoring any user-specific value.
+   * Useful for reading default configurations.
+   *
+   * @param key - Setting key
+   * @returns Promise resolving to the setting value
+   * @throws Error if system setting doesn't exist
+   *
+   * @example
+   * ```typescript
+   * // Get system default theme
+   * const { value } = await client.settings.getSystemSetting('theme')
+   * console.log('System default theme:', value)
+   * ```
+   */
+  async getSystemSetting(key) {
+    return await this.fetch.get(`/api/v1/settings/user/system/${encodeURIComponent(key)}`);
+  }
+  /**
+   * Set a user setting (create or update)
+   *
+   * Creates or updates a non-encrypted user setting.
+   * This value will override any system default when using getSetting().
+   *
+   * @param key - Setting key
+   * @param value - Setting value (any JSON-serializable object)
+   * @param options - Optional description
+   * @returns Promise resolving to UserSetting
+   *
+   * @example
+   * ```typescript
+   * // Set user's theme preference
+   * await client.settings.setSetting('theme', { mode: 'dark', accent: 'blue' })
+   *
+   * // Set with description
+   * await client.settings.setSetting('notifications', { email: true, push: false }, {
+   *   description: 'User notification preferences'
+   * })
+   * ```
+   */
+  async setSetting(key, value, options) {
+    return await this.fetch.put(
+      `/api/v1/settings/user/${encodeURIComponent(key)}`,
+      {
+        value,
+        description: options?.description
+      }
+    );
+  }
+  /**
+   * List all user's own settings
+   *
+   * Returns all non-encrypted settings the current user has set.
+   * Does not include system defaults.
+   *
+   * @returns Promise resolving to array of UserSetting
+   *
+   * @example
+   * ```typescript
+   * const settings = await client.settings.listSettings()
+   * settings.forEach(s => console.log(s.key, s.value))
+   * ```
+   */
+  async listSettings() {
+    return await this.fetch.get("/api/v1/settings/user/list");
+  }
+  /**
+   * Delete a user setting
+   *
+   * Removes the user's own setting, reverting to system default (if any).
+   *
+   * @param key - Setting key to delete
+   * @returns Promise<void>
+   *
+   * @example
+   * ```typescript
+   * // Remove user's theme preference, revert to system default
+   * await client.settings.deleteSetting('theme')
+   * ```
+   */
+  async deleteSetting(key) {
+    await this.fetch.delete(`/api/v1/settings/user/${encodeURIComponent(key)}`);
+  }
 };
 
 // src/ddl.ts
@@ -7759,6 +7901,46 @@ var FluxbaseAdminAI = class {
       return { data: null, error };
     }
   }
+  /**
+   * 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')
+   * ```
+   */
+  async setEmbeddingProvider(id) {
+    try {
+      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)
+   *
+   * @param id - Provider ID to clear
+   * @returns Promise resolving to { data, error } tuple
+   *
+   * @example
+   * ```typescript
+   * const { data, error } = await client.admin.ai.clearEmbeddingProvider('uuid')
+   * ```
+   */
+  async clearEmbeddingProvider(id) {
+    try {
+      const data = await this.fetch.delete(
+        `/api/v1/admin/ai/providers/${id}/embedding`
+      );
+      return { data, error: null };
+    } catch (error) {
+      return { data: null, error };
+    }
+  }
   // ============================================================================
   // KNOWLEDGE BASE MANAGEMENT (RAG)
   // ============================================================================