@fluxbase/sdk 2026.2.3-rc.21 → 2026.2.3-rc.23

package/dist/index.d.cts

@@ -25,6 +25,12 @@ interface FluxbaseClientOptions {
          */
         persist?: boolean;
     };
+    /**
+     * Whether this is a service role client
+     * When true, enables service_role features like onBehalfOf for job submission
+     * @internal
+     */
+    serviceRole?: boolean;
     /**
      * Global headers to include in all requests
      */
@@ -5109,7 +5115,17 @@ declare class FluxbaseFunctions {
  */
 declare class FluxbaseJobs {
     private fetch;
-    constructor(fetch: FluxbaseFetch);
+    private cachedRole;
+    private readonly ROLE_CACHE_TTL;
+    private isServiceRole;
+    constructor(fetch: FluxbaseFetch, isServiceRole?: boolean);
+    /**
+     * Get the current user's role from user_profiles table
+     * This is used to auto-populate the onBehalfOf parameter when submitting jobs
+     *
+     * @returns Promise resolving to the user's role or null if not found
+     */
+    private getCurrentUserRole;
     /**
      * Submit a new job for execution
      *
@@ -5159,6 +5175,9 @@ declare class FluxbaseJobs {
          * Submit job on behalf of another user (service_role only).
          * The job will be created with the specified user's identity,
          * allowing them to see the job and its logs via RLS.
+         *
+         * If not provided, the current user's identity and role from user_profiles
+         * will be automatically included.
          */
         onBehalfOf?: OnBehalfOf;
     }): Promise<{

package/dist/index.d.ts

@@ -25,6 +25,12 @@ interface FluxbaseClientOptions {
          */
         persist?: boolean;
     };
+    /**
+     * Whether this is a service role client
+     * When true, enables service_role features like onBehalfOf for job submission
+     * @internal
+     */
+    serviceRole?: boolean;
     /**
      * Global headers to include in all requests
      */
@@ -5109,7 +5115,17 @@ declare class FluxbaseFunctions {
  */
 declare class FluxbaseJobs {
     private fetch;
-    constructor(fetch: FluxbaseFetch);
+    private cachedRole;
+    private readonly ROLE_CACHE_TTL;
+    private isServiceRole;
+    constructor(fetch: FluxbaseFetch, isServiceRole?: boolean);
+    /**
+     * Get the current user's role from user_profiles table
+     * This is used to auto-populate the onBehalfOf parameter when submitting jobs
+     *
+     * @returns Promise resolving to the user's role or null if not found
+     */
+    private getCurrentUserRole;
     /**
      * Submit a new job for execution
      *
@@ -5159,6 +5175,9 @@ declare class FluxbaseJobs {
          * Submit job on behalf of another user (service_role only).
          * The job will be created with the specified user's identity,
          * allowing them to see the job and its logs via RLS.
+         *
+         * If not provided, the current user's identity and role from user_profiles
+         * will be automatically included.
          */
         onBehalfOf?: OnBehalfOf;
     }): Promise<{

package/dist/index.js

@@ -3643,8 +3643,43 @@ var FluxbaseFunctions = class {
 
 // src/jobs.ts
 var FluxbaseJobs = class {
-  constructor(fetch2) {
+  constructor(fetch2, isServiceRole = false) {
+    this.cachedRole = null;
+    this.ROLE_CACHE_TTL = 5 * 60 * 1e3;
     this.fetch = fetch2;
+    this.isServiceRole = isServiceRole;
+  }
+  /**
+   * Get the current user's role from user_profiles table
+   * This is used to auto-populate the onBehalfOf parameter when submitting jobs
+   *
+   * @returns Promise resolving to the user's role or null if not found
+   */
+  async getCurrentUserRole(userId) {
+    try {
+      const now = Date.now();
+      if (this.cachedRole && this.cachedRole.userId === userId && this.cachedRole.expiresAt > now) {
+        return this.cachedRole.role;
+      }
+      const profileResult = await this.fetch.get(
+        `/rest/v1/user_profiles?id=eq.${userId}&select=role`
+      );
+      if (!profileResult || !profileResult[0]) {
+        return null;
+      }
+      const role = profileResult[0].role;
+      if (role) {
+        this.cachedRole = {
+          userId,
+          role,
+          expiresAt: now + this.ROLE_CACHE_TTL
+        };
+      }
+      return role;
+    } catch (error) {
+      console.warn("[FluxbaseJobs] Failed to fetch user role:", error);
+      return null;
+    }
   }
   /**
    * Submit a new job for execution
@@ -3689,13 +3724,27 @@ var FluxbaseJobs = class {
    */
   async submit(jobName, payload, options) {
     try {
+      let finalOnBehalfOf = options?.onBehalfOf;
+      if (this.isServiceRole && !finalOnBehalfOf) {
+        const userResponse = await this.fetch.get("/api/v1/auth/user");
+        if (userResponse?.user) {
+          const user = userResponse.user;
+          const role = await this.getCurrentUserRole(user.id);
+          finalOnBehalfOf = {
+            user_id: user.id,
+            user_email: user.email,
+            user_role: role || void 0
+            // Include role if found
+          };
+        }
+      }
       const request = {
         job_name: jobName,
         payload,
         priority: options?.priority,
         namespace: options?.namespace,
         scheduled: options?.scheduled,
-        on_behalf_of: options?.onBehalfOf
+        on_behalf_of: finalOnBehalfOf
       };
       const data = await this.fetch.post("/api/v1/jobs/submit", request);
       return { data, error: null };
@@ -12536,7 +12585,7 @@ var FluxbaseClient = class {
     );
     this.storage = new FluxbaseStorage(this.fetch);
     this.functions = new FluxbaseFunctions(this.fetch);
-    this.jobs = new FluxbaseJobs(this.fetch);
+    this.jobs = new FluxbaseJobs(this.fetch, options?.serviceRole ?? false);
     this.admin = new FluxbaseAdmin(this.fetch);
     this.management = new FluxbaseManagement(this.fetch);
     this.settings = new SettingsClient(this.fetch);
@@ -12738,18 +12787,28 @@ function getEnvVar(name) {
 }
 function createClient(fluxbaseUrl, fluxbaseKey, options) {
   const url = fluxbaseUrl || getEnvVar("FLUXBASE_URL") || getEnvVar("NEXT_PUBLIC_FLUXBASE_URL") || getEnvVar("VITE_FLUXBASE_URL");
-  const key = fluxbaseKey || getEnvVar("FLUXBASE_ANON_KEY") || getEnvVar("FLUXBASE_SERVICE_TOKEN") || getEnvVar("FLUXBASE_JOB_TOKEN") || getEnvVar("NEXT_PUBLIC_FLUXBASE_ANON_KEY") || getEnvVar("VITE_FLUXBASE_ANON_KEY");
+  const resolvedKey = fluxbaseKey || getEnvVar("FLUXBASE_SERVICE_TOKEN") || getEnvVar("FLUXBASE_ANON_KEY") || getEnvVar("FLUXBASE_JOB_TOKEN") || getEnvVar("NEXT_PUBLIC_FLUXBASE_ANON_KEY") || getEnvVar("VITE_FLUXBASE_ANON_KEY");
+  let isServiceRole = options?.serviceRole ?? false;
+  if (!fluxbaseKey && getEnvVar("FLUXBASE_SERVICE_TOKEN")) {
+    isServiceRole = true;
+  }
+  if (options?.serviceRole !== void 0) {
+    isServiceRole = options.serviceRole;
+  }
   if (!url) {
     throw new Error(
       "Fluxbase URL is required. Pass it as the first argument or set FLUXBASE_URL environment variable."
     );
   }
-  if (!key) {
+  if (!resolvedKey) {
     throw new Error(
       "Fluxbase key is required. Pass it as the second argument or set FLUXBASE_ANON_KEY environment variable."
     );
   }
-  return new FluxbaseClient(url, key, options);
+  return new FluxbaseClient(url, resolvedKey, {
+    ...options,
+    serviceRole: isServiceRole
+  });
 }
 
 // src/type-guards.ts