@novu/react 3.19.1-rc.68f5589d4e → 3.19.1

package/dist/cjs/hooks/index.cjs

@@ -30,7 +30,7 @@ __export(hooks_exports, {
 module.exports = __toCommonJS(hooks_exports);
 var import_js = require("@novu/js");
 var import_NovuProvider = require("./NovuProvider.cjs");
-__reExport(hooks_exports, require("./useAgentChat.cjs"), module.exports);
+__reExport(hooks_exports, require("./useWebChat.cjs"), module.exports);
 __reExport(hooks_exports, require("./useChannelConnection.cjs"), module.exports);
 __reExport(hooks_exports, require("./useChannelConnections.cjs"), module.exports);
 __reExport(hooks_exports, require("./useChannelEndpoint.cjs"), module.exports);
@@ -55,7 +55,7 @@ __reExport(hooks_exports, require("./useUpdateSubscription.cjs"), module.exports
   SeverityLevelEnum,
   WorkflowCriticalityEnum,
   useNovu,
-  ...require("./useAgentChat.cjs"),
+  ...require("./useWebChat.cjs"),
   ...require("./useChannelConnection.cjs"),
   ...require("./useChannelConnections.cjs"),
   ...require("./useChannelEndpoint.cjs"),

package/dist/cjs/hooks/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/index.ts"],"sourcesContent":["export type * from '@novu/js';\nexport { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from '@novu/js';\nexport { NovuProvider, useNovu } from './NovuProvider';\nexport * from './useAgentChat';\nexport * from './useChannelConnection';\nexport * from './useChannelConnections';\nexport * from './useChannelEndpoint';\nexport * from './useChannelEndpoints';\nexport * from './useCounts';\nexport * from './useCreateChannelEndpoint';\nexport * from './useCreateSubscription';\nexport * from './useDeleteChannelConnection';\nexport * from './useDeleteChannelEndpoint';\nexport * from './useNotifications';\nexport * from './usePreferences';\nexport * from './useRemoveSubscription';\nexport * from './useSchedule';\nexport * from './useSubscription';\nexport * from './useSubscriptions';\nexport * from './useTelegramSubscriberLink';\nexport * from './useUpdateSubscription';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAA4E;AAC5E,0BAAsC;AACtC,0BAAc,+BAHd;AAIA,0BAAc,uCAJd;AAKA,0BAAc,wCALd;AAMA,0BAAc,qCANd;AAOA,0BAAc,sCAPd;AAQA,0BAAc,4BARd;AASA,0BAAc,2CATd;AAUA,0BAAc,wCAVd;AAWA,0BAAc,6CAXd;AAYA,0BAAc,2CAZd;AAaA,0BAAc,mCAbd;AAcA,0BAAc,iCAdd;AAeA,0BAAc,wCAfd;AAgBA,0BAAc,8BAhBd;AAiBA,0BAAc,kCAjBd;AAkBA,0BAAc,mCAlBd;AAmBA,0BAAc,4CAnBd;AAoBA,0BAAc,wCApBd;","names":[]}
+{"version":3,"sources":["../../../src/hooks/index.ts"],"sourcesContent":["export type * from '@novu/js';\nexport { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from '@novu/js';\nexport { NovuProvider, useNovu } from './NovuProvider';\nexport * from './useWebChat';\nexport * from './useChannelConnection';\nexport * from './useChannelConnections';\nexport * from './useChannelEndpoint';\nexport * from './useChannelEndpoints';\nexport * from './useCounts';\nexport * from './useCreateChannelEndpoint';\nexport * from './useCreateSubscription';\nexport * from './useDeleteChannelConnection';\nexport * from './useDeleteChannelEndpoint';\nexport * from './useNotifications';\nexport * from './usePreferences';\nexport * from './useRemoveSubscription';\nexport * from './useSchedule';\nexport * from './useSubscription';\nexport * from './useSubscriptions';\nexport * from './useTelegramSubscriberLink';\nexport * from './useUpdateSubscription';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAA4E;AAC5E,0BAAsC;AACtC,0BAAc,6BAHd;AAIA,0BAAc,uCAJd;AAKA,0BAAc,wCALd;AAMA,0BAAc,qCANd;AAOA,0BAAc,sCAPd;AAQA,0BAAc,4BARd;AASA,0BAAc,2CATd;AAUA,0BAAc,wCAVd;AAWA,0BAAc,6CAXd;AAYA,0BAAc,2CAZd;AAaA,0BAAc,mCAbd;AAcA,0BAAc,iCAdd;AAeA,0BAAc,wCAfd;AAgBA,0BAAc,8BAhBd;AAiBA,0BAAc,kCAjBd;AAkBA,0BAAc,mCAlBd;AAmBA,0BAAc,4CAnBd;AAoBA,0BAAc,wCApBd;","names":[]}

package/dist/cjs/hooks/index.d.cts

@@ -1,7 +1,7 @@
 export * from '@novu/js';
 export { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from '@novu/js';
 export { NovuProvider, useNovu } from './NovuProvider.cjs';
-export { UseAgentChatProps, UseAgentChatResult, useAgentChat } from './useAgentChat.cjs';
+export { UseWebChatProps, UseWebChatResult, useWebChat } from './useWebChat.cjs';
 export { UseChannelConnectionProps, UseChannelConnectionResult, useChannelConnection } from './useChannelConnection.cjs';
 export { UseChannelConnectionsProps, UseChannelConnectionsResult, useChannelConnections } from './useChannelConnections.cjs';
 export { UseChannelEndpointProps, UseChannelEndpointResult, useChannelEndpoint } from './useChannelEndpoint.cjs';

package/dist/cjs/hooks/useWebChat.cjs

@@ -0,0 +1,326 @@
+"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/hooks/useWebChat.ts
+var useWebChat_exports = {};
+__export(useWebChat_exports, {
+  useWebChat: () => useWebChat
+});
+module.exports = __toCommonJS(useWebChat_exports);
+var import_js = require("@novu/js");
+var import_react = require("react");
+var import_useDataRef = require("./internal/useDataRef.cjs");
+var import_NovuProvider = require("./NovuProvider.cjs");
+var EMPTY_SERVER_SNAPSHOT = {
+  key: "ssr",
+  status: "loading",
+  run: { isRunning: false },
+  conversationStatus: "active",
+  pagination: { hasMore: false, status: "idle" },
+  messages: [],
+  pendingActions: [],
+  isRecovering: false
+};
+function handlePublicationCallbacks(args) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+  const {
+    snapshot,
+    meta,
+    conversationIdProp,
+    propsRef,
+    loadNotifiedRef,
+    notifiedCatchUpErrorRef,
+    lastReportedErrorKeyRef
+  } = args;
+  if (((meta == null ? void 0 : meta.historyLoaded) || ((_a = meta == null ? void 0 : meta.change) == null ? void 0 : _a.kind) === "history") && !loadNotifiedRef.current && conversationIdProp) {
+    if (snapshot.conversationId) {
+      loadNotifiedRef.current = true;
+      (_c = (_b = propsRef.current).onSuccess) == null ? void 0 : _c.call(_b, {
+        conversationId: snapshot.conversationId,
+        messages: [...snapshot.messages],
+        hasMore: snapshot.pagination.hasMore
+      });
+    }
+  }
+  if (snapshot.catchUpError && snapshot.catchUpError !== notifiedCatchUpErrorRef.current) {
+    notifiedCatchUpErrorRef.current = snapshot.catchUpError;
+    (_e = (_d = propsRef.current).onError) == null ? void 0 : _e.call(_d, snapshot.catchUpError);
+  } else if (!snapshot.catchUpError) {
+    notifiedCatchUpErrorRef.current = void 0;
+  }
+  if (snapshot.error) {
+    const originalMessage = "originalError" in snapshot.error ? ((_f = snapshot.error.originalError) == null ? void 0 : _f.message) ?? "" : "";
+    const errorKey = `${snapshot.error.message}:${originalMessage}`;
+    if (lastReportedErrorKeyRef.current !== errorKey) {
+      lastReportedErrorKeyRef.current = errorKey;
+      (_h = (_g = propsRef.current).onError) == null ? void 0 : _h.call(_g, snapshot.error);
+    }
+  } else {
+    lastReportedErrorKeyRef.current = void 0;
+  }
+  const change = meta == null ? void 0 : meta.change;
+  if ((change == null ? void 0 : change.kind) === "live") {
+    (_j = (_i = propsRef.current).onEvent) == null ? void 0 : _j.call(_i, change.envelope);
+  }
+  if (change && change.kind !== "history") {
+    for (const message of change.addedMessages) {
+      (_l = (_k = propsRef.current).onMessage) == null ? void 0 : _l.call(_k, message);
+    }
+  }
+  if (change) {
+    for (const action of change.newActions) {
+      (_n = (_m = propsRef.current).onActionRequested) == null ? void 0 : _n.call(_m, action);
+    }
+  }
+}
+function getCreateFlowKey(agentId, agentHash) {
+  return `${agentId}\0${agentHash ?? ""}`;
+}
+function resolveOwnedRuntime(args) {
+  const key = getCreateFlowKey(args.agentId, args.agentHash);
+  const current = args.ownedRuntimeRef.current;
+  if ((current == null ? void 0 : current.novu) === args.novu && current.key === key) {
+    return current.runtime;
+  }
+  current == null ? void 0 : current.runtime.dispose();
+  const runtime = args.novu.webChat.conversation({ agentId: args.agentId, agentHash: args.agentHash });
+  args.ownedRuntimeRef.current = { key, novu: args.novu, runtime };
+  return runtime;
+}
+function toNovuError(error) {
+  if (error instanceof import_js.NovuError) {
+    return error;
+  }
+  if (error instanceof Error) {
+    return new import_js.NovuError("Failed to load Web Chat", error);
+  }
+  return new import_js.NovuError("Failed to load Web Chat", new Error(String(error)));
+}
+var useWebChat = (props) => {
+  var _a;
+  const novu = (0, import_NovuProvider.useNovu)();
+  const propsRef = (0, import_useDataRef.useDataRef)(props);
+  const [loadState, setLoadState] = (0, import_react.useState)(() => ({
+    novu,
+    status: "loading"
+  }));
+  (0, import_react.useEffect)(() => {
+    let cancelled = false;
+    if (!novu.isWebChatLoaded) {
+      setLoadState({ novu, status: "loading" });
+    }
+    void novu.loadWebChat().then(() => {
+      if (!cancelled) {
+        setLoadState({ novu, status: "ready" });
+      }
+    }).catch((error) => {
+      var _a2, _b;
+      if (cancelled) {
+        return;
+      }
+      const novuError = toNovuError(error);
+      (_b = (_a2 = propsRef.current).onError) == null ? void 0 : _b.call(_a2, novuError);
+      setLoadState({ novu, status: "error", error: novuError });
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [novu, propsRef]);
+  const webChatReady = loadState.novu === novu && loadState.status === "ready";
+  const webChatLoadError = loadState.novu === novu && loadState.status === "error" ? loadState.error : void 0;
+  const isWebChatLoading = loadState.novu !== novu || loadState.status === "loading";
+  const sharedRuntime = "conversation" in props ? props.conversation : void 0;
+  const agentId = (sharedRuntime == null ? void 0 : sharedRuntime.agentId) ?? props.agentId;
+  const conversationIdProp = sharedRuntime ? void 0 : props.conversationId;
+  const agentHash = sharedRuntime ? void 0 : props.agentHash;
+  const ownedRuntimeRef = (0, import_react.useRef)(null);
+  (0, import_react.useEffect)(() => {
+    const current = ownedRuntimeRef.current;
+    if (current && current.novu !== novu) {
+      current.runtime.dispose();
+      ownedRuntimeRef.current = null;
+    }
+  }, [novu]);
+  const cachedRuntime = (0, import_react.useMemo)(() => {
+    if (!webChatReady) {
+      return null;
+    }
+    if (sharedRuntime) {
+      return sharedRuntime;
+    }
+    if (!conversationIdProp) {
+      return null;
+    }
+    return novu.webChat.conversation({
+      agentId,
+      conversationId: conversationIdProp,
+      agentHash
+    });
+  }, [webChatReady, sharedRuntime, novu, agentId, conversationIdProp, agentHash]);
+  if (sharedRuntime || conversationIdProp) {
+    (_a = ownedRuntimeRef.current) == null ? void 0 : _a.runtime.dispose();
+    ownedRuntimeRef.current = null;
+  }
+  const ownedRuntime = !webChatReady || sharedRuntime || conversationIdProp ? null : resolveOwnedRuntime({ novu, agentId, agentHash, ownedRuntimeRef });
+  const runtime = sharedRuntime ?? cachedRuntime ?? ownedRuntime;
+  (0, import_react.useEffect)(() => {
+    return () => {
+      var _a2;
+      (_a2 = ownedRuntimeRef.current) == null ? void 0 : _a2.runtime.dispose();
+      ownedRuntimeRef.current = null;
+    };
+  }, []);
+  const loadNotifiedRef = (0, import_react.useRef)(false);
+  const replayedActionsRef = (0, import_react.useRef)(false);
+  const notifiedCatchUpErrorRef = (0, import_react.useRef)();
+  const lastReportedErrorKeyRef = (0, import_react.useRef)();
+  (0, import_react.useEffect)(() => {
+    loadNotifiedRef.current = false;
+    replayedActionsRef.current = false;
+    notifiedCatchUpErrorRef.current = void 0;
+    lastReportedErrorKeyRef.current = void 0;
+  }, [runtime]);
+  const subscribe = (0, import_react.useCallback)(
+    (onStoreChange) => {
+      var _a2, _b;
+      if (!runtime) {
+        return () => {
+        };
+      }
+      if (!replayedActionsRef.current) {
+        replayedActionsRef.current = true;
+        for (const action of runtime.getSnapshot().pendingActions) {
+          (_b = (_a2 = propsRef.current).onActionRequested) == null ? void 0 : _b.call(_a2, action);
+        }
+      }
+      return runtime.subscribe((snapshot2, meta) => {
+        onStoreChange();
+        handlePublicationCallbacks({
+          snapshot: snapshot2,
+          meta,
+          conversationIdProp,
+          propsRef,
+          loadNotifiedRef,
+          notifiedCatchUpErrorRef,
+          lastReportedErrorKeyRef
+        });
+      });
+    },
+    [runtime, conversationIdProp, propsRef]
+  );
+  const getSnapshot = (0, import_react.useCallback)(() => {
+    return (runtime == null ? void 0 : runtime.getSnapshot()) ?? EMPTY_SERVER_SNAPSHOT;
+  }, [runtime]);
+  const getServerSnapshot = (0, import_react.useCallback)(() => {
+    return (runtime == null ? void 0 : runtime.getServerSnapshot()) ?? EMPTY_SERVER_SNAPSHOT;
+  }, [runtime]);
+  const snapshot = (0, import_react.useSyncExternalStore)(subscribe, getSnapshot, getServerSnapshot);
+  const callRuntime = (0, import_react.useCallback)(
+    async (action) => {
+      var _a2, _b, _c, _d;
+      if (!runtime) {
+        const error = webChatLoadError ?? new import_js.NovuError(
+          isWebChatLoading ? "Web Chat is still loading" : "Web Chat runtime is unavailable",
+          new Error("Web Chat runtime is not ready")
+        );
+        (_b = (_a2 = propsRef.current).onError) == null ? void 0 : _b.call(_a2, error);
+        return { error };
+      }
+      const response = await action(runtime);
+      if (response.error) {
+        (_d = (_c = propsRef.current).onError) == null ? void 0 : _d.call(_c, response.error);
+      }
+      return response;
+    },
+    [runtime, webChatLoadError, isWebChatLoading, propsRef]
+  );
+  const refetch = (0, import_react.useCallback)(async () => {
+    var _a2, _b;
+    if (!runtime) {
+      return;
+    }
+    const response = await runtime.load();
+    if (response.data) {
+      (_b = (_a2 = propsRef.current).onSuccess) == null ? void 0 : _b.call(_a2, {
+        conversationId: response.data.conversationId,
+        messages: [...response.data.messages],
+        hasMore: response.data.hasMore
+      });
+    }
+  }, [runtime, propsRef]);
+  const fetchMore = (0, import_react.useCallback)(async () => {
+    const response = await callRuntime((target) => target.fetchMore());
+    return {
+      ...response,
+      error: response.error,
+      data: response.data ? {
+        messages: [...response.data.messages],
+        hasMore: response.data.hasMore
+      } : void 0
+    };
+  }, [callRuntime]);
+  const paginationWithFetch = (0, import_react.useMemo)(
+    () => ({
+      status: snapshot.pagination.status,
+      hasMore: snapshot.pagination.hasMore,
+      fetchMore
+    }),
+    [snapshot.pagination.status, snapshot.pagination.hasMore, fetchMore]
+  );
+  const sendMessage = (0, import_react.useCallback)(
+    (input) => callRuntime((target) => target.sendMessage(input)),
+    [callRuntime]
+  );
+  const respondToAction = (0, import_react.useCallback)(
+    (args) => callRuntime((target) => target.respondToAction(args)),
+    [callRuntime]
+  );
+  const sendAction = (0, import_react.useCallback)(
+    (args) => callRuntime((target) => target.sendAction(args)),
+    [callRuntime]
+  );
+  const retryMessage = (0, import_react.useCallback)(
+    (messageId) => callRuntime((target) => target.retryMessage(messageId)),
+    [callRuntime]
+  );
+  return {
+    messages: [...snapshot.messages],
+    pendingActions: [...snapshot.pendingActions],
+    conversationId: snapshot.conversationId,
+    error: webChatLoadError ?? snapshot.error,
+    isLoading: !webChatLoadError && (isWebChatLoading || snapshot.status === "loading"),
+    isRunning: snapshot.run.isRunning,
+    typing: snapshot.run.typing,
+    conversationStatus: snapshot.conversationStatus,
+    run: snapshot.run,
+    pagination: paginationWithFetch,
+    isRecovering: snapshot.isRecovering,
+    catchUpError: snapshot.catchUpError,
+    refetch,
+    sendMessage,
+    respondToAction,
+    sendAction,
+    retryMessage
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useWebChat
+});
+//# sourceMappingURL=useWebChat.cjs.map

package/dist/cjs/hooks/useWebChat.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hooks/useWebChat.ts"],"sourcesContent":["import type {\n  AgentConversationPublicationMeta,\n  AgentConversationRunSnapshot,\n  AgentConversationRuntime,\n  AgentConversationSnapshot,\n  AgentConversationStatus,\n  AgentEventEnvelope,\n  AgentHashFields,\n  AgentMessage,\n  AgentPendingAction,\n  AgentToolApprovalDecision,\n  LoadConversationResult,\n  RespondToActionResult,\n  SendActionResult,\n  SendMessageInput,\n  SendMessageResult,\n  WebChatPagination,\n  WebChatPlanLimitError,\n} from '@novu/js';\nimport { NovuError } from '@novu/js';\nimport { type MutableRefObject, useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useDataRef } from './internal/useDataRef';\nimport { useNovu } from './NovuProvider';\n\ntype UseWebChatCallbacks = {\n  onSuccess?: (data: LoadConversationResult) => void;\n  onError?: (error: NovuError | WebChatPlanLimitError) => void;\n  /**\n   * Fires once when a message id first appears. History pages do not fire.\n   * The first event of a turn can create an empty assistant message before text arrives.\n   * A send that never reaches the server does not fire. The message status becomes `failed` instead.\n   */\n  onMessage?: (message: AgentMessage) => void;\n  /**\n   * Fires once per pending action, including actions still pending on mount.\n   * Paging backwards does not fire.\n   */\n  onActionRequested?: (action: AgentPendingAction) => void;\n  /**\n   * Live event envelopes for this conversation.\n   * Duplicates that the client drops do not fire.\n   * Envelopes that arrive before the conversation id exists do not fire.\n   * The message list in this render does not include this envelope yet.\n   */\n  onEvent?: (envelope: AgentEventEnvelope) => void;\n};\n\n/** Arguments for {@link useWebChat}. Pass `agentId`, or pass `conversation`. Do not mix the two. */\nexport type UseWebChatProps = UseWebChatCallbacks &\n  AgentHashFields &\n  (\n    | {\n        agentId: string;\n        /**\n         * Resume this conversation. The hook loads history on mount.\n         * Omit this prop to start a new chat. The first send creates a conversation.\n         */\n        conversationId?: string;\n        conversation?: never;\n      }\n    | {\n        /** Share an existing conversation runtime across multiple hook instances. */\n        conversation: AgentConversationRuntime;\n        agentId?: never;\n        conversationId?: never;\n        agentHash?: never;\n      }\n  );\n\n/** State and actions returned by {@link useWebChat}. */\nexport type UseWebChatResult = {\n  /** Conversation timeline. */\n  messages: AgentMessage[];\n  /** Tool approvals and MCP connect items that are still pending. */\n  pendingActions: AgentPendingAction[];\n  /** Server conversation id after create or resume. */\n  conversationId?: string;\n  /** Last error from load, send, retry, or action. */\n  error?: NovuError | WebChatPlanLimitError;\n  /** True while Web Chat loads and, for an existing conversation, until the first history fetch completes. */\n  isLoading: boolean;\n  /** True while the agent turn is in progress. Same as `run.isRunning`. */\n  isRunning: boolean;\n  /** Typing indicator. Same as `run.typing`. Absent when the agent is not typing. */\n  typing?: AgentConversationRunSnapshot['typing'];\n  /** `'active'` or `'resolved'`. The agent sets `resolved` with `ctx.resolve()`. Not a loading flag. */\n  conversationStatus: AgentConversationStatus;\n  /** Current agent-run snapshot. */\n  run: AgentConversationRunSnapshot;\n  /** Older-history control. Not a top-level `hasMore` or `fetchMore`. */\n  pagination: WebChatPagination & {\n    fetchMore: () => Promise<{\n      data?: { messages: AgentMessage[]; hasMore: boolean };\n      error?: NovuError;\n    }>;\n  };\n  /** True while reconnect recovery is in progress. */\n  isRecovering: boolean;\n  /** Set when reconnect recovery fails. Separate from send and fetch `error`. */\n  catchUpError?: NovuError;\n  /** Reload the newest history page. No-op when there is no conversation id. */\n  refetch: () => Promise<void>;\n  /** Send a user message. `input` is a string, or `{ text, metadata }`. Creates a conversation when `conversationId` is omitted. */\n  sendMessage: (input: SendMessageInput) => Promise<{\n    data?: SendMessageResult;\n    error?: NovuError | WebChatPlanLimitError;\n  }>;\n  /** Resolve a pending `tool-approval`. Pass `action.id` from `pendingActions`. */\n  respondToAction: (args: { actionId: string; decision: AgentToolApprovalDecision }) => Promise<{\n    data?: RespondToActionResult;\n    error?: NovuError | WebChatPlanLimitError;\n  }>;\n  /** Click a Card button. Do not use this for tool approval. */\n  sendAction: (args: { actionId: string; sourceMessageId: string; value?: string }) => Promise<{\n    data?: SendActionResult;\n    error?: NovuError | WebChatPlanLimitError;\n  }>;\n  /** Resend a message whose `status` is `failed`. Reuses the original idempotency key. */\n  retryMessage: (messageId: string) => Promise<{\n    data?: SendMessageResult;\n    error?: NovuError | WebChatPlanLimitError;\n  }>;\n};\n\nconst EMPTY_SERVER_SNAPSHOT = {\n  key: 'ssr',\n  status: 'loading',\n  run: { isRunning: false },\n  conversationStatus: 'active',\n  pagination: { hasMore: false, status: 'idle' },\n  messages: [],\n  pendingActions: [],\n  isRecovering: false,\n} as AgentConversationSnapshot;\n\ntype RuntimeActionResult<T> = {\n  data?: T;\n  error?: NovuError | WebChatPlanLimitError;\n};\n\nfunction handlePublicationCallbacks(args: {\n  snapshot: AgentConversationSnapshot;\n  meta: AgentConversationPublicationMeta | undefined;\n  conversationIdProp: string | undefined;\n  propsRef: ReturnType<typeof useDataRef<UseWebChatProps>>;\n  loadNotifiedRef: MutableRefObject<boolean>;\n  notifiedCatchUpErrorRef: MutableRefObject<NovuError | undefined>;\n  lastReportedErrorKeyRef: MutableRefObject<string | undefined>;\n}): void {\n  const {\n    snapshot,\n    meta,\n    conversationIdProp,\n    propsRef,\n    loadNotifiedRef,\n    notifiedCatchUpErrorRef,\n    lastReportedErrorKeyRef,\n  } = args;\n\n  if ((meta?.historyLoaded || meta?.change?.kind === 'history') && !loadNotifiedRef.current && conversationIdProp) {\n    if (snapshot.conversationId) {\n      loadNotifiedRef.current = true;\n      propsRef.current.onSuccess?.({\n        conversationId: snapshot.conversationId,\n        messages: [...snapshot.messages],\n        hasMore: snapshot.pagination.hasMore,\n      });\n    }\n  }\n\n  if (snapshot.catchUpError && snapshot.catchUpError !== notifiedCatchUpErrorRef.current) {\n    notifiedCatchUpErrorRef.current = snapshot.catchUpError;\n    propsRef.current.onError?.(snapshot.catchUpError);\n  } else if (!snapshot.catchUpError) {\n    notifiedCatchUpErrorRef.current = undefined;\n  }\n\n  if (snapshot.error) {\n    const originalMessage = 'originalError' in snapshot.error ? (snapshot.error.originalError?.message ?? '') : '';\n    const errorKey = `${snapshot.error.message}:${originalMessage}`;\n    if (lastReportedErrorKeyRef.current !== errorKey) {\n      lastReportedErrorKeyRef.current = errorKey;\n      propsRef.current.onError?.(snapshot.error as NovuError | WebChatPlanLimitError);\n    }\n  } else {\n    lastReportedErrorKeyRef.current = undefined;\n  }\n\n  const change = meta?.change;\n  if (change?.kind === 'live') {\n    propsRef.current.onEvent?.(change.envelope);\n  }\n\n  if (change && change.kind !== 'history') {\n    for (const message of change.addedMessages) {\n      propsRef.current.onMessage?.(message);\n    }\n  }\n\n  if (change) {\n    for (const action of change.newActions) {\n      propsRef.current.onActionRequested?.(action);\n    }\n  }\n}\n\ntype OwnedRuntimeEntry = {\n  key: string;\n  novu: ReturnType<typeof useNovu>;\n  runtime: AgentConversationRuntime;\n};\n\nfunction getCreateFlowKey(agentId: string, agentHash?: string): string {\n  return `${agentId}\\0${agentHash ?? ''}`;\n}\n\nfunction resolveOwnedRuntime(args: {\n  novu: ReturnType<typeof useNovu>;\n  agentId: string;\n  agentHash?: string;\n  ownedRuntimeRef: MutableRefObject<OwnedRuntimeEntry | null>;\n}): AgentConversationRuntime | null {\n  const key = getCreateFlowKey(args.agentId, args.agentHash);\n  const current = args.ownedRuntimeRef.current;\n\n  if (current?.novu === args.novu && current.key === key) {\n    return current.runtime;\n  }\n\n  current?.runtime.dispose();\n\n  const runtime = args.novu.webChat.conversation({ agentId: args.agentId, agentHash: args.agentHash });\n  args.ownedRuntimeRef.current = { key, novu: args.novu, runtime };\n  return runtime;\n}\n\ntype WebChatLoadState =\n  | { novu: ReturnType<typeof useNovu>; status: 'loading' }\n  | { novu: ReturnType<typeof useNovu>; status: 'ready' }\n  | { novu: ReturnType<typeof useNovu>; status: 'error'; error: NovuError };\n\nfunction toNovuError(error: unknown): NovuError {\n  if (error instanceof NovuError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new NovuError('Failed to load Web Chat', error);\n  }\n\n  return new NovuError('Failed to load Web Chat', new Error(String(error)));\n}\n\n/**\n * Headless Web Chat client. Use it inside `NovuProvider`.\n *\n * @example\n * ```tsx\n * const { messages, sendMessage, isRunning, isLoading, error } = useWebChat({\n *   agentId: 'YOUR_AGENT_IDENTIFIER',\n * });\n * ```\n */\nexport const useWebChat = (props: UseWebChatProps): UseWebChatResult => {\n  const novu = useNovu();\n  const propsRef = useDataRef(props);\n  const [loadState, setLoadState] = useState<WebChatLoadState>(() => ({\n    novu,\n    status: 'loading',\n  }));\n\n  useEffect(() => {\n    let cancelled = false;\n\n    if (!novu.isWebChatLoaded) {\n      setLoadState({ novu, status: 'loading' });\n    }\n\n    void novu\n      .loadWebChat()\n      .then(() => {\n        if (!cancelled) {\n          setLoadState({ novu, status: 'ready' });\n        }\n      })\n      .catch((error: unknown) => {\n        if (cancelled) {\n          return;\n        }\n\n        const novuError = toNovuError(error);\n        propsRef.current.onError?.(novuError);\n        setLoadState({ novu, status: 'error', error: novuError });\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [novu, propsRef]);\n\n  const webChatReady = loadState.novu === novu && loadState.status === 'ready';\n  const webChatLoadError = loadState.novu === novu && loadState.status === 'error' ? loadState.error : undefined;\n  const isWebChatLoading = loadState.novu !== novu || loadState.status === 'loading';\n\n  const sharedRuntime = 'conversation' in props ? props.conversation : undefined;\n  const agentId = sharedRuntime?.agentId ?? props.agentId!;\n  const conversationIdProp = sharedRuntime ? undefined : props.conversationId;\n  const agentHash = sharedRuntime ? undefined : props.agentHash;\n\n  const ownedRuntimeRef = useRef<OwnedRuntimeEntry | null>(null);\n\n  useEffect(() => {\n    const current = ownedRuntimeRef.current;\n    if (current && current.novu !== novu) {\n      current.runtime.dispose();\n      ownedRuntimeRef.current = null;\n    }\n  }, [novu]);\n\n  const cachedRuntime = useMemo(() => {\n    if (!webChatReady) {\n      return null;\n    }\n\n    if (sharedRuntime) {\n      return sharedRuntime;\n    }\n\n    if (!conversationIdProp) {\n      return null;\n    }\n\n    return novu.webChat.conversation({\n      agentId,\n      conversationId: conversationIdProp,\n      agentHash,\n    });\n  }, [webChatReady, sharedRuntime, novu, agentId, conversationIdProp, agentHash]);\n\n  if (sharedRuntime || conversationIdProp) {\n    ownedRuntimeRef.current?.runtime.dispose();\n    ownedRuntimeRef.current = null;\n  }\n\n  const ownedRuntime =\n    !webChatReady || sharedRuntime || conversationIdProp\n      ? null\n      : resolveOwnedRuntime({ novu, agentId, agentHash, ownedRuntimeRef });\n\n  const runtime = sharedRuntime ?? cachedRuntime ?? ownedRuntime;\n\n  useEffect(() => {\n    return () => {\n      ownedRuntimeRef.current?.runtime.dispose();\n      ownedRuntimeRef.current = null;\n    };\n  }, []);\n\n  const loadNotifiedRef = useRef(false);\n  const replayedActionsRef = useRef(false);\n  const notifiedCatchUpErrorRef = useRef<NovuError | undefined>();\n  const lastReportedErrorKeyRef = useRef<string>();\n\n  useEffect(() => {\n    loadNotifiedRef.current = false;\n    replayedActionsRef.current = false;\n    notifiedCatchUpErrorRef.current = undefined;\n    lastReportedErrorKeyRef.current = undefined;\n  }, [runtime]);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      if (!runtime) {\n        return () => {};\n      }\n\n      if (!replayedActionsRef.current) {\n        replayedActionsRef.current = true;\n        for (const action of runtime.getSnapshot().pendingActions) {\n          propsRef.current.onActionRequested?.(action);\n        }\n      }\n\n      return runtime.subscribe((snapshot, meta) => {\n        onStoreChange();\n        handlePublicationCallbacks({\n          snapshot,\n          meta,\n          conversationIdProp,\n          propsRef,\n          loadNotifiedRef,\n          notifiedCatchUpErrorRef,\n          lastReportedErrorKeyRef,\n        });\n      });\n    },\n    [runtime, conversationIdProp, propsRef]\n  );\n\n  const getSnapshot = useCallback(() => {\n    return runtime?.getSnapshot() ?? EMPTY_SERVER_SNAPSHOT;\n  }, [runtime]);\n\n  const getServerSnapshot = useCallback(() => {\n    return runtime?.getServerSnapshot() ?? EMPTY_SERVER_SNAPSHOT;\n  }, [runtime]);\n\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n\n  const callRuntime = useCallback(\n    async <T>(action: (target: AgentConversationRuntime) => Promise<RuntimeActionResult<T>>) => {\n      if (!runtime) {\n        const error =\n          webChatLoadError ??\n          new NovuError(\n            isWebChatLoading ? 'Web Chat is still loading' : 'Web Chat runtime is unavailable',\n            new Error('Web Chat runtime is not ready')\n          );\n        propsRef.current.onError?.(error);\n\n        return { error };\n      }\n\n      const response = await action(runtime);\n      if (response.error) {\n        propsRef.current.onError?.(response.error);\n      }\n\n      return response;\n    },\n    [runtime, webChatLoadError, isWebChatLoading, propsRef]\n  );\n\n  const refetch = useCallback(async () => {\n    if (!runtime) {\n      return;\n    }\n\n    const response = await runtime.load();\n    if (response.data) {\n      propsRef.current.onSuccess?.({\n        conversationId: response.data.conversationId,\n        messages: [...response.data.messages],\n        hasMore: response.data.hasMore,\n      });\n    }\n  }, [runtime, propsRef]);\n\n  const fetchMore = useCallback(async () => {\n    const response = await callRuntime((target) => target.fetchMore());\n\n    return {\n      ...response,\n      error: response.error as NovuError | undefined,\n      data: response.data\n        ? {\n            messages: [...response.data.messages],\n            hasMore: response.data.hasMore,\n          }\n        : undefined,\n    };\n  }, [callRuntime]);\n\n  const paginationWithFetch = useMemo(\n    () => ({\n      status: snapshot.pagination.status,\n      hasMore: snapshot.pagination.hasMore,\n      fetchMore,\n    }),\n    [snapshot.pagination.status, snapshot.pagination.hasMore, fetchMore]\n  );\n\n  const sendMessage = useCallback(\n    (input: SendMessageInput) => callRuntime((target) => target.sendMessage(input)),\n    [callRuntime]\n  );\n  const respondToAction = useCallback(\n    (args: { actionId: string; decision: AgentToolApprovalDecision }) =>\n      callRuntime((target) => target.respondToAction(args)),\n    [callRuntime]\n  );\n  const sendAction = useCallback(\n    (args: { actionId: string; sourceMessageId: string; value?: string }) =>\n      callRuntime((target) => target.sendAction(args)),\n    [callRuntime]\n  );\n  const retryMessage = useCallback(\n    (messageId: string) => callRuntime((target) => target.retryMessage(messageId)),\n    [callRuntime]\n  );\n\n  return {\n    messages: [...snapshot.messages],\n    pendingActions: [...snapshot.pendingActions],\n    conversationId: snapshot.conversationId,\n    error: webChatLoadError ?? (snapshot.error as UseWebChatResult['error']),\n    isLoading: !webChatLoadError && (isWebChatLoading || snapshot.status === 'loading'),\n    isRunning: snapshot.run.isRunning,\n    typing: snapshot.run.typing,\n    conversationStatus: snapshot.conversationStatus,\n    run: snapshot.run,\n    pagination: paginationWithFetch,\n    isRecovering: snapshot.isRecovering,\n    catchUpError: snapshot.catchUpError,\n    refetch,\n    sendMessage,\n    respondToAction,\n    sendAction,\n    retryMessage,\n  };\n};\n"],"mappings":"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","names":["_a","snapshot"]}

package/dist/cjs/hooks/useWebChat.d.cts

@@ -0,0 +1,117 @@
+import { LoadConversationResult, NovuError, WebChatPlanLimitError, AgentMessage, AgentPendingAction, AgentEventEnvelope, AgentHashFields, AgentConversationRuntime, AgentConversationRunSnapshot, AgentConversationStatus, WebChatPagination, SendMessageInput, SendMessageResult, AgentToolApprovalDecision, RespondToActionResult, SendActionResult } from '@novu/js';
+
+type UseWebChatCallbacks = {
+    onSuccess?: (data: LoadConversationResult) => void;
+    onError?: (error: NovuError | WebChatPlanLimitError) => void;
+    /**
+     * Fires once when a message id first appears. History pages do not fire.
+     * The first event of a turn can create an empty assistant message before text arrives.
+     * A send that never reaches the server does not fire. The message status becomes `failed` instead.
+     */
+    onMessage?: (message: AgentMessage) => void;
+    /**
+     * Fires once per pending action, including actions still pending on mount.
+     * Paging backwards does not fire.
+     */
+    onActionRequested?: (action: AgentPendingAction) => void;
+    /**
+     * Live event envelopes for this conversation.
+     * Duplicates that the client drops do not fire.
+     * Envelopes that arrive before the conversation id exists do not fire.
+     * The message list in this render does not include this envelope yet.
+     */
+    onEvent?: (envelope: AgentEventEnvelope) => void;
+};
+/** Arguments for {@link useWebChat}. Pass `agentId`, or pass `conversation`. Do not mix the two. */
+type UseWebChatProps = UseWebChatCallbacks & AgentHashFields & ({
+    agentId: string;
+    /**
+     * Resume this conversation. The hook loads history on mount.
+     * Omit this prop to start a new chat. The first send creates a conversation.
+     */
+    conversationId?: string;
+    conversation?: never;
+} | {
+    /** Share an existing conversation runtime across multiple hook instances. */
+    conversation: AgentConversationRuntime;
+    agentId?: never;
+    conversationId?: never;
+    agentHash?: never;
+});
+/** State and actions returned by {@link useWebChat}. */
+type UseWebChatResult = {
+    /** Conversation timeline. */
+    messages: AgentMessage[];
+    /** Tool approvals and MCP connect items that are still pending. */
+    pendingActions: AgentPendingAction[];
+    /** Server conversation id after create or resume. */
+    conversationId?: string;
+    /** Last error from load, send, retry, or action. */
+    error?: NovuError | WebChatPlanLimitError;
+    /** True while Web Chat loads and, for an existing conversation, until the first history fetch completes. */
+    isLoading: boolean;
+    /** True while the agent turn is in progress. Same as `run.isRunning`. */
+    isRunning: boolean;
+    /** Typing indicator. Same as `run.typing`. Absent when the agent is not typing. */
+    typing?: AgentConversationRunSnapshot['typing'];
+    /** `'active'` or `'resolved'`. The agent sets `resolved` with `ctx.resolve()`. Not a loading flag. */
+    conversationStatus: AgentConversationStatus;
+    /** Current agent-run snapshot. */
+    run: AgentConversationRunSnapshot;
+    /** Older-history control. Not a top-level `hasMore` or `fetchMore`. */
+    pagination: WebChatPagination & {
+        fetchMore: () => Promise<{
+            data?: {
+                messages: AgentMessage[];
+                hasMore: boolean;
+            };
+            error?: NovuError;
+        }>;
+    };
+    /** True while reconnect recovery is in progress. */
+    isRecovering: boolean;
+    /** Set when reconnect recovery fails. Separate from send and fetch `error`. */
+    catchUpError?: NovuError;
+    /** Reload the newest history page. No-op when there is no conversation id. */
+    refetch: () => Promise<void>;
+    /** Send a user message. `input` is a string, or `{ text, metadata }`. Creates a conversation when `conversationId` is omitted. */
+    sendMessage: (input: SendMessageInput) => Promise<{
+        data?: SendMessageResult;
+        error?: NovuError | WebChatPlanLimitError;
+    }>;
+    /** Resolve a pending `tool-approval`. Pass `action.id` from `pendingActions`. */
+    respondToAction: (args: {
+        actionId: string;
+        decision: AgentToolApprovalDecision;
+    }) => Promise<{
+        data?: RespondToActionResult;
+        error?: NovuError | WebChatPlanLimitError;
+    }>;
+    /** Click a Card button. Do not use this for tool approval. */
+    sendAction: (args: {
+        actionId: string;
+        sourceMessageId: string;
+        value?: string;
+    }) => Promise<{
+        data?: SendActionResult;
+        error?: NovuError | WebChatPlanLimitError;
+    }>;
+    /** Resend a message whose `status` is `failed`. Reuses the original idempotency key. */
+    retryMessage: (messageId: string) => Promise<{
+        data?: SendMessageResult;
+        error?: NovuError | WebChatPlanLimitError;
+    }>;
+};
+/**
+ * Headless Web Chat client. Use it inside `NovuProvider`.
+ *
+ * @example
+ * ```tsx
+ * const { messages, sendMessage, isRunning, isLoading, error } = useWebChat({
+ *   agentId: 'YOUR_AGENT_IDENTIFIER',
+ * });
+ * ```
+ */
+declare const useWebChat: (props: UseWebChatProps) => UseWebChatResult;
+
+export { type UseWebChatProps, type UseWebChatResult, useWebChat };

package/dist/cjs/index.cjs

@@ -37,7 +37,6 @@ __export(index_exports, {
   SubscriptionPreferences: () => import_components.SubscriptionPreferences,
   TelegramConnectButton: () => import_components.TelegramConnectButton,
   WorkflowCriticalityEnum: () => import_js.WorkflowCriticalityEnum,
-  useAgentChat: () => import_hooks.useAgentChat,
   useChannelConnection: () => import_hooks.useChannelConnection,
   useChannelConnections: () => import_hooks.useChannelConnections,
   useChannelEndpoint: () => import_hooks.useChannelEndpoint,
@@ -53,7 +52,8 @@ __export(index_exports, {
   useSubscription: () => import_hooks.useSubscription,
   useSubscriptions: () => import_hooks.useSubscriptions,
   useTelegramSubscriberLink: () => import_hooks.useTelegramSubscriberLink,
-  useUpdateSubscription: () => import_hooks.useUpdateSubscription
+  useUpdateSubscription: () => import_hooks.useUpdateSubscription,
+  useWebChat: () => import_hooks.useWebChat
 });
 module.exports = __toCommonJS(index_exports);
 var import_js = require("@novu/js");
@@ -78,7 +78,6 @@ var import_hooks = require("./hooks/index.cjs");
   SubscriptionPreferences,
   TelegramConnectButton,
   WorkflowCriticalityEnum,
-  useAgentChat,
   useChannelConnection,
   useChannelConnections,
   useChannelEndpoint,
@@ -94,6 +93,7 @@ var import_hooks = require("./hooks/index.cjs");
   useSubscription,
   useSubscriptions,
   useTelegramSubscriberLink,
-  useUpdateSubscription
+  useUpdateSubscription,
+  useWebChat
 });
 //# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["export type * from '@novu/js';\nexport { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from '@novu/js';\n\nexport type {\n  AllLocalization,\n  AllLocalizationKey,\n  ChannelConnectButtonIconKey,\n  ElementStyles,\n  InboxAppearance,\n  InboxAppearanceCallback,\n  InboxAppearanceCallbackFunction,\n  InboxAppearanceCallbackKeys,\n  InboxAppearanceKey,\n  InboxElements,\n  InboxLocalization,\n  InboxLocalizationKey,\n  InboxTheme,\n  NotificationActionClickHandler,\n  NotificationClickHandler,\n  NotificationRenderer,\n  PreferenceGroups,\n  PreferencesFilter,\n  RouterPush,\n  SubscriptionAppearance,\n  SubscriptionAppearanceCallback,\n  SubscriptionAppearanceCallbackFunction,\n  SubscriptionAppearanceCallbackKeys,\n  SubscriptionAppearanceKey,\n  SubscriptionElements,\n  SubscriptionLocalization,\n  SubscriptionLocalizationKey,\n  SubscriptionTheme,\n  Tab,\n  Variables,\n} from '@novu/js/ui';\nexport type {\n  BellProps,\n  InboxContentProps,\n  InboxProps,\n  MsTeamsConnectButtonProps,\n  MsTeamsLinkUserProps,\n  NotificationProps,\n  NovuProviderProps,\n  SlackConnectButtonProps,\n  SlackLinkUserProps,\n  SubscriptionButtonProps,\n  SubscriptionPreferencesProps,\n  SubscriptionProps,\n  TelegramConnectButtonProps,\n} from './components';\nexport {\n  Bell,\n  Inbox,\n  InboxContent,\n  MsTeamsConnectButton,\n  MsTeamsLinkUser,\n  Notifications,\n  NovuProvider,\n  Preferences,\n  SlackConnectButton,\n  SlackLinkUser,\n  Subscription,\n  SubscriptionButton,\n  SubscriptionPreferences,\n  TelegramConnectButton,\n} from './components';\nexport type {\n  UseAgentChatProps,\n  UseAgentChatResult,\n  UseChannelConnectionProps,\n  UseChannelConnectionResult,\n  UseChannelConnectionsProps,\n  UseChannelConnectionsResult,\n  UseChannelEndpointProps,\n  UseChannelEndpointResult,\n  UseCountsProps,\n  UseCountsResult,\n  UseCreateChannelEndpointProps,\n  UseCreateChannelEndpointResult,\n  UseDeleteChannelEndpointProps,\n  UseDeleteChannelEndpointResult,\n  UseNotificationsProps,\n  UseNotificationsResult,\n  UsePreferencesResult,\n  UseScheduleProps as UsePreferencesProps,\n  UseTelegramSubscriberLinkProps,\n  UseTelegramSubscriberLinkResult,\n} from './hooks';\nexport {\n  useAgentChat,\n  useChannelConnection,\n  useChannelConnections,\n  useChannelEndpoint,\n  useCounts,\n  useCreateChannelEndpoint,\n  useCreateSubscription,\n  useDeleteChannelEndpoint,\n  useNotifications,\n  useNovu,\n  usePreferences,\n  useRemoveSubscription,\n  useSchedule,\n  useSubscription,\n  useSubscriptions,\n  useTelegramSubscriberLink,\n  useUpdateSubscription,\n} from './hooks';\n\nexport type {\n  BaseProps,\n  BellRenderer,\n  BodyRenderer,\n  DefaultInboxProps,\n  DefaultProps,\n  NoRendererProps,\n  NotificationRendererProps,\n  NotificationsRenderer,\n  ReactAllAppearance,\n  ReactInboxAppearance,\n  ReactInboxTheme,\n  ReactSubscriptionAppearance,\n  ReactSubscriptionTheme,\n  SubjectBodyRendererProps,\n  SubjectRenderer,\n  WithChildrenProps,\n} from './utils/types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAA4E;AAiD5E,wBAeO;AAuBP,mBAkBO;","names":[]}
+{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["export type * from '@novu/js';\nexport { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from '@novu/js';\n\nexport type {\n  AllLocalization,\n  AllLocalizationKey,\n  ChannelConnectButtonIconKey,\n  ElementStyles,\n  InboxAppearance,\n  InboxAppearanceCallback,\n  InboxAppearanceCallbackFunction,\n  InboxAppearanceCallbackKeys,\n  InboxAppearanceKey,\n  InboxElements,\n  InboxLocalization,\n  InboxLocalizationKey,\n  InboxTheme,\n  NotificationActionClickHandler,\n  NotificationClickHandler,\n  NotificationRenderer,\n  PreferenceGroups,\n  PreferencesFilter,\n  RouterPush,\n  SubscriptionAppearance,\n  SubscriptionAppearanceCallback,\n  SubscriptionAppearanceCallbackFunction,\n  SubscriptionAppearanceCallbackKeys,\n  SubscriptionAppearanceKey,\n  SubscriptionElements,\n  SubscriptionLocalization,\n  SubscriptionLocalizationKey,\n  SubscriptionTheme,\n  Tab,\n  Variables,\n} from '@novu/js/ui';\nexport type {\n  BellProps,\n  InboxContentProps,\n  InboxProps,\n  MsTeamsConnectButtonProps,\n  MsTeamsLinkUserProps,\n  NotificationProps,\n  NovuProviderProps,\n  SlackConnectButtonProps,\n  SlackLinkUserProps,\n  SubscriptionButtonProps,\n  SubscriptionPreferencesProps,\n  SubscriptionProps,\n  TelegramConnectButtonProps,\n} from './components';\nexport {\n  Bell,\n  Inbox,\n  InboxContent,\n  MsTeamsConnectButton,\n  MsTeamsLinkUser,\n  Notifications,\n  NovuProvider,\n  Preferences,\n  SlackConnectButton,\n  SlackLinkUser,\n  Subscription,\n  SubscriptionButton,\n  SubscriptionPreferences,\n  TelegramConnectButton,\n} from './components';\nexport type {\n  UseWebChatProps,\n  UseWebChatResult,\n  UseChannelConnectionProps,\n  UseChannelConnectionResult,\n  UseChannelConnectionsProps,\n  UseChannelConnectionsResult,\n  UseChannelEndpointProps,\n  UseChannelEndpointResult,\n  UseCountsProps,\n  UseCountsResult,\n  UseCreateChannelEndpointProps,\n  UseCreateChannelEndpointResult,\n  UseDeleteChannelEndpointProps,\n  UseDeleteChannelEndpointResult,\n  UseNotificationsProps,\n  UseNotificationsResult,\n  UsePreferencesResult,\n  UseScheduleProps as UsePreferencesProps,\n  UseTelegramSubscriberLinkProps,\n  UseTelegramSubscriberLinkResult,\n} from './hooks';\nexport {\n  useWebChat,\n  useChannelConnection,\n  useChannelConnections,\n  useChannelEndpoint,\n  useCounts,\n  useCreateChannelEndpoint,\n  useCreateSubscription,\n  useDeleteChannelEndpoint,\n  useNotifications,\n  useNovu,\n  usePreferences,\n  useRemoveSubscription,\n  useSchedule,\n  useSubscription,\n  useSubscriptions,\n  useTelegramSubscriberLink,\n  useUpdateSubscription,\n} from './hooks';\n\nexport type {\n  BaseProps,\n  BellRenderer,\n  BodyRenderer,\n  DefaultInboxProps,\n  DefaultProps,\n  NoRendererProps,\n  NotificationRendererProps,\n  NotificationsRenderer,\n  ReactAllAppearance,\n  ReactInboxAppearance,\n  ReactInboxTheme,\n  ReactSubscriptionAppearance,\n  ReactSubscriptionTheme,\n  SubjectBodyRendererProps,\n  SubjectRenderer,\n  WithChildrenProps,\n} from './utils/types';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAA4E;AAiD5E,wBAeO;AAuBP,mBAkBO;","names":[]}

package/dist/cjs/index.d.cts

@@ -15,7 +15,7 @@ export { Subscription, SubscriptionProps } from './components/subscription/Subsc
 export { SubscriptionButton, SubscriptionButtonProps } from './components/subscription/SubscriptionButton.cjs';
 export { SubscriptionPreferences, SubscriptionPreferencesProps } from './components/subscription/SubscriptionPreferences.cjs';
 export { TelegramConnectButton, TelegramConnectButtonProps } from './components/telegram-connect-button/TelegramConnectButton.cjs';
-export { UseAgentChatProps, UseAgentChatResult, useAgentChat } from './hooks/useAgentChat.cjs';
+export { UseWebChatProps, UseWebChatResult, useWebChat } from './hooks/useWebChat.cjs';
 export { UseChannelConnectionProps, UseChannelConnectionResult, useChannelConnection } from './hooks/useChannelConnection.cjs';
 export { UseChannelConnectionsProps, UseChannelConnectionsResult, useChannelConnections } from './hooks/useChannelConnections.cjs';
 export { UseChannelEndpointProps, UseChannelEndpointResult, useChannelEndpoint } from './hooks/useChannelEndpoint.cjs';