@dudousxd/nestjs-notifications-sse 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Sse, SseChannel, type SseChannelOptions, type SseNotification, } from './sse.channel';
+export { SseHub } from './sse.hub';
+export { SseChannelModule, type SseChannelModuleOptions } from './sse.module';
+export { SSE_OPTIONS } from './tokens';
+export { sseKey } from './sse-key';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,GAAG,EACH,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sseKey = exports.SSE_OPTIONS = exports.SseChannelModule = exports.SseHub = exports.SseChannel = exports.Sse = void 0;
+var sse_channel_1 = require("./sse.channel");
+Object.defineProperty(exports, "Sse", { enumerable: true, get: function () { return sse_channel_1.Sse; } });
+Object.defineProperty(exports, "SseChannel", { enumerable: true, get: function () { return sse_channel_1.SseChannel; } });
+var sse_hub_1 = require("./sse.hub");
+Object.defineProperty(exports, "SseHub", { enumerable: true, get: function () { return sse_hub_1.SseHub; } });
+var sse_module_1 = require("./sse.module");
+Object.defineProperty(exports, "SseChannelModule", { enumerable: true, get: function () { return sse_module_1.SseChannelModule; } });
+var tokens_1 = require("./tokens");
+Object.defineProperty(exports, "SSE_OPTIONS", { enumerable: true, get: function () { return tokens_1.SSE_OPTIONS; } });
+var sse_key_1 = require("./sse-key");
+Object.defineProperty(exports, "sseKey", { enumerable: true, get: function () { return sse_key_1.sseKey; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAKuB;AAJrB,kGAAA,GAAG,OAAA;AACH,yGAAA,UAAU,OAAA;AAIZ,qCAAmC;AAA1B,iGAAA,MAAM,OAAA;AACf,2CAA8E;AAArE,8GAAA,gBAAgB,OAAA;AACzB,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AACpB,qCAAmC;AAA1B,iGAAA,MAAM,OAAA"}

package/dist/sse-key.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build the stream key the {@link SseChannel} publishes under, so a controller's
+ * `@Sse()` endpoint can subscribe to the exact same key.
+ *
+ * Keys are tenant-aware: when `tenant` is set, the route value is prefixed with
+ * `${tenant}:` so a user's stream is isolated per tenant.
+ *
+ * ```ts
+ * const key = sseKey(req.tenantId, String(req.user.id));
+ * return hub.stream(key);
+ * ```
+ */
+export declare function sseKey(tenant: string | undefined, routeValue: string): string;
+//# sourceMappingURL=sse-key.d.ts.map

package/dist/sse-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-key.d.ts","sourceRoot":"","sources":["../src/sse-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7E"}

package/dist/sse-key.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sseKey = sseKey;
+/**
+ * Build the stream key the {@link SseChannel} publishes under, so a controller's
+ * `@Sse()` endpoint can subscribe to the exact same key.
+ *
+ * Keys are tenant-aware: when `tenant` is set, the route value is prefixed with
+ * `${tenant}:` so a user's stream is isolated per tenant.
+ *
+ * ```ts
+ * const key = sseKey(req.tenantId, String(req.user.id));
+ * return hub.stream(key);
+ * ```
+ */
+function sseKey(tenant, routeValue) {
+    return tenant ? `${tenant}:${routeValue}` : routeValue;
+}
+//# sourceMappingURL=sse-key.js.map

package/dist/sse-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-key.js","sourceRoot":"","sources":["../src/sse-key.ts"],"names":[],"mappings":";;AAYA,wBAEC;AAdD;;;;;;;;;;;GAWG;AACH,SAAgB,MAAM,CAAC,MAA0B,EAAE,UAAkB;IACnE,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;AACzD,CAAC"}

package/dist/sse.channel.d.ts

@@ -0,0 +1,47 @@
+import { type ChannelDriver, type DeliveryContext, type Notifiable, type Notification } from '@dudousxd/nestjs-notifications-core';
+import { SseHub } from './sse.hub';
+/** Channel handle: use as `@Sse()` on a payload method, or as a token in `via()`. */
+export declare const Sse: import("@dudousxd/nestjs-notifications-core").ChannelHandle;
+/** Resolved runtime options for the SSE channel. */
+export interface SseChannelOptions {
+    /** SSE event name (`type`) emitted to clients. Defaults to `'notification'`. */
+    event?: string;
+}
+/** Implement this on a notification to define its SSE payload. */
+export interface SseNotification extends Notification {
+    toSse?(notifiable: Notifiable): Record<string, unknown>;
+    toArray?(notifiable: Notifiable): Record<string, unknown>;
+}
+/**
+ * Pushes a notification to the notifiable's Server-Sent Events stream via
+ * {@link SseHub}, using NestJS's native `@Sse()` support. Reads the payload from
+ * `toSse()`, then `toArray()`, then a structural copy of the notification.
+ *
+ * The endpoint is mounted by the consumer, not this package. Subscribe to the
+ * same key the channel publishes to with {@link sseKey}:
+ *
+ * ```ts
+ * import { Sse, type MessageEvent } from '@nestjs/common';
+ * import { SseHub, sseKey } from '@dudousxd/nestjs-notifications-sse';
+ *
+ * @Controller('notifications')
+ * class NotificationsController {
+ *   constructor(private readonly hub: SseHub) {}
+ *
+ *   @Sse('stream')
+ *   stream(@Req() req): Observable<MessageEvent> {
+ *     // build the SAME key the notifiable routes to (tenant-aware)
+ *     return this.hub.stream(sseKey(req.tenantId, String(req.user.id)));
+ *   }
+ * }
+ * ```
+ */
+export declare class SseChannel implements ChannelDriver {
+    private readonly hub;
+    private readonly options;
+    readonly channel = "sse";
+    constructor(hub: SseHub, options: SseChannelOptions);
+    send(notifiable: Notifiable, notification: Notification, context?: DeliveryContext): Promise<void>;
+    private payloadFor;
+}
+//# sourceMappingURL=sse.channel.d.ts.map

package/dist/sse.channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.channel.d.ts","sourceRoot":"","sources":["../src/sse.channel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,EAIlB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,qFAAqF;AACrF,eAAO,MAAM,GAAG,6DAAuB,CAAC;AAExC,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,KAAK,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,UAAW,YAAW,aAAa;IAI5C,OAAO,CAAC,QAAQ,CAAC,GAAG;IAEpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,QAAQ,CAAC,OAAO,SAAS;gBAGN,GAAG,EAAE,MAAM,EAEX,OAAO,EAAE,iBAAiB;IAGvC,IAAI,CACR,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;IAShB,OAAO,CAAC,UAAU;CAUnB"}

package/dist/sse.channel.js

@@ -0,0 +1,78 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseChannel = exports.Sse = void 0;
+const nestjs_notifications_core_1 = require("@dudousxd/nestjs-notifications-core");
+const common_1 = require("@nestjs/common");
+const sse_key_1 = require("./sse-key");
+const sse_hub_1 = require("./sse.hub");
+const tokens_1 = require("./tokens");
+/** Channel handle: use as `@Sse()` on a payload method, or as a token in `via()`. */
+exports.Sse = (0, nestjs_notifications_core_1.createChannel)('sse');
+/**
+ * Pushes a notification to the notifiable's Server-Sent Events stream via
+ * {@link SseHub}, using NestJS's native `@Sse()` support. Reads the payload from
+ * `toSse()`, then `toArray()`, then a structural copy of the notification.
+ *
+ * The endpoint is mounted by the consumer, not this package. Subscribe to the
+ * same key the channel publishes to with {@link sseKey}:
+ *
+ * ```ts
+ * import { Sse, type MessageEvent } from '@nestjs/common';
+ * import { SseHub, sseKey } from '@dudousxd/nestjs-notifications-sse';
+ *
+ * @Controller('notifications')
+ * class NotificationsController {
+ *   constructor(private readonly hub: SseHub) {}
+ *
+ *   @Sse('stream')
+ *   stream(@Req() req): Observable<MessageEvent> {
+ *     // build the SAME key the notifiable routes to (tenant-aware)
+ *     return this.hub.stream(sseKey(req.tenantId, String(req.user.id)));
+ *   }
+ * }
+ * ```
+ */
+let SseChannel = class SseChannel {
+    hub;
+    options;
+    channel = 'sse';
+    constructor(hub, options) {
+        this.hub = hub;
+        this.options = options;
+    }
+    async send(notifiable, notification, context) {
+        const routeValue = String((0, nestjs_notifications_core_1.routeFor)(notifiable, 'sse', notification));
+        const key = (0, sse_key_1.sseKey)(context?.tenant, routeValue);
+        const event = this.options.event ?? 'notification';
+        const payload = this.payloadFor(notifiable, notification);
+        this.hub.publish(key, payload, { event });
+    }
+    payloadFor(notifiable, notification) {
+        const handler = (0, nestjs_notifications_core_1.getHandler)(notification, 'sse', 'toSse');
+        if (handler)
+            return handler(notifiable);
+        if (typeof notification.toArray === 'function')
+            return notification.toArray(notifiable);
+        const { ...rest } = notification;
+        return rest;
+    }
+};
+exports.SseChannel = SseChannel;
+exports.SseChannel = SseChannel = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)(tokens_1.SSE_OPTIONS)),
+    __metadata("design:paramtypes", [sse_hub_1.SseHub, Object])
+], SseChannel);
+//# sourceMappingURL=sse.channel.js.map

package/dist/sse.channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.channel.js","sourceRoot":"","sources":["../src/sse.channel.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,mFAQ6C;AAC7C,2CAAoD;AACpD,uCAAmC;AACnC,uCAAmC;AACnC,qCAAuC;AAEvC,qFAAqF;AACxE,QAAA,GAAG,GAAG,IAAA,yCAAa,EAAC,KAAK,CAAC,CAAC;AAcxC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEI,IAAM,UAAU,GAAhB,MAAM,UAAU;IAIF;IAEA;IALV,OAAO,GAAG,KAAK,CAAC;IAEzB,YACmB,GAAW,EAEX,OAA0B;QAF1B,QAAG,GAAH,GAAG,CAAQ;QAEX,YAAO,GAAP,OAAO,CAAmB;IAC1C,CAAC;IAEJ,KAAK,CAAC,IAAI,CACR,UAAsB,EACtB,YAA0B,EAC1B,OAAyB;QAEzB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAA,oCAAQ,EAAC,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,IAAA,gBAAM,EAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,YAA+B,CAAC,CAAC;QAE7E,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAEO,UAAU,CAChB,UAAsB,EACtB,YAA6B;QAE7B,MAAM,OAAO,GAAG,IAAA,sCAAU,EAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC,UAAU,CAA4B,CAAC;QACnE,IAAI,OAAO,YAAY,CAAC,OAAO,KAAK,UAAU;YAAE,OAAO,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxF,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,YAAkD,CAAC;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AAhCY,gCAAU;qBAAV,UAAU;IADtB,IAAA,mBAAU,GAAE;IAMR,WAAA,IAAA,eAAM,EAAC,oBAAW,CAAC,CAAA;qCADE,gBAAM;GAJnB,UAAU,CAgCtB"}

package/dist/sse.hub.d.ts

@@ -0,0 +1,33 @@
+import { type MessageEvent } from '@nestjs/common';
+import { type Observable } from 'rxjs';
+/**
+ * In-memory fan-out for native NestJS Server-Sent Events. Keeps one
+ * {@link Subject} per stream key; the channel pushes events into it via
+ * {@link SseHub.publish} and a controller's `@Sse()` endpoint reads from it via
+ * {@link SseHub.stream}.
+ *
+ * Each key may have multiple concurrent subscribers (e.g. a user with several
+ * open tabs). The Subject is created lazily on first subscribe and torn down
+ * once the last subscriber unsubscribes.
+ */
+export declare class SseHub {
+    private readonly subjects;
+    private readonly refcounts;
+    /**
+     * Return the live stream for `key` as an Observable. Subscribing creates the
+     * underlying Subject (if absent) and bumps its refcount; unsubscribing
+     * decrements it and removes the Subject once no subscribers remain. Return
+     * this directly from a controller's `@Sse()` method.
+     */
+    stream(key: string): Observable<MessageEvent>;
+    /**
+     * Push a `MessageEvent` to every subscriber of `key`. No-ops when nobody is
+     * listening (no Subject exists), since SSE is fire-and-forget. `options.event`
+     * sets the SSE event `type`.
+     */
+    publish(key: string, data: unknown, options?: {
+        event?: string;
+    }): void;
+    private subjectFor;
+}
+//# sourceMappingURL=sse.hub.d.ts.map

package/dist/sse.hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.hub.d.ts","sourceRoot":"","sources":["../src/sse.hub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,MAAM,CAAC;AAE1D;;;;;;;;;GASG;AACH,qBACa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC;IAkB7C;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAWvE,OAAO,CAAC,UAAU;CAQnB"}

package/dist/sse.hub.js

@@ -0,0 +1,74 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseHub = void 0;
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+/**
+ * In-memory fan-out for native NestJS Server-Sent Events. Keeps one
+ * {@link Subject} per stream key; the channel pushes events into it via
+ * {@link SseHub.publish} and a controller's `@Sse()` endpoint reads from it via
+ * {@link SseHub.stream}.
+ *
+ * Each key may have multiple concurrent subscribers (e.g. a user with several
+ * open tabs). The Subject is created lazily on first subscribe and torn down
+ * once the last subscriber unsubscribes.
+ */
+let SseHub = class SseHub {
+    subjects = new Map();
+    refcounts = new Map();
+    /**
+     * Return the live stream for `key` as an Observable. Subscribing creates the
+     * underlying Subject (if absent) and bumps its refcount; unsubscribing
+     * decrements it and removes the Subject once no subscribers remain. Return
+     * this directly from a controller's `@Sse()` method.
+     */
+    stream(key) {
+        const subject = this.subjectFor(key);
+        this.refcounts.set(key, (this.refcounts.get(key) ?? 0) + 1);
+        return subject.asObservable().pipe((0, rxjs_1.finalize)(() => {
+            const next = (this.refcounts.get(key) ?? 1) - 1;
+            if (next <= 0) {
+                this.refcounts.delete(key);
+                this.subjects.delete(key);
+                subject.complete();
+            }
+            else {
+                this.refcounts.set(key, next);
+            }
+        }));
+    }
+    /**
+     * Push a `MessageEvent` to every subscriber of `key`. No-ops when nobody is
+     * listening (no Subject exists), since SSE is fire-and-forget. `options.event`
+     * sets the SSE event `type`.
+     */
+    publish(key, data, options) {
+        const subject = this.subjects.get(key);
+        if (!subject)
+            return;
+        const data_ = data;
+        const message = options?.event
+            ? { data: data_, type: options.event }
+            : { data: data_ };
+        subject.next(message);
+    }
+    subjectFor(key) {
+        let subject = this.subjects.get(key);
+        if (!subject) {
+            subject = new rxjs_1.Subject();
+            this.subjects.set(key, subject);
+        }
+        return subject;
+    }
+};
+exports.SseHub = SseHub;
+exports.SseHub = SseHub = __decorate([
+    (0, common_1.Injectable)()
+], SseHub);
+//# sourceMappingURL=sse.hub.js.map

package/dist/sse.hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.hub.js","sourceRoot":"","sources":["../src/sse.hub.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA+D;AAC/D,+BAA0D;AAE1D;;;;;;;;;GASG;AAEI,IAAM,MAAM,GAAZ,MAAM,MAAM;IACA,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IACpD,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvD;;;;;OAKG;IACH,MAAM,CAAC,GAAW;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAE5D,OAAO,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,CAChC,IAAA,eAAQ,EAAC,GAAG,EAAE;YACZ,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,GAAW,EAAE,IAAa,EAAE,OAA4B;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,KAAK,GAAG,IAA4B,CAAC;QAC3C,MAAM,OAAO,GAAiB,OAAO,EAAE,KAAK;YAC1C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE;YACtC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,cAAO,EAAgB,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAA;AApDY,wBAAM;iBAAN,MAAM;IADlB,IAAA,mBAAU,GAAE;GACA,MAAM,CAoDlB"}

package/dist/sse.module.d.ts

@@ -0,0 +1,23 @@
+import { type DynamicModule } from '@nestjs/common';
+export interface SseChannelModuleOptions {
+    /** SSE event name (`type`) emitted to clients. Defaults to `'notification'`. */
+    event?: string;
+    /** Register globally so the channel is discoverable app-wide. Default true. */
+    global?: boolean;
+}
+/**
+ * Registers the SSE channel and its {@link SseHub}.
+ *
+ * The streaming endpoint itself is mounted by the consumer in their own
+ * controller via NestJS's native `@Sse()` decorator — this module only provides
+ * the hub (to read from) and the channel (to push into). See {@link SseChannel}
+ * for the controller example.
+ *
+ * ```ts
+ * SseChannelModule.forRoot({ event: 'notification' });
+ * ```
+ */
+export declare class SseChannelModule {
+    static forRoot(options?: SseChannelModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=sse.module.d.ts.map

package/dist/sse.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.module.d.ts","sourceRoot":"","sources":["../src/sse.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAyB,MAAM,gBAAgB,CAAC;AAK3E,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,qBACa,gBAAgB;IAC3B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa;CAkBrE"}

package/dist/sse.module.js

@@ -0,0 +1,49 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var SseChannelModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseChannelModule = void 0;
+const common_1 = require("@nestjs/common");
+const sse_channel_1 = require("./sse.channel");
+const sse_hub_1 = require("./sse.hub");
+const tokens_1 = require("./tokens");
+/**
+ * Registers the SSE channel and its {@link SseHub}.
+ *
+ * The streaming endpoint itself is mounted by the consumer in their own
+ * controller via NestJS's native `@Sse()` decorator — this module only provides
+ * the hub (to read from) and the channel (to push into). See {@link SseChannel}
+ * for the controller example.
+ *
+ * ```ts
+ * SseChannelModule.forRoot({ event: 'notification' });
+ * ```
+ */
+let SseChannelModule = SseChannelModule_1 = class SseChannelModule {
+    static forRoot(options = {}) {
+        const channelOptions = {
+            event: options.event ?? 'notification',
+        };
+        const providers = [
+            { provide: tokens_1.SSE_OPTIONS, useValue: channelOptions },
+            sse_hub_1.SseHub,
+            sse_channel_1.SseChannel,
+        ];
+        return {
+            module: SseChannelModule_1,
+            global: options.global ?? true,
+            providers,
+            exports: [sse_hub_1.SseHub, sse_channel_1.SseChannel],
+        };
+    }
+};
+exports.SseChannelModule = SseChannelModule;
+exports.SseChannelModule = SseChannelModule = SseChannelModule_1 = __decorate([
+    (0, common_1.Module)({})
+], SseChannelModule);
+//# sourceMappingURL=sse.module.js.map

package/dist/sse.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.module.js","sourceRoot":"","sources":["../src/sse.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA2E;AAC3E,+CAAmE;AACnE,uCAAmC;AACnC,qCAAuC;AASvC;;;;;;;;;;;GAWG;AAEI,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IAC3B,MAAM,CAAC,OAAO,CAAC,UAAmC,EAAE;QAClD,MAAM,cAAc,GAAsB;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,cAAc;SACvC,CAAC;QAEF,MAAM,SAAS,GAAe;YAC5B,EAAE,OAAO,EAAE,oBAAW,EAAE,QAAQ,EAAE,cAAc,EAAE;YAClD,gBAAM;YACN,wBAAU;SACX,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,kBAAgB;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,SAAS;YACT,OAAO,EAAE,CAAC,gBAAM,EAAE,wBAAU,CAAC;SAC9B,CAAC;IACJ,CAAC;CACF,CAAA;AAnBY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,gBAAgB,CAmB5B"}

package/dist/tokens.d.ts

@@ -0,0 +1,3 @@
+/** DI token for the resolved {@link SseChannelOptions} (event name, etc.). */
+export declare const SSE_OPTIONS: unique symbol;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,eAAO,MAAM,WAAW,eAAwB,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SSE_OPTIONS = void 0;
+/** DI token for the resolved {@link SseChannelOptions} (event name, etc.). */
+exports.SSE_OPTIONS = Symbol('SSE_OPTIONS');
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":";;;AAAA,8EAA8E;AACjE,QAAA,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@dudousxd/nestjs-notifications-sse",
+  "version": "0.2.0",
+  "description": "Server-Sent Events channel for nestjs-notifications — push real-time notifications over native NestJS SSE",
+  "license": "MIT",
+  "author": "Davide Carvalho",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DavideCarvalho/nestjs-notifications.git",
+    "directory": "packages/sse"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@dudousxd/nestjs-notifications-core": ">=0.1.0 <1.0.0",
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
+    "rxjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.0.0",
+    "typescript": "^5.7.2",
+    "@dudousxd/nestjs-notifications-core": "^0.4.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}