@novu/react 3.15.0 → 3.16.0

package/dist/esm/hooks/NovuProvider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/NovuProvider.tsx"],"sourcesContent":["import { Novu, NovuOptions } from '@novu/js';\nimport { buildSubscriber } from '@novu/js/internal';\nimport { createContext, ReactNode, useContext, useMemo } from 'react';\n\nexport type NovuProviderProps = NovuOptions & {\n  children: ReactNode;\n};\n\nconst NovuContext = createContext<Novu | undefined>(undefined);\n\nexport const NovuProvider = (props: NovuProviderProps) => {\n  const { subscriberId, ...propsWithoutSubscriberId } = props;\n  const subscriberObj = useMemo(\n    () => buildSubscriber({ subscriberId, subscriber: props.subscriber }),\n    [subscriberId, props.subscriber]\n  );\n  const applicationIdentifier = propsWithoutSubscriberId.applicationIdentifier\n    ? propsWithoutSubscriberId.applicationIdentifier\n    : '';\n\n  const providerProps: NovuProviderProps = {\n    ...propsWithoutSubscriberId,\n    applicationIdentifier,\n    subscriber: subscriberObj,\n  };\n\n  return (\n    <InternalNovuProvider {...providerProps} applicationIdentifier={applicationIdentifier}>\n      {props.children}\n    </InternalNovuProvider>\n  );\n};\n\n/**\n * @internal Should be used internally not to be exposed outside of the library\n */\nexport const InternalNovuProvider = (props: NovuProviderProps) => {\n  const applicationIdentifier = props.applicationIdentifier || '';\n  const subscriberObj = useMemo(\n    () => buildSubscriber({ subscriberId: props.subscriberId, subscriber: props.subscriber }),\n    [props.subscriberId, props.subscriber]\n  );\n\n  const {\n    children,\n    subscriberHash,\n    contextHash,\n    backendUrl,\n    apiUrl,\n    socketUrl,\n    socketOptions,\n    useCache,\n    defaultSchedule,\n    context,\n  } = props;\n\n  const novu = useMemo(\n    () =>\n      new Novu({\n        applicationIdentifier,\n        subscriberHash,\n        contextHash,\n        backendUrl,\n        apiUrl,\n        socketUrl,\n        socketOptions,\n        useCache,\n        subscriber: subscriberObj,\n        defaultSchedule,\n        context,\n      }),\n    [\n      applicationIdentifier,\n      subscriberHash,\n      subscriberObj,\n      context,\n      contextHash,\n      backendUrl,\n      apiUrl,\n      socketUrl,\n      socketOptions,\n      useCache,\n    ]\n  );\n\n  return <NovuContext.Provider value={novu}>{children}</NovuContext.Provider>;\n};\n\nexport const useNovu = () => {\n  const context = useContext(NovuContext);\n  if (!context) {\n    throw new Error('useNovu must be used within a <NovuProvider />');\n  }\n\n  return context;\n};\n\nexport const useUnsafeNovu = () => {\n  const context = useContext(NovuContext);\n\n  return context;\n};\n"],"mappings":";AAAA,SAAS,YAAyB;AAClC,SAAS,uBAAuB;AAChC,SAAS,eAA0B,YAAY,eAAe;AAyB1D;AAnBJ,IAAM,cAAc,cAAgC,MAAS;AAEtD,IAAM,eAAe,CAAC,UAA6B;AACxD,QAAM,EAAE,cAAc,GAAG,yBAAyB,IAAI;AACtD,QAAM,gBAAgB;AAAA,IACpB,MAAM,gBAAgB,EAAE,cAAc,YAAY,MAAM,WAAW,CAAC;AAAA,IACpE,CAAC,cAAc,MAAM,UAAU;AAAA,EACjC;AACA,QAAM,wBAAwB,yBAAyB,wBACnD,yBAAyB,wBACzB;AAEJ,QAAM,gBAAmC;AAAA,IACvC,GAAG;AAAA,IACH;AAAA,IACA,YAAY;AAAA,EACd;AAEA,SACE,oBAAC,wBAAsB,GAAG,eAAe,uBACtC,gBAAM,UACT;AAEJ;AAKO,IAAM,uBAAuB,CAAC,UAA6B;AAChE,QAAM,wBAAwB,MAAM,yBAAyB;AAC7D,QAAM,gBAAgB;AAAA,IACpB,MAAM,gBAAgB,EAAE,cAAc,MAAM,cAAc,YAAY,MAAM,WAAW,CAAC;AAAA,IACxF,CAAC,MAAM,cAAc,MAAM,UAAU;AAAA,EACvC;AAEA,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,QAAM,OAAO;AAAA,IACX,MACE,IAAI,KAAK;AAAA,MACP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,YAAY;AAAA,MACZ;AAAA,MACA;AAAA,IACF,CAAC;AAAA,IACH;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,oBAAC,YAAY,UAAZ,EAAqB,OAAO,MAAO,UAAS;AACtD;AAEO,IAAM,UAAU,MAAM;AAC3B,QAAM,UAAU,WAAW,WAAW;AACtC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AAEA,SAAO;AACT;AAEO,IAAM,gBAAgB,MAAM;AACjC,QAAM,UAAU,WAAW,WAAW;AAEtC,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../src/hooks/NovuProvider.tsx"],"sourcesContent":["import { Novu, NovuOptions } from '@novu/js';\nimport { buildSubscriber } from '@novu/js/internal';\nimport { createContext, ReactNode, useContext, useMemo } from 'react';\n\nexport type NovuProviderProps = NovuOptions & {\n  /**\n   * When `false`, disables the WebSocket subscription that auto-injects\n   * newly received notifications into the list and subscription that auto-resync\n   * notification counts. Built-in mutations like\n   * `readAll`, `seenAll`, `archiveAll`, and `archiveAllRead` continue to\n   * update local state. Use this when you want to drive new-notification updates yourself (e.g.\n   * via your own `novu.on('notifications.notification_received', ...)`\n   * handler combined with `refetch()`). Defaults to `true`.\n   */\n  realtime?: boolean;\n  children: ReactNode;\n};\n\nconst NovuContext = createContext<{ novu: Novu; realtime: boolean }>({ novu: undefined as any, realtime: true });\n\nexport const NovuProvider = (props: NovuProviderProps) => {\n  const { subscriberId, realtime = true, ...propsWithoutSubscriberId } = props;\n  const subscriberObj = useMemo(\n    () => buildSubscriber({ subscriberId, subscriber: props.subscriber }),\n    [subscriberId, props.subscriber]\n  );\n  const applicationIdentifier = propsWithoutSubscriberId.applicationIdentifier\n    ? propsWithoutSubscriberId.applicationIdentifier\n    : '';\n\n  const providerProps: NovuProviderProps = {\n    ...propsWithoutSubscriberId,\n    applicationIdentifier,\n    subscriber: subscriberObj,\n    realtime,\n  };\n\n  return (\n    <InternalNovuProvider {...providerProps} applicationIdentifier={applicationIdentifier}>\n      {props.children}\n    </InternalNovuProvider>\n  );\n};\n\n/**\n * @internal Should be used internally not to be exposed outside of the library\n */\nexport const InternalNovuProvider = (props: NovuProviderProps) => {\n  const applicationIdentifier = props.applicationIdentifier || '';\n  const subscriberObj = useMemo(\n    () => buildSubscriber({ subscriberId: props.subscriberId, subscriber: props.subscriber }),\n    [props.subscriberId, props.subscriber]\n  );\n\n  const {\n    children,\n    subscriberHash,\n    contextHash,\n    backendUrl,\n    apiUrl,\n    socketUrl,\n    socketOptions,\n    useCache,\n    defaultSchedule,\n    context,\n    realtime = true,\n  } = props;\n\n  const value = useMemo(\n    () => ({\n      novu: new Novu({\n        applicationIdentifier,\n        subscriberHash,\n        contextHash,\n        backendUrl,\n        apiUrl,\n        socketUrl,\n        socketOptions,\n        useCache,\n        subscriber: subscriberObj,\n        defaultSchedule,\n        context,\n      }),\n      realtime,\n    }),\n    [\n      applicationIdentifier,\n      subscriberHash,\n      subscriberObj,\n      context,\n      contextHash,\n      backendUrl,\n      apiUrl,\n      socketUrl,\n      socketOptions,\n      useCache,\n      realtime,\n    ]\n  );\n\n  return <NovuContext.Provider value={value}>{children}</NovuContext.Provider>;\n};\n\nexport const useNovu = () => {\n  const context = useContext(NovuContext);\n  if (!context.novu) {\n    throw new Error('useNovu must be used within a <NovuProvider />');\n  }\n\n  return context.novu;\n};\n\nexport const useUnsafeNovu = () => {\n  const context = useContext(NovuContext);\n\n  return context.novu;\n};\n\nexport const useRealtime = () => {\n  const context = useContext(NovuContext);\n\n  return context.realtime;\n};\n"],"mappings":";AAAA,SAAS,YAAyB;AAClC,SAAS,uBAAuB;AAChC,SAAS,eAA0B,YAAY,eAAe;AAoC1D;AApBJ,IAAM,cAAc,cAAiD,EAAE,MAAM,QAAkB,UAAU,KAAK,CAAC;AAExG,IAAM,eAAe,CAAC,UAA6B;AACxD,QAAM,EAAE,cAAc,WAAW,MAAM,GAAG,yBAAyB,IAAI;AACvE,QAAM,gBAAgB;AAAA,IACpB,MAAM,gBAAgB,EAAE,cAAc,YAAY,MAAM,WAAW,CAAC;AAAA,IACpE,CAAC,cAAc,MAAM,UAAU;AAAA,EACjC;AACA,QAAM,wBAAwB,yBAAyB,wBACnD,yBAAyB,wBACzB;AAEJ,QAAM,gBAAmC;AAAA,IACvC,GAAG;AAAA,IACH;AAAA,IACA,YAAY;AAAA,IACZ;AAAA,EACF;AAEA,SACE,oBAAC,wBAAsB,GAAG,eAAe,uBACtC,gBAAM,UACT;AAEJ;AAKO,IAAM,uBAAuB,CAAC,UAA6B;AAChE,QAAM,wBAAwB,MAAM,yBAAyB;AAC7D,QAAM,gBAAgB;AAAA,IACpB,MAAM,gBAAgB,EAAE,cAAc,MAAM,cAAc,YAAY,MAAM,WAAW,CAAC;AAAA,IACxF,CAAC,MAAM,cAAc,MAAM,UAAU;AAAA,EACvC;AAEA,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW;AAAA,EACb,IAAI;AAEJ,QAAM,QAAQ;AAAA,IACZ,OAAO;AAAA,MACL,MAAM,IAAI,KAAK;AAAA,QACb;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,YAAY;AAAA,QACZ;AAAA,QACA;AAAA,MACF,CAAC;AAAA,MACD;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,oBAAC,YAAY,UAAZ,EAAqB,OAAe,UAAS;AACvD;AAEO,IAAM,UAAU,MAAM;AAC3B,QAAM,UAAU,WAAW,WAAW;AACtC,MAAI,CAAC,QAAQ,MAAM;AACjB,UAAM,IAAI,MAAM,gDAAgD;AAAA,EAClE;AAEA,SAAO,QAAQ;AACjB;AAEO,IAAM,gBAAgB,MAAM;AACjC,QAAM,UAAU,WAAW,WAAW;AAEtC,SAAO,QAAQ;AACjB;AAEO,IAAM,cAAc,MAAM;AAC/B,QAAM,UAAU,WAAW,WAAW;AAEtC,SAAO,QAAQ;AACjB;","names":[]}

package/dist/esm/hooks/index.d.ts

@@ -1,8 +1,13 @@
 export * from '@novu/js';
 export { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from '@novu/js';
 export { NovuProvider, useNovu } from './NovuProvider.js';
+export { UseChannelConnectionProps, UseChannelConnectionResult, useChannelConnection } from './useChannelConnection.js';
+export { UseChannelConnectionsProps, UseChannelConnectionsResult, useChannelConnections } from './useChannelConnections.js';
+export { UseChannelEndpointProps, UseChannelEndpointResult, useChannelEndpoint } from './useChannelEndpoint.js';
 export { UseCountsProps, UseCountsResult, useCounts } from './useCounts.js';
+export { UseCreateChannelEndpointProps, UseCreateChannelEndpointResult, useCreateChannelEndpoint } from './useCreateChannelEndpoint.js';
 export { UseCreateSubscriptionProps, UseCreateSubscriptionResult, useCreateSubscription } from './useCreateSubscription.js';
+export { UseDeleteChannelEndpointProps, UseDeleteChannelEndpointResult, useDeleteChannelEndpoint } from './useDeleteChannelEndpoint.js';
 export { UseNotificationsProps, UseNotificationsResult, useNotifications } from './useNotifications.js';
 export { UsePreferencesProps, UsePreferencesResult, usePreferences } from './usePreferences.js';
 export { UseRemoveSubscriptionProps, UseRemoveSubscriptionResult, useRemoveSubscription } from './useRemoveSubscription.js';

package/dist/esm/hooks/index.js

@@ -1,8 +1,13 @@
 // src/hooks/index.ts
 import { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from "@novu/js";
 import { NovuProvider, useNovu } from "./NovuProvider.js";
+export * from "./useChannelConnection.js";
+export * from "./useChannelConnections.js";
+export * from "./useChannelEndpoint.js";
 export * from "./useCounts.js";
+export * from "./useCreateChannelEndpoint.js";
 export * from "./useCreateSubscription.js";
+export * from "./useDeleteChannelEndpoint.js";
 export * from "./useNotifications.js";
 export * from "./usePreferences.js";
 export * from "./useRemoveSubscription.js";

package/dist/esm/hooks/index.js.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 './useCounts';\nexport * from './useCreateSubscription';\nexport * from './useNotifications';\nexport * from './usePreferences';\nexport * from './useRemoveSubscription';\nexport * from './useSchedule';\nexport * from './useSubscription';\nexport * from './useSubscriptions';\nexport * from './useUpdateSubscription';\n"],"mappings":";AACA,SAAS,iBAAiB,mBAAmB,+BAA+B;AAC5E,SAAS,cAAc,eAAe;AACtC,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","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 './useChannelConnection';\nexport * from './useChannelConnections';\nexport * from './useChannelEndpoint';\nexport * from './useCounts';\nexport * from './useCreateChannelEndpoint';\nexport * from './useCreateSubscription';\nexport * from './useDeleteChannelEndpoint';\nexport * from './useNotifications';\nexport * from './usePreferences';\nexport * from './useRemoveSubscription';\nexport * from './useSchedule';\nexport * from './useSubscription';\nexport * from './useSubscriptions';\nexport * from './useUpdateSubscription';\n"],"mappings":";AACA,SAAS,iBAAiB,mBAAmB,+BAA+B;AAC5E,SAAS,cAAc,eAAe;AACtC,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/esm/hooks/internal/useBrowserTabsChannel.d.ts

@@ -1,6 +1,7 @@
-declare const useBrowserTabsChannel: <T = unknown>({ channelName, onMessage, }: {
+declare const useBrowserTabsChannel: <T = unknown>({ channelName, onMessage, enabled, }: {
     channelName: string;
     onMessage: (args: T) => void;
+    enabled?: boolean;
 }) => {
     postMessage: (data: T) => void;
 };

package/dist/esm/hooks/internal/useBrowserTabsChannel.js

@@ -2,15 +2,18 @@
 import { useEffect, useState } from "react";
 var useBrowserTabsChannel = ({
   channelName,
-  onMessage
+  onMessage,
+  enabled = true
 }) => {
   const [tabsChannel] = useState(
     typeof BroadcastChannel !== "undefined" ? new BroadcastChannel(channelName) : void 0
   );
   const postMessage = (data) => {
+    if (!enabled) return;
     tabsChannel?.postMessage(data);
   };
   useEffect(() => {
+    if (!enabled) return;
     const listener = (event) => {
       onMessage(event.data);
     };
@@ -18,7 +21,7 @@ var useBrowserTabsChannel = ({
     return () => {
       tabsChannel?.removeEventListener("message", listener);
     };
-  }, []);
+  }, [enabled]);
   return { postMessage };
 };
 export {

package/dist/esm/hooks/internal/useBrowserTabsChannel.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/hooks/internal/useBrowserTabsChannel.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nexport const useBrowserTabsChannel = <T = unknown>({\n  channelName,\n  onMessage,\n}: {\n  channelName: string;\n  onMessage: (args: T) => void;\n}) => {\n  const [tabsChannel] = useState(\n    typeof BroadcastChannel !== 'undefined' ? new BroadcastChannel(channelName) : undefined\n  );\n\n  const postMessage = (data: T) => {\n    tabsChannel?.postMessage(data);\n  };\n\n  useEffect(() => {\n    const listener = (event: MessageEvent<T>) => {\n      onMessage(event.data);\n    };\n\n    tabsChannel?.addEventListener('message', listener);\n\n    return () => {\n      tabsChannel?.removeEventListener('message', listener);\n    };\n  }, []);\n\n  return { postMessage };\n};\n"],"mappings":";AAAA,SAAS,WAAW,gBAAgB;AAE7B,IAAM,wBAAwB,CAAc;AAAA,EACjD;AAAA,EACA;AACF,MAGM;AACJ,QAAM,CAAC,WAAW,IAAI;AAAA,IACpB,OAAO,qBAAqB,cAAc,IAAI,iBAAiB,WAAW,IAAI;AAAA,EAChF;AAEA,QAAM,cAAc,CAAC,SAAY;AAC/B,iBAAa,YAAY,IAAI;AAAA,EAC/B;AAEA,YAAU,MAAM;AACd,UAAM,WAAW,CAAC,UAA2B;AAC3C,gBAAU,MAAM,IAAI;AAAA,IACtB;AAEA,iBAAa,iBAAiB,WAAW,QAAQ;AAEjD,WAAO,MAAM;AACX,mBAAa,oBAAoB,WAAW,QAAQ;AAAA,IACtD;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,YAAY;AACvB;","names":[]}
+{"version":3,"sources":["../../../../src/hooks/internal/useBrowserTabsChannel.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nexport const useBrowserTabsChannel = <T = unknown>({\n  channelName,\n  onMessage,\n  enabled = true,\n}: {\n  channelName: string;\n  onMessage: (args: T) => void;\n  enabled?: boolean;\n}) => {\n  const [tabsChannel] = useState(\n    typeof BroadcastChannel !== 'undefined' ? new BroadcastChannel(channelName) : undefined\n  );\n\n  const postMessage = (data: T) => {\n    if (!enabled) return;\n    tabsChannel?.postMessage(data);\n  };\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    const listener = (event: MessageEvent<T>) => {\n      onMessage(event.data);\n    };\n\n    tabsChannel?.addEventListener('message', listener);\n\n    return () => {\n      tabsChannel?.removeEventListener('message', listener);\n    };\n  }, [enabled]);\n\n  return { postMessage };\n};\n"],"mappings":";AAAA,SAAS,WAAW,gBAAgB;AAE7B,IAAM,wBAAwB,CAAc;AAAA,EACjD;AAAA,EACA;AAAA,EACA,UAAU;AACZ,MAIM;AACJ,QAAM,CAAC,WAAW,IAAI;AAAA,IACpB,OAAO,qBAAqB,cAAc,IAAI,iBAAiB,WAAW,IAAI;AAAA,EAChF;AAEA,QAAM,cAAc,CAAC,SAAY;AAC/B,QAAI,CAAC,QAAS;AACd,iBAAa,YAAY,IAAI;AAAA,EAC/B;AAEA,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AAEd,UAAM,WAAW,CAAC,UAA2B;AAC3C,gBAAU,MAAM,IAAI;AAAA,IACtB;AAEA,iBAAa,iBAAiB,WAAW,QAAQ;AAEjD,WAAO,MAAM;AACX,mBAAa,oBAAoB,WAAW,QAAQ;AAAA,IACtD;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AAEZ,SAAO,EAAE,YAAY;AACvB;","names":[]}

package/dist/esm/hooks/internal/useWebsocketEvent.d.ts

@@ -1,8 +1,9 @@
 import { SocketEventNames, Events } from '@novu/js';
 
-declare const useWebSocketEvent: <E extends SocketEventNames>({ event: webSocketEvent, eventHandler: onMessage, }: {
+declare const useWebSocketEvent: <E extends SocketEventNames>({ event: webSocketEvent, eventHandler: onMessage, enabled, }: {
     event: E;
     eventHandler: (args: Events[E]) => void;
+    enabled?: boolean;
 }) => void;
 
 export { useWebSocketEvent };

package/dist/esm/hooks/internal/useWebsocketEvent.js

@@ -5,19 +5,22 @@ import { useNovu } from "../NovuProvider.js";
 import { useBrowserTabsChannel } from "./useBrowserTabsChannel.js";
 var useWebSocketEvent = ({
   event: webSocketEvent,
-  eventHandler: onMessage
+  eventHandler: onMessage,
+  enabled = true
 }) => {
   const novu = useNovu();
   const channelName = `nv_ws_connection:a=${novu.applicationIdentifier}:s=${novu.subscriberId}:c=${novu.contextKey}:e=${webSocketEvent}`;
   const { postMessage } = useBrowserTabsChannel({
     channelName,
-    onMessage
+    onMessage,
+    enabled
   });
   const updateReadCount = (data) => {
     onMessage(data);
     postMessage(data);
   };
   useEffect(() => {
+    if (!enabled) return;
     let cleanup;
     const resolveLock = requestLock(channelName, () => {
       cleanup = novu.on(webSocketEvent, updateReadCount);
@@ -28,7 +31,7 @@ var useWebSocketEvent = ({
       }
       resolveLock();
     };
-  }, []);
+  }, [enabled]);
 };
 export {
   useWebSocketEvent

package/dist/esm/hooks/internal/useWebsocketEvent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/hooks/internal/useWebsocketEvent.ts"],"sourcesContent":["import { EventHandler, Events, SocketEventNames } from '@novu/js';\nimport { useEffect } from 'react';\nimport { requestLock } from '../../utils/requestLock';\nimport { useNovu } from '../NovuProvider';\nimport { useBrowserTabsChannel } from './useBrowserTabsChannel';\n\nexport const useWebSocketEvent = <E extends SocketEventNames>({\n  event: webSocketEvent,\n  eventHandler: onMessage,\n}: {\n  event: E;\n  eventHandler: (args: Events[E]) => void;\n}) => {\n  const novu = useNovu();\n  const channelName = `nv_ws_connection:a=${novu.applicationIdentifier}:s=${novu.subscriberId}:c=${novu.contextKey}:e=${webSocketEvent}`;\n\n  const { postMessage } = useBrowserTabsChannel({\n    channelName,\n    onMessage,\n  });\n\n  const updateReadCount: EventHandler<Events[E]> = (data) => {\n    onMessage(data);\n    postMessage(data);\n  };\n\n  useEffect(() => {\n    let cleanup: () => void;\n    const resolveLock = requestLock(channelName, () => {\n      cleanup = novu.on(webSocketEvent, updateReadCount);\n    });\n\n    return () => {\n      if (cleanup) {\n        cleanup();\n      }\n\n      resolveLock();\n    };\n  }, []);\n};\n"],"mappings":";AACA,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AACxB,SAAS,6BAA6B;AAE/B,IAAM,oBAAoB,CAA6B;AAAA,EAC5D,OAAO;AAAA,EACP,cAAc;AAChB,MAGM;AACJ,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,sBAAsB,KAAK,qBAAqB,MAAM,KAAK,YAAY,MAAM,KAAK,UAAU,MAAM,cAAc;AAEpI,QAAM,EAAE,YAAY,IAAI,sBAAsB;AAAA,IAC5C;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,kBAA2C,CAAC,SAAS;AACzD,cAAU,IAAI;AACd,gBAAY,IAAI;AAAA,EAClB;AAEA,YAAU,MAAM;AACd,QAAI;AACJ,UAAM,cAAc,YAAY,aAAa,MAAM;AACjD,gBAAU,KAAK,GAAG,gBAAgB,eAAe;AAAA,IACnD,CAAC;AAED,WAAO,MAAM;AACX,UAAI,SAAS;AACX,gBAAQ;AAAA,MACV;AAEA,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,CAAC;AACP;","names":[]}
+{"version":3,"sources":["../../../../src/hooks/internal/useWebsocketEvent.ts"],"sourcesContent":["import { EventHandler, Events, SocketEventNames } from '@novu/js';\nimport { useEffect } from 'react';\nimport { requestLock } from '../../utils/requestLock';\nimport { useNovu } from '../NovuProvider';\nimport { useBrowserTabsChannel } from './useBrowserTabsChannel';\n\nexport const useWebSocketEvent = <E extends SocketEventNames>({\n  event: webSocketEvent,\n  eventHandler: onMessage,\n  enabled = true,\n}: {\n  event: E;\n  eventHandler: (args: Events[E]) => void;\n  enabled?: boolean;\n}) => {\n  const novu = useNovu();\n  const channelName = `nv_ws_connection:a=${novu.applicationIdentifier}:s=${novu.subscriberId}:c=${novu.contextKey}:e=${webSocketEvent}`;\n\n  const { postMessage } = useBrowserTabsChannel({\n    channelName,\n    onMessage,\n    enabled,\n  });\n\n  const updateReadCount: EventHandler<Events[E]> = (data) => {\n    onMessage(data);\n    postMessage(data);\n  };\n\n  useEffect(() => {\n    if (!enabled) return;\n\n    let cleanup: () => void;\n    const resolveLock = requestLock(channelName, () => {\n      cleanup = novu.on(webSocketEvent, updateReadCount);\n    });\n\n    return () => {\n      if (cleanup) {\n        cleanup();\n      }\n\n      resolveLock();\n    };\n  }, [enabled]);\n};\n"],"mappings":";AACA,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AACxB,SAAS,6BAA6B;AAE/B,IAAM,oBAAoB,CAA6B;AAAA,EAC5D,OAAO;AAAA,EACP,cAAc;AAAA,EACd,UAAU;AACZ,MAIM;AACJ,QAAM,OAAO,QAAQ;AACrB,QAAM,cAAc,sBAAsB,KAAK,qBAAqB,MAAM,KAAK,YAAY,MAAM,KAAK,UAAU,MAAM,cAAc;AAEpI,QAAM,EAAE,YAAY,IAAI,sBAAsB;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAED,QAAM,kBAA2C,CAAC,SAAS;AACzD,cAAU,IAAI;AACd,gBAAY,IAAI;AAAA,EAClB;AAEA,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AAEd,QAAI;AACJ,UAAM,cAAc,YAAY,aAAa,MAAM;AACjD,gBAAU,KAAK,GAAG,gBAAgB,eAAe;AAAA,IACnD,CAAC;AAED,WAAO,MAAM;AACX,UAAI,SAAS;AACX,gBAAQ;AAAA,MACV;AAEA,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AACd;","names":[]}

package/dist/esm/hooks/useChannelConnection.d.ts

@@ -0,0 +1,20 @@
+import { ChannelConnectionResponse, NovuError } from '@novu/js';
+
+type UseChannelConnectionProps = {
+    identifier: string;
+    onSuccess?: (data: ChannelConnectionResponse | null) => void;
+    onError?: (error: NovuError) => void;
+};
+type UseChannelConnectionResult = {
+    connection?: ChannelConnectionResponse | null;
+    error?: NovuError;
+    isLoading: boolean;
+    isFetching: boolean;
+    refetch: () => Promise<void>;
+};
+/**
+ * Get a channel connection by identifier.
+ */
+declare const useChannelConnection: (props: UseChannelConnectionProps) => UseChannelConnectionResult;
+
+export { type UseChannelConnectionProps, type UseChannelConnectionResult, useChannelConnection };

package/dist/esm/hooks/useChannelConnection.js

@@ -0,0 +1,81 @@
+// src/hooks/useChannelConnection.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useNovu } from "./NovuProvider.js";
+var useChannelConnection = (props) => {
+  const novu = useNovu();
+  const propsRef = useRef(props);
+  propsRef.current = props;
+  const [connection, setConnection] = useState();
+  const [error, setError] = useState();
+  const [isLoading, setIsLoading] = useState(true);
+  const [isFetching, setIsFetching] = useState(false);
+  const fetchConnection = useCallback(
+    async (options) => {
+      const { identifier, onSuccess, onError } = propsRef.current;
+      if (options?.refetch) {
+        setError(void 0);
+        setIsLoading(true);
+      }
+      setIsFetching(true);
+      const response = await novu.channelConnections.get({ identifier });
+      if (response.error) {
+        setError(response.error);
+        onError?.(response.error);
+      } else if (response.data !== void 0) {
+        onSuccess?.(response.data);
+        setConnection(response.data);
+      }
+      setIsLoading(false);
+      setIsFetching(false);
+    },
+    [novu]
+  );
+  useEffect(() => {
+    const cleanupGetPending = novu.on("channel-connection.get.pending", ({ args }) => {
+      if (!args || args.identifier !== propsRef.current.identifier) {
+        return;
+      }
+      setIsFetching(true);
+    });
+    const cleanupGetResolved = novu.on("channel-connection.get.resolved", ({ args, data, error: resolvedError }) => {
+      if (!args || args.identifier !== propsRef.current.identifier) {
+        return;
+      }
+      const { onSuccess, onError } = propsRef.current;
+      if (resolvedError) {
+        setError(resolvedError);
+        onError?.(resolvedError);
+      } else {
+        setConnection(data ?? null);
+        onSuccess?.(data ?? null);
+      }
+      setIsFetching(false);
+    });
+    const cleanupDeleteResolved = novu.on("channel-connection.delete.resolved", ({ args }) => {
+      if (!args || args.identifier !== propsRef.current.identifier) {
+        return;
+      }
+      setConnection(null);
+      propsRef.current.onSuccess?.(null);
+      setIsFetching(false);
+    });
+    void fetchConnection({ refetch: true });
+    return () => {
+      cleanupGetPending();
+      cleanupGetResolved();
+      cleanupDeleteResolved();
+    };
+  }, [novu, fetchConnection, props.identifier]);
+  const refetch = useCallback(() => fetchConnection({ refetch: true }), [fetchConnection]);
+  return {
+    connection,
+    error,
+    isLoading,
+    isFetching,
+    refetch
+  };
+};
+export {
+  useChannelConnection
+};
+//# sourceMappingURL=useChannelConnection.js.map

package/dist/esm/hooks/useChannelConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hooks/useChannelConnection.ts"],"sourcesContent":["import type { ChannelConnectionResponse, NovuError } from '@novu/js';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { useNovu } from './NovuProvider';\n\nexport type UseChannelConnectionProps = {\n  identifier: string;\n  onSuccess?: (data: ChannelConnectionResponse | null) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseChannelConnectionResult = {\n  connection?: ChannelConnectionResponse | null;\n  error?: NovuError;\n  isLoading: boolean;\n  isFetching: boolean;\n  refetch: () => Promise<void>;\n};\n\n/**\n * Get a channel connection by identifier.\n */\nexport const useChannelConnection = (props: UseChannelConnectionProps): UseChannelConnectionResult => {\n  const novu = useNovu();\n  const propsRef = useRef<UseChannelConnectionProps>(props);\n  propsRef.current = props;\n\n  const [connection, setConnection] = useState<ChannelConnectionResponse | null>();\n  const [error, setError] = useState<NovuError>();\n  const [isLoading, setIsLoading] = useState(true);\n  const [isFetching, setIsFetching] = useState(false);\n\n  const fetchConnection = useCallback(\n    async (options?: { refetch: boolean }) => {\n      const { identifier, onSuccess, onError } = propsRef.current;\n      if (options?.refetch) {\n        setError(undefined);\n        setIsLoading(true);\n      }\n\n      setIsFetching(true);\n\n      const response = await novu.channelConnections.get({ identifier });\n\n      if (response.error) {\n        setError(response.error as NovuError);\n        onError?.(response.error as NovuError);\n      } else if (response.data !== undefined) {\n        onSuccess?.(response.data);\n        setConnection(response.data);\n      }\n      setIsLoading(false);\n      setIsFetching(false);\n    },\n    [novu]\n  );\n\n  // props.identifier triggers a re-fetch and re-registration whenever the\n  // caller switches to a different identifier; fetchConnection reads it from\n  // propsRef at call-time so it doesn't appear in the callback body directly.\n  // biome-ignore lint/correctness/useExhaustiveDependencies: props.identifier is an intentional trigger dependency\n  useEffect(() => {\n    const cleanupGetPending = novu.on('channel-connection.get.pending', ({ args }) => {\n      if (!args || args.identifier !== propsRef.current.identifier) {\n        return;\n      }\n      setIsFetching(true);\n    });\n\n    const cleanupGetResolved = novu.on('channel-connection.get.resolved', ({ args, data, error: resolvedError }) => {\n      if (!args || args.identifier !== propsRef.current.identifier) {\n        return;\n      }\n      const { onSuccess, onError } = propsRef.current;\n      if (resolvedError) {\n        setError(resolvedError as NovuError);\n        onError?.(resolvedError as NovuError);\n      } else {\n        setConnection((data as ChannelConnectionResponse) ?? null);\n        onSuccess?.((data as ChannelConnectionResponse) ?? null);\n      }\n      setIsFetching(false);\n    });\n\n    const cleanupDeleteResolved = novu.on('channel-connection.delete.resolved', ({ args }) => {\n      if (!args || args.identifier !== propsRef.current.identifier) {\n        return;\n      }\n      setConnection(null);\n      propsRef.current.onSuccess?.(null);\n      setIsFetching(false);\n    });\n\n    void fetchConnection({ refetch: true });\n\n    return () => {\n      cleanupGetPending();\n      cleanupGetResolved();\n      cleanupDeleteResolved();\n    };\n  }, [novu, fetchConnection, props.identifier]);\n\n  const refetch = useCallback(() => fetchConnection({ refetch: true }), [fetchConnection]);\n\n  return {\n    connection,\n    error,\n    isLoading,\n    isFetching,\n    refetch,\n  };\n};\n"],"mappings":";AACA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AACzD,SAAS,eAAe;AAmBjB,IAAM,uBAAuB,CAAC,UAAiE;AACpG,QAAM,OAAO,QAAQ;AACrB,QAAM,WAAW,OAAkC,KAAK;AACxD,WAAS,UAAU;AAEnB,QAAM,CAAC,YAAY,aAAa,IAAI,SAA2C;AAC/E,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAoB;AAC9C,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,QAAM,kBAAkB;AAAA,IACtB,OAAO,YAAmC;AACxC,YAAM,EAAE,YAAY,WAAW,QAAQ,IAAI,SAAS;AACpD,UAAI,SAAS,SAAS;AACpB,iBAAS,MAAS;AAClB,qBAAa,IAAI;AAAA,MACnB;AAEA,oBAAc,IAAI;AAElB,YAAM,WAAW,MAAM,KAAK,mBAAmB,IAAI,EAAE,WAAW,CAAC;AAEjE,UAAI,SAAS,OAAO;AAClB,iBAAS,SAAS,KAAkB;AACpC,kBAAU,SAAS,KAAkB;AAAA,MACvC,WAAW,SAAS,SAAS,QAAW;AACtC,oBAAY,SAAS,IAAI;AACzB,sBAAc,SAAS,IAAI;AAAA,MAC7B;AACA,mBAAa,KAAK;AAClB,oBAAc,KAAK;AAAA,IACrB;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAMA,YAAU,MAAM;AACd,UAAM,oBAAoB,KAAK,GAAG,kCAAkC,CAAC,EAAE,KAAK,MAAM;AAChF,UAAI,CAAC,QAAQ,KAAK,eAAe,SAAS,QAAQ,YAAY;AAC5D;AAAA,MACF;AACA,oBAAc,IAAI;AAAA,IACpB,CAAC;AAED,UAAM,qBAAqB,KAAK,GAAG,mCAAmC,CAAC,EAAE,MAAM,MAAM,OAAO,cAAc,MAAM;AAC9G,UAAI,CAAC,QAAQ,KAAK,eAAe,SAAS,QAAQ,YAAY;AAC5D;AAAA,MACF;AACA,YAAM,EAAE,WAAW,QAAQ,IAAI,SAAS;AACxC,UAAI,eAAe;AACjB,iBAAS,aAA0B;AACnC,kBAAU,aAA0B;AAAA,MACtC,OAAO;AACL,sBAAe,QAAsC,IAAI;AACzD,oBAAa,QAAsC,IAAI;AAAA,MACzD;AACA,oBAAc,KAAK;AAAA,IACrB,CAAC;AAED,UAAM,wBAAwB,KAAK,GAAG,sCAAsC,CAAC,EAAE,KAAK,MAAM;AACxF,UAAI,CAAC,QAAQ,KAAK,eAAe,SAAS,QAAQ,YAAY;AAC5D;AAAA,MACF;AACA,oBAAc,IAAI;AAClB,eAAS,QAAQ,YAAY,IAAI;AACjC,oBAAc,KAAK;AAAA,IACrB,CAAC;AAED,SAAK,gBAAgB,EAAE,SAAS,KAAK,CAAC;AAEtC,WAAO,MAAM;AACX,wBAAkB;AAClB,yBAAmB;AACnB,4BAAsB;AAAA,IACxB;AAAA,EACF,GAAG,CAAC,MAAM,iBAAiB,MAAM,UAAU,CAAC;AAE5C,QAAM,UAAU,YAAY,MAAM,gBAAgB,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC;AAEvF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/esm/hooks/useChannelConnections.d.ts

@@ -0,0 +1,24 @@
+import { ListChannelConnectionsArgs, ChannelConnectionResponse, NovuError } from '@novu/js';
+
+type UseChannelConnectionsProps = ListChannelConnectionsArgs & {
+    onSuccess?: (data: ChannelConnectionResponse[]) => void;
+    onError?: (error: NovuError) => void;
+};
+type UseChannelConnectionsResult = {
+    connections: ChannelConnectionResponse[];
+    error?: NovuError;
+    isLoading: boolean;
+    isFetching: boolean;
+    refetch: () => Promise<void>;
+};
+/**
+ * List channel connections for the current subscriber. Use this to discover an active
+ * connection identifier after a chat OAuth flow so it can be passed to `LinkUser`.
+ *
+ * @example
+ * const { connections } = useChannelConnections({ integrationIdentifier: 'my-chat-integration' });
+ * const connectionIdentifier = connections[0]?.identifier;
+ */
+declare const useChannelConnections: (props?: UseChannelConnectionsProps) => UseChannelConnectionsResult;
+
+export { type UseChannelConnectionsProps, type UseChannelConnectionsResult, useChannelConnections };

package/dist/esm/hooks/useChannelConnections.js

@@ -0,0 +1,60 @@
+// src/hooks/useChannelConnections.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useNovu } from "./NovuProvider.js";
+var useChannelConnections = (props = {}) => {
+  const novu = useNovu();
+  const propsRef = useRef(props);
+  propsRef.current = props;
+  const [connections, setConnections] = useState([]);
+  const [error, setError] = useState();
+  const [isLoading, setIsLoading] = useState(true);
+  const [isFetching, setIsFetching] = useState(false);
+  const fetchConnections = useCallback(
+    async (options) => {
+      const { onSuccess, onError, ...listArgs } = propsRef.current;
+      if (options?.refetch) {
+        setError(void 0);
+        setIsLoading(true);
+      }
+      setIsFetching(true);
+      try {
+        const response = await novu.channelConnections.list(listArgs);
+        if (response.error) {
+          setError(response.error);
+          onError?.(response.error);
+        } else if (response.data !== void 0) {
+          setConnections(response.data);
+          onSuccess?.(response.data);
+        }
+      } catch (err) {
+        setError(err);
+        onError?.(err);
+      } finally {
+        setIsLoading(false);
+        setIsFetching(false);
+      }
+    },
+    [novu]
+  );
+  useEffect(() => {
+    const cleanupDeleteResolved = novu.on("channel-connection.delete.resolved", () => {
+      void fetchConnections({ refetch: true });
+    });
+    void fetchConnections({ refetch: true });
+    return () => {
+      cleanupDeleteResolved();
+    };
+  }, [novu, fetchConnections]);
+  const refetch = useCallback(() => fetchConnections({ refetch: true }), [fetchConnections]);
+  return {
+    connections,
+    error,
+    isLoading,
+    isFetching,
+    refetch
+  };
+};
+export {
+  useChannelConnections
+};
+//# sourceMappingURL=useChannelConnections.js.map

package/dist/esm/hooks/useChannelConnections.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hooks/useChannelConnections.ts"],"sourcesContent":["import type { ChannelConnectionResponse, ListChannelConnectionsArgs, NovuError } from '@novu/js';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { useNovu } from './NovuProvider';\n\nexport type UseChannelConnectionsProps = ListChannelConnectionsArgs & {\n  onSuccess?: (data: ChannelConnectionResponse[]) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseChannelConnectionsResult = {\n  connections: ChannelConnectionResponse[];\n  error?: NovuError;\n  isLoading: boolean;\n  isFetching: boolean;\n  refetch: () => Promise<void>;\n};\n\n/**\n * List channel connections for the current subscriber. Use this to discover an active\n * connection identifier after a chat OAuth flow so it can be passed to `LinkUser`.\n *\n * @example\n * const { connections } = useChannelConnections({ integrationIdentifier: 'my-chat-integration' });\n * const connectionIdentifier = connections[0]?.identifier;\n */\nexport const useChannelConnections = (props: UseChannelConnectionsProps = {}): UseChannelConnectionsResult => {\n  const novu = useNovu();\n  const propsRef = useRef<UseChannelConnectionsProps>(props);\n  propsRef.current = props;\n\n  const [connections, setConnections] = useState<ChannelConnectionResponse[]>([]);\n  const [error, setError] = useState<NovuError>();\n  const [isLoading, setIsLoading] = useState(true);\n  const [isFetching, setIsFetching] = useState(false);\n\n  const fetchConnections = useCallback(\n    async (options?: { refetch: boolean }) => {\n      const { onSuccess, onError, ...listArgs } = propsRef.current;\n\n      if (options?.refetch) {\n        setError(undefined);\n        setIsLoading(true);\n      }\n\n      setIsFetching(true);\n\n      try {\n        const response = await novu.channelConnections.list(listArgs);\n\n        if (response.error) {\n          setError(response.error as NovuError);\n          onError?.(response.error as NovuError);\n        } else if (response.data !== undefined) {\n          setConnections(response.data);\n          onSuccess?.(response.data);\n        }\n      } catch (err) {\n        setError(err as NovuError);\n        onError?.(err as NovuError);\n      } finally {\n        setIsLoading(false);\n        setIsFetching(false);\n      }\n    },\n    [novu]\n  );\n\n  useEffect(() => {\n    const cleanupDeleteResolved = novu.on('channel-connection.delete.resolved', () => {\n      void fetchConnections({ refetch: true });\n    });\n\n    void fetchConnections({ refetch: true });\n\n    return () => {\n      cleanupDeleteResolved();\n    };\n  }, [novu, fetchConnections]);\n\n  const refetch = useCallback(() => fetchConnections({ refetch: true }), [fetchConnections]);\n\n  return {\n    connections,\n    error,\n    isLoading,\n    isFetching,\n    refetch,\n  };\n};\n"],"mappings":";AACA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AACzD,SAAS,eAAe;AAuBjB,IAAM,wBAAwB,CAAC,QAAoC,CAAC,MAAmC;AAC5G,QAAM,OAAO,QAAQ;AACrB,QAAM,WAAW,OAAmC,KAAK;AACzD,WAAS,UAAU;AAEnB,QAAM,CAAC,aAAa,cAAc,IAAI,SAAsC,CAAC,CAAC;AAC9E,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAoB;AAC9C,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,QAAM,mBAAmB;AAAA,IACvB,OAAO,YAAmC;AACxC,YAAM,EAAE,WAAW,SAAS,GAAG,SAAS,IAAI,SAAS;AAErD,UAAI,SAAS,SAAS;AACpB,iBAAS,MAAS;AAClB,qBAAa,IAAI;AAAA,MACnB;AAEA,oBAAc,IAAI;AAElB,UAAI;AACF,cAAM,WAAW,MAAM,KAAK,mBAAmB,KAAK,QAAQ;AAE5D,YAAI,SAAS,OAAO;AAClB,mBAAS,SAAS,KAAkB;AACpC,oBAAU,SAAS,KAAkB;AAAA,QACvC,WAAW,SAAS,SAAS,QAAW;AACtC,yBAAe,SAAS,IAAI;AAC5B,sBAAY,SAAS,IAAI;AAAA,QAC3B;AAAA,MACF,SAAS,KAAK;AACZ,iBAAS,GAAgB;AACzB,kBAAU,GAAgB;AAAA,MAC5B,UAAE;AACA,qBAAa,KAAK;AAClB,sBAAc,KAAK;AAAA,MACrB;AAAA,IACF;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAEA,YAAU,MAAM;AACd,UAAM,wBAAwB,KAAK,GAAG,sCAAsC,MAAM;AAChF,WAAK,iBAAiB,EAAE,SAAS,KAAK,CAAC;AAAA,IACzC,CAAC;AAED,SAAK,iBAAiB,EAAE,SAAS,KAAK,CAAC;AAEvC,WAAO,MAAM;AACX,4BAAsB;AAAA,IACxB;AAAA,EACF,GAAG,CAAC,MAAM,gBAAgB,CAAC;AAE3B,QAAM,UAAU,YAAY,MAAM,iBAAiB,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;AAEzF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/esm/hooks/useChannelEndpoint.d.ts

@@ -0,0 +1,20 @@
+import { ChannelEndpointResponse, NovuError } from '@novu/js';
+
+type UseChannelEndpointProps = {
+    identifier: string;
+    onSuccess?: (data: ChannelEndpointResponse | null) => void;
+    onError?: (error: NovuError) => void;
+};
+type UseChannelEndpointResult = {
+    endpoint?: ChannelEndpointResponse | null;
+    error?: NovuError;
+    isLoading: boolean;
+    isFetching: boolean;
+    refetch: () => Promise<void>;
+};
+/**
+ * Get a channel endpoint by identifier.
+ */
+declare const useChannelEndpoint: (props: UseChannelEndpointProps) => UseChannelEndpointResult;
+
+export { type UseChannelEndpointProps, type UseChannelEndpointResult, useChannelEndpoint };

package/dist/esm/hooks/useChannelEndpoint.js

@@ -0,0 +1,83 @@
+// src/hooks/useChannelEndpoint.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useNovu } from "./NovuProvider.js";
+var useChannelEndpoint = (props) => {
+  const novu = useNovu();
+  const propsRef = useRef(props);
+  propsRef.current = props;
+  const [endpoint, setEndpoint] = useState();
+  const [error, setError] = useState();
+  const [isLoading, setIsLoading] = useState(true);
+  const [isFetching, setIsFetching] = useState(false);
+  const fetchEndpoint = useCallback(
+    async (options) => {
+      const { identifier, onSuccess, onError } = propsRef.current;
+      if (options?.refetch) {
+        setError(void 0);
+        setIsLoading(true);
+      }
+      setIsFetching(true);
+      const response = await novu.channelEndpoints.get({ identifier });
+      if (response.error) {
+        setError(response.error);
+        onError?.(response.error);
+      } else if (response.data !== void 0) {
+        onSuccess?.(response.data);
+        setEndpoint(response.data);
+      }
+      setIsLoading(false);
+      setIsFetching(false);
+    },
+    [novu]
+  );
+  useEffect(() => {
+    const cleanupGetPending = novu.on("channel-endpoint.get.pending", () => {
+      setIsFetching(true);
+    });
+    const cleanupGetResolved = novu.on("channel-endpoint.get.resolved", ({ data, error: resolvedError }) => {
+      const { onSuccess, onError } = propsRef.current;
+      if (resolvedError) {
+        setError(resolvedError);
+        onError?.(resolvedError);
+      } else {
+        setEndpoint(data ?? null);
+        onSuccess?.(data ?? null);
+      }
+      setIsFetching(false);
+    });
+    const cleanupCreateResolved = novu.on("channel-endpoint.create.resolved", ({ data }) => {
+      if (data) {
+        setEndpoint(data);
+        propsRef.current.onSuccess?.(data);
+      }
+      setIsFetching(false);
+    });
+    const cleanupDeleteResolved = novu.on("channel-endpoint.delete.resolved", ({ args }) => {
+      if (!args || args.identifier !== propsRef.current.identifier) {
+        return;
+      }
+      setEndpoint(null);
+      propsRef.current.onSuccess?.(null);
+      setIsFetching(false);
+    });
+    void fetchEndpoint({ refetch: true });
+    return () => {
+      cleanupGetPending();
+      cleanupGetResolved();
+      cleanupCreateResolved();
+      cleanupDeleteResolved();
+    };
+  }, [novu, fetchEndpoint, props.identifier]);
+  const refetch = useCallback(() => fetchEndpoint({ refetch: true }), [fetchEndpoint]);
+  return {
+    endpoint,
+    error,
+    isLoading,
+    isFetching,
+    refetch
+  };
+};
+export {
+  useChannelEndpoint
+};
+//# sourceMappingURL=useChannelEndpoint.js.map

package/dist/esm/hooks/useChannelEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hooks/useChannelEndpoint.ts"],"sourcesContent":["import type { ChannelEndpointResponse, NovuError } from '@novu/js';\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport { useNovu } from './NovuProvider';\n\nexport type UseChannelEndpointProps = {\n  identifier: string;\n  onSuccess?: (data: ChannelEndpointResponse | null) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseChannelEndpointResult = {\n  endpoint?: ChannelEndpointResponse | null;\n  error?: NovuError;\n  isLoading: boolean;\n  isFetching: boolean;\n  refetch: () => Promise<void>;\n};\n\n/**\n * Get a channel endpoint by identifier.\n */\nexport const useChannelEndpoint = (props: UseChannelEndpointProps): UseChannelEndpointResult => {\n  const novu = useNovu();\n  const propsRef = useRef<UseChannelEndpointProps>(props);\n  propsRef.current = props;\n\n  const [endpoint, setEndpoint] = useState<ChannelEndpointResponse | null>();\n  const [error, setError] = useState<NovuError>();\n  const [isLoading, setIsLoading] = useState(true);\n  const [isFetching, setIsFetching] = useState(false);\n\n  const fetchEndpoint = useCallback(\n    async (options?: { refetch: boolean }) => {\n      const { identifier, onSuccess, onError } = propsRef.current;\n      if (options?.refetch) {\n        setError(undefined);\n        setIsLoading(true);\n      }\n\n      setIsFetching(true);\n\n      const response = await novu.channelEndpoints.get({ identifier });\n\n      if (response.error) {\n        setError(response.error as NovuError);\n        onError?.(response.error as NovuError);\n      } else if (response.data !== undefined) {\n        onSuccess?.(response.data);\n        setEndpoint(response.data);\n      }\n      setIsLoading(false);\n      setIsFetching(false);\n    },\n    [novu]\n  );\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: props.identifier is needed to re-run the effect and initial fetch when the identifier changes\n  useEffect(() => {\n    const cleanupGetPending = novu.on('channel-endpoint.get.pending', () => {\n      setIsFetching(true);\n    });\n\n    const cleanupGetResolved = novu.on('channel-endpoint.get.resolved', ({ data, error: resolvedError }) => {\n      const { onSuccess, onError } = propsRef.current;\n      if (resolvedError) {\n        setError(resolvedError as NovuError);\n        onError?.(resolvedError as NovuError);\n      } else {\n        setEndpoint((data as ChannelEndpointResponse) ?? null);\n        onSuccess?.((data as ChannelEndpointResponse) ?? null);\n      }\n      setIsFetching(false);\n    });\n\n    const cleanupCreateResolved = novu.on('channel-endpoint.create.resolved', ({ data }) => {\n      if (data) {\n        setEndpoint(data as ChannelEndpointResponse);\n        propsRef.current.onSuccess?.(data as ChannelEndpointResponse);\n      }\n      setIsFetching(false);\n    });\n\n    const cleanupDeleteResolved = novu.on('channel-endpoint.delete.resolved', ({ args }) => {\n      if (!args || args.identifier !== propsRef.current.identifier) {\n        return;\n      }\n      setEndpoint(null);\n      propsRef.current.onSuccess?.(null);\n      setIsFetching(false);\n    });\n\n    void fetchEndpoint({ refetch: true });\n\n    return () => {\n      cleanupGetPending();\n      cleanupGetResolved();\n      cleanupCreateResolved();\n      cleanupDeleteResolved();\n    };\n  }, [novu, fetchEndpoint, props.identifier]);\n\n  const refetch = useCallback(() => fetchEndpoint({ refetch: true }), [fetchEndpoint]);\n\n  return {\n    endpoint,\n    error,\n    isLoading,\n    isFetching,\n    refetch,\n  };\n};\n"],"mappings":";AACA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AACzD,SAAS,eAAe;AAmBjB,IAAM,qBAAqB,CAAC,UAA6D;AAC9F,QAAM,OAAO,QAAQ;AACrB,QAAM,WAAW,OAAgC,KAAK;AACtD,WAAS,UAAU;AAEnB,QAAM,CAAC,UAAU,WAAW,IAAI,SAAyC;AACzE,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAoB;AAC9C,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,QAAM,gBAAgB;AAAA,IACpB,OAAO,YAAmC;AACxC,YAAM,EAAE,YAAY,WAAW,QAAQ,IAAI,SAAS;AACpD,UAAI,SAAS,SAAS;AACpB,iBAAS,MAAS;AAClB,qBAAa,IAAI;AAAA,MACnB;AAEA,oBAAc,IAAI;AAElB,YAAM,WAAW,MAAM,KAAK,iBAAiB,IAAI,EAAE,WAAW,CAAC;AAE/D,UAAI,SAAS,OAAO;AAClB,iBAAS,SAAS,KAAkB;AACpC,kBAAU,SAAS,KAAkB;AAAA,MACvC,WAAW,SAAS,SAAS,QAAW;AACtC,oBAAY,SAAS,IAAI;AACzB,oBAAY,SAAS,IAAI;AAAA,MAC3B;AACA,mBAAa,KAAK;AAClB,oBAAc,KAAK;AAAA,IACrB;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAGA,YAAU,MAAM;AACd,UAAM,oBAAoB,KAAK,GAAG,gCAAgC,MAAM;AACtE,oBAAc,IAAI;AAAA,IACpB,CAAC;AAED,UAAM,qBAAqB,KAAK,GAAG,iCAAiC,CAAC,EAAE,MAAM,OAAO,cAAc,MAAM;AACtG,YAAM,EAAE,WAAW,QAAQ,IAAI,SAAS;AACxC,UAAI,eAAe;AACjB,iBAAS,aAA0B;AACnC,kBAAU,aAA0B;AAAA,MACtC,OAAO;AACL,oBAAa,QAAoC,IAAI;AACrD,oBAAa,QAAoC,IAAI;AAAA,MACvD;AACA,oBAAc,KAAK;AAAA,IACrB,CAAC;AAED,UAAM,wBAAwB,KAAK,GAAG,oCAAoC,CAAC,EAAE,KAAK,MAAM;AACtF,UAAI,MAAM;AACR,oBAAY,IAA+B;AAC3C,iBAAS,QAAQ,YAAY,IAA+B;AAAA,MAC9D;AACA,oBAAc,KAAK;AAAA,IACrB,CAAC;AAED,UAAM,wBAAwB,KAAK,GAAG,oCAAoC,CAAC,EAAE,KAAK,MAAM;AACtF,UAAI,CAAC,QAAQ,KAAK,eAAe,SAAS,QAAQ,YAAY;AAC5D;AAAA,MACF;AACA,kBAAY,IAAI;AAChB,eAAS,QAAQ,YAAY,IAAI;AACjC,oBAAc,KAAK;AAAA,IACrB,CAAC;AAED,SAAK,cAAc,EAAE,SAAS,KAAK,CAAC;AAEpC,WAAO,MAAM;AACX,wBAAkB;AAClB,yBAAmB;AACnB,4BAAsB;AACtB,4BAAsB;AAAA,IACxB;AAAA,EACF,GAAG,CAAC,MAAM,eAAe,MAAM,UAAU,CAAC;AAE1C,QAAM,UAAU,YAAY,MAAM,cAAc,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;AAEnF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/esm/hooks/useCounts.d.ts

@@ -23,10 +23,28 @@ type Count = {
  * const { counts } = useCounts({
  *   filters: [{ seen: true, read: false }]
  * });
+ *
+ * // Opt out of the built-in realtime count updates and drive them yourself
+ * const { counts, refetch } = useCounts({
+ *   filters: [{ read: false }],
+ *   realtime: false,
+ * });
  * ```
  */
 type UseCountsProps = {
     filters: NotificationFilter[];
+    /**
+     * When `false`, disables the WebSocket subscriptions that auto-resync
+     * counts on `notifications.notification_received` and
+     * `notifications.unread_count_changed`. The filter-driven fetch and
+     * `refetch()` keep working. Use alongside
+     * `useNotifications({ realtime: false })` when you drive live updates
+     * yourself.
+     *
+     * When set, this prop takes precedence over the `realtime` config on
+     * `<NovuProvider />`. When omitted, the provider value (default `true`) is used.
+     */
+    realtime?: boolean;
     onSuccess?: (data: Count[]) => void;
     onError?: (error: NovuError) => void;
 };

package/dist/esm/hooks/useCounts.js

@@ -3,10 +3,12 @@ import { areTagsEqual, isSameFilter } from "@novu/js";
 import { useEffect, useState } from "react";
 import { useDataRef } from "./internal/useDataRef.js";
 import { useWebSocketEvent } from "./internal/useWebsocketEvent.js";
-import { useNovu } from "./NovuProvider.js";
+import { useNovu, useRealtime } from "./NovuProvider.js";
 var useCounts = (props) => {
-  const { filters, onSuccess, onError } = props;
+  const { filters, realtime: propsRealtime, onSuccess, onError } = props;
   const { notifications } = useNovu();
+  const providerRealtime = useRealtime();
+  const realtime = propsRealtime ?? providerRealtime;
   const filtersRef = useDataRef(filters);
   const [error, setError] = useState();
   const [counts, setCounts] = useState();
@@ -57,12 +59,14 @@ var useCounts = (props) => {
   };
   useWebSocketEvent({
     event: "notifications.notification_received",
+    enabled: realtime,
     eventHandler: (data) => {
       sync(data.result);
     }
   });
   useWebSocketEvent({
     event: "notifications.unread_count_changed",
+    enabled: realtime,
     eventHandler: () => {
       sync();
     }

package/dist/esm/hooks/useCounts.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/useCounts.ts"],"sourcesContent":["import { areTagsEqual, isSameFilter, Notification, NotificationFilter, NovuError } from '@novu/js';\nimport { useEffect, useState } from 'react';\nimport { useDataRef } from './internal/useDataRef';\nimport { useWebSocketEvent } from './internal/useWebsocketEvent';\nimport { useNovu } from './NovuProvider';\n\ntype Count = {\n  count: number;\n  filter: NotificationFilter;\n};\n\n/**\n * Props for the useCounts hook.\n *\n * @example\n * ```tsx\n * // Count unread notifications\n * const { counts } = useCounts({\n *   filters: [{ read: false }]\n * });\n *\n * // Count unseen notifications with specific tags\n * const { counts } = useCounts({\n *   filters: [{ seen: false, tags: ['important'] }]\n * });\n *\n * // Count seen but unread notifications\n * const { counts } = useCounts({\n *   filters: [{ seen: true, read: false }]\n * });\n * ```\n */\nexport type UseCountsProps = {\n  filters: NotificationFilter[];\n  onSuccess?: (data: Count[]) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseCountsResult = {\n  counts?: Count[];\n  error?: NovuError;\n  isLoading: boolean; // initial loading\n  isFetching: boolean; // the request is in flight\n  refetch: () => Promise<void>;\n};\n\nexport const useCounts = (props: UseCountsProps): UseCountsResult => {\n  const { filters, onSuccess, onError } = props;\n  const { notifications } = useNovu();\n  const filtersRef = useDataRef<NotificationFilter[]>(filters);\n  const [error, setError] = useState<NovuError>();\n  const [counts, setCounts] = useState<Count[]>();\n  const [isLoading, setIsLoading] = useState(true);\n  const [isFetching, setIsFetching] = useState(false);\n\n  const sync = async (notification?: Notification, overrideFilters?: NotificationFilter[]) => {\n    const currentFilters = overrideFilters || filtersRef.current;\n    const existingCounts = currentFilters.map((filter) => ({ count: 0, filter }));\n    let countFiltersToFetch: NotificationFilter[] = [];\n    if (notification) {\n      for (let i = 0; i < existingCounts.length; i++) {\n        const filter = currentFilters[i];\n        const isSeverityMatches =\n          !filter.severity ||\n          (Array.isArray(filter.severity) && filter.severity.length === 0) ||\n          (Array.isArray(filter.severity) && filter.severity.includes(notification.severity)) ||\n          (!Array.isArray(filter.severity) && filter.severity === notification.severity);\n\n        if (areTagsEqual(filter.tags, notification.tags) && isSeverityMatches) {\n          countFiltersToFetch.push(filter);\n        }\n      }\n    } else {\n      countFiltersToFetch = currentFilters;\n    }\n\n    if (countFiltersToFetch.length === 0) {\n      return;\n    }\n\n    setIsFetching(true);\n    const countsRes = await notifications.count({ filters: countFiltersToFetch });\n    setIsFetching(false);\n    setIsLoading(false);\n    if (countsRes.error) {\n      setError(countsRes.error);\n      onError?.(countsRes.error);\n\n      return;\n    }\n    const data = countsRes.data!;\n    onSuccess?.(data.counts);\n\n    setCounts((oldCounts) => {\n      const newCounts: Count[] = [];\n      const countsReceived = data.counts;\n\n      for (let i = 0; i < existingCounts.length; i++) {\n        const existingFilter = existingCounts[i].filter;\n        const countReceived = countsReceived.find((c) => isSameFilter(c.filter, existingFilter));\n        const count = countReceived || oldCounts?.[i];\n        if (count) {\n          newCounts.push(count);\n        }\n      }\n\n      return newCounts;\n    });\n  };\n\n  useWebSocketEvent({\n    event: 'notifications.notification_received',\n    eventHandler: (data) => {\n      sync(data.result);\n    },\n  });\n\n  useWebSocketEvent({\n    event: 'notifications.unread_count_changed',\n    eventHandler: () => {\n      sync();\n    },\n  });\n\n  useEffect(() => {\n    setError(undefined);\n    setIsLoading(true);\n    setIsFetching(false);\n    sync(undefined, filters);\n  }, [JSON.stringify(filters)]);\n\n  const refetch = async () => {\n    await sync();\n  };\n\n  return { counts, error, refetch, isLoading, isFetching };\n};\n"],"mappings":";AAAA,SAAS,cAAc,oBAAiE;AACxF,SAAS,WAAW,gBAAgB;AACpC,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,eAAe;AA0CjB,IAAM,YAAY,CAAC,UAA2C;AACnE,QAAM,EAAE,SAAS,WAAW,QAAQ,IAAI;AACxC,QAAM,EAAE,cAAc,IAAI,QAAQ;AAClC,QAAM,aAAa,WAAiC,OAAO;AAC3D,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAoB;AAC9C,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkB;AAC9C,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,QAAM,OAAO,OAAO,cAA6B,oBAA2C;AAC1F,UAAM,iBAAiB,mBAAmB,WAAW;AACrD,UAAM,iBAAiB,eAAe,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,EAAE;AAC5E,QAAI,sBAA4C,CAAC;AACjD,QAAI,cAAc;AAChB,eAAS,IAAI,GAAG,IAAI,eAAe,QAAQ,KAAK;AAC9C,cAAM,SAAS,eAAe,CAAC;AAC/B,cAAM,oBACJ,CAAC,OAAO,YACP,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,WAAW,KAC7D,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,SAAS,aAAa,QAAQ,KAChF,CAAC,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,aAAa,aAAa;AAEvE,YAAI,aAAa,OAAO,MAAM,aAAa,IAAI,KAAK,mBAAmB;AACrE,8BAAoB,KAAK,MAAM;AAAA,QACjC;AAAA,MACF;AAAA,IACF,OAAO;AACL,4BAAsB;AAAA,IACxB;AAEA,QAAI,oBAAoB,WAAW,GAAG;AACpC;AAAA,IACF;AAEA,kBAAc,IAAI;AAClB,UAAM,YAAY,MAAM,cAAc,MAAM,EAAE,SAAS,oBAAoB,CAAC;AAC5E,kBAAc,KAAK;AACnB,iBAAa,KAAK;AAClB,QAAI,UAAU,OAAO;AACnB,eAAS,UAAU,KAAK;AACxB,gBAAU,UAAU,KAAK;AAEzB;AAAA,IACF;AACA,UAAM,OAAO,UAAU;AACvB,gBAAY,KAAK,MAAM;AAEvB,cAAU,CAAC,cAAc;AACvB,YAAM,YAAqB,CAAC;AAC5B,YAAM,iBAAiB,KAAK;AAE5B,eAAS,IAAI,GAAG,IAAI,eAAe,QAAQ,KAAK;AAC9C,cAAM,iBAAiB,eAAe,CAAC,EAAE;AACzC,cAAM,gBAAgB,eAAe,KAAK,CAAC,MAAM,aAAa,EAAE,QAAQ,cAAc,CAAC;AACvF,cAAM,QAAQ,iBAAiB,YAAY,CAAC;AAC5C,YAAI,OAAO;AACT,oBAAU,KAAK,KAAK;AAAA,QACtB;AAAA,MACF;AAEA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,oBAAkB;AAAA,IAChB,OAAO;AAAA,IACP,cAAc,CAAC,SAAS;AACtB,WAAK,KAAK,MAAM;AAAA,IAClB;AAAA,EACF,CAAC;AAED,oBAAkB;AAAA,IAChB,OAAO;AAAA,IACP,cAAc,MAAM;AAClB,WAAK;AAAA,IACP;AAAA,EACF,CAAC;AAED,YAAU,MAAM;AACd,aAAS,MAAS;AAClB,iBAAa,IAAI;AACjB,kBAAc,KAAK;AACnB,SAAK,QAAW,OAAO;AAAA,EACzB,GAAG,CAAC,KAAK,UAAU,OAAO,CAAC,CAAC;AAE5B,QAAM,UAAU,YAAY;AAC1B,UAAM,KAAK;AAAA,EACb;AAEA,SAAO,EAAE,QAAQ,OAAO,SAAS,WAAW,WAAW;AACzD;","names":[]}
+{"version":3,"sources":["../../../src/hooks/useCounts.ts"],"sourcesContent":["import { areTagsEqual, isSameFilter, Notification, NotificationFilter, NovuError } from '@novu/js';\nimport { useEffect, useState } from 'react';\nimport { useDataRef } from './internal/useDataRef';\nimport { useWebSocketEvent } from './internal/useWebsocketEvent';\nimport { useNovu, useRealtime } from './NovuProvider';\n\ntype Count = {\n  count: number;\n  filter: NotificationFilter;\n};\n\n/**\n * Props for the useCounts hook.\n *\n * @example\n * ```tsx\n * // Count unread notifications\n * const { counts } = useCounts({\n *   filters: [{ read: false }]\n * });\n *\n * // Count unseen notifications with specific tags\n * const { counts } = useCounts({\n *   filters: [{ seen: false, tags: ['important'] }]\n * });\n *\n * // Count seen but unread notifications\n * const { counts } = useCounts({\n *   filters: [{ seen: true, read: false }]\n * });\n *\n * // Opt out of the built-in realtime count updates and drive them yourself\n * const { counts, refetch } = useCounts({\n *   filters: [{ read: false }],\n *   realtime: false,\n * });\n * ```\n */\nexport type UseCountsProps = {\n  filters: NotificationFilter[];\n  /**\n   * When `false`, disables the WebSocket subscriptions that auto-resync\n   * counts on `notifications.notification_received` and\n   * `notifications.unread_count_changed`. The filter-driven fetch and\n   * `refetch()` keep working. Use alongside\n   * `useNotifications({ realtime: false })` when you drive live updates\n   * yourself.\n   *\n   * When set, this prop takes precedence over the `realtime` config on\n   * `<NovuProvider />`. When omitted, the provider value (default `true`) is used.\n   */\n  realtime?: boolean;\n  onSuccess?: (data: Count[]) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseCountsResult = {\n  counts?: Count[];\n  error?: NovuError;\n  isLoading: boolean; // initial loading\n  isFetching: boolean; // the request is in flight\n  refetch: () => Promise<void>;\n};\n\nexport const useCounts = (props: UseCountsProps): UseCountsResult => {\n  const { filters, realtime: propsRealtime, onSuccess, onError } = props;\n  const { notifications } = useNovu();\n  const providerRealtime = useRealtime();\n  const realtime = propsRealtime ?? providerRealtime;\n  const filtersRef = useDataRef<NotificationFilter[]>(filters);\n  const [error, setError] = useState<NovuError>();\n  const [counts, setCounts] = useState<Count[]>();\n  const [isLoading, setIsLoading] = useState(true);\n  const [isFetching, setIsFetching] = useState(false);\n\n  const sync = async (notification?: Notification, overrideFilters?: NotificationFilter[]) => {\n    const currentFilters = overrideFilters || filtersRef.current;\n    const existingCounts = currentFilters.map((filter) => ({ count: 0, filter }));\n    let countFiltersToFetch: NotificationFilter[] = [];\n    if (notification) {\n      for (let i = 0; i < existingCounts.length; i++) {\n        const filter = currentFilters[i];\n        const isSeverityMatches =\n          !filter.severity ||\n          (Array.isArray(filter.severity) && filter.severity.length === 0) ||\n          (Array.isArray(filter.severity) && filter.severity.includes(notification.severity)) ||\n          (!Array.isArray(filter.severity) && filter.severity === notification.severity);\n\n        if (areTagsEqual(filter.tags, notification.tags) && isSeverityMatches) {\n          countFiltersToFetch.push(filter);\n        }\n      }\n    } else {\n      countFiltersToFetch = currentFilters;\n    }\n\n    if (countFiltersToFetch.length === 0) {\n      return;\n    }\n\n    setIsFetching(true);\n    const countsRes = await notifications.count({ filters: countFiltersToFetch });\n    setIsFetching(false);\n    setIsLoading(false);\n    if (countsRes.error) {\n      setError(countsRes.error);\n      onError?.(countsRes.error);\n\n      return;\n    }\n    const data = countsRes.data!;\n    onSuccess?.(data.counts);\n\n    setCounts((oldCounts) => {\n      const newCounts: Count[] = [];\n      const countsReceived = data.counts;\n\n      for (let i = 0; i < existingCounts.length; i++) {\n        const existingFilter = existingCounts[i].filter;\n        const countReceived = countsReceived.find((c) => isSameFilter(c.filter, existingFilter));\n        const count = countReceived || oldCounts?.[i];\n        if (count) {\n          newCounts.push(count);\n        }\n      }\n\n      return newCounts;\n    });\n  };\n\n  useWebSocketEvent({\n    event: 'notifications.notification_received',\n    enabled: realtime,\n    eventHandler: (data) => {\n      sync(data.result);\n    },\n  });\n\n  useWebSocketEvent({\n    event: 'notifications.unread_count_changed',\n    enabled: realtime,\n    eventHandler: () => {\n      sync();\n    },\n  });\n\n  useEffect(() => {\n    setError(undefined);\n    setIsLoading(true);\n    setIsFetching(false);\n    sync(undefined, filters);\n  }, [JSON.stringify(filters)]);\n\n  const refetch = async () => {\n    await sync();\n  };\n\n  return { counts, error, refetch, isLoading, isFetching };\n};\n"],"mappings":";AAAA,SAAS,cAAc,oBAAiE;AACxF,SAAS,WAAW,gBAAgB;AACpC,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,SAAS,mBAAmB;AA4D9B,IAAM,YAAY,CAAC,UAA2C;AACnE,QAAM,EAAE,SAAS,UAAU,eAAe,WAAW,QAAQ,IAAI;AACjE,QAAM,EAAE,cAAc,IAAI,QAAQ;AAClC,QAAM,mBAAmB,YAAY;AACrC,QAAM,WAAW,iBAAiB;AAClC,QAAM,aAAa,WAAiC,OAAO;AAC3D,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAoB;AAC9C,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkB;AAC9C,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,QAAM,OAAO,OAAO,cAA6B,oBAA2C;AAC1F,UAAM,iBAAiB,mBAAmB,WAAW;AACrD,UAAM,iBAAiB,eAAe,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,EAAE;AAC5E,QAAI,sBAA4C,CAAC;AACjD,QAAI,cAAc;AAChB,eAAS,IAAI,GAAG,IAAI,eAAe,QAAQ,KAAK;AAC9C,cAAM,SAAS,eAAe,CAAC;AAC/B,cAAM,oBACJ,CAAC,OAAO,YACP,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,WAAW,KAC7D,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,SAAS,SAAS,aAAa,QAAQ,KAChF,CAAC,MAAM,QAAQ,OAAO,QAAQ,KAAK,OAAO,aAAa,aAAa;AAEvE,YAAI,aAAa,OAAO,MAAM,aAAa,IAAI,KAAK,mBAAmB;AACrE,8BAAoB,KAAK,MAAM;AAAA,QACjC;AAAA,MACF;AAAA,IACF,OAAO;AACL,4BAAsB;AAAA,IACxB;AAEA,QAAI,oBAAoB,WAAW,GAAG;AACpC;AAAA,IACF;AAEA,kBAAc,IAAI;AAClB,UAAM,YAAY,MAAM,cAAc,MAAM,EAAE,SAAS,oBAAoB,CAAC;AAC5E,kBAAc,KAAK;AACnB,iBAAa,KAAK;AAClB,QAAI,UAAU,OAAO;AACnB,eAAS,UAAU,KAAK;AACxB,gBAAU,UAAU,KAAK;AAEzB;AAAA,IACF;AACA,UAAM,OAAO,UAAU;AACvB,gBAAY,KAAK,MAAM;AAEvB,cAAU,CAAC,cAAc;AACvB,YAAM,YAAqB,CAAC;AAC5B,YAAM,iBAAiB,KAAK;AAE5B,eAAS,IAAI,GAAG,IAAI,eAAe,QAAQ,KAAK;AAC9C,cAAM,iBAAiB,eAAe,CAAC,EAAE;AACzC,cAAM,gBAAgB,eAAe,KAAK,CAAC,MAAM,aAAa,EAAE,QAAQ,cAAc,CAAC;AACvF,cAAM,QAAQ,iBAAiB,YAAY,CAAC;AAC5C,YAAI,OAAO;AACT,oBAAU,KAAK,KAAK;AAAA,QACtB;AAAA,MACF;AAEA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,oBAAkB;AAAA,IAChB,OAAO;AAAA,IACP,SAAS;AAAA,IACT,cAAc,CAAC,SAAS;AACtB,WAAK,KAAK,MAAM;AAAA,IAClB;AAAA,EACF,CAAC;AAED,oBAAkB;AAAA,IAChB,OAAO;AAAA,IACP,SAAS;AAAA,IACT,cAAc,MAAM;AAClB,WAAK;AAAA,IACP;AAAA,EACF,CAAC;AAED,YAAU,MAAM;AACd,aAAS,MAAS;AAClB,iBAAa,IAAI;AACjB,kBAAc,KAAK;AACnB,SAAK,QAAW,OAAO;AAAA,EACzB,GAAG,CAAC,KAAK,UAAU,OAAO,CAAC,CAAC;AAE5B,QAAM,UAAU,YAAY;AAC1B,UAAM,KAAK;AAAA,EACb;AAEA,SAAO,EAAE,QAAQ,OAAO,SAAS,WAAW,WAAW;AACzD;","names":[]}

package/dist/esm/hooks/useCreateChannelEndpoint.d.ts

@@ -0,0 +1,17 @@
+import { ChannelEndpointResponse, NovuError, CreateChannelEndpointArgs } from '@novu/js';
+
+type UseCreateChannelEndpointProps = {
+    onSuccess?: (data: ChannelEndpointResponse) => void;
+    onError?: (error: NovuError) => void;
+};
+type UseCreateChannelEndpointResult = {
+    isCreating: boolean;
+    error?: NovuError;
+    create: (args: CreateChannelEndpointArgs) => Promise<{
+        data?: ChannelEndpointResponse | undefined;
+        error?: NovuError | undefined;
+    }>;
+};
+declare const useCreateChannelEndpoint: (props?: UseCreateChannelEndpointProps) => UseCreateChannelEndpointResult;
+
+export { type UseCreateChannelEndpointProps, type UseCreateChannelEndpointResult, useCreateChannelEndpoint };