@novu/react 3.15.0 → 3.16.0

package/dist/cjs/hooks/useChannelEndpoint.cjs

@@ -0,0 +1,110 @@
+"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/useChannelEndpoint.ts
+var useChannelEndpoint_exports = {};
+__export(useChannelEndpoint_exports, {
+  useChannelEndpoint: () => useChannelEndpoint
+});
+module.exports = __toCommonJS(useChannelEndpoint_exports);
+var import_react = require("react");
+var import_NovuProvider = require("./NovuProvider.cjs");
+var useChannelEndpoint = (props) => {
+  const novu = (0, import_NovuProvider.useNovu)();
+  const propsRef = (0, import_react.useRef)(props);
+  propsRef.current = props;
+  const [endpoint, setEndpoint] = (0, import_react.useState)();
+  const [error, setError] = (0, import_react.useState)();
+  const [isLoading, setIsLoading] = (0, import_react.useState)(true);
+  const [isFetching, setIsFetching] = (0, import_react.useState)(false);
+  const fetchEndpoint = (0, import_react.useCallback)(
+    async (options) => {
+      const { identifier, onSuccess, onError } = propsRef.current;
+      if (options == null ? void 0 : options.refetch) {
+        setError(void 0);
+        setIsLoading(true);
+      }
+      setIsFetching(true);
+      const response = await novu.channelEndpoints.get({ identifier });
+      if (response.error) {
+        setError(response.error);
+        onError == null ? void 0 : onError(response.error);
+      } else if (response.data !== void 0) {
+        onSuccess == null ? void 0 : onSuccess(response.data);
+        setEndpoint(response.data);
+      }
+      setIsLoading(false);
+      setIsFetching(false);
+    },
+    [novu]
+  );
+  (0, import_react.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 == null ? void 0 : onError(resolvedError);
+      } else {
+        setEndpoint(data ?? null);
+        onSuccess == null ? void 0 : onSuccess(data ?? null);
+      }
+      setIsFetching(false);
+    });
+    const cleanupCreateResolved = novu.on("channel-endpoint.create.resolved", ({ data }) => {
+      var _a, _b;
+      if (data) {
+        setEndpoint(data);
+        (_b = (_a = propsRef.current).onSuccess) == null ? void 0 : _b.call(_a, data);
+      }
+      setIsFetching(false);
+    });
+    const cleanupDeleteResolved = novu.on("channel-endpoint.delete.resolved", ({ args }) => {
+      var _a, _b;
+      if (!args || args.identifier !== propsRef.current.identifier) {
+        return;
+      }
+      setEndpoint(null);
+      (_b = (_a = propsRef.current).onSuccess) == null ? void 0 : _b.call(_a, null);
+      setIsFetching(false);
+    });
+    void fetchEndpoint({ refetch: true });
+    return () => {
+      cleanupGetPending();
+      cleanupGetResolved();
+      cleanupCreateResolved();
+      cleanupDeleteResolved();
+    };
+  }, [novu, fetchEndpoint, props.identifier]);
+  const refetch = (0, import_react.useCallback)(() => fetchEndpoint({ refetch: true }), [fetchEndpoint]);
+  return {
+    endpoint,
+    error,
+    isLoading,
+    isFetching,
+    refetch
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useChannelEndpoint
+});
+//# sourceMappingURL=useChannelEndpoint.cjs.map

package/dist/cjs/hooks/useChannelEndpoint.cjs.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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAyD;AACzD,0BAAwB;AAmBjB,IAAM,qBAAqB,CAAC,UAA6D;AAC9F,QAAM,WAAO,6BAAQ;AACrB,QAAM,eAAW,qBAAgC,KAAK;AACtD,WAAS,UAAU;AAEnB,QAAM,CAAC,UAAU,WAAW,QAAI,uBAAyC;AACzE,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAoB;AAC9C,QAAM,CAAC,WAAW,YAAY,QAAI,uBAAS,IAAI;AAC/C,QAAM,CAAC,YAAY,aAAa,QAAI,uBAAS,KAAK;AAElD,QAAM,oBAAgB;AAAA,IACpB,OAAO,YAAmC;AACxC,YAAM,EAAE,YAAY,WAAW,QAAQ,IAAI,SAAS;AACpD,UAAI,mCAAS,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,2CAAU,SAAS;AAAA,MACrB,WAAW,SAAS,SAAS,QAAW;AACtC,+CAAY,SAAS;AACrB,oBAAY,SAAS,IAAI;AAAA,MAC3B;AACA,mBAAa,KAAK;AAClB,oBAAc,KAAK;AAAA,IACrB;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAGA,8BAAU,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,2CAAU;AAAA,MACZ,OAAO;AACL,oBAAa,QAAoC,IAAI;AACrD,+CAAa,QAAoC;AAAA,MACnD;AACA,oBAAc,KAAK;AAAA,IACrB,CAAC;AAED,UAAM,wBAAwB,KAAK,GAAG,oCAAoC,CAAC,EAAE,KAAK,MAAM;AA1E5F;AA2EM,UAAI,MAAM;AACR,oBAAY,IAA+B;AAC3C,6BAAS,SAAQ,cAAjB,4BAA6B;AAAA,MAC/B;AACA,oBAAc,KAAK;AAAA,IACrB,CAAC;AAED,UAAM,wBAAwB,KAAK,GAAG,oCAAoC,CAAC,EAAE,KAAK,MAAM;AAlF5F;AAmFM,UAAI,CAAC,QAAQ,KAAK,eAAe,SAAS,QAAQ,YAAY;AAC5D;AAAA,MACF;AACA,kBAAY,IAAI;AAChB,2BAAS,SAAQ,cAAjB,4BAA6B;AAC7B,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,cAAU,0BAAY,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/cjs/hooks/useChannelEndpoint.d.cts

@@ -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/cjs/hooks/useCounts.cjs

@@ -29,8 +29,10 @@ var import_useDataRef = require("./internal/useDataRef.cjs");
 var import_useWebsocketEvent = require("./internal/useWebsocketEvent.cjs");
 var import_NovuProvider = require("./NovuProvider.cjs");
 var useCounts = (props) => {
-  const { filters, onSuccess, onError } = props;
+  const { filters, realtime: propsRealtime, onSuccess, onError } = props;
   const { notifications } = (0, import_NovuProvider.useNovu)();
+  const providerRealtime = (0, import_NovuProvider.useRealtime)();
+  const realtime = propsRealtime ?? providerRealtime;
   const filtersRef = (0, import_useDataRef.useDataRef)(filters);
   const [error, setError] = (0, import_react.useState)();
   const [counts, setCounts] = (0, import_react.useState)();
@@ -81,12 +83,14 @@ var useCounts = (props) => {
   };
   (0, import_useWebsocketEvent.useWebSocketEvent)({
     event: "notifications.notification_received",
+    enabled: realtime,
     eventHandler: (data) => {
       sync(data.result);
     }
   });
   (0, import_useWebsocketEvent.useWebSocketEvent)({
     event: "notifications.unread_count_changed",
+    enabled: realtime,
     eventHandler: () => {
       sync();
     }

package/dist/cjs/hooks/useCounts.cjs.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;AAAA;AAAA;AAAA;AAAA;AAAA,gBAAwF;AACxF,mBAAoC;AACpC,wBAA2B;AAC3B,+BAAkC;AAClC,0BAAwB;AA0CjB,IAAM,YAAY,CAAC,UAA2C;AACnE,QAAM,EAAE,SAAS,WAAW,QAAQ,IAAI;AACxC,QAAM,EAAE,cAAc,QAAI,6BAAQ;AAClC,QAAM,iBAAa,8BAAiC,OAAO;AAC3D,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAoB;AAC9C,QAAM,CAAC,QAAQ,SAAS,QAAI,uBAAkB;AAC9C,QAAM,CAAC,WAAW,YAAY,QAAI,uBAAS,IAAI;AAC/C,QAAM,CAAC,YAAY,aAAa,QAAI,uBAAS,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,gBAAI,wBAAa,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,yCAAU,UAAU;AAEpB;AAAA,IACF;AACA,UAAM,OAAO,UAAU;AACvB,2CAAY,KAAK;AAEjB,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,UAAM,wBAAa,EAAE,QAAQ,cAAc,CAAC;AACvF,cAAM,QAAQ,kBAAiB,uCAAY;AAC3C,YAAI,OAAO;AACT,oBAAU,KAAK,KAAK;AAAA,QACtB;AAAA,MACF;AAEA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,kDAAkB;AAAA,IAChB,OAAO;AAAA,IACP,cAAc,CAAC,SAAS;AACtB,WAAK,KAAK,MAAM;AAAA,IAClB;AAAA,EACF,CAAC;AAED,kDAAkB;AAAA,IAChB,OAAO;AAAA,IACP,cAAc,MAAM;AAClB,WAAK;AAAA,IACP;AAAA,EACF,CAAC;AAED,8BAAU,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":"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","names":[]}

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

@@ -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/cjs/hooks/useCreateChannelEndpoint.cjs

@@ -0,0 +1,61 @@
+"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/useCreateChannelEndpoint.ts
+var useCreateChannelEndpoint_exports = {};
+__export(useCreateChannelEndpoint_exports, {
+  useCreateChannelEndpoint: () => useCreateChannelEndpoint
+});
+module.exports = __toCommonJS(useCreateChannelEndpoint_exports);
+var import_react = require("react");
+var import_NovuProvider = require("./NovuProvider.cjs");
+var useCreateChannelEndpoint = (props = {}) => {
+  const propsRef = (0, import_react.useRef)(props);
+  propsRef.current = props;
+  const novu = (0, import_NovuProvider.useNovu)();
+  const [isCreating, setIsCreating] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)();
+  const create = (0, import_react.useCallback)(
+    async (args) => {
+      const { onSuccess, onError } = propsRef.current;
+      setError(void 0);
+      setIsCreating(true);
+      const response = await novu.channelEndpoints.create(args);
+      setIsCreating(false);
+      if (response.error) {
+        setError(response.error);
+        onError == null ? void 0 : onError(response.error);
+      } else if (response.data) {
+        onSuccess == null ? void 0 : onSuccess(response.data);
+      }
+      return response;
+    },
+    [novu]
+  );
+  return {
+    create,
+    isCreating,
+    error
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCreateChannelEndpoint
+});
+//# sourceMappingURL=useCreateChannelEndpoint.cjs.map

package/dist/cjs/hooks/useCreateChannelEndpoint.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hooks/useCreateChannelEndpoint.ts"],"sourcesContent":["import type { ChannelEndpointResponse, CreateChannelEndpointArgs, NovuError } from '@novu/js';\nimport { useCallback, useRef, useState } from 'react';\nimport { useNovu } from './NovuProvider';\n\nexport type UseCreateChannelEndpointProps = {\n  onSuccess?: (data: ChannelEndpointResponse) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseCreateChannelEndpointResult = {\n  isCreating: boolean;\n  error?: NovuError;\n  create: (args: CreateChannelEndpointArgs) => Promise<{\n    data?: ChannelEndpointResponse | undefined;\n    error?: NovuError | undefined;\n  }>;\n};\n\nexport const useCreateChannelEndpoint = (props: UseCreateChannelEndpointProps = {}): UseCreateChannelEndpointResult => {\n  const propsRef = useRef<UseCreateChannelEndpointProps>(props);\n  propsRef.current = props;\n  const novu = useNovu();\n  const [isCreating, setIsCreating] = useState(false);\n  const [error, setError] = useState<NovuError>();\n\n  const create = useCallback(\n    async (args: CreateChannelEndpointArgs) => {\n      const { onSuccess, onError } = propsRef.current;\n      setError(undefined);\n      setIsCreating(true);\n\n      const response = await novu.channelEndpoints.create(args);\n\n      setIsCreating(false);\n\n      if (response.error) {\n        setError(response.error as NovuError);\n        onError?.(response.error as NovuError);\n      } else if (response.data) {\n        onSuccess?.(response.data as ChannelEndpointResponse);\n      }\n\n      return response as { data?: ChannelEndpointResponse; error?: NovuError };\n    },\n    [novu]\n  );\n\n  return {\n    create,\n    isCreating,\n    error,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAA8C;AAC9C,0BAAwB;AAgBjB,IAAM,2BAA2B,CAAC,QAAuC,CAAC,MAAsC;AACrH,QAAM,eAAW,qBAAsC,KAAK;AAC5D,WAAS,UAAU;AACnB,QAAM,WAAO,6BAAQ;AACrB,QAAM,CAAC,YAAY,aAAa,QAAI,uBAAS,KAAK;AAClD,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAoB;AAE9C,QAAM,aAAS;AAAA,IACb,OAAO,SAAoC;AACzC,YAAM,EAAE,WAAW,QAAQ,IAAI,SAAS;AACxC,eAAS,MAAS;AAClB,oBAAc,IAAI;AAElB,YAAM,WAAW,MAAM,KAAK,iBAAiB,OAAO,IAAI;AAExD,oBAAc,KAAK;AAEnB,UAAI,SAAS,OAAO;AAClB,iBAAS,SAAS,KAAkB;AACpC,2CAAU,SAAS;AAAA,MACrB,WAAW,SAAS,MAAM;AACxB,+CAAY,SAAS;AAAA,MACvB;AAEA,aAAO;AAAA,IACT;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

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

@@ -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 };

package/dist/cjs/hooks/useDeleteChannelEndpoint.cjs

@@ -0,0 +1,69 @@
+"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/useDeleteChannelEndpoint.ts
+var useDeleteChannelEndpoint_exports = {};
+__export(useDeleteChannelEndpoint_exports, {
+  useDeleteChannelEndpoint: () => useDeleteChannelEndpoint
+});
+module.exports = __toCommonJS(useDeleteChannelEndpoint_exports);
+var import_react = require("react");
+var import_NovuProvider = require("./NovuProvider.cjs");
+var useDeleteChannelEndpoint = (props = {}) => {
+  const propsRef = (0, import_react.useRef)(props);
+  propsRef.current = props;
+  const novu = (0, import_NovuProvider.useNovu)();
+  const [isDeleting, setIsDeleting] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)();
+  const remove = (0, import_react.useCallback)(
+    async (identifier) => {
+      var _a, _b, _c, _d, _e, _f;
+      setError(void 0);
+      setIsDeleting(true);
+      try {
+        const response = await novu.channelEndpoints.delete({ identifier });
+        if (response.error) {
+          setError(response.error);
+          (_b = (_a = propsRef.current).onError) == null ? void 0 : _b.call(_a, response.error);
+        } else {
+          (_d = (_c = propsRef.current).onSuccess) == null ? void 0 : _d.call(_c);
+        }
+        return response;
+      } catch (err) {
+        const novuError = err;
+        setError(novuError);
+        (_f = (_e = propsRef.current).onError) == null ? void 0 : _f.call(_e, novuError);
+        return { error: novuError };
+      } finally {
+        setIsDeleting(false);
+      }
+    },
+    [novu]
+  );
+  return {
+    remove,
+    isDeleting,
+    error
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDeleteChannelEndpoint
+});
+//# sourceMappingURL=useDeleteChannelEndpoint.cjs.map

package/dist/cjs/hooks/useDeleteChannelEndpoint.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hooks/useDeleteChannelEndpoint.ts"],"sourcesContent":["import type { NovuError } from '@novu/js';\nimport { useCallback, useRef, useState } from 'react';\nimport { useNovu } from './NovuProvider';\n\nexport type UseDeleteChannelEndpointProps = {\n  onSuccess?: () => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseDeleteChannelEndpointResult = {\n  isDeleting: boolean;\n  error?: NovuError;\n  remove: (identifier: string) => Promise<{\n    data?: undefined;\n    error?: NovuError | undefined;\n  }>;\n};\n\nexport const useDeleteChannelEndpoint = (props: UseDeleteChannelEndpointProps = {}): UseDeleteChannelEndpointResult => {\n  const propsRef = useRef<UseDeleteChannelEndpointProps>(props);\n  propsRef.current = props;\n  const novu = useNovu();\n  const [isDeleting, setIsDeleting] = useState(false);\n  const [error, setError] = useState<NovuError>();\n\n  const remove = useCallback(\n    async (identifier: string) => {\n      setError(undefined);\n      setIsDeleting(true);\n\n      try {\n        const response = await novu.channelEndpoints.delete({ identifier });\n\n        if (response.error) {\n          setError(response.error as NovuError);\n          propsRef.current.onError?.(response.error as NovuError);\n        } else {\n          propsRef.current.onSuccess?.();\n        }\n\n        return response as { data?: undefined; error?: NovuError };\n      } catch (err) {\n        const novuError = err as NovuError;\n        setError(novuError);\n        propsRef.current.onError?.(novuError);\n\n        return { error: novuError };\n      } finally {\n        setIsDeleting(false);\n      }\n    },\n    [novu]\n  );\n\n  return {\n    remove,\n    isDeleting,\n    error,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAA8C;AAC9C,0BAAwB;AAgBjB,IAAM,2BAA2B,CAAC,QAAuC,CAAC,MAAsC;AACrH,QAAM,eAAW,qBAAsC,KAAK;AAC5D,WAAS,UAAU;AACnB,QAAM,WAAO,6BAAQ;AACrB,QAAM,CAAC,YAAY,aAAa,QAAI,uBAAS,KAAK;AAClD,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAoB;AAE9C,QAAM,aAAS;AAAA,IACb,OAAO,eAAuB;AA1BlC;AA2BM,eAAS,MAAS;AAClB,oBAAc,IAAI;AAElB,UAAI;AACF,cAAM,WAAW,MAAM,KAAK,iBAAiB,OAAO,EAAE,WAAW,CAAC;AAElE,YAAI,SAAS,OAAO;AAClB,mBAAS,SAAS,KAAkB;AACpC,+BAAS,SAAQ,YAAjB,4BAA2B,SAAS;AAAA,QACtC,OAAO;AACL,+BAAS,SAAQ,cAAjB;AAAA,QACF;AAEA,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,cAAM,YAAY;AAClB,iBAAS,SAAS;AAClB,6BAAS,SAAQ,YAAjB,4BAA2B;AAE3B,eAAO,EAAE,OAAO,UAAU;AAAA,MAC5B,UAAE;AACA,sBAAc,KAAK;AAAA,MACrB;AAAA,IACF;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

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

@@ -0,0 +1,17 @@
+import { NovuError } from '@novu/js';
+
+type UseDeleteChannelEndpointProps = {
+    onSuccess?: () => void;
+    onError?: (error: NovuError) => void;
+};
+type UseDeleteChannelEndpointResult = {
+    isDeleting: boolean;
+    error?: NovuError;
+    remove: (identifier: string) => Promise<{
+        data?: undefined;
+        error?: NovuError | undefined;
+    }>;
+};
+declare const useDeleteChannelEndpoint: (props?: UseDeleteChannelEndpointProps) => UseDeleteChannelEndpointResult;
+
+export { type UseDeleteChannelEndpointProps, type UseDeleteChannelEndpointResult, useDeleteChannelEndpoint };

package/dist/cjs/hooks/useNotifications.cjs

@@ -40,6 +40,7 @@ var useNotifications = (props) => {
     createdGte,
     createdLte,
     limit = 10,
+    realtime: propsRealtime,
     onSuccess,
     onError
   } = props || {};
@@ -56,6 +57,8 @@ var useNotifications = (props) => {
     createdLte
   });
   const novu = (0, import_NovuProvider.useNovu)();
+  const providerRealtime = (0, import_NovuProvider.useRealtime)();
+  const realtime = propsRealtime ?? providerRealtime;
   const [data, setData] = (0, import_react.useState)();
   const [error, setError] = (0, import_react.useState)();
   const [isLoading, setIsLoading] = (0, import_react.useState)(true);
@@ -81,6 +84,7 @@ var useNotifications = (props) => {
   }, [filterRef, novu]);
   (0, import_useWebsocketEvent.useWebSocketEvent)({
     event: "notifications.notification_received",
+    enabled: realtime,
     eventHandler: ({ result: notification }) => {
       const currentFilter = filterRef.current;
       const matches = (0, import_js.checkNotificationMatchesFilter)(notification, currentFilter);

package/dist/cjs/hooks/useNotifications.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/useNotifications.ts"],"sourcesContent":["import { checkNotificationMatchesFilter, isSameFilter, Notification, NotificationFilter, NovuError } from '@novu/js';\nimport { useCallback, useEffect, useState } from 'react';\nimport { useDataRef } from './internal/useDataRef';\nimport { useWebSocketEvent } from './internal/useWebsocketEvent';\nimport { useNovu } from './NovuProvider';\n\n/**\n * Props for the useNotifications hook.\n *\n * @example\n * ```tsx\n * // Get unread notifications\n * const { notifications } = useNotifications({\n *   read: false\n * });\n *\n * // Get unseen notifications with specific tags\n * const { notifications } = useNotifications({\n *   seen: false,\n *   tags: ['important']\n * });\n *\n * // Get notifications (auto-updates in real time when new notifications arrive)\n * const { notifications } = useNotifications({\n *   read: false\n * });\n *\n * // Get notifications from a specific time period\n * const { notifications } = useNotifications({\n *   createdGte: 1704067200000,\n *   createdLte: 1735689599999\n * });\n * ```\n */\nexport type UseNotificationsProps = {\n  tags?: NotificationFilter['tags'];\n  data?: NotificationFilter['data'];\n  read?: NotificationFilter['read'];\n  archived?: NotificationFilter['archived'];\n  snoozed?: NotificationFilter['snoozed'];\n  seen?: NotificationFilter['seen'];\n  severity?: NotificationFilter['severity'];\n  createdGte?: NotificationFilter['createdGte'];\n  createdLte?: NotificationFilter['createdLte'];\n  limit?: number;\n  onSuccess?: (data: Notification[]) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseNotificationsResult = {\n  notifications?: Notification[];\n  error?: NovuError;\n  isLoading: boolean;\n  isFetching: boolean;\n  hasMore: boolean;\n  readAll: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  seenAll: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  archiveAll: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  archiveAllRead: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  refetch: () => Promise<void>;\n  fetchMore: () => Promise<void>;\n};\n\nexport const useNotifications = (props?: UseNotificationsProps): UseNotificationsResult => {\n  const {\n    tags,\n    data: dataFilter,\n    read,\n    archived = false,\n    snoozed = false,\n    seen,\n    severity,\n    createdGte,\n    createdLte,\n    limit = 10,\n    onSuccess,\n    onError,\n  } = props || {};\n  const limitRef = useDataRef<number | undefined>(limit);\n  const filterRef = useDataRef<NotificationFilter>({\n    tags,\n    data: dataFilter,\n    read,\n    archived,\n    snoozed,\n    seen,\n    severity,\n    createdGte,\n    createdLte,\n  });\n  const novu = useNovu();\n  const [data, setData] = useState<Array<Notification>>();\n  const [error, setError] = useState<NovuError>();\n  const [isLoading, setIsLoading] = useState(true);\n  const [isFetching, setIsFetching] = useState(false);\n  const [hasMore, setHasMore] = useState(false);\n  const length = data?.length;\n  const after = length ? data[length - 1].id : undefined;\n  const afterRef = useDataRef<string | undefined>(after);\n\n  useEffect(() => {\n    const listener = ({\n      data,\n    }: {\n      data: { notifications: Notification[]; hasMore: boolean; filter: NotificationFilter };\n    }) => {\n      if (!data || !isSameFilter(filterRef.current, data.filter)) {\n        return;\n      }\n\n      // the event is called with the list of all notifications cached matching the current filter\n      setData(data.notifications);\n      setHasMore(data.hasMore);\n    };\n\n    const cleanup = novu.on('notifications.list.updated', listener);\n\n    return () => {\n      cleanup();\n    };\n  }, [filterRef, novu]);\n\n  useWebSocketEvent({\n    event: 'notifications.notification_received',\n    eventHandler: ({ result: notification }) => {\n      const currentFilter = filterRef.current;\n      const matches = checkNotificationMatchesFilter(notification, currentFilter);\n      if (matches) {\n        // the limit and after props are used to create a cache key\n        // the first batch of notifications in the cache doesn't include the after prop and we want to push to the first batch\n        const cacheKey = { ...currentFilter, limit: limitRef.current };\n        novu.notifications.cache.unshift(cacheKey, notification);\n      }\n    },\n  });\n\n  const fetchNotifications = useCallback(\n    async (options?: { refetch: boolean }) => {\n      if (options?.refetch) {\n        setError(undefined);\n        setIsLoading(true);\n        setIsFetching(false);\n      }\n      setIsFetching(true);\n\n      const response = await novu.notifications.list({\n        ...filterRef.current,\n        limit,\n        after: options?.refetch ? undefined : afterRef.current,\n      });\n\n      if (response.error) {\n        setError(response.error);\n        onError?.(response.error);\n        setIsLoading(false);\n        setIsFetching(false);\n      } else if (response.data) {\n        const responseData = response.data;\n        onSuccess?.(responseData.notifications);\n        setData(responseData.notifications);\n        setHasMore(responseData.hasMore);\n        setIsLoading(false);\n        setIsFetching(false);\n      }\n    },\n    [novu, filterRef, afterRef, limit, onError, onSuccess]\n  );\n\n  useEffect(() => {\n    novu.notifications.clearCache({ filter: filterRef.current });\n    fetchNotifications({ refetch: true });\n  }, [filterRef, novu, JSON.stringify(filterRef.current), fetchNotifications]);\n\n  const refetch = useCallback(() => {\n    novu.notifications.clearCache({ filter: filterRef.current });\n    return fetchNotifications({ refetch: true });\n  }, [filterRef, novu, fetchNotifications]);\n\n  const fetchMore = useCallback(async () => {\n    if (!hasMore || isFetching) return;\n\n    return fetchNotifications();\n  }, [hasMore, isFetching, fetchNotifications]);\n\n  const readAll = useCallback(async () => {\n    return await novu.notifications.readAll({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  const seenAll = useCallback(async () => {\n    return await novu.notifications.seenAll({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  const archiveAll = useCallback(async () => {\n    return await novu.notifications.archiveAll({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  const archiveAllRead = useCallback(async () => {\n    return await novu.notifications.archiveAllRead({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  return {\n    readAll,\n    seenAll,\n    archiveAll,\n    archiveAllRead,\n    notifications: data,\n    error,\n    isLoading,\n    isFetching,\n    refetch,\n    fetchMore,\n    hasMore,\n  };\n};\n"],"mappings":"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","names":["data"]}
+{"version":3,"sources":["../../../src/hooks/useNotifications.ts"],"sourcesContent":["import { checkNotificationMatchesFilter, isSameFilter, Notification, NotificationFilter, NovuError } from '@novu/js';\nimport { useCallback, useEffect, useState } from 'react';\nimport { useDataRef } from './internal/useDataRef';\nimport { useWebSocketEvent } from './internal/useWebsocketEvent';\nimport { useNovu, useRealtime } from './NovuProvider';\n\n/**\n * Props for the useNotifications hook.\n *\n * @example\n * ```tsx\n * // Get unread notifications\n * const { notifications } = useNotifications({\n *   read: false\n * });\n *\n * // Get unseen notifications with specific tags\n * const { notifications } = useNotifications({\n *   seen: false,\n *   tags: ['important']\n * });\n *\n * // Get notifications (auto-updates in real time when new notifications arrive)\n * const { notifications } = useNotifications({\n *   read: false\n * });\n *\n * // Get notifications from a specific time period\n * const { notifications } = useNotifications({\n *   createdGte: 1704067200000,\n *   createdLte: 1735689599999\n * });\n *\n * // Opt out of the built-in realtime updates and drive them yourself\n * const { notifications, refetch } = useNotifications({\n *   read: false,\n *   realtime: false,\n * });\n * ```\n */\nexport type UseNotificationsProps = {\n  tags?: NotificationFilter['tags'];\n  data?: NotificationFilter['data'];\n  read?: NotificationFilter['read'];\n  archived?: NotificationFilter['archived'];\n  snoozed?: NotificationFilter['snoozed'];\n  seen?: NotificationFilter['seen'];\n  severity?: NotificationFilter['severity'];\n  createdGte?: NotificationFilter['createdGte'];\n  createdLte?: NotificationFilter['createdLte'];\n  limit?: number;\n  /**\n   * When `false`, disables the WebSocket subscription that auto-injects\n   * newly received notifications into the list. 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()`).\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: Notification[]) => void;\n  onError?: (error: NovuError) => void;\n};\n\nexport type UseNotificationsResult = {\n  notifications?: Notification[];\n  error?: NovuError;\n  isLoading: boolean;\n  isFetching: boolean;\n  hasMore: boolean;\n  readAll: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  seenAll: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  archiveAll: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  archiveAllRead: () => Promise<{\n    data?: void | undefined;\n    error?: NovuError | undefined;\n  }>;\n  refetch: () => Promise<void>;\n  fetchMore: () => Promise<void>;\n};\n\nexport const useNotifications = (props?: UseNotificationsProps): UseNotificationsResult => {\n  const {\n    tags,\n    data: dataFilter,\n    read,\n    archived = false,\n    snoozed = false,\n    seen,\n    severity,\n    createdGte,\n    createdLte,\n    limit = 10,\n    realtime: propsRealtime,\n    onSuccess,\n    onError,\n  } = props || {};\n  const limitRef = useDataRef<number | undefined>(limit);\n  const filterRef = useDataRef<NotificationFilter>({\n    tags,\n    data: dataFilter,\n    read,\n    archived,\n    snoozed,\n    seen,\n    severity,\n    createdGte,\n    createdLte,\n  });\n  const novu = useNovu();\n  const providerRealtime = useRealtime();\n  const realtime = propsRealtime ?? providerRealtime;\n  const [data, setData] = useState<Array<Notification>>();\n  const [error, setError] = useState<NovuError>();\n  const [isLoading, setIsLoading] = useState(true);\n  const [isFetching, setIsFetching] = useState(false);\n  const [hasMore, setHasMore] = useState(false);\n  const length = data?.length;\n  const after = length ? data[length - 1].id : undefined;\n  const afterRef = useDataRef<string | undefined>(after);\n\n  useEffect(() => {\n    const listener = ({\n      data,\n    }: {\n      data: { notifications: Notification[]; hasMore: boolean; filter: NotificationFilter };\n    }) => {\n      if (!data || !isSameFilter(filterRef.current, data.filter)) {\n        return;\n      }\n\n      // the event is called with the list of all notifications cached matching the current filter\n      setData(data.notifications);\n      setHasMore(data.hasMore);\n    };\n\n    const cleanup = novu.on('notifications.list.updated', listener);\n\n    return () => {\n      cleanup();\n    };\n  }, [filterRef, novu]);\n\n  useWebSocketEvent({\n    event: 'notifications.notification_received',\n    enabled: realtime,\n    eventHandler: ({ result: notification }) => {\n      const currentFilter = filterRef.current;\n      const matches = checkNotificationMatchesFilter(notification, currentFilter);\n      if (matches) {\n        // the limit and after props are used to create a cache key\n        // the first batch of notifications in the cache doesn't include the after prop and we want to push to the first batch\n        const cacheKey = { ...currentFilter, limit: limitRef.current };\n        novu.notifications.cache.unshift(cacheKey, notification);\n      }\n    },\n  });\n\n  const fetchNotifications = useCallback(\n    async (options?: { refetch: boolean }) => {\n      if (options?.refetch) {\n        setError(undefined);\n        setIsLoading(true);\n        setIsFetching(false);\n      }\n      setIsFetching(true);\n\n      const response = await novu.notifications.list({\n        ...filterRef.current,\n        limit,\n        after: options?.refetch ? undefined : afterRef.current,\n      });\n\n      if (response.error) {\n        setError(response.error);\n        onError?.(response.error);\n        setIsLoading(false);\n        setIsFetching(false);\n      } else if (response.data) {\n        const responseData = response.data;\n        onSuccess?.(responseData.notifications);\n        setData(responseData.notifications);\n        setHasMore(responseData.hasMore);\n        setIsLoading(false);\n        setIsFetching(false);\n      }\n    },\n    [novu, filterRef, afterRef, limit, onError, onSuccess]\n  );\n\n  useEffect(() => {\n    novu.notifications.clearCache({ filter: filterRef.current });\n    fetchNotifications({ refetch: true });\n  }, [filterRef, novu, JSON.stringify(filterRef.current), fetchNotifications]);\n\n  const refetch = useCallback(() => {\n    novu.notifications.clearCache({ filter: filterRef.current });\n    return fetchNotifications({ refetch: true });\n  }, [filterRef, novu, fetchNotifications]);\n\n  const fetchMore = useCallback(async () => {\n    if (!hasMore || isFetching) return;\n\n    return fetchNotifications();\n  }, [hasMore, isFetching, fetchNotifications]);\n\n  const readAll = useCallback(async () => {\n    return await novu.notifications.readAll({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  const seenAll = useCallback(async () => {\n    return await novu.notifications.seenAll({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  const archiveAll = useCallback(async () => {\n    return await novu.notifications.archiveAll({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  const archiveAllRead = useCallback(async () => {\n    return await novu.notifications.archiveAllRead({ tags: filterRef.current.tags, data: filterRef.current.data });\n  }, [filterRef, novu]);\n\n  return {\n    readAll,\n    seenAll,\n    archiveAll,\n    archiveAllRead,\n    notifications: data,\n    error,\n    isLoading,\n    isFetching,\n    refetch,\n    fetchMore,\n    hasMore,\n  };\n};\n"],"mappings":"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","names":["data"]}

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

@@ -26,6 +26,12 @@ import { NotificationFilter, Notification, NovuError } from '@novu/js';
  *   createdGte: 1704067200000,
  *   createdLte: 1735689599999
  * });
+ *
+ * // Opt out of the built-in realtime updates and drive them yourself
+ * const { notifications, refetch } = useNotifications({
+ *   read: false,
+ *   realtime: false,
+ * });
  * ```
  */
 type UseNotificationsProps = {
@@ -39,6 +45,18 @@ type UseNotificationsProps = {
     createdGte?: NotificationFilter['createdGte'];
     createdLte?: NotificationFilter['createdLte'];
     limit?: number;
+    /**
+     * When `false`, disables the WebSocket subscription that auto-injects
+     * newly received notifications into the list. Built-in mutations like
+     * `readAll`, `seenAll`, `archiveAll`, and `archiveAllRead` continue to
+     * update local state. Use this when you want to drive new-notification updates yourself (e.g.
+     * via your own `novu.on('notifications.notification_received', ...)`
+     * handler combined with `refetch()`).
+     *
+     * 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: Notification[]) => void;
     onError?: (error: NovuError) => void;
 };

package/dist/cjs/index.cjs

@@ -28,12 +28,19 @@ __export(index_exports, {
   PreferenceLevel: () => import_js.PreferenceLevel,
   Preferences: () => import_components.Preferences,
   SeverityLevelEnum: () => import_js.SeverityLevelEnum,
+  SlackConnectButton: () => import_components.SlackConnectButton,
+  SlackLinkUser: () => import_components.SlackLinkUser,
   Subscription: () => import_components.Subscription,
   SubscriptionButton: () => import_components.SubscriptionButton,
   SubscriptionPreferences: () => import_components.SubscriptionPreferences,
   WorkflowCriticalityEnum: () => import_js.WorkflowCriticalityEnum,
+  useChannelConnection: () => import_hooks.useChannelConnection,
+  useChannelConnections: () => import_hooks.useChannelConnections,
+  useChannelEndpoint: () => import_hooks.useChannelEndpoint,
   useCounts: () => import_hooks.useCounts,
+  useCreateChannelEndpoint: () => import_hooks.useCreateChannelEndpoint,
   useCreateSubscription: () => import_hooks.useCreateSubscription,
+  useDeleteChannelEndpoint: () => import_hooks.useDeleteChannelEndpoint,
   useNotifications: () => import_hooks.useNotifications,
   useNovu: () => import_hooks.useNovu,
   usePreferences: () => import_hooks.usePreferences,
@@ -57,12 +64,19 @@ var import_hooks = require("./hooks/index.cjs");
   PreferenceLevel,
   Preferences,
   SeverityLevelEnum,
+  SlackConnectButton,
+  SlackLinkUser,
   Subscription,
   SubscriptionButton,
   SubscriptionPreferences,
   WorkflowCriticalityEnum,
+  useChannelConnection,
+  useChannelConnections,
+  useChannelEndpoint,
   useCounts,
+  useCreateChannelEndpoint,
   useCreateSubscription,
+  useDeleteChannelEndpoint,
   useNotifications,
   useNovu,
   usePreferences,

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  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  NotificationProps,\n  NovuProviderProps,\n  SubscriptionButtonProps,\n  SubscriptionPreferencesProps,\n  SubscriptionProps,\n} from './components';\nexport {\n  Bell,\n  Inbox,\n  InboxContent,\n  Notifications,\n  NovuProvider,\n  Preferences,\n  Subscription,\n  SubscriptionButton,\n  SubscriptionPreferences,\n} from './components';\nexport type {\n  UseCountsProps,\n  UseCountsResult,\n  UseNotificationsProps,\n  UseNotificationsResult,\n  UsePreferencesResult,\n  UseScheduleProps as UsePreferencesProps,\n} from './hooks';\nexport {\n  useCounts,\n  useCreateSubscription,\n  useNotifications,\n  useNovu,\n  usePreferences,\n  useRemoveSubscription,\n  useSchedule,\n  useSubscription,\n  useSubscriptions,\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  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;AACA,gBAA4E;AA2C5E,wBAUO;AASP,mBAWO;","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  NotificationProps,\n  NovuProviderProps,\n  SlackConnectButtonProps,\n  SlackLinkUserProps,\n  SubscriptionButtonProps,\n  SubscriptionPreferencesProps,\n  SubscriptionProps,\n} from './components';\nexport {\n  Bell,\n  Inbox,\n  InboxContent,\n  Notifications,\n  NovuProvider,\n  Preferences,\n  SlackConnectButton,\n  SlackLinkUser,\n  Subscription,\n  SubscriptionButton,\n  SubscriptionPreferences,\n} from './components';\nexport type {\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} from './hooks';\nexport {\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  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;AACA,gBAA4E;AA8C5E,wBAYO;AAmBP,mBAgBO;","names":[]}

package/dist/cjs/index.d.cts

@@ -1,17 +1,24 @@
 export * from '@novu/js';
 export { PreferenceLevel, SeverityLevelEnum, WorkflowCriticalityEnum } from '@novu/js';
-export { AllLocalization, AllLocalizationKey, ElementStyles, InboxAppearance, InboxAppearanceCallback, InboxAppearanceCallbackFunction, InboxAppearanceCallbackKeys, InboxAppearanceKey, InboxElements, InboxLocalization, InboxLocalizationKey, InboxTheme, NotificationActionClickHandler, NotificationClickHandler, NotificationRenderer, PreferenceGroups, PreferencesFilter, RouterPush, SubscriptionAppearance, SubscriptionAppearanceCallback, SubscriptionAppearanceCallbackFunction, SubscriptionAppearanceCallbackKeys, SubscriptionAppearanceKey, SubscriptionElements, SubscriptionLocalization, SubscriptionLocalizationKey, SubscriptionTheme, Tab, Variables } from '@novu/js/ui';
+export { AllLocalization, AllLocalizationKey, ChannelConnectButtonIconKey, ElementStyles, InboxAppearance, InboxAppearanceCallback, InboxAppearanceCallbackFunction, InboxAppearanceCallbackKeys, InboxAppearanceKey, InboxElements, InboxLocalization, InboxLocalizationKey, InboxTheme, NotificationActionClickHandler, NotificationClickHandler, NotificationRenderer, PreferenceGroups, PreferencesFilter, RouterPush, SubscriptionAppearance, SubscriptionAppearanceCallback, SubscriptionAppearanceCallbackFunction, SubscriptionAppearanceCallbackKeys, SubscriptionAppearanceKey, SubscriptionElements, SubscriptionLocalization, SubscriptionLocalizationKey, SubscriptionTheme, Tab, Variables } from '@novu/js/ui';
 export { NovuProvider, NovuProviderProps, useNovu } from './hooks/NovuProvider.cjs';
 export { Bell, BellProps } from './components/Bell.cjs';
 export { Inbox, InboxProps } from './components/Inbox.cjs';
 export { InboxContent, InboxContentProps } from './components/InboxContent.cjs';
 export { NotificationProps, Notifications } from './components/Notifications.cjs';
 export { Preferences } from './components/Preferences.cjs';
+export { SlackConnectButton, SlackConnectButtonProps } from './components/slack-connect-button/SlackConnectButton.cjs';
+export { SlackLinkUser, SlackLinkUserProps } from './components/slack-link-user/SlackLinkUser.cjs';
 export { Subscription, SubscriptionProps } from './components/subscription/Subscription.cjs';
 export { SubscriptionButton, SubscriptionButtonProps } from './components/subscription/SubscriptionButton.cjs';
 export { SubscriptionPreferences, SubscriptionPreferencesProps } from './components/subscription/SubscriptionPreferences.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';
 export { UseCountsProps, UseCountsResult, useCounts } from './hooks/useCounts.cjs';
+export { UseCreateChannelEndpointProps, UseCreateChannelEndpointResult, useCreateChannelEndpoint } from './hooks/useCreateChannelEndpoint.cjs';
 export { useCreateSubscription } from './hooks/useCreateSubscription.cjs';
+export { UseDeleteChannelEndpointProps, UseDeleteChannelEndpointResult, useDeleteChannelEndpoint } from './hooks/useDeleteChannelEndpoint.cjs';
 export { UseNotificationsProps, UseNotificationsResult, useNotifications } from './hooks/useNotifications.cjs';
 export { UsePreferencesResult, usePreferences } from './hooks/usePreferences.cjs';
 export { useRemoveSubscription } from './hooks/useRemoveSubscription.cjs';
@@ -19,8 +26,10 @@ export { UseScheduleProps as UsePreferencesProps, useSchedule } from './hooks/us
 export { useSubscription } from './hooks/useSubscription.cjs';
 export { useSubscriptions } from './hooks/useSubscriptions.cjs';
 export { useUpdateSubscription } from './hooks/useUpdateSubscription.cjs';
-export { BaseProps, BellRenderer, BodyRenderer, DefaultInboxProps, DefaultProps, NoRendererProps, NotificationRendererProps, NotificationsRenderer, ReactInboxAppearance, ReactInboxTheme, ReactSubscriptionAppearance, ReactSubscriptionTheme, SubjectBodyRendererProps, SubjectRenderer, WithChildrenProps } from './utils/types.cjs';
+export { BaseProps, BellRenderer, BodyRenderer, DefaultInboxProps, DefaultProps, NoRendererProps, NotificationRendererProps, NotificationsRenderer, ReactAllAppearance, ReactInboxAppearance, ReactInboxTheme, ReactSubscriptionAppearance, ReactSubscriptionTheme, SubjectBodyRendererProps, SubjectRenderer, WithChildrenProps } from './utils/types.cjs';
 import 'react/jsx-runtime';
 import 'react';
 import './components/NovuUI.cjs';
+import './components/slack-connect-button/DefaultSlackConnectButton.cjs';
+import './components/slack-link-user/DefaultSlackLinkUser.cjs';
 import './components/subscription/DefaultSubscription.cjs';

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

@@ -1 +1,2 @@
 export { buildSubscriber } from '@novu/js/internal';
+import '@novu/js/themes';

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

@@ -1,2 +1 @@
 export * from '@novu/js/themes';
-import '@novu/js/internal';