@scalemule/nextjs 0.0.9 → 0.0.11

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

@@ -2831,6 +2831,98 @@ 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, publishableKey, gatewayUrl } = 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 endpoint = keys && keys.length > 0 ? "/v1/flags/evaluate/batch" : "/v1/flags/evaluate/all";
+      let result;
+      if (publishableKey && gatewayUrl) {
+        const response = await fetch(`${gatewayUrl}${endpoint}`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": publishableKey
+          },
+          body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+          throw new Error(`Flag evaluation failed: ${response.status}`);
+        }
+        const json = await response.json();
+        result = json.data || json || {};
+      } else {
+        result = await client.post(endpoint, payload);
+      }
+      setFlags(result || {});
+      setError(null);
+    } catch (err) {
+      setError(toApiError(err));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, enabled, environment, keys, keysKey, publishableKey, gatewayUrl]);
+  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 = [
@@ -3136,6 +3228,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

@@ -2829,6 +2829,98 @@ 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, publishableKey, gatewayUrl } = 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 endpoint = keys && keys.length > 0 ? "/v1/flags/evaluate/batch" : "/v1/flags/evaluate/all";
+      let result;
+      if (publishableKey && gatewayUrl) {
+        const response = await fetch(`${gatewayUrl}${endpoint}`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "x-api-key": publishableKey
+          },
+          body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+          throw new Error(`Flag evaluation failed: ${response.status}`);
+        }
+        const json = await response.json();
+        result = json.data || json || {};
+      } else {
+        result = await client.post(endpoint, payload);
+      }
+      setFlags(result || {});
+      setError(null);
+    } catch (err) {
+      setError(toApiError(err));
+    } finally {
+      setLoading(false);
+    }
+  }, [client, enabled, environment, keys, keysKey, publishableKey, gatewayUrl]);
+  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 = [
@@ -3121,4 +3213,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.9",
+  "version": "0.0.11",
   "description": "ScaleMule SDK for Next.js applications - authentication, storage, and user management",
   "main": "dist/index.js",
   "module": "dist/index.mjs",