react-nats 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,254 @@
+# react-nats
+
+React hooks for NATS messaging and JetStream.
+
+## Features
+
+- 🔌 **NatsProvider** - WebSocket connection management with auto-reconnect
+- 📊 **useNatsKvTable** - Reactive NATS KV bucket with real-time updates
+- 📨 **useNatsStream** - JetStream consumer with time-based replay
+- ⚡ **Performance optimized** - Batched updates and stable sorting
+- 🎯 **TypeScript first** - Full type safety with generics
+- 🧪 **Zero dependencies** - Only peer dependencies on React and NATS
+
+## Installation
+
+```bash
+npm install react-nats @nats-io/nats-core @nats-io/jetstream @nats-io/kv
+```
+
+## Quick Start
+
+### 1. Wrap your app with NatsProvider
+
+```tsx
+import { NatsProvider } from 'react-nats';
+
+function App() {
+  return (
+    <NatsProvider url="ws://localhost:4222">
+      <YourApp />
+    </NatsProvider>
+  );
+}
+```
+
+### 2. Use NATS KV for real-time data
+
+```tsx
+import { useNatsKvTable } from 'react-nats';
+
+interface MyData {
+  id: string;
+  value: number;
+}
+
+function MyComponent() {
+  const entries = useNatsKvTable({
+    bucketName: 'my-bucket',
+    decoder: {
+      decode: (data: Uint8Array) => JSON.parse(new TextDecoder().decode(data)),
+    },
+    refreshInterval: 50, // Batch updates every 50ms
+  });
+
+  return (
+    <ul>
+      {entries.map((entry) => (
+        <li key={entry.key}>
+          {entry.key}: {entry.value.value}
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
+### 3. Consume JetStream messages
+
+```tsx
+import { useNatsStream } from 'react-nats';
+
+function StreamComponent() {
+  const messages = useNatsStream({
+    stream: 'my-stream',
+    subject: 'events.*',
+    decoder: {
+      decode: (data: Uint8Array) => JSON.parse(new TextDecoder().decode(data)),
+    },
+    reducer: {
+      reduce: (arr, msg) => [...arr, msg].slice(-100), // Keep last 100
+    },
+    opt_start_time: new Date(Date.now() - 3600000), // Last hour
+  });
+
+  return <div>Received {messages.length} messages</div>;
+}
+```
+
+## API Reference
+
+### `<NatsProvider>`
+
+Manages WebSocket connection to NATS server.
+
+**Props:**
+- `url: string` - NATS WebSocket URL (e.g., `ws://localhost:4222`)
+- `options?: Partial<ConnectionOptions>` - Additional NATS connection options
+- `children: React.ReactNode`
+
+**Example:**
+```tsx
+<NatsProvider
+  url="wss://nats.example.com"
+  options={{
+    maxReconnectAttempts: 10,
+    reconnectTimeWait: 2000,
+  }}
+>
+  <App />
+</NatsProvider>
+```
+
+### `useNatsConnection()`
+
+Returns the current NATS connection or `null` if not connected.
+
+```tsx
+const connection = useNatsConnection();
+if (connection) {
+  // Use connection directly
+}
+```
+
+### `useNatsKvTable<T, U>(options)`
+
+Watches a NATS KV bucket and returns reactive entries.
+
+**Options:**
+- `bucketName: string` - Name of the KV bucket
+- `decoder: { decode: (data: Uint8Array) => T }` - Decode function for values
+- `enrich?: (key: string, created: Date, decoded: T) => U` - Optional transform
+- `refreshInterval?: number` - Batch update interval in ms (default: 50)
+- `key?: string | string[]` - Filter specific keys
+
+**Returns:** `NatsEntry<U>[]`
+```typescript
+type NatsEntry<T> = {
+  key: string;
+  value: T;
+  created: Date;
+};
+```
+
+**Example with enrichment:**
+```tsx
+const entries = useNatsKvTable({
+  bucketName: 'prices',
+  decoder: { decode: (data) => parseFloat(new TextDecoder().decode(data)) },
+  enrich: (key, created, price) => ({
+    symbol: key,
+    price,
+    age: Date.now() - created.getTime(),
+  }),
+});
+```
+
+### `useNatsStream<T>(options)`
+
+Consumes messages from a JetStream stream.
+
+**Options:**
+- `stream?: string` - Stream name (required)
+- `subject?: string | string[]` - Filter subjects
+- `decoder: { decode: (data: Uint8Array) => T }` - Decode function
+- `reducer: { reduce: (arr: NatsMessage<T>[], msg: NatsMessage<T>) => NatsMessage<T>[] }` - State reducer
+- `opt_start_time?: Date` - Start consuming from this time
+
+**Returns:** `NatsMessage<T>[]`
+```typescript
+type NatsMessage<T> = {
+  subject: string;
+  value: T;
+  received: Date;
+};
+```
+
+**Example with filtering:**
+```tsx
+const trades = useNatsStream({
+  stream: 'TRADES',
+  subject: 'trades.BTC.*',
+  decoder: { decode: (data) => JSON.parse(new TextDecoder().decode(data)) },
+  reducer: {
+    reduce: (arr, msg) => {
+      // Keep only profitable trades
+      if (msg.value.profit > 0) {
+        return [...arr, msg];
+      }
+      return arr;
+    },
+  },
+  opt_start_time: new Date(Date.now() - 86400000), // Last 24 hours
+});
+```
+
+## Common Patterns
+
+### JSON Decoder
+
+```tsx
+const jsonDecoder = {
+  decode: (data: Uint8Array) => JSON.parse(new TextDecoder().decode(data)),
+};
+```
+
+### Protobuf Decoder
+
+```tsx
+import { MyMessage } from './generated/proto';
+
+const protobufDecoder = {
+  decode: (data: Uint8Array) => MyMessage.decode(data),
+};
+```
+
+### Sliding Window Reducer
+
+```tsx
+const slidingWindowReducer = (windowSize: number) => ({
+  reduce: (arr: NatsMessage<any>[], msg: NatsMessage<any>) =>
+    [...arr, msg].slice(-windowSize),
+});
+```
+
+## Performance Tips
+
+1. **Batch updates** - Use `refreshInterval` in `useNatsKvTable` to batch rapid updates
+2. **Filter early** - Use `key` parameter to watch only specific keys
+3. **Limit state** - Use reducer to keep only necessary messages in memory
+4. **Memoize decoders** - Create decoder objects outside components
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the library
+npm run build
+
+# Run tests
+npm test
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.

package/dist/index.d.mts

@@ -0,0 +1,47 @@
+import { ConnectionOptions, NatsConnection } from '@nats-io/nats-core';
+
+interface NatsProviderProps {
+    url: string;
+    options?: Partial<ConnectionOptions>;
+    children: React.ReactNode;
+}
+declare const NatsProvider: React.FC<NatsProviderProps>;
+
+declare function useNatsConnection(): NatsConnection | null;
+
+type NatsEntry<T> = {
+    key: string;
+    value: T;
+    created: Date;
+};
+type NatsMessage<T> = {
+    subject: string;
+    value: T;
+    received: Date;
+};
+
+interface NatsKvTableOptions<T, U> {
+    bucketName: string;
+    decoder: {
+        decode: (data: Uint8Array) => T;
+    };
+    enrich?: (key: string, created: Date, decoded: T) => U;
+    refreshInterval?: number;
+    key?: string | string[];
+}
+declare function useNatsKvTable<T, U = T>({ bucketName, decoder, enrich, refreshInterval, key, }: NatsKvTableOptions<T, U>): NatsEntry<U>[];
+
+interface NatsStreamOptions<T> {
+    stream?: string;
+    subject?: string | string[];
+    decoder: {
+        decode: (data: Uint8Array) => T;
+    };
+    reducer: {
+        reduce: (arr: NatsMessage<T>[], element: NatsMessage<T>) => NatsMessage<T>[];
+    };
+    opt_start_time?: Date;
+}
+declare function useNatsStream<T>({ stream, decoder, reducer, subject, opt_start_time, }: NatsStreamOptions<T>): NatsMessage<T>[];
+
+export { type NatsEntry, type NatsKvTableOptions, type NatsMessage, NatsProvider, type NatsProviderProps, type NatsStreamOptions, useNatsConnection, useNatsKvTable, useNatsStream };

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { ConnectionOptions, NatsConnection } from '@nats-io/nats-core';
+
+interface NatsProviderProps {
+    url: string;
+    options?: Partial<ConnectionOptions>;
+    children: React.ReactNode;
+}
+declare const NatsProvider: React.FC<NatsProviderProps>;
+
+declare function useNatsConnection(): NatsConnection | null;
+
+type NatsEntry<T> = {
+    key: string;
+    value: T;
+    created: Date;
+};
+type NatsMessage<T> = {
+    subject: string;
+    value: T;
+    received: Date;
+};
+
+interface NatsKvTableOptions<T, U> {
+    bucketName: string;
+    decoder: {
+        decode: (data: Uint8Array) => T;
+    };
+    enrich?: (key: string, created: Date, decoded: T) => U;
+    refreshInterval?: number;
+    key?: string | string[];
+}
+declare function useNatsKvTable<T, U = T>({ bucketName, decoder, enrich, refreshInterval, key, }: NatsKvTableOptions<T, U>): NatsEntry<U>[];
+
+interface NatsStreamOptions<T> {
+    stream?: string;
+    subject?: string | string[];
+    decoder: {
+        decode: (data: Uint8Array) => T;
+    };
+    reducer: {
+        reduce: (arr: NatsMessage<T>[], element: NatsMessage<T>) => NatsMessage<T>[];
+    };
+    opt_start_time?: Date;
+}
+declare function useNatsStream<T>({ stream, decoder, reducer, subject, opt_start_time, }: NatsStreamOptions<T>): NatsMessage<T>[];
+
+export { type NatsEntry, type NatsKvTableOptions, type NatsMessage, NatsProvider, type NatsProviderProps, type NatsStreamOptions, useNatsConnection, useNatsKvTable, useNatsStream };

package/dist/index.js

@@ -0,0 +1,290 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  NatsProvider: () => NatsProvider,
+  useNatsConnection: () => useNatsConnection,
+  useNatsKvTable: () => useNatsKvTable,
+  useNatsStream: () => useNatsStream
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/NatsProvider.tsx
+var import_react = require("react");
+var import_nats_core = require("@nats-io/nats-core");
+var import_jsx_runtime = require("react/jsx-runtime");
+var NatsContext = (0, import_react.createContext)(null);
+var DEFAULT_OPTIONS = {
+  reconnect: true,
+  pingInterval: 1e4,
+  maxPingOut: 5
+};
+var NatsProvider = ({
+  url,
+  options,
+  children
+}) => {
+  const [connection, setConnection] = (0, import_react.useState)(null);
+  const connRef = (0, import_react.useRef)(null);
+  const isConnectingRef = (0, import_react.useRef)(false);
+  const connectionOptions = (0, import_react.useMemo)(
+    () => ({ ...DEFAULT_OPTIONS, ...options }),
+    [options]
+  );
+  (0, import_react.useEffect)(() => {
+    if (isConnectingRef.current || connRef.current) {
+      return;
+    }
+    isConnectingRef.current = true;
+    let isActive = true;
+    const establishConnection = async () => {
+      try {
+        const newConnection = await (0, import_nats_core.wsconnect)({
+          servers: url,
+          ...connectionOptions
+        });
+        if (isActive) {
+          connRef.current = newConnection;
+          setConnection(newConnection);
+          newConnection.closed().then((err) => {
+            console.log("NATS connection closed:", err?.message || "Manual close");
+            if (isActive) {
+              connRef.current = null;
+              setConnection(null);
+              isConnectingRef.current = false;
+            }
+          });
+        } else {
+          newConnection.close().then(() => console.log("Closed superseded connection")).catch((err) => {
+            console.error("Error closing superseded connection:", err);
+          });
+        }
+      } catch (err) {
+        if (isActive) {
+          console.error("NATS connection failed:", err);
+          setConnection(null);
+          isConnectingRef.current = false;
+        }
+      }
+    };
+    establishConnection();
+    return () => {
+      isActive = false;
+      if (connRef.current) {
+        connRef.current.close().catch((err) => {
+          console.error("Error closing NATS connection:", err);
+        });
+        connRef.current = null;
+        setConnection(null);
+      }
+      isConnectingRef.current = false;
+    };
+  }, [url, connectionOptions]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(NatsContext.Provider, { value: connection, children });
+};
+
+// src/useNatsConnection.ts
+var import_react2 = require("react");
+function useNatsConnection() {
+  const connection = (0, import_react2.useContext)(NatsContext);
+  return connection;
+}
+
+// src/useNatsKvTable.ts
+var import_react3 = require("react");
+var import_jetstream = require("@nats-io/jetstream");
+var import_kv = require("@nats-io/kv");
+var stableUpsert = (arr, newEntry, inPlace = false) => {
+  const index = arr.findIndex((item) => item.key === newEntry.key);
+  if (index >= 0) {
+    if (inPlace) {
+      arr[index] = newEntry;
+      return arr;
+    }
+    return [...arr.slice(0, index), newEntry, ...arr.slice(index + 1)];
+  } else {
+    if (inPlace) {
+      arr.push(newEntry);
+      arr.sort((a, b) => a.key.localeCompare(b.key));
+      return arr;
+    }
+    return [...arr, newEntry].sort((a, b) => a.key.localeCompare(b.key));
+  }
+};
+function useNatsKvTable({
+  bucketName,
+  decoder,
+  enrich,
+  refreshInterval = 50,
+  key
+}) {
+  const connection = useNatsConnection();
+  const [entries, setEntries] = (0, import_react3.useState)([]);
+  const pendingUpdates = (0, import_react3.useRef)([]);
+  (0, import_react3.useEffect)(() => {
+    if (!connection) return;
+    let kv;
+    let watch;
+    let interval;
+    const setupNats = async () => {
+      const js = (0, import_jetstream.jetstream)(connection);
+      const kvm = new import_kv.Kvm(js);
+      kv = await kvm.open(bucketName, { bindOnly: true });
+      watch = await kv.watch({ key });
+      const flushUpdates = () => {
+        const updatesToProcess = [...pendingUpdates.current];
+        if (updatesToProcess.length > 0) {
+          pendingUpdates.current = [];
+          setEntries((prev) => {
+            const newEntries = [...prev];
+            return updatesToProcess.reduce(
+              (acc, newEntry) => stableUpsert(acc, newEntry, true),
+              newEntries
+            );
+          });
+        }
+      };
+      if (refreshInterval > 0) {
+        flushUpdates();
+        interval = setInterval(flushUpdates, refreshInterval);
+        (async () => {
+          for await (const e of watch) {
+            if (e.operation === "PUT") {
+              const decoded = decoder.decode(e.value);
+              const enrichedValue = enrich ? enrich(e.key, e.created, decoded) : decoded;
+              const newEntry = {
+                key: e.key,
+                value: enrichedValue,
+                created: e.created
+              };
+              pendingUpdates.current.push(newEntry);
+            } else if (e.operation === "DEL" || e.operation === "PURGE") {
+              pendingUpdates.current = pendingUpdates.current.filter(
+                (item) => item.key !== e.key
+              );
+              setEntries((prev) => prev.filter((item) => item.key !== e.key));
+            }
+          }
+        })();
+      } else {
+        (async () => {
+          for await (const e of watch) {
+            if (e.operation === "PUT") {
+              const decoded = decoder.decode(e.value);
+              const enrichedValue = enrich ? enrich(e.key, e.created, decoded) : decoded;
+              const newEntry = {
+                key: e.key,
+                value: enrichedValue,
+                created: e.created
+              };
+              setEntries((prev) => stableUpsert(prev, newEntry));
+            } else if (e.operation === "DEL" || e.operation === "PURGE") {
+              setEntries((prev) => prev.filter((item) => item.key !== e.key));
+            }
+          }
+        })();
+      }
+    };
+    setupNats().catch((err) => console.error("NATS setup error:", err));
+    return () => {
+      watch?.stop();
+      if (interval) clearInterval(interval);
+      kv = void 0;
+      watch = void 0;
+    };
+  }, [bucketName, connection, decoder, enrich, key, refreshInterval]);
+  return entries;
+}
+
+// src/useNatsStream.ts
+var import_react4 = require("react");
+var import_jetstream2 = require("@nats-io/jetstream");
+function useNatsStream({
+  stream,
+  decoder,
+  reducer,
+  subject,
+  opt_start_time
+}) {
+  const connection = useNatsConnection();
+  const [data, setData] = (0, import_react4.useState)([]);
+  (0, import_react4.useEffect)(() => {
+    setData([]);
+    if (!connection) return;
+    if (!opt_start_time) return;
+    if (!stream) return;
+    let isCurrent = true;
+    let c = null;
+    const setupNats = async () => {
+      const js = (0, import_jetstream2.jetstream)(connection);
+      const opt = {};
+      if (opt_start_time) {
+        opt.opt_start_time = opt_start_time.toISOString();
+        opt.deliver_policy = import_jetstream2.DeliverPolicy.StartTime;
+      }
+      if (subject) {
+        opt.filter_subjects = subject;
+      }
+      c = await js.consumers.get(stream, opt);
+      try {
+        const messages = await c.consume({ max_messages: 1 });
+        let effectData = [];
+        for await (const m of messages) {
+          const d = {
+            received: m.time,
+            subject: m.subject,
+            value: decoder.decode(m.data)
+          };
+          effectData = reducer.reduce(effectData, d);
+          m.ack();
+          if (!isCurrent) {
+            break;
+          }
+          setData(effectData);
+        }
+      } finally {
+        if (!await c.delete()) {
+          console.warn(`Failed to delete consumer for stream ${stream}`);
+        }
+      }
+    };
+    setupNats().catch((error) => {
+      if (error.name === "AbortError") {
+        return;
+      }
+      if (isCurrent) {
+        console.error("NATS setup error:", error);
+      }
+    });
+    return () => {
+      isCurrent = false;
+    };
+  }, [connection, stream, decoder, reducer, subject, opt_start_time]);
+  return data;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NatsProvider,
+  useNatsConnection,
+  useNatsKvTable,
+  useNatsStream
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/NatsProvider.tsx","../src/useNatsConnection.ts","../src/useNatsKvTable.ts","../src/useNatsStream.ts"],"sourcesContent":["export { NatsProvider } from './NatsProvider';\nexport type { NatsProviderProps } from './NatsProvider';\n\nexport { useNatsConnection } from './useNatsConnection';\nexport { useNatsKvTable } from './useNatsKvTable';\nexport type { NatsKvTableOptions } from './useNatsKvTable';\nexport { useNatsStream } from './useNatsStream';\nexport type { NatsStreamOptions } from './useNatsStream';\n\nexport type { NatsEntry, NatsMessage } from './types';\n","import { createContext, useEffect, useState, useRef, useMemo } from 'react';\nimport { wsconnect, NatsConnection, ConnectionOptions } from '@nats-io/nats-core';\n\nexport const NatsContext = createContext<NatsConnection | null>(null);\n\nexport interface NatsProviderProps {\n  url: string;\n  options?: Partial<ConnectionOptions>;\n  children: React.ReactNode;\n}\n\nconst DEFAULT_OPTIONS: Partial<ConnectionOptions> = {\n  reconnect: true,\n  pingInterval: 10000,\n  maxPingOut: 5,\n};\n\nexport const NatsProvider: React.FC<NatsProviderProps> = ({\n  url,\n  options,\n  children,\n}) => {\n  const [connection, setConnection] = useState<NatsConnection | null>(null);\n  const connRef = useRef<NatsConnection | null>(null);\n  const isConnectingRef = useRef(false);\n  const connectionOptions = useMemo(\n    () => ({ ...DEFAULT_OPTIONS, ...options }),\n    [options]\n  );\n\n  useEffect(() => {\n    if (isConnectingRef.current || connRef.current) {\n      return;\n    }\n\n    isConnectingRef.current = true;\n    let isActive = true;\n\n    const establishConnection = async () => {\n      try {\n        const newConnection = await wsconnect({\n          servers: url,\n          ...connectionOptions,\n        });\n        if (isActive) {\n          connRef.current = newConnection;\n          setConnection(newConnection);\n\n          newConnection.closed().then((err: Error | void) => {\n            console.log('NATS connection closed:', err?.message || 'Manual close');\n            if (isActive) {\n              connRef.current = null;\n              setConnection(null);\n              isConnectingRef.current = false;\n            }\n          });\n        } else {\n          newConnection.close()\n            .then(() => console.log('Closed superseded connection'))\n            .catch((err) => {\n              console.error('Error closing superseded connection:', err);\n            });\n        }\n      } catch (err) {\n        if (isActive) {\n          console.error('NATS connection failed:', err);\n          setConnection(null);\n          isConnectingRef.current = false;\n        }\n      }\n    };\n\n    establishConnection();\n\n    return () => {\n      isActive = false;\n      if (connRef.current) {\n        connRef.current.close().catch((err) => {\n          console.error('Error closing NATS connection:', err);\n        });\n        connRef.current = null;\n        setConnection(null);\n      }\n      isConnectingRef.current = false;\n    };\n  }, [url, connectionOptions]);\n\n  return (\n    <NatsContext.Provider value={connection}>\n      {children}\n    </NatsContext.Provider>\n  );\n};\n","import { useContext } from 'react';\nimport { NatsConnection } from '@nats-io/nats-core';\nimport { NatsContext } from './NatsProvider';\n\nexport function useNatsConnection(): NatsConnection | null {\n  const connection = useContext(NatsContext);\n  return connection;\n}\n","import { useEffect, useRef, useState } from 'react';\nimport { jetstream } from '@nats-io/jetstream';\nimport { KV, Kvm, KvWatchEntry } from '@nats-io/kv';\nimport { QueuedIterator } from '@nats-io/nats-core';\nimport { useNatsConnection } from './useNatsConnection';\nimport { NatsEntry } from './types';\n\nexport interface NatsKvTableOptions<T, U> {\n  bucketName: string;\n  decoder: { decode: (data: Uint8Array) => T };\n  enrich?: (key: string, created: Date, decoded: T) => U;\n  refreshInterval?: number;\n  key?: string | string[];\n}\n\nconst stableUpsert = (\n  arr: NatsEntry<any>[],\n  newEntry: NatsEntry<any>,\n  inPlace: boolean = false\n) => {\n  const index = arr.findIndex((item) => item.key === newEntry.key);\n  if (index >= 0) {\n    if (inPlace) {\n      arr[index] = newEntry;\n      return arr;\n    }\n    return [...arr.slice(0, index), newEntry, ...arr.slice(index + 1)];\n  } else {\n    if (inPlace) {\n      arr.push(newEntry);\n      arr.sort((a, b) => a.key.localeCompare(b.key));\n      return arr;\n    }\n    return [...arr, newEntry].sort((a, b) => a.key.localeCompare(b.key));\n  }\n};\n\nexport function useNatsKvTable<T, U = T>({\n  bucketName,\n  decoder,\n  enrich,\n  refreshInterval = 50,\n  key,\n}: NatsKvTableOptions<T, U>) {\n  const connection = useNatsConnection();\n  const [entries, setEntries] = useState<NatsEntry<U>[]>([]);\n  const pendingUpdates = useRef<NatsEntry<U>[]>([]);\n\n  useEffect(() => {\n    if (!connection) return;\n\n    let kv: KV | undefined;\n    let watch: QueuedIterator<KvWatchEntry> | undefined;\n    let interval: ReturnType<typeof setInterval> | undefined;\n\n    const setupNats = async () => {\n      const js = jetstream(connection);\n      const kvm = new Kvm(js);\n      kv = await kvm.open(bucketName, { bindOnly: true });\n      watch = await kv.watch({ key });\n\n      const flushUpdates = () => {\n        const updatesToProcess = [...pendingUpdates.current];\n        if (updatesToProcess.length > 0) {\n          pendingUpdates.current = [];\n          setEntries((prev) => {\n            const newEntries = [...prev];\n            return updatesToProcess.reduce(\n              (acc, newEntry) => stableUpsert(acc, newEntry, true),\n              newEntries\n            );\n          });\n        }\n      };\n\n      if (refreshInterval > 0) {\n        flushUpdates();\n        interval = setInterval(flushUpdates, refreshInterval);\n\n        (async () => {\n          for await (const e of watch) {\n            if (e.operation === 'PUT') {\n              const decoded = decoder.decode(e.value);\n              const enrichedValue = enrich\n                ? enrich(e.key, e.created, decoded)\n                : (decoded as unknown as U);\n              const newEntry: NatsEntry<U> = {\n                key: e.key,\n                value: enrichedValue,\n                created: e.created,\n              };\n              pendingUpdates.current.push(newEntry);\n            } else if (e.operation === 'DEL' || e.operation === 'PURGE') {\n              pendingUpdates.current = pendingUpdates.current.filter(\n                (item) => item.key !== e.key\n              );\n              setEntries((prev) => prev.filter((item) => item.key !== e.key));\n            }\n          }\n        })();\n      } else {\n        (async () => {\n          for await (const e of watch) {\n            if (e.operation === 'PUT') {\n              const decoded = decoder.decode(e.value);\n              const enrichedValue = enrich\n                ? enrich(e.key, e.created, decoded)\n                : (decoded as unknown as U);\n              const newEntry: NatsEntry<U> = {\n                key: e.key,\n                value: enrichedValue,\n                created: e.created,\n              };\n              setEntries((prev) => stableUpsert(prev, newEntry));\n            } else if (e.operation === 'DEL' || e.operation === 'PURGE') {\n              setEntries((prev) => prev.filter((item) => item.key !== e.key));\n            }\n          }\n        })();\n      }\n    };\n\n    setupNats().catch((err) => console.error('NATS setup error:', err));\n\n    return () => {\n      watch?.stop();\n      if (interval) clearInterval(interval);\n      kv = undefined;\n      watch = undefined;\n    };\n  }, [bucketName, connection, decoder, enrich, key, refreshInterval]);\n\n  return entries;\n}\n","import { useEffect, useState } from 'react';\nimport {\n  jetstream,\n  Consumer,\n  DeliverPolicy,\n  OrderedConsumerOptions,\n} from '@nats-io/jetstream';\nimport { useNatsConnection } from './useNatsConnection';\nimport { NatsMessage } from './types';\n\nexport interface NatsStreamOptions<T> {\n  stream?: string;\n  subject?: string | string[];\n  decoder: { decode: (data: Uint8Array) => T };\n  reducer: {\n    reduce: (arr: NatsMessage<T>[], element: NatsMessage<T>) => NatsMessage<T>[];\n  };\n  opt_start_time?: Date;\n}\n\nexport function useNatsStream<T>({\n  stream,\n  decoder,\n  reducer,\n  subject,\n  opt_start_time,\n}: NatsStreamOptions<T>) {\n  const connection = useNatsConnection();\n  const [data, setData] = useState<NatsMessage<T>[]>([]);\n\n  useEffect(() => {\n    setData([]);\n    if (!connection) return;\n    if (!opt_start_time) return;\n    if (!stream) return;\n\n    let isCurrent = true;\n    let c: Consumer | null = null;\n\n    const setupNats = async () => {\n      const js = jetstream(connection);\n      const opt: Partial<OrderedConsumerOptions> = {};\n\n      if (opt_start_time) {\n        opt.opt_start_time = opt_start_time.toISOString();\n        opt.deliver_policy = DeliverPolicy.StartTime;\n      }\n\n      if (subject) {\n        opt.filter_subjects = subject;\n      }\n\n      c = await js.consumers.get(stream, opt);\n\n      try {\n        const messages = await c.consume({ max_messages: 1 });\n        let effectData: NatsMessage<T>[] = [];\n\n        for await (const m of messages) {\n          const d: NatsMessage<T> = {\n            received: m.time,\n            subject: m.subject,\n            value: decoder.decode(m.data),\n          };\n\n          effectData = reducer.reduce(effectData, d);\n          m.ack();\n\n          if (!isCurrent) {\n            break;\n          }\n\n          setData(effectData);\n        }\n      } finally {\n        if (!(await c.delete())) {\n          console.warn(`Failed to delete consumer for stream ${stream}`);\n        }\n      }\n    };\n\n    setupNats().catch((error) => {\n      if (error.name === 'AbortError') {\n        return;\n      }\n      if (isCurrent) {\n        console.error('NATS setup error:', error);\n      }\n    });\n\n    return () => {\n      isCurrent = false;\n    };\n  }, [connection, stream, decoder, reducer, subject, opt_start_time]);\n\n  return data;\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_jetstream"]}

package/dist/index.mjs

@@ -0,0 +1,263 @@
+// src/NatsProvider.tsx
+import { createContext, useEffect, useState, useRef, useMemo } from "react";
+import { wsconnect } from "@nats-io/nats-core";
+import { jsx } from "react/jsx-runtime";
+var NatsContext = createContext(null);
+var DEFAULT_OPTIONS = {
+  reconnect: true,
+  pingInterval: 1e4,
+  maxPingOut: 5
+};
+var NatsProvider = ({
+  url,
+  options,
+  children
+}) => {
+  const [connection, setConnection] = useState(null);
+  const connRef = useRef(null);
+  const isConnectingRef = useRef(false);
+  const connectionOptions = useMemo(
+    () => ({ ...DEFAULT_OPTIONS, ...options }),
+    [options]
+  );
+  useEffect(() => {
+    if (isConnectingRef.current || connRef.current) {
+      return;
+    }
+    isConnectingRef.current = true;
+    let isActive = true;
+    const establishConnection = async () => {
+      try {
+        const newConnection = await wsconnect({
+          servers: url,
+          ...connectionOptions
+        });
+        if (isActive) {
+          connRef.current = newConnection;
+          setConnection(newConnection);
+          newConnection.closed().then((err) => {
+            console.log("NATS connection closed:", err?.message || "Manual close");
+            if (isActive) {
+              connRef.current = null;
+              setConnection(null);
+              isConnectingRef.current = false;
+            }
+          });
+        } else {
+          newConnection.close().then(() => console.log("Closed superseded connection")).catch((err) => {
+            console.error("Error closing superseded connection:", err);
+          });
+        }
+      } catch (err) {
+        if (isActive) {
+          console.error("NATS connection failed:", err);
+          setConnection(null);
+          isConnectingRef.current = false;
+        }
+      }
+    };
+    establishConnection();
+    return () => {
+      isActive = false;
+      if (connRef.current) {
+        connRef.current.close().catch((err) => {
+          console.error("Error closing NATS connection:", err);
+        });
+        connRef.current = null;
+        setConnection(null);
+      }
+      isConnectingRef.current = false;
+    };
+  }, [url, connectionOptions]);
+  return /* @__PURE__ */ jsx(NatsContext.Provider, { value: connection, children });
+};
+
+// src/useNatsConnection.ts
+import { useContext } from "react";
+function useNatsConnection() {
+  const connection = useContext(NatsContext);
+  return connection;
+}
+
+// src/useNatsKvTable.ts
+import { useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
+import { jetstream } from "@nats-io/jetstream";
+import { Kvm } from "@nats-io/kv";
+var stableUpsert = (arr, newEntry, inPlace = false) => {
+  const index = arr.findIndex((item) => item.key === newEntry.key);
+  if (index >= 0) {
+    if (inPlace) {
+      arr[index] = newEntry;
+      return arr;
+    }
+    return [...arr.slice(0, index), newEntry, ...arr.slice(index + 1)];
+  } else {
+    if (inPlace) {
+      arr.push(newEntry);
+      arr.sort((a, b) => a.key.localeCompare(b.key));
+      return arr;
+    }
+    return [...arr, newEntry].sort((a, b) => a.key.localeCompare(b.key));
+  }
+};
+function useNatsKvTable({
+  bucketName,
+  decoder,
+  enrich,
+  refreshInterval = 50,
+  key
+}) {
+  const connection = useNatsConnection();
+  const [entries, setEntries] = useState2([]);
+  const pendingUpdates = useRef2([]);
+  useEffect2(() => {
+    if (!connection) return;
+    let kv;
+    let watch;
+    let interval;
+    const setupNats = async () => {
+      const js = jetstream(connection);
+      const kvm = new Kvm(js);
+      kv = await kvm.open(bucketName, { bindOnly: true });
+      watch = await kv.watch({ key });
+      const flushUpdates = () => {
+        const updatesToProcess = [...pendingUpdates.current];
+        if (updatesToProcess.length > 0) {
+          pendingUpdates.current = [];
+          setEntries((prev) => {
+            const newEntries = [...prev];
+            return updatesToProcess.reduce(
+              (acc, newEntry) => stableUpsert(acc, newEntry, true),
+              newEntries
+            );
+          });
+        }
+      };
+      if (refreshInterval > 0) {
+        flushUpdates();
+        interval = setInterval(flushUpdates, refreshInterval);
+        (async () => {
+          for await (const e of watch) {
+            if (e.operation === "PUT") {
+              const decoded = decoder.decode(e.value);
+              const enrichedValue = enrich ? enrich(e.key, e.created, decoded) : decoded;
+              const newEntry = {
+                key: e.key,
+                value: enrichedValue,
+                created: e.created
+              };
+              pendingUpdates.current.push(newEntry);
+            } else if (e.operation === "DEL" || e.operation === "PURGE") {
+              pendingUpdates.current = pendingUpdates.current.filter(
+                (item) => item.key !== e.key
+              );
+              setEntries((prev) => prev.filter((item) => item.key !== e.key));
+            }
+          }
+        })();
+      } else {
+        (async () => {
+          for await (const e of watch) {
+            if (e.operation === "PUT") {
+              const decoded = decoder.decode(e.value);
+              const enrichedValue = enrich ? enrich(e.key, e.created, decoded) : decoded;
+              const newEntry = {
+                key: e.key,
+                value: enrichedValue,
+                created: e.created
+              };
+              setEntries((prev) => stableUpsert(prev, newEntry));
+            } else if (e.operation === "DEL" || e.operation === "PURGE") {
+              setEntries((prev) => prev.filter((item) => item.key !== e.key));
+            }
+          }
+        })();
+      }
+    };
+    setupNats().catch((err) => console.error("NATS setup error:", err));
+    return () => {
+      watch?.stop();
+      if (interval) clearInterval(interval);
+      kv = void 0;
+      watch = void 0;
+    };
+  }, [bucketName, connection, decoder, enrich, key, refreshInterval]);
+  return entries;
+}
+
+// src/useNatsStream.ts
+import { useEffect as useEffect3, useState as useState3 } from "react";
+import {
+  jetstream as jetstream2,
+  DeliverPolicy
+} from "@nats-io/jetstream";
+function useNatsStream({
+  stream,
+  decoder,
+  reducer,
+  subject,
+  opt_start_time
+}) {
+  const connection = useNatsConnection();
+  const [data, setData] = useState3([]);
+  useEffect3(() => {
+    setData([]);
+    if (!connection) return;
+    if (!opt_start_time) return;
+    if (!stream) return;
+    let isCurrent = true;
+    let c = null;
+    const setupNats = async () => {
+      const js = jetstream2(connection);
+      const opt = {};
+      if (opt_start_time) {
+        opt.opt_start_time = opt_start_time.toISOString();
+        opt.deliver_policy = DeliverPolicy.StartTime;
+      }
+      if (subject) {
+        opt.filter_subjects = subject;
+      }
+      c = await js.consumers.get(stream, opt);
+      try {
+        const messages = await c.consume({ max_messages: 1 });
+        let effectData = [];
+        for await (const m of messages) {
+          const d = {
+            received: m.time,
+            subject: m.subject,
+            value: decoder.decode(m.data)
+          };
+          effectData = reducer.reduce(effectData, d);
+          m.ack();
+          if (!isCurrent) {
+            break;
+          }
+          setData(effectData);
+        }
+      } finally {
+        if (!await c.delete()) {
+          console.warn(`Failed to delete consumer for stream ${stream}`);
+        }
+      }
+    };
+    setupNats().catch((error) => {
+      if (error.name === "AbortError") {
+        return;
+      }
+      if (isCurrent) {
+        console.error("NATS setup error:", error);
+      }
+    });
+    return () => {
+      isCurrent = false;
+    };
+  }, [connection, stream, decoder, reducer, subject, opt_start_time]);
+  return data;
+}
+export {
+  NatsProvider,
+  useNatsConnection,
+  useNatsKvTable,
+  useNatsStream
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/NatsProvider.tsx","../src/useNatsConnection.ts","../src/useNatsKvTable.ts","../src/useNatsStream.ts"],"sourcesContent":["import { createContext, useEffect, useState, useRef, useMemo } from 'react';\nimport { wsconnect, NatsConnection, ConnectionOptions } from '@nats-io/nats-core';\n\nexport const NatsContext = createContext<NatsConnection | null>(null);\n\nexport interface NatsProviderProps {\n  url: string;\n  options?: Partial<ConnectionOptions>;\n  children: React.ReactNode;\n}\n\nconst DEFAULT_OPTIONS: Partial<ConnectionOptions> = {\n  reconnect: true,\n  pingInterval: 10000,\n  maxPingOut: 5,\n};\n\nexport const NatsProvider: React.FC<NatsProviderProps> = ({\n  url,\n  options,\n  children,\n}) => {\n  const [connection, setConnection] = useState<NatsConnection | null>(null);\n  const connRef = useRef<NatsConnection | null>(null);\n  const isConnectingRef = useRef(false);\n  const connectionOptions = useMemo(\n    () => ({ ...DEFAULT_OPTIONS, ...options }),\n    [options]\n  );\n\n  useEffect(() => {\n    if (isConnectingRef.current || connRef.current) {\n      return;\n    }\n\n    isConnectingRef.current = true;\n    let isActive = true;\n\n    const establishConnection = async () => {\n      try {\n        const newConnection = await wsconnect({\n          servers: url,\n          ...connectionOptions,\n        });\n        if (isActive) {\n          connRef.current = newConnection;\n          setConnection(newConnection);\n\n          newConnection.closed().then((err: Error | void) => {\n            console.log('NATS connection closed:', err?.message || 'Manual close');\n            if (isActive) {\n              connRef.current = null;\n              setConnection(null);\n              isConnectingRef.current = false;\n            }\n          });\n        } else {\n          newConnection.close()\n            .then(() => console.log('Closed superseded connection'))\n            .catch((err) => {\n              console.error('Error closing superseded connection:', err);\n            });\n        }\n      } catch (err) {\n        if (isActive) {\n          console.error('NATS connection failed:', err);\n          setConnection(null);\n          isConnectingRef.current = false;\n        }\n      }\n    };\n\n    establishConnection();\n\n    return () => {\n      isActive = false;\n      if (connRef.current) {\n        connRef.current.close().catch((err) => {\n          console.error('Error closing NATS connection:', err);\n        });\n        connRef.current = null;\n        setConnection(null);\n      }\n      isConnectingRef.current = false;\n    };\n  }, [url, connectionOptions]);\n\n  return (\n    <NatsContext.Provider value={connection}>\n      {children}\n    </NatsContext.Provider>\n  );\n};\n","import { useContext } from 'react';\nimport { NatsConnection } from '@nats-io/nats-core';\nimport { NatsContext } from './NatsProvider';\n\nexport function useNatsConnection(): NatsConnection | null {\n  const connection = useContext(NatsContext);\n  return connection;\n}\n","import { useEffect, useRef, useState } from 'react';\nimport { jetstream } from '@nats-io/jetstream';\nimport { KV, Kvm, KvWatchEntry } from '@nats-io/kv';\nimport { QueuedIterator } from '@nats-io/nats-core';\nimport { useNatsConnection } from './useNatsConnection';\nimport { NatsEntry } from './types';\n\nexport interface NatsKvTableOptions<T, U> {\n  bucketName: string;\n  decoder: { decode: (data: Uint8Array) => T };\n  enrich?: (key: string, created: Date, decoded: T) => U;\n  refreshInterval?: number;\n  key?: string | string[];\n}\n\nconst stableUpsert = (\n  arr: NatsEntry<any>[],\n  newEntry: NatsEntry<any>,\n  inPlace: boolean = false\n) => {\n  const index = arr.findIndex((item) => item.key === newEntry.key);\n  if (index >= 0) {\n    if (inPlace) {\n      arr[index] = newEntry;\n      return arr;\n    }\n    return [...arr.slice(0, index), newEntry, ...arr.slice(index + 1)];\n  } else {\n    if (inPlace) {\n      arr.push(newEntry);\n      arr.sort((a, b) => a.key.localeCompare(b.key));\n      return arr;\n    }\n    return [...arr, newEntry].sort((a, b) => a.key.localeCompare(b.key));\n  }\n};\n\nexport function useNatsKvTable<T, U = T>({\n  bucketName,\n  decoder,\n  enrich,\n  refreshInterval = 50,\n  key,\n}: NatsKvTableOptions<T, U>) {\n  const connection = useNatsConnection();\n  const [entries, setEntries] = useState<NatsEntry<U>[]>([]);\n  const pendingUpdates = useRef<NatsEntry<U>[]>([]);\n\n  useEffect(() => {\n    if (!connection) return;\n\n    let kv: KV | undefined;\n    let watch: QueuedIterator<KvWatchEntry> | undefined;\n    let interval: ReturnType<typeof setInterval> | undefined;\n\n    const setupNats = async () => {\n      const js = jetstream(connection);\n      const kvm = new Kvm(js);\n      kv = await kvm.open(bucketName, { bindOnly: true });\n      watch = await kv.watch({ key });\n\n      const flushUpdates = () => {\n        const updatesToProcess = [...pendingUpdates.current];\n        if (updatesToProcess.length > 0) {\n          pendingUpdates.current = [];\n          setEntries((prev) => {\n            const newEntries = [...prev];\n            return updatesToProcess.reduce(\n              (acc, newEntry) => stableUpsert(acc, newEntry, true),\n              newEntries\n            );\n          });\n        }\n      };\n\n      if (refreshInterval > 0) {\n        flushUpdates();\n        interval = setInterval(flushUpdates, refreshInterval);\n\n        (async () => {\n          for await (const e of watch) {\n            if (e.operation === 'PUT') {\n              const decoded = decoder.decode(e.value);\n              const enrichedValue = enrich\n                ? enrich(e.key, e.created, decoded)\n                : (decoded as unknown as U);\n              const newEntry: NatsEntry<U> = {\n                key: e.key,\n                value: enrichedValue,\n                created: e.created,\n              };\n              pendingUpdates.current.push(newEntry);\n            } else if (e.operation === 'DEL' || e.operation === 'PURGE') {\n              pendingUpdates.current = pendingUpdates.current.filter(\n                (item) => item.key !== e.key\n              );\n              setEntries((prev) => prev.filter((item) => item.key !== e.key));\n            }\n          }\n        })();\n      } else {\n        (async () => {\n          for await (const e of watch) {\n            if (e.operation === 'PUT') {\n              const decoded = decoder.decode(e.value);\n              const enrichedValue = enrich\n                ? enrich(e.key, e.created, decoded)\n                : (decoded as unknown as U);\n              const newEntry: NatsEntry<U> = {\n                key: e.key,\n                value: enrichedValue,\n                created: e.created,\n              };\n              setEntries((prev) => stableUpsert(prev, newEntry));\n            } else if (e.operation === 'DEL' || e.operation === 'PURGE') {\n              setEntries((prev) => prev.filter((item) => item.key !== e.key));\n            }\n          }\n        })();\n      }\n    };\n\n    setupNats().catch((err) => console.error('NATS setup error:', err));\n\n    return () => {\n      watch?.stop();\n      if (interval) clearInterval(interval);\n      kv = undefined;\n      watch = undefined;\n    };\n  }, [bucketName, connection, decoder, enrich, key, refreshInterval]);\n\n  return entries;\n}\n","import { useEffect, useState } from 'react';\nimport {\n  jetstream,\n  Consumer,\n  DeliverPolicy,\n  OrderedConsumerOptions,\n} from '@nats-io/jetstream';\nimport { useNatsConnection } from './useNatsConnection';\nimport { NatsMessage } from './types';\n\nexport interface NatsStreamOptions<T> {\n  stream?: string;\n  subject?: string | string[];\n  decoder: { decode: (data: Uint8Array) => T };\n  reducer: {\n    reduce: (arr: NatsMessage<T>[], element: NatsMessage<T>) => NatsMessage<T>[];\n  };\n  opt_start_time?: Date;\n}\n\nexport function useNatsStream<T>({\n  stream,\n  decoder,\n  reducer,\n  subject,\n  opt_start_time,\n}: NatsStreamOptions<T>) {\n  const connection = useNatsConnection();\n  const [data, setData] = useState<NatsMessage<T>[]>([]);\n\n  useEffect(() => {\n    setData([]);\n    if (!connection) return;\n    if (!opt_start_time) return;\n    if (!stream) return;\n\n    let isCurrent = true;\n    let c: Consumer | null = null;\n\n    const setupNats = async () => {\n      const js = jetstream(connection);\n      const opt: Partial<OrderedConsumerOptions> = {};\n\n      if (opt_start_time) {\n        opt.opt_start_time = opt_start_time.toISOString();\n        opt.deliver_policy = DeliverPolicy.StartTime;\n      }\n\n      if (subject) {\n        opt.filter_subjects = subject;\n      }\n\n      c = await js.consumers.get(stream, opt);\n\n      try {\n        const messages = await c.consume({ max_messages: 1 });\n        let effectData: NatsMessage<T>[] = [];\n\n        for await (const m of messages) {\n          const d: NatsMessage<T> = {\n            received: m.time,\n            subject: m.subject,\n            value: decoder.decode(m.data),\n          };\n\n          effectData = reducer.reduce(effectData, d);\n          m.ack();\n\n          if (!isCurrent) {\n            break;\n          }\n\n          setData(effectData);\n        }\n      } finally {\n        if (!(await c.delete())) {\n          console.warn(`Failed to delete consumer for stream ${stream}`);\n        }\n      }\n    };\n\n    setupNats().catch((error) => {\n      if (error.name === 'AbortError') {\n        return;\n      }\n      if (isCurrent) {\n        console.error('NATS setup error:', error);\n      }\n    });\n\n    return () => {\n      isCurrent = false;\n    };\n  }, [connection, stream, decoder, reducer, subject, opt_start_time]);\n\n  return data;\n}\n"],"mappings":"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","names":["useEffect","useRef","useState","useState","useRef","useEffect","useEffect","useState","jetstream","useState","useEffect","jetstream"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "react-nats",
+  "version": "0.1.0",
+  "description": "React hooks for NATS messaging and JetStream",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts,.tsx",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react",
+    "nats",
+    "jetstream",
+    "hooks",
+    "websocket",
+    "messaging",
+    "kv",
+    "key-value"
+  ],
+  "author": "jeff@jeffplourde.com",
+  "license": "MIT",
+  "peerDependencies": {
+    "@nats-io/jetstream": "^3.0.2-1",
+    "@nats-io/kv": "^3.0.2-1",
+    "@nats-io/nats-core": "^3.0.2-1",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.39.2",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeffplourde/react-nats"
+  }
+}