@scalemule/nextjs 0.0.8 → 0.0.10

package/dist/client.d.mts

@@ -64,6 +64,7 @@ declare class ScaleMuleClient {
     private enableOfflineQueue;
     private sessionGate;
     private resolveSessionGate;
+    private workspaceId;
     constructor(config: ClientConfig);
     /**
      * Sync offline queue when coming back online
@@ -85,6 +86,15 @@ declare class ScaleMuleClient {
      * Check if currently rate limited
      */
     isRateLimited(): boolean;
+    /**
+     * Set the active workspace context. All subsequent requests will include
+     * x-sm-workspace-id header. Pass null to clear.
+     */
+    setWorkspaceContext(id: string | null): void;
+    /**
+     * Get the current workspace ID
+     */
+    getWorkspaceId(): string | null;
     /**
      * Get the gateway URL
      */

package/dist/client.d.ts

@@ -64,6 +64,7 @@ declare class ScaleMuleClient {
     private enableOfflineQueue;
     private sessionGate;
     private resolveSessionGate;
+    private workspaceId;
     constructor(config: ClientConfig);
     /**
      * Sync offline queue when coming back online
@@ -85,6 +86,15 @@ declare class ScaleMuleClient {
      * Check if currently rate limited
      */
     isRateLimited(): boolean;
+    /**
+     * Set the active workspace context. All subsequent requests will include
+     * x-sm-workspace-id header. Pass null to clear.
+     */
+    setWorkspaceContext(id: string | null): void;
+    /**
+     * Get the current workspace ID
+     */
+    getWorkspaceId(): string | null;
     /**
      * Get the gateway URL
      */

package/dist/client.js

@@ -17,6 +17,7 @@ var GATEWAY_URLS = {
 };
 var SESSION_STORAGE_KEY = "scalemule_session";
 var USER_ID_STORAGE_KEY = "scalemule_user_id";
+var WORKSPACE_STORAGE_KEY = "scalemule_workspace_id";
 var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -275,6 +276,7 @@ var ScaleMuleClient = class {
     this.offlineQueue = null;
     this.sessionGate = null;
     this.resolveSessionGate = null;
+    this.workspaceId = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -345,6 +347,24 @@ var ScaleMuleClient = class {
   isRateLimited() {
     return this.rateLimitQueue?.isRateLimited || false;
   }
+  /**
+   * Set the active workspace context. All subsequent requests will include
+   * x-sm-workspace-id header. Pass null to clear.
+   */
+  setWorkspaceContext(id) {
+    this.workspaceId = id;
+    if (id) {
+      this.storage.setItem(WORKSPACE_STORAGE_KEY, id);
+    } else {
+      this.storage.removeItem(WORKSPACE_STORAGE_KEY);
+    }
+  }
+  /**
+   * Get the current workspace ID
+   */
+  getWorkspaceId() {
+    return this.workspaceId;
+  }
   /**
    * Get the gateway URL
    */
@@ -387,6 +407,8 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    const wsId = await this.storage.getItem(WORKSPACE_STORAGE_KEY);
+    if (wsId) this.workspaceId = wsId;
     if (token) {
       this.resolveSessionPending();
     }
@@ -412,8 +434,10 @@ var ScaleMuleClient = class {
   async clearSession() {
     this.sessionToken = null;
     this.userId = null;
+    this.workspaceId = null;
     await this.storage.removeItem(SESSION_STORAGE_KEY);
     await this.storage.removeItem(USER_ID_STORAGE_KEY);
+    await this.storage.removeItem(WORKSPACE_STORAGE_KEY);
     if (this.debug) {
       console.log("[ScaleMule] Session cleared");
     }
@@ -445,6 +469,9 @@ var ScaleMuleClient = class {
     if (!options?.skipAuth && this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     if (!headers.has("Content-Type") && options?.body && typeof options.body === "string") {
       headers.set("Content-Type", "application/json");
     }
@@ -600,6 +627,9 @@ var ScaleMuleClient = class {
     if (this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     let lastError = null;
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
@@ -737,6 +767,9 @@ var ScaleMuleClient = class {
       if (this.sessionToken) {
         xhr.setRequestHeader("Authorization", `Bearer ${this.sessionToken}`);
       }
+      if (this.workspaceId) {
+        xhr.setRequestHeader("x-sm-workspace-id", this.workspaceId);
+      }
       xhr.send(formData);
     });
   }

package/dist/client.mjs

@@ -15,6 +15,7 @@ var GATEWAY_URLS = {
 };
 var SESSION_STORAGE_KEY = "scalemule_session";
 var USER_ID_STORAGE_KEY = "scalemule_user_id";
+var WORKSPACE_STORAGE_KEY = "scalemule_workspace_id";
 var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -273,6 +274,7 @@ var ScaleMuleClient = class {
     this.offlineQueue = null;
     this.sessionGate = null;
     this.resolveSessionGate = null;
+    this.workspaceId = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -343,6 +345,24 @@ var ScaleMuleClient = class {
   isRateLimited() {
     return this.rateLimitQueue?.isRateLimited || false;
   }
+  /**
+   * Set the active workspace context. All subsequent requests will include
+   * x-sm-workspace-id header. Pass null to clear.
+   */
+  setWorkspaceContext(id) {
+    this.workspaceId = id;
+    if (id) {
+      this.storage.setItem(WORKSPACE_STORAGE_KEY, id);
+    } else {
+      this.storage.removeItem(WORKSPACE_STORAGE_KEY);
+    }
+  }
+  /**
+   * Get the current workspace ID
+   */
+  getWorkspaceId() {
+    return this.workspaceId;
+  }
   /**
    * Get the gateway URL
    */
@@ -385,6 +405,8 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    const wsId = await this.storage.getItem(WORKSPACE_STORAGE_KEY);
+    if (wsId) this.workspaceId = wsId;
     if (token) {
       this.resolveSessionPending();
     }
@@ -410,8 +432,10 @@ var ScaleMuleClient = class {
   async clearSession() {
     this.sessionToken = null;
     this.userId = null;
+    this.workspaceId = null;
     await this.storage.removeItem(SESSION_STORAGE_KEY);
     await this.storage.removeItem(USER_ID_STORAGE_KEY);
+    await this.storage.removeItem(WORKSPACE_STORAGE_KEY);
     if (this.debug) {
       console.log("[ScaleMule] Session cleared");
     }
@@ -443,6 +467,9 @@ var ScaleMuleClient = class {
     if (!options?.skipAuth && this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     if (!headers.has("Content-Type") && options?.body && typeof options.body === "string") {
       headers.set("Content-Type", "application/json");
     }
@@ -598,6 +625,9 @@ var ScaleMuleClient = class {
     if (this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     let lastError = null;
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
@@ -735,6 +765,9 @@ var ScaleMuleClient = class {
       if (this.sessionToken) {
         xhr.setRequestHeader("Authorization", `Bearer ${this.sessionToken}`);
       }
+      if (this.workspaceId) {
+        xhr.setRequestHeader("x-sm-workspace-id", this.workspaceId);
+      }
       xhr.send(formData);
     });
   }

package/dist/index.d.mts

@@ -257,6 +257,32 @@ declare function useRealtime(options?: UseRealtimeOptions): UseRealtimeReturn;
  */
 declare function useAnalytics(options?: UseAnalyticsOptions): UseAnalyticsReturn;
 
+interface FeatureFlagEvaluation<T = unknown> {
+    flag_id: string;
+    flag_key: string;
+    environment: string;
+    value: T;
+    reason: string;
+    matched_rule_id?: string | null;
+    variant_key?: string | null;
+    bucket?: number | null;
+}
+interface UseFeatureFlagsOptions {
+    environment?: string;
+    context?: Record<string, unknown>;
+    keys?: string[];
+    enabled?: boolean;
+}
+interface UseFeatureFlagsReturn {
+    flags: Record<string, FeatureFlagEvaluation>;
+    loading: boolean;
+    error: ApiError | null;
+    refresh: () => Promise<void>;
+    isEnabled: (flagKey: string, fallback?: boolean) => boolean;
+    getFlag: <T = unknown>(flagKey: string, fallback?: T) => T;
+}
+declare function useFeatureFlags(options?: UseFeatureFlagsOptions): UseFeatureFlagsReturn;
+
 /**
  * Client-side validation helpers
  *
@@ -415,4 +441,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };
+export { ApiError, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };

package/dist/index.d.ts

@@ -257,6 +257,32 @@ declare function useRealtime(options?: UseRealtimeOptions): UseRealtimeReturn;
  */
 declare function useAnalytics(options?: UseAnalyticsOptions): UseAnalyticsReturn;
 
+interface FeatureFlagEvaluation<T = unknown> {
+    flag_id: string;
+    flag_key: string;
+    environment: string;
+    value: T;
+    reason: string;
+    matched_rule_id?: string | null;
+    variant_key?: string | null;
+    bucket?: number | null;
+}
+interface UseFeatureFlagsOptions {
+    environment?: string;
+    context?: Record<string, unknown>;
+    keys?: string[];
+    enabled?: boolean;
+}
+interface UseFeatureFlagsReturn {
+    flags: Record<string, FeatureFlagEvaluation>;
+    loading: boolean;
+    error: ApiError | null;
+    refresh: () => Promise<void>;
+    isEnabled: (flagKey: string, fallback?: boolean) => boolean;
+    getFlag: <T = unknown>(flagKey: string, fallback?: T) => T;
+}
+declare function useFeatureFlags(options?: UseFeatureFlagsOptions): UseFeatureFlagsReturn;
+
 /**
  * Client-side validation helpers
  *
@@ -415,4 +441,4 @@ declare function createSafeLogger(prefix: string): {
     error: (message: string, data?: unknown) => void;
 };
 
-export { ApiError, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };
+export { ApiError, type FeatureFlagEvaluation, type FeatureFlagEvaluation as FeatureFlagResult, ListFilesParams, LoginResponse, type PasswordValidationResult, type PhoneCountry, type PhoneValidationResult, type RealtimeEvent, type RealtimeMessage, type RealtimeStatus, ScaleMuleClient, ScaleMuleConfig, ScaleMuleProvider, type ScaleMuleProviderProps, UseAnalyticsOptions, UseAnalyticsReturn, UseAuthReturn, UseBillingReturn, UseContentReturn, type UseFeatureFlagsOptions, type UseFeatureFlagsReturn, type UseFeatureFlagsOptions as UseFlagsOptions, type UseFeatureFlagsReturn as UseFlagsReturn, type UseRealtimeOptions, type UseRealtimeReturn, UseUserReturn, User, type UsernameValidationResult, composePhone, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };

package/dist/index.js

@@ -22,6 +22,7 @@ var GATEWAY_URLS = {
 };
 var SESSION_STORAGE_KEY = "scalemule_session";
 var USER_ID_STORAGE_KEY = "scalemule_user_id";
+var WORKSPACE_STORAGE_KEY = "scalemule_workspace_id";
 var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -280,6 +281,7 @@ var ScaleMuleClient = class {
     this.offlineQueue = null;
     this.sessionGate = null;
     this.resolveSessionGate = null;
+    this.workspaceId = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -350,6 +352,24 @@ var ScaleMuleClient = class {
   isRateLimited() {
     return this.rateLimitQueue?.isRateLimited || false;
   }
+  /**
+   * Set the active workspace context. All subsequent requests will include
+   * x-sm-workspace-id header. Pass null to clear.
+   */
+  setWorkspaceContext(id) {
+    this.workspaceId = id;
+    if (id) {
+      this.storage.setItem(WORKSPACE_STORAGE_KEY, id);
+    } else {
+      this.storage.removeItem(WORKSPACE_STORAGE_KEY);
+    }
+  }
+  /**
+   * Get the current workspace ID
+   */
+  getWorkspaceId() {
+    return this.workspaceId;
+  }
   /**
    * Get the gateway URL
    */
@@ -392,6 +412,8 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    const wsId = await this.storage.getItem(WORKSPACE_STORAGE_KEY);
+    if (wsId) this.workspaceId = wsId;
     if (token) {
       this.resolveSessionPending();
     }
@@ -417,8 +439,10 @@ var ScaleMuleClient = class {
   async clearSession() {
     this.sessionToken = null;
     this.userId = null;
+    this.workspaceId = null;
     await this.storage.removeItem(SESSION_STORAGE_KEY);
     await this.storage.removeItem(USER_ID_STORAGE_KEY);
+    await this.storage.removeItem(WORKSPACE_STORAGE_KEY);
     if (this.debug) {
       console.log("[ScaleMule] Session cleared");
     }
@@ -450,6 +474,9 @@ var ScaleMuleClient = class {
     if (!options?.skipAuth && this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     if (!headers.has("Content-Type") && options?.body && typeof options.body === "string") {
       headers.set("Content-Type", "application/json");
     }
@@ -605,6 +632,9 @@ var ScaleMuleClient = class {
     if (this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     let lastError = null;
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
@@ -742,6 +772,9 @@ var ScaleMuleClient = class {
       if (this.sessionToken) {
         xhr.setRequestHeader("Authorization", `Bearer ${this.sessionToken}`);
       }
+      if (this.workspaceId) {
+        xhr.setRequestHeader("x-sm-workspace-id", this.workspaceId);
+      }
       xhr.send(formData);
     });
   }
@@ -2798,6 +2831,80 @@ function useAnalytics(options = {}) {
     ]
   );
 }
+function toApiError(error) {
+  if (error instanceof ScaleMuleApiError) {
+    return {
+      code: error.code,
+      message: error.message,
+      field: error.field
+    };
+  }
+  return {
+    code: "UNKNOWN",
+    message: error instanceof Error ? error.message : "Failed to load feature flags"
+  };
+}
+function useFeatureFlags(options = {}) {
+  const {
+    environment = "prod",
+    context = {},
+    keys,
+    enabled = true
+  } = options;
+  const { client } = useScaleMule();
+  const [flags, setFlags] = react.useState({});
+  const [loading, setLoading] = react.useState(enabled);
+  const [error, setError] = react.useState(null);
+  const contextRef = react.useRef(context);
+  const keysKey = react.useMemo(() => keys && keys.length > 0 ? [...keys].sort().join("|") : "", [keys]);
+  react.useEffect(() => {
+    contextRef.current = context;
+  }, [context]);
+  const refresh = react.useCallback(async () => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+    setLoading(true);
+    try {
+      const payload = keys && keys.length > 0 ? { flag_keys: keys, environment, context: contextRef.current } : { environment, context: contextRef.current };
+      const result = keys && keys.length > 0 ? await client.post("/v1/flags/evaluate/batch", payload) : await client.post("/v1/flags/evaluate/all", payload);
+      setFlags(result || {});
+      setError(null);
+    } catch (err) {
+      setError(toApiError(err));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, enabled, environment, keys, keysKey]);
+  react.useEffect(() => {
+    void refresh();
+  }, [refresh]);
+  const isEnabled = react.useCallback(
+    (flagKey, fallback = false) => {
+      const evaluation = flags[flagKey];
+      if (!evaluation) return fallback;
+      return typeof evaluation.value === "boolean" ? evaluation.value : fallback;
+    },
+    [flags]
+  );
+  const getFlag = react.useCallback(
+    (flagKey, fallback) => {
+      const evaluation = flags[flagKey];
+      if (!evaluation) return fallback;
+      return evaluation.value ?? fallback;
+    },
+    [flags]
+  );
+  return {
+    flags,
+    loading,
+    error,
+    refresh,
+    isEnabled,
+    getFlag
+  };
+}
 
 // src/validation.ts
 var phoneCountries = [
@@ -3103,6 +3210,7 @@ exports.useAnalytics = useAnalytics;
 exports.useAuth = useAuth;
 exports.useBilling = useBilling;
 exports.useContent = useContent;
+exports.useFeatureFlags = useFeatureFlags;
 exports.useRealtime = useRealtime;
 exports.useScaleMule = useScaleMule;
 exports.useScaleMuleClient = useScaleMuleClient;

package/dist/index.mjs

@@ -20,6 +20,7 @@ var GATEWAY_URLS = {
 };
 var SESSION_STORAGE_KEY = "scalemule_session";
 var USER_ID_STORAGE_KEY = "scalemule_user_id";
+var WORKSPACE_STORAGE_KEY = "scalemule_workspace_id";
 var RETRYABLE_STATUS_CODES = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -278,6 +279,7 @@ var ScaleMuleClient = class {
     this.offlineQueue = null;
     this.sessionGate = null;
     this.resolveSessionGate = null;
+    this.workspaceId = null;
     this.apiKey = config.apiKey;
     this.applicationId = config.applicationId || null;
     this.gatewayUrl = resolveGatewayUrl(config);
@@ -348,6 +350,24 @@ var ScaleMuleClient = class {
   isRateLimited() {
     return this.rateLimitQueue?.isRateLimited || false;
   }
+  /**
+   * Set the active workspace context. All subsequent requests will include
+   * x-sm-workspace-id header. Pass null to clear.
+   */
+  setWorkspaceContext(id) {
+    this.workspaceId = id;
+    if (id) {
+      this.storage.setItem(WORKSPACE_STORAGE_KEY, id);
+    } else {
+      this.storage.removeItem(WORKSPACE_STORAGE_KEY);
+    }
+  }
+  /**
+   * Get the current workspace ID
+   */
+  getWorkspaceId() {
+    return this.workspaceId;
+  }
   /**
    * Get the gateway URL
    */
@@ -390,6 +410,8 @@ var ScaleMuleClient = class {
     const userId = await this.storage.getItem(USER_ID_STORAGE_KEY);
     if (token) this.sessionToken = token;
     if (userId) this.userId = userId;
+    const wsId = await this.storage.getItem(WORKSPACE_STORAGE_KEY);
+    if (wsId) this.workspaceId = wsId;
     if (token) {
       this.resolveSessionPending();
     }
@@ -415,8 +437,10 @@ var ScaleMuleClient = class {
   async clearSession() {
     this.sessionToken = null;
     this.userId = null;
+    this.workspaceId = null;
     await this.storage.removeItem(SESSION_STORAGE_KEY);
     await this.storage.removeItem(USER_ID_STORAGE_KEY);
+    await this.storage.removeItem(WORKSPACE_STORAGE_KEY);
     if (this.debug) {
       console.log("[ScaleMule] Session cleared");
     }
@@ -448,6 +472,9 @@ var ScaleMuleClient = class {
     if (!options?.skipAuth && this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     if (!headers.has("Content-Type") && options?.body && typeof options.body === "string") {
       headers.set("Content-Type", "application/json");
     }
@@ -603,6 +630,9 @@ var ScaleMuleClient = class {
     if (this.sessionToken) {
       headers.set("Authorization", `Bearer ${this.sessionToken}`);
     }
+    if (this.workspaceId) {
+      headers.set("x-sm-workspace-id", this.workspaceId);
+    }
     let lastError = null;
     for (let attempt = 0; attempt <= maxRetries; attempt++) {
       try {
@@ -740,6 +770,9 @@ var ScaleMuleClient = class {
       if (this.sessionToken) {
         xhr.setRequestHeader("Authorization", `Bearer ${this.sessionToken}`);
       }
+      if (this.workspaceId) {
+        xhr.setRequestHeader("x-sm-workspace-id", this.workspaceId);
+      }
       xhr.send(formData);
     });
   }
@@ -2796,6 +2829,80 @@ function useAnalytics(options = {}) {
     ]
   );
 }
+function toApiError(error) {
+  if (error instanceof ScaleMuleApiError) {
+    return {
+      code: error.code,
+      message: error.message,
+      field: error.field
+    };
+  }
+  return {
+    code: "UNKNOWN",
+    message: error instanceof Error ? error.message : "Failed to load feature flags"
+  };
+}
+function useFeatureFlags(options = {}) {
+  const {
+    environment = "prod",
+    context = {},
+    keys,
+    enabled = true
+  } = options;
+  const { client } = useScaleMule();
+  const [flags, setFlags] = useState({});
+  const [loading, setLoading] = useState(enabled);
+  const [error, setError] = useState(null);
+  const contextRef = useRef(context);
+  const keysKey = useMemo(() => keys && keys.length > 0 ? [...keys].sort().join("|") : "", [keys]);
+  useEffect(() => {
+    contextRef.current = context;
+  }, [context]);
+  const refresh = useCallback(async () => {
+    if (!enabled) {
+      setLoading(false);
+      return;
+    }
+    setLoading(true);
+    try {
+      const payload = keys && keys.length > 0 ? { flag_keys: keys, environment, context: contextRef.current } : { environment, context: contextRef.current };
+      const result = keys && keys.length > 0 ? await client.post("/v1/flags/evaluate/batch", payload) : await client.post("/v1/flags/evaluate/all", payload);
+      setFlags(result || {});
+      setError(null);
+    } catch (err) {
+      setError(toApiError(err));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, enabled, environment, keys, keysKey]);
+  useEffect(() => {
+    void refresh();
+  }, [refresh]);
+  const isEnabled = useCallback(
+    (flagKey, fallback = false) => {
+      const evaluation = flags[flagKey];
+      if (!evaluation) return fallback;
+      return typeof evaluation.value === "boolean" ? evaluation.value : fallback;
+    },
+    [flags]
+  );
+  const getFlag = useCallback(
+    (flagKey, fallback) => {
+      const evaluation = flags[flagKey];
+      if (!evaluation) return fallback;
+      return evaluation.value ?? fallback;
+    },
+    [flags]
+  );
+  return {
+    flags,
+    loading,
+    error,
+    refresh,
+    isEnabled,
+    getFlag
+  };
+}
 
 // src/validation.ts
 var phoneCountries = [
@@ -3088,4 +3195,4 @@ function createSafeLogger(prefix) {
   };
 }
 
-export { ScaleMuleApiError, ScaleMuleClient, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };
+export { ScaleMuleApiError, ScaleMuleClient, ScaleMuleProvider, composePhone, createClient, createSafeLogger, normalizePhone, phoneCountries, sanitizeForLog, useAnalytics, useAuth, useBilling, useContent, useFeatureFlags, useRealtime, useScaleMule, useScaleMuleClient, useUser, validateForm, validators };

package/dist/server/auth.js

@@ -655,6 +655,37 @@ var ScaleMuleServer = class {
         });
       }
     };
+    this.flags = {
+      evaluate: async (flagKey, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate", {
+          body: {
+            flag_key: flagKey,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateBatch: async (flagKeys, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/batch", {
+          body: {
+            flag_keys: flagKeys,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateAll: async (context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/all", {
+          body: {
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      }
+    };
     this.apiKey = config.apiKey;
     this.gatewayUrl = resolveGatewayUrl(config);
     this.debug = config.debug || false;

package/dist/server/auth.mjs

@@ -653,6 +653,37 @@ var ScaleMuleServer = class {
         });
       }
     };
+    this.flags = {
+      evaluate: async (flagKey, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate", {
+          body: {
+            flag_key: flagKey,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateBatch: async (flagKeys, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/batch", {
+          body: {
+            flag_keys: flagKeys,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateAll: async (context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/all", {
+          body: {
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      }
+    };
     this.apiKey = config.apiKey;
     this.gatewayUrl = resolveGatewayUrl(config);
     this.debug = config.debug || false;

package/dist/server/index.d.mts

@@ -1,5 +1,5 @@
-import { S as ServerConfig } from '../webhook-handler-BzBvYbZU.mjs';
-export { a as ScaleMuleServer, d as VideoFailedEvent, V as VideoReadyEvent, f as VideoTranscodedEvent, e as VideoUploadedEvent, W as WebhookEvent, g as WebhookRoutesConfig, c as createServerClient, h as createWebhookHandler, b as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, v as verifyWebhookSignature } from '../webhook-handler-BzBvYbZU.mjs';
+import { S as ServerConfig } from '../webhook-handler-CweF_nT3.mjs';
+export { a as ScaleMuleServer, d as VideoFailedEvent, V as VideoReadyEvent, f as VideoTranscodedEvent, e as VideoUploadedEvent, W as WebhookEvent, g as WebhookRoutesConfig, c as createServerClient, h as createWebhookHandler, b as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, v as verifyWebhookSignature } from '../webhook-handler-CweF_nT3.mjs';
 import { $ as ClientContext, L as LoginResponse, A as ApiError } from '../index-jomBa89d.mjs';
 import { NextRequest, NextResponse } from 'next/server';
 

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ServerConfig } from '../webhook-handler-tcJtRpkE.js';
-export { a as ScaleMuleServer, d as VideoFailedEvent, V as VideoReadyEvent, f as VideoTranscodedEvent, e as VideoUploadedEvent, W as WebhookEvent, g as WebhookRoutesConfig, c as createServerClient, h as createWebhookHandler, b as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, v as verifyWebhookSignature } from '../webhook-handler-tcJtRpkE.js';
+import { S as ServerConfig } from '../webhook-handler-Bi3bMNty.js';
+export { a as ScaleMuleServer, d as VideoFailedEvent, V as VideoReadyEvent, f as VideoTranscodedEvent, e as VideoUploadedEvent, W as WebhookEvent, g as WebhookRoutesConfig, c as createServerClient, h as createWebhookHandler, b as createWebhookRoutes, p as parseWebhookEvent, r as registerVideoWebhook, v as verifyWebhookSignature } from '../webhook-handler-Bi3bMNty.js';
 import { $ as ClientContext, L as LoginResponse, A as ApiError } from '../index-jomBa89d.js';
 import { NextRequest, NextResponse } from 'next/server';
 

package/dist/server/index.js

@@ -715,6 +715,37 @@ var ScaleMuleServer = class {
         });
       }
     };
+    this.flags = {
+      evaluate: async (flagKey, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate", {
+          body: {
+            flag_key: flagKey,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateBatch: async (flagKeys, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/batch", {
+          body: {
+            flag_keys: flagKeys,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateAll: async (context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/all", {
+          body: {
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      }
+    };
     this.apiKey = config.apiKey;
     this.gatewayUrl = resolveGatewayUrl(config);
     this.debug = config.debug || false;

package/dist/server/index.mjs

@@ -713,6 +713,37 @@ var ScaleMuleServer = class {
         });
       }
     };
+    this.flags = {
+      evaluate: async (flagKey, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate", {
+          body: {
+            flag_key: flagKey,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateBatch: async (flagKeys, context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/batch", {
+          body: {
+            flag_keys: flagKeys,
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      },
+      evaluateAll: async (context = {}, environment = "prod", options) => {
+        return this.request("POST", "/v1/flags/evaluate/all", {
+          body: {
+            environment,
+            context
+          },
+          clientContext: options?.clientContext
+        });
+      }
+    };
     this.apiKey = config.apiKey;
     this.gatewayUrl = resolveGatewayUrl(config);
     this.debug = config.debug || false;

package/dist/server/webhook-handler.d.mts

@@ -1,2 +1,2 @@
-export { h as createWebhookHandler } from '../webhook-handler-BzBvYbZU.mjs';
+export { h as createWebhookHandler } from '../webhook-handler-CweF_nT3.mjs';
 import '../index-jomBa89d.mjs';

package/dist/server/webhook-handler.d.ts

@@ -1,2 +1,2 @@
-export { h as createWebhookHandler } from '../webhook-handler-tcJtRpkE.js';
+export { h as createWebhookHandler } from '../webhook-handler-Bi3bMNty.js';
 import '../index-jomBa89d.js';

package/dist/{webhook-handler-tcJtRpkE.d.ts → webhook-handler-Bi3bMNty.d.ts}

@@ -523,6 +523,44 @@ declare class ScaleMuleServer {
             tracked: number;
         }>;
     };
+    flags: {
+        evaluate: <T = unknown>(flagKey: string, context?: Record<string, unknown>, environment?: string, options?: {
+            clientContext?: ClientContext;
+        }) => Promise<{
+            flag_id: string;
+            flag_key: string;
+            environment: string;
+            value: T;
+            reason: string;
+            matched_rule_id?: string | null;
+            variant_key?: string | null;
+            bucket?: number | null;
+        }>;
+        evaluateBatch: (flagKeys: string[], context?: Record<string, unknown>, environment?: string, options?: {
+            clientContext?: ClientContext;
+        }) => Promise<Record<string, {
+            flag_id: string;
+            flag_key: string;
+            environment: string;
+            value: unknown;
+            reason: string;
+            matched_rule_id?: string | null;
+            variant_key?: string | null;
+            bucket?: number | null;
+        }>>;
+        evaluateAll: (context?: Record<string, unknown>, environment?: string, options?: {
+            clientContext?: ClientContext;
+        }) => Promise<Record<string, {
+            flag_id: string;
+            flag_key: string;
+            environment: string;
+            value: unknown;
+            reason: string;
+            matched_rule_id?: string | null;
+            variant_key?: string | null;
+            bucket?: number | null;
+        }>>;
+    };
 }
 /**
  * Create a server client with environment-based defaults

package/dist/{webhook-handler-BzBvYbZU.d.mts → webhook-handler-CweF_nT3.d.mts}

@@ -523,6 +523,44 @@ declare class ScaleMuleServer {
             tracked: number;
         }>;
     };
+    flags: {
+        evaluate: <T = unknown>(flagKey: string, context?: Record<string, unknown>, environment?: string, options?: {
+            clientContext?: ClientContext;
+        }) => Promise<{
+            flag_id: string;
+            flag_key: string;
+            environment: string;
+            value: T;
+            reason: string;
+            matched_rule_id?: string | null;
+            variant_key?: string | null;
+            bucket?: number | null;
+        }>;
+        evaluateBatch: (flagKeys: string[], context?: Record<string, unknown>, environment?: string, options?: {
+            clientContext?: ClientContext;
+        }) => Promise<Record<string, {
+            flag_id: string;
+            flag_key: string;
+            environment: string;
+            value: unknown;
+            reason: string;
+            matched_rule_id?: string | null;
+            variant_key?: string | null;
+            bucket?: number | null;
+        }>>;
+        evaluateAll: (context?: Record<string, unknown>, environment?: string, options?: {
+            clientContext?: ClientContext;
+        }) => Promise<Record<string, {
+            flag_id: string;
+            flag_key: string;
+            environment: string;
+            value: unknown;
+            reason: string;
+            matched_rule_id?: string | null;
+            variant_key?: string | null;
+            bucket?: number | null;
+        }>>;
+    };
 }
 /**
  * Create a server client with environment-based defaults

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scalemule/nextjs",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",