npm - @vira-ui/react - Versions diffs - 1.0.2 → 1.1.0 - Mend

@vira-ui/react 1.0.2 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -1,746 +1,65 @@
 # @vira-ui/react
-<div align="center">
+React-хуки для работы с Vira Reactive Protocol (VRP). Синхронизация состояния между клиентом и сервером через WebSocket.
-**Vira Framework - React hooks for Vira Reactive Protocol (VRP)**
+## Зачем нужен
-[![Version](https://img.shields.io/npm/v/@vira-ui/react.svg)](https://www.npmjs.com/package/@vira-ui/react)
-[![License](https://img.shields.io/npm/l/@vira-ui/react.svg)](LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue.svg)](https://www.typescriptlang.org/)
+Пакет предоставляет простой способ подключения React-компонентов к серверу через WebSocket:
-**React hooks для работы с Vira Reactive Protocol - синхронизация состояния в реальном времени через WebSocket.**
+- **Автоматическая синхронизация** — состояние обновляется при изменениях на сервере
+- **Двусторонняя связь** — можно отправлять события и обновления на сервер
+- **Diff-патчи** — обновляются только изменённые части данных
+- **Переподключение** — автоматическое восстановление соединения
-[Установка](#-установка) • [Быстрый старт](#-быстрый-старт) • [API](#-api-reference) • [Примеры](#-примеры)
+## Основные возможности
-</div>
+### useViraState
----
-## 🎯 Что это?
-**@vira-ui/react** — это пакет React хуков для работы с **Vira Reactive Protocol (VRP)**. Он предоставляет простой способ синхронизации состояния между клиентом и сервером в реальном времени через WebSocket.
-### Основные возможности
-- ✅ **useViraState** — универсальный хук для работы с VRP каналами
-- ✅ **Автоматическая синхронизация** — состояние обновляется автоматически при изменениях на сервере
-- ✅ **Типизация** — полная поддержка TypeScript
-- ✅ **Idempotency** — поддержка msgId для предотвращения дублирования сообщений
-- ✅ **Deep merge** — умное слияние частичных обновлений
-- ✅ **Reconnection** — автоматическое переподключение при разрыве связи
-- ✅ **Session management** — управление сессиями для восстановления состояния
----
-## 📦 Установка
-```bash
-npm install @vira-ui/react @vira-ui/core react
-```
-**Требования:**
-- React 18.2.0+
-- @vira-ui/core 1.0.1+
-- TypeScript 5.3+ (рекомендуется)
----
-## 🚀 Быстрый старт
-### 1. Базовое использование
-```tsx
-import { useViraState } from "@vira-ui/react";
-function MyComponent() {
-  const { data, sendUpdate, sendDiff, sendEvent } = useViraState<User>(
-    "user:123"
-  );
-  if (!data) {
-    return <div>Loading...</div>;
-  }
-  return (
-    <div>
-      <h1>{data.name}</h1>
-      <button onClick={() => sendDiff({ name: "New Name" })}>
-        Обновить имя
-      </button>
-    </div>
-  );
-}
-```
-### 2. С опциями
-```tsx
-import { useViraState } from "@vira-ui/react";
-function MyComponent() {
-  const { data, sendUpdate, sendDiff, isConnected, error } = useViraState<User>(
-    "user:123",
-    {
-      initial: { name: "Guest", email: "" },
-      enableMsgId: true,
-      deepMerge: true,
-      onOpen: () => console.log("Connected"),
-      onClose: () => console.log("Disconnected"),
-      onError: (err) => console.error("Error:", err),
-      apiUrl: "http://localhost:8080",
-      authToken: "your-token",
-    }
-  );
-  if (error) {
-    return <div>Error: {error.message}</div>;
-  }
-  if (!isConnected) {
-    return <div>Connecting...</div>;
-  }
-  return <div>{data?.name}</div>;
-}
-```
-### 3. С несколькими каналами
-```tsx
-import { useViraState } from "@vira-ui/react";
-function Dashboard() {
-  const user = useViraState<User>("user:123");
-  const notifications = useViraState<Notification[]>("notifications:123");
-  const tasks = useViraState<Task[]>("tasks:123");
-  return (
-    <div>
-      <UserProfile data={user.data} />
-      <NotificationsList data={notifications.data} />
-      <TasksList data={tasks.data} />
-    </div>
-  );
-}
-```
----
-## 📚 API Reference
-### `useViraState<T>(channel, options?)`
-Универсальный хук для работы с VRP каналами.
-**Параметры:**
-- `channel` (string) — имя канала (например, `"user:123"`, `"tasks:456"`)
-- `options` (UseViraStateOptions, опционально) — опции хука
-**Возвращает:**
-```tsx
-{
-  // Текущее состояние данных
-  data: T | null;
-  // Отправить событие на сервер
-  sendEvent: (name: string, payload: any, msgId?: string) => void;
-  // Отправить полное обновление (заменяет состояние)
-  sendUpdate: (payload: T, msgId?: string) => void;
-  // Отправить частичное обновление (сливается с текущим состоянием)
-  sendDiff: (patch: Partial<T>, msgId?: string) => void;
-  // Статус подключения
-  isConnected: boolean;
-  // Ошибка подключения, если есть
-  error: Error | null;
-}
-```
-**Опции:**
-```tsx
-interface UseViraStateOptions<T> {
-  // Начальное значение состояния
-  initial?: T | null;
-  // Включить поддержку msgId для идемпотентности
-  enableMsgId?: boolean;
-  // Callback при открытии соединения
-  onOpen?: () => void;
-  // Callback при закрытии соединения
-  onClose?: (event: CloseEvent) => void;
-  // Callback при ошибке соединения
-  onError?: (error: Error) => void;
-  // Использовать deep merge для diff патчей (по умолчанию: true)
-  deepMerge?: boolean;
-  // URL API (по умолчанию: VITE_API_URL или 'http://localhost:8080')
-  apiUrl?: string;
-  // Auth token для handshake
-  authToken?: string;
-}
-```
----
-## 🎯 Примеры использования
-### Пример 1: Простое обновление состояния
+Подключается к каналу и синхронизирует состояние:
 ```tsx
-import { useViraState } from "@vira-ui/react";
-interface Counter {
-  count: number;
-}
-function CounterComponent() {
-  const { data, sendDiff } = useViraState<Counter>("counter:demo");
-  const increment = () => {
-    sendDiff({ count: (data?.count || 0) + 1 });
-  };
-  return (
-    <div>
-      <p>Count: {data?.count || 0}</p>
-      <button onClick={increment}>Increment</button>
-    </div>
-  );
-}
-```
-### Пример 2: Работа с пользователем
-```tsx
-import { useViraState } from "@vira-ui/react";
-interface User {
-  id: string;
-  name: string;
-  email: string;
-  avatar?: string;
-}
+import { useViraState } from '@vira-ui/react';
 function UserProfile({ userId }: { userId: string }) {
-  const { data, sendDiff, sendEvent, isConnected } = useViraState<User>(
+  const { data, sendUpdate, sendDiff, isConnected } = useViraState<User>(
     `user:${userId}`,
     {
-      initial: { id: userId, name: "", email: "" },
-      enableMsgId: true,
+      initial: { name: 'Guest' },
+      onOpen: () => console.log('Connected'),
+      deepMerge: true
     }
   );
-  const updateName = (newName: string) => {
-    sendDiff({ name: newName });
-  };
-  const updateEmail = (newEmail: string) => {
-    sendDiff({ email: newEmail });
-  };
-  const uploadAvatar = (avatarUrl: string) => {
-    sendEvent("user.avatar.upload", { avatarUrl });
-  };
-  if (!isConnected) {
-    return <div>Connecting...</div>;
-  }
+  if (!isConnected) return <div>Connecting...</div>;
+  if (!data) return <div>Loading...</div>;
   return (
     <div>
-      <img src={data?.avatar} alt={data?.name} />
-      <input
-        value={data?.name || ""}
-        onChange={(e) => updateName(e.target.value)}
-      />
-      <input
-        value={data?.email || ""}
-        onChange={(e) => updateEmail(e.target.value)}
-      />
-    </div>
-  );
-}
-```
-### Пример 3: Kanban доска
-```tsx
-import { useViraState } from "@vira-ui/react";
-interface KanbanBoard {
-  id: string;
-  title: string;
-  columns: Column[];
-  cards: Record<string, Card>;
-}
-function KanbanBoard({ boardId }: { boardId: string }) {
-  const { data, sendEvent, sendDiff } = useViraState<KanbanBoard>(
-    `kanban:${boardId}`,
-    {
-      enableMsgId: true,
-      deepMerge: true,
-    }
-  );
-  const createCard = (columnId: string, title: string) => {
-    sendEvent("kanban.card.create", {
-      boardId,
-      columnId,
-      title,
-      at: Date.now(),
-    });
-  };
-  const moveCard = (
-    cardId: string,
-    fromColumnId: string,
-    toColumnId: string,
-    newOrder: number
-  ) => {
-    sendEvent("kanban.card.move", {
-      boardId,
-      cardId,
-      fromColumnId,
-      toColumnId,
-      newOrder,
-      at: Date.now(),
-    });
-  };
-  const updateCard = (cardId: string, updates: Partial<Card>) => {
-    sendDiff({
-      cards: {
-        [cardId]: updates,
-      },
-    });
-  };
-  if (!data) {
-    return <div>Loading board...</div>;
-  }
-  return (
-    <div>
-      <h1>{data.title}</h1>
-      {data.columns.map((column) => (
-        <Column
-          key={column.id}
-          column={column}
-          cards={getColumnCards(data, column.id)}
-          onCreateCard={(title) => createCard(column.id, title)}
-          onMoveCard={moveCard}
-          onUpdateCard={updateCard}
-        />
-      ))}
-    </div>
-  );
-}
-```
-### Пример 4: Чат приложение
-```tsx
-import { useViraState } from "@vira-ui/react";
-interface Chat {
-  messages: Message[];
-  participants: User[];
-}
-function ChatRoom({ roomId }: { roomId: string }) {
-  const { data, sendEvent, sendDiff } = useViraState<Chat>(`chat:${roomId}`, {
-    initial: { messages: [], participants: [] },
-    enableMsgId: true,
-  });
-  const sendMessage = (text: string) => {
-    sendEvent("chat.message.send", {
-      roomId,
-      text,
-      timestamp: Date.now(),
-    });
-  };
-  const addParticipant = (user: User) => {
-    sendDiff({
-      participants: [...(data?.participants || []), user],
-    });
-  };
-  return (
-    <div>
-      <div>
-        {data?.messages.map((msg) => (
-          <MessageBubble key={msg.id} message={msg} />
-        ))}
-      </div>
-      <MessageInput onSend={sendMessage} />
-    </div>
-  );
-}
-```
-### Пример 5: Редактирование документа
-```tsx
-import { useViraState } from "@vira-ui/react";
-interface Document {
-  id: string;
-  title: string;
-  content: string;
-  version: number;
-  updatedAt: number;
-}
-function DocumentEditor({ docId }: { docId: string }) {
-  const { data, sendDiff, isConnected } = useViraState<Document>(
-    `document:${docId}`,
-    {
-      enableMsgId: true,
-      deepMerge: true,
-      onOpen: () => console.log("Document loaded"),
-    }
-  );
-  const updateTitle = (title: string) => {
-    sendDiff({
-      title,
-      updatedAt: Date.now(),
-    });
-  };
-  const updateContent = (content: string) => {
-    sendDiff({
-      content,
-      updatedAt: Date.now(),
-    });
-  };
-  if (!isConnected || !data) {
-    return <div>Loading document...</div>;
-  }
-  return (
-    <div>
-      <input
-        value={data.title}
-        onChange={(e) => updateTitle(e.target.value)}
-      />
-      <textarea
-        value={data.content}
-        onChange={(e) => updateContent(e.target.value)}
-      />
-      <div>Version: {data.version}</div>
+      <h1>{data.name}</h1>
+      <button onClick={() => sendDiff({ name: 'New Name' })}>
+        Update Name
+      </button>
     </div>
   );
 }
 ```
-### Пример 6: С обработкой ошибок
-```tsx
-import { useViraState } from "@vira-ui/react";
-function RobustComponent() {
-  const { data, sendDiff, isConnected, error } = useViraState<MyData>(
-    "my:channel",
-    {
-      onError: (err) => {
-        console.error("Connection error:", err);
-        // Можно отправить в систему мониторинга
-        // sendToMonitoring(err);
-      },
-      onClose: (event) => {
-        console.log("Connection closed:", event.code, event.reason);
-        // Можно показать уведомление пользователю
-      },
-    }
-  );
-  if (error) {
-    return (
-      <div>
-        <p>Ошибка подключения: {error.message}</p>
-        <button onClick={() => window.location.reload()}>
-          Перезагрузить
-        </button>
-      </div>
-    );
-  }
-  if (!isConnected) {
-    return <div>Подключение...</div>;
-  }
-  return <div>{/* Ваш контент */}</div>;
-}
-```
----
-## 🔧 Конфигурация
-### Переменные окружения
-```env
-# URL API сервера
-VITE_API_URL=http://localhost:8080
-# Auth token для подключения
-VITE_AUTH_TOKEN=your-secret-token
-```
-### Программная конфигурация
-```tsx
-import { useViraState } from "@vira-ui/react";
-function MyComponent() {
-  const { data } = useViraState("my:channel", {
-    apiUrl: "https://api.example.com",
-    authToken: "your-token",
-  });
-}
-```
----
-## 🎯 Vira Reactive Protocol (VRP)
-### Типы сообщений
-VRP поддерживает следующие типы сообщений:
-#### 1. `update` — полное обновление состояния
-```tsx
-sendUpdate({ name: "John", age: 30 });
-```
-#### 2. `diff` — частичное обновление
-```tsx
-sendDiff({ name: "Jane" }); // Обновит только name
-```
-#### 3. `event` — событие
-```tsx
-sendEvent("user.created", { userId: "123" });
-```
-### Каналы
-Каналы используются для изоляции данных:
-```tsx
-// Пользователь
-"user:123"
-// Задачи
-"tasks:456"
-// Уведомления
-"notifications:123"
-// Демо канал
-"demo"
-```
-### Idempotency (msgId)
-Для предотвращения дублирования сообщений используйте `enableMsgId`:
-```tsx
-const { sendUpdate } = useViraState("my:channel", {
-  enableMsgId: true, // Автоматически генерирует msgId
-});
-// Или вручную
-sendUpdate(data, "custom-msg-id");
-```
-### Deep Merge
-По умолчанию используется deep merge для diff обновлений:
-```tsx
-// Текущее состояние
-{ user: { name: "John", age: 30 } }
-// Отправляем diff
-sendDiff({ user: { name: "Jane" } });
-// Результат (deep merge)
-{ user: { name: "Jane", age: 30 } }
-```
-Для shallow merge:
-```tsx
-useViraState("my:channel", {
-  deepMerge: false, // Shallow merge
-});
-```
----
-## 🔥 Best Practices
-### 1. Используйте типизацию
-```tsx
-// ✅ Хорошо
-interface User {
-  id: string;
-  name: string;
-}
-const { data } = useViraState<User>("user:123");
-// ❌ Плохо
-const { data } = useViraState("user:123");
-```
-### 2. Используйте enableMsgId для критичных операций
-```tsx
-// ✅ Хорошо
-useViraState("payment:123", {
-  enableMsgId: true, // Предотвращает дублирование платежей
-});
-// ❌ Плохо
-useViraState("payment:123"); // Может привести к дублированию
-```
-### 3. Обрабатывайте ошибки
-```tsx
-// ✅ Хорошо
-const { data, error, isConnected } = useViraState("my:channel", {
-  onError: (err) => console.error(err),
-});
-if (error) {
-  return <ErrorComponent error={error} />;
-}
-// ❌ Плохо
-const { data } = useViraState("my:channel");
-// Нет обработки ошибок
-```
-### 4. Используйте initial для лучшего UX
-```tsx
-// ✅ Хорошо
-useViraState("user:123", {
-  initial: { name: "Loading...", email: "" },
-});
-// ❌ Плохо
-useViraState("user:123");
-// Пользователь видит пустой экран
-```
-### 5. Используйте sendDiff для частичных обновлений
-```tsx
-// ✅ Хорошо
-sendDiff({ name: "New Name" }); // Обновляет только name
-// ❌ Плохо
-sendUpdate({ ...data, name: "New Name" }); // Отправляет весь объект
-```
----
-## ❓ FAQ
-**Q: В чём разница между `sendUpdate` и `sendDiff`?**
-A: `sendUpdate` заменяет всё состояние целиком, а `sendDiff` сливает изменения с текущим состоянием. Используйте `sendDiff` для частичных обновлений.
-**Q: Что такое msgId и зачем он нужен?**
-A: `msgId` — это уникальный идентификатор сообщения для предотвращения дублирования. Включите `enableMsgId: true` для критичных операций.
-**Q: Как работает deep merge?**
-A: Deep merge рекурсивно сливает объекты, сохраняя вложенные структуры. Например, `{ user: { name: "Jane" } }` обновит только `name`, не затрагивая другие поля `user`.
-**Q: Можно ли использовать несколько каналов одновременно?**
-A: Да! Просто вызовите `useViraState` несколько раз с разными каналами.
-**Q: Что происходит при разрыве соединения?**
-A: Клиент автоматически пытается переподключиться. Вы можете отслеживать статус через `isConnected` и обрабатывать через `onClose` callback.
-**Q: Как работает сессия?**
-A: Сессия сохраняется между переподключениями, что позволяет восстановить подписки и состояние.
-**Q: Можно ли использовать без TypeScript?**
-A: Да, но TypeScript рекомендуется для лучшего DX и безопасности типов.
----
-## 🛣️ Roadmap
-### v1.1 (В разработке)
-- [ ] Поддержка batch операций
-- [ ] Оптимистичные обновления
-- [ ] Offline queue
-- [ ] Compression для больших payload
-### v1.2 (Планируется)
-- [ ] DevTools интеграция
-- [ ] Метрики и мониторинг
-- [ ] Поддержка подписок на несколько каналов
-- [ ] WebRTC fallback
----
-## 📄 License
-MIT
----
-## 🤝 Contributing
-Мы приветствуем вклад! Пожалуйста, прочитайте [CONTRIBUTING.md](../../CONTRIBUTING.md) для деталей.
----
-## 📞 Support
-- **GitHub Issues**: [Создать issue](https://github.com/skrolikov/vira-core/issues)
-- **Discussions**: [Обсуждения](https://github.com/skrolikov/vira-core/discussions)
+### Отправка данных
----
+- `sendUpdate(payload)` — полная замена состояния
+- `sendDiff(patch)` — частичное обновление (merge)
+- `sendEvent(name, payload)` — отправка события
-<div align="center">
+### Опции
-**Сделано с ❤️ командой Vira**
+- `initial` — начальное значение
+- `apiUrl` — URL сервера (по умолчанию из `VITE_API_URL`)
+- `authToken` — токен авторизации
+- `deepMerge` — глубокое слияние для diff-патчей
+- `enableMsgId` — поддержка idempotency
+- `onOpen`, `onClose`, `onError` — колбэки событий соединения
-[GitHub](https://github.com/skrolikov/vira-core) • [Документация](https://vira.dev/react) • [Примеры](https://vira.dev/examples)
+## Использование
-</div>
+Требует сервер с поддержкой Vira Reactive Protocol. Обычно используется вместе с `@vira-ui/core` и `@vira-ui/bindings-react`.

package/dist/index.d.mts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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":[]}
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 {\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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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":[]}
1	+ {"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":";AAAA,SAAS,WAAW,SAAS,QAAQ,UAAU,mBAAmB;AAClE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AA2CA,SAAS,aACd,SACA,kBAcA;AAEA,QAAM,UAAkC,QAAQ,MAAM;AACpD,QAAI,qBAAqB,QAAQ,qBAAqB,QAAW;AAC/D,aAAO,CAAC;AAAA,IACV;AAEA,QACE,OAAO,qBAAqB,YAC5B,CAAC,MAAM,QAAQ,gBAAgB,MAC9B,iBAAiB,oBAChB,YAAY,oBACZ,aAAa,oBACb,aAAa,oBACb,eAAe,oBACf,aAAa,oBACb,YAAY,oBACZ,eAAe,oBACf,oBAAoB,oBACpB,WAAW,mBACb;AACA,aAAO;AAAA,IACT;AAEA,WAAO,EAAE,SAAS,iBAA6B;AAAA,EACjD,GAAG,CAAC,gBAAgB,CAAC;AAErB,QAAM;AAAA,IACJ,UAAU;AAAA,IACV,cAAc;AAAA,IACd;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,eAAe;AAAA,IAC1B,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,iBAAiB;AAAA,IACjB,OAAO;AAAA,EACT,IAAI;AAEJ,QAAM,CAAC,MAAM,OAAO,IAAI,SAAmB,OAAO;AAClD,QAAM,CAAC,aAAa,cAAc,IAAI,SAAS,KAAK;AACpD,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAuB,IAAI;AAQrD,QAAM,eAAe,OAAyB,IAAI;AAClD,QAAM,YAAY,OAA0B,IAAI;AAChD,QAAM,aAAa,OAAsB,IAAI;AAC7C,QAAM,kBAAkB,OAAO,CAAC;AAChC,QAAM,kBAAkB,OAAO,KAAK;AACpC,QAAM,eAAe,OAAqB,IAAI;AAI9C,QAAM,SAAS,QAAQ,MAAM;AAC3B,QAAI,aAAc,QAAO;AAEzB,QAAI;AAEF,YAAM,MAAO,WAAmB,QAAQ,MAAM,OAAQ,WAAmB,SAAS;AAClF,UAAI,KAAK,aAAc,QAAO,IAAI;AAAA,IACpC,QAAQ;AAAA,IAER;AACA,WAAO;AAAA,EACT,GAAG,CAAC,YAAY,CAAC;AAGjB,QAAM,YAAY,QAAQ,MAAM;AAC9B,QAAI,oBAAoB,OAAW,QAAO;AAC1C,QAAI;AAEF,YAAM,MAAO,WAAmB,QAAQ,MAAM,OAAQ,WAAmB,SAAS;AAClF,aAAO,KAAK,mBAAmB;AAAA,IACjC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,GAAG,CAAC,eAAe,CAAC;AAEpB,QAAM,QAAQ,QAAQ,MAAM;AAC1B,QAAI,gBAAgB,OAAW,QAAO,QAAQ,WAAW;AACzD,QAAI;AAEF,YAAM,MAAO,WAAmB,QAAQ,MAAM,OAAQ,WAAmB,SAAS;AAClF,aAAO,OAAO,KAAK,kBAAkB,EAAE,EAAE,YAAY,MAAM;AAAA,IAC7D,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,GAAG,CAAC,WAAW,CAAC;AAEhB,QAAM,OAAkC,QAAQ,MAAM;AACpD,QAAI,eAAgB,QAAO;AAC3B,WAAO,sBAAsB,EAAE,KAAK,QAAQ,WAAW,MAAM,CAAC;AAAA,EAChE,GAAG,CAAC,gBAAgB,QAAQ,WAAW,KAAK,CAAC;AAE7C,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AAEd,UAAM,gBAAgB,CAAC,QAAiB;AACtC,cAAQ,IAAI,MAAM;AAAA,QAChB,KAAK;AAAA,QACL,KAAK;AACH,cAAI,IAAI,YAAY,SAAS;AAC3B,oBAAQ,IAAI,IAAS;AAAA,UACvB;AACA;AAAA,QAEF,KAAK;AACH,cAAI,IAAI,YAAY,SAAS;AAC3B,oBAAQ,CAAC,SAAS;AAChB,kBAAI,CAAC,MAAM;AACT,uBAAQ,IAAI,SAAe;AAAA,cAC7B;AAGA,kBAAI,OAAO,SAAS,YAAY,OAAO,IAAI,UAAU,UAAU;AAC7D,oBAAI,cAAc;AAEhB,yBAAO,UAAU,MAA6B,IAAI,KAAmB;AAAA,gBACvE,OAAO;AAEL,yBAAO,EAAE,GAAI,MAAc,GAAI,IAAI,MAAc;AAAA,gBACnD;AAAA,cACF;AAGA,qBAAQ,IAAI,SAAe;AAAA,YAC7B,CAAC;AAAA,UACH;AACA;AAAA,MACJ;AAAA,IACF;AAGA,QAAI,MAAM;AAER,YAAM,eAAe,KAAK,UAAU,SAAS,aAAa;AAG1D,YAAM,cAAc,KAAK,SAAS,CAAC,WAAW;AAC5C,iBAAS,OAAO,KAAK;AACrB,uBAAe,OAAO,SAAS;AAG/B,YAAI,OAAO,aAAa,CAAC,gBAAgB,SAAS;AAChD,0BAAgB,UAAU;AAC1B,mBAAS;AAAA,QACX;AACA,YAAI,CAAC,OAAO,aAAa,gBAAgB,SAAS;AAChD,0BAAgB,UAAU;AAE1B,gBAAM,YAAa,OAAO,eAAe,cACrC,IAAI,WAAW,SAAS,EAAE,MAAM,MAAM,QAAQ,oBAAoB,CAAC,IAClE,EAAE,MAAM,MAAM,QAAQ,oBAAoB;AAC/C,oBAAU,SAAS;AAAA,QACrB;AACA,YAAI,OAAO,OAAO;AAChB,cAAI,aAAa,YAAY,OAAO,OAAO;AACzC,yBAAa,UAAU,OAAO;AAC9B,sBAAU,OAAO,KAAK;AAAA,UACxB;AAAA,QACF,OAAO;AACL,uBAAa,UAAU;AAAA,QACzB;AAAA,MACF,CAAC;AAGD,mBAAa,UAAU;AAAA,QACrB,WAAW,CAAC,MAAM,SAAS,UAAU,KAAK,UAAU,SAAS,MAAM,SAAS,KAAK;AAAA,QACjF,YAAY,CAAC,SAAS,UAAU,KAAK,WAAW,SAAS,SAAS,KAAK;AAAA,QACvE,UAAU,CAAC,OAAO,UAAU,KAAK,SAAS,SAAS,OAAO,KAAK;AAAA,MACjE;AAEA,aAAO,MAAM;AACX,oBAAY;AACZ,qBAAa;AACb,qBAAa,UAAU;AACvB,uBAAe,KAAK;AACpB,iBAAS,IAAI;AAAA,MACf;AAAA,IACF;AAGA,UAAM,gBAAgB,MAAM;AAC1B,qBAAe,IAAI;AACnB,eAAS,IAAI;AACb,eAAS;AAAA,IACX;AAEA,UAAM,mBAAmB,CAAC,UAAuB;AAC/C,qBAAe,KAAK;AACpB,gBAAU,KAAM;AAAA,IAClB;AAEA,UAAM,cAAc,CAAC,QAAe;AAClC,eAAS,GAAG;AACZ,gBAAU,GAAG;AAAA,IACf;AAEA,UAAM,SAAS,iBAAiB;AAAA,MAC9B,KAAK;AAAA,MACL;AAAA,MACA,WAAW;AAAA,MACX,WAAW;AAAA,MACX,cAAc;AAAA,MACd,SAAS;AAAA,MACT,SAAS,WAAW;AAAA,MACpB;AAAA,MACA,iBAAiB,CAAC,eAAe;AAC/B,mBAAW,UAAU;AAAA,MACvB;AAAA,IACF,CAAC;AAED,cAAU,UAAU;AACpB,iBAAa,UAAU;AAAA,MACrB,WAAW,CAAC,MAAM,SAAS,UAAU,OAAO,UAAU,MAAM,SAAS,KAAK;AAAA,MAC1E,YAAY,CAAC,SAAS,UAAU,OAAO,WAAW,SAAS,KAAK;AAAA,MAChE,UAAU,CAAC,OAAO,UAAU,OAAO,SAAS,OAAO,KAAK;AAAA,IAC1D;AAEA,WAAO,MAAM;AACX,aAAO,MAAM;AACb,gBAAU,UAAU;AACpB,mBAAa,UAAU;AACvB,qBAAe,KAAK;AACpB,eAAS,IAAI;AAAA,IACf;AAAA,EACF,GAAG,CAAC,SAAS,QAAQ,WAAW,QAAQ,SAAS,SAAS,cAAc,IAAI,CAAC;AAG7E,QAAM,gBAAgB,YAAY,MAA0B;AAC1D,QAAI,CAAC,YAAa,QAAO;AACzB,oBAAgB;AAChB,WAAO,GAAG,OAAO,IAAI,KAAK,IAAI,CAAC,IAAI,gBAAgB,OAAO;AAAA,EAC5D,GAAG,CAAC,SAAS,WAAW,CAAC;AAEzB,QAAM,YAAY;AAAA,IAChB,CAAC,MAAc,SAAc,UAAmB;AAC9C,mBAAa,SAAS,UAAU,MAAM,SAAS,SAAS,cAAc,CAAC;AAAA,IACzE;AAAA,IACA,CAAC,aAAa;AAAA,EAChB;AAEA,QAAM,aAAa;AAAA,IACjB,CAAC,SAAY,UAAmB;AAC9B,mBAAa,SAAS,WAAW,SAAS,SAAS,cAAc,CAAC;AAAA,IACpE;AAAA,IACA,CAAC,aAAa;AAAA,EAChB;AAEA,QAAM,WAAW;AAAA,IACf,CAAC,OAAmB,UAAmB;AACrC,mBAAa,SAAS,SAAS,OAAO,SAAS,cAAc,CAAC;AAAA,IAChE;AAAA,IACA,CAAC,aAAa;AAAA,EAChB;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAMO,SAAS,cACd,SACA,SACA;AACA,SAAO,aAAmB,SAAS,EAAE,GAAG,SAAS,SAAS,KAAK,CAAC;AAClE;","names":[]}

package/package.json CHANGED Viewed

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