wolves-react-client 1.0.5 → 1.0.7

package/dist/WolvesProvider.d.ts

@@ -1,19 +1,26 @@
 import React from 'react';
-import { WolvesProviderProps } from './types';
+import { WolvesClient } from 'wolves-js-client';
+export interface WolvesProviderProps {
+    /** The initialized WolvesClient instance */
+    client: WolvesClient | null;
+    /** Child components that will have access to Wolves context */
+    children: React.ReactNode;
+    /** Component to display while client is null */
+    loadingComponent?: React.ReactNode;
+}
 /**
- * WolvesProvider is the root component for integrating Wolves SDK with React.
- * It initializes the WolvesClient and provides it to child components via React Context.
+ * WolvesProvider provides the Wolves client to child components via React Context.
+ * Use with useClientAsyncInit or useClientSyncInit to initialize the client.
  *
  * @example
  * ```tsx
- * import { WolvesProvider } from 'wolves-react-client';
+ * import { WolvesProvider, useClientAsyncInit } from 'wolves-react-client';
  *
  * function App() {
+ *   const { client } = useClientAsyncInit('your-sdk-key', { userID: 'user-123' });
+ *
  *   return (
- *     <WolvesProvider
- *       sdkKey="your-sdk-key"
- *       user={{ userID: 'user-123' }}
- *     >
+ *     <WolvesProvider client={client} loadingComponent={<div>Loading...</div>}>
  *       <YourApp />
  *     </WolvesProvider>
  *   );

package/dist/WolvesProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WolvesProvider.d.ts","sourceRoot":"","sources":["../src/WolvesProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAGpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAI9C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAuKxD,CAAC"}
+{"version":3,"file":"WolvesProvider.d.ts","sourceRoot":"","sources":["../src/WolvesProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIhD,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA8BxD,CAAC"}

package/dist/WolvesProvider.js

@@ -44,159 +44,41 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WolvesProvider = void 0;
 const react_1 = __importStar(require("react"));
-const wolves_js_client_1 = require("wolves-js-client");
 const WolvesContext_1 = require("./WolvesContext");
 const ssrHelpers_1 = require("./utils/ssrHelpers");
-const metadata_1 = require("./metadata");
 /**
- * WolvesProvider is the root component for integrating Wolves SDK with React.
- * It initializes the WolvesClient and provides it to child components via React Context.
+ * WolvesProvider provides the Wolves client to child components via React Context.
+ * Use with useClientAsyncInit or useClientSyncInit to initialize the client.
  *
  * @example
  * ```tsx
- * import { WolvesProvider } from 'wolves-react-client';
+ * import { WolvesProvider, useClientAsyncInit } from 'wolves-react-client';
  *
  * function App() {
+ *   const { client } = useClientAsyncInit('your-sdk-key', { userID: 'user-123' });
+ *
  *   return (
- *     <WolvesProvider
- *       sdkKey="your-sdk-key"
- *       user={{ userID: 'user-123' }}
- *     >
+ *     <WolvesProvider client={client} loadingComponent={<div>Loading...</div>}>
  *       <YourApp />
  *     </WolvesProvider>
  *   );
  * }
  * ```
  */
-const WolvesProvider = ({ sdkKey, user, children, options = {}, waitForInitialization = false, loadingComponent = null, }) => {
-    const [client, setClient] = (0, react_1.useState)(null);
-    const [isInitialized, setIsInitialized] = (0, react_1.useState)(false);
-    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
-    const [initializationDetails, setInitializationDetails] = (0, react_1.useState)(null);
-    const [error, setError] = (0, react_1.useState)(null);
-    const userRef = (0, react_1.useRef)(user);
-    // Skip initialization on server
-    const shouldInitialize = !(0, ssrHelpers_1.isServer)();
-    // Initialize client on mount
-    (0, react_1.useEffect)(() => {
-        if (!shouldInitialize) {
-            setIsLoading(false);
-            return;
-        }
-        let isMounted = true;
-        const initMode = options.initMode || 'async';
-        const initializeClient = () => __awaiter(void 0, void 0, void 0, function* () {
-            try {
-                // Set React SDK metadata before creating client
-                wolves_js_client_1.WolvesMetadataProvider.add((0, metadata_1.getReactSDKMetadata)());
-                const newClient = new wolves_js_client_1.WolvesClient(sdkKey, user, options.apiEnv || 'prod');
-                if (initMode === 'async') {
-                    // Async initialization
-                    const details = yield newClient.initializeAsync(options.asyncOptions);
-                    if (!isMounted)
-                        return;
-                    setInitializationDetails(details);
-                    setIsInitialized(true);
-                    setIsLoading(false);
-                    setClient(newClient);
-                    if (options.onInitialized) {
-                        options.onInitialized(details);
-                    }
-                }
-                else {
-                    // Sync initialization
-                    const details = newClient.initializeSync(options.syncOptions);
-                    if (!isMounted)
-                        return;
-                    setInitializationDetails(details);
-                    setIsInitialized(true);
-                    setIsLoading(false);
-                    setClient(newClient);
-                    if (options.onInitialized) {
-                        options.onInitialized(details);
-                    }
-                }
-            }
-            catch (err) {
-                if (!isMounted)
-                    return;
-                const error = err instanceof Error ? err : new Error(String(err));
-                setError(error);
-                setIsLoading(false);
-                if (options.onError) {
-                    options.onError(error);
-                }
-            }
-        });
-        initializeClient();
-        // Cleanup on unmount
-        return () => {
-            isMounted = false;
-            if (client) {
-                client.shutdown().catch((e) => {
-                    console.error('Failed to shutdown Wolves client:', e);
-                });
-            }
-        };
-        // Intentionally only depend on sdkKey and shouldInitialize
-        // User and options changes are handled separately
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [sdkKey, shouldInitialize]);
-    // Handle user changes
-    (0, react_1.useEffect)(() => {
-        if (!client || !isInitialized)
-            return;
-        // Check if user actually changed
-        if (JSON.stringify(userRef.current) === JSON.stringify(user)) {
-            return;
-        }
-        userRef.current = user;
-        const updateUser = () => __awaiter(void 0, void 0, void 0, function* () {
-            try {
-                const details = yield client.updateUserAsync(user, options.asyncOptions);
-                setInitializationDetails(details);
-                if (options.onInitialized) {
-                    options.onInitialized(details);
-                }
-            }
-            catch (err) {
-                const error = err instanceof Error ? err : new Error(String(err));
-                setError(error);
-                if (options.onError) {
-                    options.onError(error);
-                }
-            }
-        });
-        updateUser();
-        // Intentionally don't include options in deps as we only want to react to user changes
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [user, client, isInitialized]);
-    // Create updateUser function for manual user updates
-    const updateUser = (newUser) => __awaiter(void 0, void 0, void 0, function* () {
-        if (!client) {
-            throw new Error('Wolves client is not initialized');
-        }
-        userRef.current = newUser;
-        const details = yield client.updateUserAsync(newUser, options.asyncOptions);
-        setInitializationDetails(details);
-        if (options.onInitialized) {
-            options.onInitialized(details);
-        }
-    });
+const WolvesProvider = ({ client, children, loadingComponent = null, }) => {
     // Memoize context value to prevent unnecessary re-renders
     const contextValue = (0, react_1.useMemo)(() => ({
         client,
-        isInitialized,
-        isLoading,
-        initializationDetails,
-        error,
-        updateUser,
-    }), 
-    // updateUser function is stable (defined outside useEffect)
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [client, isInitialized, isLoading, initializationDetails, error]);
-    // Show loading component if waiting for initialization
-    if (waitForInitialization && isLoading && !error) {
+        isInitialized: !!client,
+        isLoading: false,
+        initializationDetails: null,
+        error: null,
+        updateUser: () => __awaiter(void 0, void 0, void 0, function* () {
+            throw new Error('updateUser is not available when using client-based initialization. Use client.updateUserAsync() directly.');
+        }),
+    }), [client]);
+    // Show loading component if client is not ready
+    if (!client && !(0, ssrHelpers_1.isServer)()) {
         return react_1.default.createElement(react_1.default.Fragment, null, loadingComponent);
     }
     return (react_1.default.createElement(WolvesContext_1.WolvesContext.Provider, { value: contextValue }, children));

package/dist/hooks/useClientAsyncInit.d.ts

@@ -0,0 +1,49 @@
+import { WolvesClient, WolvesUser, WolvesUpdateDetails, AsyncUpdateOptions } from 'wolves-js-client';
+export interface UseClientAsyncInitOptions {
+    /** API environment: 'local', 'dev', or 'prod' (default) */
+    apiEnv?: 'local' | 'dev' | 'prod';
+    /** Options for async initialization */
+    asyncOptions?: AsyncUpdateOptions;
+    /** Callback invoked when initialization completes */
+    onInitialized?: (details: WolvesUpdateDetails) => void;
+    /** Callback invoked when an error occurs */
+    onError?: (error: Error) => void;
+}
+export interface UseClientAsyncInitReturn {
+    /** The initialized WolvesClient instance (null until initialized) */
+    client: WolvesClient | null;
+    /** Whether the client is currently initializing */
+    isLoading: boolean;
+    /** Whether initialization has completed successfully */
+    isInitialized: boolean;
+    /** Initialization details from the last update */
+    initializationDetails: WolvesUpdateDetails | null;
+    /** Any error that occurred during initialization */
+    error: Error | null;
+}
+/**
+ * Hook to initialize Wolves client in async mode.
+ * Use this hook before WolvesProvider to control initialization timing.
+ *
+ * @param sdkKey - Your Wolves SDK key
+ * @param user - User identification and attributes
+ * @param options - Optional configuration
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { client } = useClientAsyncInit(
+ *     'your-sdk-key',
+ *     { userID: 'user-123' }
+ *   );
+ *
+ *   return (
+ *     <WolvesProvider client={client} loadingComponent={<div>Loading...</div>}>
+ *       <YourApp />
+ *     </WolvesProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function useClientAsyncInit(sdkKey: string, user: WolvesUser, options?: UseClientAsyncInitOptions): UseClientAsyncInitReturn;
+//# sourceMappingURL=useClientAsyncInit.d.ts.map

package/dist/hooks/useClientAsyncInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClientAsyncInit.d.ts","sourceRoot":"","sources":["../../src/hooks/useClientAsyncInit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAA0B,MAAM,kBAAkB,CAAC;AAI7H,MAAM,WAAW,yBAAyB;IACxC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,uCAAuC;IACvC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,qDAAqD;IACrD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACvD,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,aAAa,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,qBAAqB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CA6E1B"}

package/dist/hooks/useClientAsyncInit.js

@@ -0,0 +1,108 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useClientAsyncInit = useClientAsyncInit;
+const react_1 = require("react");
+const wolves_js_client_1 = require("wolves-js-client");
+const metadata_1 = require("../metadata");
+const ssrHelpers_1 = require("../utils/ssrHelpers");
+/**
+ * Hook to initialize Wolves client in async mode.
+ * Use this hook before WolvesProvider to control initialization timing.
+ *
+ * @param sdkKey - Your Wolves SDK key
+ * @param user - User identification and attributes
+ * @param options - Optional configuration
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { client } = useClientAsyncInit(
+ *     'your-sdk-key',
+ *     { userID: 'user-123' }
+ *   );
+ *
+ *   return (
+ *     <WolvesProvider client={client} loadingComponent={<div>Loading...</div>}>
+ *       <YourApp />
+ *     </WolvesProvider>
+ *   );
+ * }
+ * ```
+ */
+function useClientAsyncInit(sdkKey, user, options = {}) {
+    const [client, setClient] = (0, react_1.useState)(null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    const [isInitialized, setIsInitialized] = (0, react_1.useState)(false);
+    const [initializationDetails, setInitializationDetails] = (0, react_1.useState)(null);
+    const [error, setError] = (0, react_1.useState)(null);
+    const initializingRef = (0, react_1.useRef)(false);
+    const clientRef = (0, react_1.useRef)(null);
+    // Skip initialization on server
+    const shouldInitialize = !(0, ssrHelpers_1.isServer)();
+    (0, react_1.useEffect)(() => {
+        if (!shouldInitialize || initializingRef.current) {
+            if (!shouldInitialize) {
+                setIsLoading(false);
+            }
+            return;
+        }
+        initializingRef.current = true;
+        let isMounted = true;
+        const initializeClient = () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                // Set React SDK metadata
+                wolves_js_client_1.WolvesMetadataProvider.add((0, metadata_1.getReactSDKMetadata)());
+                const newClient = new wolves_js_client_1.WolvesClient(sdkKey, user, options.apiEnv || 'prod');
+                const details = yield newClient.initializeAsync(options.asyncOptions);
+                if (!isMounted)
+                    return;
+                clientRef.current = newClient;
+                setClient(newClient);
+                setInitializationDetails(details);
+                setIsInitialized(true);
+                setIsLoading(false);
+                if (options.onInitialized) {
+                    options.onInitialized(details);
+                }
+            }
+            catch (err) {
+                if (!isMounted)
+                    return;
+                const error = err instanceof Error ? err : new Error(String(err));
+                setError(error);
+                setIsLoading(false);
+                if (options.onError) {
+                    options.onError(error);
+                }
+            }
+        });
+        initializeClient();
+        return () => {
+            isMounted = false;
+            initializingRef.current = false; // Reset so it can re-initialize if needed
+            if (clientRef.current) {
+                clientRef.current.shutdown().catch((e) => {
+                    console.error('Failed to shutdown Wolves client:', e);
+                });
+                clientRef.current = null;
+            }
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [sdkKey, shouldInitialize]);
+    return {
+        client,
+        isLoading,
+        isInitialized,
+        initializationDetails,
+        error,
+    };
+}

package/dist/hooks/useClientSyncInit.d.ts

@@ -0,0 +1,51 @@
+import { WolvesClient, WolvesUser, WolvesUpdateDetails, SyncUpdateOptions } from 'wolves-js-client';
+export interface UseClientSyncInitOptions {
+    /** API environment: 'local', 'dev', or 'prod' (default) */
+    apiEnv?: 'local' | 'dev' | 'prod';
+    /** Options for sync initialization */
+    syncOptions?: SyncUpdateOptions;
+    /** Callback invoked when initialization completes */
+    onInitialized?: (details: WolvesUpdateDetails) => void;
+    /** Callback invoked when an error occurs */
+    onError?: (error: Error) => void;
+}
+export interface UseClientSyncInitReturn {
+    /** The initialized WolvesClient instance (null until initialized) */
+    client: WolvesClient | null;
+    /** Whether the client is currently initializing */
+    isLoading: boolean;
+    /** Whether initialization has completed successfully */
+    isInitialized: boolean;
+    /** Initialization details from the last update */
+    initializationDetails: WolvesUpdateDetails | null;
+    /** Any error that occurred during initialization */
+    error: Error | null;
+}
+/**
+ * Hook to initialize Wolves client in sync mode.
+ * Use this hook before WolvesProvider to control initialization timing.
+ *
+ * Sync mode loads from cache immediately and fetches updates in the background.
+ *
+ * @param sdkKey - Your Wolves SDK key
+ * @param user - User identification and attributes
+ * @param options - Optional configuration
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { client } = useClientSyncInit(
+ *     'your-sdk-key',
+ *     { userID: 'user-123' }
+ *   );
+ *
+ *   return (
+ *     <WolvesProvider client={client}>
+ *       <YourApp />
+ *     </WolvesProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function useClientSyncInit(sdkKey: string, user: WolvesUser, options?: UseClientSyncInitOptions): UseClientSyncInitReturn;
+//# sourceMappingURL=useClientSyncInit.d.ts.map

package/dist/hooks/useClientSyncInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClientSyncInit.d.ts","sourceRoot":"","sources":["../../src/hooks/useClientSyncInit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,EAA0B,MAAM,kBAAkB,CAAC;AAI5H,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,sCAAsC;IACtC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,qDAAqD;IACrD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACvD,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,aAAa,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,qBAAqB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,oDAAoD;IACpD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CA6EzB"}

package/dist/hooks/useClientSyncInit.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useClientSyncInit = useClientSyncInit;
+const react_1 = require("react");
+const wolves_js_client_1 = require("wolves-js-client");
+const metadata_1 = require("../metadata");
+const ssrHelpers_1 = require("../utils/ssrHelpers");
+/**
+ * Hook to initialize Wolves client in sync mode.
+ * Use this hook before WolvesProvider to control initialization timing.
+ *
+ * Sync mode loads from cache immediately and fetches updates in the background.
+ *
+ * @param sdkKey - Your Wolves SDK key
+ * @param user - User identification and attributes
+ * @param options - Optional configuration
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { client } = useClientSyncInit(
+ *     'your-sdk-key',
+ *     { userID: 'user-123' }
+ *   );
+ *
+ *   return (
+ *     <WolvesProvider client={client}>
+ *       <YourApp />
+ *     </WolvesProvider>
+ *   );
+ * }
+ * ```
+ */
+function useClientSyncInit(sdkKey, user, options = {}) {
+    const [client, setClient] = (0, react_1.useState)(null);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    const [isInitialized, setIsInitialized] = (0, react_1.useState)(false);
+    const [initializationDetails, setInitializationDetails] = (0, react_1.useState)(null);
+    const [error, setError] = (0, react_1.useState)(null);
+    const initializingRef = (0, react_1.useRef)(false);
+    const clientRef = (0, react_1.useRef)(null);
+    // Skip initialization on server
+    const shouldInitialize = !(0, ssrHelpers_1.isServer)();
+    (0, react_1.useEffect)(() => {
+        if (!shouldInitialize || initializingRef.current) {
+            if (!shouldInitialize) {
+                setIsLoading(false);
+            }
+            return;
+        }
+        initializingRef.current = true;
+        let isMounted = true;
+        const initializeClient = () => {
+            try {
+                // Set React SDK metadata
+                wolves_js_client_1.WolvesMetadataProvider.add((0, metadata_1.getReactSDKMetadata)());
+                const newClient = new wolves_js_client_1.WolvesClient(sdkKey, user, options.apiEnv || 'prod');
+                const details = newClient.initializeSync(options.syncOptions);
+                if (!isMounted)
+                    return;
+                clientRef.current = newClient;
+                setClient(newClient);
+                setInitializationDetails(details);
+                setIsInitialized(true);
+                setIsLoading(false);
+                if (options.onInitialized) {
+                    options.onInitialized(details);
+                }
+            }
+            catch (err) {
+                if (!isMounted)
+                    return;
+                const error = err instanceof Error ? err : new Error(String(err));
+                setError(error);
+                setIsLoading(false);
+                if (options.onError) {
+                    options.onError(error);
+                }
+            }
+        };
+        initializeClient();
+        return () => {
+            isMounted = false;
+            initializingRef.current = false; // Reset so it can re-initialize if needed
+            if (clientRef.current) {
+                clientRef.current.shutdown().catch((e) => {
+                    console.error('Failed to shutdown Wolves client:', e);
+                });
+                clientRef.current = null;
+            }
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [sdkKey, shouldInitialize]);
+    return {
+        client,
+        isLoading,
+        isInitialized,
+        initializationDetails,
+        error,
+    };
+}

package/dist/index.d.ts

@@ -2,14 +2,13 @@
  * Main entry point for the Wolves React SDK
  */
 export { WolvesProvider } from './WolvesProvider';
+export type { WolvesProviderProps } from './WolvesProvider';
 export { WolvesContext } from './WolvesContext';
 export type { WolvesContextValue } from './WolvesContext';
 export { useWolvesClient } from './hooks/useWolvesClient';
-export { useExperiment } from './hooks/useExperiment';
-export { useWolvesEvent } from './hooks/useWolvesEvent';
-export { useWolvesInitialization } from './hooks/useWolvesInitialization';
-export type { UseWolvesInitializationReturn } from './hooks/useWolvesInitialization';
+export { useClientAsyncInit } from './hooks/useClientAsyncInit';
+export { useClientSyncInit } from './hooks/useClientSyncInit';
 export type { WolvesUser, WolvesUpdateDetails, LoadingStatus, AsyncUpdateOptions, SyncUpdateOptions, } from 'wolves-js-client';
-export type { WolvesProviderProps, WolvesProviderOptions, UseExperimentOptions, UseExperimentReturn, UseWolvesEventReturn, InitMode, } from './types';
+export type { UseClientAsyncInitOptions, UseClientAsyncInitReturn, UseClientSyncInitOptions, UseClientSyncInitReturn, } from './types';
 export { isBrowser, isServer } from './utils/ssrHelpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,YAAY,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAGrF,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,GACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -3,7 +3,7 @@
  * Main entry point for the Wolves React SDK
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isServer = exports.isBrowser = exports.useWolvesInitialization = exports.useWolvesEvent = exports.useExperiment = exports.useWolvesClient = exports.WolvesContext = exports.WolvesProvider = void 0;
+exports.isServer = exports.isBrowser = exports.useClientSyncInit = exports.useClientAsyncInit = exports.useWolvesClient = exports.WolvesContext = exports.WolvesProvider = void 0;
 // Provider component
 var WolvesProvider_1 = require("./WolvesProvider");
 Object.defineProperty(exports, "WolvesProvider", { enumerable: true, get: function () { return WolvesProvider_1.WolvesProvider; } });
@@ -13,12 +13,10 @@ Object.defineProperty(exports, "WolvesContext", { enumerable: true, get: functio
 // Hooks
 var useWolvesClient_1 = require("./hooks/useWolvesClient");
 Object.defineProperty(exports, "useWolvesClient", { enumerable: true, get: function () { return useWolvesClient_1.useWolvesClient; } });
-var useExperiment_1 = require("./hooks/useExperiment");
-Object.defineProperty(exports, "useExperiment", { enumerable: true, get: function () { return useExperiment_1.useExperiment; } });
-var useWolvesEvent_1 = require("./hooks/useWolvesEvent");
-Object.defineProperty(exports, "useWolvesEvent", { enumerable: true, get: function () { return useWolvesEvent_1.useWolvesEvent; } });
-var useWolvesInitialization_1 = require("./hooks/useWolvesInitialization");
-Object.defineProperty(exports, "useWolvesInitialization", { enumerable: true, get: function () { return useWolvesInitialization_1.useWolvesInitialization; } });
+var useClientAsyncInit_1 = require("./hooks/useClientAsyncInit");
+Object.defineProperty(exports, "useClientAsyncInit", { enumerable: true, get: function () { return useClientAsyncInit_1.useClientAsyncInit; } });
+var useClientSyncInit_1 = require("./hooks/useClientSyncInit");
+Object.defineProperty(exports, "useClientSyncInit", { enumerable: true, get: function () { return useClientSyncInit_1.useClientSyncInit; } });
 // SSR utilities
 var ssrHelpers_1 = require("./utils/ssrHelpers");
 Object.defineProperty(exports, "isBrowser", { enumerable: true, get: function () { return ssrHelpers_1.isBrowser; } });

package/dist/metadata.d.ts

@@ -2,8 +2,8 @@
  * React SDK Metadata
  * This file defines the SDK version and type for the Wolves React SDK
  */
-export declare const REACT_SDK_VERSION = "1.0.4";
-export declare const REACT_SDK_TYPE = "wolves-react-client";
+export declare const REACT_SDK_VERSION: string;
+export declare const REACT_SDK_TYPE: string;
 /**
  * Get React SDK metadata to override the JS SDK metadata
  */

package/dist/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAG9B,CAAC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,iBAAiB,QAAsB,CAAC;AACrD,eAAO,MAAM,cAAc,QAAmB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;CAG9B,CAAC"}

package/dist/metadata.js

@@ -3,10 +3,14 @@
  * React SDK Metadata
  * This file defines the SDK version and type for the Wolves React SDK
  */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getReactSDKMetadata = exports.REACT_SDK_TYPE = exports.REACT_SDK_VERSION = void 0;
-exports.REACT_SDK_VERSION = '1.0.4';
-exports.REACT_SDK_TYPE = 'wolves-react-client';
+const package_json_1 = __importDefault(require("../package.json"));
+exports.REACT_SDK_VERSION = package_json_1.default.version;
+exports.REACT_SDK_TYPE = package_json_1.default.name;
 /**
  * Get React SDK metadata to override the JS SDK metadata
  */

package/dist/types/index.d.ts

@@ -1,75 +1,6 @@
 /**
  * Type definitions for Wolves React SDK
  */
-import { WolvesUser, WolvesUpdateDetails, AsyncUpdateOptions, SyncUpdateOptions } from 'wolves-js-client';
-import React from 'react';
-/**
- * Initialization mode for the Wolves client
- */
-export type InitMode = 'async' | 'sync';
-/**
- * Options for configuring WolvesProvider behavior
- */
-export interface WolvesProviderOptions {
-    /** Initialization mode: 'async' (default) or 'sync' */
-    initMode?: InitMode;
-    /** API environment: 'local', 'dev', or 'prod' (default) */
-    apiEnv?: 'local' | 'dev' | 'prod';
-    /** Options for async initialization */
-    asyncOptions?: AsyncUpdateOptions;
-    /** Options for sync initialization */
-    syncOptions?: SyncUpdateOptions;
-    /** Callback invoked when initialization completes */
-    onInitialized?: (details: WolvesUpdateDetails) => void;
-    /** Callback invoked when an error occurs */
-    onError?: (error: Error) => void;
-}
-/**
- * Props for the WolvesProvider component
- */
-export interface WolvesProviderProps {
-    /** SDK key for authenticating with Wolves API */
-    sdkKey: string;
-    /** User object containing user identification and attributes */
-    user: WolvesUser;
-    /** Child components that will have access to Wolves context */
-    children: React.ReactNode;
-    /** Optional configuration options */
-    options?: WolvesProviderOptions;
-    /** Whether to wait for initialization before rendering children */
-    waitForInitialization?: boolean;
-    /** Component to display while waiting for initialization */
-    loadingComponent?: React.ReactNode;
-}
-/**
- * Options for the useExperiment hook
- */
-export interface UseExperimentOptions<T = Record<string, any>> {
-    /** Whether to skip logging exposure events */
-    skipExposure?: boolean;
-    /** Default value to return if experiment is not found */
-    defaultValue?: T;
-}
-/**
- * Return type for the useExperiment hook
- */
-export interface UseExperimentReturn<T = Record<string, any>> {
-    /** The experiment configuration value */
-    value: T;
-    /** The group/variant name assigned to the user */
-    groupName: string | null;
-    /** The experiment ID */
-    experimentID: string;
-    /** Get a specific parameter from the experiment with a default fallback */
-    get: <K extends keyof T>(key: K, defaultValue: T[K]) => T[K];
-    /** Whether the client is still loading */
-    isLoading: boolean;
-}
-/**
- * Return type for the useWolvesEvent hook
- */
-export interface UseWolvesEventReturn {
-    /** Function to log a custom event */
-    logEvent: (eventName: string, value?: string | number, metadata?: Record<string, string>) => void;
-}
+export type { UseClientAsyncInitOptions, UseClientAsyncInitReturn } from '../hooks/useClientAsyncInit';
+export type { UseClientSyncInitOptions, UseClientSyncInitReturn } from '../hooks/useClientSyncInit';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1G,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAClC,uCAAuC;IACvC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,sCAAsC;IACtC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,qDAAqD;IACrD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACvD,4CAA4C;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,IAAI,EAAE,UAAU,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,qCAAqC;IACrC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3D,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,CAAC,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC1D,yCAAyC;IACzC,KAAK,EAAE,CAAC,CAAC;IACT,kDAAkD;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,GAAG,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,QAAQ,EAAE,CACR,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,IAAI,CAAC;CACX"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvG,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolves-react-client",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "React SDK for Wolves A/B Testing Platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",