@novu/js 3.17.0 → 3.18.0

package/dist/esm/{chunk-4S22IB5W.mjs → chunk-T3NTOGY3.mjs}

@@ -1,4 +1,4 @@
-import { __async, __spreadProps, __spreadValues, __privateAdd, __privateSet, __privateGet } from './chunk-STZMOEWR.mjs';
+import { __privateAdd, __privateSet, __privateGet, __async, __spreadProps, __spreadValues } from './chunk-3LR3AF54.mjs';
 
 // src/ui/internal/buildContextKey.ts
 function buildContextKey(context) {
@@ -93,7 +93,193 @@ var NovuError = class extends Error {
   }
 };
 
+// src/notifications/notification.ts
+var _emitter, _inboxService;
+var Notification = class {
+  constructor(notification, emitter, inboxService) {
+    __privateAdd(this, _emitter);
+    __privateAdd(this, _inboxService);
+    __privateSet(this, _emitter, emitter);
+    __privateSet(this, _inboxService, inboxService);
+    this.id = notification.id;
+    this.transactionId = notification.transactionId;
+    this.subject = notification.subject;
+    this.body = notification.body;
+    this.to = notification.to;
+    this.isRead = notification.isRead;
+    this.isSeen = notification.isSeen;
+    this.isArchived = notification.isArchived;
+    this.isSnoozed = notification.isSnoozed;
+    this.snoozedUntil = notification.snoozedUntil;
+    this.deliveredAt = notification.deliveredAt;
+    this.createdAt = notification.createdAt;
+    this.readAt = notification.readAt;
+    this.firstSeenAt = notification.firstSeenAt;
+    this.archivedAt = notification.archivedAt;
+    this.avatar = notification.avatar;
+    this.primaryAction = notification.primaryAction;
+    this.secondaryAction = notification.secondaryAction;
+    this.channelType = notification.channelType;
+    this.tags = notification.tags;
+    this.redirect = notification.redirect;
+    this.data = notification.data;
+    this.workflow = notification.workflow;
+    this.severity = notification.severity;
+  }
+  read() {
+    return read({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      }
+    });
+  }
+  unread() {
+    return unread({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      }
+    });
+  }
+  seen() {
+    return seen({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      }
+    });
+  }
+  archive() {
+    return archive({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      }
+    });
+  }
+  unarchive() {
+    return unarchive({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      }
+    });
+  }
+  delete() {
+    return deleteNotification({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      }
+    });
+  }
+  snooze(snoozeUntil) {
+    return snooze({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this,
+        snoozeUntil
+      }
+    });
+  }
+  unsnooze() {
+    return unsnooze({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: { notification: this }
+    });
+  }
+  completePrimary() {
+    if (!this.primaryAction) {
+      throw new Error("Primary action is not available");
+    }
+    return completeAction({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      },
+      actionType: "primary" /* PRIMARY */
+    });
+  }
+  completeSecondary() {
+    if (!this.primaryAction) {
+      throw new Error("Secondary action is not available");
+    }
+    return completeAction({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      },
+      actionType: "secondary" /* SECONDARY */
+    });
+  }
+  revertPrimary() {
+    if (!this.primaryAction) {
+      throw new Error("Primary action is not available");
+    }
+    return revertAction({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      },
+      actionType: "primary" /* PRIMARY */
+    });
+  }
+  revertSecondary() {
+    if (!this.primaryAction) {
+      throw new Error("Secondary action is not available");
+    }
+    return revertAction({
+      emitter: __privateGet(this, _emitter),
+      apiService: __privateGet(this, _inboxService),
+      args: {
+        notification: this
+      },
+      actionType: "secondary" /* SECONDARY */
+    });
+  }
+  on(eventName, listener) {
+    const cleanup = __privateGet(this, _emitter).on(eventName, listener);
+    return () => {
+      cleanup();
+    };
+  }
+  /**
+   * @deprecated
+   * Use the cleanup function returned by the "on" method instead.
+   */
+  off(eventName, listener) {
+    __privateGet(this, _emitter).off(eventName, listener);
+  }
+};
+_emitter = new WeakMap();
+_inboxService = new WeakMap();
+
 // src/notifications/helpers.ts
+function ensureNotificationInstance({
+  notification,
+  emitter,
+  inboxService
+}) {
+  if (notification instanceof Notification) {
+    return notification;
+  }
+  if (typeof notification.read === "function") {
+    return notification;
+  }
+  return new Notification(notification, emitter, inboxService);
+}
 var read = (_0) => __async(null, [_0], function* ({
   emitter,
   apiService,
@@ -561,186 +747,17 @@ var deleteAll = (_0) => __async(null, [_0], function* ({
   }
 });
 
-// src/notifications/notification.ts
-var _emitter, _inboxService;
-var Notification = class {
-  constructor(notification, emitter, inboxService) {
-    __privateAdd(this, _emitter);
-    __privateAdd(this, _inboxService);
-    __privateSet(this, _emitter, emitter);
-    __privateSet(this, _inboxService, inboxService);
-    this.id = notification.id;
-    this.transactionId = notification.transactionId;
-    this.subject = notification.subject;
-    this.body = notification.body;
-    this.to = notification.to;
-    this.isRead = notification.isRead;
-    this.isSeen = notification.isSeen;
-    this.isArchived = notification.isArchived;
-    this.isSnoozed = notification.isSnoozed;
-    this.snoozedUntil = notification.snoozedUntil;
-    this.deliveredAt = notification.deliveredAt;
-    this.createdAt = notification.createdAt;
-    this.readAt = notification.readAt;
-    this.firstSeenAt = notification.firstSeenAt;
-    this.archivedAt = notification.archivedAt;
-    this.avatar = notification.avatar;
-    this.primaryAction = notification.primaryAction;
-    this.secondaryAction = notification.secondaryAction;
-    this.channelType = notification.channelType;
-    this.tags = notification.tags;
-    this.redirect = notification.redirect;
-    this.data = notification.data;
-    this.workflow = notification.workflow;
-    this.severity = notification.severity;
-  }
-  read() {
-    return read({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      }
-    });
-  }
-  unread() {
-    return unread({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      }
-    });
-  }
-  seen() {
-    return seen({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      }
-    });
-  }
-  archive() {
-    return archive({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      }
-    });
-  }
-  unarchive() {
-    return unarchive({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      }
-    });
-  }
-  delete() {
-    return deleteNotification({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      }
-    });
-  }
-  snooze(snoozeUntil) {
-    return snooze({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this,
-        snoozeUntil
-      }
-    });
-  }
-  unsnooze() {
-    return unsnooze({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: { notification: this }
-    });
-  }
-  completePrimary() {
-    if (!this.primaryAction) {
-      throw new Error("Primary action is not available");
-    }
-    return completeAction({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      },
-      actionType: "primary" /* PRIMARY */
-    });
-  }
-  completeSecondary() {
-    if (!this.primaryAction) {
-      throw new Error("Secondary action is not available");
-    }
-    return completeAction({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      },
-      actionType: "secondary" /* SECONDARY */
-    });
-  }
-  revertPrimary() {
-    if (!this.primaryAction) {
-      throw new Error("Primary action is not available");
-    }
-    return revertAction({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      },
-      actionType: "primary" /* PRIMARY */
-    });
-  }
-  revertSecondary() {
-    if (!this.primaryAction) {
-      throw new Error("Secondary action is not available");
-    }
-    return revertAction({
-      emitter: __privateGet(this, _emitter),
-      apiService: __privateGet(this, _inboxService),
-      args: {
-        notification: this
-      },
-      actionType: "secondary" /* SECONDARY */
-    });
-  }
-  on(eventName, listener) {
-    const cleanup = __privateGet(this, _emitter).on(eventName, listener);
-    return () => {
-      cleanup();
-    };
-  }
-  /**
-   * @deprecated
-   * Use the cleanup function returned by the "on" method instead.
-   */
-  off(eventName, listener) {
-    __privateGet(this, _emitter).off(eventName, listener);
-  }
-};
-_emitter = new WeakMap();
-_inboxService = new WeakMap();
-
 // src/ui/internal/createNotification.ts
 function createNotification({
   emitter,
   inboxService,
   notification
 }) {
-  return new Notification(notification, emitter, inboxService);
+  return ensureNotificationInstance({
+    notification,
+    emitter,
+    inboxService
+  });
 }
 
 // src/ui/internal/parseMarkdown.tsx
@@ -799,4 +816,4 @@ var parseMarkdownIntoTokens = (text) => {
   return tokens;
 };
 
-export { ChannelType, Notification, NotificationStatus, NovuError, PreferenceLevel, SeverityLevelEnum, WebSocketEvent, WorkflowCriticalityEnum, archive, archiveAll, archiveAllRead, buildContextKey, buildSubscriber, buildSubscriptionIdentifier, completeAction, createNotification, deleteAll, deleteNotification, parseMarkdownIntoTokens, read, readAll, revertAction, seen, seenAll, snooze, unarchive, unread, unsnooze };
+export { ChannelType, Notification, NotificationStatus, NovuError, PreferenceLevel, SeverityLevelEnum, WebSocketEvent, WorkflowCriticalityEnum, archive, archiveAll, archiveAllRead, buildContextKey, buildSubscriber, buildSubscriptionIdentifier, completeAction, createNotification, deleteAll, deleteNotification, ensureNotificationInstance, parseMarkdownIntoTokens, read, readAll, revertAction, seen, seenAll, snooze, unarchive, unread, unsnooze };

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

@@ -301,6 +301,7 @@ type ChannelEndpointsFetchEvents = BaseEvents<'channel-endpoints.list', ListChan
 type ChannelEndpointGetEvents = BaseEvents<'channel-endpoint.get', GetChannelEndpointArgs, ChannelEndpointResponse | null>;
 type ChannelEndpointCreateEvents = BaseEvents<'channel-endpoint.create', CreateChannelEndpointArgs, ChannelEndpointResponse>;
 type ChannelEndpointDeleteEvents = BaseEvents<'channel-endpoint.delete', DeleteChannelEndpointArgs, void>;
+type ChannelEndpointLinkEvents = BaseEvents<'channel-endpoint.link', LinkChannelEndpointArgs, LinkChannelEndpointResponse>;
 type SocketConnectEvents = BaseEvents<'socket.connect', {
     socketUrl: string;
 }, undefined>;
@@ -354,7 +355,7 @@ type Events = SessionInitializeEvents & NotificationsFetchEvents & {
             subscriptions: TopicSubscription[];
         };
     };
-} & 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;
+} & ChannelConnectionOAuthUrlEvents & ChannelConnectionsFetchEvents & ChannelConnectionGetEvents & ChannelConnectionDeleteEvents & ChannelEndpointOAuthUrlEvents & ChannelEndpointsFetchEvents & ChannelEndpointGetEvents & ChannelEndpointCreateEvents & ChannelEndpointDeleteEvents & ChannelEndpointLinkEvents & 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;
@@ -864,6 +865,20 @@ type CreateChannelEndpointArgs = {
 type DeleteChannelEndpointArgs = {
     identifier: string;
 };
+/**
+ * Args for issuing a provider-specific URL the subscriber opens to link their
+ * chat identity (e.g. a Telegram `t.me` deep link). The subscriber is derived
+ * from the session token, so only the integration identifier is required.
+ */
+type LinkChannelEndpointArgs = {
+    integrationIdentifier: string;
+};
+type LinkChannelEndpointResponse = {
+    /** URL the subscriber opens to link their chat identity (deep link or OAuth URL). */
+    url: string;
+    /** Provider-specific metadata returned alongside the link URL (e.g. Telegram `botUsername`, `expiresAt`). */
+    providerMetadata?: Record<string, unknown>;
+};
 
 type InboxServiceOptions = HttpClientOptions;
 declare class InboxService {
@@ -1038,6 +1053,7 @@ declare class InboxService {
     getChannelEndpoint(identifier: string): Promise<ChannelEndpointResponse>;
     createChannelEndpoint({ identifier, integrationIdentifier, connectionIdentifier, subscriberId, context, type, endpoint, }: CreateChannelEndpointArgs): Promise<ChannelEndpointResponse>;
     deleteChannelEndpoint(identifier: string): Promise<void>;
+    linkChannelEndpoint({ integrationIdentifier }: LinkChannelEndpointArgs): Promise<LinkChannelEndpointResponse>;
 }
 
-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 };
+export { type UnreadCount as $, type NovuOptions 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, type NovuSocketOptions as H, type InboxNotification as I, type PreferenceFilter as J, PreferenceLevel as K, type LinkChannelEndpointArgs as L, type PreferencesResponse as M, Notification as N, Schedule as O, Preference as P, type SocketEventNames as Q, type SocketTypeOption as R, SeverityLevelEnum as S, type TagsFilter as T, type StandardNovuOptions as U, type Subscriber as V, SubscriptionPreference as W, type TagsFilterAndForm as X, type TagsFilterOrGroup as Y, type TimeRange as Z, TopicSubscription as _, type NotificationFilter as a, type UpdateSubscriptionArgs as a0, type UpdateSubscriptionPreferenceArgs as a1, WebSocketEvent as a2, type WeeklySchedule as a3, WorkflowCriticalityEnum as a4, type WorkflowFilter as a5, type WorkflowGroupFilter as a6, type WorkflowIdentifierOrId as a7, type ConnectionMode as a8, InboxService as a9, NovuEventEmitter as aa, type Session as ab, type Result as ac, ScheduleCache as ad, type UpdateScheduleArgs as ae, PreferencesCache as af, type ListPreferencesArgs as ag, type BasePreferenceArgs as ah, type InstancePreferenceArgs as ai, type ListNotificationsArgs as aj, type FilterCountArgs as ak, type FilterCountResponse as al, type FiltersCountArgs as am, type BaseArgs as an, type InstanceArgs as ao, type SnoozeArgs as ap, type GenerateConnectOAuthUrlArgs as aq, type GenerateLinkUserOAuthUrlArgs as ar, SubscriptionsCache as as, type Options as at, type EventNames as au, type ContextValue as av, 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 LinkChannelEndpointResponse as t, type ListChannelConnectionsArgs as u, type ListChannelEndpointsArgs as v, type ListNotificationsResponse as w, type ListSubscriptionsArgs as x, NotificationStatus as y, NovuError as z };

package/dist/esm/index.d.mts

@@ -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-CGCuuYnv.mjs';
-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.mjs';
-export { N as Novu } from './novu-CFYEiYN8.mjs';
+import { S as SeverityLevelEnum, T as TagsFilter, N as Notification, a as NotificationFilter } from './inbox-service-DSSwFYNG.mjs';
+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 LinkChannelEndpointArgs, t as LinkChannelEndpointResponse, u as ListChannelConnectionsArgs, v as ListChannelEndpointsArgs, w as ListNotificationsResponse, x as ListSubscriptionsArgs, y as NotificationStatus, z as NovuError, A as NovuOptions, H as NovuSocketOptions, P as Preference, J as PreferenceFilter, K as PreferenceLevel, M as PreferencesResponse, O as Schedule, Q as SocketEventNames, R as SocketTypeOption, U as StandardNovuOptions, V as Subscriber, W as SubscriptionPreference, X as TagsFilterAndForm, Y as TagsFilterOrGroup, Z as TimeRange, _ as TopicSubscription, $ as UnreadCount, a0 as UpdateSubscriptionArgs, a1 as UpdateSubscriptionPreferenceArgs, a2 as WebSocketEvent, a3 as WeeklySchedule, a4 as WorkflowCriticalityEnum, a5 as WorkflowFilter, a6 as WorkflowGroupFilter, a7 as WorkflowIdentifierOrId } from './inbox-service-DSSwFYNG.mjs';
+export { N as Novu } from './novu-Z0z0-IxO.mjs';
 
 /**
  * Normalizes inbox tag filters to CNF: `string[][]` where each inner array is one OR-group.
@@ -31,4 +31,93 @@ declare function checkNotificationDataFilter(notificationData: Notification['dat
  */
 declare function checkNotificationMatchesFilter(notification: Notification, filter: NotificationFilter): boolean;
 
-export { Notification, NotificationFilter, SeverityLevelEnum, TagsFilter, areSeveritiesEqual, areTagsEqual, checkNotificationDataFilter, checkNotificationMatchesFilter, isSameFilter, normalizeTagGroups };
+declare const NOTIFICATION_COUNT_SYNC_EVENTS: readonly ["notification.read.resolved", "notification.unread.resolved", "notification.seen.resolved", "notification.archive.resolved", "notification.unarchive.resolved", "notification.snooze.resolved", "notification.unsnooze.resolved", "notification.delete.resolved", "notifications.read_all.resolved", "notifications.seen_all.resolved", "notifications.archive_all.resolved", "notifications.archive_all_read.resolved", "notifications.delete_all.resolved"];
+
+type TelegramSubscriberLinkStatus = 'loading' | 'pending' | 'connected' | 'expired';
+type TelegramSubscriberLinkResponse = {
+    deepLinkUrl: string;
+    botUsername: string;
+    expiresAt: string;
+};
+type TelegramSubscriberLinkOptions = {
+    /**
+     * Base URL of the Novu API (or your backend proxy).
+     * Defaults to `https://api.novu.co`.
+     */
+    apiUrl?: string;
+    /**
+     * Novu server-side secret key (`Authorization: ApiKey <key>`).
+     * Required when calling the Novu API directly.
+     * Omit when routing through a backend proxy that injects its own auth.
+     */
+    secretKey?: string;
+    /** Integration identifier (the `identifier` field on the Telegram integration, not `_id`). */
+    integrationIdentifier: string;
+    /** External subscriber ID to link to the Telegram chat. */
+    subscriberId: string;
+    /**
+     * Polling interval in milliseconds to check for connection confirmation.
+     * Defaults to `2000` (2 seconds).
+     */
+    pollIntervalMs?: number;
+    /**
+     * Custom fetch function. Defaults to the global `fetch`.
+     * Useful for injecting auth headers in a backend-proxy scenario.
+     */
+    fetchFn?: typeof fetch;
+};
+type TelegramSubscriberLinkState = {
+    status: TelegramSubscriberLinkStatus;
+    deepLinkUrl: string | null;
+    botUsername: string | null;
+    expiresAt: string | null;
+    error: Error | null;
+};
+
+type StateListener = (state: TelegramSubscriberLinkState) => void;
+/**
+ * Framework-agnostic helper that manages the full Telegram subscriber-link
+ * lifecycle: issue a deep link, poll for the subscriber's `/start` tap, and
+ * re-issue automatically when the 10-minute code expires.
+ *
+ * **Important:** The subscriber-link endpoint requires `INTEGRATION_WRITE`
+ * permission and must be called from a trusted server or via a backend proxy —
+ * never directly from an untrusted browser with end-user credentials.
+ *
+ * @example
+ * ```ts
+ * import { TelegramSubscriberLink } from '@novu/js';
+ *
+ * const link = new TelegramSubscriberLink({
+ *   secretKey: process.env.NOVU_SECRET_KEY,
+ *   integrationIdentifier: '<telegram-integration-identifier>',
+ *   subscriberId: 'user-42',
+ * });
+ *
+ * link.onStateChange((state) => {
+ *   console.log(state.status, state.deepLinkUrl);
+ * });
+ *
+ * await link.start();
+ * // … later …
+ * link.stop();
+ * ```
+ */
+declare class TelegramSubscriberLink {
+    #private;
+    constructor(options: TelegramSubscriberLinkOptions);
+    get state(): Readonly<TelegramSubscriberLinkState>;
+    onStateChange(listener: StateListener): () => void;
+    /**
+     * Check whether the subscriber is already connected; if not, issue a deep
+     * link and begin polling for connection. Call {@link stop} to cancel polling
+     * and timers.
+     */
+    start(): Promise<void>;
+    /** Re-issue a fresh deep link (e.g. after expiry or on-demand refresh). */
+    refresh(): Promise<void>;
+    /** Stop all polling and expiry timers. */
+    stop(): void;
+}
+
+export { NOTIFICATION_COUNT_SYNC_EVENTS, Notification, NotificationFilter, SeverityLevelEnum, TagsFilter, TelegramSubscriberLink, type TelegramSubscriberLinkOptions, type TelegramSubscriberLinkResponse, type TelegramSubscriberLinkState, type TelegramSubscriberLinkStatus, areSeveritiesEqual, areTagsEqual, checkNotificationDataFilter, checkNotificationMatchesFilter, isSameFilter, normalizeTagGroups };