flagmint-react-sdk 0.7.13 → 0.7.14

package/dist/client.cjs

@@ -106,14 +106,14 @@ function useFlagmint() {
   };
 }
 function useFlags() {
-  const store = useFlagmintStore();
+  const store = react.useContext(FlagmintStoreContext);
   if (!store) {
     return {};
   }
   return zustand.useStore(store, (state) => state.flags);
 }
 function useFlag(key, fallback) {
-  const store = useFlagmintStore();
+  const store = react.useContext(FlagmintStoreContext);
   if (!store) {
     return fallback;
   }
@@ -121,7 +121,7 @@ function useFlag(key, fallback) {
   return flagValue != null ? flagValue : fallback;
 }
 function useFlagmintReady() {
-  const store = useFlagmintStore();
+  const store = react.useContext(FlagmintStoreContext);
   if (!store) {
     return false;
   }

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/store/store.ts","../src/providers/FlagmintProvider.tsx","../src/hooks/index.ts"],"names":["createStore","createContext","useMemo","useRef","FlagClient","useEffect","useContext","useStore"],"mappings":"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","file":"client.cjs","sourcesContent":["'use client';\nimport { createStore, StoreApi } from \"zustand/vanilla\";\nimport { Flags, FlagStore } from \"@/types\";\n\n\nexport function createFlagStore(initialFlags: Flags = {}): StoreApi<FlagStore> {\n   return createStore<FlagStore>((set, get) => ({\n    flags: initialFlags,\n    client: null,\n    isInitialized: false,\n    isReady: false,\n    setFlags: (flags) => {\n      set({ flags: { ...flags } })\n    },\n    setFlag: (key, value) => set((state) => ({\n      flags: { ...state.flags, [key]: value }\n    })),\n    setClient: (client) => set({ client }),\n    setInitialized: (initialized) => set({ isInitialized: initialized }),\n    setReady: (ready) => set({ isReady: ready })\n  }))\n}\n","'use client';\nimport { FlagClient } from \"flagmint-js-sdk\"\nimport { useMemo, useRef, useEffect, createContext } from \"react\"\nimport { createFlagStore } from \"@/store/store\"\nimport { FlagmintProviderProps, Flags, FlagStore } from \"@/types\"\nimport { StoreApi } from \"zustand\"\n\nexport const FlagmintStoreContext = createContext<StoreApi<FlagStore> | null>(null)\n\n/**\n * Provides the Flagmint flag store to React components and keeps it synced with FlagClient updates.\n * Lifecycle overview:\n * - App loads → FlagClient constructed → initialize() begins.\n * - Cached flags applied → subscribers notified → React renders cached values.\n * - Transport set up → initial fetch → store updated → subscribers notified.\n * - Subsequent server updates propagate via client.subscribe to re-render consumers.\n * - When context changes (updateContext), flags are re-fetched and the store is refreshed.\n *\n * @param props Component props: children, client options, optional initial flags, and deferInitialization flag.\n * @returns A provider that supplies the flag store context to its children.\n */\nexport function FlagmintProvider<\n  T extends FlagClient<T, C>,\n  C extends Record<string, any> = Record<string, any>\n>({\n  children,\n  options,\n  initialFlags = {},\n  deferInitialization = false\n}: FlagmintProviderProps<T, C>) {\n  // Create a new store instance for each provider (per-request in SSR)\n  const store = useMemo(() => createFlagStore(initialFlags), [])\n  \n  // Use ref to avoid recreating client on every render\n  const clientRef = useRef<FlagClient<T, C> | null>(null)\n  const initPromiseRef = useRef<Promise<FlagClient<T, C>> | null>(null)\n  const unsubscribeRef = useRef<(() => void) | null>(null)\n  \n  // Initialization function similar to Vue plugin\n  const init = async (): Promise<FlagClient<T, C>> => {\n    if (clientRef.current) return clientRef.current // Avoid re-init\n    \n    // Return existing promise if init is already in progress\n    if (initPromiseRef.current) return initPromiseRef.current\n    \n    const { setClient, setReady, setInitialized, setFlags } = store.getState()\n    \n    initPromiseRef.current = (async () => {\n      try {\n        // Create the FlagClient\n        const client = new FlagClient<T, C>(options)\n        \n        // Wait for client to be ready\n        await client.ready()\n        \n        // Get initial flags from client\n        const initialClientFlags = client.getFlags()\n        setFlags(initialClientFlags)\n        \n        // Subscribe to flag changes - THIS IS THE KEY FIX\n        const unsubscribe = client.subscribe((updatedFlags: Flags) => {\n          // Get fresh reference each time\n          const currentStore = store.getState();\n          currentStore.setFlags(updatedFlags);\n        })\n        \n        unsubscribeRef.current = unsubscribe\n        \n        clientRef.current = client\n        setClient(client)\n        setReady(true)\n        setInitialized(true)\n        \n        return client\n      } catch (error) {\n        console.error('Failed to initialize Flagmint client:', error)\n        throw error\n      }\n    })()\n    \n    return initPromiseRef.current\n  }\n\n  useEffect(() => {\n    if (!deferInitialization) {\n      init().catch(error => {\n        console.error('Auto-initialization failed:', error)\n      })\n    }\n\n    return () => {\n      // Unsubscribe from flag changes\n      if (unsubscribeRef.current) {\n        unsubscribeRef.current()\n        unsubscribeRef.current = null\n      }\n      \n      // Destroy client\n      if (clientRef.current) {\n        clientRef.current.destroy?.()\n        clientRef.current = null\n        initPromiseRef.current = null\n      }\n    }\n  }, [deferInitialization])\n\n  return (\n    <FlagmintStoreContext.Provider value={store}>\n      {children}\n    </FlagmintStoreContext.Provider>\n  )\n}\n","'use client';\nimport { FlagValue } from \"flagmint-js-sdk\"\nimport { useContext } from \"react\"\nimport { StoreApi, useStore } from \"zustand\"\nimport { FlagmintStoreContext } from \"@/providers/FlagmintProvider\"\nimport { FlagStore, Flags } from \"@/types\"\n\n// Helper to get the store from context\nexport function useFlagmintStore(): StoreApi<FlagStore> {\n  const store = useContext(FlagmintStoreContext)\n  if (!store) {\n    throw new Error('useFlagmintStore must be used within a FlagmintProvider')\n  }\n  return store\n}\n\n// Hook to get the client instance and update context\nexport function useFlagmint() {\n  const store = useFlagmintStore()\n  const client = useStore(store, (state) => state.client)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n\n  const updateContext = async (context: Record<string, any>) => {\n    if (!client) {\n      throw new Error('Flagmint client not initialized')\n    }\n    await client.updateContext(context)\n  }\n\n  return {\n    client,\n    isInitialized,\n    updateContext\n  }\n}\n\n// Hook to get all flags - only re-renders when flags change\nexport function useFlags(): Flags {\n  const store = useFlagmintStore()\n  if (!store) {\n    return {};\n  }\n  return useStore(store, (state) => state.flags)\n}\n\n// Simplified useFlag - just read from the reactive store\nexport function useFlag<T = FlagValue>(\n  key: string,\n  fallback?: T\n): T {\n  const store = useFlagmintStore()\n  if (!store) {\n    return fallback as T;\n  }\n  // Subscribe to this specific flag in the store\n  const flagValue = useStore(store, (state) => state.flags[key])\n  \n  // Return the flag value or fallback\n  return (flagValue ?? fallback) as T\n}\n\n// Hook to check if the client is ready\nexport function useFlagmintReady(): boolean {\n  const store = useFlagmintStore()\n  if (!store) {\n    return false;\n  }\n  // Subscribe to both isReady and isInitialized\n  const isReady = useStore(store, (state) => state.isReady)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n  \n  return isReady && isInitialized\n}"]}
+{"version":3,"sources":["../src/store/store.ts","../src/providers/FlagmintProvider.tsx","../src/hooks/index.ts"],"names":["createStore","createContext","useMemo","useRef","FlagClient","useEffect","useContext","useStore"],"mappings":";;;;;;;;AAKO,SAAS,eAAA,CAAgB,YAAA,GAAsB,EAAC,EAAwB;AAC5E,EAAA,OAAOA,mBAAA,CAAuB,CAAC,GAAA,EAAK,GAAA,MAAS;AAAA,IAC5C,KAAA,EAAO,YAAA;AAAA,IACP,MAAA,EAAQ,IAAA;AAAA,IACR,aAAA,EAAe,KAAA;AAAA,IACf,OAAA,EAAS,KAAA;AAAA,IACT,QAAA,EAAU,CAAC,KAAA,KAAU;AACnB,MAAA,GAAA,CAAI,EAAE,KAAA,EAAO,EAAE,GAAG,KAAA,IAAS,CAAA;AAAA,IAC7B,CAAA;AAAA,IACA,SAAS,CAAC,GAAA,EAAK,KAAA,KAAU,GAAA,CAAI,CAAC,KAAA,MAAW;AAAA,MACvC,KAAA,EAAO,EAAE,GAAG,KAAA,CAAM,OAAO,CAAC,GAAG,GAAG,KAAA;AAAM,KACxC,CAAE,CAAA;AAAA,IACF,WAAW,CAAC,MAAA,KAAW,GAAA,CAAI,EAAE,QAAQ,CAAA;AAAA,IACrC,gBAAgB,CAAC,WAAA,KAAgB,IAAI,EAAE,aAAA,EAAe,aAAa,CAAA;AAAA,IACnE,UAAU,CAAC,KAAA,KAAU,IAAI,EAAE,OAAA,EAAS,OAAO;AAAA,GAC7C,CAAE,CAAA;AACJ;ACdO,IAAM,oBAAA,GAAuBC,oBAA0C,IAAI;AAc3E,SAAS,gBAAA,CAGd;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,eAAe,EAAC;AAAA,EAChB,mBAAA,GAAsB;AACxB,CAAA,EAAgC;AAE9B,EAAA,MAAM,QAAQC,aAAA,CAAQ,MAAM,gBAAgB,YAAY,CAAA,EAAG,EAAE,CAAA;AAG7D,EAAA,MAAM,SAAA,GAAYC,aAAgC,IAAI,CAAA;AACtD,EAAA,MAAM,cAAA,GAAiBA,aAAyC,IAAI,CAAA;AACpE,EAAA,MAAM,cAAA,GAAiBA,aAA4B,IAAI,CAAA;AAGvD,EAAA,MAAM,OAAO,YAAuC;AAClD,IAAA,IAAI,SAAA,CAAU,OAAA,EAAS,OAAO,SAAA,CAAU,OAAA;AAGxC,IAAA,IAAI,cAAA,CAAe,OAAA,EAAS,OAAO,cAAA,CAAe,OAAA;AAElD,IAAA,MAAM,EAAE,SAAA,EAAW,QAAA,EAAU,gBAAgB,QAAA,EAAS,GAAI,MAAM,QAAA,EAAS;AAEzE,IAAA,cAAA,CAAe,WAAW,YAAY;AACpC,MAAA,IAAI;AAEF,QAAA,MAAM,MAAA,GAAS,IAAIC,wBAAA,CAAiB,OAAO,CAAA;AAG3C,QAAA,MAAM,OAAO,KAAA,EAAM;AAGnB,QAAA,MAAM,kBAAA,GAAqB,OAAO,QAAA,EAAS;AAC3C,QAAA,QAAA,CAAS,kBAAkB,CAAA;AAG3B,QAAA,MAAM,WAAA,GAAc,MAAA,CAAO,SAAA,CAAU,CAAC,YAAA,KAAwB;AAE5D,UAAA,MAAM,YAAA,GAAe,MAAM,QAAA,EAAS;AACpC,UAAA,YAAA,CAAa,SAAS,YAAY,CAAA;AAAA,QACpC,CAAC,CAAA;AAED,QAAA,cAAA,CAAe,OAAA,GAAU,WAAA;AAEzB,QAAA,SAAA,CAAU,OAAA,GAAU,MAAA;AACpB,QAAA,SAAA,CAAU,MAAM,CAAA;AAChB,QAAA,QAAA,CAAS,IAAI,CAAA;AACb,QAAA,cAAA,CAAe,IAAI,CAAA;AAEnB,QAAA,OAAO,MAAA;AAAA,MACT,SAAS,KAAA,EAAO;AACd,QAAA,OAAA,CAAQ,KAAA,CAAM,yCAAyC,KAAK,CAAA;AAC5D,QAAA,MAAM,KAAA;AAAA,MACR;AAAA,IACF,CAAA,GAAG;AAEH,IAAA,OAAO,cAAA,CAAe,OAAA;AAAA,EACxB,CAAA;AAEA,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,mBAAA,EAAqB;AACxB,MAAA,IAAA,EAAK,CAAE,MAAM,CAAA,KAAA,KAAS;AACpB,QAAA,OAAA,CAAQ,KAAA,CAAM,+BAA+B,KAAK,CAAA;AAAA,MACpD,CAAC,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,MAAM;AA1FjB,MAAA,IAAA,EAAA,EAAA,EAAA;AA4FM,MAAA,IAAI,eAAe,OAAA,EAAS;AAC1B,QAAA,cAAA,CAAe,OAAA,EAAQ;AACvB,QAAA,cAAA,CAAe,OAAA,GAAU,IAAA;AAAA,MAC3B;AAGA,MAAA,IAAI,UAAU,OAAA,EAAS;AACrB,QAAA,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,SAAA,CAAU,SAAQ,OAAA,KAAlB,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,EAAA,CAAA;AACA,QAAA,SAAA,CAAU,OAAA,GAAU,IAAA;AACpB,QAAA,cAAA,CAAe,OAAA,GAAU,IAAA;AAAA,MAC3B;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,mBAAmB,CAAC,CAAA;AAExB,EAAA,sCACG,oBAAA,CAAqB,QAAA,EAArB,EAA8B,KAAA,EAAO,OACnC,QAAA,EACH,CAAA;AAEJ;ACrFO,SAAS,gBAAA,GAAwC;AACtD,EAAA,MAAM,KAAA,GAAQC,iBAAW,oBAAoB,CAAA;AAC7C,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,MAAM,IAAI,MAAM,yDAAyD,CAAA;AAAA,EAC3E;AACA,EAAA,OAAO,KAAA;AACT;AA6BO,SAAS,WAAA,GAAc;AAC5B,EAAA,MAAM,QAAQ,gBAAA,EAAiB;AAC/B,EAAA,MAAM,SAASC,gBAAA,CAAS,KAAA,EAAO,CAAC,KAAA,KAAU,MAAM,MAAM,CAAA;AACtD,EAAA,MAAM,gBAAgBA,gBAAA,CAAS,KAAA,EAAO,CAAC,KAAA,KAAU,MAAM,aAAa,CAAA;AAEpE,EAAA,MAAM,aAAA,GAAgB,OAAO,OAAA,KAAiC;AAC5D,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,iCAAiC,CAAA;AAAA,IACnD;AACA,IAAA,MAAM,MAAA,CAAO,cAAc,OAAO,CAAA;AAAA,EACpC,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,aAAA;AAAA,IACA;AAAA,GACF;AACF;AA+BO,SAAS,QAAA,GAAkB;AAChC,EAAA,MAAM,KAAA,GAAQD,iBAAW,oBAAoB,CAAA;AAC7C,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,OAAOC,gBAAA,CAAS,KAAA,EAAO,CAAC,KAAA,KAAU,MAAM,KAAK,CAAA;AAC/C;AA2CO,SAAS,OAAA,CACd,KACA,QAAA,EACG;AACH,EAAA,MAAM,KAAA,GAAQD,iBAAW,oBAAoB,CAAA;AAC7C,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,MAAM,SAAA,GAAYC,iBAAS,KAAA,EAAO,CAAC,UAAU,KAAA,CAAM,KAAA,CAAM,GAAG,CAAC,CAAA;AAC7D,EAAA,OAAQ,SAAA,IAAA,IAAA,GAAA,SAAA,GAAa,QAAA;AACvB;AAkCO,SAAS,gBAAA,GAA4B;AAC1C,EAAA,MAAM,KAAA,GAAQD,iBAAW,oBAAoB,CAAA;AAC7C,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,MAAM,UAAUC,gBAAA,CAAS,KAAA,EAAO,CAAC,KAAA,KAAU,MAAM,OAAO,CAAA;AACxD,EAAA,MAAM,gBAAgBA,gBAAA,CAAS,KAAA,EAAO,CAAC,KAAA,KAAU,MAAM,aAAa,CAAA;AACpE,EAAA,OAAO,OAAA,IAAW,aAAA;AACpB","file":"client.cjs","sourcesContent":["'use client';\nimport { createStore, StoreApi } from \"zustand/vanilla\";\nimport { Flags, FlagStore } from \"@/types\";\n\n\nexport function createFlagStore(initialFlags: Flags = {}): StoreApi<FlagStore> {\n   return createStore<FlagStore>((set, get) => ({\n    flags: initialFlags,\n    client: null,\n    isInitialized: false,\n    isReady: false,\n    setFlags: (flags) => {\n      set({ flags: { ...flags } })\n    },\n    setFlag: (key, value) => set((state) => ({\n      flags: { ...state.flags, [key]: value }\n    })),\n    setClient: (client) => set({ client }),\n    setInitialized: (initialized) => set({ isInitialized: initialized }),\n    setReady: (ready) => set({ isReady: ready })\n  }))\n}\n","'use client';\nimport { FlagClient } from \"flagmint-js-sdk\"\nimport { useMemo, useRef, useEffect, createContext } from \"react\"\nimport { createFlagStore } from \"@/store/store\"\nimport { FlagmintProviderProps, Flags, FlagStore } from \"@/types\"\nimport { StoreApi } from \"zustand\"\n\nexport const FlagmintStoreContext = createContext<StoreApi<FlagStore> | null>(null)\n\n/**\n * Provides the Flagmint flag store to React components and keeps it synced with FlagClient updates.\n * Lifecycle overview:\n * - App loads → FlagClient constructed → initialize() begins.\n * - Cached flags applied → subscribers notified → React renders cached values.\n * - Transport set up → initial fetch → store updated → subscribers notified.\n * - Subsequent server updates propagate via client.subscribe to re-render consumers.\n * - When context changes (updateContext), flags are re-fetched and the store is refreshed.\n *\n * @param props Component props: children, client options, optional initial flags, and deferInitialization flag.\n * @returns A provider that supplies the flag store context to its children.\n */\nexport function FlagmintProvider<\n  T extends FlagClient<T, C>,\n  C extends Record<string, any> = Record<string, any>\n>({\n  children,\n  options,\n  initialFlags = {},\n  deferInitialization = false\n}: FlagmintProviderProps<T, C>) {\n  // Create a new store instance for each provider (per-request in SSR)\n  const store = useMemo(() => createFlagStore(initialFlags), [])\n  \n  // Use ref to avoid recreating client on every render\n  const clientRef = useRef<FlagClient<T, C> | null>(null)\n  const initPromiseRef = useRef<Promise<FlagClient<T, C>> | null>(null)\n  const unsubscribeRef = useRef<(() => void) | null>(null)\n  \n  // Initialization function similar to Vue plugin\n  const init = async (): Promise<FlagClient<T, C>> => {\n    if (clientRef.current) return clientRef.current // Avoid re-init\n    \n    // Return existing promise if init is already in progress\n    if (initPromiseRef.current) return initPromiseRef.current\n    \n    const { setClient, setReady, setInitialized, setFlags } = store.getState()\n    \n    initPromiseRef.current = (async () => {\n      try {\n        // Create the FlagClient\n        const client = new FlagClient<T, C>(options)\n        \n        // Wait for client to be ready\n        await client.ready()\n        \n        // Get initial flags from client\n        const initialClientFlags = client.getFlags()\n        setFlags(initialClientFlags)\n        \n        // Subscribe to flag changes - THIS IS THE KEY FIX\n        const unsubscribe = client.subscribe((updatedFlags: Flags) => {\n          // Get fresh reference each time\n          const currentStore = store.getState();\n          currentStore.setFlags(updatedFlags);\n        })\n        \n        unsubscribeRef.current = unsubscribe\n        \n        clientRef.current = client\n        setClient(client)\n        setReady(true)\n        setInitialized(true)\n        \n        return client\n      } catch (error) {\n        console.error('Failed to initialize Flagmint client:', error)\n        throw error\n      }\n    })()\n    \n    return initPromiseRef.current\n  }\n\n  useEffect(() => {\n    if (!deferInitialization) {\n      init().catch(error => {\n        console.error('Auto-initialization failed:', error)\n      })\n    }\n\n    return () => {\n      // Unsubscribe from flag changes\n      if (unsubscribeRef.current) {\n        unsubscribeRef.current()\n        unsubscribeRef.current = null\n      }\n      \n      // Destroy client\n      if (clientRef.current) {\n        clientRef.current.destroy?.()\n        clientRef.current = null\n        initPromiseRef.current = null\n      }\n    }\n  }, [deferInitialization])\n\n  return (\n    <FlagmintStoreContext.Provider value={store}>\n      {children}\n    </FlagmintStoreContext.Provider>\n  )\n}\n","'use client';\nimport { FlagValue } from \"flagmint-js-sdk\"\nimport { useContext } from \"react\"\nimport { StoreApi, useStore } from \"zustand\"\nimport { FlagmintStoreContext } from \"@/providers/FlagmintProvider\"\nimport { FlagStore, Flags } from \"@/types\"\n\n/**\n * Low-level hook that returns the raw Zustand store instance from context.\n *\n * **Use this when building custom hooks on top of the SDK**, not for general\n * flag consumption. Unlike the consumer hooks, this will throw if called\n * outside a FlagmintProvider - making it useful for catching misuse early\n * during development.\n *\n * @throws {Error} If called outside of a FlagmintProvider\n *\n * @example\n * // Building a custom hook that combines multiple flags\n * function useCanAccessBetaFeatures() {\n *   const store = useFlagmintStore();\n *   return useStore(store, (state) =>\n *     state.flags['beta_access'] && state.flags['new_ui']\n *   );\n * }\n */\nexport function useFlagmintStore(): StoreApi<FlagStore> {\n  const store = useContext(FlagmintStoreContext)\n  if (!store) {\n    throw new Error('useFlagmintStore must be used within a FlagmintProvider')\n  }\n  return store\n}\n\n/**\n * Hook that provides access to the underlying FlagClient instance and\n * the ability to update the evaluation context.\n *\n * **Use this when you need to update the context** after the initial render,\n * for example when a user logs in, changes their plan, or switches organization.\n * Re-renders are triggered when `isInitialized` changes.\n *\n * @throws {Error} If called outside of a FlagmintProvider\n * @throws {Error} If `updateContext` is called before the client is initialized\n *\n * @example\n * // Update context when user logs in\n * function Dashboard() {\n *   const { updateContext, isInitialized } = useFlagmint();\n *   const user = useCurrentUser();\n *\n *   useEffect(() => {\n *     if (user) {\n *       updateContext({ userId: user.id, plan: user.plan });\n *     }\n *   }, [user]);\n *\n *   if (!isInitialized) return <Spinner />;\n *   return <DashboardContent />;\n * }\n */\nexport function useFlagmint() {\n  const store = useFlagmintStore()\n  const client = useStore(store, (state) => state.client)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n\n  const updateContext = async (context: Record<string, any>) => {\n    if (!client) {\n      throw new Error('Flagmint client not initialized')\n    }\n    await client.updateContext(context)\n  }\n\n  return {\n    client,\n    isInitialized,\n    updateContext\n  }\n}\n\n/**\n * Hook that returns all feature flags as a reactive object.\n *\n * **Use this when you need to access multiple flags at once**, for example\n * to pass them to a child component or when rendering a list of features.\n * The component re-renders whenever any flag value changes.\n *\n * For single flag access prefer `useFlag` which only re-renders when that\n * specific flag changes.\n *\n * Returns an empty object `{}` if called outside a FlagmintProvider,\n * making it safe to use on public routes or before the user is authenticated.\n *\n * @returns All evaluated feature flags as a key-value object\n *\n * @example\n * // Passing multiple flags to a child\n * function FeatureList() {\n *   const flags = useFlags();\n *\n *   return (\n *     <ul>\n *       {Object.entries(flags).map(([key, value]) => (\n *         <li key={key}>{key}: {String(value)}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n */\nexport function useFlags(): Flags {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return {};\n  }\n  return useStore(store, (state) => state.flags);\n}\n\n/**\n * Hook that returns the current value of a single feature flag.\n *\n * **This is the primary hook for feature flag consumption.** Use this in\n * any component that needs to conditionally render or behave based on a\n * flag value. The component only re-renders when this specific flag changes,\n * not when other flags update.\n *\n * Returns `fallback` silently if called outside a FlagmintProvider, making\n * it safe to use on public routes or before the user is authenticated.\n *\n * @param key - The feature flag key to evaluate\n * @param fallback - Value to return if the flag is not found or the provider is not ready\n * @returns The flag value cast to type T, or the fallback value\n *\n * @example\n * // Boolean flag - show/hide a feature\n * function RightRail() {\n *   const showDocumentation = useFlag<boolean>('show_documentation_feature', false);\n *\n *   return (\n *     <div>\n *       {showDocumentation && <DocumentationCard />}\n *     </div>\n *   );\n * }\n *\n * @example\n * // String flag - switch between variants\n * function Header() {\n *   const colorScheme = useFlag<string>('color_scheme', 'light');\n *   return <header className={colorScheme}>...</header>;\n * }\n *\n * @example\n * // Number flag - configure a limit\n * function ResultsList() {\n *   const resultsPerPage = useFlag<number>('results_per_page', 10);\n *   return <List limit={resultsPerPage} />;\n * }\n */\nexport function useFlag<T = FlagValue>(\n  key: string,\n  fallback?: T\n): T {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return fallback as T;\n  }\n  const flagValue = useStore(store, (state) => state.flags[key]);\n  return (flagValue ?? fallback) as T;\n}\n\n/**\n * Hook that returns whether the Flagmint client has finished initializing\n * and is ready to serve flag values.\n *\n * **Use this to gate rendering** of components that depend on flags having\n * their real server values, preventing a flash of incorrect content on\n * first load. Both `isReady` and `isInitialized` must be true before\n * this returns `true`.\n *\n * Returns `false` silently if called outside a FlagmintProvider, making\n * it safe to use on public routes.\n *\n * @returns `true` when the client is initialized and flags are loaded\n *\n * @example\n * // Gate rendering until flags are ready\n * function App() {\n *   const isReady = useFlagmintReady();\n *   if (!isReady) return <Spinner />;\n *   return <Dashboard />;\n * }\n *\n * @example\n * // Avoid flash of wrong content on first load\n * function PricingPage() {\n *   const isReady = useFlagmintReady();\n *   const showNewPricing = useFlag<boolean>('new_pricing_page', false);\n *\n *   if (!isReady) return <Skeleton />;\n *   return showNewPricing ? <NewPricing /> : <OldPricing />;\n * }\n */\nexport function useFlagmintReady(): boolean {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return false;\n  }\n  const isReady = useStore(store, (state) => state.isReady);\n  const isInitialized = useStore(store, (state) => state.isInitialized);\n  return isReady && isInitialized;\n}"]}

package/dist/client.d.cts

@@ -51,14 +51,162 @@ declare const FlagmintStoreContext: react.Context<StoreApi<FlagStore> | null>;
  */
 declare function FlagmintProvider<T extends FlagClient<T, C>, C extends Record<string, any> = Record<string, any>>({ children, options, initialFlags, deferInitialization }: FlagmintProviderProps<T, C>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Low-level hook that returns the raw Zustand store instance from context.
+ *
+ * **Use this when building custom hooks on top of the SDK**, not for general
+ * flag consumption. Unlike the consumer hooks, this will throw if called
+ * outside a FlagmintProvider - making it useful for catching misuse early
+ * during development.
+ *
+ * @throws {Error} If called outside of a FlagmintProvider
+ *
+ * @example
+ * // Building a custom hook that combines multiple flags
+ * function useCanAccessBetaFeatures() {
+ *   const store = useFlagmintStore();
+ *   return useStore(store, (state) =>
+ *     state.flags['beta_access'] && state.flags['new_ui']
+ *   );
+ * }
+ */
 declare function useFlagmintStore(): StoreApi<FlagStore>;
+/**
+ * Hook that provides access to the underlying FlagClient instance and
+ * the ability to update the evaluation context.
+ *
+ * **Use this when you need to update the context** after the initial render,
+ * for example when a user logs in, changes their plan, or switches organization.
+ * Re-renders are triggered when `isInitialized` changes.
+ *
+ * @throws {Error} If called outside of a FlagmintProvider
+ * @throws {Error} If `updateContext` is called before the client is initialized
+ *
+ * @example
+ * // Update context when user logs in
+ * function Dashboard() {
+ *   const { updateContext, isInitialized } = useFlagmint();
+ *   const user = useCurrentUser();
+ *
+ *   useEffect(() => {
+ *     if (user) {
+ *       updateContext({ userId: user.id, plan: user.plan });
+ *     }
+ *   }, [user]);
+ *
+ *   if (!isInitialized) return <Spinner />;
+ *   return <DashboardContent />;
+ * }
+ */
 declare function useFlagmint(): {
     client: flagmint_js_sdk.FlagClient<any, any> | null;
     isInitialized: boolean;
     updateContext: (context: Record<string, any>) => Promise<void>;
 };
+/**
+ * Hook that returns all feature flags as a reactive object.
+ *
+ * **Use this when you need to access multiple flags at once**, for example
+ * to pass them to a child component or when rendering a list of features.
+ * The component re-renders whenever any flag value changes.
+ *
+ * For single flag access prefer `useFlag` which only re-renders when that
+ * specific flag changes.
+ *
+ * Returns an empty object `{}` if called outside a FlagmintProvider,
+ * making it safe to use on public routes or before the user is authenticated.
+ *
+ * @returns All evaluated feature flags as a key-value object
+ *
+ * @example
+ * // Passing multiple flags to a child
+ * function FeatureList() {
+ *   const flags = useFlags();
+ *
+ *   return (
+ *     <ul>
+ *       {Object.entries(flags).map(([key, value]) => (
+ *         <li key={key}>{key}: {String(value)}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ */
 declare function useFlags(): Flags;
+/**
+ * Hook that returns the current value of a single feature flag.
+ *
+ * **This is the primary hook for feature flag consumption.** Use this in
+ * any component that needs to conditionally render or behave based on a
+ * flag value. The component only re-renders when this specific flag changes,
+ * not when other flags update.
+ *
+ * Returns `fallback` silently if called outside a FlagmintProvider, making
+ * it safe to use on public routes or before the user is authenticated.
+ *
+ * @param key - The feature flag key to evaluate
+ * @param fallback - Value to return if the flag is not found or the provider is not ready
+ * @returns The flag value cast to type T, or the fallback value
+ *
+ * @example
+ * // Boolean flag - show/hide a feature
+ * function RightRail() {
+ *   const showDocumentation = useFlag<boolean>('show_documentation_feature', false);
+ *
+ *   return (
+ *     <div>
+ *       {showDocumentation && <DocumentationCard />}
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // String flag - switch between variants
+ * function Header() {
+ *   const colorScheme = useFlag<string>('color_scheme', 'light');
+ *   return <header className={colorScheme}>...</header>;
+ * }
+ *
+ * @example
+ * // Number flag - configure a limit
+ * function ResultsList() {
+ *   const resultsPerPage = useFlag<number>('results_per_page', 10);
+ *   return <List limit={resultsPerPage} />;
+ * }
+ */
 declare function useFlag<T = FlagValue$1>(key: string, fallback?: T): T;
+/**
+ * Hook that returns whether the Flagmint client has finished initializing
+ * and is ready to serve flag values.
+ *
+ * **Use this to gate rendering** of components that depend on flags having
+ * their real server values, preventing a flash of incorrect content on
+ * first load. Both `isReady` and `isInitialized` must be true before
+ * this returns `true`.
+ *
+ * Returns `false` silently if called outside a FlagmintProvider, making
+ * it safe to use on public routes.
+ *
+ * @returns `true` when the client is initialized and flags are loaded
+ *
+ * @example
+ * // Gate rendering until flags are ready
+ * function App() {
+ *   const isReady = useFlagmintReady();
+ *   if (!isReady) return <Spinner />;
+ *   return <Dashboard />;
+ * }
+ *
+ * @example
+ * // Avoid flash of wrong content on first load
+ * function PricingPage() {
+ *   const isReady = useFlagmintReady();
+ *   const showNewPricing = useFlag<boolean>('new_pricing_page', false);
+ *
+ *   if (!isReady) return <Skeleton />;
+ *   return showNewPricing ? <NewPricing /> : <OldPricing />;
+ * }
+ */
 declare function useFlagmintReady(): boolean;
 
 declare function createFlagStore(initialFlags?: Flags): StoreApi$1<FlagStore>;

package/dist/client.d.ts

@@ -51,14 +51,162 @@ declare const FlagmintStoreContext: react.Context<StoreApi<FlagStore> | null>;
  */
 declare function FlagmintProvider<T extends FlagClient<T, C>, C extends Record<string, any> = Record<string, any>>({ children, options, initialFlags, deferInitialization }: FlagmintProviderProps<T, C>): react_jsx_runtime.JSX.Element;
 
+/**
+ * Low-level hook that returns the raw Zustand store instance from context.
+ *
+ * **Use this when building custom hooks on top of the SDK**, not for general
+ * flag consumption. Unlike the consumer hooks, this will throw if called
+ * outside a FlagmintProvider - making it useful for catching misuse early
+ * during development.
+ *
+ * @throws {Error} If called outside of a FlagmintProvider
+ *
+ * @example
+ * // Building a custom hook that combines multiple flags
+ * function useCanAccessBetaFeatures() {
+ *   const store = useFlagmintStore();
+ *   return useStore(store, (state) =>
+ *     state.flags['beta_access'] && state.flags['new_ui']
+ *   );
+ * }
+ */
 declare function useFlagmintStore(): StoreApi<FlagStore>;
+/**
+ * Hook that provides access to the underlying FlagClient instance and
+ * the ability to update the evaluation context.
+ *
+ * **Use this when you need to update the context** after the initial render,
+ * for example when a user logs in, changes their plan, or switches organization.
+ * Re-renders are triggered when `isInitialized` changes.
+ *
+ * @throws {Error} If called outside of a FlagmintProvider
+ * @throws {Error} If `updateContext` is called before the client is initialized
+ *
+ * @example
+ * // Update context when user logs in
+ * function Dashboard() {
+ *   const { updateContext, isInitialized } = useFlagmint();
+ *   const user = useCurrentUser();
+ *
+ *   useEffect(() => {
+ *     if (user) {
+ *       updateContext({ userId: user.id, plan: user.plan });
+ *     }
+ *   }, [user]);
+ *
+ *   if (!isInitialized) return <Spinner />;
+ *   return <DashboardContent />;
+ * }
+ */
 declare function useFlagmint(): {
     client: flagmint_js_sdk.FlagClient<any, any> | null;
     isInitialized: boolean;
     updateContext: (context: Record<string, any>) => Promise<void>;
 };
+/**
+ * Hook that returns all feature flags as a reactive object.
+ *
+ * **Use this when you need to access multiple flags at once**, for example
+ * to pass them to a child component or when rendering a list of features.
+ * The component re-renders whenever any flag value changes.
+ *
+ * For single flag access prefer `useFlag` which only re-renders when that
+ * specific flag changes.
+ *
+ * Returns an empty object `{}` if called outside a FlagmintProvider,
+ * making it safe to use on public routes or before the user is authenticated.
+ *
+ * @returns All evaluated feature flags as a key-value object
+ *
+ * @example
+ * // Passing multiple flags to a child
+ * function FeatureList() {
+ *   const flags = useFlags();
+ *
+ *   return (
+ *     <ul>
+ *       {Object.entries(flags).map(([key, value]) => (
+ *         <li key={key}>{key}: {String(value)}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ */
 declare function useFlags(): Flags;
+/**
+ * Hook that returns the current value of a single feature flag.
+ *
+ * **This is the primary hook for feature flag consumption.** Use this in
+ * any component that needs to conditionally render or behave based on a
+ * flag value. The component only re-renders when this specific flag changes,
+ * not when other flags update.
+ *
+ * Returns `fallback` silently if called outside a FlagmintProvider, making
+ * it safe to use on public routes or before the user is authenticated.
+ *
+ * @param key - The feature flag key to evaluate
+ * @param fallback - Value to return if the flag is not found or the provider is not ready
+ * @returns The flag value cast to type T, or the fallback value
+ *
+ * @example
+ * // Boolean flag - show/hide a feature
+ * function RightRail() {
+ *   const showDocumentation = useFlag<boolean>('show_documentation_feature', false);
+ *
+ *   return (
+ *     <div>
+ *       {showDocumentation && <DocumentationCard />}
+ *     </div>
+ *   );
+ * }
+ *
+ * @example
+ * // String flag - switch between variants
+ * function Header() {
+ *   const colorScheme = useFlag<string>('color_scheme', 'light');
+ *   return <header className={colorScheme}>...</header>;
+ * }
+ *
+ * @example
+ * // Number flag - configure a limit
+ * function ResultsList() {
+ *   const resultsPerPage = useFlag<number>('results_per_page', 10);
+ *   return <List limit={resultsPerPage} />;
+ * }
+ */
 declare function useFlag<T = FlagValue$1>(key: string, fallback?: T): T;
+/**
+ * Hook that returns whether the Flagmint client has finished initializing
+ * and is ready to serve flag values.
+ *
+ * **Use this to gate rendering** of components that depend on flags having
+ * their real server values, preventing a flash of incorrect content on
+ * first load. Both `isReady` and `isInitialized` must be true before
+ * this returns `true`.
+ *
+ * Returns `false` silently if called outside a FlagmintProvider, making
+ * it safe to use on public routes.
+ *
+ * @returns `true` when the client is initialized and flags are loaded
+ *
+ * @example
+ * // Gate rendering until flags are ready
+ * function App() {
+ *   const isReady = useFlagmintReady();
+ *   if (!isReady) return <Spinner />;
+ *   return <Dashboard />;
+ * }
+ *
+ * @example
+ * // Avoid flash of wrong content on first load
+ * function PricingPage() {
+ *   const isReady = useFlagmintReady();
+ *   const showNewPricing = useFlag<boolean>('new_pricing_page', false);
+ *
+ *   if (!isReady) return <Skeleton />;
+ *   return showNewPricing ? <NewPricing /> : <OldPricing />;
+ * }
+ */
 declare function useFlagmintReady(): boolean;
 
 declare function createFlagStore(initialFlags?: Flags): StoreApi$1<FlagStore>;

package/dist/client.js

@@ -104,14 +104,14 @@ function useFlagmint() {
   };
 }
 function useFlags() {
-  const store = useFlagmintStore();
+  const store = useContext(FlagmintStoreContext);
   if (!store) {
     return {};
   }
   return useStore(store, (state) => state.flags);
 }
 function useFlag(key, fallback) {
-  const store = useFlagmintStore();
+  const store = useContext(FlagmintStoreContext);
   if (!store) {
     return fallback;
   }
@@ -119,7 +119,7 @@ function useFlag(key, fallback) {
   return flagValue != null ? flagValue : fallback;
 }
 function useFlagmintReady() {
-  const store = useFlagmintStore();
+  const store = useContext(FlagmintStoreContext);
   if (!store) {
     return false;
   }

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/store/store.ts","../src/providers/FlagmintProvider.tsx","../src/hooks/index.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["'use client';\nimport { createStore, StoreApi } from \"zustand/vanilla\";\nimport { Flags, FlagStore } from \"@/types\";\n\n\nexport function createFlagStore(initialFlags: Flags = {}): StoreApi<FlagStore> {\n   return createStore<FlagStore>((set, get) => ({\n    flags: initialFlags,\n    client: null,\n    isInitialized: false,\n    isReady: false,\n    setFlags: (flags) => {\n      set({ flags: { ...flags } })\n    },\n    setFlag: (key, value) => set((state) => ({\n      flags: { ...state.flags, [key]: value }\n    })),\n    setClient: (client) => set({ client }),\n    setInitialized: (initialized) => set({ isInitialized: initialized }),\n    setReady: (ready) => set({ isReady: ready })\n  }))\n}\n","'use client';\nimport { FlagClient } from \"flagmint-js-sdk\"\nimport { useMemo, useRef, useEffect, createContext } from \"react\"\nimport { createFlagStore } from \"@/store/store\"\nimport { FlagmintProviderProps, Flags, FlagStore } from \"@/types\"\nimport { StoreApi } from \"zustand\"\n\nexport const FlagmintStoreContext = createContext<StoreApi<FlagStore> | null>(null)\n\n/**\n * Provides the Flagmint flag store to React components and keeps it synced with FlagClient updates.\n * Lifecycle overview:\n * - App loads → FlagClient constructed → initialize() begins.\n * - Cached flags applied → subscribers notified → React renders cached values.\n * - Transport set up → initial fetch → store updated → subscribers notified.\n * - Subsequent server updates propagate via client.subscribe to re-render consumers.\n * - When context changes (updateContext), flags are re-fetched and the store is refreshed.\n *\n * @param props Component props: children, client options, optional initial flags, and deferInitialization flag.\n * @returns A provider that supplies the flag store context to its children.\n */\nexport function FlagmintProvider<\n  T extends FlagClient<T, C>,\n  C extends Record<string, any> = Record<string, any>\n>({\n  children,\n  options,\n  initialFlags = {},\n  deferInitialization = false\n}: FlagmintProviderProps<T, C>) {\n  // Create a new store instance for each provider (per-request in SSR)\n  const store = useMemo(() => createFlagStore(initialFlags), [])\n  \n  // Use ref to avoid recreating client on every render\n  const clientRef = useRef<FlagClient<T, C> | null>(null)\n  const initPromiseRef = useRef<Promise<FlagClient<T, C>> | null>(null)\n  const unsubscribeRef = useRef<(() => void) | null>(null)\n  \n  // Initialization function similar to Vue plugin\n  const init = async (): Promise<FlagClient<T, C>> => {\n    if (clientRef.current) return clientRef.current // Avoid re-init\n    \n    // Return existing promise if init is already in progress\n    if (initPromiseRef.current) return initPromiseRef.current\n    \n    const { setClient, setReady, setInitialized, setFlags } = store.getState()\n    \n    initPromiseRef.current = (async () => {\n      try {\n        // Create the FlagClient\n        const client = new FlagClient<T, C>(options)\n        \n        // Wait for client to be ready\n        await client.ready()\n        \n        // Get initial flags from client\n        const initialClientFlags = client.getFlags()\n        setFlags(initialClientFlags)\n        \n        // Subscribe to flag changes - THIS IS THE KEY FIX\n        const unsubscribe = client.subscribe((updatedFlags: Flags) => {\n          // Get fresh reference each time\n          const currentStore = store.getState();\n          currentStore.setFlags(updatedFlags);\n        })\n        \n        unsubscribeRef.current = unsubscribe\n        \n        clientRef.current = client\n        setClient(client)\n        setReady(true)\n        setInitialized(true)\n        \n        return client\n      } catch (error) {\n        console.error('Failed to initialize Flagmint client:', error)\n        throw error\n      }\n    })()\n    \n    return initPromiseRef.current\n  }\n\n  useEffect(() => {\n    if (!deferInitialization) {\n      init().catch(error => {\n        console.error('Auto-initialization failed:', error)\n      })\n    }\n\n    return () => {\n      // Unsubscribe from flag changes\n      if (unsubscribeRef.current) {\n        unsubscribeRef.current()\n        unsubscribeRef.current = null\n      }\n      \n      // Destroy client\n      if (clientRef.current) {\n        clientRef.current.destroy?.()\n        clientRef.current = null\n        initPromiseRef.current = null\n      }\n    }\n  }, [deferInitialization])\n\n  return (\n    <FlagmintStoreContext.Provider value={store}>\n      {children}\n    </FlagmintStoreContext.Provider>\n  )\n}\n","'use client';\nimport { FlagValue } from \"flagmint-js-sdk\"\nimport { useContext } from \"react\"\nimport { StoreApi, useStore } from \"zustand\"\nimport { FlagmintStoreContext } from \"@/providers/FlagmintProvider\"\nimport { FlagStore, Flags } from \"@/types\"\n\n// Helper to get the store from context\nexport function useFlagmintStore(): StoreApi<FlagStore> {\n  const store = useContext(FlagmintStoreContext)\n  if (!store) {\n    throw new Error('useFlagmintStore must be used within a FlagmintProvider')\n  }\n  return store\n}\n\n// Hook to get the client instance and update context\nexport function useFlagmint() {\n  const store = useFlagmintStore()\n  const client = useStore(store, (state) => state.client)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n\n  const updateContext = async (context: Record<string, any>) => {\n    if (!client) {\n      throw new Error('Flagmint client not initialized')\n    }\n    await client.updateContext(context)\n  }\n\n  return {\n    client,\n    isInitialized,\n    updateContext\n  }\n}\n\n// Hook to get all flags - only re-renders when flags change\nexport function useFlags(): Flags {\n  const store = useFlagmintStore()\n  if (!store) {\n    return {};\n  }\n  return useStore(store, (state) => state.flags)\n}\n\n// Simplified useFlag - just read from the reactive store\nexport function useFlag<T = FlagValue>(\n  key: string,\n  fallback?: T\n): T {\n  const store = useFlagmintStore()\n  if (!store) {\n    return fallback as T;\n  }\n  // Subscribe to this specific flag in the store\n  const flagValue = useStore(store, (state) => state.flags[key])\n  \n  // Return the flag value or fallback\n  return (flagValue ?? fallback) as T\n}\n\n// Hook to check if the client is ready\nexport function useFlagmintReady(): boolean {\n  const store = useFlagmintStore()\n  if (!store) {\n    return false;\n  }\n  // Subscribe to both isReady and isInitialized\n  const isReady = useStore(store, (state) => state.isReady)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n  \n  return isReady && isInitialized\n}"]}
+{"version":3,"sources":["../src/store/store.ts","../src/providers/FlagmintProvider.tsx","../src/hooks/index.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["'use client';\nimport { createStore, StoreApi } from \"zustand/vanilla\";\nimport { Flags, FlagStore } from \"@/types\";\n\n\nexport function createFlagStore(initialFlags: Flags = {}): StoreApi<FlagStore> {\n   return createStore<FlagStore>((set, get) => ({\n    flags: initialFlags,\n    client: null,\n    isInitialized: false,\n    isReady: false,\n    setFlags: (flags) => {\n      set({ flags: { ...flags } })\n    },\n    setFlag: (key, value) => set((state) => ({\n      flags: { ...state.flags, [key]: value }\n    })),\n    setClient: (client) => set({ client }),\n    setInitialized: (initialized) => set({ isInitialized: initialized }),\n    setReady: (ready) => set({ isReady: ready })\n  }))\n}\n","'use client';\nimport { FlagClient } from \"flagmint-js-sdk\"\nimport { useMemo, useRef, useEffect, createContext } from \"react\"\nimport { createFlagStore } from \"@/store/store\"\nimport { FlagmintProviderProps, Flags, FlagStore } from \"@/types\"\nimport { StoreApi } from \"zustand\"\n\nexport const FlagmintStoreContext = createContext<StoreApi<FlagStore> | null>(null)\n\n/**\n * Provides the Flagmint flag store to React components and keeps it synced with FlagClient updates.\n * Lifecycle overview:\n * - App loads → FlagClient constructed → initialize() begins.\n * - Cached flags applied → subscribers notified → React renders cached values.\n * - Transport set up → initial fetch → store updated → subscribers notified.\n * - Subsequent server updates propagate via client.subscribe to re-render consumers.\n * - When context changes (updateContext), flags are re-fetched and the store is refreshed.\n *\n * @param props Component props: children, client options, optional initial flags, and deferInitialization flag.\n * @returns A provider that supplies the flag store context to its children.\n */\nexport function FlagmintProvider<\n  T extends FlagClient<T, C>,\n  C extends Record<string, any> = Record<string, any>\n>({\n  children,\n  options,\n  initialFlags = {},\n  deferInitialization = false\n}: FlagmintProviderProps<T, C>) {\n  // Create a new store instance for each provider (per-request in SSR)\n  const store = useMemo(() => createFlagStore(initialFlags), [])\n  \n  // Use ref to avoid recreating client on every render\n  const clientRef = useRef<FlagClient<T, C> | null>(null)\n  const initPromiseRef = useRef<Promise<FlagClient<T, C>> | null>(null)\n  const unsubscribeRef = useRef<(() => void) | null>(null)\n  \n  // Initialization function similar to Vue plugin\n  const init = async (): Promise<FlagClient<T, C>> => {\n    if (clientRef.current) return clientRef.current // Avoid re-init\n    \n    // Return existing promise if init is already in progress\n    if (initPromiseRef.current) return initPromiseRef.current\n    \n    const { setClient, setReady, setInitialized, setFlags } = store.getState()\n    \n    initPromiseRef.current = (async () => {\n      try {\n        // Create the FlagClient\n        const client = new FlagClient<T, C>(options)\n        \n        // Wait for client to be ready\n        await client.ready()\n        \n        // Get initial flags from client\n        const initialClientFlags = client.getFlags()\n        setFlags(initialClientFlags)\n        \n        // Subscribe to flag changes - THIS IS THE KEY FIX\n        const unsubscribe = client.subscribe((updatedFlags: Flags) => {\n          // Get fresh reference each time\n          const currentStore = store.getState();\n          currentStore.setFlags(updatedFlags);\n        })\n        \n        unsubscribeRef.current = unsubscribe\n        \n        clientRef.current = client\n        setClient(client)\n        setReady(true)\n        setInitialized(true)\n        \n        return client\n      } catch (error) {\n        console.error('Failed to initialize Flagmint client:', error)\n        throw error\n      }\n    })()\n    \n    return initPromiseRef.current\n  }\n\n  useEffect(() => {\n    if (!deferInitialization) {\n      init().catch(error => {\n        console.error('Auto-initialization failed:', error)\n      })\n    }\n\n    return () => {\n      // Unsubscribe from flag changes\n      if (unsubscribeRef.current) {\n        unsubscribeRef.current()\n        unsubscribeRef.current = null\n      }\n      \n      // Destroy client\n      if (clientRef.current) {\n        clientRef.current.destroy?.()\n        clientRef.current = null\n        initPromiseRef.current = null\n      }\n    }\n  }, [deferInitialization])\n\n  return (\n    <FlagmintStoreContext.Provider value={store}>\n      {children}\n    </FlagmintStoreContext.Provider>\n  )\n}\n","'use client';\nimport { FlagValue } from \"flagmint-js-sdk\"\nimport { useContext } from \"react\"\nimport { StoreApi, useStore } from \"zustand\"\nimport { FlagmintStoreContext } from \"@/providers/FlagmintProvider\"\nimport { FlagStore, Flags } from \"@/types\"\n\n/**\n * Low-level hook that returns the raw Zustand store instance from context.\n *\n * **Use this when building custom hooks on top of the SDK**, not for general\n * flag consumption. Unlike the consumer hooks, this will throw if called\n * outside a FlagmintProvider - making it useful for catching misuse early\n * during development.\n *\n * @throws {Error} If called outside of a FlagmintProvider\n *\n * @example\n * // Building a custom hook that combines multiple flags\n * function useCanAccessBetaFeatures() {\n *   const store = useFlagmintStore();\n *   return useStore(store, (state) =>\n *     state.flags['beta_access'] && state.flags['new_ui']\n *   );\n * }\n */\nexport function useFlagmintStore(): StoreApi<FlagStore> {\n  const store = useContext(FlagmintStoreContext)\n  if (!store) {\n    throw new Error('useFlagmintStore must be used within a FlagmintProvider')\n  }\n  return store\n}\n\n/**\n * Hook that provides access to the underlying FlagClient instance and\n * the ability to update the evaluation context.\n *\n * **Use this when you need to update the context** after the initial render,\n * for example when a user logs in, changes their plan, or switches organization.\n * Re-renders are triggered when `isInitialized` changes.\n *\n * @throws {Error} If called outside of a FlagmintProvider\n * @throws {Error} If `updateContext` is called before the client is initialized\n *\n * @example\n * // Update context when user logs in\n * function Dashboard() {\n *   const { updateContext, isInitialized } = useFlagmint();\n *   const user = useCurrentUser();\n *\n *   useEffect(() => {\n *     if (user) {\n *       updateContext({ userId: user.id, plan: user.plan });\n *     }\n *   }, [user]);\n *\n *   if (!isInitialized) return <Spinner />;\n *   return <DashboardContent />;\n * }\n */\nexport function useFlagmint() {\n  const store = useFlagmintStore()\n  const client = useStore(store, (state) => state.client)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n\n  const updateContext = async (context: Record<string, any>) => {\n    if (!client) {\n      throw new Error('Flagmint client not initialized')\n    }\n    await client.updateContext(context)\n  }\n\n  return {\n    client,\n    isInitialized,\n    updateContext\n  }\n}\n\n/**\n * Hook that returns all feature flags as a reactive object.\n *\n * **Use this when you need to access multiple flags at once**, for example\n * to pass them to a child component or when rendering a list of features.\n * The component re-renders whenever any flag value changes.\n *\n * For single flag access prefer `useFlag` which only re-renders when that\n * specific flag changes.\n *\n * Returns an empty object `{}` if called outside a FlagmintProvider,\n * making it safe to use on public routes or before the user is authenticated.\n *\n * @returns All evaluated feature flags as a key-value object\n *\n * @example\n * // Passing multiple flags to a child\n * function FeatureList() {\n *   const flags = useFlags();\n *\n *   return (\n *     <ul>\n *       {Object.entries(flags).map(([key, value]) => (\n *         <li key={key}>{key}: {String(value)}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n */\nexport function useFlags(): Flags {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return {};\n  }\n  return useStore(store, (state) => state.flags);\n}\n\n/**\n * Hook that returns the current value of a single feature flag.\n *\n * **This is the primary hook for feature flag consumption.** Use this in\n * any component that needs to conditionally render or behave based on a\n * flag value. The component only re-renders when this specific flag changes,\n * not when other flags update.\n *\n * Returns `fallback` silently if called outside a FlagmintProvider, making\n * it safe to use on public routes or before the user is authenticated.\n *\n * @param key - The feature flag key to evaluate\n * @param fallback - Value to return if the flag is not found or the provider is not ready\n * @returns The flag value cast to type T, or the fallback value\n *\n * @example\n * // Boolean flag - show/hide a feature\n * function RightRail() {\n *   const showDocumentation = useFlag<boolean>('show_documentation_feature', false);\n *\n *   return (\n *     <div>\n *       {showDocumentation && <DocumentationCard />}\n *     </div>\n *   );\n * }\n *\n * @example\n * // String flag - switch between variants\n * function Header() {\n *   const colorScheme = useFlag<string>('color_scheme', 'light');\n *   return <header className={colorScheme}>...</header>;\n * }\n *\n * @example\n * // Number flag - configure a limit\n * function ResultsList() {\n *   const resultsPerPage = useFlag<number>('results_per_page', 10);\n *   return <List limit={resultsPerPage} />;\n * }\n */\nexport function useFlag<T = FlagValue>(\n  key: string,\n  fallback?: T\n): T {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return fallback as T;\n  }\n  const flagValue = useStore(store, (state) => state.flags[key]);\n  return (flagValue ?? fallback) as T;\n}\n\n/**\n * Hook that returns whether the Flagmint client has finished initializing\n * and is ready to serve flag values.\n *\n * **Use this to gate rendering** of components that depend on flags having\n * their real server values, preventing a flash of incorrect content on\n * first load. Both `isReady` and `isInitialized` must be true before\n * this returns `true`.\n *\n * Returns `false` silently if called outside a FlagmintProvider, making\n * it safe to use on public routes.\n *\n * @returns `true` when the client is initialized and flags are loaded\n *\n * @example\n * // Gate rendering until flags are ready\n * function App() {\n *   const isReady = useFlagmintReady();\n *   if (!isReady) return <Spinner />;\n *   return <Dashboard />;\n * }\n *\n * @example\n * // Avoid flash of wrong content on first load\n * function PricingPage() {\n *   const isReady = useFlagmintReady();\n *   const showNewPricing = useFlag<boolean>('new_pricing_page', false);\n *\n *   if (!isReady) return <Skeleton />;\n *   return showNewPricing ? <NewPricing /> : <OldPricing />;\n * }\n */\nexport function useFlagmintReady(): boolean {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return false;\n  }\n  const isReady = useStore(store, (state) => state.isReady);\n  const isInitialized = useStore(store, (state) => state.isInitialized);\n  return isReady && isInitialized;\n}"]}

package/dist/index.cjs

@@ -107,14 +107,14 @@ function useFlagmint() {
   };
 }
 function useFlags() {
-  const store = useFlagmintStore();
+  const store = react.useContext(FlagmintStoreContext);
   if (!store) {
     return {};
   }
   return zustand.useStore(store, (state) => state.flags);
 }
 function useFlag(key, fallback) {
-  const store = useFlagmintStore();
+  const store = react.useContext(FlagmintStoreContext);
   if (!store) {
     return fallback;
   }
@@ -122,7 +122,7 @@ function useFlag(key, fallback) {
   return flagValue != null ? flagValue : fallback;
 }
 function useFlagmintReady() {
-  const store = useFlagmintStore();
+  const store = react.useContext(FlagmintStoreContext);
   if (!store) {
     return false;
   }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/store/store.ts","../src/providers/FlagmintProvider.tsx","../src/hooks/index.ts"],"names":["createStore","createContext","useMemo","useRef","FlagClient","useEffect","useContext","useStore"],"mappings":"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","file":"index.cjs","sourcesContent":["'use client';\nimport { createStore, StoreApi } from \"zustand/vanilla\";\nimport { Flags, FlagStore } from \"@/types\";\n\n\nexport function createFlagStore(initialFlags: Flags = {}): StoreApi<FlagStore> {\n   return createStore<FlagStore>((set, get) => ({\n    flags: initialFlags,\n    client: null,\n    isInitialized: false,\n    isReady: false,\n    setFlags: (flags) => {\n      set({ flags: { ...flags } })\n    },\n    setFlag: (key, value) => set((state) => ({\n      flags: { ...state.flags, [key]: value }\n    })),\n    setClient: (client) => set({ client }),\n    setInitialized: (initialized) => set({ isInitialized: initialized }),\n    setReady: (ready) => set({ isReady: ready })\n  }))\n}\n","'use client';\nimport { FlagClient } from \"flagmint-js-sdk\"\nimport { useMemo, useRef, useEffect, createContext } from \"react\"\nimport { createFlagStore } from \"@/store/store\"\nimport { FlagmintProviderProps, Flags, FlagStore } from \"@/types\"\nimport { StoreApi } from \"zustand\"\n\nexport const FlagmintStoreContext = createContext<StoreApi<FlagStore> | null>(null)\n\n/**\n * Provides the Flagmint flag store to React components and keeps it synced with FlagClient updates.\n * Lifecycle overview:\n * - App loads → FlagClient constructed → initialize() begins.\n * - Cached flags applied → subscribers notified → React renders cached values.\n * - Transport set up → initial fetch → store updated → subscribers notified.\n * - Subsequent server updates propagate via client.subscribe to re-render consumers.\n * - When context changes (updateContext), flags are re-fetched and the store is refreshed.\n *\n * @param props Component props: children, client options, optional initial flags, and deferInitialization flag.\n * @returns A provider that supplies the flag store context to its children.\n */\nexport function FlagmintProvider<\n  T extends FlagClient<T, C>,\n  C extends Record<string, any> = Record<string, any>\n>({\n  children,\n  options,\n  initialFlags = {},\n  deferInitialization = false\n}: FlagmintProviderProps<T, C>) {\n  // Create a new store instance for each provider (per-request in SSR)\n  const store = useMemo(() => createFlagStore(initialFlags), [])\n  \n  // Use ref to avoid recreating client on every render\n  const clientRef = useRef<FlagClient<T, C> | null>(null)\n  const initPromiseRef = useRef<Promise<FlagClient<T, C>> | null>(null)\n  const unsubscribeRef = useRef<(() => void) | null>(null)\n  \n  // Initialization function similar to Vue plugin\n  const init = async (): Promise<FlagClient<T, C>> => {\n    if (clientRef.current) return clientRef.current // Avoid re-init\n    \n    // Return existing promise if init is already in progress\n    if (initPromiseRef.current) return initPromiseRef.current\n    \n    const { setClient, setReady, setInitialized, setFlags } = store.getState()\n    \n    initPromiseRef.current = (async () => {\n      try {\n        // Create the FlagClient\n        const client = new FlagClient<T, C>(options)\n        \n        // Wait for client to be ready\n        await client.ready()\n        \n        // Get initial flags from client\n        const initialClientFlags = client.getFlags()\n        setFlags(initialClientFlags)\n        \n        // Subscribe to flag changes - THIS IS THE KEY FIX\n        const unsubscribe = client.subscribe((updatedFlags: Flags) => {\n          // Get fresh reference each time\n          const currentStore = store.getState();\n          currentStore.setFlags(updatedFlags);\n        })\n        \n        unsubscribeRef.current = unsubscribe\n        \n        clientRef.current = client\n        setClient(client)\n        setReady(true)\n        setInitialized(true)\n        \n        return client\n      } catch (error) {\n        console.error('Failed to initialize Flagmint client:', error)\n        throw error\n      }\n    })()\n    \n    return initPromiseRef.current\n  }\n\n  useEffect(() => {\n    if (!deferInitialization) {\n      init().catch(error => {\n        console.error('Auto-initialization failed:', error)\n      })\n    }\n\n    return () => {\n      // Unsubscribe from flag changes\n      if (unsubscribeRef.current) {\n        unsubscribeRef.current()\n        unsubscribeRef.current = null\n      }\n      \n      // Destroy client\n      if (clientRef.current) {\n        clientRef.current.destroy?.()\n        clientRef.current = null\n        initPromiseRef.current = null\n      }\n    }\n  }, [deferInitialization])\n\n  return (\n    <FlagmintStoreContext.Provider value={store}>\n      {children}\n    </FlagmintStoreContext.Provider>\n  )\n}\n","'use client';\nimport { FlagValue } from \"flagmint-js-sdk\"\nimport { useContext } from \"react\"\nimport { StoreApi, useStore } from \"zustand\"\nimport { FlagmintStoreContext } from \"@/providers/FlagmintProvider\"\nimport { FlagStore, Flags } from \"@/types\"\n\n// Helper to get the store from context\nexport function useFlagmintStore(): StoreApi<FlagStore> {\n  const store = useContext(FlagmintStoreContext)\n  if (!store) {\n    throw new Error('useFlagmintStore must be used within a FlagmintProvider')\n  }\n  return store\n}\n\n// Hook to get the client instance and update context\nexport function useFlagmint() {\n  const store = useFlagmintStore()\n  const client = useStore(store, (state) => state.client)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n\n  const updateContext = async (context: Record<string, any>) => {\n    if (!client) {\n      throw new Error('Flagmint client not initialized')\n    }\n    await client.updateContext(context)\n  }\n\n  return {\n    client,\n    isInitialized,\n    updateContext\n  }\n}\n\n// Hook to get all flags - only re-renders when flags change\nexport function useFlags(): Flags {\n  const store = useFlagmintStore()\n  if (!store) {\n    return {};\n  }\n  return useStore(store, (state) => state.flags)\n}\n\n// Simplified useFlag - just read from the reactive store\nexport function useFlag<T = FlagValue>(\n  key: string,\n  fallback?: T\n): T {\n  const store = useFlagmintStore()\n  if (!store) {\n    return fallback as T;\n  }\n  // Subscribe to this specific flag in the store\n  const flagValue = useStore(store, (state) => state.flags[key])\n  \n  // Return the flag value or fallback\n  return (flagValue ?? fallback) as T\n}\n\n// Hook to check if the client is ready\nexport function useFlagmintReady(): boolean {\n  const store = useFlagmintStore()\n  if (!store) {\n    return false;\n  }\n  // Subscribe to both isReady and isInitialized\n  const isReady = useStore(store, (state) => state.isReady)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n  \n  return isReady && isInitialized\n}"]}
+{"version":3,"sources":["../src/store/store.ts","../src/providers/FlagmintProvider.tsx","../src/hooks/index.ts"],"names":["createStore","createContext","useMemo","useRef","FlagClient","useEffect","useContext","useStore"],"mappings":"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","file":"index.cjs","sourcesContent":["'use client';\nimport { createStore, StoreApi } from \"zustand/vanilla\";\nimport { Flags, FlagStore } from \"@/types\";\n\n\nexport function createFlagStore(initialFlags: Flags = {}): StoreApi<FlagStore> {\n   return createStore<FlagStore>((set, get) => ({\n    flags: initialFlags,\n    client: null,\n    isInitialized: false,\n    isReady: false,\n    setFlags: (flags) => {\n      set({ flags: { ...flags } })\n    },\n    setFlag: (key, value) => set((state) => ({\n      flags: { ...state.flags, [key]: value }\n    })),\n    setClient: (client) => set({ client }),\n    setInitialized: (initialized) => set({ isInitialized: initialized }),\n    setReady: (ready) => set({ isReady: ready })\n  }))\n}\n","'use client';\nimport { FlagClient } from \"flagmint-js-sdk\"\nimport { useMemo, useRef, useEffect, createContext } from \"react\"\nimport { createFlagStore } from \"@/store/store\"\nimport { FlagmintProviderProps, Flags, FlagStore } from \"@/types\"\nimport { StoreApi } from \"zustand\"\n\nexport const FlagmintStoreContext = createContext<StoreApi<FlagStore> | null>(null)\n\n/**\n * Provides the Flagmint flag store to React components and keeps it synced with FlagClient updates.\n * Lifecycle overview:\n * - App loads → FlagClient constructed → initialize() begins.\n * - Cached flags applied → subscribers notified → React renders cached values.\n * - Transport set up → initial fetch → store updated → subscribers notified.\n * - Subsequent server updates propagate via client.subscribe to re-render consumers.\n * - When context changes (updateContext), flags are re-fetched and the store is refreshed.\n *\n * @param props Component props: children, client options, optional initial flags, and deferInitialization flag.\n * @returns A provider that supplies the flag store context to its children.\n */\nexport function FlagmintProvider<\n  T extends FlagClient<T, C>,\n  C extends Record<string, any> = Record<string, any>\n>({\n  children,\n  options,\n  initialFlags = {},\n  deferInitialization = false\n}: FlagmintProviderProps<T, C>) {\n  // Create a new store instance for each provider (per-request in SSR)\n  const store = useMemo(() => createFlagStore(initialFlags), [])\n  \n  // Use ref to avoid recreating client on every render\n  const clientRef = useRef<FlagClient<T, C> | null>(null)\n  const initPromiseRef = useRef<Promise<FlagClient<T, C>> | null>(null)\n  const unsubscribeRef = useRef<(() => void) | null>(null)\n  \n  // Initialization function similar to Vue plugin\n  const init = async (): Promise<FlagClient<T, C>> => {\n    if (clientRef.current) return clientRef.current // Avoid re-init\n    \n    // Return existing promise if init is already in progress\n    if (initPromiseRef.current) return initPromiseRef.current\n    \n    const { setClient, setReady, setInitialized, setFlags } = store.getState()\n    \n    initPromiseRef.current = (async () => {\n      try {\n        // Create the FlagClient\n        const client = new FlagClient<T, C>(options)\n        \n        // Wait for client to be ready\n        await client.ready()\n        \n        // Get initial flags from client\n        const initialClientFlags = client.getFlags()\n        setFlags(initialClientFlags)\n        \n        // Subscribe to flag changes - THIS IS THE KEY FIX\n        const unsubscribe = client.subscribe((updatedFlags: Flags) => {\n          // Get fresh reference each time\n          const currentStore = store.getState();\n          currentStore.setFlags(updatedFlags);\n        })\n        \n        unsubscribeRef.current = unsubscribe\n        \n        clientRef.current = client\n        setClient(client)\n        setReady(true)\n        setInitialized(true)\n        \n        return client\n      } catch (error) {\n        console.error('Failed to initialize Flagmint client:', error)\n        throw error\n      }\n    })()\n    \n    return initPromiseRef.current\n  }\n\n  useEffect(() => {\n    if (!deferInitialization) {\n      init().catch(error => {\n        console.error('Auto-initialization failed:', error)\n      })\n    }\n\n    return () => {\n      // Unsubscribe from flag changes\n      if (unsubscribeRef.current) {\n        unsubscribeRef.current()\n        unsubscribeRef.current = null\n      }\n      \n      // Destroy client\n      if (clientRef.current) {\n        clientRef.current.destroy?.()\n        clientRef.current = null\n        initPromiseRef.current = null\n      }\n    }\n  }, [deferInitialization])\n\n  return (\n    <FlagmintStoreContext.Provider value={store}>\n      {children}\n    </FlagmintStoreContext.Provider>\n  )\n}\n","'use client';\nimport { FlagValue } from \"flagmint-js-sdk\"\nimport { useContext } from \"react\"\nimport { StoreApi, useStore } from \"zustand\"\nimport { FlagmintStoreContext } from \"@/providers/FlagmintProvider\"\nimport { FlagStore, Flags } from \"@/types\"\n\n/**\n * Low-level hook that returns the raw Zustand store instance from context.\n *\n * **Use this when building custom hooks on top of the SDK**, not for general\n * flag consumption. Unlike the consumer hooks, this will throw if called\n * outside a FlagmintProvider - making it useful for catching misuse early\n * during development.\n *\n * @throws {Error} If called outside of a FlagmintProvider\n *\n * @example\n * // Building a custom hook that combines multiple flags\n * function useCanAccessBetaFeatures() {\n *   const store = useFlagmintStore();\n *   return useStore(store, (state) =>\n *     state.flags['beta_access'] && state.flags['new_ui']\n *   );\n * }\n */\nexport function useFlagmintStore(): StoreApi<FlagStore> {\n  const store = useContext(FlagmintStoreContext)\n  if (!store) {\n    throw new Error('useFlagmintStore must be used within a FlagmintProvider')\n  }\n  return store\n}\n\n/**\n * Hook that provides access to the underlying FlagClient instance and\n * the ability to update the evaluation context.\n *\n * **Use this when you need to update the context** after the initial render,\n * for example when a user logs in, changes their plan, or switches organization.\n * Re-renders are triggered when `isInitialized` changes.\n *\n * @throws {Error} If called outside of a FlagmintProvider\n * @throws {Error} If `updateContext` is called before the client is initialized\n *\n * @example\n * // Update context when user logs in\n * function Dashboard() {\n *   const { updateContext, isInitialized } = useFlagmint();\n *   const user = useCurrentUser();\n *\n *   useEffect(() => {\n *     if (user) {\n *       updateContext({ userId: user.id, plan: user.plan });\n *     }\n *   }, [user]);\n *\n *   if (!isInitialized) return <Spinner />;\n *   return <DashboardContent />;\n * }\n */\nexport function useFlagmint() {\n  const store = useFlagmintStore()\n  const client = useStore(store, (state) => state.client)\n  const isInitialized = useStore(store, (state) => state.isInitialized)\n\n  const updateContext = async (context: Record<string, any>) => {\n    if (!client) {\n      throw new Error('Flagmint client not initialized')\n    }\n    await client.updateContext(context)\n  }\n\n  return {\n    client,\n    isInitialized,\n    updateContext\n  }\n}\n\n/**\n * Hook that returns all feature flags as a reactive object.\n *\n * **Use this when you need to access multiple flags at once**, for example\n * to pass them to a child component or when rendering a list of features.\n * The component re-renders whenever any flag value changes.\n *\n * For single flag access prefer `useFlag` which only re-renders when that\n * specific flag changes.\n *\n * Returns an empty object `{}` if called outside a FlagmintProvider,\n * making it safe to use on public routes or before the user is authenticated.\n *\n * @returns All evaluated feature flags as a key-value object\n *\n * @example\n * // Passing multiple flags to a child\n * function FeatureList() {\n *   const flags = useFlags();\n *\n *   return (\n *     <ul>\n *       {Object.entries(flags).map(([key, value]) => (\n *         <li key={key}>{key}: {String(value)}</li>\n *       ))}\n *     </ul>\n *   );\n * }\n */\nexport function useFlags(): Flags {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return {};\n  }\n  return useStore(store, (state) => state.flags);\n}\n\n/**\n * Hook that returns the current value of a single feature flag.\n *\n * **This is the primary hook for feature flag consumption.** Use this in\n * any component that needs to conditionally render or behave based on a\n * flag value. The component only re-renders when this specific flag changes,\n * not when other flags update.\n *\n * Returns `fallback` silently if called outside a FlagmintProvider, making\n * it safe to use on public routes or before the user is authenticated.\n *\n * @param key - The feature flag key to evaluate\n * @param fallback - Value to return if the flag is not found or the provider is not ready\n * @returns The flag value cast to type T, or the fallback value\n *\n * @example\n * // Boolean flag - show/hide a feature\n * function RightRail() {\n *   const showDocumentation = useFlag<boolean>('show_documentation_feature', false);\n *\n *   return (\n *     <div>\n *       {showDocumentation && <DocumentationCard />}\n *     </div>\n *   );\n * }\n *\n * @example\n * // String flag - switch between variants\n * function Header() {\n *   const colorScheme = useFlag<string>('color_scheme', 'light');\n *   return <header className={colorScheme}>...</header>;\n * }\n *\n * @example\n * // Number flag - configure a limit\n * function ResultsList() {\n *   const resultsPerPage = useFlag<number>('results_per_page', 10);\n *   return <List limit={resultsPerPage} />;\n * }\n */\nexport function useFlag<T = FlagValue>(\n  key: string,\n  fallback?: T\n): T {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return fallback as T;\n  }\n  const flagValue = useStore(store, (state) => state.flags[key]);\n  return (flagValue ?? fallback) as T;\n}\n\n/**\n * Hook that returns whether the Flagmint client has finished initializing\n * and is ready to serve flag values.\n *\n * **Use this to gate rendering** of components that depend on flags having\n * their real server values, preventing a flash of incorrect content on\n * first load. Both `isReady` and `isInitialized` must be true before\n * this returns `true`.\n *\n * Returns `false` silently if called outside a FlagmintProvider, making\n * it safe to use on public routes.\n *\n * @returns `true` when the client is initialized and flags are loaded\n *\n * @example\n * // Gate rendering until flags are ready\n * function App() {\n *   const isReady = useFlagmintReady();\n *   if (!isReady) return <Spinner />;\n *   return <Dashboard />;\n * }\n *\n * @example\n * // Avoid flash of wrong content on first load\n * function PricingPage() {\n *   const isReady = useFlagmintReady();\n *   const showNewPricing = useFlag<boolean>('new_pricing_page', false);\n *\n *   if (!isReady) return <Skeleton />;\n *   return showNewPricing ? <NewPricing /> : <OldPricing />;\n * }\n */\nexport function useFlagmintReady(): boolean {\n  const store = useContext(FlagmintStoreContext);\n  if (!store) {\n    return false;\n  }\n  const isReady = useStore(store, (state) => state.isReady);\n  const isInitialized = useStore(store, (state) => state.isInitialized);\n  return isReady && isInitialized;\n}"]}

package/dist/index.js

@@ -105,14 +105,14 @@ function useFlagmint() {
   };
 }
 function useFlags() {
-  const store = useFlagmintStore();
+  const store = useContext(FlagmintStoreContext);
   if (!store) {
     return {};
   }
   return useStore(store, (state) => state.flags);
 }
 function useFlag(key, fallback) {
-  const store = useFlagmintStore();
+  const store = useContext(FlagmintStoreContext);
   if (!store) {
     return fallback;
   }
@@ -120,7 +120,7 @@ function useFlag(key, fallback) {
   return flagValue != null ? flagValue : fallback;
 }
 function useFlagmintReady() {
-  const store = useFlagmintStore();
+  const store = useContext(FlagmintStoreContext);
   if (!store) {
     return false;
   }