@statsig/react-bindings 0.0.1-beta.9 → 1.0.0

package/README.md

@@ -1,8 +1,5 @@
 # Statsig - React
 
-> [!IMPORTANT]
-> This version of the SDK is still in beta. The non-beta version can be found [here](https://github.com/statsig-io/react-sdk).
-
 ReactJS specific additions for use with a Statsig Javascript SDK.
 
 Learn more by visiting: https://docs.statsig.com/client/javascript-sdk

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@statsig/react-bindings",
-  "version": "0.0.1-beta.9",
+  "version": "1.0.0",
   "dependencies": {
-    "@statsig/client-core": "0.0.1-beta.9"
+    "@statsig/client-core": "1.0.0"
   },
   "peerDependencies": {
     "react": "^16.6.3 || ^17.0.0 || ^18.0.0"

package/src/NoopEvaluationsClient.js

@@ -1,44 +1,77 @@
 "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.NoopEvaluationsClient = void 0;
-var client_core_1 = require("@statsig/client-core");
-var noop = function () {
+const client_core_1 = require("@statsig/client-core");
+const _noop = () => {
     // noop
 };
-var NOOP_DETAILS = { reason: 'Error' };
-var defaultEvaluation = function (type) {
-    return function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        var name = typeof args[0] === 'string' ? args[0] : args[1];
+const _noopAsync = () => Promise.resolve();
+const NOOP_DETAILS = { reason: 'Error' };
+const _defaultEvaluation = (type) => {
+    return (...args) => {
+        const name = typeof args[0] === 'string' ? args[0] : args[1];
         switch (type) {
             case 'gate':
-                return (0, client_core_1.makeFeatureGate)(name, NOOP_DETAILS);
+                return (0, client_core_1._makeFeatureGate)(name, NOOP_DETAILS, null);
             case 'config':
-                return (0, client_core_1.makeDynamicConfig)(name, NOOP_DETAILS);
+                return (0, client_core_1._makeDynamicConfig)(name, NOOP_DETAILS, null);
             case 'layer':
-                return (0, client_core_1.makeLayer)(name, NOOP_DETAILS);
+                return (0, client_core_1._makeLayer)(name, NOOP_DETAILS, null);
         }
     };
 };
-var client = {
+const _noopDataAdapter = {
+    __primeInMemoryCache: _noop,
+    attach: _noop,
+    getDataSync: () => null,
+    getDataAsync: () => Promise.resolve(null),
+    setData: _noop,
+    setDataLegacy: _noop,
+    prefetchData: _noopAsync,
+};
+const context = {
+    sdkKey: '',
+    options: {},
+    values: null,
+    user: { userID: '' },
+    errorBoundary: {},
+};
+const _client = {
     isNoop: true,
     loadingStatus: 'Uninitialized',
-    initializeSync: noop,
-    initializeAsync: function () { return Promise.resolve(); },
-    shutdown: function () { return Promise.resolve(); },
-    updateUserSync: noop,
-    updateUserAsync: function (_u) { return Promise.resolve(); },
-    getCurrentUser: function () { return ({ userID: '' }); },
-    checkGate: function () { return false; },
-    getFeatureGate: defaultEvaluation('gate'),
-    getDynamicConfig: defaultEvaluation('config'),
-    getExperiment: defaultEvaluation('config'),
-    getLayer: defaultEvaluation('layer'),
-    logEvent: noop,
-    on: noop,
-    off: noop,
+    initializeSync: _noop,
+    initializeAsync: _noopAsync,
+    shutdown: _noopAsync,
+    flush: _noopAsync,
+    updateRuntimeOptions: _noop,
+    updateUserSync: _noop,
+    updateUserAsync: _noopAsync,
+    getContext: () => (Object.assign({}, context)),
+    getAsyncContext: () => __awaiter(void 0, void 0, void 0, function* () {
+        return (Object.assign(Object.assign({}, context), { session: {
+                data: { sessionID: '', startTime: 0, lastUpdate: 0 },
+                sdkKey: '',
+            }, stableID: '' }));
+    }),
+    checkGate: () => false,
+    getFeatureGate: _defaultEvaluation('gate'),
+    getDynamicConfig: _defaultEvaluation('config'),
+    getExperiment: _defaultEvaluation('config'),
+    getLayer: _defaultEvaluation('layer'),
+    logEvent: _noop,
+    on: _noop,
+    off: _noop,
+    $on: _noop,
+    $emt: _noop,
+    dataAdapter: _noopDataAdapter,
 };
-exports.NoopEvaluationsClient = client;
+exports.NoopEvaluationsClient = _client;

package/src/OnDeviceVsPrecomputedUtils.d.ts

@@ -1,5 +1,4 @@
 import { OnDeviceEvaluationsInterface, PrecomputedEvaluationsInterface } from '@statsig/client-core';
-export declare function isPrecomputedEvaluationsClient(client: OnDeviceEvaluationsInterface | PrecomputedEvaluationsInterface | {
-    isNoop: true;
-}): client is PrecomputedEvaluationsInterface;
+export declare function isPrecomputedEvalClient(client: OnDeviceEvaluationsInterface | PrecomputedEvaluationsInterface): client is PrecomputedEvaluationsInterface;
+export declare function isNoopClient(client: OnDeviceEvaluationsInterface | PrecomputedEvaluationsInterface): boolean;
 export declare function logMissingStatsigUserWarning(): void;

package/src/OnDeviceVsPrecomputedUtils.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.logMissingStatsigUserWarning = exports.isPrecomputedEvaluationsClient = void 0;
-var client_core_1 = require("@statsig/client-core");
-function isPrecomputedEvaluationsClient(client) {
-    if ('isNoop' in client) {
+exports.logMissingStatsigUserWarning = exports.isNoopClient = exports.isPrecomputedEvalClient = void 0;
+const client_core_1 = require("@statsig/client-core");
+function isPrecomputedEvalClient(client) {
+    if (isNoopClient(client)) {
         return false;
     }
     return 'updateUserSync' in client;
 }
-exports.isPrecomputedEvaluationsClient = isPrecomputedEvaluationsClient;
+exports.isPrecomputedEvalClient = isPrecomputedEvalClient;
+function isNoopClient(client) {
+    return 'isNoop' in client;
+}
+exports.isNoopClient = isNoopClient;
 function logMissingStatsigUserWarning() {
     client_core_1.Log.warn('StatsigUser not provided for On Device Evaluation. Returning default value.');
 }

package/src/StatsigContext.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = require("react");
+const react_1 = require("react");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
 exports.default = (0, react_1.createContext)({
     renderVersion: 0,
-    client: {},
+    client: NoopEvaluationsClient_1.NoopEvaluationsClient,
 });

package/src/StatsigProvider.d.ts

@@ -1,8 +1,7 @@
 import { ReactNode } from 'react';
 import { StatsigClientInterface } from '@statsig/client-core';
-type Props = {
+export type StatsigProviderProps = {
     children: ReactNode | ReactNode[];
     client: StatsigClientInterface;
 };
-export default function StatsigProvider(props: Props): JSX.Element;
-export {};
+export declare function StatsigProvider({ client, children, }: StatsigProviderProps): JSX.Element;

package/src/StatsigProvider.js

@@ -1,30 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-var jsx_runtime_1 = require("react/jsx-runtime");
-var react_1 = require("react");
-var client_core_1 = require("@statsig/client-core");
-var StatsigContext_1 = require("./StatsigContext");
-function StatsigProvider(props) {
-    var _a = (0, react_1.useState)(0), renderVersion = _a[0], setRenderVersion = _a[1];
-    var client = props.client, children = props.children;
-    (0, react_1.useEffect)(function () {
-        var onStatusChange = function (data) {
-            if (data.event === 'status_change') {
-                setRenderVersion(function (v) { return v + 1; });
-            }
+exports.StatsigProvider = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const StatsigContext_1 = require("./StatsigContext");
+function StatsigProvider({ client, children, }) {
+    const [renderVersion, setRenderVersion] = (0, react_1.useState)(0);
+    (0, react_1.useEffect)(() => {
+        const onValuesUpdated = () => {
+            setRenderVersion((v) => v + 1);
         };
-        client.on('status_change', onStatusChange);
-        client.initializeSync();
-        return function () {
-            client.shutdown().catch(function (error) {
+        client_core_1.SDKType._setBindingType('react');
+        client.$on('values_updated', onValuesUpdated);
+        return () => {
+            client.shutdown().catch((error) => {
                 client_core_1.Log.error('An error occured during shutdown', error);
             });
-            client.off('status_change', onStatusChange);
+            client.off('values_updated', onValuesUpdated);
         };
     }, [client]);
-    return ((0, jsx_runtime_1.jsx)(StatsigContext_1.default.Provider, { value: { renderVersion: renderVersion, client: client }, children: _shouldRender(client) ? children : null }));
+    return ((0, jsx_runtime_1.jsx)(StatsigContext_1.default.Provider, { value: { renderVersion, client }, children: _shouldRender(client) ? children : null }));
 }
-exports.default = StatsigProvider;
+exports.StatsigProvider = StatsigProvider;
 function _shouldRender(client) {
     if ('isNoop' in client) {
         return true;

package/src/index.d.ts

@@ -1,10 +1,12 @@
 import StatsigContext from './StatsigContext';
-import StatsigProvider from './StatsigProvider';
+import { StatsigProvider, StatsigProviderProps } from './StatsigProvider';
 import useDynamicConfig from './useDynamicConfig';
 import useExperiment from './useExperiment';
-import useGate from './useGate';
+import useFeatureGate from './useFeatureGate';
+import useGateValue from './useGateValue';
 import useLayer from './useLayer';
-import useStatsigOnDeviceEvaluationsClient from './useStatsigOnDeviceEvaluationsClient';
-import useStatsigPrecomputedEvaluationsClient from './useStatsigPrecomputedEvaluationsClient';
-import useStatsigUser from './useStatsigUser';
-export { StatsigContext, StatsigProvider, useGate, useDynamicConfig, useExperiment, useLayer, useStatsigUser, useStatsigOnDeviceEvaluationsClient, useStatsigPrecomputedEvaluationsClient, };
+import { useStatsigClient } from './useStatsigClient';
+import { useStatsigOnDeviceEvalClient } from './useStatsigOnDeviceEvalClient';
+import { useStatsigUser } from './useStatsigUser';
+export type { StatsigProviderProps };
+export { StatsigContext, StatsigProvider, useDynamicConfig, useExperiment, useGateValue, useFeatureGate, useLayer, useStatsigOnDeviceEvalClient, useStatsigClient, useStatsigUser, };

package/src/index.js

@@ -1,33 +1,32 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useStatsigPrecomputedEvaluationsClient = exports.useStatsigOnDeviceEvaluationsClient = exports.useStatsigUser = exports.useLayer = exports.useExperiment = exports.useDynamicConfig = exports.useGate = exports.StatsigProvider = exports.StatsigContext = void 0;
-var StatsigContext_1 = require("./StatsigContext");
+exports.useStatsigUser = exports.useStatsigClient = exports.useStatsigOnDeviceEvalClient = exports.useLayer = exports.useFeatureGate = exports.useGateValue = exports.useExperiment = exports.useDynamicConfig = exports.StatsigProvider = exports.StatsigContext = void 0;
+const StatsigContext_1 = require("./StatsigContext");
 exports.StatsigContext = StatsigContext_1.default;
-var StatsigProvider_1 = require("./StatsigProvider");
-exports.StatsigProvider = StatsigProvider_1.default;
-var useDynamicConfig_1 = require("./useDynamicConfig");
+const StatsigProvider_1 = require("./StatsigProvider");
+Object.defineProperty(exports, "StatsigProvider", { enumerable: true, get: function () { return StatsigProvider_1.StatsigProvider; } });
+const useDynamicConfig_1 = require("./useDynamicConfig");
 exports.useDynamicConfig = useDynamicConfig_1.default;
-var useExperiment_1 = require("./useExperiment");
+const useExperiment_1 = require("./useExperiment");
 exports.useExperiment = useExperiment_1.default;
-var useGate_1 = require("./useGate");
-exports.useGate = useGate_1.default;
-var useLayer_1 = require("./useLayer");
+const useFeatureGate_1 = require("./useFeatureGate");
+exports.useFeatureGate = useFeatureGate_1.default;
+const useGateValue_1 = require("./useGateValue");
+exports.useGateValue = useGateValue_1.default;
+const useLayer_1 = require("./useLayer");
 exports.useLayer = useLayer_1.default;
-var useStatsigOnDeviceEvaluationsClient_1 = require("./useStatsigOnDeviceEvaluationsClient");
-exports.useStatsigOnDeviceEvaluationsClient = useStatsigOnDeviceEvaluationsClient_1.default;
-var useStatsigPrecomputedEvaluationsClient_1 = require("./useStatsigPrecomputedEvaluationsClient");
-exports.useStatsigPrecomputedEvaluationsClient = useStatsigPrecomputedEvaluationsClient_1.default;
-var useStatsigUser_1 = require("./useStatsigUser");
-exports.useStatsigUser = useStatsigUser_1.default;
-__STATSIG__ = __assign(__assign({}, __STATSIG__), { StatsigContext: StatsigContext_1.default, StatsigProvider: StatsigProvider_1.default, useGate: useGate_1.default, useDynamicConfig: useDynamicConfig_1.default, useExperiment: useExperiment_1.default, useLayer: useLayer_1.default, useStatsigOnDeviceEvaluationsClient: useStatsigOnDeviceEvaluationsClient_1.default, useStatsigPrecomputedEvaluationsClient: useStatsigPrecomputedEvaluationsClient_1.default });
+const useStatsigClient_1 = require("./useStatsigClient");
+Object.defineProperty(exports, "useStatsigClient", { enumerable: true, get: function () { return useStatsigClient_1.useStatsigClient; } });
+const useStatsigOnDeviceEvalClient_1 = require("./useStatsigOnDeviceEvalClient");
+Object.defineProperty(exports, "useStatsigOnDeviceEvalClient", { enumerable: true, get: function () { return useStatsigOnDeviceEvalClient_1.useStatsigOnDeviceEvalClient; } });
+const useStatsigUser_1 = require("./useStatsigUser");
+Object.defineProperty(exports, "useStatsigUser", { enumerable: true, get: function () { return useStatsigUser_1.useStatsigUser; } });
+__STATSIG__ = Object.assign(Object.assign({}, (__STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {})), { StatsigContext: StatsigContext_1.default,
+    StatsigProvider: StatsigProvider_1.StatsigProvider,
+    useDynamicConfig: useDynamicConfig_1.default,
+    useExperiment: useExperiment_1.default,
+    useGateValue: useGateValue_1.default,
+    useFeatureGate: useFeatureGate_1.default,
+    useLayer: useLayer_1.default,
+    useStatsigOnDeviceEvalClient: useStatsigOnDeviceEvalClient_1.useStatsigOnDeviceEvalClient,
+    useStatsigClient: useStatsigClient_1.useStatsigClient });

package/src/useDynamicConfig.d.ts

@@ -1,4 +1,5 @@
-import { DynamicConfig } from '@statsig/client-core';
-import { UseConfigOptions } from './useConfigImpl';
-export type UseDynamicConfigOptions = UseConfigOptions;
+import { DynamicConfig, DynamicConfigEvaluationOptions, StatsigUser } from '@statsig/client-core';
+export type UseDynamicConfigOptions = DynamicConfigEvaluationOptions & {
+    user: StatsigUser | null;
+};
 export default function (configName: string, options?: UseDynamicConfigOptions): DynamicConfig;

package/src/useDynamicConfig.js

@@ -1,20 +1,21 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-var client_core_1 = require("@statsig/client-core");
-var useConfigImpl_1 = require("./useConfigImpl");
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
+const OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
+const StatsigContext_1 = require("./StatsigContext");
 function default_1(configName, options) {
-    if (options === void 0) { options = __assign(__assign({}, client_core_1.DEFAULT_EVAL_OPTIONS), { user: null }); }
-    return (0, useConfigImpl_1.useConfigImpl)('useDynamicConfig', configName, options);
+    const { client, renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    return (0, react_1.useMemo)(() => {
+        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvalClient)(client)) {
+            return client.getDynamicConfig(configName, options);
+        }
+        if ((options === null || options === void 0 ? void 0 : options.user) != null) {
+            return client.getDynamicConfig(configName, options.user, options);
+        }
+        client_core_1.Log.warn(`useDynamicConfig hook failed to find a valid Statsig client for dynamic config '${configName}'.`);
+        return NoopEvaluationsClient_1.NoopEvaluationsClient.getDynamicConfig(configName, options);
+    }, [configName, client, renderVersion, options]);
 }
 exports.default = default_1;

package/src/useExperiment.d.ts

@@ -1,4 +1,5 @@
-import { Experiment } from '@statsig/client-core';
-import { UseConfigOptions } from './useConfigImpl';
-export type UseExperimentOptions = UseConfigOptions;
+import { Experiment, ExperimentEvaluationOptions, StatsigUser } from '@statsig/client-core';
+export type UseExperimentOptions = ExperimentEvaluationOptions & {
+    user: StatsigUser | null;
+};
 export default function (experimentName: string, options?: UseExperimentOptions): Experiment;

package/src/useExperiment.js

@@ -1,20 +1,21 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-var client_core_1 = require("@statsig/client-core");
-var useConfigImpl_1 = require("./useConfigImpl");
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
+const OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
+const StatsigContext_1 = require("./StatsigContext");
 function default_1(experimentName, options) {
-    if (options === void 0) { options = __assign(__assign({}, client_core_1.DEFAULT_EVAL_OPTIONS), { user: null }); }
-    return (0, useConfigImpl_1.useConfigImpl)('useExperiment', experimentName, options);
+    const { client, renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    return (0, react_1.useMemo)(() => {
+        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvalClient)(client)) {
+            return client.getExperiment(experimentName, options);
+        }
+        if ((options === null || options === void 0 ? void 0 : options.user) != null) {
+            return client.getExperiment(experimentName, options.user, options);
+        }
+        client_core_1.Log.warn(`useExperiment hook failed to find a valid Statsig client for experiment '${experimentName}'.`);
+        return NoopEvaluationsClient_1.NoopEvaluationsClient.getExperiment(experimentName, options);
+    }, [experimentName, client, renderVersion, options]);
 }
 exports.default = default_1;

package/src/useFeatureGate.d.ts

@@ -0,0 +1,5 @@
+import { FeatureGate, FeatureGateEvaluationOptions, StatsigUser } from '@statsig/client-core';
+export type useFeatureGateOptions = FeatureGateEvaluationOptions & {
+    user: StatsigUser | null;
+};
+export default function (gateName: string, options?: useFeatureGateOptions): FeatureGate;

package/src/useFeatureGate.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
+const OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
+const StatsigContext_1 = require("./StatsigContext");
+function default_1(gateName, options) {
+    const { client, renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    const gate = (0, react_1.useMemo)(() => {
+        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvalClient)(client)) {
+            return client.getFeatureGate(gateName, options);
+        }
+        if ((options === null || options === void 0 ? void 0 : options.user) != null) {
+            return client.getFeatureGate(gateName, options.user, options);
+        }
+        client_core_1.Log.warn(`useFeatureGate hook failed to find a valid Statsig client for gate '${gateName}'.`);
+        return NoopEvaluationsClient_1.NoopEvaluationsClient.getFeatureGate(gateName, options);
+    }, [gateName, client, renderVersion, options]);
+    return gate;
+}
+exports.default = default_1;

package/src/useGateValue.d.ts

@@ -0,0 +1,5 @@
+import { FeatureGateEvaluationOptions, StatsigUser } from '@statsig/client-core';
+export type useFeatureGateOptions = FeatureGateEvaluationOptions & {
+    user: StatsigUser | null;
+};
+export default function (gateName: string, options?: useFeatureGateOptions): boolean;

package/src/useGateValue.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
+const OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
+const StatsigContext_1 = require("./StatsigContext");
+function default_1(gateName, options) {
+    const { client, renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    const gate = (0, react_1.useMemo)(() => {
+        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvalClient)(client)) {
+            return client.checkGate(gateName, options);
+        }
+        if ((options === null || options === void 0 ? void 0 : options.user) != null) {
+            return client.checkGate(gateName, options.user, options);
+        }
+        client_core_1.Log.warn(`useFeatureGate hook failed to find a valid Statsig client for gate '${gateName}'.`);
+        return NoopEvaluationsClient_1.NoopEvaluationsClient.checkGate(gateName, options);
+    }, [gateName, client, renderVersion, options]);
+    return gate;
+}
+exports.default = default_1;

package/src/useLayer.d.ts

@@ -1,5 +1,5 @@
-import { EvaluationOptions, Layer, StatsigUser } from '@statsig/client-core';
-export type UseLayerOptions = EvaluationOptions & {
+import { Layer, LayerEvaluationOptions, StatsigUser } from '@statsig/client-core';
+export type UseLayerOptions = LayerEvaluationOptions & {
     user: StatsigUser | null;
 };
 export default function (layerName: string, options?: UseLayerOptions): Layer;

package/src/useLayer.js

@@ -1,34 +1,22 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = require("react");
-var client_core_1 = require("@statsig/client-core");
-var NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
-var OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
-var StatsigContext_1 = require("./StatsigContext");
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
+const OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
+const StatsigContext_1 = require("./StatsigContext");
 function default_1(layerName, options) {
-    if (options === void 0) { options = __assign(__assign({}, client_core_1.DEFAULT_EVAL_OPTIONS), { user: null }); }
-    var client = (0, react_1.useContext)(StatsigContext_1.default).client;
-    var layer = (0, react_1.useMemo)(function () {
-        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvaluationsClient)(client)) {
+    const { client, renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    const layer = (0, react_1.useMemo)(() => {
+        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvalClient)(client)) {
             return client.getLayer(layerName, options);
         }
-        if (options.user != null) {
+        if ((options === null || options === void 0 ? void 0 : options.user) != null) {
             return client.getLayer(layerName, options.user, options);
         }
-        client_core_1.Log.warn("useLayer hook failed to find a valid Statsig client for layer '".concat(layerName, "'."));
+        client_core_1.Log.warn(`useLayer hook failed to find a valid Statsig client for layer '${layerName}'.`);
         return NoopEvaluationsClient_1.NoopEvaluationsClient.getLayer(layerName, options);
-    }, [client.loadingStatus, options]);
+    }, [layerName, client, renderVersion, options]);
     return layer;
 }
 exports.default = default_1;

package/src/useStatsigClient.d.ts

@@ -0,0 +1,6 @@
+import { PrecomputedEvaluationsInterface } from '@statsig/client-core';
+type HositedFuncs = Pick<PrecomputedEvaluationsInterface, 'checkGate' | 'getFeatureGate' | 'getDynamicConfig' | 'getExperiment' | 'getLayer' | 'logEvent'>;
+export declare function useStatsigClient(): HositedFuncs & {
+    client: PrecomputedEvaluationsInterface;
+};
+export {};

package/src/useStatsigClient.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStatsigClient = void 0;
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
+const OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
+const StatsigContext_1 = require("./StatsigContext");
+function useStatsigClient() {
+    const { client: anyClient, renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    const client = (0, react_1.useMemo)(() => {
+        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvalClient)(anyClient)) {
+            return anyClient;
+        }
+        client_core_1.Log.warn('Attempting to retrieve a StatsigClient but none was set.');
+        return NoopEvaluationsClient_1.NoopEvaluationsClient;
+    }, [anyClient, renderVersion]);
+    const deps = [client, renderVersion];
+    return {
+        client,
+        checkGate: (0, react_1.useCallback)((name, options) => {
+            return client.checkGate(name, options);
+        }, deps),
+        getFeatureGate: (0, react_1.useCallback)((name, options) => {
+            return client.getFeatureGate(name, options);
+        }, deps),
+        getDynamicConfig: (0, react_1.useCallback)((name, options) => {
+            return client.getDynamicConfig(name, options);
+        }, deps),
+        getExperiment: (0, react_1.useCallback)((name, options) => {
+            return client.getExperiment(name, options);
+        }, deps),
+        getLayer: (0, react_1.useCallback)((name, options) => {
+            return client.getLayer(name, options);
+        }, deps),
+        logEvent: (0, react_1.useCallback)((eventName, value, metadata) => {
+            if (typeof eventName === 'string') {
+                return client.logEvent(eventName, value, metadata);
+            }
+            return client.logEvent(eventName);
+        }, deps),
+    };
+}
+exports.useStatsigClient = useStatsigClient;

package/src/useStatsigOnDeviceEvalClient.d.ts

@@ -0,0 +1,6 @@
+import { OnDeviceEvaluationsInterface } from '@statsig/client-core';
+type HositedFuncs = Pick<OnDeviceEvaluationsInterface, 'checkGate' | 'getFeatureGate' | 'getDynamicConfig' | 'getExperiment' | 'getLayer' | 'logEvent'>;
+export declare function useStatsigOnDeviceEvalClient(): HositedFuncs & {
+    client: OnDeviceEvaluationsInterface;
+};
+export {};

package/src/useStatsigOnDeviceEvalClient.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useStatsigOnDeviceEvalClient = void 0;
+const react_1 = require("react");
+const client_core_1 = require("@statsig/client-core");
+const NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
+const OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
+const StatsigContext_1 = require("./StatsigContext");
+function useStatsigOnDeviceEvalClient() {
+    const { client: anyClient, renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    const client = (0, react_1.useMemo)(() => {
+        if (!(0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvalClient)(anyClient)) {
+            return anyClient;
+        }
+        client_core_1.Log.warn('Attempting to retrieve a StatsigOnDeviceEvalClient but none was set.');
+        return NoopEvaluationsClient_1.NoopEvaluationsClient;
+    }, [anyClient, renderVersion]);
+    const deps = [client, renderVersion];
+    return {
+        client,
+        checkGate: (0, react_1.useCallback)((name, options) => {
+            return client.checkGate(name, options);
+        }, deps),
+        getFeatureGate: (0, react_1.useCallback)((name, options) => {
+            return client.getFeatureGate(name, options);
+        }, deps),
+        getDynamicConfig: (0, react_1.useCallback)((name, options) => {
+            return client.getDynamicConfig(name, options);
+        }, deps),
+        getExperiment: (0, react_1.useCallback)((name, options) => {
+            return client.getExperiment(name, options);
+        }, deps),
+        getLayer: (0, react_1.useCallback)((name, options) => {
+            return client.getLayer(name, options);
+        }, deps),
+        logEvent: (0, react_1.useCallback)((eventName, user, value, metadata) => {
+            if (typeof eventName === 'string') {
+                return client.logEvent(eventName, user, value, metadata);
+            }
+            return client.logEvent(eventName, user);
+        }, deps),
+    };
+}
+exports.useStatsigOnDeviceEvalClient = useStatsigOnDeviceEvalClient;

package/src/useStatsigUser.d.ts

@@ -1,7 +1,12 @@
 import { StatsigUser } from '@statsig/client-core';
+type UpdaterArg = StatsigUser | ((previous: StatsigUser) => StatsigUser);
+type UpdaterFunc<T> = (updated: UpdaterArg) => T;
+type SyncUpdateFunc = UpdaterFunc<void>;
+type AsyncUpdateFunc = UpdaterFunc<Promise<void>>;
 export type UseStatsigUserResult = {
     user: StatsigUser;
-    updateUserSync: (fn: (prevState: StatsigUser) => StatsigUser) => void;
-    updateUserAsync: (fn: (prevState: StatsigUser) => StatsigUser) => Promise<void>;
+    updateUserSync: SyncUpdateFunc;
+    updateUserAsync: AsyncUpdateFunc;
 };
-export default function (): UseStatsigUserResult;
+export declare function useStatsigUser(): UseStatsigUserResult;
+export {};

package/src/useStatsigUser.js

@@ -1,18 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-var useStatsigPrecomputedEvaluationsClient_1 = require("./useStatsigPrecomputedEvaluationsClient");
-function default_1() {
-    var client = (0, useStatsigPrecomputedEvaluationsClient_1.default)();
+exports.useStatsigUser = void 0;
+const react_1 = require("react");
+const StatsigContext_1 = require("./StatsigContext");
+const useStatsigClient_1 = require("./useStatsigClient");
+function useStatsigUser() {
+    const { client } = (0, useStatsigClient_1.useStatsigClient)();
+    const { renderVersion } = (0, react_1.useContext)(StatsigContext_1.default);
+    const deps = [client, renderVersion];
+    const memoUser = (0, react_1.useMemo)(() => {
+        const context = client.getContext();
+        return context.user;
+    }, deps);
     return {
-        user: client.getCurrentUser(),
-        updateUserSync: function (fn) {
-            var user = fn(client.getCurrentUser());
-            client.updateUserSync(user);
-        },
-        updateUserAsync: function (fn) {
-            var user = fn(client.getCurrentUser());
-            return client.updateUserAsync(user);
-        },
+        user: memoUser,
+        updateUserSync: (0, react_1.useCallback)((arg) => {
+            if (typeof arg === 'function') {
+                arg = arg(memoUser);
+            }
+            client.updateUserSync(arg);
+        }, deps),
+        updateUserAsync: (0, react_1.useCallback)((arg) => {
+            if (typeof arg === 'function') {
+                arg = arg(memoUser);
+            }
+            return client.updateUserAsync(arg);
+        }, deps),
     };
 }
-exports.default = default_1;
+exports.useStatsigUser = useStatsigUser;

package/src/useConfigImpl.d.ts

@@ -1,5 +0,0 @@
-import { DynamicConfig, EvaluationOptions, StatsigUser } from '@statsig/client-core';
-export type UseConfigOptions = EvaluationOptions & {
-    user: StatsigUser | null;
-};
-export declare function useConfigImpl(hook: 'useExperiment' | 'useDynamicConfig', configName: string, options?: UseConfigOptions): DynamicConfig;

package/src/useConfigImpl.js

@@ -1,36 +0,0 @@
-"use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useConfigImpl = void 0;
-var react_1 = require("react");
-var client_core_1 = require("@statsig/client-core");
-var NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
-var OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
-var StatsigContext_1 = require("./StatsigContext");
-function useConfigImpl(hook, configName, options) {
-    if (options === void 0) { options = __assign(__assign({}, client_core_1.DEFAULT_EVAL_OPTIONS), { user: null }); }
-    var client = (0, react_1.useContext)(StatsigContext_1.default).client;
-    var config = (0, react_1.useMemo)(function () {
-        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvaluationsClient)(client)) {
-            return client.getDynamicConfig(configName, options);
-        }
-        if (options.user != null) {
-            return client.getDynamicConfig(configName, options.user, options);
-        }
-        var type = hook === 'useDynamicConfig' ? 'dynamic config' : 'experiment';
-        client_core_1.Log.warn("".concat(hook, " hook failed to find a valid Statsig client for ").concat(type, " '").concat(configName, "'."));
-        return NoopEvaluationsClient_1.NoopEvaluationsClient.getDynamicConfig(configName, options);
-    }, [client.loadingStatus, options]);
-    return config;
-}
-exports.useConfigImpl = useConfigImpl;

package/src/useGate.d.ts

@@ -1,5 +0,0 @@
-import { EvaluationOptions, FeatureGate, StatsigUser } from '@statsig/client-core';
-export type UseGateOptions = EvaluationOptions & {
-    user: StatsigUser | null;
-};
-export default function (gateName: string, options?: UseGateOptions): FeatureGate;

package/src/useGate.js

@@ -1,34 +0,0 @@
-"use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = require("react");
-var client_core_1 = require("@statsig/client-core");
-var NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
-var OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
-var StatsigContext_1 = require("./StatsigContext");
-function default_1(gateName, options) {
-    if (options === void 0) { options = __assign(__assign({}, client_core_1.DEFAULT_EVAL_OPTIONS), { user: null }); }
-    var client = (0, react_1.useContext)(StatsigContext_1.default).client;
-    var gate = (0, react_1.useMemo)(function () {
-        if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvaluationsClient)(client)) {
-            return client.getFeatureGate(gateName, options);
-        }
-        if (options.user != null) {
-            return client.getFeatureGate(gateName, options.user, options);
-        }
-        client_core_1.Log.warn("useGate hook failed to find a valid Statsig client for gate '".concat(gateName, "'."));
-        return NoopEvaluationsClient_1.NoopEvaluationsClient.getFeatureGate(gateName, options);
-    }, [client.loadingStatus, options]);
-    return gate;
-}
-exports.default = default_1;

package/src/useStatsigOnDeviceEvaluationsClient.d.ts

@@ -1,2 +0,0 @@
-import { OnDeviceEvaluationsInterface } from '@statsig/client-core';
-export default function (): OnDeviceEvaluationsInterface;

package/src/useStatsigOnDeviceEvaluationsClient.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = require("react");
-var client_core_1 = require("@statsig/client-core");
-var NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
-var OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
-var StatsigContext_1 = require("./StatsigContext");
-function default_1() {
-    var client = (0, react_1.useContext)(StatsigContext_1.default).client;
-    if (!(0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvaluationsClient)(client)) {
-        return client;
-    }
-    client_core_1.Log.warn('Attempting to retrive a Statsig OnDeviceEvaluationsClient but none was set.');
-    return NoopEvaluationsClient_1.NoopEvaluationsClient;
-}
-exports.default = default_1;

package/src/useStatsigPrecomputedEvaluationsClient.d.ts

@@ -1,2 +0,0 @@
-import { PrecomputedEvaluationsInterface } from '@statsig/client-core';
-export default function (): PrecomputedEvaluationsInterface;

package/src/useStatsigPrecomputedEvaluationsClient.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = require("react");
-var client_core_1 = require("@statsig/client-core");
-var NoopEvaluationsClient_1 = require("./NoopEvaluationsClient");
-var OnDeviceVsPrecomputedUtils_1 = require("./OnDeviceVsPrecomputedUtils");
-var StatsigContext_1 = require("./StatsigContext");
-function default_1() {
-    var client = (0, react_1.useContext)(StatsigContext_1.default).client;
-    if ((0, OnDeviceVsPrecomputedUtils_1.isPrecomputedEvaluationsClient)(client)) {
-        return client;
-    }
-    client_core_1.Log.warn('Attempting to retrive a Statsig PrecomputedEvaluationsClient but none was set.');
-    return NoopEvaluationsClient_1.NoopEvaluationsClient;
-}
-exports.default = default_1;