@replanejs/react 0.8.20 → 0.9.2

package/dist/index.js

@@ -2,17 +2,12 @@
 
 
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
-import { createReplaneClient, getReplaneSnapshot, restoreReplaneClient } from "@replanejs/sdk";
+import { Replane, Replane as Replane$1, ReplaneError, ReplaneErrorCode, getReplaneSnapshot } from "@replanejs/sdk";
 import { Fragment, jsx } from "react/jsx-runtime";
 
 //#region src/context.ts
 const ReplaneContext = createContext(null);
 
-//#endregion
-//#region src/version.ts
-const VERSION = "0.8.20";
-const DEFAULT_AGENT = `replane-js-react/${VERSION}`;
-
 //#endregion
 //#region src/useReplaneClient.ts
 const suspenseCache = new Map();
@@ -20,10 +15,23 @@ function getCacheKey(options) {
 	return `${options.baseUrl}:${options.sdkKey}`;
 }
 /**
-* Hook to manage ReplaneClient creation internally.
+* Creates a Replane client and connects it.
+*/
+async function createAndConnectClient(options, connection) {
+	const client = new Replane$1({
+		logger: options.logger,
+		context: options.context,
+		defaults: options.defaults
+	});
+	if (!connection) return client;
+	await client.connect(connection);
+	return client;
+}
+/**
+* Hook to manage Replane client creation internally.
 * Handles loading state and cleanup.
 */
-function useReplaneClientInternal(options) {
+function useReplaneClientInternal(options, originalConnection) {
 	const [state, setState] = useState({
 		status: "loading",
 		client: null,
@@ -31,16 +39,15 @@ function useReplaneClientInternal(options) {
 	});
 	const clientRef = useRef(null);
 	const optionsRef = useRef(options);
+	const connectionJson = JSON.stringify(originalConnection);
 	useEffect(() => {
+		const connection = JSON.parse(connectionJson);
 		let cancelled = false;
 		async function initClient() {
 			try {
-				const client = await createReplaneClient({
-					...optionsRef.current,
-					agent: optionsRef.current.agent ?? DEFAULT_AGENT
-				});
+				const client = await createAndConnectClient(optionsRef.current, connection);
 				if (cancelled) {
-					client.close();
+					client.disconnect();
 					return;
 				}
 				clientRef.current = client;
@@ -63,29 +70,26 @@ function useReplaneClientInternal(options) {
 		return () => {
 			cancelled = true;
 			if (clientRef.current) {
-				clientRef.current.close();
+				clientRef.current.disconnect();
 				clientRef.current = null;
 			}
 		};
-	}, []);
+	}, [connectionJson]);
 	return state;
 }
 /**
 * Hook for Suspense-based client creation.
 * Throws a promise while loading, throws error on failure.
 */
-function useReplaneClientSuspense(options) {
-	const cacheKey = getCacheKey(options);
+function useReplaneClientSuspense(options, connection) {
+	const cacheKey = getCacheKey(connection);
 	const cached = suspenseCache.get(cacheKey);
 	if (cached) {
 		if (cached.error) throw cached.error;
 		if (cached.result) return cached.result;
 		throw cached.promise;
 	}
-	const promise = createReplaneClient({
-		...options,
-		agent: options.agent ?? DEFAULT_AGENT
-	}).then((client) => {
+	const promise = createAndConnectClient(options, connection).then((client) => {
 		const entry = suspenseCache.get(cacheKey);
 		if (entry) entry.result = client;
 		return client;
@@ -98,150 +102,59 @@ function useReplaneClientSuspense(options) {
 	throw promise;
 }
 /**
-* Clear the suspense cache for a specific options configuration.
+* Clear the suspense cache for a specific connection configuration.
 * Useful for testing or when you need to force re-initialization.
 */
-function clearSuspenseCache(options) {
-	if (options) suspenseCache.delete(getCacheKey(options));
+function clearSuspenseCache(connection) {
+	if (connection) suspenseCache.delete(getCacheKey(connection));
 	else suspenseCache.clear();
 }
 
-//#endregion
-//#region src/hooks.ts
-function useReplane() {
-	const context = useContext(ReplaneContext);
-	if (!context) throw new Error("useReplane must be used within a ReplaneProvider");
-	return context.client;
-}
-function useConfig(name, options) {
-	const client = useReplane();
-	const subscribe = useCallback((callback) => {
-		return client.subscribe(name, callback);
-	}, [client, name]);
-	const get = useCallback(() => {
-		return client.get(name, options);
-	}, [
-		client,
-		name,
-		options
-	]);
-	const value = useSyncExternalStore(subscribe, get, get);
-	return value;
-}
-/**
-* Creates a typed version of useReplane hook.
-*
-* @example
-* ```tsx
-* interface AppConfigs {
-*   theme: { darkMode: boolean };
-*   features: { beta: boolean };
-* }
-*
-* const useAppReplane = createReplaneHook<AppConfigs>();
-*
-* function MyComponent() {
-*   const replane = useAppReplane();
-*   // replane.get("theme") returns { darkMode: boolean }
-* }
-* ```
-*/
-function createReplaneHook() {
-	return function useTypedReplane() {
-		return useReplane();
-	};
-}
-/**
-* Creates a typed version of useConfig hook.
-*
-* @example
-* ```tsx
-* interface AppConfigs {
-*   theme: { darkMode: boolean };
-*   features: { beta: boolean };
-* }
-*
-* const useAppConfig = createConfigHook<AppConfigs>();
-*
-* function MyComponent() {
-*   const theme = useAppConfig("theme");
-*   // theme is typed as { darkMode: boolean }
-* }
-* ```
-*/
-function createConfigHook() {
-	return function useTypedConfig(name, options) {
-		return useConfig(String(name), options);
-	};
-}
-/**
-* Hook for creating stateful resources with cleanup support.
-* Unlike useMemo, this guarantees cleanup when dependencies change or on unmount.
-*
-* @param factory - Function that creates the resource
-* @param cleanup - Function that cleans up the resource
-* @param deps - Dependencies array (resource is recreated when these change)
-*/
-function useStateful(factory, cleanup, deps) {
-	const valueRef = useRef(null);
-	const initializedRef = useRef(false);
-	if (!initializedRef.current) {
-		valueRef.current = factory();
-		initializedRef.current = true;
-	}
-	useEffect(() => {
-		if (valueRef.current === null) valueRef.current = factory();
-		return () => {
-			if (valueRef.current !== null) {
-				cleanup(valueRef.current);
-				valueRef.current = null;
-			}
-		};
-	}, deps);
-	return valueRef.current;
-}
-
 //#endregion
 //#region src/types.ts
 /**
 * Type guard to check if props contain a pre-created client.
 */
 function hasClient(props) {
-	return "client" in props && props.client !== void 0;
+	return "client" in props && !!props.client;
 }
 
+//#endregion
+//#region src/version.ts
+const VERSION = "0.9.2";
+const DEFAULT_AGENT = `replane-js-react/${VERSION}`;
+
 //#endregion
 //#region src/provider.tsx
 /**
 * Internal provider component for pre-created client.
 */
 function ReplaneProviderWithClient({ client, children }) {
-	const value = useMemo(() => ({ client }), [client]);
+	const value = useMemo(() => ({ replane: client }), [client]);
 	return /* @__PURE__ */ jsx(ReplaneContext.Provider, {
 		value,
 		children
 	});
 }
 /**
-* Internal provider component for restoring client from snapshot.
-* Uses restoreReplaneClient which is synchronous.
+* Internal provider component for creating a Replane client asynchronously.
+* Creates a Replane client synchronously and connects in background.
 */
-function ReplaneProviderWithSnapshot({ options, snapshot, children }) {
-	const client = useStateful(() => restoreReplaneClient({
-		snapshot,
-		connection: {
-			baseUrl: options.baseUrl,
-			sdkKey: options.sdkKey,
-			fetchFn: options.fetchFn,
-			requestTimeoutMs: options.requestTimeoutMs,
-			retryDelayMs: options.retryDelayMs,
-			inactivityTimeoutMs: options.inactivityTimeoutMs,
-			logger: options.logger,
-			agent: options.agent ?? DEFAULT_AGENT
-		},
-		context: options.context
-	}), (c) => c.close(), [snapshot, options]);
-	const value = useMemo(() => ({ client }), [client]);
+function AsyncReplaneProvider({ children, connection,...options }) {
+	const replaneRef = useRef(void 0);
+	if (!replaneRef.current) replaneRef.current = new Replane$1(options);
+	const connectionJson = connection ? JSON.stringify(connection) : void 0;
+	useEffect(() => {
+		const parsedConnection = connectionJson ? JSON.parse(connectionJson) : void 0;
+		if (!parsedConnection) return;
+		replaneRef.current.connect(parsedConnection).catch((err) => {
+			(options.logger ?? console)?.error("Failed to connect Replane client", err);
+		});
+		return () => {
+			replaneRef.current.disconnect();
+		};
+	}, [connectionJson, options.logger]);
+	const value = useMemo(() => ({ replane: replaneRef.current }), []);
 	return /* @__PURE__ */ jsx(ReplaneContext.Provider, {
 		value,
 		children
@@ -251,11 +164,12 @@ function ReplaneProviderWithSnapshot({ options, snapshot, children }) {
 * Internal provider component for options-based client creation (non-suspense).
 * Throws errors during rendering so they can be caught by Error Boundaries.
 */
-function ReplaneProviderWithOptions({ options, children, loader }) {
-	const state = useReplaneClientInternal(options);
+function LoaderReplaneProvider({ children, loader, connection,...options }) {
+	if (!connection) throw new Error("Connection is required when using Loader");
+	const state = useReplaneClientInternal(options, connection);
 	if (state.status === "loading") return /* @__PURE__ */ jsx(Fragment, { children: loader ?? null });
 	if (state.status === "error") throw state.error;
-	const value = { client: state.client };
+	const value = { replane: state.client };
 	return /* @__PURE__ */ jsx(ReplaneContext.Provider, {
 		value,
 		children
@@ -264,22 +178,24 @@ function ReplaneProviderWithOptions({ options, children, loader }) {
 /**
 * Internal provider component for options-based client creation with Suspense.
 */
-function ReplaneProviderWithSuspense({ options, children }) {
-	const client = useReplaneClientSuspense(options);
-	const value = useMemo(() => ({ client }), [client]);
+function SuspenseReplaneProvider({ connection, children,...options }) {
+	if (!connection) throw new Error("Connection is required when using Suspense");
+	const client = useReplaneClientSuspense(options, connection);
+	const value = useMemo(() => ({ replane: client }), [client]);
 	return /* @__PURE__ */ jsx(ReplaneContext.Provider, {
 		value,
 		children
 	});
 }
 /**
-* Provider component that makes a ReplaneClient available to the component tree.
+* Provider component that makes a Replane client available to the component tree.
 *
-* Can be used in three ways:
+* Can be used in several ways:
 *
 * 1. With a pre-created client:
 * ```tsx
-* const client = await createReplaneClient({ ... });
+* const client = new Replane({ defaults: { ... } });
+* await client.connect({ baseUrl: '...', sdkKey: '...' });
 * <ReplaneProvider client={client}>
 *   <App />
 * </ReplaneProvider>
@@ -329,15 +245,92 @@ function ReplaneProviderWithSuspense({ options, children }) {
 * allowing them to be caught by React Error Boundaries.
 */
 function ReplaneProvider(props) {
+	const originalConnection = props.connection;
+	const connection = useMemo(() => originalConnection ? {
+		...originalConnection,
+		agent: originalConnection.agent ?? DEFAULT_AGENT
+	} : void 0, [originalConnection]);
 	if (hasClient(props)) return /* @__PURE__ */ jsx(ReplaneProviderWithClient, { ...props });
-	if (props.snapshot) return /* @__PURE__ */ jsx(ReplaneProviderWithSnapshot, {
+	if (props.snapshot || !connection || props.async) return /* @__PURE__ */ jsx(AsyncReplaneProvider, { ...props });
+	if (props.suspense) return /* @__PURE__ */ jsx(SuspenseReplaneProvider, {
 		...props,
-		snapshot: props.snapshot
+		connection
 	});
-	if (props.suspense) return /* @__PURE__ */ jsx(ReplaneProviderWithSuspense, { ...props });
-	return /* @__PURE__ */ jsx(ReplaneProviderWithOptions, { ...props });
+	return /* @__PURE__ */ jsx(LoaderReplaneProvider, {
+		...props,
+		connection
+	});
+}
+
+//#endregion
+//#region src/hooks.ts
+function useReplane() {
+	const context = useContext(ReplaneContext);
+	if (!context) throw new Error("useReplane must be used within a ReplaneProvider");
+	return context.replane;
+}
+function useConfig(name, options) {
+	const client = useReplane();
+	const subscribe = useCallback((callback) => {
+		return client.subscribe(name, callback);
+	}, [client, name]);
+	const get = useCallback(() => {
+		return client.get(name, options);
+	}, [
+		client,
+		name,
+		options
+	]);
+	const value = useSyncExternalStore(subscribe, get, get);
+	return value;
+}
+/**
+* Creates a typed version of useReplane hook.
+*
+* @example
+* ```tsx
+* interface AppConfigs {
+*   theme: { darkMode: boolean };
+*   features: { beta: boolean };
+* }
+*
+* const useAppReplane = createReplaneHook<AppConfigs>();
+*
+* function MyComponent() {
+*   const replane = useAppReplane();
+*   // replane.get("theme") returns { darkMode: boolean }
+* }
+* ```
+*/
+function createReplaneHook() {
+	return function useTypedReplane() {
+		return useReplane();
+	};
+}
+/**
+* Creates a typed version of useConfig hook.
+*
+* @example
+* ```tsx
+* interface AppConfigs {
+*   theme: { darkMode: boolean };
+*   features: { beta: boolean };
+* }
+*
+* const useAppConfig = createConfigHook<AppConfigs>();
+*
+* function MyComponent() {
+*   const theme = useAppConfig("theme");
+*   // theme is typed as { darkMode: boolean }
+* }
+* ```
+*/
+function createConfigHook() {
+	return function useTypedConfig(name, options) {
+		return useConfig(String(name), options);
+	};
 }
 
 //#endregion
-export { ReplaneProvider, clearSuspenseCache, createConfigHook, createReplaneHook, getReplaneSnapshot, useConfig, useReplane };
+export { Replane, ReplaneError, ReplaneErrorCode, ReplaneProvider, clearSuspenseCache, createConfigHook, createReplaneHook, getReplaneSnapshot, useConfig, useReplane };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["options: ReplaneClientOptions<T>","err: unknown","options?: ReplaneClientOptions<T>","name: string","options?: GetConfigOptions<T>","callback: () => void","name: K","options?: GetConfigOptions<TConfigs[K]>","factory: () => T","cleanup: (value: T) => void","deps: React.DependencyList","props: ReplaneProviderProps<T>","value: ReplaneContextValue<T>","props: ReplaneProviderProps<T>"],"sources":["../src/context.ts","../src/version.ts","../src/useReplaneClient.ts","../src/hooks.ts","../src/types.ts","../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport { createContext } from \"react\";\nimport type { ReplaneContextValue } from \"./types\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const ReplaneContext = createContext<ReplaneContextValue<any> | null>(null);\n","// Auto-generated - do not edit manually\nexport const VERSION = \"0.8.20\";\nexport const DEFAULT_AGENT = `replane-js-react/${VERSION}`;\n","\"use client\";\n\nimport { useEffect, useRef, useState } from \"react\";\nimport { createReplaneClient } from \"@replanejs/sdk\";\nimport type { ReplaneClient, ReplaneClientOptions } from \"@replanejs/sdk\";\nimport { DEFAULT_AGENT } from \"./version\";\n\ntype ClientState<T extends object> =\n  | { status: \"loading\"; client: null; error: null }\n  | { status: \"ready\"; client: ReplaneClient<T>; error: null }\n  | { status: \"error\"; client: null; error: Error };\n\n// Cache for suspense promise tracking\nconst suspenseCache = new Map<\n  string,\n  {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    promise: Promise<ReplaneClient<any>>;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    result?: ReplaneClient<any>;\n    error?: Error;\n  }\n>();\n\nfunction getCacheKey<T extends object>(options: ReplaneClientOptions<T>): string {\n  return `${options.baseUrl}:${options.sdkKey}`;\n}\n\ntype ErrorConstructor = new (message: string, options?: { cause?: unknown }) => Error;\n\n/**\n * Hook to manage ReplaneClient creation internally.\n * Handles loading state and cleanup.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useReplaneClientInternal<T extends object = any>(\n  options: ReplaneClientOptions<T>\n): ClientState<T> {\n  const [state, setState] = useState<ClientState<T>>({\n    status: \"loading\",\n    client: null,\n    error: null,\n  });\n  const clientRef = useRef<ReplaneClient<T> | null>(null);\n  const optionsRef = useRef(options);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    async function initClient() {\n      try {\n        const client = await createReplaneClient<T>({\n          ...optionsRef.current,\n          agent: optionsRef.current.agent ?? DEFAULT_AGENT,\n        });\n        if (cancelled) {\n          client.close();\n          return;\n        }\n        clientRef.current = client;\n        setState({ status: \"ready\", client, error: null });\n      } catch (err) {\n        if (cancelled) return;\n        const error =\n          err instanceof Error ? err : new (Error as ErrorConstructor)(String(err), { cause: err });\n        setState({ status: \"error\", client: null, error });\n      }\n    }\n\n    initClient();\n\n    return () => {\n      cancelled = true;\n      if (clientRef.current) {\n        clientRef.current.close();\n        clientRef.current = null;\n      }\n    };\n  }, []);\n\n  return state;\n}\n\n/**\n * Hook for Suspense-based client creation.\n * Throws a promise while loading, throws error on failure.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useReplaneClientSuspense<T extends object = any>(\n  options: ReplaneClientOptions<T>\n): ReplaneClient<T> {\n  const cacheKey = getCacheKey(options);\n  const cached = suspenseCache.get(cacheKey);\n\n  if (cached) {\n    if (cached.error) {\n      throw cached.error;\n    }\n    if (cached.result) {\n      return cached.result as ReplaneClient<T>;\n    }\n    // Still loading, throw the promise\n    throw cached.promise;\n  }\n\n  // First time - create the promise\n  const promise = createReplaneClient<T>({\n    ...options,\n    agent: options.agent ?? DEFAULT_AGENT,\n  })\n    .then((client) => {\n      const entry = suspenseCache.get(cacheKey);\n      if (entry) {\n        entry.result = client;\n      }\n      return client;\n    })\n    .catch((err: unknown) => {\n      const entry = suspenseCache.get(cacheKey);\n      if (entry) {\n        entry.error = err instanceof Error ? err : new Error(String(err));\n      }\n      throw err;\n    });\n\n  suspenseCache.set(cacheKey, { promise });\n  throw promise;\n}\n\n/**\n * Clear the suspense cache for a specific options configuration.\n * Useful for testing or when you need to force re-initialization.\n */\nexport function clearSuspenseCache<T extends object>(options?: ReplaneClientOptions<T>): void {\n  if (options) {\n    suspenseCache.delete(getCacheKey(options));\n  } else {\n    suspenseCache.clear();\n  }\n}\n","\"use client\";\n\nimport { useCallback, useContext, useEffect, useRef, useSyncExternalStore } from \"react\";\nimport { ReplaneContext } from \"./context\";\nimport type { UntypedReplaneConfig } from \"./types\";\nimport type { ReplaneClient, GetConfigOptions } from \"@replanejs/sdk\";\n\nexport function useReplane<T extends object = UntypedReplaneConfig>(): ReplaneClient<T> {\n  const context = useContext(ReplaneContext);\n  if (!context) {\n    throw new Error(\"useReplane must be used within a ReplaneProvider\");\n  }\n  return context.client as ReplaneClient<T>;\n}\n\nexport function useConfig<T>(name: string, options?: GetConfigOptions<T>): T {\n  const client = useReplane();\n\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      return client.subscribe(name, callback);\n    },\n    [client, name]\n  );\n\n  const get = useCallback(() => {\n    return client.get(name, options) as T;\n  }, [client, name, options]);\n\n  const value = useSyncExternalStore(subscribe, get, get);\n\n  return value;\n}\n\n/**\n * Creates a typed version of useReplane hook.\n *\n * @example\n * ```tsx\n * interface AppConfigs {\n *   theme: { darkMode: boolean };\n *   features: { beta: boolean };\n * }\n *\n * const useAppReplane = createReplaneHook<AppConfigs>();\n *\n * function MyComponent() {\n *   const replane = useAppReplane();\n *   // replane.get(\"theme\") returns { darkMode: boolean }\n * }\n * ```\n */\nexport function createReplaneHook<TConfigs extends object>() {\n  return function useTypedReplane(): ReplaneClient<TConfigs> {\n    return useReplane<TConfigs>();\n  };\n}\n\n/**\n * Creates a typed version of useConfig hook.\n *\n * @example\n * ```tsx\n * interface AppConfigs {\n *   theme: { darkMode: boolean };\n *   features: { beta: boolean };\n * }\n *\n * const useAppConfig = createConfigHook<AppConfigs>();\n *\n * function MyComponent() {\n *   const theme = useAppConfig(\"theme\");\n *   // theme is typed as { darkMode: boolean }\n * }\n * ```\n */\nexport function createConfigHook<TConfigs extends object>() {\n  return function useTypedConfig<K extends keyof TConfigs>(\n    name: K,\n    options?: GetConfigOptions<TConfigs[K]>\n  ): TConfigs[K] {\n    return useConfig<TConfigs[K]>(String(name), options);\n  };\n}\n\n/**\n * Hook for creating stateful resources with cleanup support.\n * Unlike useMemo, this guarantees cleanup when dependencies change or on unmount.\n *\n * @param factory - Function that creates the resource\n * @param cleanup - Function that cleans up the resource\n * @param deps - Dependencies array (resource is recreated when these change)\n */\nexport function useStateful<T>(\n  factory: () => T,\n  cleanup: (value: T) => void,\n  deps: React.DependencyList\n): T {\n  const valueRef = useRef<T | null>(null);\n  const initializedRef = useRef(false);\n\n  // Create initial value synchronously on first render\n  if (!initializedRef.current) {\n    valueRef.current = factory();\n    initializedRef.current = true;\n  }\n\n  useEffect(() => {\n    // On mount or deps change, we may need to recreate\n    // If this is not the initial mount, recreate the value\n    if (valueRef.current === null) {\n      valueRef.current = factory();\n    }\n\n    return () => {\n      if (valueRef.current !== null) {\n        cleanup(valueRef.current);\n        valueRef.current = null;\n      }\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n\n  return valueRef.current as T;\n}\n","import type {\n  ReplaneClient,\n  ReplaneClientOptions,\n  ReplaneSnapshot,\n} from \"@replanejs/sdk\";\nimport type { ReactNode } from \"react\";\n\nexport type UntypedReplaneConfig = Record<string, unknown>;\n\nexport interface ReplaneContextValue<T extends object = UntypedReplaneConfig> {\n  client: ReplaneClient<T>;\n}\n\n/**\n * Props for ReplaneProvider when using a pre-created client.\n */\nexport interface ReplaneProviderWithClientProps<T extends object = UntypedReplaneConfig> {\n  /** Pre-created ReplaneClient instance */\n  client: ReplaneClient<T>;\n  children: ReactNode;\n}\n\n/**\n * Props for ReplaneProvider when letting it manage the client internally.\n */\nexport interface ReplaneProviderWithOptionsProps<T extends object = UntypedReplaneConfig> {\n  /** Options to create or restore the ReplaneClient */\n  options: ReplaneClientOptions<T>;\n  children: ReactNode;\n  /**\n   * Optional snapshot from server-side rendering.\n   * When provided, the client will be restored from the snapshot synchronously\n   * instead of fetching configs from the server.\n   * The `options` will be used for live updates connection if provided.\n   */\n  snapshot?: ReplaneSnapshot<T>;\n  /**\n   * Optional loading component to show while the client is initializing.\n   * If not provided and suspense is false/undefined, children will not render until ready.\n   * Ignored when snapshot is provided (restoration is synchronous).\n   */\n  loader?: ReactNode;\n  /**\n   * If true, uses React Suspense for loading state.\n   * The provider will throw a promise that Suspense can catch.\n   * Ignored when snapshot is provided (restoration is synchronous).\n   * @default false\n   */\n  suspense?: boolean;\n}\n\nexport type ReplaneProviderProps<T extends object = UntypedReplaneConfig> =\n  | ReplaneProviderWithClientProps<T>\n  | ReplaneProviderWithOptionsProps<T>;\n\n/**\n * Type guard to check if props contain a pre-created client.\n */\nexport function hasClient<T extends object>(\n  props: ReplaneProviderProps<T>\n): props is ReplaneProviderWithClientProps<T> {\n  return \"client\" in props && props.client !== undefined;\n}\n\n/**\n * Type guard to check if props contain options (with or without snapshot).\n */\nexport function hasOptions<T extends object>(\n  props: ReplaneProviderProps<T>\n): props is ReplaneProviderWithOptionsProps<T> {\n  return \"options\" in props && props.options !== undefined;\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport { restoreReplaneClient } from \"@replanejs/sdk\";\nimport { ReplaneContext } from \"./context\";\nimport { useReplaneClientInternal, useReplaneClientSuspense } from \"./useReplaneClient\";\nimport { useStateful } from \"./hooks\";\nimport type {\n  ReplaneProviderProps,\n  ReplaneProviderWithClientProps,\n  ReplaneProviderWithOptionsProps,\n  ReplaneContextValue,\n} from \"./types\";\nimport { hasClient } from \"./types\";\nimport { DEFAULT_AGENT } from \"./version\";\n\n/**\n * Internal provider component for pre-created client.\n */\nfunction ReplaneProviderWithClient<T extends object>({\n  client,\n  children,\n}: ReplaneProviderWithClientProps<T>) {\n  const value = useMemo<ReplaneContextValue<T>>(() => ({ client }), [client]);\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Internal provider component for restoring client from snapshot.\n * Uses restoreReplaneClient which is synchronous.\n */\nfunction ReplaneProviderWithSnapshot<T extends object>({\n  options,\n  snapshot,\n  children,\n}: ReplaneProviderWithOptionsProps<T> & {\n  snapshot: NonNullable<ReplaneProviderWithOptionsProps<T>[\"snapshot\"]>;\n}) {\n  const client = useStateful(\n    () =>\n      restoreReplaneClient<T>({\n        snapshot,\n        connection: {\n          baseUrl: options.baseUrl,\n          sdkKey: options.sdkKey,\n          fetchFn: options.fetchFn,\n          requestTimeoutMs: options.requestTimeoutMs,\n          retryDelayMs: options.retryDelayMs,\n          inactivityTimeoutMs: options.inactivityTimeoutMs,\n          logger: options.logger,\n          agent: options.agent ?? DEFAULT_AGENT,\n        },\n        context: options.context,\n      }),\n    (c) => c.close(),\n    [snapshot, options]\n  );\n  const value = useMemo<ReplaneContextValue<T>>(() => ({ client }), [client]);\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Internal provider component for options-based client creation (non-suspense).\n * Throws errors during rendering so they can be caught by Error Boundaries.\n */\nfunction ReplaneProviderWithOptions<T extends object>({\n  options,\n  children,\n  loader,\n}: ReplaneProviderWithOptionsProps<T>) {\n  const state = useReplaneClientInternal<T>(options);\n\n  if (state.status === \"loading\") {\n    return <>{loader ?? null}</>;\n  }\n\n  if (state.status === \"error\") {\n    // Throw error during render so it can be caught by Error Boundary\n    throw state.error;\n  }\n\n  const value: ReplaneContextValue<T> = { client: state.client };\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Internal provider component for options-based client creation with Suspense.\n */\nfunction ReplaneProviderWithSuspense<T extends object>({\n  options,\n  children,\n}: ReplaneProviderWithOptionsProps<T>) {\n  const client = useReplaneClientSuspense<T>(options);\n  const value = useMemo<ReplaneContextValue<T>>(() => ({ client }), [client]);\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Provider component that makes a ReplaneClient available to the component tree.\n *\n * Can be used in three ways:\n *\n * 1. With a pre-created client:\n * ```tsx\n * const client = await createReplaneClient({ ... });\n * <ReplaneProvider client={client}>\n *   <App />\n * </ReplaneProvider>\n * ```\n *\n * 2. With options (client managed internally):\n * ```tsx\n * <ErrorBoundary fallback={<ErrorMessage />}>\n *   <ReplaneProvider\n *     options={{ baseUrl: '...', sdkKey: '...' }}\n *     loader={<LoadingSpinner />}\n *   >\n *     <App />\n *   </ReplaneProvider>\n * </ErrorBoundary>\n * ```\n *\n * 3. With Suspense:\n * ```tsx\n * <ErrorBoundary fallback={<ErrorMessage />}>\n *   <Suspense fallback={<LoadingSpinner />}>\n *     <ReplaneProvider\n *       options={{ baseUrl: '...', sdkKey: '...' }}\n *       suspense\n *     >\n *       <App />\n *     </ReplaneProvider>\n *   </Suspense>\n * </ErrorBoundary>\n * ```\n *\n * 4. With a snapshot (for SSR/hydration):\n * ```tsx\n * // On the server, get a snapshot from the client\n * const snapshot = serverClient.getSnapshot();\n *\n * // On the client, restore from the snapshot with live updates\n * <ReplaneProvider\n *   options={{ baseUrl: '...', sdkKey: '...' }}\n *   snapshot={snapshot}\n * >\n *   <App />\n * </ReplaneProvider>\n * ```\n *\n * Errors during client initialization are thrown during rendering,\n * allowing them to be caught by React Error Boundaries.\n */\nexport function ReplaneProvider<T extends object>(props: ReplaneProviderProps<T>) {\n  if (hasClient(props)) {\n    return <ReplaneProviderWithClient {...props} />;\n  }\n\n  // Has options - check if snapshot is provided\n  if (props.snapshot) {\n    return <ReplaneProviderWithSnapshot {...props} snapshot={props.snapshot} />;\n  }\n\n  if (props.suspense) {\n    return <ReplaneProviderWithSuspense {...props} />;\n  }\n\n  return <ReplaneProviderWithOptions {...props} />;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["options: ConnectOptions","options: ReplaneOptions<T>","connection: ConnectOptions","Replane","originalConnection: ConnectOptions","err: unknown","connection?: ConnectOptions","props: ReplaneProviderProps<T>","Replane","value: ReplaneContextValue<T>","props: ReplaneProviderProps<T>","name: string","options?: GetConfigOptions<T>","callback: () => void","name: K","options?: GetConfigOptions<TConfigs[K]>"],"sources":["../src/context.ts","../src/useReplaneClient.ts","../src/types.ts","../src/version.ts","../src/provider.tsx","../src/hooks.ts"],"sourcesContent":["\"use client\";\n\nimport { createContext } from \"react\";\nimport type { ReplaneContextValue } from \"./types\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const ReplaneContext = createContext<ReplaneContextValue<any> | null>(null);\n","\"use client\";\n\nimport { useEffect, useRef, useState } from \"react\";\nimport { Replane, type ConnectOptions, type ReplaneOptions } from \"@replanejs/sdk\";\n\ntype ClientState<T extends object> =\n  | { status: \"loading\"; client: null; error: null }\n  | { status: \"ready\"; client: Replane<T>; error: null }\n  | { status: \"error\"; client: null; error: Error };\n\n// Cache for suspense promise tracking\nconst suspenseCache = new Map<\n  string,\n  {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    promise: Promise<Replane<any>>;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    result?: Replane<any>;\n    error?: Error;\n  }\n>();\n\nfunction getCacheKey(options: ConnectOptions): string {\n  return `${options.baseUrl}:${options.sdkKey}`;\n}\n\n/**\n * Creates a Replane client and connects it.\n */\nasync function createAndConnectClient<T extends object>(\n  options: ReplaneOptions<T>,\n  connection: ConnectOptions\n): Promise<Replane<T>> {\n  const client = new Replane<T>({\n    logger: options.logger,\n    context: options.context,\n    defaults: options.defaults,\n  });\n\n  if (!connection) {\n    return client;\n  }\n\n  await client.connect(connection);\n\n  return client;\n}\n\ntype ErrorConstructor = new (message: string, options?: { cause?: unknown }) => Error;\n\n/**\n * Hook to manage Replane client creation internally.\n * Handles loading state and cleanup.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useReplaneClientInternal<T extends object = any>(\n  options: ReplaneOptions<T>,\n  originalConnection: ConnectOptions\n): ClientState<T> {\n  const [state, setState] = useState<ClientState<T>>({\n    status: \"loading\",\n    client: null,\n    error: null,\n  });\n  const clientRef = useRef<Replane<T> | null>(null);\n  const optionsRef = useRef(options);\n\n  const connectionJson = JSON.stringify(originalConnection);\n  useEffect(() => {\n    const connection = JSON.parse(connectionJson);\n    let cancelled = false;\n\n    async function initClient() {\n      try {\n        const client = await createAndConnectClient<T>(optionsRef.current, connection);\n        if (cancelled) {\n          client.disconnect();\n          return;\n        }\n        clientRef.current = client;\n        setState({ status: \"ready\", client, error: null });\n      } catch (err) {\n        if (cancelled) return;\n        const error =\n          err instanceof Error ? err : new (Error as ErrorConstructor)(String(err), { cause: err });\n        setState({ status: \"error\", client: null, error });\n      }\n    }\n\n    initClient();\n\n    return () => {\n      cancelled = true;\n      if (clientRef.current) {\n        clientRef.current.disconnect();\n        clientRef.current = null;\n      }\n    };\n  }, [connectionJson]);\n\n  return state;\n}\n\n/**\n * Hook for Suspense-based client creation.\n * Throws a promise while loading, throws error on failure.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useReplaneClientSuspense<T extends object = any>(\n  options: ReplaneOptions<T>,\n  connection: ConnectOptions\n): Replane<T> {\n  const cacheKey = getCacheKey(connection);\n  const cached = suspenseCache.get(cacheKey);\n\n  if (cached) {\n    if (cached.error) {\n      throw cached.error;\n    }\n    if (cached.result) {\n      return cached.result as Replane<T>;\n    }\n    // Still loading, throw the promise\n    throw cached.promise;\n  }\n\n  // First time - create the promise\n  const promise = createAndConnectClient<T>(options, connection)\n    .then((client) => {\n      const entry = suspenseCache.get(cacheKey);\n      if (entry) {\n        entry.result = client;\n      }\n      return client;\n    })\n    .catch((err: unknown) => {\n      const entry = suspenseCache.get(cacheKey);\n      if (entry) {\n        entry.error = err instanceof Error ? err : new Error(String(err));\n      }\n      throw err;\n    });\n\n  suspenseCache.set(cacheKey, { promise });\n  throw promise;\n}\n\n/**\n * Clear the suspense cache for a specific connection configuration.\n * Useful for testing or when you need to force re-initialization.\n */\nexport function clearSuspenseCache(connection?: ConnectOptions): void {\n  if (connection) {\n    suspenseCache.delete(getCacheKey(connection));\n  } else {\n    suspenseCache.clear();\n  }\n}\n","import type { Replane, ReplaneOptions, ConnectOptions } from \"@replanejs/sdk\";\nimport type { ReactNode } from \"react\";\n\nexport type UntypedReplaneConfig = Record<string, unknown>;\n\nexport interface ReplaneContextValue<T extends object = UntypedReplaneConfig> {\n  replane: Replane<T>;\n}\n\n/**\n * Props for ReplaneProvider when using a pre-created client.\n */\nexport interface ReplaneProviderWithClientProps<T extends object = UntypedReplaneConfig> {\n  /** Pre-created Replane client instance */\n  client: Replane<T>;\n  children: ReactNode;\n}\n\n/**\n * Props for ReplaneProvider when letting it manage the client internally.\n */\nexport interface ReplaneProviderWithOptionsProps<\n  T extends object = UntypedReplaneConfig,\n> extends ReplaneOptions<T> {\n  children: ReactNode;\n  /**\n   * Connection options for connecting to the Replane server.\n   * Pass null to explicitly skip connection (client will use defaults/snapshot only).\n   */\n  connection: ConnectOptions | null;\n  /**\n   * Optional loading component to show while the client is initializing.\n   * If not provided and suspense is false/undefined, children will not render until ready.\n   * Ignored when snapshot is provided (restoration is synchronous).\n   */\n  loader?: ReactNode;\n  /**\n   * If true, uses React Suspense for loading state.\n   * The provider will throw a promise that Suspense can catch.\n   * Ignored when snapshot is provided (restoration is synchronous).\n   * @default false\n   */\n  suspense?: boolean;\n  /**\n   * If true, the client will be connected asynchronously. Make sure to provide defaults or snapshot.\n   * @default false\n   */\n  async?: boolean;\n}\n\nexport type ReplaneProviderProps<T extends object = UntypedReplaneConfig> =\n  | ReplaneProviderWithClientProps<T>\n  | ReplaneProviderWithOptionsProps<T>;\n\n/**\n * Type guard to check if props contain a pre-created client.\n */\nexport function hasClient<T extends object>(\n  props: ReplaneProviderProps<T>\n): props is ReplaneProviderWithClientProps<T> {\n  return \"client\" in props && !!props.client;\n}\n\n/**\n * Type guard to check if props contain options (with or without snapshot).\n */\nexport function hasOptions<T extends object>(\n  props: ReplaneProviderProps<T>\n): props is ReplaneProviderWithOptionsProps<T> {\n  return !hasClient(props);\n}\n","// Auto-generated - do not edit manually\nexport const VERSION = \"0.9.2\";\nexport const DEFAULT_AGENT = `replane-js-react/${VERSION}`;\n","\"use client\";\n\nimport { useEffect, useMemo, useRef } from \"react\";\nimport { Replane, type ConnectOptions } from \"@replanejs/sdk\";\nimport { ReplaneContext } from \"./context\";\nimport { useReplaneClientInternal, useReplaneClientSuspense } from \"./useReplaneClient\";\nimport type {\n  ReplaneProviderProps,\n  ReplaneProviderWithClientProps,\n  ReplaneProviderWithOptionsProps,\n  ReplaneContextValue,\n} from \"./types\";\nimport { hasClient } from \"./types\";\nimport { DEFAULT_AGENT } from \"./version\";\n\n/**\n * Internal provider component for pre-created client.\n */\nfunction ReplaneProviderWithClient<T extends object>({\n  client,\n  children,\n}: ReplaneProviderWithClientProps<T>) {\n  const value = useMemo<ReplaneContextValue<T>>(() => ({ replane: client }), [client]);\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Internal provider component for creating a Replane client asynchronously.\n * Creates a Replane client synchronously and connects in background.\n */\nfunction AsyncReplaneProvider<T extends object>({\n  children,\n  connection,\n  ...options\n}: ReplaneProviderWithOptionsProps<T>) {\n  const replaneRef = useRef<Replane<T>>(undefined as unknown as Replane<T>);\n\n  if (!replaneRef.current) {\n    replaneRef.current = new Replane<T>(options);\n  }\n\n  const connectionJson = connection ? JSON.stringify(connection) : undefined;\n\n  useEffect(() => {\n    const parsedConnection = connectionJson ? JSON.parse(connectionJson) : undefined;\n    if (!parsedConnection) {\n      return;\n    }\n\n    replaneRef.current.connect(parsedConnection).catch((err) => {\n      (options.logger ?? console)?.error(\"Failed to connect Replane client\", err);\n    });\n\n    return () => {\n      replaneRef.current.disconnect();\n    };\n  }, [connectionJson, options.logger]);\n\n  const value = useMemo<ReplaneContextValue<T>>(() => ({ replane: replaneRef.current }), []);\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Internal provider component for options-based client creation (non-suspense).\n * Throws errors during rendering so they can be caught by Error Boundaries.\n */\nfunction LoaderReplaneProvider<T extends object>({\n  children,\n  loader,\n  connection,\n  ...options\n}: ReplaneProviderWithOptionsProps<T> & { connection: ConnectOptions }) {\n  if (!connection) {\n    throw new Error(\"Connection is required when using Loader\");\n  }\n  const state = useReplaneClientInternal<T>(options, connection);\n\n  if (state.status === \"loading\") {\n    return <>{loader ?? null}</>;\n  }\n\n  if (state.status === \"error\") {\n    // Throw error during render so it can be caught by Error Boundary\n    throw state.error;\n  }\n\n  const value: ReplaneContextValue<T> = { replane: state.client };\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Internal provider component for options-based client creation with Suspense.\n */\nfunction SuspenseReplaneProvider<T extends object>({\n  connection,\n  children,\n  ...options\n}: ReplaneProviderWithOptionsProps<T> & { connection: ConnectOptions }) {\n  if (!connection) {\n    throw new Error(\"Connection is required when using Suspense\");\n  }\n  const client = useReplaneClientSuspense<T>(options, connection);\n  const value = useMemo<ReplaneContextValue<T>>(() => ({ replane: client }), [client]);\n  return <ReplaneContext.Provider value={value}>{children}</ReplaneContext.Provider>;\n}\n\n/**\n * Provider component that makes a Replane client available to the component tree.\n *\n * Can be used in several ways:\n *\n * 1. With a pre-created client:\n * ```tsx\n * const client = new Replane({ defaults: { ... } });\n * await client.connect({ baseUrl: '...', sdkKey: '...' });\n * <ReplaneProvider client={client}>\n *   <App />\n * </ReplaneProvider>\n * ```\n *\n * 2. With options (client managed internally):\n * ```tsx\n * <ErrorBoundary fallback={<ErrorMessage />}>\n *   <ReplaneProvider\n *     options={{ baseUrl: '...', sdkKey: '...' }}\n *     loader={<LoadingSpinner />}\n *   >\n *     <App />\n *   </ReplaneProvider>\n * </ErrorBoundary>\n * ```\n *\n * 3. With Suspense:\n * ```tsx\n * <ErrorBoundary fallback={<ErrorMessage />}>\n *   <Suspense fallback={<LoadingSpinner />}>\n *     <ReplaneProvider\n *       options={{ baseUrl: '...', sdkKey: '...' }}\n *       suspense\n *     >\n *       <App />\n *     </ReplaneProvider>\n *   </Suspense>\n * </ErrorBoundary>\n * ```\n *\n * 4. With a snapshot (for SSR/hydration):\n * ```tsx\n * // On the server, get a snapshot from the client\n * const snapshot = serverClient.getSnapshot();\n *\n * // On the client, restore from the snapshot with live updates\n * <ReplaneProvider\n *   options={{ baseUrl: '...', sdkKey: '...' }}\n *   snapshot={snapshot}\n * >\n *   <App />\n * </ReplaneProvider>\n * ```\n *\n * Errors during client initialization are thrown during rendering,\n * allowing them to be caught by React Error Boundaries.\n */\nexport function ReplaneProvider<T extends object>(props: ReplaneProviderProps<T>) {\n  const originalConnection = (props as { connection?: ConnectOptions }).connection;\n  const connection = useMemo(\n    () =>\n      originalConnection\n        ? {\n            ...originalConnection,\n            agent: originalConnection.agent ?? DEFAULT_AGENT,\n          }\n        : undefined,\n    [originalConnection]\n  );\n\n  if (hasClient(props)) {\n    return <ReplaneProviderWithClient {...props} />;\n  }\n\n  if (props.snapshot || !connection || props.async) {\n    return <AsyncReplaneProvider {...props} />;\n  }\n\n  if (props.suspense) {\n    return <SuspenseReplaneProvider {...props} connection={connection} />;\n  }\n\n  return <LoaderReplaneProvider {...props} connection={connection} />;\n}\n","\"use client\";\n\nimport { useCallback, useContext, useSyncExternalStore } from \"react\";\nimport { ReplaneContext } from \"./context\";\nimport type { UntypedReplaneConfig } from \"./types\";\nimport type { Replane, GetConfigOptions } from \"@replanejs/sdk\";\n\nexport function useReplane<T extends object = UntypedReplaneConfig>(): Replane<T> {\n  const context = useContext(ReplaneContext);\n  if (!context) {\n    throw new Error(\"useReplane must be used within a ReplaneProvider\");\n  }\n  return context.replane as Replane<T>;\n}\n\nexport function useConfig<T>(name: string, options?: GetConfigOptions<T>): T {\n  const client = useReplane();\n\n  const subscribe = useCallback(\n    (callback: () => void) => {\n      return client.subscribe(name, callback);\n    },\n    [client, name]\n  );\n\n  const get = useCallback(() => {\n    return client.get(name, options) as T;\n  }, [client, name, options]);\n\n  const value = useSyncExternalStore(subscribe, get, get);\n\n  return value;\n}\n\n/**\n * Creates a typed version of useReplane hook.\n *\n * @example\n * ```tsx\n * interface AppConfigs {\n *   theme: { darkMode: boolean };\n *   features: { beta: boolean };\n * }\n *\n * const useAppReplane = createReplaneHook<AppConfigs>();\n *\n * function MyComponent() {\n *   const replane = useAppReplane();\n *   // replane.get(\"theme\") returns { darkMode: boolean }\n * }\n * ```\n */\nexport function createReplaneHook<TConfigs extends object>() {\n  return function useTypedReplane(): Replane<TConfigs> {\n    return useReplane<TConfigs>();\n  };\n}\n\n/**\n * Creates a typed version of useConfig hook.\n *\n * @example\n * ```tsx\n * interface AppConfigs {\n *   theme: { darkMode: boolean };\n *   features: { beta: boolean };\n * }\n *\n * const useAppConfig = createConfigHook<AppConfigs>();\n *\n * function MyComponent() {\n *   const theme = useAppConfig(\"theme\");\n *   // theme is typed as { darkMode: boolean }\n * }\n * ```\n */\nexport function createConfigHook<TConfigs extends object>() {\n  return function useTypedConfig<K extends keyof TConfigs>(\n    name: K,\n    options?: GetConfigOptions<TConfigs[K]>\n  ): TConfigs[K] {\n    return useConfig<TConfigs[K]>(String(name), options);\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@replanejs/react",
-  "version": "0.8.20",
+  "version": "0.9.2",
   "description": "React SDK for Replane - feature flags and remote configuration",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -40,7 +40,7 @@
     "react": ">=18.0.0"
   },
   "dependencies": {
-    "@replanejs/sdk": "^0.8.20"
+    "@replanejs/sdk": "^0.9.2"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",