@novu/js 3.16.0 → 3.17.0-rc.d0046861c6

package/dist/cjs/{chunk-6I5A5OGE.js → chunk-N6G6IRD4.js}

@@ -186,6 +186,97 @@ var areDataEqual = (data1, data2) => {
 var isSameFilter = (filter1, filter2) => {
   return areDataEqual(filter1.data, filter2.data) && areTagsEqual(filter1.tags, filter2.tags) && filter1.read === filter2.read && filter1.archived === filter2.archived && filter1.snoozed === filter2.snoozed && filter1.seen === filter2.seen && areSeveritiesEqual(filter1.severity, filter2.severity) && filter1.createdGte === filter2.createdGte && filter1.createdLte === filter2.createdLte;
 };
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOperatorObject(value) {
+  return Object.prototype.hasOwnProperty.call(value, "or") || Object.prototype.hasOwnProperty.call(value, "and");
+}
+function isScalarValue(value) {
+  if (value === null) return true;
+  if (typeof value === "boolean") return true;
+  if (typeof value === "string") return true;
+  if (typeof value === "number") return Number.isFinite(value);
+  return false;
+}
+function normalizeDataFieldValue(value) {
+  if (value === void 0) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) return [];
+    if (!value.every(isScalarValue)) return null;
+    return [value];
+  }
+  if (isPlainObject(value)) {
+    const hasOr = Object.prototype.hasOwnProperty.call(value, "or");
+    const hasAnd = Object.prototype.hasOwnProperty.call(value, "and");
+    if (hasOr && hasAnd) return null;
+    const keys = Object.keys(value);
+    if (hasOr) {
+      if (keys.length !== 1) return null;
+      const orVal = value.or;
+      if (!Array.isArray(orVal)) return null;
+      if (orVal.length === 0) return [];
+      if (!orVal.every(isScalarValue)) return null;
+      return [orVal];
+    }
+    if (hasAnd) {
+      if (keys.length !== 1) return null;
+      const andVal = value.and;
+      if (!Array.isArray(andVal)) return null;
+      const groups = [];
+      for (const item of andVal) {
+        if (!isPlainObject(item)) return null;
+        const itemKeys = Object.keys(item);
+        if (itemKeys.length !== 1 || !("or" in item)) return null;
+        const innerOr = item.or;
+        if (!Array.isArray(innerOr) || innerOr.length === 0) return null;
+        if (!innerOr.every(isScalarValue)) return null;
+        groups.push(innerOr);
+      }
+      return groups;
+    }
+    return null;
+  }
+  if (!isScalarValue(value)) return null;
+  return [[value]];
+}
+function dataValueAtPath(obj, path) {
+  let current = obj;
+  for (const segment of path) {
+    if (current === null || current === void 0) return void 0;
+    if (typeof current !== "object" || Array.isArray(current)) return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+function orGroupMatchesNotifValue(group, notifValue) {
+  if (Array.isArray(notifValue)) {
+    return notifValue.some((v) => group.some((g) => g === v));
+  }
+  return group.some((g) => g === notifValue);
+}
+function checkDataEntries(notificationData, filterData, pathPrefix, depth) {
+  if (depth > 2) return false;
+  for (const [rawKey, rawValue] of Object.entries(filterData)) {
+    if (rawKey.startsWith("$") || rawKey.startsWith(".") || rawKey === "__proto__" || rawKey === "constructor" || rawKey === "prototype") {
+      return false;
+    }
+    const path = [...pathPrefix, rawKey];
+    if (isPlainObject(rawValue) && !isOperatorObject(rawValue)) {
+      if (!checkDataEntries(notificationData, rawValue, path, depth + 1)) return false;
+      continue;
+    }
+    const groups = normalizeDataFieldValue(rawValue);
+    if (groups === null) return false;
+    if (groups.length === 0) continue;
+    const notifValue = notificationData ? dataValueAtPath(notificationData, path) : void 0;
+    if (notifValue === void 0) return false;
+    if (!groups.every((g) => orGroupMatchesNotifValue(g, notifValue))) return false;
+  }
+  return true;
+}
 function checkNotificationDataFilter(notificationData, filterData) {
   if (!filterData || Object.keys(filterData).length === 0) {
     return true;
@@ -193,24 +284,7 @@ function checkNotificationDataFilter(notificationData, filterData) {
   if (!notificationData) {
     return false;
   }
-  return Object.entries(filterData).every(([key, filterValue]) => {
-    const notifValue = notificationData[key];
-    if (notifValue === void 0 && filterValue !== void 0) {
-      return false;
-    }
-    if (Array.isArray(filterValue)) {
-      if (Array.isArray(notifValue)) {
-        if (filterValue.length !== notifValue.length) return false;
-        const sortedFilterValue = [...filterValue].sort();
-        const sortedNotifValue = [...notifValue].sort();
-        return sortedFilterValue.every((val, index) => val === sortedNotifValue[index]);
-      } else {
-        return filterValue.includes(notifValue);
-      }
-    } else {
-      return notifValue === filterValue;
-    }
-  });
+  return checkDataEntries(notificationData, filterData, [], 1);
 }
 function checkNotificationTagFilter(notificationTags, filterTags) {
   let groups;
@@ -1043,7 +1117,7 @@ _contextKey = new WeakMap();
 
 // src/api/http-client.ts
 var DEFAULT_API_VERSION = "v1";
-var DEFAULT_CLIENT_VERSION = `${"@novu/js"}@${"3.16.0"}`;
+var DEFAULT_CLIENT_VERSION = `${"@novu/js"}@${"3.17.0-rc.d0046861c6"}`;
 var HttpClient = class {
   constructor(options = {}) {
     // Environment variable for local development that overrides the default API endpoint without affecting the Inbox DX
@@ -1159,7 +1233,9 @@ var INBOX_ROUTE = "/inbox";
 var INBOX_NOTIFICATIONS_ROUTE = `${INBOX_ROUTE}/notifications`;
 var CHAT_OAUTH_ROUTE = `${INBOX_ROUTE}/chat/oauth`;
 var CHANNEL_CONNECTIONS_ROUTE = `${INBOX_ROUTE}/channel-connections`;
+var CHANNEL_CONNECTIONS_OAUTH_ROUTE = `${CHANNEL_CONNECTIONS_ROUTE}/oauth`;
 var CHANNEL_ENDPOINTS_ROUTE = `${INBOX_ROUTE}/channel-endpoints`;
+var CHANNEL_ENDPOINTS_OAUTH_ROUTE = `${CHANNEL_ENDPOINTS_ROUTE}/oauth`;
 function buildChannelListSearchParams(args) {
   const searchParams = new URLSearchParams();
   if (args.subscriberId) searchParams.append("subscriberId", args.subscriberId);
@@ -1498,6 +1574,9 @@ var InboxService = class {
   deleteSubscription({ topicKey, identifier }) {
     return chunk7B52C2XE_js.__privateGet(this, _httpClient).delete(`${INBOX_ROUTE}/topics/${topicKey}/subscriptions/${identifier}`);
   }
+  /**
+   * @deprecated Use generateConnectOAuthUrl() or generateLinkUserOAuthUrl() instead.
+   */
   generateChatOAuthUrl({
     integrationIdentifier,
     connectionIdentifier,
@@ -1506,7 +1585,8 @@ var InboxService = class {
     scope,
     userScope,
     mode,
-    connectionMode
+    connectionMode,
+    autoLinkUser
   }) {
     return chunk7B52C2XE_js.__privateGet(this, _httpClient).post(CHAT_OAUTH_ROUTE, {
       integrationIdentifier,
@@ -1516,7 +1596,42 @@ var InboxService = class {
       scope,
       userScope,
       mode,
-      connectionMode
+      connectionMode,
+      autoLinkUser
+    });
+  }
+  generateConnectOAuthUrl({
+    integrationIdentifier,
+    connectionIdentifier,
+    subscriberId,
+    context,
+    scope,
+    connectionMode,
+    autoLinkUser
+  }) {
+    return chunk7B52C2XE_js.__privateGet(this, _httpClient).post(CHANNEL_CONNECTIONS_OAUTH_ROUTE, {
+      integrationIdentifier,
+      connectionIdentifier,
+      subscriberId,
+      context,
+      scope,
+      connectionMode,
+      autoLinkUser
+    });
+  }
+  generateLinkUserOAuthUrl({
+    integrationIdentifier,
+    connectionIdentifier,
+    subscriberId,
+    context,
+    userScope
+  }) {
+    return chunk7B52C2XE_js.__privateGet(this, _httpClient).post(CHANNEL_ENDPOINTS_OAUTH_ROUTE, {
+      integrationIdentifier,
+      connectionIdentifier,
+      subscriberId,
+      context,
+      userScope
     });
   }
   listChannelConnections(args = {}) {
@@ -1594,6 +1709,21 @@ var generateChatOAuthUrl = (_0) => chunk7B52C2XE_js.__async(null, [_0], function
     return { error: new chunkWDGG3OER_js.NovuError("Failed to generate chat OAuth URL", error) };
   }
 });
+var generateConnectOAuthUrl = (_0) => chunk7B52C2XE_js.__async(null, [_0], function* ({
+  emitter,
+  apiService,
+  args
+}) {
+  try {
+    emitter.emit("channel-connection.oauth-url.pending", { args });
+    const data = yield apiService.generateConnectOAuthUrl(args);
+    emitter.emit("channel-connection.oauth-url.resolved", { args, data });
+    return { data };
+  } catch (error) {
+    emitter.emit("channel-connection.oauth-url.resolved", { args, error });
+    return { error: new chunkWDGG3OER_js.NovuError("Failed to generate connect OAuth URL", error) };
+  }
+});
 var listChannelConnections = (_0) => chunk7B52C2XE_js.__async(null, [_0], function* ({
   emitter,
   apiService,
@@ -1649,6 +1779,9 @@ var ChannelConnections = class extends BaseModule {
   }) {
     super({ inboxServiceInstance, eventEmitterInstance });
   }
+  /**
+   * @deprecated Use generateConnectOAuthUrl() instead. For user-level linking use channelEndpoints.generateLinkUserOAuthUrl().
+   */
   generateOAuthUrl(args) {
     return chunk7B52C2XE_js.__async(this, null, function* () {
       return this.callWithSession(
@@ -1660,6 +1793,17 @@ var ChannelConnections = class extends BaseModule {
       );
     });
   }
+  generateConnectOAuthUrl(args) {
+    return chunk7B52C2XE_js.__async(this, null, function* () {
+      return this.callWithSession(
+        () => generateConnectOAuthUrl({
+          emitter: this._emitter,
+          apiService: this._inboxService,
+          args
+        })
+      );
+    });
+  }
   list() {
     return chunk7B52C2XE_js.__async(this, arguments, function* (args = {}) {
       return this.callWithSession(
@@ -1696,6 +1840,21 @@ var ChannelConnections = class extends BaseModule {
 };
 
 // src/channel-endpoints/helpers.ts
+var generateLinkUserOAuthUrl = (_0) => chunk7B52C2XE_js.__async(null, [_0], function* ({
+  emitter,
+  apiService,
+  args
+}) {
+  try {
+    emitter.emit("channel-endpoint.oauth-url.pending", { args });
+    const data = yield apiService.generateLinkUserOAuthUrl(args);
+    emitter.emit("channel-endpoint.oauth-url.resolved", { args, data });
+    return { data };
+  } catch (error) {
+    emitter.emit("channel-endpoint.oauth-url.resolved", { args, error });
+    return { error: new chunkWDGG3OER_js.NovuError("Failed to generate link user OAuth URL", error) };
+  }
+});
 var listChannelEndpoints = (_0) => chunk7B52C2XE_js.__async(null, [_0], function* ({
   emitter,
   apiService,
@@ -1766,6 +1925,17 @@ var ChannelEndpoints = class extends BaseModule {
   }) {
     super({ inboxServiceInstance, eventEmitterInstance });
   }
+  generateLinkUserOAuthUrl(args) {
+    return chunk7B52C2XE_js.__async(this, null, function* () {
+      return this.callWithSession(
+        () => generateLinkUserOAuthUrl({
+          emitter: this._emitter,
+          apiService: this._inboxService,
+          args
+        })
+      );
+    });
+  }
   list() {
     return chunk7B52C2XE_js.__async(this, arguments, function* (args = {}) {
       return this.callWithSession(
@@ -3218,6 +3388,8 @@ _emitter9 = new WeakMap();
 _inboxService5 = new WeakMap();
 _options = new WeakMap();
 var PRODUCTION_SOCKET_URL = "wss://socket.novu.co";
+var HIBERNATION_HEARTBEAT_MS = 25e3;
+var HIBERNATION_PING_PAYLOAD = "ping";
 var NOTIFICATION_RECEIVED = "notifications.notification_received";
 var UNSEEN_COUNT_CHANGED = "notifications.unseen_count_changed";
 var UNREAD_COUNT_CHANGED = "notifications.unread_count_changed";
@@ -3308,7 +3480,7 @@ var mapToNotification = ({
     severity
   });
 };
-var _token, _emitter10, _partySocket, _socketUrl, _socketOptions, _notificationReceived, _unseenCountChanged, _unreadCountChanged, _handleMessage, _PartySocketClient_instances, initializeSocket_fn, handleConnectSocket_fn, handleDisconnectSocket_fn;
+var _token, _emitter10, _partySocket, _socketUrl, _socketOptions, _hibernationHeartbeatIntervalId, _notificationReceived, _unseenCountChanged, _unreadCountChanged, _handleMessage, _PartySocketClient_instances, clearHibernationHeartbeat_fn, startHibernationHeartbeat_fn, initializeSocket_fn, handleConnectSocket_fn, handleDisconnectSocket_fn;
 var PartySocketClient = class extends BaseModule {
   constructor({
     socketUrl,
@@ -3326,6 +3498,7 @@ var PartySocketClient = class extends BaseModule {
     chunk7B52C2XE_js.__privateAdd(this, _partySocket);
     chunk7B52C2XE_js.__privateAdd(this, _socketUrl);
     chunk7B52C2XE_js.__privateAdd(this, _socketOptions);
+    chunk7B52C2XE_js.__privateAdd(this, _hibernationHeartbeatIntervalId);
     chunk7B52C2XE_js.__privateAdd(this, _notificationReceived, (event) => {
       try {
         const data = JSON.parse(event.data);
@@ -3361,6 +3534,9 @@ var PartySocketClient = class extends BaseModule {
       }
     });
     chunk7B52C2XE_js.__privateAdd(this, _handleMessage, (event) => {
+      if (event.data === HIBERNATION_PING_PAYLOAD || event.data === "pong") {
+        return;
+      }
       try {
         const data = JSON.parse(event.data);
         switch (data.event) {
@@ -3410,11 +3586,31 @@ _emitter10 = new WeakMap();
 _partySocket = new WeakMap();
 _socketUrl = new WeakMap();
 _socketOptions = new WeakMap();
+_hibernationHeartbeatIntervalId = new WeakMap();
 _notificationReceived = new WeakMap();
 _unseenCountChanged = new WeakMap();
 _unreadCountChanged = new WeakMap();
 _handleMessage = new WeakMap();
 _PartySocketClient_instances = new WeakSet();
+clearHibernationHeartbeat_fn = function() {
+  if (chunk7B52C2XE_js.__privateGet(this, _hibernationHeartbeatIntervalId) !== void 0) {
+    clearInterval(chunk7B52C2XE_js.__privateGet(this, _hibernationHeartbeatIntervalId));
+    chunk7B52C2XE_js.__privateSet(this, _hibernationHeartbeatIntervalId, void 0);
+  }
+};
+startHibernationHeartbeat_fn = function() {
+  chunk7B52C2XE_js.__privateMethod(this, _PartySocketClient_instances, clearHibernationHeartbeat_fn).call(this);
+  chunk7B52C2XE_js.__privateSet(this, _hibernationHeartbeatIntervalId, setInterval(() => {
+    const socket = chunk7B52C2XE_js.__privateGet(this, _partySocket);
+    if (!socket || socket.readyState !== partysocket.WebSocket.OPEN) {
+      return;
+    }
+    try {
+      socket.send(HIBERNATION_PING_PAYLOAD);
+    } catch (e) {
+    }
+  }, HIBERNATION_HEARTBEAT_MS));
+};
 initializeSocket_fn = function() {
   return chunk7B52C2XE_js.__async(this, null, function* () {
     if (chunk7B52C2XE_js.__privateGet(this, _partySocket)) {
@@ -3425,13 +3621,22 @@ initializeSocket_fn = function() {
     const url = new URL(chunk7B52C2XE_js.__privateGet(this, _socketUrl));
     url.searchParams.set("token", chunk7B52C2XE_js.__privateGet(this, _token));
     chunk7B52C2XE_js.__privateSet(this, _partySocket, new partysocket.WebSocket(url.toString(), void 0, chunk7B52C2XE_js.__privateGet(this, _socketOptions)));
-    chunk7B52C2XE_js.__privateGet(this, _partySocket).addEventListener("open", () => {
+    const socket = chunk7B52C2XE_js.__privateGet(this, _partySocket);
+    socket.addEventListener("open", () => {
+      chunk7B52C2XE_js.__privateMethod(this, _PartySocketClient_instances, startHibernationHeartbeat_fn).call(this);
       chunk7B52C2XE_js.__privateGet(this, _emitter10).emit("socket.connect.resolved", { args });
     });
-    chunk7B52C2XE_js.__privateGet(this, _partySocket).addEventListener("error", (error) => {
+    socket.addEventListener("error", (error) => {
       chunk7B52C2XE_js.__privateGet(this, _emitter10).emit("socket.connect.resolved", { args, error });
     });
-    chunk7B52C2XE_js.__privateGet(this, _partySocket).addEventListener("message", chunk7B52C2XE_js.__privateGet(this, _handleMessage));
+    socket.addEventListener("close", () => {
+      if (socket !== chunk7B52C2XE_js.__privateGet(this, _partySocket)) {
+        return;
+      }
+      chunk7B52C2XE_js.__privateMethod(this, _PartySocketClient_instances, clearHibernationHeartbeat_fn).call(this);
+      chunk7B52C2XE_js.__privateSet(this, _partySocket, void 0);
+    });
+    socket.addEventListener("message", chunk7B52C2XE_js.__privateGet(this, _handleMessage));
   });
 };
 handleConnectSocket_fn = function() {
@@ -3448,6 +3653,7 @@ handleDisconnectSocket_fn = function() {
   return chunk7B52C2XE_js.__async(this, null, function* () {
     var _a;
     try {
+      chunk7B52C2XE_js.__privateMethod(this, _PartySocketClient_instances, clearHibernationHeartbeat_fn).call(this);
       (_a = chunk7B52C2XE_js.__privateGet(this, _partySocket)) == null ? void 0 : _a.close();
       chunk7B52C2XE_js.__privateSet(this, _partySocket, void 0);
       return {};

package/dist/{esm/inbox-service-CEMMLHsX.d.mts → cjs/inbox-service-CGCuuYnv.d.ts}

@@ -294,6 +294,9 @@ type ChannelConnectionOAuthUrlEvents = BaseEvents<'channel-connection.oauth-url'
 type ChannelConnectionsFetchEvents = BaseEvents<'channel-connections.list', ListChannelConnectionsArgs, ChannelConnectionResponse[]>;
 type ChannelConnectionGetEvents = BaseEvents<'channel-connection.get', GetChannelConnectionArgs, ChannelConnectionResponse | null>;
 type ChannelConnectionDeleteEvents = BaseEvents<'channel-connection.delete', DeleteChannelConnectionArgs, void>;
+type ChannelEndpointOAuthUrlEvents = BaseEvents<'channel-endpoint.oauth-url', GenerateLinkUserOAuthUrlArgs, {
+    url: string;
+}>;
 type ChannelEndpointsFetchEvents = BaseEvents<'channel-endpoints.list', ListChannelEndpointsArgs, ChannelEndpointResponse[]>;
 type ChannelEndpointGetEvents = BaseEvents<'channel-endpoint.get', GetChannelEndpointArgs, ChannelEndpointResponse | null>;
 type ChannelEndpointCreateEvents = BaseEvents<'channel-endpoint.create', CreateChannelEndpointArgs, ChannelEndpointResponse>;
@@ -351,7 +354,7 @@ type Events = SessionInitializeEvents & NotificationsFetchEvents & {
             subscriptions: TopicSubscription[];
         };
     };
-} & ChannelConnectionOAuthUrlEvents & ChannelConnectionsFetchEvents & ChannelConnectionGetEvents & ChannelConnectionDeleteEvents & ChannelEndpointsFetchEvents & ChannelEndpointGetEvents & ChannelEndpointCreateEvents & ChannelEndpointDeleteEvents & SocketConnectEvents & SocketEvents & NotificationReadEvents & NotificationUnreadEvents & NotificationSeenEvents & NotificationArchiveEvents & NotificationUnarchiveEvents & NotificationDeleteEvents & NotificationSnoozeEvents & NotificationUnsnoozeEvents & NotificationCompleteActionEvents & NotificationRevertActionEvents & NotificationsReadAllEvents & NotificationsSeenAllEvents & NotificationsArchivedAllEvents & NotificationsReadArchivedAllEvents & NotificationsDeletedAllEvents;
+} & ChannelConnectionOAuthUrlEvents & ChannelConnectionsFetchEvents & ChannelConnectionGetEvents & ChannelConnectionDeleteEvents & ChannelEndpointOAuthUrlEvents & ChannelEndpointsFetchEvents & ChannelEndpointGetEvents & ChannelEndpointCreateEvents & ChannelEndpointDeleteEvents & SocketConnectEvents & SocketEvents & NotificationReadEvents & NotificationUnreadEvents & NotificationSeenEvents & NotificationArchiveEvents & NotificationUnarchiveEvents & NotificationDeleteEvents & NotificationSnoozeEvents & NotificationUnsnoozeEvents & NotificationCompleteActionEvents & NotificationRevertActionEvents & NotificationsReadAllEvents & NotificationsSeenAllEvents & NotificationsArchivedAllEvents & NotificationsReadArchivedAllEvents & NotificationsDeletedAllEvents;
 type EventNames = keyof Events;
 type SocketEventNames = keyof SocketEvents;
 type EventHandler<T = unknown> = (event: T) => void;
@@ -638,6 +641,18 @@ type NotificationFilter = {
     archived?: boolean;
     snoozed?: boolean;
     seen?: boolean;
+    /**
+     * Filter notifications by keys in their `data` object.
+     *
+     * Each top-level key value can be:
+     *  - a scalar (exact equality)
+     *  - `Scalar[]` (OR — match any of the listed values)
+     *  - `{ or: Scalar[] }` (explicit OR)
+     *  - `{ and: [{ or: Scalar[] }, ...] }` (AND of OR-groups)
+     *  - a 1-level nested object whose sub-keys follow the same rules
+     *
+     * Across keys clauses are AND-ed together.
+     */
     data?: Record<string, unknown>;
     severity?: SeverityLevelEnum | SeverityLevelEnum[];
     createdGte?: number;
@@ -759,6 +774,9 @@ type ChannelEndpointResponse = {
 };
 type OAuthMode = 'connect' | 'link_user';
 type ConnectionMode = 'subscriber' | 'shared';
+/**
+ * @deprecated Use GenerateConnectOAuthUrlArgs or GenerateLinkUserOAuthUrlArgs instead.
+ */
 type GenerateChatOAuthUrlArgs = {
     integrationIdentifier: string;
     connectionIdentifier?: string;
@@ -768,6 +786,28 @@ type GenerateChatOAuthUrlArgs = {
     userScope?: string[];
     mode?: OAuthMode;
     connectionMode?: ConnectionMode;
+    autoLinkUser?: boolean;
+};
+/** Args for creating a workspace/tenant channel connection (Slack install or MS Teams admin consent). */
+type GenerateConnectOAuthUrlArgs = {
+    integrationIdentifier: string;
+    connectionIdentifier?: string;
+    subscriberId?: string;
+    context?: Context;
+    /** Slack only: OAuth bot scopes to request. */
+    scope?: string[];
+    connectionMode?: ConnectionMode;
+    autoLinkUser?: boolean;
+};
+/** Args for linking a subscriber to their personal chat identity (Slack user or MS Teams user OID). */
+type GenerateLinkUserOAuthUrlArgs = {
+    integrationIdentifier: string;
+    connectionIdentifier?: string;
+    /** Required — this operation always binds a specific subscriber to a user identity. */
+    subscriberId: string;
+    context?: Context;
+    /** Slack only: user-level OAuth scopes (e.g. identity.basic). */
+    userScope?: string[];
 };
 type ListChannelConnectionsArgs = {
     subscriberId?: string;
@@ -970,7 +1010,16 @@ declare class InboxService {
         topicKey: string;
         identifier: string;
     }): Promise<void>;
-    generateChatOAuthUrl({ integrationIdentifier, connectionIdentifier, subscriberId, context, scope, userScope, mode, connectionMode, }: GenerateChatOAuthUrlArgs): Promise<{
+    /**
+     * @deprecated Use generateConnectOAuthUrl() or generateLinkUserOAuthUrl() instead.
+     */
+    generateChatOAuthUrl({ integrationIdentifier, connectionIdentifier, subscriberId, context, scope, userScope, mode, connectionMode, autoLinkUser, }: GenerateChatOAuthUrlArgs): Promise<{
+        url: string;
+    }>;
+    generateConnectOAuthUrl({ integrationIdentifier, connectionIdentifier, subscriberId, context, scope, connectionMode, autoLinkUser, }: GenerateConnectOAuthUrlArgs): Promise<{
+        url: string;
+    }>;
+    generateLinkUserOAuthUrl({ integrationIdentifier, connectionIdentifier, subscriberId, context, userScope, }: GenerateLinkUserOAuthUrlArgs): Promise<{
         url: string;
     }>;
     listChannelConnections(args?: ListChannelConnectionsArgs): Promise<{
@@ -991,4 +1040,4 @@ declare class InboxService {
     deleteChannelEndpoint(identifier: string): Promise<void>;
 }
 
-export { type UpdateSubscriptionPreferenceArgs as $, type PreferenceFilter as A, type BaseDeleteSubscriptionArgs as B, type ChannelConnectionResponse as C, type DaySchedule as D, type EventHandler as E, type FiltersCountResponse as F, type GenerateChatOAuthUrlArgs as G, PreferenceLevel as H, type InboxNotification as I, type PreferencesResponse as J, Schedule as K, type ListChannelConnectionsArgs as L, type SocketEventNames as M, Notification as N, type SocketTypeOption as O, Preference as P, type StandardNovuOptions as Q, type Subscriber as R, SeverityLevelEnum as S, type TagsFilter as T, SubscriptionPreference as U, type TagsFilterAndForm as V, type TagsFilterOrGroup as W, type TimeRange as X, TopicSubscription as Y, type UnreadCount as Z, type UpdateSubscriptionArgs as _, type NotificationFilter as a, WebSocketEvent as a0, type WeeklySchedule as a1, WorkflowCriticalityEnum as a2, type WorkflowFilter as a3, type WorkflowGroupFilter as a4, type WorkflowIdentifierOrId as a5, type ConnectionMode as a6, InboxService as a7, NovuEventEmitter as a8, type Session as a9, type Result as aa, ScheduleCache as ab, type UpdateScheduleArgs as ac, PreferencesCache as ad, type ListPreferencesArgs as ae, type BasePreferenceArgs as af, type InstancePreferenceArgs as ag, type ListNotificationsArgs as ah, type FilterCountArgs as ai, type FilterCountResponse as aj, type FiltersCountArgs as ak, type BaseArgs as al, type InstanceArgs as am, type SnoozeArgs as an, SubscriptionsCache as ao, type Options as ap, type EventNames as aq, type ContextValue as ar, type BaseUpdateSubscriptionArgs as b, type ChannelEndpointResponse as c, type ChannelPreference as d, ChannelType as e, type Context as f, type CreateChannelConnectionArgs as g, type CreateChannelEndpointArgs as h, type CreateSubscriptionArgs as i, type DefaultSchedule as j, type DeleteChannelConnectionArgs as k, type DeleteChannelEndpointArgs as l, type DeleteSubscriptionArgs as m, type Events as n, type GetChannelConnectionArgs as o, type GetChannelEndpointArgs as p, type GetSubscriptionArgs as q, type InstanceDeleteSubscriptionArgs as r, type InstanceUpdateSubscriptionArgs as s, type ListChannelEndpointsArgs as t, type ListNotificationsResponse as u, type ListSubscriptionsArgs as v, NotificationStatus as w, NovuError as x, type NovuOptions as y, type NovuSocketOptions as z };
+export { type UpdateSubscriptionPreferenceArgs as $, type PreferenceFilter as A, type BaseDeleteSubscriptionArgs as B, type ChannelConnectionResponse as C, type DaySchedule as D, type EventHandler as E, type FiltersCountResponse as F, type GenerateChatOAuthUrlArgs as G, PreferenceLevel as H, type InboxNotification as I, type PreferencesResponse as J, Schedule as K, type ListChannelConnectionsArgs as L, type SocketEventNames as M, Notification as N, type SocketTypeOption as O, Preference as P, type StandardNovuOptions as Q, type Subscriber as R, SeverityLevelEnum as S, type TagsFilter as T, SubscriptionPreference as U, type TagsFilterAndForm as V, type TagsFilterOrGroup as W, type TimeRange as X, TopicSubscription as Y, type UnreadCount as Z, type UpdateSubscriptionArgs as _, type NotificationFilter as a, WebSocketEvent as a0, type WeeklySchedule as a1, WorkflowCriticalityEnum as a2, type WorkflowFilter as a3, type WorkflowGroupFilter as a4, type WorkflowIdentifierOrId as a5, type ConnectionMode as a6, InboxService as a7, NovuEventEmitter as a8, type Session as a9, type Result as aa, ScheduleCache as ab, type UpdateScheduleArgs as ac, PreferencesCache as ad, type ListPreferencesArgs as ae, type BasePreferenceArgs as af, type InstancePreferenceArgs as ag, type ListNotificationsArgs as ah, type FilterCountArgs as ai, type FilterCountResponse as aj, type FiltersCountArgs as ak, type BaseArgs as al, type InstanceArgs as am, type SnoozeArgs as an, type GenerateConnectOAuthUrlArgs as ao, type GenerateLinkUserOAuthUrlArgs as ap, SubscriptionsCache as aq, type Options as ar, type EventNames as as, type ContextValue as at, type BaseUpdateSubscriptionArgs as b, type ChannelEndpointResponse as c, type ChannelPreference as d, ChannelType as e, type Context as f, type CreateChannelConnectionArgs as g, type CreateChannelEndpointArgs as h, type CreateSubscriptionArgs as i, type DefaultSchedule as j, type DeleteChannelConnectionArgs as k, type DeleteChannelEndpointArgs as l, type DeleteSubscriptionArgs as m, type Events as n, type GetChannelConnectionArgs as o, type GetChannelEndpointArgs as p, type GetSubscriptionArgs as q, type InstanceDeleteSubscriptionArgs as r, type InstanceUpdateSubscriptionArgs as s, type ListChannelEndpointsArgs as t, type ListNotificationsResponse as u, type ListSubscriptionsArgs as v, NotificationStatus as w, NovuError as x, type NovuOptions as y, type NovuSocketOptions as z };

package/dist/cjs/index.d.ts

@@ -1,7 +1,7 @@
 export * from 'json-logic-js';
-import { S as SeverityLevelEnum, T as TagsFilter, N as Notification, a as NotificationFilter } from './inbox-service-CEMMLHsX.js';
-export { B as BaseDeleteSubscriptionArgs, b as BaseUpdateSubscriptionArgs, C as ChannelConnectionResponse, c as ChannelEndpointResponse, d as ChannelPreference, e as ChannelType, f as Context, g as CreateChannelConnectionArgs, h as CreateChannelEndpointArgs, i as CreateSubscriptionArgs, D as DaySchedule, j as DefaultSchedule, k as DeleteChannelConnectionArgs, l as DeleteChannelEndpointArgs, m as DeleteSubscriptionArgs, E as EventHandler, n as Events, F as FiltersCountResponse, G as GenerateChatOAuthUrlArgs, o as GetChannelConnectionArgs, p as GetChannelEndpointArgs, q as GetSubscriptionArgs, I as InboxNotification, r as InstanceDeleteSubscriptionArgs, s as InstanceUpdateSubscriptionArgs, L as ListChannelConnectionsArgs, t as ListChannelEndpointsArgs, u as ListNotificationsResponse, v as ListSubscriptionsArgs, w as NotificationStatus, x as NovuError, y as NovuOptions, z as NovuSocketOptions, P as Preference, A as PreferenceFilter, H as PreferenceLevel, J as PreferencesResponse, K as Schedule, M as SocketEventNames, O as SocketTypeOption, Q as StandardNovuOptions, R as Subscriber, U as SubscriptionPreference, V as TagsFilterAndForm, W as TagsFilterOrGroup, X as TimeRange, Y as TopicSubscription, Z as UnreadCount, _ as UpdateSubscriptionArgs, $ as UpdateSubscriptionPreferenceArgs, a0 as WebSocketEvent, a1 as WeeklySchedule, a2 as WorkflowCriticalityEnum, a3 as WorkflowFilter, a4 as WorkflowGroupFilter, a5 as WorkflowIdentifierOrId } from './inbox-service-CEMMLHsX.js';
-export { N as Novu } from './novu-ChPiHuXt.js';
+import { S as SeverityLevelEnum, T as TagsFilter, N as Notification, a as NotificationFilter } from './inbox-service-CGCuuYnv.js';
+export { B as BaseDeleteSubscriptionArgs, b as BaseUpdateSubscriptionArgs, C as ChannelConnectionResponse, c as ChannelEndpointResponse, d as ChannelPreference, e as ChannelType, f as Context, g as CreateChannelConnectionArgs, h as CreateChannelEndpointArgs, i as CreateSubscriptionArgs, D as DaySchedule, j as DefaultSchedule, k as DeleteChannelConnectionArgs, l as DeleteChannelEndpointArgs, m as DeleteSubscriptionArgs, E as EventHandler, n as Events, F as FiltersCountResponse, G as GenerateChatOAuthUrlArgs, o as GetChannelConnectionArgs, p as GetChannelEndpointArgs, q as GetSubscriptionArgs, I as InboxNotification, r as InstanceDeleteSubscriptionArgs, s as InstanceUpdateSubscriptionArgs, L as ListChannelConnectionsArgs, t as ListChannelEndpointsArgs, u as ListNotificationsResponse, v as ListSubscriptionsArgs, w as NotificationStatus, x as NovuError, y as NovuOptions, z as NovuSocketOptions, P as Preference, A as PreferenceFilter, H as PreferenceLevel, J as PreferencesResponse, K as Schedule, M as SocketEventNames, O as SocketTypeOption, Q as StandardNovuOptions, R as Subscriber, U as SubscriptionPreference, V as TagsFilterAndForm, W as TagsFilterOrGroup, X as TimeRange, Y as TopicSubscription, Z as UnreadCount, _ as UpdateSubscriptionArgs, $ as UpdateSubscriptionPreferenceArgs, a0 as WebSocketEvent, a1 as WeeklySchedule, a2 as WorkflowCriticalityEnum, a3 as WorkflowFilter, a4 as WorkflowGroupFilter, a5 as WorkflowIdentifierOrId } from './inbox-service-CGCuuYnv.js';
+export { N as Novu } from './novu-CmNBco-0.js';
 
 /**
  * Normalizes inbox tag filters to CNF: `string[][]` where each inner array is one OR-group.
@@ -11,6 +11,19 @@ declare function normalizeTagGroups(tags: TagsFilter | undefined): string[][];
 declare const areTagsEqual: (tags1?: TagsFilter, tags2?: TagsFilter) => boolean;
 declare const areSeveritiesEqual: (el1?: SeverityLevelEnum | SeverityLevelEnum[], el2?: SeverityLevelEnum | SeverityLevelEnum[]) => boolean;
 declare const isSameFilter: (filter1: NotificationFilter, filter2: NotificationFilter) => boolean;
+/**
+ * Check whether a notification's `data` matches the supplied filter shape.
+ *
+ * Supports per-key:
+ *   - scalar (exact equality)
+ *   - `Scalar[]` (OR — match any)
+ *   - `{ or: Scalar[] }` (explicit OR)
+ *   - `{ and: [{ or: Scalar[] }, ...] }` (AND of OR-groups)
+ *   - 1 level of nested objects whose sub-keys follow the same rules
+ *
+ * Mirrors the server-side semantics from `@novu/shared#checkDataFilterMatches`
+ * so realtime, cache, and counts stay consistent.
+ */
 declare function checkNotificationDataFilter(notificationData: Notification['data'], filterData: NotificationFilter['data']): boolean;
 /**
  * Complete notification filter check combining all criteria.

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk6I5A5OGE_js = require('./chunk-6I5A5OGE.js');
+var chunkN6G6IRD4_js = require('./chunk-N6G6IRD4.js');
 var chunkWDGG3OER_js = require('./chunk-WDGG3OER.js');
 require('./chunk-7B52C2XE.js');
 
@@ -8,39 +8,39 @@ require('./chunk-7B52C2XE.js');
 
 Object.defineProperty(exports, "Novu", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.Novu; }
+  get: function () { return chunkN6G6IRD4_js.Novu; }
 });
 Object.defineProperty(exports, "SubscriptionPreference", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.SubscriptionPreference; }
+  get: function () { return chunkN6G6IRD4_js.SubscriptionPreference; }
 });
 Object.defineProperty(exports, "TopicSubscription", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.TopicSubscription; }
+  get: function () { return chunkN6G6IRD4_js.TopicSubscription; }
 });
 Object.defineProperty(exports, "areSeveritiesEqual", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.areSeveritiesEqual; }
+  get: function () { return chunkN6G6IRD4_js.areSeveritiesEqual; }
 });
 Object.defineProperty(exports, "areTagsEqual", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.areTagsEqual; }
+  get: function () { return chunkN6G6IRD4_js.areTagsEqual; }
 });
 Object.defineProperty(exports, "checkNotificationDataFilter", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.checkNotificationDataFilter; }
+  get: function () { return chunkN6G6IRD4_js.checkNotificationDataFilter; }
 });
 Object.defineProperty(exports, "checkNotificationMatchesFilter", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.checkNotificationMatchesFilter; }
+  get: function () { return chunkN6G6IRD4_js.checkNotificationMatchesFilter; }
 });
 Object.defineProperty(exports, "isSameFilter", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.isSameFilter; }
+  get: function () { return chunkN6G6IRD4_js.isSameFilter; }
 });
 Object.defineProperty(exports, "normalizeTagGroups", {
   enumerable: true,
-  get: function () { return chunk6I5A5OGE_js.normalizeTagGroups; }
+  get: function () { return chunkN6G6IRD4_js.normalizeTagGroups; }
 });
 Object.defineProperty(exports, "ChannelType", {
   enumerable: true,

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

@@ -1,4 +1,4 @@
-import { f as Context, R as Subscriber, a8 as NovuEventEmitter, a7 as InboxService, I as InboxNotification, N as Notification } from '../inbox-service-CEMMLHsX.js';
+import { f as Context, R as Subscriber, a8 as NovuEventEmitter, a7 as InboxService, I as InboxNotification, N as Notification } from '../inbox-service-CGCuuYnv.js';
 import 'json-logic-js';
 
 /**

package/dist/{esm/novu-BlonRpYH.d.mts → cjs/novu-CmNBco-0.d.ts}

@@ -1,4 +1,4 @@
-import { a7 as InboxService, a8 as NovuEventEmitter, a9 as Session, aa as Result, ab as ScheduleCache, K as Schedule, ac as UpdateScheduleArgs, ad as PreferencesCache, ae as ListPreferencesArgs, P as Preference, af as BasePreferenceArgs, ag as InstancePreferenceArgs, ah as ListNotificationsArgs, u as ListNotificationsResponse, I as InboxNotification, N as Notification, a as NotificationFilter, ai as FilterCountArgs, aj as FilterCountResponse, ak as FiltersCountArgs, F as FiltersCountResponse, al as BaseArgs, am as InstanceArgs, an as SnoozeArgs, G as GenerateChatOAuthUrlArgs, L as ListChannelConnectionsArgs, C as ChannelConnectionResponse, o as GetChannelConnectionArgs, k as DeleteChannelConnectionArgs, t as ListChannelEndpointsArgs, c as ChannelEndpointResponse, p as GetChannelEndpointArgs, h as CreateChannelEndpointArgs, l as DeleteChannelEndpointArgs, ao as SubscriptionsCache, R as Subscriber, v as ListSubscriptionsArgs, ap as Options, Y as TopicSubscription, q as GetSubscriptionArgs, i as CreateSubscriptionArgs, b as BaseUpdateSubscriptionArgs, s as InstanceUpdateSubscriptionArgs, B as BaseDeleteSubscriptionArgs, r as InstanceDeleteSubscriptionArgs, M as SocketEventNames, aq as EventNames, E as EventHandler, n as Events, ar as ContextValue, y as NovuOptions, f as Context } from './inbox-service-CEMMLHsX.mjs';
+import { a7 as InboxService, a8 as NovuEventEmitter, a9 as Session, aa as Result, ab as ScheduleCache, K as Schedule, ac as UpdateScheduleArgs, ad as PreferencesCache, ae as ListPreferencesArgs, P as Preference, af as BasePreferenceArgs, ag as InstancePreferenceArgs, ah as ListNotificationsArgs, u as ListNotificationsResponse, I as InboxNotification, N as Notification, a as NotificationFilter, ai as FilterCountArgs, aj as FilterCountResponse, ak as FiltersCountArgs, F as FiltersCountResponse, al as BaseArgs, am as InstanceArgs, an as SnoozeArgs, G as GenerateChatOAuthUrlArgs, ao as GenerateConnectOAuthUrlArgs, L as ListChannelConnectionsArgs, C as ChannelConnectionResponse, o as GetChannelConnectionArgs, k as DeleteChannelConnectionArgs, ap as GenerateLinkUserOAuthUrlArgs, t as ListChannelEndpointsArgs, c as ChannelEndpointResponse, p as GetChannelEndpointArgs, h as CreateChannelEndpointArgs, l as DeleteChannelEndpointArgs, aq as SubscriptionsCache, R as Subscriber, v as ListSubscriptionsArgs, ar as Options, Y as TopicSubscription, q as GetSubscriptionArgs, i as CreateSubscriptionArgs, b as BaseUpdateSubscriptionArgs, s as InstanceUpdateSubscriptionArgs, B as BaseDeleteSubscriptionArgs, r as InstanceDeleteSubscriptionArgs, M as SocketEventNames, as as EventNames, E as EventHandler, n as Events, at as ContextValue, y as NovuOptions, f as Context } from './inbox-service-CGCuuYnv.js';
 
 declare class BaseModule {
     #private;
@@ -135,9 +135,15 @@ declare class ChannelConnections extends BaseModule {
         inboxServiceInstance: InboxService;
         eventEmitterInstance: NovuEventEmitter;
     });
+    /**
+     * @deprecated Use generateConnectOAuthUrl() instead. For user-level linking use channelEndpoints.generateLinkUserOAuthUrl().
+     */
     generateOAuthUrl(args: GenerateChatOAuthUrlArgs): Result<{
         url: string;
     }>;
+    generateConnectOAuthUrl(args: GenerateConnectOAuthUrlArgs): Result<{
+        url: string;
+    }>;
     list(args?: ListChannelConnectionsArgs): Result<ChannelConnectionResponse[]>;
     get(args: GetChannelConnectionArgs): Result<ChannelConnectionResponse | null>;
     delete(args: DeleteChannelConnectionArgs): Result<void>;
@@ -148,6 +154,9 @@ declare class ChannelEndpoints extends BaseModule {
         inboxServiceInstance: InboxService;
         eventEmitterInstance: NovuEventEmitter;
     });
+    generateLinkUserOAuthUrl(args: GenerateLinkUserOAuthUrlArgs): Result<{
+        url: string;
+    }>;
     list(args?: ListChannelEndpointsArgs): Result<ChannelEndpointResponse[]>;
     get(args: GetChannelEndpointArgs): Result<ChannelEndpointResponse | null>;
     create(args: CreateChannelEndpointArgs): Result<ChannelEndpointResponse>;

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

@@ -1,7 +1,7 @@
-import { L as InboxTheme, a3 as SubscriptionTheme } from '../types-CPxEgcM4.js';
-import '../inbox-service-CEMMLHsX.js';
+import { L as InboxTheme, a6 as SubscriptionTheme } from '../types-BF6zvyj6.js';
+import '../inbox-service-CGCuuYnv.js';
 import 'json-logic-js';
-import '../novu-ChPiHuXt.js';
+import '../novu-CmNBco-0.js';
 
 declare const inboxDarkTheme: InboxTheme;
 /**