@scalemule/nextjs 0.0.12 → 0.0.13

package/dist/index.js

@@ -2908,9 +2908,15 @@ function useFeatureFlags(options = {}) {
       setLoading(false);
     }
   }, [client, enabled, environment, keys, keysKey, publishableKey, gatewayUrl]);
+  const bootstrapCoversKeys = react.useMemo(() => {
+    if (!hasBootstrap || !keys || keys.length === 0) return false;
+    return keys.every((k) => k in initialFlags);
+  }, [hasBootstrap, keys, initialFlags]);
   react.useEffect(() => {
-    void refresh();
-  }, [refresh]);
+    if (!bootstrapCoversKeys) {
+      void refresh();
+    }
+  }, [refresh, bootstrapCoversKeys]);
   const isEnabled = react.useCallback(
     (flagKey, fallback = false) => {
       const evaluation = flags[flagKey];

package/dist/index.mjs

@@ -2906,9 +2906,15 @@ function useFeatureFlags(options = {}) {
       setLoading(false);
     }
   }, [client, enabled, environment, keys, keysKey, publishableKey, gatewayUrl]);
+  const bootstrapCoversKeys = useMemo(() => {
+    if (!hasBootstrap || !keys || keys.length === 0) return false;
+    return keys.every((k) => k in initialFlags);
+  }, [hasBootstrap, keys, initialFlags]);
   useEffect(() => {
-    void refresh();
-  }, [refresh]);
+    if (!bootstrapCoversKeys) {
+      void refresh();
+    }
+  }, [refresh, bootstrapCoversKeys]);
   const isEnabled = useCallback(
     (flagKey, fallback = false) => {
       const evaluation = flags[flagKey];

package/dist/server/index.d.mts

@@ -439,6 +439,11 @@ declare function apiHandler(handler: HandlerFn, options?: HandlerOptions): (requ
  * Evaluates feature flags on the server during SSR so the client
  * has correct values on first render -- no loading flash, no race condition.
  *
+ * Results are cached in-memory with a configurable TTL (default: 60s) to
+ * prevent excessive API calls. Since feature flags change infrequently,
+ * a short cache window is fine and avoids hammering the flags service on
+ * every page render.
+ *
  * @example
  * ```ts
  * // app/layout.tsx
@@ -461,14 +466,18 @@ declare function apiHandler(handler: HandlerFn, options?: HandlerOptions): (requ
  * and passes it as ip_address in the evaluation context so IP-based targeting
  * rules work correctly.
  *
+ * Results are cached in-memory for `cacheTtlMs` milliseconds (default: 60s).
+ * Pass `cacheTtlMs: 0` to disable caching.
+ *
  * Returns a Record that can be passed directly to ScaleMuleProvider's
  * bootstrapFlags prop.
  *
  * @param flagKeys - Array of flag keys to evaluate
  * @param environment - Environment name (default: 'prod')
  * @param extraContext - Additional context attributes to include
+ * @param cacheTtlMs - Cache TTL in milliseconds (default: 60000). Set to 0 to disable.
  */
-declare function getBootstrapFlags(flagKeys: string[], environment?: string, extraContext?: Record<string, unknown>): Promise<Record<string, unknown>>;
+declare function getBootstrapFlags(flagKeys: string[], environment?: string, extraContext?: Record<string, unknown>, cacheTtlMs?: number): Promise<Record<string, unknown>>;
 
 /**
  * Next.js Middleware Helpers

package/dist/server/index.d.ts

@@ -439,6 +439,11 @@ declare function apiHandler(handler: HandlerFn, options?: HandlerOptions): (requ
  * Evaluates feature flags on the server during SSR so the client
  * has correct values on first render -- no loading flash, no race condition.
  *
+ * Results are cached in-memory with a configurable TTL (default: 60s) to
+ * prevent excessive API calls. Since feature flags change infrequently,
+ * a short cache window is fine and avoids hammering the flags service on
+ * every page render.
+ *
  * @example
  * ```ts
  * // app/layout.tsx
@@ -461,14 +466,18 @@ declare function apiHandler(handler: HandlerFn, options?: HandlerOptions): (requ
  * and passes it as ip_address in the evaluation context so IP-based targeting
  * rules work correctly.
  *
+ * Results are cached in-memory for `cacheTtlMs` milliseconds (default: 60s).
+ * Pass `cacheTtlMs: 0` to disable caching.
+ *
  * Returns a Record that can be passed directly to ScaleMuleProvider's
  * bootstrapFlags prop.
  *
  * @param flagKeys - Array of flag keys to evaluate
  * @param environment - Environment name (default: 'prod')
  * @param extraContext - Additional context attributes to include
+ * @param cacheTtlMs - Cache TTL in milliseconds (default: 60000). Set to 0 to disable.
  */
-declare function getBootstrapFlags(flagKeys: string[], environment?: string, extraContext?: Record<string, unknown>): Promise<Record<string, unknown>>;
+declare function getBootstrapFlags(flagKeys: string[], environment?: string, extraContext?: Record<string, unknown>, cacheTtlMs?: number): Promise<Record<string, unknown>>;
 
 /**
  * Next.js Middleware Helpers

package/dist/server/index.js

@@ -1772,8 +1772,17 @@ function getClient() {
   }
   return _serverClient;
 }
-async function getBootstrapFlags(flagKeys, environment = "prod", extraContext = {}) {
+var _flagCache = /* @__PURE__ */ new Map();
+var DEFAULT_CACHE_TTL_MS = 6e4;
+async function getBootstrapFlags(flagKeys, environment = "prod", extraContext = {}, cacheTtlMs = DEFAULT_CACHE_TTL_MS) {
   try {
+    const cacheKey = [...flagKeys].sort().join("|") + ":" + environment;
+    if (cacheTtlMs > 0) {
+      const cached = _flagCache.get(cacheKey);
+      if (cached && Date.now() - cached.timestamp < cacheTtlMs) {
+        return cached.result;
+      }
+    }
     const hdrs = await headers.headers();
     const forwardedFor = hdrs.get("x-forwarded-for");
     const realIp = hdrs.get("x-real-ip") || hdrs.get("x-real-client-ip");
@@ -1785,7 +1794,19 @@ async function getBootstrapFlags(flagKeys, environment = "prod", extraContext =
       context.ip_address = clientIp;
     }
     const result = await getClient().flags.evaluateBatch(flagKeys, context, environment);
-    return result || {};
+    const flagResult = result || {};
+    if (cacheTtlMs > 0) {
+      _flagCache.set(cacheKey, { result: flagResult, timestamp: Date.now() });
+      if (_flagCache.size > 100) {
+        const now = Date.now();
+        for (const [key, entry] of _flagCache) {
+          if (now - entry.timestamp > cacheTtlMs) {
+            _flagCache.delete(key);
+          }
+        }
+      }
+    }
+    return flagResult;
   } catch {
     return {};
   }
@@ -1917,14 +1938,14 @@ function clearOAuthState(response) {
 }
 
 // src/server/secrets.ts
-var DEFAULT_CACHE_TTL_MS = 5 * 60 * 1e3;
+var DEFAULT_CACHE_TTL_MS2 = 5 * 60 * 1e3;
 var secretsCache = {};
 var globalConfig = {};
 function configureSecrets(config) {
   globalConfig = { ...globalConfig, ...config };
 }
 async function getAppSecret(key) {
-  const cacheTtl = globalConfig.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+  const cacheTtl = globalConfig.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS2;
   const noCache = globalConfig.noCache ?? false;
   if (!noCache) {
     const cached = secretsCache[key];
@@ -1976,14 +1997,14 @@ async function prefetchSecrets(keys) {
 }
 
 // src/server/bundles.ts
-var DEFAULT_CACHE_TTL_MS2 = 5 * 60 * 1e3;
+var DEFAULT_CACHE_TTL_MS3 = 5 * 60 * 1e3;
 var bundlesCache = {};
 var globalConfig2 = {};
 function configureBundles(config) {
   globalConfig2 = { ...globalConfig2, ...config };
 }
 async function getBundle(key, resolve = true) {
-  const cacheTtl = globalConfig2.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS2;
+  const cacheTtl = globalConfig2.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS3;
   const noCache = globalConfig2.noCache ?? false;
   if (!noCache) {
     const cached = bundlesCache[key];

package/dist/server/index.mjs

@@ -1770,8 +1770,17 @@ function getClient() {
   }
   return _serverClient;
 }
-async function getBootstrapFlags(flagKeys, environment = "prod", extraContext = {}) {
+var _flagCache = /* @__PURE__ */ new Map();
+var DEFAULT_CACHE_TTL_MS = 6e4;
+async function getBootstrapFlags(flagKeys, environment = "prod", extraContext = {}, cacheTtlMs = DEFAULT_CACHE_TTL_MS) {
   try {
+    const cacheKey = [...flagKeys].sort().join("|") + ":" + environment;
+    if (cacheTtlMs > 0) {
+      const cached = _flagCache.get(cacheKey);
+      if (cached && Date.now() - cached.timestamp < cacheTtlMs) {
+        return cached.result;
+      }
+    }
     const hdrs = await headers();
     const forwardedFor = hdrs.get("x-forwarded-for");
     const realIp = hdrs.get("x-real-ip") || hdrs.get("x-real-client-ip");
@@ -1783,7 +1792,19 @@ async function getBootstrapFlags(flagKeys, environment = "prod", extraContext =
       context.ip_address = clientIp;
     }
     const result = await getClient().flags.evaluateBatch(flagKeys, context, environment);
-    return result || {};
+    const flagResult = result || {};
+    if (cacheTtlMs > 0) {
+      _flagCache.set(cacheKey, { result: flagResult, timestamp: Date.now() });
+      if (_flagCache.size > 100) {
+        const now = Date.now();
+        for (const [key, entry] of _flagCache) {
+          if (now - entry.timestamp > cacheTtlMs) {
+            _flagCache.delete(key);
+          }
+        }
+      }
+    }
+    return flagResult;
   } catch {
     return {};
   }
@@ -1915,14 +1936,14 @@ function clearOAuthState(response) {
 }
 
 // src/server/secrets.ts
-var DEFAULT_CACHE_TTL_MS = 5 * 60 * 1e3;
+var DEFAULT_CACHE_TTL_MS2 = 5 * 60 * 1e3;
 var secretsCache = {};
 var globalConfig = {};
 function configureSecrets(config) {
   globalConfig = { ...globalConfig, ...config };
 }
 async function getAppSecret(key) {
-  const cacheTtl = globalConfig.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+  const cacheTtl = globalConfig.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS2;
   const noCache = globalConfig.noCache ?? false;
   if (!noCache) {
     const cached = secretsCache[key];
@@ -1974,14 +1995,14 @@ async function prefetchSecrets(keys) {
 }
 
 // src/server/bundles.ts
-var DEFAULT_CACHE_TTL_MS2 = 5 * 60 * 1e3;
+var DEFAULT_CACHE_TTL_MS3 = 5 * 60 * 1e3;
 var bundlesCache = {};
 var globalConfig2 = {};
 function configureBundles(config) {
   globalConfig2 = { ...globalConfig2, ...config };
 }
 async function getBundle(key, resolve = true) {
-  const cacheTtl = globalConfig2.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS2;
+  const cacheTtl = globalConfig2.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS3;
   const noCache = globalConfig2.noCache ?? false;
   if (!noCache) {
     const cached = bundlesCache[key];

package/package.json

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