@fluxbase/sdk 0.0.1-rc.24 → 0.0.1-rc.26

package/dist/index.cjs

@@ -1944,87 +1944,128 @@ var AppSettingsManager = class {
       authentication: { require_email_verification: required }
     });
   }
-};
-var CustomSettingsManager = class {
-  constructor(fetch2) {
-    this.fetch = fetch2;
-  }
+  // ===================================================================
+  // CUSTOM SETTINGS METHODS
+  // Flexible key-value storage for application-specific configuration
+  // ===================================================================
   /**
-   * Create a new custom setting
+   * Get a specific custom setting's value only (without metadata)
    *
-   * @param request - Custom setting creation request
-   * @returns Promise resolving to CustomSetting
+   * Convenience method that returns just the value field instead of the full CustomSetting object.
+   *
+   * @param key - Setting key (e.g., 'billing.tiers', 'features.beta_enabled')
+   * @returns Promise resolving to the setting's value
    *
    * @example
    * ```typescript
-   * const setting = await client.admin.settings.custom.create({
-   *   key: 'api.quotas',
-   *   value: { free: 1000, pro: 10000, enterprise: 100000 },
-   *   value_type: 'json',
-   *   description: 'API request quotas by tier',
-   *   metadata: { category: 'billing' }
-   * })
+   * const tiers = await client.admin.settings.app.getSetting('billing.tiers')
+   * console.log(tiers) // { free: 1000, pro: 10000, enterprise: 100000 }
    * ```
    */
-  async create(request) {
-    return await this.fetch.post(
-      "/api/v1/admin/settings/custom",
-      request
+  async getSetting(key) {
+    const setting = await this.fetch.get(
+      `/api/v1/admin/settings/custom/${key}`
     );
+    return setting.value;
   }
   /**
-   * List all custom settings
+   * Get multiple custom settings' values by keys
+   *
+   * Fetches multiple settings in a single request and returns only their values.
    *
-   * @returns Promise resolving to ListCustomSettingsResponse
+   * @param keys - Array of setting keys to fetch
+   * @returns Promise resolving to object mapping keys to values
    *
    * @example
    * ```typescript
-   * const response = await client.admin.settings.custom.list()
-   * console.log(response.settings)
+   * const values = await client.admin.settings.app.getSettings([
+   *   'billing.tiers',
+   *   'features.beta_enabled'
+   * ])
+   * console.log(values)
+   * // {
+   * //   'billing.tiers': { free: 1000, pro: 10000 },
+   * //   'features.beta_enabled': { enabled: true }
+   * // }
    * ```
    */
-  async list() {
-    const settings = await this.fetch.get(
-      "/api/v1/admin/settings/custom"
+  async getSettings(keys) {
+    const response = await this.fetch.post(
+      "/api/v1/settings/batch",
+      { keys }
+    );
+    return response.reduce(
+      (acc, setting) => {
+        acc[setting.key] = setting.value;
+        return acc;
+      },
+      {}
     );
-    return { settings: Array.isArray(settings) ? settings : [] };
   }
   /**
-   * Get a specific custom setting by key
+   * Set or create a custom setting
+   *
+   * Creates a new custom setting or updates an existing one.
    *
-   * @param key - Setting key (e.g., 'feature.dark_mode')
+   * @param key - Setting key
+   * @param value - Setting value (any JSON-serializable value)
+   * @param options - Optional configuration (description, is_public, is_secret, etc.)
    * @returns Promise resolving to CustomSetting
    *
    * @example
    * ```typescript
-   * const setting = await client.admin.settings.custom.get('feature.dark_mode')
-   * console.log(setting.value)
+   * await client.admin.settings.app.setSetting('billing.tiers', {
+   *   free: 1000,
+   *   pro: 10000,
+   *   enterprise: 100000
+   * }, {
+   *   description: 'API quotas per billing tier',
+   *   is_public: false
+   * })
    * ```
    */
-  async get(key) {
-    return await this.fetch.get(
-      `/api/v1/admin/settings/custom/${key}`
-    );
+  async setSetting(key, value, options) {
+    try {
+      return await this.fetch.put(
+        `/api/v1/admin/settings/custom/${key}`,
+        {
+          value,
+          description: options?.description,
+          is_public: options?.is_public,
+          is_secret: options?.is_secret
+        }
+      );
+    } catch (error) {
+      if (error.status === 404 || error.message?.includes("not found")) {
+        return await this.fetch.post(
+          "/api/v1/admin/settings/custom",
+          {
+            key,
+            value,
+            value_type: options?.value_type || "json",
+            description: options?.description,
+            is_public: options?.is_public ?? false,
+            is_secret: options?.is_secret ?? false
+          }
+        );
+      }
+      throw error;
+    }
   }
   /**
-   * Update an existing custom setting
+   * List all custom settings
    *
-   * @param key - Setting key
-   * @param request - Update request with new values
-   * @returns Promise resolving to CustomSetting
+   * @returns Promise resolving to array of CustomSetting objects
    *
    * @example
    * ```typescript
-   * const updated = await client.admin.settings.custom.update('feature.dark_mode', {
-   *   value: { enabled: false },
-   *   description: 'Updated description'
-   * })
+   * const settings = await client.admin.settings.app.listSettings()
+   * settings.forEach(s => console.log(s.key, s.value))
    * ```
    */
-  async update(key, request) {
-    return await this.fetch.put(
-      `/api/v1/admin/settings/custom/${key}`,
-      request
+  async listSettings() {
+    return await this.fetch.get(
+      "/api/v1/admin/settings/custom"
     );
   }
   /**
@@ -2035,10 +2076,10 @@ var CustomSettingsManager = class {
    *
    * @example
    * ```typescript
-   * await client.admin.settings.custom.delete('feature.dark_mode')
+   * await client.admin.settings.app.deleteSetting('billing.tiers')
    * ```
    */
-  async delete(key) {
+  async deleteSetting(key) {
     await this.fetch.delete(`/api/v1/admin/settings/custom/${key}`);
   }
 };
@@ -2152,7 +2193,80 @@ var FluxbaseSettings = class {
   constructor(fetch2) {
     this.system = new SystemSettingsManager(fetch2);
     this.app = new AppSettingsManager(fetch2);
-    this.custom = new CustomSettingsManager(fetch2);
+  }
+};
+var SettingsClient = class {
+  constructor(fetch2) {
+    this.fetch = fetch2;
+  }
+  /**
+   * Get a single setting's value
+   *
+   * Returns only the value field of the setting.
+   * Access is controlled by RLS policies - will return 403 if the user
+   * doesn't have permission to read the setting.
+   *
+   * @param key - Setting key (e.g., 'features.beta_enabled')
+   * @returns Promise resolving to the setting's value
+   * @throws Error if setting doesn't exist or user lacks permission
+   *
+   * @example
+   * ```typescript
+   * // Get public setting (any user)
+   * const value = await client.settings.get('features.beta_enabled')
+   * console.log(value) // { enabled: true }
+   *
+   * // Get restricted setting (requires permission)
+   * try {
+   *   const secret = await client.settings.get('internal.api_key')
+   * } catch (error) {
+   *   console.error('Access denied:', error)
+   * }
+   * ```
+   */
+  async get(key) {
+    const response = await this.fetch.get(
+      `/api/v1/settings/${encodeURIComponent(key)}`
+    );
+    return response.value;
+  }
+  /**
+   * Get multiple settings' values by keys
+   *
+   * Fetches multiple settings in a single request.
+   * Only returns settings the user has permission to read based on RLS policies.
+   * Settings the user can't access will be omitted from the result (no error thrown).
+   *
+   * @param keys - Array of setting keys to fetch
+   * @returns Promise resolving to object mapping keys to values
+   *
+   * @example
+   * ```typescript
+   * const values = await client.settings.getMany([
+   *   'features.beta_enabled',  // public - will be returned
+   *   'features.dark_mode',      // public - will be returned
+   *   'internal.api_key'         // secret - will be omitted
+   * ])
+   * console.log(values)
+   * // {
+   * //   'features.beta_enabled': { enabled: true },
+   * //   'features.dark_mode': { enabled: false }
+   * //   // 'internal.api_key' is omitted (no error)
+   * // }
+   * ```
+   */
+  async getMany(keys) {
+    const response = await this.fetch.post(
+      "/api/v1/settings/batch",
+      { keys }
+    );
+    return response.reduce(
+      (acc, setting) => {
+        acc[setting.key] = setting.value;
+        return acc;
+      },
+      {}
+    );
   }
 };
 
@@ -4077,8 +4191,8 @@ var FluxbaseClient = class {
     this.fluxbaseUrl = fluxbaseUrl;
     this.fluxbaseKey = fluxbaseKey;
     const headers = {
-      "apikey": fluxbaseKey,
-      "Authorization": `Bearer ${fluxbaseKey}`,
+      apikey: fluxbaseKey,
+      Authorization: `Bearer ${fluxbaseKey}`,
       ...options?.headers
     };
     this.fetch = new FluxbaseFetch(fluxbaseUrl, {
@@ -4102,6 +4216,7 @@ var FluxbaseClient = class {
     this.functions = new FluxbaseFunctions(this.fetch);
     this.admin = new FluxbaseAdmin(this.fetch);
     this.management = new FluxbaseManagement(this.fetch);
+    this.settings = new SettingsClient(this.fetch);
     this.setupAuthSync();
   }
   /**
@@ -4274,6 +4389,7 @@ exports.InvitationsManager = InvitationsManager;
 exports.OAuthProviderManager = OAuthProviderManager;
 exports.QueryBuilder = QueryBuilder;
 exports.RealtimeChannel = RealtimeChannel;
+exports.SettingsClient = SettingsClient;
 exports.StorageBucket = StorageBucket;
 exports.SystemSettingsManager = SystemSettingsManager;
 exports.WebhooksManager = WebhooksManager;