@feelflow/ffid-sdk 1.7.3 → 1.9.0

package/README.md

@@ -17,6 +17,10 @@ yarn add @feelflow/ffid-sdk
 pnpm add @feelflow/ffid-sdk
 ```
 
+## 統合ガイド
+
+サービスを FFID Platform に統合する詳細なガイドは **[Integration Guide](./docs/INTEGRATION_GUIDE.md)** を参照してください。OAuth フロー、フロントエンド/バックエンド実装パターン、セキュリティチェックリスト、アンチパターン集を網羅しています。
+
 ## クイックスタート
 
 ### 1. プロバイダーを設定（5行で完了！）
@@ -263,9 +267,10 @@ token mode では SDK は `/api/v1/oauth/userinfo` を呼び出し、基本プ
 
 ```ts
 interface FFIDOAuthUserInfoSubscription {
+  subscriptionId: string | null
   status: 'trialing' | 'active' | 'past_due' | 'canceled' | 'paused' | null
   planCode: string | null
-  seatModel: 'organization' | 'individual' | null
+  seatModel: 'organization' | null
   memberRole: 'owner' | 'admin' | 'member' | 'viewer' | null
   organizationId: string | null
 }

package/dist/{chunk-LLOXOE37.cjs → chunk-CBYBTBKA.cjs}

@@ -238,8 +238,11 @@ function createJwtVerifier(deps) {
 
 // src/client/verify-access-token.ts
 var OAUTH_INTROSPECT_ENDPOINT = "/api/v1/oauth/introspect";
+var CACHE_KEY_PREFIX = "ffid:introspect:";
+var HEX_BASE = 16;
+var HEX_BYTE_WIDTH = 2;
 function createVerifyAccessToken(deps) {
-  const { authMode, baseUrl, serviceCode, serviceApiKey, verifyStrategy, logger, createError, errorCodes } = deps;
+  const { authMode, baseUrl, serviceCode, serviceApiKey, verifyStrategy, logger, createError, errorCodes, cache, timeout } = deps;
   let jwtVerify2 = null;
   function getJwtVerifier() {
     if (!jwtVerify2) {
@@ -286,17 +289,33 @@ function createVerifyAccessToken(deps) {
     }
     const url = `${baseUrl}${OAUTH_INTROSPECT_ENDPOINT}`;
     logger.debug("Verifying access token:", url);
+    const cacheKey = await buildCacheKey(accessToken);
+    if (cache) {
+      try {
+        const cached = await cache.adapter.get(cacheKey);
+        if (cached && typeof cached === "object" && "sub" in cached) {
+          logger.debug("Cache hit for introspect result");
+          return { data: cached };
+        }
+      } catch (cacheError) {
+        logger.warn("Cache read failed, falling back to API call:", cacheError);
+      }
+    }
+    const fetchOptions = {
+      method: "POST",
+      credentials: "omit",
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded",
+        "X-Service-Api-Key": serviceApiKey
+      },
+      body: new URLSearchParams({ token: accessToken }).toString()
+    };
+    if (timeout !== void 0) {
+      fetchOptions.signal = AbortSignal.timeout(timeout);
+    }
     let response;
     try {
-      response = await fetch(url, {
-        method: "POST",
-        credentials: "omit",
-        headers: {
-          "Content-Type": "application/x-www-form-urlencoded",
-          "X-Service-Api-Key": serviceApiKey
-        },
-        body: new URLSearchParams({ token: accessToken }).toString()
-      });
+      response = await fetch(url, fetchOptions);
     } catch (error) {
       logger.error("Network error during token verification:", error);
       return {
@@ -362,7 +381,26 @@ function createVerifyAccessToken(deps) {
         organization_id: introspectResponse.subscription.organization_id
       }
     } : base;
-    return { data: normalizeUserinfo(raw) };
+    const userinfo = normalizeUserinfo(raw);
+    if (cache) {
+      try {
+        await cache.adapter.set(cacheKey, userinfo, cache.ttl);
+      } catch (cacheError) {
+        logger.warn("Cache write failed (result still returned):", cacheError);
+      }
+    }
+    return { data: userinfo };
+  }
+  async function buildCacheKey(token) {
+    if (typeof globalThis.crypto?.subtle?.digest === "function") {
+      const encoder = new TextEncoder();
+      const data = encoder.encode(token);
+      const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+      const hashArray = Array.from(new Uint8Array(hashBuffer));
+      const hashHex = hashArray.map((b) => b.toString(HEX_BASE).padStart(HEX_BYTE_WIDTH, "0")).join("");
+      return CACHE_KEY_PREFIX + hashHex;
+    }
+    return CACHE_KEY_PREFIX + token;
   }
   return verifyAccessToken;
 }
@@ -414,6 +452,43 @@ function createBillingMethods(deps) {
   return { createCheckoutSession, createPortalSession };
 }
 
+// src/client/version-check.ts
+var SDK_VERSION = "1.9.0";
+var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
+var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
+var LATEST_VERSION_HEADER = "X-FFID-SDK-Latest-Version";
+var SEMVER_PATTERN = /^\d+(\.\d+)*$/;
+var _versionWarningShown = false;
+function compareSemver(a, b) {
+  const cleanA = a.replace(/^v/, "");
+  const cleanB = b.replace(/^v/, "");
+  if (!SEMVER_PATTERN.test(cleanA) || !SEMVER_PATTERN.test(cleanB)) return 0;
+  const partsA = cleanA.split(".").map(Number);
+  const partsB = cleanB.split(".").map(Number);
+  const maxLen = Math.max(partsA.length, partsB.length);
+  for (let i = 0; i < maxLen; i++) {
+    const numA = partsA[i] ?? 0;
+    const numB = partsB[i] ?? 0;
+    if (numA < numB) return -1;
+    if (numA > numB) return 1;
+  }
+  return 0;
+}
+function checkVersionHeader(response, logger) {
+  if (_versionWarningShown) return;
+  if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") return;
+  if (!response.headers?.get) return;
+  const latestVersion = response.headers.get(LATEST_VERSION_HEADER);
+  if (!latestVersion) return;
+  if (compareSemver(SDK_VERSION, latestVersion) < 0) {
+    _versionWarningShown = true;
+    logger.warn(
+      `\u65B0\u3057\u3044\u30D0\u30FC\u30B8\u30E7\u30F3\u304C\u5229\u7528\u53EF\u80FD\u3067\u3059: v${latestVersion} (\u73FE\u5728: v${SDK_VERSION})
+npm install @feelflow/ffid-sdk@latest \u3067\u30A2\u30C3\u30D7\u30C7\u30FC\u30C8\u3067\u304D\u307E\u3059`
+    );
+  }
+}
+
 // src/client/ffid-client.ts
 var NO_CONTENT_STATUS = 204;
 var SESSION_ENDPOINT = "/api/v1/auth/session";
@@ -427,7 +502,7 @@ var SDK_LOG_PREFIX = "[FFID SDK]";
 var MS_PER_SECOND = 1e3;
 var UNAUTHORIZED_STATUS = 401;
 var STATE_RANDOM_BYTES = 16;
-var HEX_BASE = 16;
+var HEX_BASE2 = 16;
 var noopLogger = {
   debug: () => {
   },
@@ -462,9 +537,17 @@ function createFFIDClient(config) {
   const resolvedRedirectUri = config.redirectUri ?? null;
   const serviceApiKey = config.serviceApiKey?.trim();
   const verifyStrategy = config.verifyStrategy ?? "jwt";
+  const cache = config.cache;
+  const timeout = config.timeout;
   if (authMode === "service-key" && !serviceApiKey) {
     throw new Error("FFID Client: service-key \u30E2\u30FC\u30C9\u3067\u306F serviceApiKey \u304C\u5FC5\u9808\u3067\u3059");
   }
+  if (cache && cache.ttl <= 0) {
+    throw new Error("FFID Client: cache.ttl \u306F\u6B63\u306E\u6570\u5024\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044");
+  }
+  if (timeout !== void 0 && timeout <= 0) {
+    throw new Error("FFID Client: timeout \u306F\u6B63\u306E\u6570\u5024\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044");
+  }
   const logger = config.logger ?? (config.debug ? consoleLogger : noopLogger);
   const tokenStore = authMode === "token" ? createTokenStore() : createTokenStore("memory");
   async function fetchWithAuth(endpoint, options = {}) {
@@ -514,6 +597,7 @@ function createFFIDClient(config) {
       };
     }
     logger.debug("Response:", response.status, raw);
+    checkVersionHeader(response, logger);
     if (!response.ok) {
       return {
         error: raw.error ?? {
@@ -532,6 +616,12 @@ function createFFIDClient(config) {
     }
     return { data: raw.data };
   }
+  function sdkHeaders() {
+    return {
+      "User-Agent": SDK_USER_AGENT,
+      [SDK_VERSION_HEADER]: SDK_VERSION
+    };
+  }
   function buildFetchOptions(options) {
     if (authMode === "service-key") {
       return {
@@ -539,6 +629,7 @@ function createFFIDClient(config) {
         credentials: "omit",
         headers: {
           "Content-Type": "application/json",
+          ...sdkHeaders(),
           "X-Service-Api-Key": serviceApiKey,
           ...options.headers
         }
@@ -548,6 +639,7 @@ function createFFIDClient(config) {
       const tokens = tokenStore.getTokens();
       const headers = {
         "Content-Type": "application/json",
+        ...sdkHeaders(),
         ...options.headers
       };
       if (tokens) {
@@ -564,6 +656,7 @@ function createFFIDClient(config) {
       credentials: "include",
       headers: {
         "Content-Type": "application/json",
+        ...sdkHeaders(),
         ...options.headers
       }
     };
@@ -609,7 +702,8 @@ function createFFIDClient(config) {
         credentials: "omit",
         headers: {
           "Authorization": `Bearer ${tokens.accessToken}`,
-          "Content-Type": "application/json"
+          "Content-Type": "application/json",
+          ...sdkHeaders()
         }
       });
     } catch (error) {
@@ -631,7 +725,8 @@ function createFFIDClient(config) {
               credentials: "omit",
               headers: {
                 "Authorization": `Bearer ${retryTokens.accessToken}`,
-                "Content-Type": "application/json"
+                "Content-Type": "application/json",
+                ...sdkHeaders()
               }
             });
           } catch (retryError) {
@@ -701,7 +796,7 @@ function createFFIDClient(config) {
       response = await fetch(url, {
         method: "POST",
         credentials: "include",
-        headers: { "Content-Type": "application/json" }
+        headers: { "Content-Type": "application/json", ...sdkHeaders() }
       });
     } catch (error) {
       logger.error("Network error:", error);
@@ -750,7 +845,7 @@ function createFFIDClient(config) {
       await fetch(url, {
         method: "POST",
         credentials: "omit",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        headers: { "Content-Type": "application/x-www-form-urlencoded", ...sdkHeaders() },
         body: new URLSearchParams({
           token: tokens.accessToken,
           client_id: clientId
@@ -789,7 +884,7 @@ function createFFIDClient(config) {
       response = await fetch(url, {
         method: "POST",
         credentials: "omit",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        headers: { "Content-Type": "application/x-www-form-urlencoded", ...sdkHeaders() },
         body: new URLSearchParams(body).toString()
       });
     } catch (error) {
@@ -847,7 +942,7 @@ function createFFIDClient(config) {
       response = await fetch(url, {
         method: "POST",
         credentials: "omit",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        headers: { "Content-Type": "application/x-www-form-urlencoded", ...sdkHeaders() },
         body: new URLSearchParams({
           grant_type: "refresh_token",
           refresh_token: tokens.refreshToken,
@@ -972,7 +1067,9 @@ function createFFIDClient(config) {
     verifyStrategy,
     logger,
     createError,
-    errorCodes: FFID_ERROR_CODES
+    errorCodes: FFID_ERROR_CODES,
+    cache,
+    timeout
   });
   return {
     getSession,
@@ -1002,7 +1099,7 @@ function createFFIDClient(config) {
 function generateRandomState() {
   const array = new Uint8Array(STATE_RANDOM_BYTES);
   crypto.getRandomValues(array);
-  return Array.from(array, (byte) => byte.toString(HEX_BASE).padStart(2, "0")).join("");
+  return Array.from(array, (byte) => byte.toString(HEX_BASE2).padStart(2, "0")).join("");
 }
 var DEFAULT_REFRESH_INTERVAL_MS = 5 * 60 * 1e3;
 var TOKEN_REFRESH_RATIO = 0.8;

package/dist/{chunk-SNARMHI7.js → chunk-H5JRKOD7.js}

@@ -236,8 +236,11 @@ function createJwtVerifier(deps) {
 
 // src/client/verify-access-token.ts
 var OAUTH_INTROSPECT_ENDPOINT = "/api/v1/oauth/introspect";
+var CACHE_KEY_PREFIX = "ffid:introspect:";
+var HEX_BASE = 16;
+var HEX_BYTE_WIDTH = 2;
 function createVerifyAccessToken(deps) {
-  const { authMode, baseUrl, serviceCode, serviceApiKey, verifyStrategy, logger, createError, errorCodes } = deps;
+  const { authMode, baseUrl, serviceCode, serviceApiKey, verifyStrategy, logger, createError, errorCodes, cache, timeout } = deps;
   let jwtVerify2 = null;
   function getJwtVerifier() {
     if (!jwtVerify2) {
@@ -284,17 +287,33 @@ function createVerifyAccessToken(deps) {
     }
     const url = `${baseUrl}${OAUTH_INTROSPECT_ENDPOINT}`;
     logger.debug("Verifying access token:", url);
+    const cacheKey = await buildCacheKey(accessToken);
+    if (cache) {
+      try {
+        const cached = await cache.adapter.get(cacheKey);
+        if (cached && typeof cached === "object" && "sub" in cached) {
+          logger.debug("Cache hit for introspect result");
+          return { data: cached };
+        }
+      } catch (cacheError) {
+        logger.warn("Cache read failed, falling back to API call:", cacheError);
+      }
+    }
+    const fetchOptions = {
+      method: "POST",
+      credentials: "omit",
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded",
+        "X-Service-Api-Key": serviceApiKey
+      },
+      body: new URLSearchParams({ token: accessToken }).toString()
+    };
+    if (timeout !== void 0) {
+      fetchOptions.signal = AbortSignal.timeout(timeout);
+    }
     let response;
     try {
-      response = await fetch(url, {
-        method: "POST",
-        credentials: "omit",
-        headers: {
-          "Content-Type": "application/x-www-form-urlencoded",
-          "X-Service-Api-Key": serviceApiKey
-        },
-        body: new URLSearchParams({ token: accessToken }).toString()
-      });
+      response = await fetch(url, fetchOptions);
     } catch (error) {
       logger.error("Network error during token verification:", error);
       return {
@@ -360,7 +379,26 @@ function createVerifyAccessToken(deps) {
         organization_id: introspectResponse.subscription.organization_id
       }
     } : base;
-    return { data: normalizeUserinfo(raw) };
+    const userinfo = normalizeUserinfo(raw);
+    if (cache) {
+      try {
+        await cache.adapter.set(cacheKey, userinfo, cache.ttl);
+      } catch (cacheError) {
+        logger.warn("Cache write failed (result still returned):", cacheError);
+      }
+    }
+    return { data: userinfo };
+  }
+  async function buildCacheKey(token) {
+    if (typeof globalThis.crypto?.subtle?.digest === "function") {
+      const encoder = new TextEncoder();
+      const data = encoder.encode(token);
+      const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+      const hashArray = Array.from(new Uint8Array(hashBuffer));
+      const hashHex = hashArray.map((b) => b.toString(HEX_BASE).padStart(HEX_BYTE_WIDTH, "0")).join("");
+      return CACHE_KEY_PREFIX + hashHex;
+    }
+    return CACHE_KEY_PREFIX + token;
   }
   return verifyAccessToken;
 }
@@ -412,6 +450,43 @@ function createBillingMethods(deps) {
   return { createCheckoutSession, createPortalSession };
 }
 
+// src/client/version-check.ts
+var SDK_VERSION = "1.9.0";
+var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
+var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
+var LATEST_VERSION_HEADER = "X-FFID-SDK-Latest-Version";
+var SEMVER_PATTERN = /^\d+(\.\d+)*$/;
+var _versionWarningShown = false;
+function compareSemver(a, b) {
+  const cleanA = a.replace(/^v/, "");
+  const cleanB = b.replace(/^v/, "");
+  if (!SEMVER_PATTERN.test(cleanA) || !SEMVER_PATTERN.test(cleanB)) return 0;
+  const partsA = cleanA.split(".").map(Number);
+  const partsB = cleanB.split(".").map(Number);
+  const maxLen = Math.max(partsA.length, partsB.length);
+  for (let i = 0; i < maxLen; i++) {
+    const numA = partsA[i] ?? 0;
+    const numB = partsB[i] ?? 0;
+    if (numA < numB) return -1;
+    if (numA > numB) return 1;
+  }
+  return 0;
+}
+function checkVersionHeader(response, logger) {
+  if (_versionWarningShown) return;
+  if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") return;
+  if (!response.headers?.get) return;
+  const latestVersion = response.headers.get(LATEST_VERSION_HEADER);
+  if (!latestVersion) return;
+  if (compareSemver(SDK_VERSION, latestVersion) < 0) {
+    _versionWarningShown = true;
+    logger.warn(
+      `\u65B0\u3057\u3044\u30D0\u30FC\u30B8\u30E7\u30F3\u304C\u5229\u7528\u53EF\u80FD\u3067\u3059: v${latestVersion} (\u73FE\u5728: v${SDK_VERSION})
+npm install @feelflow/ffid-sdk@latest \u3067\u30A2\u30C3\u30D7\u30C7\u30FC\u30C8\u3067\u304D\u307E\u3059`
+    );
+  }
+}
+
 // src/client/ffid-client.ts
 var NO_CONTENT_STATUS = 204;
 var SESSION_ENDPOINT = "/api/v1/auth/session";
@@ -425,7 +500,7 @@ var SDK_LOG_PREFIX = "[FFID SDK]";
 var MS_PER_SECOND = 1e3;
 var UNAUTHORIZED_STATUS = 401;
 var STATE_RANDOM_BYTES = 16;
-var HEX_BASE = 16;
+var HEX_BASE2 = 16;
 var noopLogger = {
   debug: () => {
   },
@@ -460,9 +535,17 @@ function createFFIDClient(config) {
   const resolvedRedirectUri = config.redirectUri ?? null;
   const serviceApiKey = config.serviceApiKey?.trim();
   const verifyStrategy = config.verifyStrategy ?? "jwt";
+  const cache = config.cache;
+  const timeout = config.timeout;
   if (authMode === "service-key" && !serviceApiKey) {
     throw new Error("FFID Client: service-key \u30E2\u30FC\u30C9\u3067\u306F serviceApiKey \u304C\u5FC5\u9808\u3067\u3059");
   }
+  if (cache && cache.ttl <= 0) {
+    throw new Error("FFID Client: cache.ttl \u306F\u6B63\u306E\u6570\u5024\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044");
+  }
+  if (timeout !== void 0 && timeout <= 0) {
+    throw new Error("FFID Client: timeout \u306F\u6B63\u306E\u6570\u5024\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044");
+  }
   const logger = config.logger ?? (config.debug ? consoleLogger : noopLogger);
   const tokenStore = authMode === "token" ? createTokenStore() : createTokenStore("memory");
   async function fetchWithAuth(endpoint, options = {}) {
@@ -512,6 +595,7 @@ function createFFIDClient(config) {
       };
     }
     logger.debug("Response:", response.status, raw);
+    checkVersionHeader(response, logger);
     if (!response.ok) {
       return {
         error: raw.error ?? {
@@ -530,6 +614,12 @@ function createFFIDClient(config) {
     }
     return { data: raw.data };
   }
+  function sdkHeaders() {
+    return {
+      "User-Agent": SDK_USER_AGENT,
+      [SDK_VERSION_HEADER]: SDK_VERSION
+    };
+  }
   function buildFetchOptions(options) {
     if (authMode === "service-key") {
       return {
@@ -537,6 +627,7 @@ function createFFIDClient(config) {
         credentials: "omit",
         headers: {
           "Content-Type": "application/json",
+          ...sdkHeaders(),
           "X-Service-Api-Key": serviceApiKey,
           ...options.headers
         }
@@ -546,6 +637,7 @@ function createFFIDClient(config) {
       const tokens = tokenStore.getTokens();
       const headers = {
         "Content-Type": "application/json",
+        ...sdkHeaders(),
         ...options.headers
       };
       if (tokens) {
@@ -562,6 +654,7 @@ function createFFIDClient(config) {
       credentials: "include",
       headers: {
         "Content-Type": "application/json",
+        ...sdkHeaders(),
         ...options.headers
       }
     };
@@ -607,7 +700,8 @@ function createFFIDClient(config) {
         credentials: "omit",
         headers: {
           "Authorization": `Bearer ${tokens.accessToken}`,
-          "Content-Type": "application/json"
+          "Content-Type": "application/json",
+          ...sdkHeaders()
         }
       });
     } catch (error) {
@@ -629,7 +723,8 @@ function createFFIDClient(config) {
               credentials: "omit",
               headers: {
                 "Authorization": `Bearer ${retryTokens.accessToken}`,
-                "Content-Type": "application/json"
+                "Content-Type": "application/json",
+                ...sdkHeaders()
               }
             });
           } catch (retryError) {
@@ -699,7 +794,7 @@ function createFFIDClient(config) {
       response = await fetch(url, {
         method: "POST",
         credentials: "include",
-        headers: { "Content-Type": "application/json" }
+        headers: { "Content-Type": "application/json", ...sdkHeaders() }
       });
     } catch (error) {
       logger.error("Network error:", error);
@@ -748,7 +843,7 @@ function createFFIDClient(config) {
       await fetch(url, {
         method: "POST",
         credentials: "omit",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        headers: { "Content-Type": "application/x-www-form-urlencoded", ...sdkHeaders() },
         body: new URLSearchParams({
           token: tokens.accessToken,
           client_id: clientId
@@ -787,7 +882,7 @@ function createFFIDClient(config) {
       response = await fetch(url, {
         method: "POST",
         credentials: "omit",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        headers: { "Content-Type": "application/x-www-form-urlencoded", ...sdkHeaders() },
         body: new URLSearchParams(body).toString()
       });
     } catch (error) {
@@ -845,7 +940,7 @@ function createFFIDClient(config) {
       response = await fetch(url, {
         method: "POST",
         credentials: "omit",
-        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        headers: { "Content-Type": "application/x-www-form-urlencoded", ...sdkHeaders() },
         body: new URLSearchParams({
           grant_type: "refresh_token",
           refresh_token: tokens.refreshToken,
@@ -970,7 +1065,9 @@ function createFFIDClient(config) {
     verifyStrategy,
     logger,
     createError,
-    errorCodes: FFID_ERROR_CODES
+    errorCodes: FFID_ERROR_CODES,
+    cache,
+    timeout
   });
   return {
     getSession,
@@ -1000,7 +1097,7 @@ function createFFIDClient(config) {
 function generateRandomState() {
   const array = new Uint8Array(STATE_RANDOM_BYTES);
   crypto.getRandomValues(array);
-  return Array.from(array, (byte) => byte.toString(HEX_BASE).padStart(2, "0")).join("");
+  return Array.from(array, (byte) => byte.toString(HEX_BASE2).padStart(2, "0")).join("");
 }
 var DEFAULT_REFRESH_INTERVAL_MS = 5 * 60 * 1e3;
 var TOKEN_REFRESH_RATIO = 0.8;

package/dist/components/index.cjs

@@ -1,30 +1,30 @@
 'use strict';
 
-var chunkLLOXOE37_cjs = require('../chunk-LLOXOE37.cjs');
+var chunkCBYBTBKA_cjs = require('../chunk-CBYBTBKA.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDLoginButton; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDUserMenu; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDUserMenu; }
 });

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { u as FFIDAnnouncementBadge, Q as FFIDAnnouncementBadgeClassNames, R as FFIDAnnouncementBadgeProps, v as FFIDAnnouncementList, S as FFIDAnnouncementListClassNames, T as FFIDAnnouncementListProps, C as FFIDLoginButton, V as FFIDLoginButtonProps, H as FFIDOrganizationSwitcher, W as FFIDOrganizationSwitcherClassNames, X as FFIDOrganizationSwitcherProps, J as FFIDSubscriptionBadge, Y as FFIDSubscriptionBadgeClassNames, Z as FFIDSubscriptionBadgeProps, N as FFIDUserMenu, _ as FFIDUserMenuClassNames, $ as FFIDUserMenuProps } from '../index-ea8WAh39.cjs';
+export { v as FFIDAnnouncementBadge, S as FFIDAnnouncementBadgeClassNames, T as FFIDAnnouncementBadgeProps, w as FFIDAnnouncementList, V as FFIDAnnouncementListClassNames, W as FFIDAnnouncementListProps, E as FFIDLoginButton, X as FFIDLoginButtonProps, J as FFIDOrganizationSwitcher, Y as FFIDOrganizationSwitcherClassNames, Z as FFIDOrganizationSwitcherProps, M as FFIDSubscriptionBadge, _ as FFIDSubscriptionBadgeClassNames, $ as FFIDSubscriptionBadgeProps, P as FFIDUserMenu, a0 as FFIDUserMenuClassNames, a1 as FFIDUserMenuProps } from '../index-CTvhqdrH.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { u as FFIDAnnouncementBadge, Q as FFIDAnnouncementBadgeClassNames, R as FFIDAnnouncementBadgeProps, v as FFIDAnnouncementList, S as FFIDAnnouncementListClassNames, T as FFIDAnnouncementListProps, C as FFIDLoginButton, V as FFIDLoginButtonProps, H as FFIDOrganizationSwitcher, W as FFIDOrganizationSwitcherClassNames, X as FFIDOrganizationSwitcherProps, J as FFIDSubscriptionBadge, Y as FFIDSubscriptionBadgeClassNames, Z as FFIDSubscriptionBadgeProps, N as FFIDUserMenu, _ as FFIDUserMenuClassNames, $ as FFIDUserMenuProps } from '../index-ea8WAh39.js';
+export { v as FFIDAnnouncementBadge, S as FFIDAnnouncementBadgeClassNames, T as FFIDAnnouncementBadgeProps, w as FFIDAnnouncementList, V as FFIDAnnouncementListClassNames, W as FFIDAnnouncementListProps, E as FFIDLoginButton, X as FFIDLoginButtonProps, J as FFIDOrganizationSwitcher, Y as FFIDOrganizationSwitcherClassNames, Z as FFIDOrganizationSwitcherProps, M as FFIDSubscriptionBadge, _ as FFIDSubscriptionBadgeClassNames, $ as FFIDSubscriptionBadgeProps, P as FFIDUserMenu, a0 as FFIDUserMenuClassNames, a1 as FFIDUserMenuProps } from '../index-CTvhqdrH.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-SNARMHI7.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-H5JRKOD7.js';

package/dist/{index-ea8WAh39.d.cts → index-CTvhqdrH.d.cts}

@@ -1,11 +1,33 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ButtonHTMLAttributes, ReactNode, CSSProperties } from 'react';
 
+/** Cache adapter interface for FFID SDK token verification */
+/**
+ * Pluggable cache adapter interface.
+ * Implement this to use custom cache backends (Redis, Memcached, etc.)
+ */
+interface FFIDCacheAdapter {
+    /** Get a cached value by key. Returns null if not found or expired. */
+    get(key: string): Promise<unknown | null>;
+    /** Set a value with TTL in seconds. */
+    set(key: string, value: unknown, ttlSeconds: number): Promise<void>;
+    /** Delete a cached value. */
+    delete(key: string): Promise<void>;
+}
+/** Cache configuration for createFFIDClient */
+interface FFIDCacheConfig {
+    /** Cache adapter instance */
+    adapter: FFIDCacheAdapter;
+    /** Cache TTL in seconds (how long to cache userinfo/introspect results) */
+    ttl: number;
+}
+
 /**
  * FFID SDK Type Definitions
  *
  * Core types for the FeelFlow ID SDK
  */
+
 /**
  * User information from FFID
  */
@@ -151,6 +173,18 @@ interface FFIDConfig {
      * Use 'introspect' if you need full user profile data.
      */
     verifyStrategy?: 'jwt' | 'introspect' | undefined;
+    /**
+     * Cache configuration for token verification results.
+     * When set, introspect/userinfo responses are cached to reduce API calls.
+     * Only effective in service-key mode with verifyStrategy: 'introspect'.
+     */
+    cache?: FFIDCacheConfig | undefined;
+    /**
+     * Request timeout in milliseconds for FFID API calls.
+     * Applies to token verification and introspection requests.
+     * @default undefined (no timeout, uses fetch default)
+     */
+    timeout?: number | undefined;
 }
 /**
  * FFID JWT claims structure (minimal payload).
@@ -727,4 +761,4 @@ interface FFIDAnnouncementListProps {
  */
 declare function FFIDAnnouncementList({ announcements, isLoading, className, classNames, style, formatDate, emptyMessage, loadingRender, renderItem, maxContentLines, }: FFIDAnnouncementListProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDUserMenuProps as $, type AnnouncementListResponse as A, type FFIDJwtClaims as B, FFIDLoginButton as C, type FFIDOAuthTokenResponse as D, type FFIDOAuthUserInfoMemberRole as E, type FFIDConfig as F, type FFIDOAuthUserInfoSubscription as G, FFIDOrganizationSwitcher as H, type FFIDSeatModel as I, FFIDSubscriptionBadge as J, type FFIDSubscriptionStatus as K, type ListAnnouncementsOptions as L, type FFIDTokenIntrospectionResponse as M, FFIDUserMenu as N, type UseFFIDAnnouncementsReturn as O, useFFIDAnnouncements as P, type FFIDAnnouncementBadgeClassNames as Q, type FFIDAnnouncementBadgeProps as R, type FFIDAnnouncementListClassNames as S, type FFIDAnnouncementListProps as T, type UseFFIDAnnouncementsOptions as U, type FFIDLoginButtonProps as V, type FFIDOrganizationSwitcherClassNames as W, type FFIDOrganizationSwitcherProps as X, type FFIDSubscriptionBadgeClassNames as Y, type FFIDSubscriptionBadgeProps as Z, type FFIDUserMenuClassNames as _, type FFIDApiResponse as a, type FFIDSessionResponse as b, type FFIDError as c, type FFIDSubscriptionCheckResponse as d, type FFIDCreateCheckoutParams as e, type FFIDCheckoutSessionResponse as f, type FFIDCreatePortalParams as g, type FFIDPortalSessionResponse as h, type FFIDOAuthUserInfo as i, type FFIDLogger as j, type FFIDUser as k, type FFIDOrganization as l, type FFIDSubscription as m, type FFIDSubscriptionContextValue as n, type FFIDAnnouncementsClientConfig as o, type FFIDAnnouncementsApiResponse as p, type FFIDAnnouncementsLogger as q, type Announcement as r, type AnnouncementStatus as s, type AnnouncementType as t, FFIDAnnouncementBadge as u, FFIDAnnouncementList as v, type FFIDAnnouncementsError as w, type FFIDAnnouncementsErrorCode as x, type FFIDAnnouncementsServerResponse as y, type FFIDContextValue as z };
+export { type FFIDSubscriptionBadgeProps as $, type AnnouncementListResponse as A, type FFIDCacheConfig as B, type FFIDContextValue as C, type FFIDJwtClaims as D, FFIDLoginButton as E, type FFIDConfig as F, type FFIDOAuthTokenResponse as G, type FFIDOAuthUserInfoMemberRole as H, type FFIDOAuthUserInfoSubscription as I, FFIDOrganizationSwitcher as J, type FFIDSeatModel as K, type ListAnnouncementsOptions as L, FFIDSubscriptionBadge as M, type FFIDSubscriptionStatus as N, type FFIDTokenIntrospectionResponse as O, FFIDUserMenu as P, type UseFFIDAnnouncementsReturn as Q, useFFIDAnnouncements as R, type FFIDAnnouncementBadgeClassNames as S, type FFIDAnnouncementBadgeProps as T, type UseFFIDAnnouncementsOptions as U, type FFIDAnnouncementListClassNames as V, type FFIDAnnouncementListProps as W, type FFIDLoginButtonProps as X, type FFIDOrganizationSwitcherClassNames as Y, type FFIDOrganizationSwitcherProps as Z, type FFIDSubscriptionBadgeClassNames as _, type FFIDApiResponse as a, type FFIDUserMenuClassNames as a0, type FFIDUserMenuProps as a1, type FFIDSessionResponse as b, type FFIDError as c, type FFIDSubscriptionCheckResponse as d, type FFIDCreateCheckoutParams as e, type FFIDCheckoutSessionResponse as f, type FFIDCreatePortalParams as g, type FFIDPortalSessionResponse as h, type FFIDOAuthUserInfo as i, type FFIDLogger as j, type FFIDCacheAdapter as k, type FFIDUser as l, type FFIDOrganization as m, type FFIDSubscription as n, type FFIDSubscriptionContextValue as o, type FFIDAnnouncementsClientConfig as p, type FFIDAnnouncementsApiResponse as q, type FFIDAnnouncementsLogger as r, type Announcement as s, type AnnouncementStatus as t, type AnnouncementType as u, FFIDAnnouncementBadge as v, FFIDAnnouncementList as w, type FFIDAnnouncementsError as x, type FFIDAnnouncementsErrorCode as y, type FFIDAnnouncementsServerResponse as z };

package/dist/{index-ea8WAh39.d.ts → index-CTvhqdrH.d.ts}

@@ -1,11 +1,33 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ButtonHTMLAttributes, ReactNode, CSSProperties } from 'react';
 
+/** Cache adapter interface for FFID SDK token verification */
+/**
+ * Pluggable cache adapter interface.
+ * Implement this to use custom cache backends (Redis, Memcached, etc.)
+ */
+interface FFIDCacheAdapter {
+    /** Get a cached value by key. Returns null if not found or expired. */
+    get(key: string): Promise<unknown | null>;
+    /** Set a value with TTL in seconds. */
+    set(key: string, value: unknown, ttlSeconds: number): Promise<void>;
+    /** Delete a cached value. */
+    delete(key: string): Promise<void>;
+}
+/** Cache configuration for createFFIDClient */
+interface FFIDCacheConfig {
+    /** Cache adapter instance */
+    adapter: FFIDCacheAdapter;
+    /** Cache TTL in seconds (how long to cache userinfo/introspect results) */
+    ttl: number;
+}
+
 /**
  * FFID SDK Type Definitions
  *
  * Core types for the FeelFlow ID SDK
  */
+
 /**
  * User information from FFID
  */
@@ -151,6 +173,18 @@ interface FFIDConfig {
      * Use 'introspect' if you need full user profile data.
      */
     verifyStrategy?: 'jwt' | 'introspect' | undefined;
+    /**
+     * Cache configuration for token verification results.
+     * When set, introspect/userinfo responses are cached to reduce API calls.
+     * Only effective in service-key mode with verifyStrategy: 'introspect'.
+     */
+    cache?: FFIDCacheConfig | undefined;
+    /**
+     * Request timeout in milliseconds for FFID API calls.
+     * Applies to token verification and introspection requests.
+     * @default undefined (no timeout, uses fetch default)
+     */
+    timeout?: number | undefined;
 }
 /**
  * FFID JWT claims structure (minimal payload).
@@ -727,4 +761,4 @@ interface FFIDAnnouncementListProps {
  */
 declare function FFIDAnnouncementList({ announcements, isLoading, className, classNames, style, formatDate, emptyMessage, loadingRender, renderItem, maxContentLines, }: FFIDAnnouncementListProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDUserMenuProps as $, type AnnouncementListResponse as A, type FFIDJwtClaims as B, FFIDLoginButton as C, type FFIDOAuthTokenResponse as D, type FFIDOAuthUserInfoMemberRole as E, type FFIDConfig as F, type FFIDOAuthUserInfoSubscription as G, FFIDOrganizationSwitcher as H, type FFIDSeatModel as I, FFIDSubscriptionBadge as J, type FFIDSubscriptionStatus as K, type ListAnnouncementsOptions as L, type FFIDTokenIntrospectionResponse as M, FFIDUserMenu as N, type UseFFIDAnnouncementsReturn as O, useFFIDAnnouncements as P, type FFIDAnnouncementBadgeClassNames as Q, type FFIDAnnouncementBadgeProps as R, type FFIDAnnouncementListClassNames as S, type FFIDAnnouncementListProps as T, type UseFFIDAnnouncementsOptions as U, type FFIDLoginButtonProps as V, type FFIDOrganizationSwitcherClassNames as W, type FFIDOrganizationSwitcherProps as X, type FFIDSubscriptionBadgeClassNames as Y, type FFIDSubscriptionBadgeProps as Z, type FFIDUserMenuClassNames as _, type FFIDApiResponse as a, type FFIDSessionResponse as b, type FFIDError as c, type FFIDSubscriptionCheckResponse as d, type FFIDCreateCheckoutParams as e, type FFIDCheckoutSessionResponse as f, type FFIDCreatePortalParams as g, type FFIDPortalSessionResponse as h, type FFIDOAuthUserInfo as i, type FFIDLogger as j, type FFIDUser as k, type FFIDOrganization as l, type FFIDSubscription as m, type FFIDSubscriptionContextValue as n, type FFIDAnnouncementsClientConfig as o, type FFIDAnnouncementsApiResponse as p, type FFIDAnnouncementsLogger as q, type Announcement as r, type AnnouncementStatus as s, type AnnouncementType as t, FFIDAnnouncementBadge as u, FFIDAnnouncementList as v, type FFIDAnnouncementsError as w, type FFIDAnnouncementsErrorCode as x, type FFIDAnnouncementsServerResponse as y, type FFIDContextValue as z };
+export { type FFIDSubscriptionBadgeProps as $, type AnnouncementListResponse as A, type FFIDCacheConfig as B, type FFIDContextValue as C, type FFIDJwtClaims as D, FFIDLoginButton as E, type FFIDConfig as F, type FFIDOAuthTokenResponse as G, type FFIDOAuthUserInfoMemberRole as H, type FFIDOAuthUserInfoSubscription as I, FFIDOrganizationSwitcher as J, type FFIDSeatModel as K, type ListAnnouncementsOptions as L, FFIDSubscriptionBadge as M, type FFIDSubscriptionStatus as N, type FFIDTokenIntrospectionResponse as O, FFIDUserMenu as P, type UseFFIDAnnouncementsReturn as Q, useFFIDAnnouncements as R, type FFIDAnnouncementBadgeClassNames as S, type FFIDAnnouncementBadgeProps as T, type UseFFIDAnnouncementsOptions as U, type FFIDAnnouncementListClassNames as V, type FFIDAnnouncementListProps as W, type FFIDLoginButtonProps as X, type FFIDOrganizationSwitcherClassNames as Y, type FFIDOrganizationSwitcherProps as Z, type FFIDSubscriptionBadgeClassNames as _, type FFIDApiResponse as a, type FFIDUserMenuClassNames as a0, type FFIDUserMenuProps as a1, type FFIDSessionResponse as b, type FFIDError as c, type FFIDSubscriptionCheckResponse as d, type FFIDCreateCheckoutParams as e, type FFIDCheckoutSessionResponse as f, type FFIDCreatePortalParams as g, type FFIDPortalSessionResponse as h, type FFIDOAuthUserInfo as i, type FFIDLogger as j, type FFIDCacheAdapter as k, type FFIDUser as l, type FFIDOrganization as m, type FFIDSubscription as n, type FFIDSubscriptionContextValue as o, type FFIDAnnouncementsClientConfig as p, type FFIDAnnouncementsApiResponse as q, type FFIDAnnouncementsLogger as r, type Announcement as s, type AnnouncementStatus as t, type AnnouncementType as u, FFIDAnnouncementBadge as v, FFIDAnnouncementList as w, type FFIDAnnouncementsError as x, type FFIDAnnouncementsErrorCode as y, type FFIDAnnouncementsServerResponse as z };

package/dist/index.cjs

@@ -1,12 +1,52 @@
 'use strict';
 
-var chunkLLOXOE37_cjs = require('./chunk-LLOXOE37.cjs');
+var chunkCBYBTBKA_cjs = require('./chunk-CBYBTBKA.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
+// src/client/cache/memory-cache-adapter.ts
+var MS_PER_SECOND = 1e3;
+function createMemoryCacheAdapter() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    async get(key) {
+      const entry = store.get(key);
+      if (!entry) return null;
+      if (Date.now() >= entry.expiresAt) {
+        store.delete(key);
+        return null;
+      }
+      return entry.value;
+    },
+    async set(key, value, ttlSeconds) {
+      store.set(key, {
+        value,
+        expiresAt: Date.now() + ttlSeconds * MS_PER_SECOND
+      });
+    },
+    async delete(key) {
+      store.delete(key);
+    }
+  };
+}
+
+// src/client/cache/kv-cache-adapter.ts
+function createKVCacheAdapter(kv) {
+  return {
+    async get(key) {
+      return kv.get(key, "json");
+    },
+    async set(key, value, ttlSeconds) {
+      await kv.put(key, JSON.stringify(value), { expirationTtl: ttlSeconds });
+    },
+    async delete(key) {
+      await kv.delete(key);
+    }
+  };
+}
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkLLOXOE37_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkCBYBTBKA_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -31,82 +71,84 @@ function withFFIDAuth(Component, options = {}) {
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkCBYBTBKA_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDLoginButton; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDProvider; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFIDUserMenu; }
+  get: function () { return chunkCBYBTBKA_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkCBYBTBKA_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkCBYBTBKA_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.createFFIDClient; }
+  get: function () { return chunkCBYBTBKA_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.createTokenStore; }
+  get: function () { return chunkCBYBTBKA_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.generateCodeChallenge; }
+  get: function () { return chunkCBYBTBKA_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.generateCodeVerifier; }
+  get: function () { return chunkCBYBTBKA_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkCBYBTBKA_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.storeCodeVerifier; }
+  get: function () { return chunkCBYBTBKA_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.useFFID; }
+  get: function () { return chunkCBYBTBKA_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkCBYBTBKA_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.useSubscription; }
+  get: function () { return chunkCBYBTBKA_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkLLOXOE37_cjs.withSubscription; }
+  get: function () { return chunkCBYBTBKA_cjs.withSubscription; }
 });
+exports.createKVCacheAdapter = createKVCacheAdapter;
+exports.createMemoryCacheAdapter = createMemoryCacheAdapter;
 exports.withFFIDAuth = withFFIDAuth;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDConfig, a as FFIDApiResponse, b as FFIDSessionResponse, c as FFIDError, d as FFIDSubscriptionCheckResponse, e as FFIDCreateCheckoutParams, f as FFIDCheckoutSessionResponse, g as FFIDCreatePortalParams, h as FFIDPortalSessionResponse, i as FFIDOAuthUserInfo, j as FFIDLogger, k as FFIDUser, l as FFIDOrganization, m as FFIDSubscription, n as FFIDSubscriptionContextValue, o as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, p as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, q as FFIDAnnouncementsLogger } from './index-ea8WAh39.cjs';
-export { r as Announcement, s as AnnouncementStatus, t as AnnouncementType, u as FFIDAnnouncementBadge, v as FFIDAnnouncementList, w as FFIDAnnouncementsError, x as FFIDAnnouncementsErrorCode, y as FFIDAnnouncementsServerResponse, z as FFIDContextValue, B as FFIDJwtClaims, C as FFIDLoginButton, D as FFIDOAuthTokenResponse, E as FFIDOAuthUserInfoMemberRole, G as FFIDOAuthUserInfoSubscription, H as FFIDOrganizationSwitcher, I as FFIDSeatModel, J as FFIDSubscriptionBadge, K as FFIDSubscriptionStatus, M as FFIDTokenIntrospectionResponse, N as FFIDUserMenu, U as UseFFIDAnnouncementsOptions, O as UseFFIDAnnouncementsReturn, P as useFFIDAnnouncements } from './index-ea8WAh39.cjs';
+import { F as FFIDConfig, a as FFIDApiResponse, b as FFIDSessionResponse, c as FFIDError, d as FFIDSubscriptionCheckResponse, e as FFIDCreateCheckoutParams, f as FFIDCheckoutSessionResponse, g as FFIDCreatePortalParams, h as FFIDPortalSessionResponse, i as FFIDOAuthUserInfo, j as FFIDLogger, k as FFIDCacheAdapter, l as FFIDUser, m as FFIDOrganization, n as FFIDSubscription, o as FFIDSubscriptionContextValue, p as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, q as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, r as FFIDAnnouncementsLogger } from './index-CTvhqdrH.cjs';
+export { s as Announcement, t as AnnouncementStatus, u as AnnouncementType, v as FFIDAnnouncementBadge, w as FFIDAnnouncementList, x as FFIDAnnouncementsError, y as FFIDAnnouncementsErrorCode, z as FFIDAnnouncementsServerResponse, B as FFIDCacheConfig, C as FFIDContextValue, D as FFIDJwtClaims, E as FFIDLoginButton, G as FFIDOAuthTokenResponse, H as FFIDOAuthUserInfoMemberRole, I as FFIDOAuthUserInfoSubscription, J as FFIDOrganizationSwitcher, K as FFIDSeatModel, M as FFIDSubscriptionBadge, N as FFIDSubscriptionStatus, O as FFIDTokenIntrospectionResponse, P as FFIDUserMenu, U as UseFFIDAnnouncementsOptions, Q as UseFFIDAnnouncementsReturn, R as useFFIDAnnouncements } from './index-CTvhqdrH.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -115,6 +115,29 @@ declare function createFFIDClient(config: FFIDConfig): {
 /** Type of the FFID client */
 type FFIDClient = ReturnType<typeof createFFIDClient>;
 
+/**
+ * Create an in-memory cache adapter using a Map.
+ * Suitable for single-process environments (e.g., development, testing).
+ */
+declare function createMemoryCacheAdapter(): FFIDCacheAdapter;
+
+/**
+ * Minimal KVNamespace-compatible interface.
+ * Matches Cloudflare Workers KV without requiring the CF Workers dependency.
+ */
+interface KVNamespaceLike {
+    get(key: string, type: 'json'): Promise<unknown | null>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Create a cache adapter backed by a KVNamespace-compatible store.
+ * Suitable for Cloudflare Workers and other KV-based environments.
+ */
+declare function createKVCacheAdapter(kv: KVNamespaceLike): FFIDCacheAdapter;
+
 /**
  * Props for FFIDProvider component
  */
@@ -343,4 +366,4 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDLogger, FFIDOAuthUserInfo, FFIDOrganization, FFIDPortalSessionResponse, FFIDProvider, type FFIDProviderProps, FFIDSessionResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, FFIDUser, FFID_ANNOUNCEMENTS_ERROR_CODES, ListAnnouncementsOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };
+export { AnnouncementListResponse, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, FFIDCacheAdapter, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDLogger, FFIDOAuthUserInfo, FFIDOrganization, FFIDPortalSessionResponse, FFIDProvider, type FFIDProviderProps, FFIDSessionResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, FFIDUser, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDConfig, a as FFIDApiResponse, b as FFIDSessionResponse, c as FFIDError, d as FFIDSubscriptionCheckResponse, e as FFIDCreateCheckoutParams, f as FFIDCheckoutSessionResponse, g as FFIDCreatePortalParams, h as FFIDPortalSessionResponse, i as FFIDOAuthUserInfo, j as FFIDLogger, k as FFIDUser, l as FFIDOrganization, m as FFIDSubscription, n as FFIDSubscriptionContextValue, o as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, p as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, q as FFIDAnnouncementsLogger } from './index-ea8WAh39.js';
-export { r as Announcement, s as AnnouncementStatus, t as AnnouncementType, u as FFIDAnnouncementBadge, v as FFIDAnnouncementList, w as FFIDAnnouncementsError, x as FFIDAnnouncementsErrorCode, y as FFIDAnnouncementsServerResponse, z as FFIDContextValue, B as FFIDJwtClaims, C as FFIDLoginButton, D as FFIDOAuthTokenResponse, E as FFIDOAuthUserInfoMemberRole, G as FFIDOAuthUserInfoSubscription, H as FFIDOrganizationSwitcher, I as FFIDSeatModel, J as FFIDSubscriptionBadge, K as FFIDSubscriptionStatus, M as FFIDTokenIntrospectionResponse, N as FFIDUserMenu, U as UseFFIDAnnouncementsOptions, O as UseFFIDAnnouncementsReturn, P as useFFIDAnnouncements } from './index-ea8WAh39.js';
+import { F as FFIDConfig, a as FFIDApiResponse, b as FFIDSessionResponse, c as FFIDError, d as FFIDSubscriptionCheckResponse, e as FFIDCreateCheckoutParams, f as FFIDCheckoutSessionResponse, g as FFIDCreatePortalParams, h as FFIDPortalSessionResponse, i as FFIDOAuthUserInfo, j as FFIDLogger, k as FFIDCacheAdapter, l as FFIDUser, m as FFIDOrganization, n as FFIDSubscription, o as FFIDSubscriptionContextValue, p as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, q as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, r as FFIDAnnouncementsLogger } from './index-CTvhqdrH.js';
+export { s as Announcement, t as AnnouncementStatus, u as AnnouncementType, v as FFIDAnnouncementBadge, w as FFIDAnnouncementList, x as FFIDAnnouncementsError, y as FFIDAnnouncementsErrorCode, z as FFIDAnnouncementsServerResponse, B as FFIDCacheConfig, C as FFIDContextValue, D as FFIDJwtClaims, E as FFIDLoginButton, G as FFIDOAuthTokenResponse, H as FFIDOAuthUserInfoMemberRole, I as FFIDOAuthUserInfoSubscription, J as FFIDOrganizationSwitcher, K as FFIDSeatModel, M as FFIDSubscriptionBadge, N as FFIDSubscriptionStatus, O as FFIDTokenIntrospectionResponse, P as FFIDUserMenu, U as UseFFIDAnnouncementsOptions, Q as UseFFIDAnnouncementsReturn, R as useFFIDAnnouncements } from './index-CTvhqdrH.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -115,6 +115,29 @@ declare function createFFIDClient(config: FFIDConfig): {
 /** Type of the FFID client */
 type FFIDClient = ReturnType<typeof createFFIDClient>;
 
+/**
+ * Create an in-memory cache adapter using a Map.
+ * Suitable for single-process environments (e.g., development, testing).
+ */
+declare function createMemoryCacheAdapter(): FFIDCacheAdapter;
+
+/**
+ * Minimal KVNamespace-compatible interface.
+ * Matches Cloudflare Workers KV without requiring the CF Workers dependency.
+ */
+interface KVNamespaceLike {
+    get(key: string, type: 'json'): Promise<unknown | null>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Create a cache adapter backed by a KVNamespace-compatible store.
+ * Suitable for Cloudflare Workers and other KV-based environments.
+ */
+declare function createKVCacheAdapter(kv: KVNamespaceLike): FFIDCacheAdapter;
+
 /**
  * Props for FFIDProvider component
  */
@@ -343,4 +366,4 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDLogger, FFIDOAuthUserInfo, FFIDOrganization, FFIDPortalSessionResponse, FFIDProvider, type FFIDProviderProps, FFIDSessionResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, FFIDUser, FFID_ANNOUNCEMENTS_ERROR_CODES, ListAnnouncementsOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };
+export { AnnouncementListResponse, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, FFIDCacheAdapter, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDLogger, FFIDOAuthUserInfo, FFIDOrganization, FFIDPortalSessionResponse, FFIDProvider, type FFIDProviderProps, FFIDSessionResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, FFIDUser, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.js

@@ -1,8 +1,48 @@
-import { useFFIDContext } from './chunk-SNARMHI7.js';
-export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-SNARMHI7.js';
+import { useFFIDContext } from './chunk-H5JRKOD7.js';
+export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-H5JRKOD7.js';
 import { useRef, useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 
+// src/client/cache/memory-cache-adapter.ts
+var MS_PER_SECOND = 1e3;
+function createMemoryCacheAdapter() {
+  const store = /* @__PURE__ */ new Map();
+  return {
+    async get(key) {
+      const entry = store.get(key);
+      if (!entry) return null;
+      if (Date.now() >= entry.expiresAt) {
+        store.delete(key);
+        return null;
+      }
+      return entry.value;
+    },
+    async set(key, value, ttlSeconds) {
+      store.set(key, {
+        value,
+        expiresAt: Date.now() + ttlSeconds * MS_PER_SECOND
+      });
+    },
+    async delete(key) {
+      store.delete(key);
+    }
+  };
+}
+
+// src/client/cache/kv-cache-adapter.ts
+function createKVCacheAdapter(kv) {
+  return {
+    async get(key) {
+      return kv.get(key, "json");
+    },
+    async set(key, value, ttlSeconds) {
+      await kv.put(key, JSON.stringify(value), { expirationTtl: ttlSeconds });
+    },
+    async delete(key) {
+      await kv.delete(key);
+    }
+  };
+}
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
     const { isLoading, isAuthenticated, login } = useFFIDContext();
@@ -28,4 +68,4 @@ function withFFIDAuth(Component, options = {}) {
   return WrappedComponent;
 }
 
-export { withFFIDAuth };
+export { createKVCacheAdapter, createMemoryCacheAdapter, withFFIDAuth };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feelflow/ffid-sdk",
-  "version": "1.7.3",
+  "version": "1.9.0",
   "description": "FeelFlow ID Platform SDK for React/Next.js applications",
   "keywords": [
     "feelflow",