@restless-stream/react 0.1.0

package/dist/index.cjs

@@ -0,0 +1,310 @@
+"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, {
+  DEFAULT_MAX_EVENTS: () => DEFAULT_MAX_EVENTS,
+  RestlessProvider: () => RestlessProvider,
+  useDirectStream: () => useDirectStream,
+  useManagedStream: () => useManagedStream,
+  useRestlessClient: () => useRestlessClient,
+  useStreamSubscription: () => useStreamSubscription
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/provider.ts
+var import_core = require("@restless-stream/core");
+var import_react = require("react");
+var RestlessClientContext = (0, import_react.createContext)(null);
+function RestlessProvider({
+  apiBaseUrl,
+  apiKey,
+  children,
+  client,
+  config,
+  fetch,
+  headers,
+  streamBaseUrl
+}) {
+  const inlineConfig = (0, import_react.useMemo)(
+    () => compactConfig({
+      apiBaseUrl,
+      apiKey,
+      fetch,
+      headers,
+      streamBaseUrl
+    }),
+    [apiBaseUrl, apiKey, fetch, headers, streamBaseUrl]
+  );
+  const providerConfig = config ?? inlineConfig;
+  const contextClient = (0, import_react.useMemo)(() => client ?? (0, import_core.createRestlessClient)(providerConfig), [client, providerConfig]);
+  return (0, import_react.createElement)(RestlessClientContext.Provider, { value: contextClient }, children);
+}
+function useRestlessClient() {
+  const client = (0, import_react.useContext)(RestlessClientContext);
+  if (!client) {
+    throw new Error("useRestlessClient must be used within a RestlessProvider or with an explicit client option.");
+  }
+  return client;
+}
+function useOptionalRestlessClient() {
+  return (0, import_react.useContext)(RestlessClientContext);
+}
+function compactConfig(config) {
+  return Object.fromEntries(Object.entries(config).filter(([, value]) => value !== void 0));
+}
+
+// src/stream-subscription.ts
+var import_react2 = require("react");
+
+// src/stream-subscription-types.ts
+var DEFAULT_MAX_EVENTS = 100;
+
+// src/stream-subscription-utils.ts
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function appendEvent(currentEvents, event, maxEvents) {
+  if (maxEvents === 0) {
+    return [];
+  }
+  const nextEvents = [...currentEvents, event];
+  return nextEvents.length > maxEvents ? nextEvents.slice(nextEvents.length - maxEvents) : nextEvents;
+}
+function normalizeMaxEvents(maxEvents) {
+  if (!Number.isFinite(maxEvents)) {
+    return DEFAULT_MAX_EVENTS;
+  }
+  return Math.max(0, Math.floor(maxEvents));
+}
+function resolveReconnectDelay(delay, attempt) {
+  const resolvedDelay = typeof delay === "function" ? delay(attempt) : delay;
+  return Number.isFinite(resolvedDelay) ? Math.max(0, resolvedDelay) : 0;
+}
+async function sleep(milliseconds, signal) {
+  if (milliseconds === 0 || signal.aborted) {
+    return;
+  }
+  return new Promise((resolve) => {
+    const timeout = setTimeout(resolve, milliseconds);
+    signal.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timeout);
+        resolve();
+      },
+      { once: true }
+    );
+  });
+}
+function stableOptionsKey(options) {
+  return JSON.stringify(sortRecord(options));
+}
+function toError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(typeof error === "string" ? error : "Restless stream subscription failed.");
+}
+function sortRecord(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => sortRecord(item));
+  }
+  if (typeof value === "function") {
+    return value.toString();
+  }
+  if (value === null || value === void 0 || typeof value !== "object") {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nestedValue]) => [key, sortRecord(nestedValue)])
+  );
+}
+
+// src/stream-subscription.ts
+function useStreamSubscription(options) {
+  const {
+    client: explicitClient,
+    enabled = true,
+    maxEvents = DEFAULT_MAX_EVENTS,
+    maxReconnectAttempts = 0,
+    onError,
+    onEvent,
+    reconnect = false,
+    reconnectDelayMs = 1e3,
+    ...subscribeOptions
+  } = options;
+  const contextClient = useOptionalRestlessClient();
+  const client = explicitClient ?? contextClient;
+  if (!client) {
+    throw new Error("useStreamSubscription requires a RestlessProvider or an explicit client option.");
+  }
+  const subscriptionClient = client;
+  const boundedMaxEvents = normalizeMaxEvents(maxEvents);
+  const subscribeOptionsKey = stableOptionsKey(subscribeOptions);
+  const abortControllerRef = (0, import_react2.useRef)(null);
+  const onErrorRef = (0, import_react2.useRef)(onError);
+  const onEventRef = (0, import_react2.useRef)(onEvent);
+  const reconnectDelayRef = (0, import_react2.useRef)(reconnectDelayMs);
+  const subscribeOptionsRef = (0, import_react2.useRef)(subscribeOptions);
+  const [connectionToken, setConnectionToken] = (0, import_react2.useState)(0);
+  const [events, setEvents] = (0, import_react2.useState)([]);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const [shouldConnect, setShouldConnect] = (0, import_react2.useState)(enabled);
+  const [status, setStatus] = (0, import_react2.useState)(enabled ? "connecting" : "idle");
+  onErrorRef.current = onError;
+  onEventRef.current = onEvent;
+  reconnectDelayRef.current = reconnectDelayMs;
+  subscribeOptionsRef.current = subscribeOptions;
+  (0, import_react2.useEffect)(() => {
+    setShouldConnect(enabled);
+    setStatus((currentStatus) => {
+      if (enabled) {
+        return currentStatus === "idle" || currentStatus === "closed" ? "connecting" : currentStatus;
+      }
+      return "idle";
+    });
+  }, [enabled]);
+  const connect = (0, import_react2.useCallback)(() => {
+    setError(null);
+    setShouldConnect(true);
+    setStatus((currentStatus) => currentStatus === "open" ? currentStatus : "connecting");
+    setConnectionToken((currentToken) => currentToken + 1);
+  }, []);
+  const disconnect = (0, import_react2.useCallback)(() => {
+    setShouldConnect(false);
+    abortControllerRef.current?.abort();
+    abortControllerRef.current = null;
+    setStatus("closed");
+  }, []);
+  const reset = (0, import_react2.useCallback)(() => {
+    setEvents([]);
+    setError(null);
+  }, []);
+  (0, import_react2.useEffect)(() => {
+    if (!shouldConnect) {
+      return;
+    }
+    let cancelled = false;
+    const abortController = new AbortController();
+    abortControllerRef.current?.abort();
+    abortControllerRef.current = abortController;
+    async function subscribe() {
+      let reconnectAttempt = 0;
+      while (!cancelled) {
+        setStatus(reconnectAttempt > 0 ? "reconnecting" : "connecting");
+        try {
+          const stream = subscriptionClient.streams.subscribeSse({
+            ...subscribeOptionsRef.current,
+            signal: abortController.signal
+          });
+          setError(null);
+          setStatus("open");
+          for await (const event of stream) {
+            if (cancelled) {
+              break;
+            }
+            onEventRef.current?.(event);
+            setEvents((currentEvents) => appendEvent(currentEvents, event, boundedMaxEvents));
+          }
+          if (!cancelled) {
+            setStatus("closed");
+          }
+          break;
+        } catch (caughtError) {
+          if (cancelled || abortController.signal.aborted) {
+            break;
+          }
+          const normalizedError = toError(caughtError);
+          setError(normalizedError);
+          onErrorRef.current?.(normalizedError);
+          if (!reconnect || reconnectAttempt >= maxReconnectAttempts) {
+            setStatus("error");
+            break;
+          }
+          reconnectAttempt += 1;
+          setStatus("reconnecting");
+          await sleep(resolveReconnectDelay(reconnectDelayRef.current, reconnectAttempt), abortController.signal);
+        }
+      }
+    }
+    void subscribe();
+    return () => {
+      cancelled = true;
+      abortController.abort();
+      if (abortControllerRef.current === abortController) {
+        abortControllerRef.current = null;
+      }
+    };
+  }, [
+    boundedMaxEvents,
+    connectionToken,
+    maxReconnectAttempts,
+    reconnect,
+    shouldConnect,
+    subscribeOptionsKey,
+    subscriptionClient
+  ]);
+  const latestEvent = events.at(-1) ?? null;
+  return (0, import_react2.useMemo)(
+    () => ({
+      connect,
+      disconnect,
+      error,
+      events,
+      isConnected: status === "open",
+      isConnecting: status === "connecting" || status === "reconnecting",
+      latestEvent,
+      reset,
+      status
+    }),
+    [connect, disconnect, error, events, latestEvent, reset, status]
+  );
+}
+function useManagedStream(options) {
+  const { sseUrl, stream, enabled, ...subscriptionOptions } = options;
+  const managedSseUrl = sseUrl ?? stream?.sseUrl ?? "";
+  const shouldEnable = typeof enabled === "boolean" ? enabled : isNonEmptyString(managedSseUrl);
+  return useStreamSubscription({
+    ...subscriptionOptions,
+    enabled: shouldEnable,
+    sseUrl: managedSseUrl
+  });
+}
+function useDirectStream(options) {
+  const { directUrl, enabled, session, sseUrl, ...subscriptionOptions } = options;
+  const directSseUrl = directUrl ?? sseUrl ?? session?.sseUrl ?? "";
+  const shouldEnable = typeof enabled === "boolean" ? enabled : isNonEmptyString(directSseUrl);
+  return useStreamSubscription({
+    ...subscriptionOptions,
+    enabled: shouldEnable,
+    sseUrl: directSseUrl
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_MAX_EVENTS,
+  RestlessProvider,
+  useDirectStream,
+  useManagedStream,
+  useRestlessClient,
+  useStreamSubscription
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/provider.ts","../src/stream-subscription.ts","../src/stream-subscription-types.ts","../src/stream-subscription-utils.ts"],"sourcesContent":["export {\n  RestlessProvider,\n  type RestlessProviderProps,\n  useRestlessClient,\n} from './provider.js';\nexport {\n  DEFAULT_MAX_EVENTS,\n  type StreamSubscriptionControls,\n  type StreamSubscriptionStatus,\n  type UseDirectStreamOptions,\n  type UseManagedStreamOptions,\n  type UseStreamSubscriptionOptions,\n  type UseStreamSubscriptionResult,\n  useDirectStream,\n  useManagedStream,\n  useStreamSubscription,\n} from './stream-subscription.js';\n","import { createRestlessClient, type RestlessClient, type RestlessClientConfig } from '@restless-stream/core';\nimport { createContext, createElement, type ReactNode, useContext, useMemo } from 'react';\n\nconst RestlessClientContext = createContext<RestlessClient | null>(null);\ntype InlineRestlessClientConfig = {\n  [K in keyof RestlessClientConfig]-?: RestlessClientConfig[K] | undefined;\n};\n\nexport type RestlessProviderProps = Partial<RestlessClientConfig> & {\n  children?: ReactNode;\n  client?: RestlessClient;\n  config?: RestlessClientConfig;\n};\n\nexport function RestlessProvider({\n  apiBaseUrl,\n  apiKey,\n  children,\n  client,\n  config,\n  fetch,\n  headers,\n  streamBaseUrl,\n}: RestlessProviderProps) {\n  const inlineConfig = useMemo(\n    () =>\n      compactConfig({\n        apiBaseUrl,\n        apiKey,\n        fetch,\n        headers,\n        streamBaseUrl,\n      }),\n    [apiBaseUrl, apiKey, fetch, headers, streamBaseUrl],\n  );\n  const providerConfig = config ?? inlineConfig;\n  const contextClient = useMemo(() => client ?? createRestlessClient(providerConfig), [client, providerConfig]);\n\n  return createElement(RestlessClientContext.Provider, { value: contextClient }, children);\n}\n\nexport function useRestlessClient(): RestlessClient {\n  const client = useContext(RestlessClientContext);\n\n  if (!client) {\n    throw new Error('useRestlessClient must be used within a RestlessProvider or with an explicit client option.');\n  }\n\n  return client;\n}\n\nexport function useOptionalRestlessClient(): RestlessClient | null {\n  return useContext(RestlessClientContext);\n}\n\nfunction compactConfig(config: InlineRestlessClientConfig): RestlessClientConfig {\n  return Object.fromEntries(Object.entries(config).filter(([, value]) => value !== undefined));\n}\n","import type { RestlessStreamEvent } from '@restless-stream/core';\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { useOptionalRestlessClient } from './provider.js';\nimport {\n  DEFAULT_MAX_EVENTS,\n  type StreamSubscriptionStatus,\n  type UseDirectStreamOptions,\n  type UseManagedStreamOptions,\n  type UseStreamSubscriptionOptions,\n  type UseStreamSubscriptionResult,\n} from './stream-subscription-types.js';\nimport {\n  appendEvent,\n  isNonEmptyString,\n  normalizeMaxEvents,\n  resolveReconnectDelay,\n  sleep,\n  stableOptionsKey,\n  toError,\n} from './stream-subscription-utils.js';\n\nexport { DEFAULT_MAX_EVENTS } from './stream-subscription-types.js';\nexport type {\n  StreamSubscriptionControls,\n  StreamSubscriptionStatus,\n  UseDirectStreamOptions,\n  UseManagedStreamOptions,\n  UseStreamSubscriptionOptions,\n  UseStreamSubscriptionResult,\n} from './stream-subscription-types.js';\n\nexport function useStreamSubscription(options: UseStreamSubscriptionOptions): UseStreamSubscriptionResult {\n  const {\n    client: explicitClient,\n    enabled = true,\n    maxEvents = DEFAULT_MAX_EVENTS,\n    maxReconnectAttempts = 0,\n    onError,\n    onEvent,\n    reconnect = false,\n    reconnectDelayMs = 1000,\n    ...subscribeOptions\n  } = options;\n  const contextClient = useOptionalRestlessClient();\n  const client = explicitClient ?? contextClient;\n\n  if (!client) {\n    throw new Error('useStreamSubscription requires a RestlessProvider or an explicit client option.');\n  }\n\n  const subscriptionClient = client;\n\n  const boundedMaxEvents = normalizeMaxEvents(maxEvents);\n  const subscribeOptionsKey = stableOptionsKey(subscribeOptions);\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const onErrorRef = useRef(onError);\n  const onEventRef = useRef(onEvent);\n  const reconnectDelayRef = useRef(reconnectDelayMs);\n  const subscribeOptionsRef = useRef(subscribeOptions);\n  const [connectionToken, setConnectionToken] = useState(0);\n  const [events, setEvents] = useState<RestlessStreamEvent[]>([]);\n  const [error, setError] = useState<Error | null>(null);\n  const [shouldConnect, setShouldConnect] = useState(enabled);\n  const [status, setStatus] = useState<StreamSubscriptionStatus>(enabled ? 'connecting' : 'idle');\n\n  onErrorRef.current = onError;\n  onEventRef.current = onEvent;\n  reconnectDelayRef.current = reconnectDelayMs;\n  subscribeOptionsRef.current = subscribeOptions;\n\n  useEffect(() => {\n    setShouldConnect(enabled);\n    setStatus((currentStatus) => {\n      if (enabled) {\n        return currentStatus === 'idle' || currentStatus === 'closed' ? 'connecting' : currentStatus;\n      }\n\n      return 'idle';\n    });\n  }, [enabled]);\n\n  const connect = useCallback(() => {\n    setError(null);\n    setShouldConnect(true);\n    setStatus((currentStatus) => (currentStatus === 'open' ? currentStatus : 'connecting'));\n    setConnectionToken((currentToken) => currentToken + 1);\n  }, []);\n\n  const disconnect = useCallback(() => {\n    setShouldConnect(false);\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = null;\n    setStatus('closed');\n  }, []);\n\n  const reset = useCallback(() => {\n    setEvents([]);\n    setError(null);\n  }, []);\n\n  useEffect(() => {\n    if (!shouldConnect) {\n      return;\n    }\n\n    let cancelled = false;\n    const abortController = new AbortController();\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = abortController;\n\n    async function subscribe() {\n      let reconnectAttempt = 0;\n\n      while (!cancelled) {\n        setStatus(reconnectAttempt > 0 ? 'reconnecting' : 'connecting');\n\n        try {\n          const stream = subscriptionClient.streams.subscribeSse({\n            ...subscribeOptionsRef.current,\n            signal: abortController.signal,\n          });\n\n          setError(null);\n          setStatus('open');\n\n          for await (const event of stream) {\n            if (cancelled) {\n              break;\n            }\n\n            onEventRef.current?.(event);\n            setEvents((currentEvents) => appendEvent(currentEvents, event, boundedMaxEvents));\n          }\n\n          if (!cancelled) {\n            setStatus('closed');\n          }\n\n          break;\n        } catch (caughtError) {\n          if (cancelled || abortController.signal.aborted) {\n            break;\n          }\n\n          const normalizedError = toError(caughtError);\n          setError(normalizedError);\n          onErrorRef.current?.(normalizedError);\n\n          if (!reconnect || reconnectAttempt >= maxReconnectAttempts) {\n            setStatus('error');\n            break;\n          }\n\n          reconnectAttempt += 1;\n          setStatus('reconnecting');\n          await sleep(resolveReconnectDelay(reconnectDelayRef.current, reconnectAttempt), abortController.signal);\n        }\n      }\n    }\n\n    void subscribe();\n\n    return () => {\n      cancelled = true;\n      abortController.abort();\n\n      if (abortControllerRef.current === abortController) {\n        abortControllerRef.current = null;\n      }\n    };\n  }, [\n    boundedMaxEvents,\n    connectionToken,\n    maxReconnectAttempts,\n    reconnect,\n    shouldConnect,\n    subscribeOptionsKey,\n    subscriptionClient,\n  ]);\n\n  const latestEvent = events.at(-1) ?? null;\n\n  return useMemo(\n    () => ({\n      connect,\n      disconnect,\n      error,\n      events,\n      isConnected: status === 'open',\n      isConnecting: status === 'connecting' || status === 'reconnecting',\n      latestEvent,\n      reset,\n      status,\n    }),\n    [connect, disconnect, error, events, latestEvent, reset, status],\n  );\n}\n\nexport function useManagedStream(options: UseManagedStreamOptions): UseStreamSubscriptionResult {\n  const { sseUrl, stream, enabled, ...subscriptionOptions } = options;\n  const managedSseUrl = sseUrl ?? stream?.sseUrl ?? '';\n  const shouldEnable = typeof enabled === 'boolean' ? enabled : isNonEmptyString(managedSseUrl);\n\n  return useStreamSubscription({\n    ...subscriptionOptions,\n    enabled: shouldEnable,\n    sseUrl: managedSseUrl,\n  });\n}\n\nexport function useDirectStream(options: UseDirectStreamOptions): UseStreamSubscriptionResult {\n  const { directUrl, enabled, session, sseUrl, ...subscriptionOptions } = options;\n  const directSseUrl = directUrl ?? sseUrl ?? session?.sseUrl ?? '';\n  const shouldEnable = typeof enabled === 'boolean' ? enabled : isNonEmptyString(directSseUrl);\n\n  return useStreamSubscription({\n    ...subscriptionOptions,\n    enabled: shouldEnable,\n    sseUrl: directSseUrl,\n  });\n}\n","import type { RestlessClient, RestlessStreamEvent, SubscribeSseOptions } from '@restless-stream/core';\n\nexport const DEFAULT_MAX_EVENTS = 100;\n\nexport type StreamSubscriptionStatus = 'idle' | 'connecting' | 'open' | 'reconnecting' | 'closed' | 'error';\n\nexport interface StreamSubscriptionControls {\n  connect: () => void;\n  disconnect: () => void;\n  reset: () => void;\n}\n\nexport type UseStreamSubscriptionOptions = Omit<SubscribeSseOptions, 'reconnect' | 'reconnectDelayMs'> & {\n  client?: RestlessClient;\n  enabled?: boolean;\n  maxEvents?: number;\n  maxReconnectAttempts?: number;\n  onError?: (error: Error) => void;\n  onEvent?: (event: RestlessStreamEvent) => void;\n  reconnect?: boolean;\n  reconnectDelayMs?: number | ((attempt: number) => number);\n};\n\nexport type UseStreamSubscriptionResult = StreamSubscriptionControls & {\n  error: Error | null;\n  events: RestlessStreamEvent[];\n  isConnected: boolean;\n  isConnecting: boolean;\n  latestEvent: RestlessStreamEvent | null;\n  status: StreamSubscriptionStatus;\n};\n\nexport type UseManagedStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {\n  sseUrl?: SubscribeSseOptions['sseUrl'] | null;\n  stream?: { sseUrl?: string | null } | null;\n};\n\nexport type UseDirectStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {\n  directUrl?: string | null;\n  session?: { sseUrl?: string | null } | null;\n  sseUrl?: SubscribeSseOptions['sseUrl'] | null;\n};\n","import type { RestlessStreamEvent, SubscribeSseOptions } from '@restless-stream/core';\n\nimport { DEFAULT_MAX_EVENTS } from './stream-subscription-types.js';\n\nexport function isNonEmptyString(value: unknown): boolean {\n  return typeof value === 'string' && value.length > 0;\n}\n\nexport function appendEvent(\n  currentEvents: RestlessStreamEvent[],\n  event: RestlessStreamEvent,\n  maxEvents: number,\n): RestlessStreamEvent[] {\n  if (maxEvents === 0) {\n    return [];\n  }\n\n  const nextEvents = [...currentEvents, event];\n  return nextEvents.length > maxEvents ? nextEvents.slice(nextEvents.length - maxEvents) : nextEvents;\n}\n\nexport function normalizeMaxEvents(maxEvents: number): number {\n  if (!Number.isFinite(maxEvents)) {\n    return DEFAULT_MAX_EVENTS;\n  }\n\n  return Math.max(0, Math.floor(maxEvents));\n}\n\nexport function resolveReconnectDelay(delay: number | ((attempt: number) => number), attempt: number): number {\n  const resolvedDelay = typeof delay === 'function' ? delay(attempt) : delay;\n  return Number.isFinite(resolvedDelay) ? Math.max(0, resolvedDelay) : 0;\n}\n\nexport async function sleep(milliseconds: number, signal: AbortSignal): Promise<void> {\n  if (milliseconds === 0 || signal.aborted) {\n    return;\n  }\n\n  return new Promise((resolve) => {\n    const timeout = setTimeout(resolve, milliseconds);\n\n    signal.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timeout);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\nexport function stableOptionsKey(options: Partial<SubscribeSseOptions>): string {\n  return JSON.stringify(sortRecord(options));\n}\n\nexport function toError(error: unknown): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  return new Error(typeof error === 'string' ? error : 'Restless stream subscription failed.');\n}\n\nfunction sortRecord(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => sortRecord(item));\n  }\n\n  if (typeof value === 'function') {\n    return value.toString();\n  }\n\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return value;\n  }\n\n  return Object.fromEntries(\n    Object.entries(value)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([key, nestedValue]) => [key, sortRecord(nestedValue)]),\n  );\n}\n"],"mappings":"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","names":["import_react"]}

package/dist/index.d.cts

@@ -0,0 +1,56 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { RestlessClientConfig, RestlessClient, SubscribeSseOptions, RestlessStreamEvent } from '@restless-stream/core';
+
+type RestlessProviderProps = Partial<RestlessClientConfig> & {
+    children?: ReactNode;
+    client?: RestlessClient;
+    config?: RestlessClientConfig;
+};
+declare function RestlessProvider({ apiBaseUrl, apiKey, children, client, config, fetch, headers, streamBaseUrl, }: RestlessProviderProps): react.FunctionComponentElement<react.ProviderProps<RestlessClient | null>>;
+declare function useRestlessClient(): RestlessClient;
+
+declare const DEFAULT_MAX_EVENTS = 100;
+type StreamSubscriptionStatus = 'idle' | 'connecting' | 'open' | 'reconnecting' | 'closed' | 'error';
+interface StreamSubscriptionControls {
+    connect: () => void;
+    disconnect: () => void;
+    reset: () => void;
+}
+type UseStreamSubscriptionOptions = Omit<SubscribeSseOptions, 'reconnect' | 'reconnectDelayMs'> & {
+    client?: RestlessClient;
+    enabled?: boolean;
+    maxEvents?: number;
+    maxReconnectAttempts?: number;
+    onError?: (error: Error) => void;
+    onEvent?: (event: RestlessStreamEvent) => void;
+    reconnect?: boolean;
+    reconnectDelayMs?: number | ((attempt: number) => number);
+};
+type UseStreamSubscriptionResult = StreamSubscriptionControls & {
+    error: Error | null;
+    events: RestlessStreamEvent[];
+    isConnected: boolean;
+    isConnecting: boolean;
+    latestEvent: RestlessStreamEvent | null;
+    status: StreamSubscriptionStatus;
+};
+type UseManagedStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {
+    sseUrl?: SubscribeSseOptions['sseUrl'] | null;
+    stream?: {
+        sseUrl?: string | null;
+    } | null;
+};
+type UseDirectStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {
+    directUrl?: string | null;
+    session?: {
+        sseUrl?: string | null;
+    } | null;
+    sseUrl?: SubscribeSseOptions['sseUrl'] | null;
+};
+
+declare function useStreamSubscription(options: UseStreamSubscriptionOptions): UseStreamSubscriptionResult;
+declare function useManagedStream(options: UseManagedStreamOptions): UseStreamSubscriptionResult;
+declare function useDirectStream(options: UseDirectStreamOptions): UseStreamSubscriptionResult;
+
+export { DEFAULT_MAX_EVENTS, RestlessProvider, type RestlessProviderProps, type StreamSubscriptionControls, type StreamSubscriptionStatus, type UseDirectStreamOptions, type UseManagedStreamOptions, type UseStreamSubscriptionOptions, type UseStreamSubscriptionResult, useDirectStream, useManagedStream, useRestlessClient, useStreamSubscription };

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { RestlessClientConfig, RestlessClient, SubscribeSseOptions, RestlessStreamEvent } from '@restless-stream/core';
+
+type RestlessProviderProps = Partial<RestlessClientConfig> & {
+    children?: ReactNode;
+    client?: RestlessClient;
+    config?: RestlessClientConfig;
+};
+declare function RestlessProvider({ apiBaseUrl, apiKey, children, client, config, fetch, headers, streamBaseUrl, }: RestlessProviderProps): react.FunctionComponentElement<react.ProviderProps<RestlessClient | null>>;
+declare function useRestlessClient(): RestlessClient;
+
+declare const DEFAULT_MAX_EVENTS = 100;
+type StreamSubscriptionStatus = 'idle' | 'connecting' | 'open' | 'reconnecting' | 'closed' | 'error';
+interface StreamSubscriptionControls {
+    connect: () => void;
+    disconnect: () => void;
+    reset: () => void;
+}
+type UseStreamSubscriptionOptions = Omit<SubscribeSseOptions, 'reconnect' | 'reconnectDelayMs'> & {
+    client?: RestlessClient;
+    enabled?: boolean;
+    maxEvents?: number;
+    maxReconnectAttempts?: number;
+    onError?: (error: Error) => void;
+    onEvent?: (event: RestlessStreamEvent) => void;
+    reconnect?: boolean;
+    reconnectDelayMs?: number | ((attempt: number) => number);
+};
+type UseStreamSubscriptionResult = StreamSubscriptionControls & {
+    error: Error | null;
+    events: RestlessStreamEvent[];
+    isConnected: boolean;
+    isConnecting: boolean;
+    latestEvent: RestlessStreamEvent | null;
+    status: StreamSubscriptionStatus;
+};
+type UseManagedStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {
+    sseUrl?: SubscribeSseOptions['sseUrl'] | null;
+    stream?: {
+        sseUrl?: string | null;
+    } | null;
+};
+type UseDirectStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {
+    directUrl?: string | null;
+    session?: {
+        sseUrl?: string | null;
+    } | null;
+    sseUrl?: SubscribeSseOptions['sseUrl'] | null;
+};
+
+declare function useStreamSubscription(options: UseStreamSubscriptionOptions): UseStreamSubscriptionResult;
+declare function useManagedStream(options: UseManagedStreamOptions): UseStreamSubscriptionResult;
+declare function useDirectStream(options: UseDirectStreamOptions): UseStreamSubscriptionResult;
+
+export { DEFAULT_MAX_EVENTS, RestlessProvider, type RestlessProviderProps, type StreamSubscriptionControls, type StreamSubscriptionStatus, type UseDirectStreamOptions, type UseManagedStreamOptions, type UseStreamSubscriptionOptions, type UseStreamSubscriptionResult, useDirectStream, useManagedStream, useRestlessClient, useStreamSubscription };

package/dist/index.js

@@ -0,0 +1,278 @@
+// src/provider.ts
+import { createRestlessClient } from "@restless-stream/core";
+import { createContext, createElement, useContext, useMemo } from "react";
+var RestlessClientContext = createContext(null);
+function RestlessProvider({
+  apiBaseUrl,
+  apiKey,
+  children,
+  client,
+  config,
+  fetch,
+  headers,
+  streamBaseUrl
+}) {
+  const inlineConfig = useMemo(
+    () => compactConfig({
+      apiBaseUrl,
+      apiKey,
+      fetch,
+      headers,
+      streamBaseUrl
+    }),
+    [apiBaseUrl, apiKey, fetch, headers, streamBaseUrl]
+  );
+  const providerConfig = config ?? inlineConfig;
+  const contextClient = useMemo(() => client ?? createRestlessClient(providerConfig), [client, providerConfig]);
+  return createElement(RestlessClientContext.Provider, { value: contextClient }, children);
+}
+function useRestlessClient() {
+  const client = useContext(RestlessClientContext);
+  if (!client) {
+    throw new Error("useRestlessClient must be used within a RestlessProvider or with an explicit client option.");
+  }
+  return client;
+}
+function useOptionalRestlessClient() {
+  return useContext(RestlessClientContext);
+}
+function compactConfig(config) {
+  return Object.fromEntries(Object.entries(config).filter(([, value]) => value !== void 0));
+}
+
+// src/stream-subscription.ts
+import { useCallback, useEffect, useMemo as useMemo2, useRef, useState } from "react";
+
+// src/stream-subscription-types.ts
+var DEFAULT_MAX_EVENTS = 100;
+
+// src/stream-subscription-utils.ts
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function appendEvent(currentEvents, event, maxEvents) {
+  if (maxEvents === 0) {
+    return [];
+  }
+  const nextEvents = [...currentEvents, event];
+  return nextEvents.length > maxEvents ? nextEvents.slice(nextEvents.length - maxEvents) : nextEvents;
+}
+function normalizeMaxEvents(maxEvents) {
+  if (!Number.isFinite(maxEvents)) {
+    return DEFAULT_MAX_EVENTS;
+  }
+  return Math.max(0, Math.floor(maxEvents));
+}
+function resolveReconnectDelay(delay, attempt) {
+  const resolvedDelay = typeof delay === "function" ? delay(attempt) : delay;
+  return Number.isFinite(resolvedDelay) ? Math.max(0, resolvedDelay) : 0;
+}
+async function sleep(milliseconds, signal) {
+  if (milliseconds === 0 || signal.aborted) {
+    return;
+  }
+  return new Promise((resolve) => {
+    const timeout = setTimeout(resolve, milliseconds);
+    signal.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timeout);
+        resolve();
+      },
+      { once: true }
+    );
+  });
+}
+function stableOptionsKey(options) {
+  return JSON.stringify(sortRecord(options));
+}
+function toError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(typeof error === "string" ? error : "Restless stream subscription failed.");
+}
+function sortRecord(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => sortRecord(item));
+  }
+  if (typeof value === "function") {
+    return value.toString();
+  }
+  if (value === null || value === void 0 || typeof value !== "object") {
+    return value;
+  }
+  return Object.fromEntries(
+    Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nestedValue]) => [key, sortRecord(nestedValue)])
+  );
+}
+
+// src/stream-subscription.ts
+function useStreamSubscription(options) {
+  const {
+    client: explicitClient,
+    enabled = true,
+    maxEvents = DEFAULT_MAX_EVENTS,
+    maxReconnectAttempts = 0,
+    onError,
+    onEvent,
+    reconnect = false,
+    reconnectDelayMs = 1e3,
+    ...subscribeOptions
+  } = options;
+  const contextClient = useOptionalRestlessClient();
+  const client = explicitClient ?? contextClient;
+  if (!client) {
+    throw new Error("useStreamSubscription requires a RestlessProvider or an explicit client option.");
+  }
+  const subscriptionClient = client;
+  const boundedMaxEvents = normalizeMaxEvents(maxEvents);
+  const subscribeOptionsKey = stableOptionsKey(subscribeOptions);
+  const abortControllerRef = useRef(null);
+  const onErrorRef = useRef(onError);
+  const onEventRef = useRef(onEvent);
+  const reconnectDelayRef = useRef(reconnectDelayMs);
+  const subscribeOptionsRef = useRef(subscribeOptions);
+  const [connectionToken, setConnectionToken] = useState(0);
+  const [events, setEvents] = useState([]);
+  const [error, setError] = useState(null);
+  const [shouldConnect, setShouldConnect] = useState(enabled);
+  const [status, setStatus] = useState(enabled ? "connecting" : "idle");
+  onErrorRef.current = onError;
+  onEventRef.current = onEvent;
+  reconnectDelayRef.current = reconnectDelayMs;
+  subscribeOptionsRef.current = subscribeOptions;
+  useEffect(() => {
+    setShouldConnect(enabled);
+    setStatus((currentStatus) => {
+      if (enabled) {
+        return currentStatus === "idle" || currentStatus === "closed" ? "connecting" : currentStatus;
+      }
+      return "idle";
+    });
+  }, [enabled]);
+  const connect = useCallback(() => {
+    setError(null);
+    setShouldConnect(true);
+    setStatus((currentStatus) => currentStatus === "open" ? currentStatus : "connecting");
+    setConnectionToken((currentToken) => currentToken + 1);
+  }, []);
+  const disconnect = useCallback(() => {
+    setShouldConnect(false);
+    abortControllerRef.current?.abort();
+    abortControllerRef.current = null;
+    setStatus("closed");
+  }, []);
+  const reset = useCallback(() => {
+    setEvents([]);
+    setError(null);
+  }, []);
+  useEffect(() => {
+    if (!shouldConnect) {
+      return;
+    }
+    let cancelled = false;
+    const abortController = new AbortController();
+    abortControllerRef.current?.abort();
+    abortControllerRef.current = abortController;
+    async function subscribe() {
+      let reconnectAttempt = 0;
+      while (!cancelled) {
+        setStatus(reconnectAttempt > 0 ? "reconnecting" : "connecting");
+        try {
+          const stream = subscriptionClient.streams.subscribeSse({
+            ...subscribeOptionsRef.current,
+            signal: abortController.signal
+          });
+          setError(null);
+          setStatus("open");
+          for await (const event of stream) {
+            if (cancelled) {
+              break;
+            }
+            onEventRef.current?.(event);
+            setEvents((currentEvents) => appendEvent(currentEvents, event, boundedMaxEvents));
+          }
+          if (!cancelled) {
+            setStatus("closed");
+          }
+          break;
+        } catch (caughtError) {
+          if (cancelled || abortController.signal.aborted) {
+            break;
+          }
+          const normalizedError = toError(caughtError);
+          setError(normalizedError);
+          onErrorRef.current?.(normalizedError);
+          if (!reconnect || reconnectAttempt >= maxReconnectAttempts) {
+            setStatus("error");
+            break;
+          }
+          reconnectAttempt += 1;
+          setStatus("reconnecting");
+          await sleep(resolveReconnectDelay(reconnectDelayRef.current, reconnectAttempt), abortController.signal);
+        }
+      }
+    }
+    void subscribe();
+    return () => {
+      cancelled = true;
+      abortController.abort();
+      if (abortControllerRef.current === abortController) {
+        abortControllerRef.current = null;
+      }
+    };
+  }, [
+    boundedMaxEvents,
+    connectionToken,
+    maxReconnectAttempts,
+    reconnect,
+    shouldConnect,
+    subscribeOptionsKey,
+    subscriptionClient
+  ]);
+  const latestEvent = events.at(-1) ?? null;
+  return useMemo2(
+    () => ({
+      connect,
+      disconnect,
+      error,
+      events,
+      isConnected: status === "open",
+      isConnecting: status === "connecting" || status === "reconnecting",
+      latestEvent,
+      reset,
+      status
+    }),
+    [connect, disconnect, error, events, latestEvent, reset, status]
+  );
+}
+function useManagedStream(options) {
+  const { sseUrl, stream, enabled, ...subscriptionOptions } = options;
+  const managedSseUrl = sseUrl ?? stream?.sseUrl ?? "";
+  const shouldEnable = typeof enabled === "boolean" ? enabled : isNonEmptyString(managedSseUrl);
+  return useStreamSubscription({
+    ...subscriptionOptions,
+    enabled: shouldEnable,
+    sseUrl: managedSseUrl
+  });
+}
+function useDirectStream(options) {
+  const { directUrl, enabled, session, sseUrl, ...subscriptionOptions } = options;
+  const directSseUrl = directUrl ?? sseUrl ?? session?.sseUrl ?? "";
+  const shouldEnable = typeof enabled === "boolean" ? enabled : isNonEmptyString(directSseUrl);
+  return useStreamSubscription({
+    ...subscriptionOptions,
+    enabled: shouldEnable,
+    sseUrl: directSseUrl
+  });
+}
+export {
+  DEFAULT_MAX_EVENTS,
+  RestlessProvider,
+  useDirectStream,
+  useManagedStream,
+  useRestlessClient,
+  useStreamSubscription
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.ts","../src/stream-subscription.ts","../src/stream-subscription-types.ts","../src/stream-subscription-utils.ts"],"sourcesContent":["import { createRestlessClient, type RestlessClient, type RestlessClientConfig } from '@restless-stream/core';\nimport { createContext, createElement, type ReactNode, useContext, useMemo } from 'react';\n\nconst RestlessClientContext = createContext<RestlessClient | null>(null);\ntype InlineRestlessClientConfig = {\n  [K in keyof RestlessClientConfig]-?: RestlessClientConfig[K] | undefined;\n};\n\nexport type RestlessProviderProps = Partial<RestlessClientConfig> & {\n  children?: ReactNode;\n  client?: RestlessClient;\n  config?: RestlessClientConfig;\n};\n\nexport function RestlessProvider({\n  apiBaseUrl,\n  apiKey,\n  children,\n  client,\n  config,\n  fetch,\n  headers,\n  streamBaseUrl,\n}: RestlessProviderProps) {\n  const inlineConfig = useMemo(\n    () =>\n      compactConfig({\n        apiBaseUrl,\n        apiKey,\n        fetch,\n        headers,\n        streamBaseUrl,\n      }),\n    [apiBaseUrl, apiKey, fetch, headers, streamBaseUrl],\n  );\n  const providerConfig = config ?? inlineConfig;\n  const contextClient = useMemo(() => client ?? createRestlessClient(providerConfig), [client, providerConfig]);\n\n  return createElement(RestlessClientContext.Provider, { value: contextClient }, children);\n}\n\nexport function useRestlessClient(): RestlessClient {\n  const client = useContext(RestlessClientContext);\n\n  if (!client) {\n    throw new Error('useRestlessClient must be used within a RestlessProvider or with an explicit client option.');\n  }\n\n  return client;\n}\n\nexport function useOptionalRestlessClient(): RestlessClient | null {\n  return useContext(RestlessClientContext);\n}\n\nfunction compactConfig(config: InlineRestlessClientConfig): RestlessClientConfig {\n  return Object.fromEntries(Object.entries(config).filter(([, value]) => value !== undefined));\n}\n","import type { RestlessStreamEvent } from '@restless-stream/core';\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { useOptionalRestlessClient } from './provider.js';\nimport {\n  DEFAULT_MAX_EVENTS,\n  type StreamSubscriptionStatus,\n  type UseDirectStreamOptions,\n  type UseManagedStreamOptions,\n  type UseStreamSubscriptionOptions,\n  type UseStreamSubscriptionResult,\n} from './stream-subscription-types.js';\nimport {\n  appendEvent,\n  isNonEmptyString,\n  normalizeMaxEvents,\n  resolveReconnectDelay,\n  sleep,\n  stableOptionsKey,\n  toError,\n} from './stream-subscription-utils.js';\n\nexport { DEFAULT_MAX_EVENTS } from './stream-subscription-types.js';\nexport type {\n  StreamSubscriptionControls,\n  StreamSubscriptionStatus,\n  UseDirectStreamOptions,\n  UseManagedStreamOptions,\n  UseStreamSubscriptionOptions,\n  UseStreamSubscriptionResult,\n} from './stream-subscription-types.js';\n\nexport function useStreamSubscription(options: UseStreamSubscriptionOptions): UseStreamSubscriptionResult {\n  const {\n    client: explicitClient,\n    enabled = true,\n    maxEvents = DEFAULT_MAX_EVENTS,\n    maxReconnectAttempts = 0,\n    onError,\n    onEvent,\n    reconnect = false,\n    reconnectDelayMs = 1000,\n    ...subscribeOptions\n  } = options;\n  const contextClient = useOptionalRestlessClient();\n  const client = explicitClient ?? contextClient;\n\n  if (!client) {\n    throw new Error('useStreamSubscription requires a RestlessProvider or an explicit client option.');\n  }\n\n  const subscriptionClient = client;\n\n  const boundedMaxEvents = normalizeMaxEvents(maxEvents);\n  const subscribeOptionsKey = stableOptionsKey(subscribeOptions);\n  const abortControllerRef = useRef<AbortController | null>(null);\n  const onErrorRef = useRef(onError);\n  const onEventRef = useRef(onEvent);\n  const reconnectDelayRef = useRef(reconnectDelayMs);\n  const subscribeOptionsRef = useRef(subscribeOptions);\n  const [connectionToken, setConnectionToken] = useState(0);\n  const [events, setEvents] = useState<RestlessStreamEvent[]>([]);\n  const [error, setError] = useState<Error | null>(null);\n  const [shouldConnect, setShouldConnect] = useState(enabled);\n  const [status, setStatus] = useState<StreamSubscriptionStatus>(enabled ? 'connecting' : 'idle');\n\n  onErrorRef.current = onError;\n  onEventRef.current = onEvent;\n  reconnectDelayRef.current = reconnectDelayMs;\n  subscribeOptionsRef.current = subscribeOptions;\n\n  useEffect(() => {\n    setShouldConnect(enabled);\n    setStatus((currentStatus) => {\n      if (enabled) {\n        return currentStatus === 'idle' || currentStatus === 'closed' ? 'connecting' : currentStatus;\n      }\n\n      return 'idle';\n    });\n  }, [enabled]);\n\n  const connect = useCallback(() => {\n    setError(null);\n    setShouldConnect(true);\n    setStatus((currentStatus) => (currentStatus === 'open' ? currentStatus : 'connecting'));\n    setConnectionToken((currentToken) => currentToken + 1);\n  }, []);\n\n  const disconnect = useCallback(() => {\n    setShouldConnect(false);\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = null;\n    setStatus('closed');\n  }, []);\n\n  const reset = useCallback(() => {\n    setEvents([]);\n    setError(null);\n  }, []);\n\n  useEffect(() => {\n    if (!shouldConnect) {\n      return;\n    }\n\n    let cancelled = false;\n    const abortController = new AbortController();\n    abortControllerRef.current?.abort();\n    abortControllerRef.current = abortController;\n\n    async function subscribe() {\n      let reconnectAttempt = 0;\n\n      while (!cancelled) {\n        setStatus(reconnectAttempt > 0 ? 'reconnecting' : 'connecting');\n\n        try {\n          const stream = subscriptionClient.streams.subscribeSse({\n            ...subscribeOptionsRef.current,\n            signal: abortController.signal,\n          });\n\n          setError(null);\n          setStatus('open');\n\n          for await (const event of stream) {\n            if (cancelled) {\n              break;\n            }\n\n            onEventRef.current?.(event);\n            setEvents((currentEvents) => appendEvent(currentEvents, event, boundedMaxEvents));\n          }\n\n          if (!cancelled) {\n            setStatus('closed');\n          }\n\n          break;\n        } catch (caughtError) {\n          if (cancelled || abortController.signal.aborted) {\n            break;\n          }\n\n          const normalizedError = toError(caughtError);\n          setError(normalizedError);\n          onErrorRef.current?.(normalizedError);\n\n          if (!reconnect || reconnectAttempt >= maxReconnectAttempts) {\n            setStatus('error');\n            break;\n          }\n\n          reconnectAttempt += 1;\n          setStatus('reconnecting');\n          await sleep(resolveReconnectDelay(reconnectDelayRef.current, reconnectAttempt), abortController.signal);\n        }\n      }\n    }\n\n    void subscribe();\n\n    return () => {\n      cancelled = true;\n      abortController.abort();\n\n      if (abortControllerRef.current === abortController) {\n        abortControllerRef.current = null;\n      }\n    };\n  }, [\n    boundedMaxEvents,\n    connectionToken,\n    maxReconnectAttempts,\n    reconnect,\n    shouldConnect,\n    subscribeOptionsKey,\n    subscriptionClient,\n  ]);\n\n  const latestEvent = events.at(-1) ?? null;\n\n  return useMemo(\n    () => ({\n      connect,\n      disconnect,\n      error,\n      events,\n      isConnected: status === 'open',\n      isConnecting: status === 'connecting' || status === 'reconnecting',\n      latestEvent,\n      reset,\n      status,\n    }),\n    [connect, disconnect, error, events, latestEvent, reset, status],\n  );\n}\n\nexport function useManagedStream(options: UseManagedStreamOptions): UseStreamSubscriptionResult {\n  const { sseUrl, stream, enabled, ...subscriptionOptions } = options;\n  const managedSseUrl = sseUrl ?? stream?.sseUrl ?? '';\n  const shouldEnable = typeof enabled === 'boolean' ? enabled : isNonEmptyString(managedSseUrl);\n\n  return useStreamSubscription({\n    ...subscriptionOptions,\n    enabled: shouldEnable,\n    sseUrl: managedSseUrl,\n  });\n}\n\nexport function useDirectStream(options: UseDirectStreamOptions): UseStreamSubscriptionResult {\n  const { directUrl, enabled, session, sseUrl, ...subscriptionOptions } = options;\n  const directSseUrl = directUrl ?? sseUrl ?? session?.sseUrl ?? '';\n  const shouldEnable = typeof enabled === 'boolean' ? enabled : isNonEmptyString(directSseUrl);\n\n  return useStreamSubscription({\n    ...subscriptionOptions,\n    enabled: shouldEnable,\n    sseUrl: directSseUrl,\n  });\n}\n","import type { RestlessClient, RestlessStreamEvent, SubscribeSseOptions } from '@restless-stream/core';\n\nexport const DEFAULT_MAX_EVENTS = 100;\n\nexport type StreamSubscriptionStatus = 'idle' | 'connecting' | 'open' | 'reconnecting' | 'closed' | 'error';\n\nexport interface StreamSubscriptionControls {\n  connect: () => void;\n  disconnect: () => void;\n  reset: () => void;\n}\n\nexport type UseStreamSubscriptionOptions = Omit<SubscribeSseOptions, 'reconnect' | 'reconnectDelayMs'> & {\n  client?: RestlessClient;\n  enabled?: boolean;\n  maxEvents?: number;\n  maxReconnectAttempts?: number;\n  onError?: (error: Error) => void;\n  onEvent?: (event: RestlessStreamEvent) => void;\n  reconnect?: boolean;\n  reconnectDelayMs?: number | ((attempt: number) => number);\n};\n\nexport type UseStreamSubscriptionResult = StreamSubscriptionControls & {\n  error: Error | null;\n  events: RestlessStreamEvent[];\n  isConnected: boolean;\n  isConnecting: boolean;\n  latestEvent: RestlessStreamEvent | null;\n  status: StreamSubscriptionStatus;\n};\n\nexport type UseManagedStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {\n  sseUrl?: SubscribeSseOptions['sseUrl'] | null;\n  stream?: { sseUrl?: string | null } | null;\n};\n\nexport type UseDirectStreamOptions = Omit<UseStreamSubscriptionOptions, 'sseUrl'> & {\n  directUrl?: string | null;\n  session?: { sseUrl?: string | null } | null;\n  sseUrl?: SubscribeSseOptions['sseUrl'] | null;\n};\n","import type { RestlessStreamEvent, SubscribeSseOptions } from '@restless-stream/core';\n\nimport { DEFAULT_MAX_EVENTS } from './stream-subscription-types.js';\n\nexport function isNonEmptyString(value: unknown): boolean {\n  return typeof value === 'string' && value.length > 0;\n}\n\nexport function appendEvent(\n  currentEvents: RestlessStreamEvent[],\n  event: RestlessStreamEvent,\n  maxEvents: number,\n): RestlessStreamEvent[] {\n  if (maxEvents === 0) {\n    return [];\n  }\n\n  const nextEvents = [...currentEvents, event];\n  return nextEvents.length > maxEvents ? nextEvents.slice(nextEvents.length - maxEvents) : nextEvents;\n}\n\nexport function normalizeMaxEvents(maxEvents: number): number {\n  if (!Number.isFinite(maxEvents)) {\n    return DEFAULT_MAX_EVENTS;\n  }\n\n  return Math.max(0, Math.floor(maxEvents));\n}\n\nexport function resolveReconnectDelay(delay: number | ((attempt: number) => number), attempt: number): number {\n  const resolvedDelay = typeof delay === 'function' ? delay(attempt) : delay;\n  return Number.isFinite(resolvedDelay) ? Math.max(0, resolvedDelay) : 0;\n}\n\nexport async function sleep(milliseconds: number, signal: AbortSignal): Promise<void> {\n  if (milliseconds === 0 || signal.aborted) {\n    return;\n  }\n\n  return new Promise((resolve) => {\n    const timeout = setTimeout(resolve, milliseconds);\n\n    signal.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timeout);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\nexport function stableOptionsKey(options: Partial<SubscribeSseOptions>): string {\n  return JSON.stringify(sortRecord(options));\n}\n\nexport function toError(error: unknown): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  return new Error(typeof error === 'string' ? error : 'Restless stream subscription failed.');\n}\n\nfunction sortRecord(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => sortRecord(item));\n  }\n\n  if (typeof value === 'function') {\n    return value.toString();\n  }\n\n  if (value === null || value === undefined || typeof value !== 'object') {\n    return value;\n  }\n\n  return Object.fromEntries(\n    Object.entries(value)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([key, nestedValue]) => [key, sortRecord(nestedValue)]),\n  );\n}\n"],"mappings":"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","names":["useMemo","useMemo"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@restless-stream/react",
+  "version": "0.1.0",
+  "description": "Lightweight React bindings for the Restless Stream SDK.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18.2 <20"
+  },
+  "dependencies": {
+    "@restless-stream/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@vitejs/plugin-react": "^5.1.2",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "jsdom": "^27.2.0",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:live": "vitest run src/live.test.tsx --config vitest.live.config.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}