@vira-ui/react 1.0.1 → 1.1.0

package/README.md

@@ -0,0 +1,65 @@
+# @vira-ui/react
+
+React-хуки для работы с Vira Reactive Protocol (VRP). Синхронизация состояния между клиентом и сервером через WebSocket.
+
+## Зачем нужен
+
+Пакет предоставляет простой способ подключения React-компонентов к серверу через WebSocket:
+
+- **Автоматическая синхронизация** — состояние обновляется при изменениях на сервере
+- **Двусторонняя связь** — можно отправлять события и обновления на сервер
+- **Diff-патчи** — обновляются только изменённые части данных
+- **Переподключение** — автоматическое восстановление соединения
+
+## Основные возможности
+
+### useViraState
+
+Подключается к каналу и синхронизирует состояние:
+
+```tsx
+import { useViraState } from '@vira-ui/react';
+
+function UserProfile({ userId }: { userId: string }) {
+  const { data, sendUpdate, sendDiff, isConnected } = useViraState<User>(
+    `user:${userId}`,
+    {
+      initial: { name: 'Guest' },
+      onOpen: () => console.log('Connected'),
+      deepMerge: true
+    }
+  );
+
+  if (!isConnected) return <div>Connecting...</div>;
+  if (!data) return <div>Loading...</div>;
+
+  return (
+    <div>
+      <h1>{data.name}</h1>
+      <button onClick={() => sendDiff({ name: 'New Name' })}>
+        Update Name
+      </button>
+    </div>
+  );
+}
+```
+
+### Отправка данных
+
+- `sendUpdate(payload)` — полная замена состояния
+- `sendDiff(patch)` — частичное обновление (merge)
+- `sendEvent(name, payload)` — отправка события
+
+### Опции
+
+- `initial` — начальное значение
+- `apiUrl` — URL сервера (по умолчанию из `VITE_API_URL`)
+- `authToken` — токен авторизации
+- `deepMerge` — глубокое слияние для diff-патчей
+- `enableMsgId` — поддержка idempotency
+- `onOpen`, `onClose`, `onError` — колбэки событий соединения
+
+## Использование
+
+Требует сервер с поддержкой Vira Reactive Protocol. Обычно используется вместе с `@vira-ui/core` и `@vira-ui/bindings-react`.
+

package/dist/index.d.mts

@@ -15,6 +15,10 @@ interface UseViraStateOptions<T = any> {
     apiUrl?: string;
     /** Auth token for handshake */
     authToken?: string;
+    /** Disable connection pooling (fallback to 1 WS per channel). Default: false */
+    disablePooling?: boolean;
+    /** Enable debug logs for VRP (console.debug). Default: env VITE_VRP_DEBUG === 'true' */
+    debug?: boolean;
 }
 /**
  * Unified hook for Vira Reactive Protocol state management.

package/dist/index.d.ts

@@ -15,6 +15,10 @@ interface UseViraStateOptions<T = any> {
     apiUrl?: string;
     /** Auth token for handshake */
     authToken?: string;
+    /** Disable connection pooling (fallback to 1 WS per channel). Default: false */
+    disablePooling?: boolean;
+    /** Enable debug logs for VRP (console.debug). Default: env VITE_VRP_DEBUG === 'true' */
+    debug?: boolean;
 }
 /**
  * Unified hook for Vira Reactive Protocol state management.

package/dist/index.js

@@ -33,7 +33,7 @@ function useViraState(channel, initialOrOptions) {
     if (initialOrOptions === null || initialOrOptions === void 0) {
       return {};
     }
-    if (typeof initialOrOptions === "object" && !Array.isArray(initialOrOptions) && ("enableMsgId" in initialOrOptions || "onOpen" in initialOrOptions || "onClose" in initialOrOptions || "onError" in initialOrOptions || "deepMerge" in initialOrOptions || "initial" in initialOrOptions || "apiUrl" in initialOrOptions || "authToken" in initialOrOptions)) {
+    if (typeof initialOrOptions === "object" && !Array.isArray(initialOrOptions) && ("enableMsgId" in initialOrOptions || "onOpen" in initialOrOptions || "onClose" in initialOrOptions || "onError" in initialOrOptions || "deepMerge" in initialOrOptions || "initial" in initialOrOptions || "apiUrl" in initialOrOptions || "authToken" in initialOrOptions || "disablePooling" in initialOrOptions || "debug" in initialOrOptions)) {
       return initialOrOptions;
     }
     return { initial: initialOrOptions };
@@ -46,14 +46,19 @@ function useViraState(channel, initialOrOptions) {
     onError,
     deepMerge: useDeepMerge = true,
     apiUrl: apiUrlOption,
-    authToken: authTokenOption
+    authToken: authTokenOption,
+    disablePooling = false,
+    debug: debugOption
   } = options;
   const [data, setData] = (0, import_react.useState)(initial);
   const [isConnected, setIsConnected] = (0, import_react.useState)(false);
   const [error, setError] = (0, import_react.useState)(null);
+  const transportRef = (0, import_react.useRef)(null);
   const clientRef = (0, import_react.useRef)(null);
   const sessionRef = (0, import_react.useRef)(null);
   const msgIdCounterRef = (0, import_react.useRef)(0);
+  const wasConnectedRef = (0, import_react.useRef)(false);
+  const lastErrorRef = (0, import_react.useRef)(null);
   const apiUrl = (0, import_react.useMemo)(() => {
     if (apiUrlOption) return apiUrlOption;
     try {
@@ -72,6 +77,19 @@ function useViraState(channel, initialOrOptions) {
       return "";
     }
   }, [authTokenOption]);
+  const debug = (0, import_react.useMemo)(() => {
+    if (debugOption !== void 0) return Boolean(debugOption);
+    try {
+      const env = globalThis.import?.meta?.env || globalThis.process?.env;
+      return String(env?.VITE_VRP_DEBUG || "").toLowerCase() === "true";
+    } catch {
+      return false;
+    }
+  }, [debugOption]);
+  const pool = (0, import_react.useMemo)(() => {
+    if (disablePooling) return null;
+    return (0, import_core.getViraConnectionPool)({ url: apiUrl, authToken, debug });
+  }, [disablePooling, apiUrl, authToken, debug]);
   (0, import_react.useEffect)(() => {
     if (!channel) return;
     const handleMessage = (msg) => {
@@ -101,6 +119,42 @@ function useViraState(channel, initialOrOptions) {
           break;
       }
     };
+    if (pool) {
+      const unsubChannel = pool.subscribe(channel, handleMessage);
+      const unsubStatus = pool.onStatus((status) => {
+        setError(status.error);
+        setIsConnected(status.connected);
+        if (status.connected && !wasConnectedRef.current) {
+          wasConnectedRef.current = true;
+          onOpen?.();
+        }
+        if (!status.connected && wasConnectedRef.current) {
+          wasConnectedRef.current = false;
+          const synthetic = typeof CloseEvent !== "undefined" ? new CloseEvent("close", { code: 1001, reason: "pooled disconnect" }) : { code: 1001, reason: "pooled disconnect" };
+          onClose?.(synthetic);
+        }
+        if (status.error) {
+          if (lastErrorRef.current !== status.error) {
+            lastErrorRef.current = status.error;
+            onError?.(status.error);
+          }
+        } else {
+          lastErrorRef.current = null;
+        }
+      });
+      transportRef.current = {
+        sendEvent: (name, payload, msgId) => pool.sendEvent(channel, name, payload, msgId),
+        sendUpdate: (payload, msgId) => pool.sendUpdate(channel, payload, msgId),
+        sendDiff: (patch, msgId) => pool.sendDiff(channel, patch, msgId)
+      };
+      return () => {
+        unsubStatus();
+        unsubChannel();
+        transportRef.current = null;
+        setIsConnected(false);
+        setError(null);
+      };
+    }
     const handleConnect = () => {
       setIsConnected(true);
       setError(null);
@@ -128,13 +182,19 @@ function useViraState(channel, initialOrOptions) {
       }
     });
     clientRef.current = client;
+    transportRef.current = {
+      sendEvent: (name, payload, msgId) => client.sendEvent(name, payload, msgId),
+      sendUpdate: (payload, msgId) => client.sendUpdate(payload, msgId),
+      sendDiff: (patch, msgId) => client.sendDiff(patch, msgId)
+    };
     return () => {
       client.close();
       clientRef.current = null;
+      transportRef.current = null;
       setIsConnected(false);
       setError(null);
     };
-  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge]);
+  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge, pool]);
   const generateMsgId = (0, import_react.useCallback)(() => {
     if (!enableMsgId) return void 0;
     msgIdCounterRef.current++;
@@ -142,19 +202,19 @@ function useViraState(channel, initialOrOptions) {
   }, [channel, enableMsgId]);
   const sendEvent = (0, import_react.useCallback)(
     (name, payload, msgId) => {
-      clientRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());
+      transportRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());
     },
     [generateMsgId]
   );
   const sendUpdate = (0, import_react.useCallback)(
     (payload, msgId) => {
-      clientRef.current?.sendUpdate(payload, msgId ?? generateMsgId());
+      transportRef.current?.sendUpdate(payload, msgId ?? generateMsgId());
     },
     [generateMsgId]
   );
   const sendDiff = (0, import_react.useCallback)(
     (patch, msgId) => {
-      clientRef.current?.sendDiff(patch, msgId ?? generateMsgId());
+      transportRef.current?.sendDiff(patch, msgId ?? generateMsgId());
     },
     [generateMsgId]
   );

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/useViraState.ts"],"sourcesContent":["/**\r\n * @vira-ui/react\r\n * \r\n * Vira Framework - React hooks for Vira Reactive Protocol\r\n * \r\n * This package provides React hooks for VRP, built on top of @vira-ui/core.\r\n */\r\n\r\nexport {\r\n  useViraState,\r\n  useViraStream,\r\n} from './useViraState';\r\nexport type {\r\n  UseViraStateOptions,\r\n} from './useViraState';\r\n\r\n","import { useEffect, useMemo, useRef, useState, useCallback } from 'react';\r\nimport { createViraClient, deepMerge, type ViraClient, type Message } from '@vira-ui/core';\r\n\r\nexport interface UseViraStateOptions<T = any> {\r\n  /** Initial value for the state */\r\n  initial?: T | null;\r\n  /** Enable msgId support for idempotency */\r\n  enableMsgId?: boolean;\r\n  /** Callback when connection opens */\r\n  onOpen?: () => void;\r\n  /** Callback when connection closes */\r\n  onClose?: (event: CloseEvent) => void;\r\n  /** Callback when connection error occurs */\r\n  onError?: (error: Error) => void;\r\n  /** Use deep merge for diff patches (default: true) */\r\n  deepMerge?: boolean;\r\n  /** API URL (defaults to VITE_API_URL env or 'http://localhost:8080') */\r\n  apiUrl?: string;\r\n  /** Auth token for handshake */\r\n  authToken?: string;\r\n}\r\n\r\n/**\r\n * Unified hook for Vira Reactive Protocol state management.\r\n * Replaces both useViraState and useViraStream.\r\n *\r\n * @example\r\n * ```tsx\r\n * // Basic usage\r\n * const { data, sendUpdate } = useViraState<MyType>('my-channel');\r\n *\r\n * // With options\r\n * const { data, sendUpdate, sendDiff } = useViraState<User>('user:123', {\r\n *   initial: { name: 'Guest' },\r\n *   enableMsgId: true,\r\n *   onOpen: () => console.log('Connected'),\r\n *   deepMerge: true\r\n * });\r\n * ```\r\n */\r\nexport function useViraState<T = any, C extends string = string>(\r\n  channel: C,\r\n  initialOrOptions?: T | null | UseViraStateOptions<T>\r\n): {\r\n  /** Current state data */\r\n  data: T | null;\r\n  /** Send an event to the server */\r\n  sendEvent: (name: string, payload: any, msgId?: string) => void;\r\n  /** Send a full update (replaces state) */\r\n  sendUpdate: (payload: T, msgId?: string) => void;\r\n  /** Send a partial diff (merges with current state) */\r\n  sendDiff: (patch: Partial<T>, msgId?: string) => void;\r\n  /** Connection status */\r\n  isConnected: boolean;\r\n  /** Connection error, if any */\r\n  error: Error | null;\r\n} {\r\n  // Parse options (backward compatibility: second param can be initial value or options)\r\n  const options: UseViraStateOptions<T> = useMemo(() => {\r\n    if (initialOrOptions === null || initialOrOptions === undefined) {\r\n      return {};\r\n    }\r\n    // If it's an object with known option keys, treat as options\r\n    if (\r\n      typeof initialOrOptions === 'object' &&\r\n      !Array.isArray(initialOrOptions) &&\r\n      ('enableMsgId' in initialOrOptions ||\r\n        'onOpen' in initialOrOptions ||\r\n        'onClose' in initialOrOptions ||\r\n        'onError' in initialOrOptions ||\r\n        'deepMerge' in initialOrOptions ||\r\n        'initial' in initialOrOptions ||\r\n        'apiUrl' in initialOrOptions ||\r\n        'authToken' in initialOrOptions)\r\n    ) {\r\n      return initialOrOptions as UseViraStateOptions<T>;\r\n    }\r\n    // Otherwise, treat as initial value (backward compatibility)\r\n    return { initial: initialOrOptions as T | null };\r\n  }, [initialOrOptions]);\r\n\r\n  const {\r\n    initial = null,\r\n    enableMsgId = false,\r\n    onOpen,\r\n    onClose,\r\n    onError,\r\n    deepMerge: useDeepMerge = true,\r\n    apiUrl: apiUrlOption,\r\n    authToken: authTokenOption,\r\n  } = options;\r\n\r\n  const [data, setData] = useState<T | null>(initial);\r\n  const [isConnected, setIsConnected] = useState(false);\r\n  const [error, setError] = useState<Error | null>(null);\r\n  const clientRef = useRef<ViraClient | null>(null);\r\n  const sessionRef = useRef<string | null>(null);\r\n  const msgIdCounterRef = useRef(0);\r\n\r\n  // Use provided apiUrl or fallback to env or default\r\n  // Note: import.meta is only available in ESM, so we check safely\r\n  const apiUrl = useMemo(() => {\r\n    if (apiUrlOption) return apiUrlOption;\r\n    // Try to get from env if available (Vite/bundler environment)\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      if (env?.VITE_API_URL) return env.VITE_API_URL;\r\n    } catch {\r\n      // Ignore if import.meta is not available\r\n    }\r\n    return 'http://localhost:8080';\r\n  }, [apiUrlOption]);\r\n\r\n  // Get authToken from options or try to get from env\r\n  const authToken = useMemo(() => {\r\n    if (authTokenOption !== undefined) return authTokenOption;\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      return env?.VITE_AUTH_TOKEN || '';\r\n    } catch {\r\n      return '';\r\n    }\r\n  }, [authTokenOption]);\r\n\r\n  useEffect(() => {\r\n    if (!channel) return;\r\n\r\n    const handleMessage = (msg: Message) => {\r\n      switch (msg.type) {\r\n        case 'update':\r\n        case 'event':\r\n          if (msg.channel === channel) {\r\n            setData(msg.data as T);\r\n          }\r\n          break;\r\n\r\n        case 'diff':\r\n          if (msg.channel === channel) {\r\n            setData((prev) => {\r\n              if (!prev) {\r\n                return (msg.patch as T) || null;\r\n              }\r\n\r\n              // For objects, merge the patch\r\n              if (typeof prev === 'object' && typeof msg.patch === 'object') {\r\n                if (useDeepMerge) {\r\n                  // Deep merge preserves nested structures\r\n                  return deepMerge(prev as Record<string, any>, msg.patch as Partial<T>) as T;\r\n                } else {\r\n                  // Shallow merge (backward compatible)\r\n                  return { ...(prev as any), ...(msg.patch as any) };\r\n                }\r\n              }\r\n\r\n              // For primitives, replace entirely\r\n              return (msg.patch as T) || prev;\r\n            });\r\n          }\r\n          break;\r\n      }\r\n    };\r\n\r\n    const handleConnect = () => {\r\n      setIsConnected(true);\r\n      setError(null);\r\n      onOpen?.();\r\n    };\r\n\r\n    const handleDisconnect = (event?: CloseEvent) => {\r\n      setIsConnected(false);\r\n      onClose?.(event!);\r\n    };\r\n\r\n    const handleError = (err: Error) => {\r\n      setError(err);\r\n      onError?.(err);\r\n    };\r\n\r\n    const client = createViraClient({\r\n      url: apiUrl,\r\n      channel,\r\n      onMessage: handleMessage,\r\n      onConnect: handleConnect,\r\n      onDisconnect: handleDisconnect,\r\n      onError: handleError,\r\n      session: sessionRef.current,\r\n      authToken,\r\n      onSessionChange: (newSession) => {\r\n        sessionRef.current = newSession;\r\n      },\r\n    });\r\n\r\n    clientRef.current = client;\r\n\r\n    return () => {\r\n      client.close();\r\n      clientRef.current = null;\r\n      setIsConnected(false);\r\n      setError(null);\r\n    };\r\n  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge]);\r\n\r\n  // Generate msgId if enabled\r\n  const generateMsgId = useCallback((): string | undefined => {\r\n    if (!enableMsgId) return undefined;\r\n    msgIdCounterRef.current++;\r\n    return `${channel}:${Date.now()}:${msgIdCounterRef.current}`;\r\n  }, [channel, enableMsgId]);\r\n\r\n  const sendEvent = useCallback(\r\n    (name: string, payload: any, msgId?: string) => {\r\n      clientRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendUpdate = useCallback(\r\n    (payload: T, msgId?: string) => {\r\n      clientRef.current?.sendUpdate(payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendDiff = useCallback(\r\n    (patch: Partial<T>, msgId?: string) => {\r\n      clientRef.current?.sendDiff(patch, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  return {\r\n    data,\r\n    sendEvent,\r\n    sendUpdate,\r\n    sendDiff,\r\n    isConnected,\r\n    error,\r\n  };\r\n}\r\n\r\n/**\r\n * Legacy hook - use useViraState instead.\r\n * @deprecated Use useViraState with options instead\r\n */\r\nexport function useViraStream<T = any, C extends string = string>(\r\n  channel: C,\r\n  options?: UseViraStateOptions<T>\r\n) {\r\n  return useViraState<T, C>(channel, { ...options, initial: null });\r\n}\r\n\r\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/useViraState.ts"],"sourcesContent":["/**\r\n * @vira-ui/react\r\n * \r\n * Vira Framework - React hooks for Vira Reactive Protocol\r\n * \r\n * This package provides React hooks for VRP, built on top of @vira-ui/core.\r\n */\r\n\r\nexport {\r\n  useViraState,\r\n  useViraStream,\r\n} from './useViraState';\r\nexport type {\r\n  UseViraStateOptions,\r\n} from './useViraState';\r\n\r\n","import { useEffect, useMemo, useRef, useState, useCallback } from 'react';\r\nimport {\r\n  createViraClient,\r\n  deepMerge,\r\n  getViraConnectionPool,\r\n  type ViraClient,\r\n  type Message,\r\n  type ViraConnectionPool,\r\n} from '@vira-ui/core';\r\n\r\nexport interface UseViraStateOptions<T = any> {\r\n  /** Initial value for the state */\r\n  initial?: T | null;\r\n  /** Enable msgId support for idempotency */\r\n  enableMsgId?: boolean;\r\n  /** Callback when connection opens */\r\n  onOpen?: () => void;\r\n  /** Callback when connection closes */\r\n  onClose?: (event: CloseEvent) => void;\r\n  /** Callback when connection error occurs */\r\n  onError?: (error: Error) => void;\r\n  /** Use deep merge for diff patches (default: true) */\r\n  deepMerge?: boolean;\r\n  /** API URL (defaults to VITE_API_URL env or 'http://localhost:8080') */\r\n  apiUrl?: string;\r\n  /** Auth token for handshake */\r\n  authToken?: string;\r\n  /** Disable connection pooling (fallback to 1 WS per channel). Default: false */\r\n  disablePooling?: boolean;\r\n  /** Enable debug logs for VRP (console.debug). Default: env VITE_VRP_DEBUG === 'true' */\r\n  debug?: boolean;\r\n}\r\n\r\n/**\r\n * Unified hook for Vira Reactive Protocol state management.\r\n * Replaces both useViraState and useViraStream.\r\n *\r\n * @example\r\n * ```tsx\r\n * // Basic usage\r\n * const { data, sendUpdate } = useViraState<MyType>('my-channel');\r\n *\r\n * // With options\r\n * const { data, sendUpdate, sendDiff } = useViraState<User>('user:123', {\r\n *   initial: { name: 'Guest' },\r\n *   enableMsgId: true,\r\n *   onOpen: () => console.log('Connected'),\r\n *   deepMerge: true\r\n * });\r\n * ```\r\n */\r\nexport function useViraState<T = any, C extends string = string>(\r\n  channel: C,\r\n  initialOrOptions?: T | null | UseViraStateOptions<T>\r\n): {\r\n  /** Current state data */\r\n  data: T | null;\r\n  /** Send an event to the server */\r\n  sendEvent: (name: string, payload: any, msgId?: string) => void;\r\n  /** Send a full update (replaces state) */\r\n  sendUpdate: (payload: T, msgId?: string) => void;\r\n  /** Send a partial diff (merges with current state) */\r\n  sendDiff: (patch: Partial<T>, msgId?: string) => void;\r\n  /** Connection status */\r\n  isConnected: boolean;\r\n  /** Connection error, if any */\r\n  error: Error | null;\r\n} {\r\n  // Parse options (backward compatibility: second param can be initial value or options)\r\n  const options: UseViraStateOptions<T> = useMemo(() => {\r\n    if (initialOrOptions === null || initialOrOptions === undefined) {\r\n      return {};\r\n    }\r\n    // If it's an object with known option keys, treat as options\r\n    if (\r\n      typeof initialOrOptions === 'object' &&\r\n      !Array.isArray(initialOrOptions) &&\r\n      ('enableMsgId' in initialOrOptions ||\r\n        'onOpen' in initialOrOptions ||\r\n        'onClose' in initialOrOptions ||\r\n        'onError' in initialOrOptions ||\r\n        'deepMerge' in initialOrOptions ||\r\n        'initial' in initialOrOptions ||\r\n        'apiUrl' in initialOrOptions ||\r\n        'authToken' in initialOrOptions ||\r\n        'disablePooling' in initialOrOptions ||\r\n        'debug' in initialOrOptions)\r\n    ) {\r\n      return initialOrOptions as UseViraStateOptions<T>;\r\n    }\r\n    // Otherwise, treat as initial value (backward compatibility)\r\n    return { initial: initialOrOptions as T | null };\r\n  }, [initialOrOptions]);\r\n\r\n  const {\r\n    initial = null,\r\n    enableMsgId = false,\r\n    onOpen,\r\n    onClose,\r\n    onError,\r\n    deepMerge: useDeepMerge = true,\r\n    apiUrl: apiUrlOption,\r\n    authToken: authTokenOption,\r\n    disablePooling = false,\r\n    debug: debugOption,\r\n  } = options;\r\n\r\n  const [data, setData] = useState<T | null>(initial);\r\n  const [isConnected, setIsConnected] = useState(false);\r\n  const [error, setError] = useState<Error | null>(null);\r\n\r\n  type Transport = {\r\n    sendEvent: (name: string, payload: any, msgId?: string) => void;\r\n    sendUpdate: (payload: T, msgId?: string) => void;\r\n    sendDiff: (patch: Partial<T>, msgId?: string) => void;\r\n  };\r\n\r\n  const transportRef = useRef<Transport | null>(null);\r\n  const clientRef = useRef<ViraClient | null>(null); // legacy non-pooled mode only\r\n  const sessionRef = useRef<string | null>(null);\r\n  const msgIdCounterRef = useRef(0);\r\n  const wasConnectedRef = useRef(false);\r\n  const lastErrorRef = useRef<Error | null>(null);\r\n\r\n  // Use provided apiUrl or fallback to env or default\r\n  // Note: import.meta is only available in ESM, so we check safely\r\n  const apiUrl = useMemo(() => {\r\n    if (apiUrlOption) return apiUrlOption;\r\n    // Try to get from env if available (Vite/bundler environment)\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      if (env?.VITE_API_URL) return env.VITE_API_URL;\r\n    } catch {\r\n      // Ignore if import.meta is not available\r\n    }\r\n    return 'http://localhost:8080';\r\n  }, [apiUrlOption]);\r\n\r\n  // Get authToken from options or try to get from env\r\n  const authToken = useMemo(() => {\r\n    if (authTokenOption !== undefined) return authTokenOption;\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      return env?.VITE_AUTH_TOKEN || '';\r\n    } catch {\r\n      return '';\r\n    }\r\n  }, [authTokenOption]);\r\n\r\n  const debug = useMemo(() => {\r\n    if (debugOption !== undefined) return Boolean(debugOption);\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      return String(env?.VITE_VRP_DEBUG || '').toLowerCase() === 'true';\r\n    } catch {\r\n      return false;\r\n    }\r\n  }, [debugOption]);\r\n\r\n  const pool: ViraConnectionPool | null = useMemo(() => {\r\n    if (disablePooling) return null;\r\n    return getViraConnectionPool({ url: apiUrl, authToken, debug });\r\n  }, [disablePooling, apiUrl, authToken, debug]);\r\n\r\n  useEffect(() => {\r\n    if (!channel) return;\r\n\r\n    const handleMessage = (msg: Message) => {\r\n      switch (msg.type) {\r\n        case 'update':\r\n        case 'event':\r\n          if (msg.channel === channel) {\r\n            setData(msg.data as T);\r\n          }\r\n          break;\r\n\r\n        case 'diff':\r\n          if (msg.channel === channel) {\r\n            setData((prev) => {\r\n              if (!prev) {\r\n                return (msg.patch as T) || null;\r\n              }\r\n\r\n              // For objects, merge the patch\r\n              if (typeof prev === 'object' && typeof msg.patch === 'object') {\r\n                if (useDeepMerge) {\r\n                  // Deep merge preserves nested structures\r\n                  return deepMerge(prev as Record<string, any>, msg.patch as Partial<T>) as T;\r\n                } else {\r\n                  // Shallow merge (backward compatible)\r\n                  return { ...(prev as any), ...(msg.patch as any) };\r\n                }\r\n              }\r\n\r\n              // For primitives, replace entirely\r\n              return (msg.patch as T) || prev;\r\n            });\r\n          }\r\n          break;\r\n      }\r\n    };\r\n\r\n    // --- Pooled mode (default) ---\r\n    if (pool) {\r\n      // Subscribe to messages for this channel\r\n      const unsubChannel = pool.subscribe(channel, handleMessage);\r\n\r\n      // Track shared connection status\r\n      const unsubStatus = pool.onStatus((status) => {\r\n        setError(status.error);\r\n        setIsConnected(status.connected);\r\n\r\n        // Fire callbacks only on transitions\r\n        if (status.connected && !wasConnectedRef.current) {\r\n          wasConnectedRef.current = true;\r\n          onOpen?.();\r\n        }\r\n        if (!status.connected && wasConnectedRef.current) {\r\n          wasConnectedRef.current = false;\r\n          // We don't get a real CloseEvent from pooled status, so we pass a lightweight synthetic object\r\n          const synthetic = (typeof CloseEvent !== 'undefined'\r\n            ? new CloseEvent('close', { code: 1001, reason: 'pooled disconnect' })\r\n            : ({ code: 1001, reason: 'pooled disconnect' } as any)) as any;\r\n          onClose?.(synthetic);\r\n        }\r\n        if (status.error) {\r\n          if (lastErrorRef.current !== status.error) {\r\n            lastErrorRef.current = status.error;\r\n            onError?.(status.error);\r\n          }\r\n        } else {\r\n          lastErrorRef.current = null;\r\n        }\r\n      });\r\n\r\n      // Wire transport for send* APIs\r\n      transportRef.current = {\r\n        sendEvent: (name, payload, msgId) => pool.sendEvent(channel, name, payload, msgId),\r\n        sendUpdate: (payload, msgId) => pool.sendUpdate(channel, payload, msgId),\r\n        sendDiff: (patch, msgId) => pool.sendDiff(channel, patch, msgId),\r\n      };\r\n\r\n      return () => {\r\n        unsubStatus();\r\n        unsubChannel();\r\n        transportRef.current = null;\r\n        setIsConnected(false);\r\n        setError(null);\r\n      };\r\n    }\r\n\r\n    // --- Legacy mode (1 WS per channel) ---\r\n    const handleConnect = () => {\r\n      setIsConnected(true);\r\n      setError(null);\r\n      onOpen?.();\r\n    };\r\n\r\n    const handleDisconnect = (event?: CloseEvent) => {\r\n      setIsConnected(false);\r\n      onClose?.(event!);\r\n    };\r\n\r\n    const handleError = (err: Error) => {\r\n      setError(err);\r\n      onError?.(err);\r\n    };\r\n\r\n    const client = createViraClient({\r\n      url: apiUrl,\r\n      channel,\r\n      onMessage: handleMessage,\r\n      onConnect: handleConnect,\r\n      onDisconnect: handleDisconnect,\r\n      onError: handleError,\r\n      session: sessionRef.current,\r\n      authToken,\r\n      onSessionChange: (newSession) => {\r\n        sessionRef.current = newSession;\r\n      },\r\n    });\r\n\r\n    clientRef.current = client;\r\n    transportRef.current = {\r\n      sendEvent: (name, payload, msgId) => client.sendEvent(name, payload, msgId),\r\n      sendUpdate: (payload, msgId) => client.sendUpdate(payload, msgId),\r\n      sendDiff: (patch, msgId) => client.sendDiff(patch, msgId),\r\n    };\r\n\r\n    return () => {\r\n      client.close();\r\n      clientRef.current = null;\r\n      transportRef.current = null;\r\n      setIsConnected(false);\r\n      setError(null);\r\n    };\r\n  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge, pool]);\r\n\r\n  // Generate msgId if enabled\r\n  const generateMsgId = useCallback((): string | undefined => {\r\n    if (!enableMsgId) return undefined;\r\n    msgIdCounterRef.current++;\r\n    return `${channel}:${Date.now()}:${msgIdCounterRef.current}`;\r\n  }, [channel, enableMsgId]);\r\n\r\n  const sendEvent = useCallback(\r\n    (name: string, payload: any, msgId?: string) => {\r\n      transportRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendUpdate = useCallback(\r\n    (payload: T, msgId?: string) => {\r\n      transportRef.current?.sendUpdate(payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendDiff = useCallback(\r\n    (patch: Partial<T>, msgId?: string) => {\r\n      transportRef.current?.sendDiff(patch, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  return {\r\n    data,\r\n    sendEvent,\r\n    sendUpdate,\r\n    sendDiff,\r\n    isConnected,\r\n    error,\r\n  };\r\n}\r\n\r\n/**\r\n * Legacy hook - use useViraState instead.\r\n * @deprecated Use useViraState with options instead\r\n */\r\nexport function useViraStream<T = any, C extends string = string>(\r\n  channel: C,\r\n  options?: UseViraStateOptions<T>\r\n) {\r\n  return useViraState<T, C>(channel, { ...options, initial: null });\r\n}\r\n\r\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -1,12 +1,16 @@
 // src/useViraState.ts
 import { useEffect, useMemo, useRef, useState, useCallback } from "react";
-import { createViraClient, deepMerge } from "@vira-ui/core";
+import {
+  createViraClient,
+  deepMerge,
+  getViraConnectionPool
+} from "@vira-ui/core";
 function useViraState(channel, initialOrOptions) {
   const options = useMemo(() => {
     if (initialOrOptions === null || initialOrOptions === void 0) {
       return {};
     }
-    if (typeof initialOrOptions === "object" && !Array.isArray(initialOrOptions) && ("enableMsgId" in initialOrOptions || "onOpen" in initialOrOptions || "onClose" in initialOrOptions || "onError" in initialOrOptions || "deepMerge" in initialOrOptions || "initial" in initialOrOptions || "apiUrl" in initialOrOptions || "authToken" in initialOrOptions)) {
+    if (typeof initialOrOptions === "object" && !Array.isArray(initialOrOptions) && ("enableMsgId" in initialOrOptions || "onOpen" in initialOrOptions || "onClose" in initialOrOptions || "onError" in initialOrOptions || "deepMerge" in initialOrOptions || "initial" in initialOrOptions || "apiUrl" in initialOrOptions || "authToken" in initialOrOptions || "disablePooling" in initialOrOptions || "debug" in initialOrOptions)) {
       return initialOrOptions;
     }
     return { initial: initialOrOptions };
@@ -19,14 +23,19 @@ function useViraState(channel, initialOrOptions) {
     onError,
     deepMerge: useDeepMerge = true,
     apiUrl: apiUrlOption,
-    authToken: authTokenOption
+    authToken: authTokenOption,
+    disablePooling = false,
+    debug: debugOption
   } = options;
   const [data, setData] = useState(initial);
   const [isConnected, setIsConnected] = useState(false);
   const [error, setError] = useState(null);
+  const transportRef = useRef(null);
   const clientRef = useRef(null);
   const sessionRef = useRef(null);
   const msgIdCounterRef = useRef(0);
+  const wasConnectedRef = useRef(false);
+  const lastErrorRef = useRef(null);
   const apiUrl = useMemo(() => {
     if (apiUrlOption) return apiUrlOption;
     try {
@@ -45,6 +54,19 @@ function useViraState(channel, initialOrOptions) {
       return "";
     }
   }, [authTokenOption]);
+  const debug = useMemo(() => {
+    if (debugOption !== void 0) return Boolean(debugOption);
+    try {
+      const env = globalThis.import?.meta?.env || globalThis.process?.env;
+      return String(env?.VITE_VRP_DEBUG || "").toLowerCase() === "true";
+    } catch {
+      return false;
+    }
+  }, [debugOption]);
+  const pool = useMemo(() => {
+    if (disablePooling) return null;
+    return getViraConnectionPool({ url: apiUrl, authToken, debug });
+  }, [disablePooling, apiUrl, authToken, debug]);
   useEffect(() => {
     if (!channel) return;
     const handleMessage = (msg) => {
@@ -74,6 +96,42 @@ function useViraState(channel, initialOrOptions) {
           break;
       }
     };
+    if (pool) {
+      const unsubChannel = pool.subscribe(channel, handleMessage);
+      const unsubStatus = pool.onStatus((status) => {
+        setError(status.error);
+        setIsConnected(status.connected);
+        if (status.connected && !wasConnectedRef.current) {
+          wasConnectedRef.current = true;
+          onOpen?.();
+        }
+        if (!status.connected && wasConnectedRef.current) {
+          wasConnectedRef.current = false;
+          const synthetic = typeof CloseEvent !== "undefined" ? new CloseEvent("close", { code: 1001, reason: "pooled disconnect" }) : { code: 1001, reason: "pooled disconnect" };
+          onClose?.(synthetic);
+        }
+        if (status.error) {
+          if (lastErrorRef.current !== status.error) {
+            lastErrorRef.current = status.error;
+            onError?.(status.error);
+          }
+        } else {
+          lastErrorRef.current = null;
+        }
+      });
+      transportRef.current = {
+        sendEvent: (name, payload, msgId) => pool.sendEvent(channel, name, payload, msgId),
+        sendUpdate: (payload, msgId) => pool.sendUpdate(channel, payload, msgId),
+        sendDiff: (patch, msgId) => pool.sendDiff(channel, patch, msgId)
+      };
+      return () => {
+        unsubStatus();
+        unsubChannel();
+        transportRef.current = null;
+        setIsConnected(false);
+        setError(null);
+      };
+    }
     const handleConnect = () => {
       setIsConnected(true);
       setError(null);
@@ -101,13 +159,19 @@ function useViraState(channel, initialOrOptions) {
       }
     });
     clientRef.current = client;
+    transportRef.current = {
+      sendEvent: (name, payload, msgId) => client.sendEvent(name, payload, msgId),
+      sendUpdate: (payload, msgId) => client.sendUpdate(payload, msgId),
+      sendDiff: (patch, msgId) => client.sendDiff(patch, msgId)
+    };
     return () => {
       client.close();
       clientRef.current = null;
+      transportRef.current = null;
       setIsConnected(false);
       setError(null);
     };
-  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge]);
+  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge, pool]);
   const generateMsgId = useCallback(() => {
     if (!enableMsgId) return void 0;
     msgIdCounterRef.current++;
@@ -115,19 +179,19 @@ function useViraState(channel, initialOrOptions) {
   }, [channel, enableMsgId]);
   const sendEvent = useCallback(
     (name, payload, msgId) => {
-      clientRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());
+      transportRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());
     },
     [generateMsgId]
   );
   const sendUpdate = useCallback(
     (payload, msgId) => {
-      clientRef.current?.sendUpdate(payload, msgId ?? generateMsgId());
+      transportRef.current?.sendUpdate(payload, msgId ?? generateMsgId());
     },
     [generateMsgId]
   );
   const sendDiff = useCallback(
     (patch, msgId) => {
-      clientRef.current?.sendDiff(patch, msgId ?? generateMsgId());
+      transportRef.current?.sendDiff(patch, msgId ?? generateMsgId());
     },
     [generateMsgId]
   );

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useViraState.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState, useCallback } from 'react';\r\nimport { createViraClient, deepMerge, type ViraClient, type Message } from '@vira-ui/core';\r\n\r\nexport interface UseViraStateOptions<T = any> {\r\n  /** Initial value for the state */\r\n  initial?: T | null;\r\n  /** Enable msgId support for idempotency */\r\n  enableMsgId?: boolean;\r\n  /** Callback when connection opens */\r\n  onOpen?: () => void;\r\n  /** Callback when connection closes */\r\n  onClose?: (event: CloseEvent) => void;\r\n  /** Callback when connection error occurs */\r\n  onError?: (error: Error) => void;\r\n  /** Use deep merge for diff patches (default: true) */\r\n  deepMerge?: boolean;\r\n  /** API URL (defaults to VITE_API_URL env or 'http://localhost:8080') */\r\n  apiUrl?: string;\r\n  /** Auth token for handshake */\r\n  authToken?: string;\r\n}\r\n\r\n/**\r\n * Unified hook for Vira Reactive Protocol state management.\r\n * Replaces both useViraState and useViraStream.\r\n *\r\n * @example\r\n * ```tsx\r\n * // Basic usage\r\n * const { data, sendUpdate } = useViraState<MyType>('my-channel');\r\n *\r\n * // With options\r\n * const { data, sendUpdate, sendDiff } = useViraState<User>('user:123', {\r\n *   initial: { name: 'Guest' },\r\n *   enableMsgId: true,\r\n *   onOpen: () => console.log('Connected'),\r\n *   deepMerge: true\r\n * });\r\n * ```\r\n */\r\nexport function useViraState<T = any, C extends string = string>(\r\n  channel: C,\r\n  initialOrOptions?: T | null | UseViraStateOptions<T>\r\n): {\r\n  /** Current state data */\r\n  data: T | null;\r\n  /** Send an event to the server */\r\n  sendEvent: (name: string, payload: any, msgId?: string) => void;\r\n  /** Send a full update (replaces state) */\r\n  sendUpdate: (payload: T, msgId?: string) => void;\r\n  /** Send a partial diff (merges with current state) */\r\n  sendDiff: (patch: Partial<T>, msgId?: string) => void;\r\n  /** Connection status */\r\n  isConnected: boolean;\r\n  /** Connection error, if any */\r\n  error: Error | null;\r\n} {\r\n  // Parse options (backward compatibility: second param can be initial value or options)\r\n  const options: UseViraStateOptions<T> = useMemo(() => {\r\n    if (initialOrOptions === null || initialOrOptions === undefined) {\r\n      return {};\r\n    }\r\n    // If it's an object with known option keys, treat as options\r\n    if (\r\n      typeof initialOrOptions === 'object' &&\r\n      !Array.isArray(initialOrOptions) &&\r\n      ('enableMsgId' in initialOrOptions ||\r\n        'onOpen' in initialOrOptions ||\r\n        'onClose' in initialOrOptions ||\r\n        'onError' in initialOrOptions ||\r\n        'deepMerge' in initialOrOptions ||\r\n        'initial' in initialOrOptions ||\r\n        'apiUrl' in initialOrOptions ||\r\n        'authToken' in initialOrOptions)\r\n    ) {\r\n      return initialOrOptions as UseViraStateOptions<T>;\r\n    }\r\n    // Otherwise, treat as initial value (backward compatibility)\r\n    return { initial: initialOrOptions as T | null };\r\n  }, [initialOrOptions]);\r\n\r\n  const {\r\n    initial = null,\r\n    enableMsgId = false,\r\n    onOpen,\r\n    onClose,\r\n    onError,\r\n    deepMerge: useDeepMerge = true,\r\n    apiUrl: apiUrlOption,\r\n    authToken: authTokenOption,\r\n  } = options;\r\n\r\n  const [data, setData] = useState<T | null>(initial);\r\n  const [isConnected, setIsConnected] = useState(false);\r\n  const [error, setError] = useState<Error | null>(null);\r\n  const clientRef = useRef<ViraClient | null>(null);\r\n  const sessionRef = useRef<string | null>(null);\r\n  const msgIdCounterRef = useRef(0);\r\n\r\n  // Use provided apiUrl or fallback to env or default\r\n  // Note: import.meta is only available in ESM, so we check safely\r\n  const apiUrl = useMemo(() => {\r\n    if (apiUrlOption) return apiUrlOption;\r\n    // Try to get from env if available (Vite/bundler environment)\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      if (env?.VITE_API_URL) return env.VITE_API_URL;\r\n    } catch {\r\n      // Ignore if import.meta is not available\r\n    }\r\n    return 'http://localhost:8080';\r\n  }, [apiUrlOption]);\r\n\r\n  // Get authToken from options or try to get from env\r\n  const authToken = useMemo(() => {\r\n    if (authTokenOption !== undefined) return authTokenOption;\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      return env?.VITE_AUTH_TOKEN || '';\r\n    } catch {\r\n      return '';\r\n    }\r\n  }, [authTokenOption]);\r\n\r\n  useEffect(() => {\r\n    if (!channel) return;\r\n\r\n    const handleMessage = (msg: Message) => {\r\n      switch (msg.type) {\r\n        case 'update':\r\n        case 'event':\r\n          if (msg.channel === channel) {\r\n            setData(msg.data as T);\r\n          }\r\n          break;\r\n\r\n        case 'diff':\r\n          if (msg.channel === channel) {\r\n            setData((prev) => {\r\n              if (!prev) {\r\n                return (msg.patch as T) || null;\r\n              }\r\n\r\n              // For objects, merge the patch\r\n              if (typeof prev === 'object' && typeof msg.patch === 'object') {\r\n                if (useDeepMerge) {\r\n                  // Deep merge preserves nested structures\r\n                  return deepMerge(prev as Record<string, any>, msg.patch as Partial<T>) as T;\r\n                } else {\r\n                  // Shallow merge (backward compatible)\r\n                  return { ...(prev as any), ...(msg.patch as any) };\r\n                }\r\n              }\r\n\r\n              // For primitives, replace entirely\r\n              return (msg.patch as T) || prev;\r\n            });\r\n          }\r\n          break;\r\n      }\r\n    };\r\n\r\n    const handleConnect = () => {\r\n      setIsConnected(true);\r\n      setError(null);\r\n      onOpen?.();\r\n    };\r\n\r\n    const handleDisconnect = (event?: CloseEvent) => {\r\n      setIsConnected(false);\r\n      onClose?.(event!);\r\n    };\r\n\r\n    const handleError = (err: Error) => {\r\n      setError(err);\r\n      onError?.(err);\r\n    };\r\n\r\n    const client = createViraClient({\r\n      url: apiUrl,\r\n      channel,\r\n      onMessage: handleMessage,\r\n      onConnect: handleConnect,\r\n      onDisconnect: handleDisconnect,\r\n      onError: handleError,\r\n      session: sessionRef.current,\r\n      authToken,\r\n      onSessionChange: (newSession) => {\r\n        sessionRef.current = newSession;\r\n      },\r\n    });\r\n\r\n    clientRef.current = client;\r\n\r\n    return () => {\r\n      client.close();\r\n      clientRef.current = null;\r\n      setIsConnected(false);\r\n      setError(null);\r\n    };\r\n  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge]);\r\n\r\n  // Generate msgId if enabled\r\n  const generateMsgId = useCallback((): string | undefined => {\r\n    if (!enableMsgId) return undefined;\r\n    msgIdCounterRef.current++;\r\n    return `${channel}:${Date.now()}:${msgIdCounterRef.current}`;\r\n  }, [channel, enableMsgId]);\r\n\r\n  const sendEvent = useCallback(\r\n    (name: string, payload: any, msgId?: string) => {\r\n      clientRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendUpdate = useCallback(\r\n    (payload: T, msgId?: string) => {\r\n      clientRef.current?.sendUpdate(payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendDiff = useCallback(\r\n    (patch: Partial<T>, msgId?: string) => {\r\n      clientRef.current?.sendDiff(patch, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  return {\r\n    data,\r\n    sendEvent,\r\n    sendUpdate,\r\n    sendDiff,\r\n    isConnected,\r\n    error,\r\n  };\r\n}\r\n\r\n/**\r\n * Legacy hook - use useViraState instead.\r\n * @deprecated Use useViraState with options instead\r\n */\r\nexport function useViraStream<T = any, C extends string = string>(\r\n  channel: C,\r\n  options?: UseViraStateOptions<T>\r\n) {\r\n  return useViraState<T, C>(channel, { ...options, initial: null });\r\n}\r\n\r\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/useViraState.ts"],"sourcesContent":["import { useEffect, useMemo, useRef, useState, useCallback } from 'react';\r\nimport {\r\n  createViraClient,\r\n  deepMerge,\r\n  getViraConnectionPool,\r\n  type ViraClient,\r\n  type Message,\r\n  type ViraConnectionPool,\r\n} from '@vira-ui/core';\r\n\r\nexport interface UseViraStateOptions<T = any> {\r\n  /** Initial value for the state */\r\n  initial?: T | null;\r\n  /** Enable msgId support for idempotency */\r\n  enableMsgId?: boolean;\r\n  /** Callback when connection opens */\r\n  onOpen?: () => void;\r\n  /** Callback when connection closes */\r\n  onClose?: (event: CloseEvent) => void;\r\n  /** Callback when connection error occurs */\r\n  onError?: (error: Error) => void;\r\n  /** Use deep merge for diff patches (default: true) */\r\n  deepMerge?: boolean;\r\n  /** API URL (defaults to VITE_API_URL env or 'http://localhost:8080') */\r\n  apiUrl?: string;\r\n  /** Auth token for handshake */\r\n  authToken?: string;\r\n  /** Disable connection pooling (fallback to 1 WS per channel). Default: false */\r\n  disablePooling?: boolean;\r\n  /** Enable debug logs for VRP (console.debug). Default: env VITE_VRP_DEBUG === 'true' */\r\n  debug?: boolean;\r\n}\r\n\r\n/**\r\n * Unified hook for Vira Reactive Protocol state management.\r\n * Replaces both useViraState and useViraStream.\r\n *\r\n * @example\r\n * ```tsx\r\n * // Basic usage\r\n * const { data, sendUpdate } = useViraState<MyType>('my-channel');\r\n *\r\n * // With options\r\n * const { data, sendUpdate, sendDiff } = useViraState<User>('user:123', {\r\n *   initial: { name: 'Guest' },\r\n *   enableMsgId: true,\r\n *   onOpen: () => console.log('Connected'),\r\n *   deepMerge: true\r\n * });\r\n * ```\r\n */\r\nexport function useViraState<T = any, C extends string = string>(\r\n  channel: C,\r\n  initialOrOptions?: T | null | UseViraStateOptions<T>\r\n): {\r\n  /** Current state data */\r\n  data: T | null;\r\n  /** Send an event to the server */\r\n  sendEvent: (name: string, payload: any, msgId?: string) => void;\r\n  /** Send a full update (replaces state) */\r\n  sendUpdate: (payload: T, msgId?: string) => void;\r\n  /** Send a partial diff (merges with current state) */\r\n  sendDiff: (patch: Partial<T>, msgId?: string) => void;\r\n  /** Connection status */\r\n  isConnected: boolean;\r\n  /** Connection error, if any */\r\n  error: Error | null;\r\n} {\r\n  // Parse options (backward compatibility: second param can be initial value or options)\r\n  const options: UseViraStateOptions<T> = useMemo(() => {\r\n    if (initialOrOptions === null || initialOrOptions === undefined) {\r\n      return {};\r\n    }\r\n    // If it's an object with known option keys, treat as options\r\n    if (\r\n      typeof initialOrOptions === 'object' &&\r\n      !Array.isArray(initialOrOptions) &&\r\n      ('enableMsgId' in initialOrOptions ||\r\n        'onOpen' in initialOrOptions ||\r\n        'onClose' in initialOrOptions ||\r\n        'onError' in initialOrOptions ||\r\n        'deepMerge' in initialOrOptions ||\r\n        'initial' in initialOrOptions ||\r\n        'apiUrl' in initialOrOptions ||\r\n        'authToken' in initialOrOptions ||\r\n        'disablePooling' in initialOrOptions ||\r\n        'debug' in initialOrOptions)\r\n    ) {\r\n      return initialOrOptions as UseViraStateOptions<T>;\r\n    }\r\n    // Otherwise, treat as initial value (backward compatibility)\r\n    return { initial: initialOrOptions as T | null };\r\n  }, [initialOrOptions]);\r\n\r\n  const {\r\n    initial = null,\r\n    enableMsgId = false,\r\n    onOpen,\r\n    onClose,\r\n    onError,\r\n    deepMerge: useDeepMerge = true,\r\n    apiUrl: apiUrlOption,\r\n    authToken: authTokenOption,\r\n    disablePooling = false,\r\n    debug: debugOption,\r\n  } = options;\r\n\r\n  const [data, setData] = useState<T | null>(initial);\r\n  const [isConnected, setIsConnected] = useState(false);\r\n  const [error, setError] = useState<Error | null>(null);\r\n\r\n  type Transport = {\r\n    sendEvent: (name: string, payload: any, msgId?: string) => void;\r\n    sendUpdate: (payload: T, msgId?: string) => void;\r\n    sendDiff: (patch: Partial<T>, msgId?: string) => void;\r\n  };\r\n\r\n  const transportRef = useRef<Transport | null>(null);\r\n  const clientRef = useRef<ViraClient | null>(null); // legacy non-pooled mode only\r\n  const sessionRef = useRef<string | null>(null);\r\n  const msgIdCounterRef = useRef(0);\r\n  const wasConnectedRef = useRef(false);\r\n  const lastErrorRef = useRef<Error | null>(null);\r\n\r\n  // Use provided apiUrl or fallback to env or default\r\n  // Note: import.meta is only available in ESM, so we check safely\r\n  const apiUrl = useMemo(() => {\r\n    if (apiUrlOption) return apiUrlOption;\r\n    // Try to get from env if available (Vite/bundler environment)\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      if (env?.VITE_API_URL) return env.VITE_API_URL;\r\n    } catch {\r\n      // Ignore if import.meta is not available\r\n    }\r\n    return 'http://localhost:8080';\r\n  }, [apiUrlOption]);\r\n\r\n  // Get authToken from options or try to get from env\r\n  const authToken = useMemo(() => {\r\n    if (authTokenOption !== undefined) return authTokenOption;\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      return env?.VITE_AUTH_TOKEN || '';\r\n    } catch {\r\n      return '';\r\n    }\r\n  }, [authTokenOption]);\r\n\r\n  const debug = useMemo(() => {\r\n    if (debugOption !== undefined) return Boolean(debugOption);\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\r\n      const env = (globalThis as any).import?.meta?.env || (globalThis as any).process?.env;\r\n      return String(env?.VITE_VRP_DEBUG || '').toLowerCase() === 'true';\r\n    } catch {\r\n      return false;\r\n    }\r\n  }, [debugOption]);\r\n\r\n  const pool: ViraConnectionPool | null = useMemo(() => {\r\n    if (disablePooling) return null;\r\n    return getViraConnectionPool({ url: apiUrl, authToken, debug });\r\n  }, [disablePooling, apiUrl, authToken, debug]);\r\n\r\n  useEffect(() => {\r\n    if (!channel) return;\r\n\r\n    const handleMessage = (msg: Message) => {\r\n      switch (msg.type) {\r\n        case 'update':\r\n        case 'event':\r\n          if (msg.channel === channel) {\r\n            setData(msg.data as T);\r\n          }\r\n          break;\r\n\r\n        case 'diff':\r\n          if (msg.channel === channel) {\r\n            setData((prev) => {\r\n              if (!prev) {\r\n                return (msg.patch as T) || null;\r\n              }\r\n\r\n              // For objects, merge the patch\r\n              if (typeof prev === 'object' && typeof msg.patch === 'object') {\r\n                if (useDeepMerge) {\r\n                  // Deep merge preserves nested structures\r\n                  return deepMerge(prev as Record<string, any>, msg.patch as Partial<T>) as T;\r\n                } else {\r\n                  // Shallow merge (backward compatible)\r\n                  return { ...(prev as any), ...(msg.patch as any) };\r\n                }\r\n              }\r\n\r\n              // For primitives, replace entirely\r\n              return (msg.patch as T) || prev;\r\n            });\r\n          }\r\n          break;\r\n      }\r\n    };\r\n\r\n    // --- Pooled mode (default) ---\r\n    if (pool) {\r\n      // Subscribe to messages for this channel\r\n      const unsubChannel = pool.subscribe(channel, handleMessage);\r\n\r\n      // Track shared connection status\r\n      const unsubStatus = pool.onStatus((status) => {\r\n        setError(status.error);\r\n        setIsConnected(status.connected);\r\n\r\n        // Fire callbacks only on transitions\r\n        if (status.connected && !wasConnectedRef.current) {\r\n          wasConnectedRef.current = true;\r\n          onOpen?.();\r\n        }\r\n        if (!status.connected && wasConnectedRef.current) {\r\n          wasConnectedRef.current = false;\r\n          // We don't get a real CloseEvent from pooled status, so we pass a lightweight synthetic object\r\n          const synthetic = (typeof CloseEvent !== 'undefined'\r\n            ? new CloseEvent('close', { code: 1001, reason: 'pooled disconnect' })\r\n            : ({ code: 1001, reason: 'pooled disconnect' } as any)) as any;\r\n          onClose?.(synthetic);\r\n        }\r\n        if (status.error) {\r\n          if (lastErrorRef.current !== status.error) {\r\n            lastErrorRef.current = status.error;\r\n            onError?.(status.error);\r\n          }\r\n        } else {\r\n          lastErrorRef.current = null;\r\n        }\r\n      });\r\n\r\n      // Wire transport for send* APIs\r\n      transportRef.current = {\r\n        sendEvent: (name, payload, msgId) => pool.sendEvent(channel, name, payload, msgId),\r\n        sendUpdate: (payload, msgId) => pool.sendUpdate(channel, payload, msgId),\r\n        sendDiff: (patch, msgId) => pool.sendDiff(channel, patch, msgId),\r\n      };\r\n\r\n      return () => {\r\n        unsubStatus();\r\n        unsubChannel();\r\n        transportRef.current = null;\r\n        setIsConnected(false);\r\n        setError(null);\r\n      };\r\n    }\r\n\r\n    // --- Legacy mode (1 WS per channel) ---\r\n    const handleConnect = () => {\r\n      setIsConnected(true);\r\n      setError(null);\r\n      onOpen?.();\r\n    };\r\n\r\n    const handleDisconnect = (event?: CloseEvent) => {\r\n      setIsConnected(false);\r\n      onClose?.(event!);\r\n    };\r\n\r\n    const handleError = (err: Error) => {\r\n      setError(err);\r\n      onError?.(err);\r\n    };\r\n\r\n    const client = createViraClient({\r\n      url: apiUrl,\r\n      channel,\r\n      onMessage: handleMessage,\r\n      onConnect: handleConnect,\r\n      onDisconnect: handleDisconnect,\r\n      onError: handleError,\r\n      session: sessionRef.current,\r\n      authToken,\r\n      onSessionChange: (newSession) => {\r\n        sessionRef.current = newSession;\r\n      },\r\n    });\r\n\r\n    clientRef.current = client;\r\n    transportRef.current = {\r\n      sendEvent: (name, payload, msgId) => client.sendEvent(name, payload, msgId),\r\n      sendUpdate: (payload, msgId) => client.sendUpdate(payload, msgId),\r\n      sendDiff: (patch, msgId) => client.sendDiff(patch, msgId),\r\n    };\r\n\r\n    return () => {\r\n      client.close();\r\n      clientRef.current = null;\r\n      transportRef.current = null;\r\n      setIsConnected(false);\r\n      setError(null);\r\n    };\r\n  }, [channel, apiUrl, authToken, onOpen, onClose, onError, useDeepMerge, pool]);\r\n\r\n  // Generate msgId if enabled\r\n  const generateMsgId = useCallback((): string | undefined => {\r\n    if (!enableMsgId) return undefined;\r\n    msgIdCounterRef.current++;\r\n    return `${channel}:${Date.now()}:${msgIdCounterRef.current}`;\r\n  }, [channel, enableMsgId]);\r\n\r\n  const sendEvent = useCallback(\r\n    (name: string, payload: any, msgId?: string) => {\r\n      transportRef.current?.sendEvent(name, payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendUpdate = useCallback(\r\n    (payload: T, msgId?: string) => {\r\n      transportRef.current?.sendUpdate(payload, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  const sendDiff = useCallback(\r\n    (patch: Partial<T>, msgId?: string) => {\r\n      transportRef.current?.sendDiff(patch, msgId ?? generateMsgId());\r\n    },\r\n    [generateMsgId]\r\n  );\r\n\r\n  return {\r\n    data,\r\n    sendEvent,\r\n    sendUpdate,\r\n    sendDiff,\r\n    isConnected,\r\n    error,\r\n  };\r\n}\r\n\r\n/**\r\n * Legacy hook - use useViraState instead.\r\n * @deprecated Use useViraState with options instead\r\n */\r\nexport function useViraStream<T = any, C extends string = string>(\r\n  channel: C,\r\n  options?: UseViraStateOptions<T>\r\n) {\r\n  return useViraState<T, C>(channel, { ...options, initial: null });\r\n}\r\n\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vira-ui/react",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Vira Framework - React hooks for Vira Reactive Protocol",
   "author": "Vira Team",
   "license": "MIT",