@futdevpro/nts-dynamo 1.15.362 → 1.15.363

package/build/_modules/notifications/_models/notification-mongo-collection.interface.d.ts

@@ -0,0 +1,21 @@
+/**
+ * BFR-OLDLIGHTSITE-001 — the minimal MongoDB collection surface `DyNTS_Notification_MongoStore` needs. A native
+ * driver `Collection` and `mongoose.connection.collection(name)` satisfy it structurally, so the store has no hard
+ * driver dependency.
+ */
+export interface DyNTS_NotificationMongoCollection_Interface {
+    insertOne(document: object): Promise<unknown>;
+    findOne(filter: object): Promise<unknown>;
+    find(filter: object, options?: object): {
+        toArray(): Promise<unknown[]>;
+    };
+    countDocuments(filter: object): Promise<number>;
+    updateMany(filter: object, update: object): Promise<{
+        modifiedCount?: number;
+    }>;
+    /** Ascending / descending keys only — the shape a native `Collection` accepts without a cast. */
+    createIndex(spec: {
+        [key: string]: 1 | -1;
+    }, options: object): Promise<unknown>;
+}
+//# sourceMappingURL=notification-mongo-collection.interface.d.ts.map

package/build/_modules/notifications/_models/notification-mongo-collection.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-mongo-collection.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification-mongo-collection.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,2CAA2C;IAC1D,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,OAAO,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;KAAE,CAAC;IAC1E,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,iGAAiG;IACjG,WAAW,CAAC,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;KAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjF"}

package/build/_modules/notifications/_models/notification-mongo-collection.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=notification-mongo-collection.interface.js.map

package/build/_modules/notifications/_models/notification-mongo-collection.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-mongo-collection.interface.js","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification-mongo-collection.interface.ts"],"names":[],"mappings":""}

package/build/_modules/notifications/_models/notification-publisher.interface.d.ts

@@ -0,0 +1,32 @@
+import { DyNTS_Notification_Interface } from './notification.interface';
+/**
+ * BFR-OLDLIGHTSITE-001 — a change pushed to the account's other devices / tabs.
+ *
+ * @description Every event carries the account's `unreadCount` after the change, so a client can set its badge
+ *   without a round-trip. A read event carries the ids and the `seen` time; a client applies it MONOTONICALLY (it
+ *   only ever turns unread → read), so an event arriving late or out of order can never make a read item unread.
+ */
+export type DyNTS_NotificationEvent_Type = {
+    kind: 'created';
+    accountId: string;
+    notification: DyNTS_Notification_Interface;
+    unreadCount: number;
+} | {
+    kind: 'read';
+    accountId: string;
+    ids: string[];
+    seen: Date;
+    unreadCount: number;
+} | {
+    kind: 'read-all';
+    accountId: string;
+    upTo: Date;
+    seen: Date;
+    unreadCount: number;
+};
+/**
+ * BFR-OLDLIGHTSITE-001 — delivers the events (e.g. a socket emit to the account's room). Best effort: the stored
+ * list is the truth, so a failing publisher is logged and never fails the operation that raised the event.
+ */
+export type DyNTS_NotificationPublisher_Type = (event: DyNTS_NotificationEvent_Type) => void | Promise<void>;
+//# sourceMappingURL=notification-publisher.interface.d.ts.map

package/build/_modules/notifications/_models/notification-publisher.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-publisher.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification-publisher.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,4BAA4B,GACpC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,4BAA4B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACvG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/build/_modules/notifications/_models/notification-publisher.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=notification-publisher.interface.js.map

package/build/_modules/notifications/_models/notification-publisher.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-publisher.interface.js","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification-publisher.interface.ts"],"names":[],"mappings":""}

package/build/_modules/notifications/_models/notification-store.interface.d.ts

@@ -0,0 +1,35 @@
+import { DyNTS_Notification_Interface } from './notification.interface';
+/** A position in the newest-first order: the page continues with the notifications strictly OLDER than it. */
+export interface DyNTS_NotificationCursor_Interface {
+    created: Date;
+    id: string;
+}
+/**
+ * BFR-OLDLIGHTSITE-001 — the persistence contract behind `DyNTS_Notification_Service` (in-memory and MongoDB
+ * implementations). The store does NO validation — the service does it before every call.
+ */
+export interface DyNTS_NotificationStore_Interface {
+    /** Inserts, or — same `accountId` + `dedupeKey` — returns the EXISTING one unchanged. */
+    insert(notification: DyNTS_Notification_Interface): Promise<DyNTS_Notification_Interface>;
+    /** Newest first (`__created` desc, then `_id` desc), strictly after `before`. */
+    list(query: {
+        accountId: string;
+        limit: number;
+        before?: DyNTS_NotificationCursor_Interface;
+        unreadOnly?: boolean;
+    }): Promise<DyNTS_Notification_Interface[]>;
+    countUnread(accountId: string): Promise<number>;
+    /** The ids (of the given ones) that exist for the account. */
+    existingIds(accountId: string, ids: string[]): Promise<string[]>;
+    /**
+     * Sets `seen = at` on the account's UNREAD notifications among `ids` (an already read one is left untouched), or —
+     * `ids` omitted — on every unread one created at or before `upTo`. Returns how many changed.
+     */
+    markSeen(query: {
+        accountId: string;
+        at: Date;
+        ids?: string[];
+        upTo?: Date;
+    }): Promise<number>;
+}
+//# sourceMappingURL=notification-store.interface.d.ts.map

package/build/_modules/notifications/_models/notification-store.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-store.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification-store.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAExE,8GAA8G;AAC9G,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,IAAI,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,iCAAiC;IAChD,yFAAyF;IACzF,MAAM,CAAC,YAAY,EAAE,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC1F,iFAAiF;IACjF,IAAI,CAAC,KAAK,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,kCAAkC,CAAC;QAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAC;IAC5C,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,8DAA8D;IAC9D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChG"}

package/build/_modules/notifications/_models/notification-store.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=notification-store.interface.js.map

package/build/_modules/notifications/_models/notification-store.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-store.interface.js","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification-store.interface.ts"],"names":[],"mappings":""}

package/build/_modules/notifications/_models/notification.interface.d.ts

@@ -0,0 +1,59 @@
+/** BFR-OLDLIGHTSITE-001 — the severity of a notification (the values of the client's `DyNX_Notification_Type`). */
+export type DyNTS_NotificationKind_Type = 'info' | 'success' | 'warning' | 'error';
+/**
+ * BFR-OLDLIGHTSITE-001 — one stored notification of one account.
+ *
+ * @description The display fields (`title`, `message`, `type`, `routerLink`, `queryParams`, `seen`, `_id`,
+ *   `__created`) carry the SAME names as the client's `DyNX_Notification`, so a stored record can be handed to the
+ *   `ngx-dynamo` notification components unchanged.
+ */
+export interface DyNTS_Notification_Interface {
+    _id: string;
+    /** The recipient (`fdp-issuer-is-account-id`: always the accountId, never the userId). */
+    accountId: string;
+    /** The domain event that raised it, e.g. `sp-review.reminder` — for filtering and client routing. */
+    eventType: string;
+    title: string;
+    message?: string;
+    type: DyNTS_NotificationKind_Type;
+    /** An app-internal route (always starts with `/` — an external or `javascript:` link is rejected). */
+    routerLink?: string;
+    queryParams?: Record<string, string | number>;
+    /** Event-specific data (JSON, at most 16 KB). */
+    payload?: Record<string, unknown>;
+    /** Same account + same key → the SAME notification (a retried producer never duplicates it). */
+    dedupeKey?: string;
+    /** `null` = unread. Set ONCE, by the first read; never cleared, never moved (the read state cannot jump back). */
+    seen: Date | null;
+    __created: Date;
+}
+/** BFR-OLDLIGHTSITE-001 — what a producer passes to `create`. */
+export interface DyNTS_NotificationCreate_Interface {
+    accountId: string;
+    eventType: string;
+    title: string;
+    message?: string;
+    /** Default `info`. */
+    type?: DyNTS_NotificationKind_Type;
+    routerLink?: string;
+    queryParams?: Record<string, string | number>;
+    payload?: Record<string, unknown>;
+    dedupeKey?: string;
+}
+/** BFR-OLDLIGHTSITE-001 — one page of an account's notifications, newest first. */
+export interface DyNTS_NotificationPage_Interface {
+    items: DyNTS_Notification_Interface[];
+    /** Pass it as `before` for the next (older) page; `null` = no more. */
+    nextCursor: string | null;
+    unreadCount: number;
+}
+/** BFR-OLDLIGHTSITE-001 — the outcome of `markRead` / `markAllRead`. */
+export interface DyNTS_NotificationReadResult_Interface {
+    /** How many notifications THIS call turned from unread to read (a repeated call → 0: idempotent). */
+    updated: number;
+    /** Requested ids that do not exist for this account (`markRead` only). */
+    notFound: string[];
+    /** The account's unread count after the call — the client sets its badge from it. */
+    unreadCount: number;
+}
+//# sourceMappingURL=notification.interface.d.ts.map

package/build/_modules/notifications/_models/notification.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification.interface.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,0FAA0F;IAC1F,SAAS,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,2BAA2B,CAAC;IAClC,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kHAAkH;IAClH,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,iEAAiE;AACjE,MAAM,WAAW,kCAAkC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,CAAC,EAAE,2BAA2B,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACtC,uEAAuE;IACvE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,sCAAsC;IACrD,qGAAqG;IACrG,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/build/_modules/notifications/_models/notification.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=notification.interface.js.map

package/build/_modules/notifications/_models/notification.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.interface.js","sourceRoot":"","sources":["../../../../src/_modules/notifications/_models/notification.interface.ts"],"names":[],"mappings":""}

package/build/_modules/notifications/get-notifications-routing-module.util.d.ts

@@ -0,0 +1,18 @@
+import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
+import { DyNTS_NotificationsController_Config } from './notifications.controller';
+/**
+ * BFR-OLDLIGHTSITE-001 — the routing module of the account notification routes (default mount: `/notifications`).
+ *
+ * @example
+ * ```ts
+ * const notifications = new DyNTS_Notification_Service({
+ *   store: new DyNTS_Notification_MongoStore({ collection: mongoose.connection.collection('dynts_notifications') }),
+ *   publisher: (event) => socketServer.to(`account:${event.accountId}`).emit('notification', event),
+ * });
+ * routingModules.push(DyNTS_getNotificationsRoutingModule({ service: notifications, authPreProcess: auth }));
+ * ```
+ */
+export declare function DyNTS_getNotificationsRoutingModule(config: DyNTS_NotificationsController_Config & {
+    route?: string;
+}): DyNTS_RoutingModule;
+//# sourceMappingURL=get-notifications-routing-module.util.d.ts.map

package/build/_modules/notifications/get-notifications-routing-module.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-notifications-routing-module.util.d.ts","sourceRoot":"","sources":["../../../src/_modules/notifications/get-notifications-routing-module.util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAkC,oCAAoC,EAAE,MAAM,4BAA4B,CAAC;AAElH;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,oCAAoC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,mBAAmB,CASrB"}

package/build/_modules/notifications/get-notifications-routing-module.util.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_getNotificationsRoutingModule = DyNTS_getNotificationsRoutingModule;
+const routing_module_service_1 = require("../../_services/route/routing-module.service");
+const notifications_controller_1 = require("./notifications.controller");
+/**
+ * BFR-OLDLIGHTSITE-001 — the routing module of the account notification routes (default mount: `/notifications`).
+ *
+ * @example
+ * ```ts
+ * const notifications = new DyNTS_Notification_Service({
+ *   store: new DyNTS_Notification_MongoStore({ collection: mongoose.connection.collection('dynts_notifications') }),
+ *   publisher: (event) => socketServer.to(`account:${event.accountId}`).emit('notification', event),
+ * });
+ * routingModules.push(DyNTS_getNotificationsRoutingModule({ service: notifications, authPreProcess: auth }));
+ * ```
+ */
+function DyNTS_getNotificationsRoutingModule(config) {
+    notifications_controller_1.DyNTS_Notifications_Controller.configure(config);
+    const set = {
+        route: config.route ?? '/notifications',
+        controllers: [notifications_controller_1.DyNTS_Notifications_Controller.getInstance()],
+    };
+    return new routing_module_service_1.DyNTS_RoutingModule(set);
+}
+//# sourceMappingURL=get-notifications-routing-module.util.js.map

package/build/_modules/notifications/get-notifications-routing-module.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-notifications-routing-module.util.js","sourceRoot":"","sources":["../../../src/_modules/notifications/get-notifications-routing-module.util.ts"],"names":[],"mappings":";;AAgBA,kFAWC;AA1BD,yFAAmF;AACnF,yEAAkH;AAElH;;;;;;;;;;;GAWG;AACH,SAAgB,mCAAmC,CACjD,MAAiE;IAEjE,yDAA8B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEjD,MAAM,GAAG,GAAiC;QACxC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,gBAAgB;QACvC,WAAW,EAAE,CAAE,yDAA8B,CAAC,WAAW,EAAE,CAAE;KAC9D,CAAC;IAEF,OAAO,IAAI,4CAAmB,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/build/_modules/notifications/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * BFR-OLDLIGHTSITE-001 — `@futdevpro/nts-dynamo/notifications`: persisted per-account notifications
+ * (create · list · unread count · mark read · mark all read) with a monotonic read state, an optional push
+ * publisher, and the account routes. In-memory and MongoDB stores.
+ */
+export * from './_models/notification.interface';
+export * from './_models/notification-store.interface';
+export * from './_models/notification-publisher.interface';
+export * from './_models/notification-mongo-collection.interface';
+export * from './notification-in-memory.store';
+export * from './notification-mongo.store';
+export * from './notification.service';
+export * from './notifications.controller';
+export * from './get-notifications-routing-module.util';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,kCAAkC,CAAC;AACjD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,mDAAmD,CAAC;AAClE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC"}

package/build/_modules/notifications/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * BFR-OLDLIGHTSITE-001 — `@futdevpro/nts-dynamo/notifications`: persisted per-account notifications
+ * (create · list · unread count · mark read · mark all read) with a monotonic read state, an optional push
+ * publisher, and the account routes. In-memory and MongoDB stores.
+ */
+tslib_1.__exportStar(require("./_models/notification.interface"), exports);
+tslib_1.__exportStar(require("./_models/notification-store.interface"), exports);
+tslib_1.__exportStar(require("./_models/notification-publisher.interface"), exports);
+tslib_1.__exportStar(require("./_models/notification-mongo-collection.interface"), exports);
+tslib_1.__exportStar(require("./notification-in-memory.store"), exports);
+tslib_1.__exportStar(require("./notification-mongo.store"), exports);
+tslib_1.__exportStar(require("./notification.service"), exports);
+tslib_1.__exportStar(require("./notifications.controller"), exports);
+tslib_1.__exportStar(require("./get-notifications-routing-module.util"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/notifications/index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2EAAiD;AACjD,iFAAuD;AACvD,qFAA2D;AAC3D,4FAAkE;AAClE,yEAA+C;AAC/C,qEAA2C;AAC3C,iEAAuC;AACvC,qEAA2C;AAC3C,kFAAwD"}

package/build/_modules/notifications/notification-in-memory.store.d.ts

@@ -0,0 +1,30 @@
+import { DyNTS_Notification_Interface } from './_models/notification.interface';
+import { DyNTS_NotificationCursor_Interface, DyNTS_NotificationStore_Interface } from './_models/notification-store.interface';
+/**
+ * BFR-OLDLIGHTSITE-001 — a single-process notification store (tests, local development, one-replica tools).
+ * Same semantics as `DyNTS_Notification_MongoStore`; every returned record is a copy.
+ */
+export declare class DyNTS_Notification_InMemoryStore implements DyNTS_NotificationStore_Interface {
+    private readonly records;
+    insert(notification: DyNTS_Notification_Interface): Promise<DyNTS_Notification_Interface>;
+    list(query: {
+        accountId: string;
+        limit: number;
+        before?: DyNTS_NotificationCursor_Interface;
+        unreadOnly?: boolean;
+    }): Promise<DyNTS_Notification_Interface[]>;
+    countUnread(accountId: string): Promise<number>;
+    existingIds(accountId: string, ids: string[]): Promise<string[]>;
+    markSeen(query: {
+        accountId: string;
+        at: Date;
+        ids?: string[];
+        upTo?: Date;
+    }): Promise<number>;
+    /** Newest first: `__created` desc, then `_id` desc (a stable total order for paging). */
+    static newestFirst(a: DyNTS_Notification_Interface, b: DyNTS_Notification_Interface): number;
+    /** Strictly after the cursor in the newest-first order. */
+    private static isOlder;
+    private static copy;
+}
+//# sourceMappingURL=notification-in-memory.store.d.ts.map

package/build/_modules/notifications/notification-in-memory.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-in-memory.store.d.ts","sourceRoot":"","sources":["../../../src/_modules/notifications/notification-in-memory.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EACL,kCAAkC,EAAE,iCAAiC,EACtE,MAAM,wCAAwC,CAAC;AAEhD;;;GAGG;AACH,qBAAa,gCAAiC,YAAW,iCAAiC;IACxF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAExD,MAAM,CAAC,YAAY,EAAE,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAgBzF,IAAI,CAAC,KAAK,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,kCAAkC,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;KACrG,GAAG,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAUrC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM/C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMhE,QAAQ,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBpG,yFAAyF;IACzF,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,4BAA4B,EAAE,CAAC,EAAE,4BAA4B,GAAG,MAAM;IAI5F,2DAA2D;IAC3D,OAAO,CAAC,MAAM,CAAC,OAAO;IAMtB,OAAO,CAAC,MAAM,CAAC,IAAI;CASpB"}

package/build/_modules/notifications/notification-in-memory.store.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Notification_InMemoryStore = void 0;
+/**
+ * BFR-OLDLIGHTSITE-001 — a single-process notification store (tests, local development, one-replica tools).
+ * Same semantics as `DyNTS_Notification_MongoStore`; every returned record is a copy.
+ */
+class DyNTS_Notification_InMemoryStore {
+    records = [];
+    async insert(notification) {
+        const existing = notification.dedupeKey
+            ? this.records.find((record) => (record.accountId === notification.accountId && record.dedupeKey === notification.dedupeKey))
+            : undefined;
+        if (existing) {
+            return DyNTS_Notification_InMemoryStore.copy(existing);
+        }
+        this.records.push(DyNTS_Notification_InMemoryStore.copy(notification));
+        return DyNTS_Notification_InMemoryStore.copy(notification);
+    }
+    async list(query) {
+        return this.records
+            .filter((record) => record.accountId === query.accountId
+            && (!query.unreadOnly || !record.seen)
+            && (!query.before || DyNTS_Notification_InMemoryStore.isOlder(record, query.before)))
+            .sort(DyNTS_Notification_InMemoryStore.newestFirst)
+            .slice(0, query.limit)
+            .map(DyNTS_Notification_InMemoryStore.copy);
+    }
+    async countUnread(accountId) {
+        return this.records.filter((record) => (record.accountId === accountId && !record.seen)).length;
+    }
+    async existingIds(accountId, ids) {
+        return ids.filter((id) => this.records.some((record) => (record.accountId === accountId && record._id === id)));
+    }
+    async markSeen(query) {
+        let updated = 0;
+        for (const record of this.records) {
+            const selected = query.ids
+                ? query.ids.includes(record._id)
+                : !query.upTo || record.__created.getTime() <= query.upTo.getTime();
+            if (record.accountId === query.accountId && !record.seen && selected) {
+                record.seen = new Date(query.at);
+                updated++;
+            }
+        }
+        return updated;
+    }
+    /** Newest first: `__created` desc, then `_id` desc (a stable total order for paging). */
+    static newestFirst(a, b) {
+        return b.__created.getTime() - a.__created.getTime() || (a._id < b._id ? 1 : a._id > b._id ? -1 : 0);
+    }
+    /** Strictly after the cursor in the newest-first order. */
+    static isOlder(record, before) {
+        const created = record.__created.getTime();
+        return created < before.created.getTime() || (created === before.created.getTime() && record._id < before.id);
+    }
+    static copy(record) {
+        return {
+            ...record,
+            __created: new Date(record.__created),
+            seen: record.seen ? new Date(record.seen) : null,
+            queryParams: record.queryParams ? { ...record.queryParams } : undefined,
+            payload: record.payload ? JSON.parse(JSON.stringify(record.payload)) : undefined,
+        };
+    }
+}
+exports.DyNTS_Notification_InMemoryStore = DyNTS_Notification_InMemoryStore;
+//# sourceMappingURL=notification-in-memory.store.js.map

package/build/_modules/notifications/notification-in-memory.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-in-memory.store.js","sourceRoot":"","sources":["../../../src/_modules/notifications/notification-in-memory.store.ts"],"names":[],"mappings":"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"}

package/build/_modules/notifications/notification-mongo.store.d.ts

@@ -0,0 +1,51 @@
+import { DyNTS_Notification_Interface } from './_models/notification.interface';
+import { DyNTS_NotificationMongoCollection_Interface } from './_models/notification-mongo-collection.interface';
+import { DyNTS_NotificationCursor_Interface, DyNTS_NotificationStore_Interface } from './_models/notification-store.interface';
+/**
+ * BFR-OLDLIGHTSITE-001 — the shared (multi-process, multi-replica) notification store, on MongoDB.
+ *
+ * @description
+ * - **Read state never jumps back:** `markSeen` updates with the filter `seen: null`, so an already read
+ *   notification is never touched again — two devices, the API and the socket may race, the first read wins and
+ *   the state only ever goes unread → read. There is no operation that clears `seen`.
+ * - **Idempotent create:** a unique partial index on `(accountId, dedupeKey)` makes a retried producer's second
+ *   insert fail with a duplicate key; the store then returns the EXISTING record.
+ * - Paging is a keyset on `(__created desc, _id desc)` — stable under concurrent inserts, no skip/offset.
+ *
+ * Usage: `new DyNTS_Notification_MongoStore({ collection: mongoose.connection.collection('dynts_notifications') })`,
+ * then `ensureIndexes()` once at boot.
+ */
+export declare class DyNTS_Notification_MongoStore implements DyNTS_NotificationStore_Interface {
+    private readonly collection;
+    /** Every replica must point at the SAME collection. */
+    constructor(set: {
+        collection: DyNTS_NotificationMongoCollection_Interface;
+    });
+    /**
+     * The list, unread-count and dedupe indexes; with `retentionDays`, a TTL index that deletes notifications older than
+     * that. Idempotent — call once at boot.
+     */
+    ensureIndexes(options?: {
+        retentionDays?: number;
+    }): Promise<void>;
+    insert(notification: DyNTS_Notification_Interface): Promise<DyNTS_Notification_Interface>;
+    list(query: {
+        accountId: string;
+        limit: number;
+        before?: DyNTS_NotificationCursor_Interface;
+        unreadOnly?: boolean;
+    }): Promise<DyNTS_Notification_Interface[]>;
+    countUnread(accountId: string): Promise<number>;
+    existingIds(accountId: string, ids: string[]): Promise<string[]>;
+    markSeen(query: {
+        accountId: string;
+        at: Date;
+        ids?: string[];
+        upTo?: Date;
+    }): Promise<number>;
+    /** A stored document → a clean record (dates as `Date`, no driver-specific fields). */
+    static fromDocument(document: unknown): DyNTS_Notification_Interface;
+    private static toDate;
+    private static kindOf;
+}
+//# sourceMappingURL=notification-mongo.store.d.ts.map

package/build/_modules/notifications/notification-mongo.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-mongo.store.d.ts","sourceRoot":"","sources":["../../../src/_modules/notifications/notification-mongo.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,2CAA2C,EAAE,MAAM,mDAAmD,CAAC;AAChH,OAAO,EACL,kCAAkC,EAAE,iCAAiC,EACtE,MAAM,wCAAwC,CAAC;AAKhD;;;;;;;;;;;;;GAaG;AACH,qBAAa,6BAA8B,YAAW,iCAAiC;IACrF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8C;IAEzE,uDAAuD;gBAC3C,GAAG,EAAE;QAAE,UAAU,EAAE,2CAA2C,CAAA;KAAE;IAO5E;;;OAGG;IACG,aAAa,CAAC,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtE,MAAM,CAAC,YAAY,EAAE,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IA+BzF,IAAI,CAAC,KAAK,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,kCAAkC,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;KACrG,GAAG,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAoBrC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWhE,QAAQ,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,IAAI,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAepG,uFAAuF;IACvF,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,4BAA4B;IAsBpE,OAAO,CAAC,MAAM,CAAC,MAAM;IAIrB,OAAO,CAAC,MAAM,CAAC,MAAM;CAGtB"}

package/build/_modules/notifications/notification-mongo.store.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Notification_MongoStore = void 0;
+/** MongoDB's duplicate-key error code. */
+const DUPLICATE_KEY = 11000;
+/**
+ * BFR-OLDLIGHTSITE-001 — the shared (multi-process, multi-replica) notification store, on MongoDB.
+ *
+ * @description
+ * - **Read state never jumps back:** `markSeen` updates with the filter `seen: null`, so an already read
+ *   notification is never touched again — two devices, the API and the socket may race, the first read wins and
+ *   the state only ever goes unread → read. There is no operation that clears `seen`.
+ * - **Idempotent create:** a unique partial index on `(accountId, dedupeKey)` makes a retried producer's second
+ *   insert fail with a duplicate key; the store then returns the EXISTING record.
+ * - Paging is a keyset on `(__created desc, _id desc)` — stable under concurrent inserts, no skip/offset.
+ *
+ * Usage: `new DyNTS_Notification_MongoStore({ collection: mongoose.connection.collection('dynts_notifications') })`,
+ * then `ensureIndexes()` once at boot.
+ */
+class DyNTS_Notification_MongoStore {
+    collection;
+    /** Every replica must point at the SAME collection. */
+    constructor(set) {
+        if (!set?.collection) {
+            throw new Error('DYNTS_NOTIFICATION_MONGO_STORE_COLLECTION_MISSING');
+        }
+        this.collection = set.collection;
+    }
+    /**
+     * The list, unread-count and dedupe indexes; with `retentionDays`, a TTL index that deletes notifications older than
+     * that. Idempotent — call once at boot.
+     */
+    async ensureIndexes(options = {}) {
+        await this.collection.createIndex({ accountId: 1, __created: -1, _id: -1 }, { name: 'dynts_notification_list' });
+        await this.collection.createIndex({ accountId: 1, seen: 1 }, { name: 'dynts_notification_unread' });
+        await this.collection.createIndex({ accountId: 1, dedupeKey: 1 }, {
+            name: 'dynts_notification_dedupe', unique: true, partialFilterExpression: { dedupeKey: { $type: 'string' } },
+        });
+        if (options.retentionDays) {
+            await this.collection.createIndex({ __created: 1 }, {
+                name: 'dynts_notification_retention', expireAfterSeconds: Math.round(options.retentionDays * 86400),
+            });
+        }
+    }
+    async insert(notification) {
+        const document = { ...notification };
+        // an absent optional field is not stored (a `null` dedupeKey would collide in the unique index)
+        Object.keys(document).forEach((key) => {
+            if (document[key] === undefined) {
+                delete document[key];
+            }
+        });
+        try {
+            await this.collection.insertOne(document);
+            return notification;
+        }
+        catch (error) {
+            if (Reflect.get(Object(error), 'code') !== DUPLICATE_KEY || !notification.dedupeKey) {
+                throw error;
+            }
+            const existing = await this.collection.findOne({
+                accountId: notification.accountId, dedupeKey: notification.dedupeKey,
+            });
+            if (!existing) {
+                throw error;
+            }
+            return DyNTS_Notification_MongoStore.fromDocument(existing);
+        }
+    }
+    async list(query) {
+        const filter = { accountId: query.accountId };
+        if (query.unreadOnly) {
+            filter.seen = null;
+        }
+        if (query.before) {
+            filter.$or = [
+                { __created: { $lt: query.before.created } },
+                { __created: query.before.created, _id: { $lt: query.before.id } },
+            ];
+        }
+        const documents = await this.collection
+            .find(filter, { sort: { __created: -1, _id: -1 }, limit: query.limit })
+            .toArray();
+        return documents.map(DyNTS_Notification_MongoStore.fromDocument);
+    }
+    async countUnread(accountId) {
+        return this.collection.countDocuments({ accountId: accountId, seen: null });
+    }
+    async existingIds(accountId, ids) {
+        const documents = await this.collection
+            .find({ accountId: accountId, _id: { $in: ids } }, { projection: { _id: 1 } })
+            .toArray();
+        const found = new Set(documents.map((document) => (String(Reflect.get(Object(document), '_id')))));
+        return ids.filter((id) => found.has(id));
+    }
+    async markSeen(query) {
+        // `seen: null` in the filter is the whole guarantee: a read notification is never matched again
+        const filter = { accountId: query.accountId, seen: null };
+        if (query.ids) {
+            filter._id = { $in: query.ids };
+        }
+        else if (query.upTo) {
+            filter.__created = { $lte: query.upTo };
+        }
+        const result = await this.collection.updateMany(filter, { $set: { seen: query.at } });
+        return Number(result?.modifiedCount ?? 0);
+    }
+    /** A stored document → a clean record (dates as `Date`, no driver-specific fields). */
+    static fromDocument(document) {
+        const read = (key) => Reflect.get(Object(document), key);
+        const seen = read('seen');
+        const record = {
+            _id: String(read('_id')),
+            accountId: String(read('accountId')),
+            eventType: String(read('eventType')),
+            title: String(read('title')),
+            type: DyNTS_Notification_MongoStore.kindOf(read('type')),
+            seen: seen ? DyNTS_Notification_MongoStore.toDate(seen) : null,
+            __created: DyNTS_Notification_MongoStore.toDate(read('__created')),
+        };
+        for (const key of ['message', 'routerLink', 'queryParams', 'payload', 'dedupeKey']) {
+            if (read(key) !== undefined && read(key) !== null) {
+                Reflect.set(record, key, read(key));
+            }
+        }
+        return record;
+    }
+    static toDate(value) {
+        return value instanceof Date ? new Date(value.getTime()) : new Date(String(value));
+    }
+    static kindOf(value) {
+        return value === 'success' || value === 'warning' || value === 'error' ? value : 'info';
+    }
+}
+exports.DyNTS_Notification_MongoStore = DyNTS_Notification_MongoStore;
+//# sourceMappingURL=notification-mongo.store.js.map

package/build/_modules/notifications/notification-mongo.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-mongo.store.js","sourceRoot":"","sources":["../../../src/_modules/notifications/notification-mongo.store.ts"],"names":[],"mappings":"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"}

package/build/_modules/notifications/notification.service.d.ts

@@ -0,0 +1,67 @@
+import { DyNTS_Notification_Interface, DyNTS_NotificationCreate_Interface, DyNTS_NotificationPage_Interface, DyNTS_NotificationReadResult_Interface } from './_models/notification.interface';
+import { DyNTS_NotificationPublisher_Type } from './_models/notification-publisher.interface';
+import { DyNTS_NotificationStore_Interface } from './_models/notification-store.interface';
+/** BFR-OLDLIGHTSITE-001 — the notification service settings. */
+export interface DyNTS_Notification_Settings_Interface {
+    store: DyNTS_NotificationStore_Interface;
+    /** Pushes every change to the account's devices (e.g. a socket room). Optional, best effort. */
+    publisher?: DyNTS_NotificationPublisher_Type;
+    /** When given, `create` accepts ONLY these event types (a typo in a producer is a 400, not a silent new type). */
+    eventTypes?: string[];
+    /** A test seam (default: `() => new Date()`). */
+    now?: () => Date;
+}
+/**
+ * BFR-OLDLIGHTSITE-001 — a persisted, per-account notification service: create · list · unread count ·
+ * mark read · mark all read, with an optional push publisher.
+ *
+ * @description
+ * - **The read state never jumps back.** A read only ever turns unread → read, the FIRST read's time is kept, and
+ *   nothing clears it; `markAllRead` takes an `upTo` watermark, so a notification that arrived AFTER the user looked
+ *   at the list is not marked read by a late "mark all" from another device.
+ * - **Idempotent.** A repeated `markRead` / `markAllRead` changes nothing (`updated: 0`); a producer that retries
+ *   `create` with the same `dedupeKey` gets the same notification back.
+ * - **A stable retry contract for clients.** 400 `DyNTS-NTF-IN0` = the request is wrong, do not retry; 401
+ *   `DyNTS-NTF-AU0` = no account; 503 `DyNTS-NTF-ST0` = the store failed, retry with backoff (every operation is
+ *   idempotent, so a retry is always safe).
+ */
+export declare class DyNTS_Notification_Service {
+    private readonly store;
+    private readonly publisher?;
+    private readonly eventTypes?;
+    private readonly now;
+    /** Keeps the store and the optional publisher; `eventTypes` restricts `create`. */
+    constructor(settings: DyNTS_Notification_Settings_Interface);
+    /** Stores a notification for one account (idempotent with `dedupeKey`) and publishes it. */
+    create(input: DyNTS_NotificationCreate_Interface): Promise<DyNTS_Notification_Interface>;
+    /** One page, newest first; `before` is the `nextCursor` of the previous page. */
+    listForAccount(accountId: string, options?: {
+        limit?: number;
+        before?: string | null;
+        unreadOnly?: boolean;
+    }): Promise<DyNTS_NotificationPage_Interface>;
+    unreadCount(accountId: string): Promise<number>;
+    /** Marks the given notifications read (the account's own only; an already read one is left as it is). */
+    markRead(accountId: string, ids: string[]): Promise<DyNTS_NotificationReadResult_Interface>;
+    /**
+     * Marks every unread notification created at or before `upTo` read. Pass the time the user SAW the list (default:
+     * now), so a notification that arrived later stays unread.
+     */
+    markAllRead(accountId: string, upTo?: Date | string | null): Promise<DyNTS_NotificationReadResult_Interface>;
+    /** The opaque paging cursor of a record. */
+    static cursorOf(record: DyNTS_Notification_Interface): string;
+    private static parseCursor;
+    private static limitOf;
+    private validateCreate;
+    private validateAccount;
+    private validateIds;
+    private static isQueryParams;
+    private static isSmallJsonObject;
+    private invalid;
+    private static invalidStatic;
+    /** A store call; a failure becomes a retryable 503 (every operation is idempotent). */
+    private call;
+    /** Best effort: a failing publisher (or its unread count) is logged, never thrown. */
+    private publish;
+}
+//# sourceMappingURL=notification.service.d.ts.map

package/build/_modules/notifications/notification.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.service.d.ts","sourceRoot":"","sources":["../../../src/_modules/notifications/notification.service.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,4BAA4B,EAAE,kCAAkC,EAChE,gCAAgC,EAAE,sCAAsC,EACzE,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACyB,gCAAgC,EAC/D,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAC+B,iCAAiC,EACtE,MAAM,wCAAwC,CAAC;AAIhD,gEAAgE;AAChE,MAAM,WAAW,qCAAqC;IACpD,KAAK,EAAE,iCAAiC,CAAC;IACzC,gGAAgG;IAChG,SAAS,CAAC,EAAE,gCAAgC,CAAC;IAC7C,kHAAkH;IAClH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IAEjC,mFAAmF;gBACvE,QAAQ,EAAE,qCAAqC;IAU3D,4FAA4F;IACtF,MAAM,CAAC,KAAK,EAAE,kCAAkC,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAiB9F,iFAAiF;IAC3E,cAAc,CAClB,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GAChG,OAAO,CAAC,gCAAgC,CAAC;IAsBtC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMrD,yGAAyG;IACnG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,sCAAsC,CAAC;IA2BjG;;;OAGG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,sCAAsC,CAAC;IA0BlH,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,GAAG,MAAM;IAI7D,OAAO,CAAC,MAAM,CAAC,WAAW;IAW1B,OAAO,CAAC,MAAM,CAAC,OAAO;IAMtB,OAAO,CAAC,cAAc;IA0DtB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAWhC,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM,CAAC,aAAa;IAU5B,uFAAuF;YACzE,IAAI;IAoBlB,sFAAsF;YACxE,OAAO;CAetB"}

package/build/_modules/notifications/notification.service.js

@@ -0,0 +1,271 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Notification_Service = void 0;
+const crypto_1 = require("crypto");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const secret_redaction_util_1 = require("../../_collections/secret-redaction.util");
+const KINDS = ['info', 'success', 'warning', 'error'];
+/**
+ * BFR-OLDLIGHTSITE-001 — a persisted, per-account notification service: create · list · unread count ·
+ * mark read · mark all read, with an optional push publisher.
+ *
+ * @description
+ * - **The read state never jumps back.** A read only ever turns unread → read, the FIRST read's time is kept, and
+ *   nothing clears it; `markAllRead` takes an `upTo` watermark, so a notification that arrived AFTER the user looked
+ *   at the list is not marked read by a late "mark all" from another device.
+ * - **Idempotent.** A repeated `markRead` / `markAllRead` changes nothing (`updated: 0`); a producer that retries
+ *   `create` with the same `dedupeKey` gets the same notification back.
+ * - **A stable retry contract for clients.** 400 `DyNTS-NTF-IN0` = the request is wrong, do not retry; 401
+ *   `DyNTS-NTF-AU0` = no account; 503 `DyNTS-NTF-ST0` = the store failed, retry with backoff (every operation is
+ *   idempotent, so a retry is always safe).
+ */
+class DyNTS_Notification_Service {
+    store;
+    publisher;
+    eventTypes;
+    now;
+    /** Keeps the store and the optional publisher; `eventTypes` restricts `create`. */
+    constructor(settings) {
+        if (!settings?.store) {
+            throw new Error('DYNTS_NOTIFICATION_SERVICE_STORE_MISSING');
+        }
+        this.store = settings.store;
+        this.publisher = settings.publisher;
+        this.eventTypes = settings.eventTypes ? new Set(settings.eventTypes) : undefined;
+        this.now = settings.now ?? (() => new Date());
+    }
+    /** Stores a notification for one account (idempotent with `dedupeKey`) and publishes it. */
+    async create(input) {
+        const notification = this.validateCreate(input);
+        const stored = await this.call('create', () => this.store.insert(notification));
+        // a deduplicated retry returns the existing record — it was published the first time
+        if (stored._id === notification._id) {
+            await this.publish(async () => ({
+                kind: 'created', accountId: stored.accountId, notification: stored,
+                unreadCount: await this.store.countUnread(stored.accountId),
+            }));
+        }
+        return stored;
+    }
+    /** One page, newest first; `before` is the `nextCursor` of the previous page. */
+    async listForAccount(accountId, options = {}) {
+        const account = this.validateAccount(accountId);
+        const limit = DyNTS_Notification_Service.limitOf(options.limit);
+        const before = options.before
+            ? DyNTS_Notification_Service.parseCursor(options.before)
+            : undefined;
+        // one extra item tells whether an older page exists
+        const items = await this.call('list', () => this.store.list({
+            accountId: account, limit: limit + 1, before: before, unreadOnly: !!options.unreadOnly,
+        }));
+        const page = items.slice(0, limit);
+        const last = page[page.length - 1];
+        return {
+            items: page,
+            nextCursor: items.length > limit && last ? DyNTS_Notification_Service.cursorOf(last) : null,
+            unreadCount: await this.unreadCount(account),
+        };
+    }
+    async unreadCount(accountId) {
+        const account = this.validateAccount(accountId);
+        return this.call('count', () => this.store.countUnread(account));
+    }
+    /** Marks the given notifications read (the account's own only; an already read one is left as it is). */
+    async markRead(accountId, ids) {
+        const account = this.validateAccount(accountId);
+        const wanted = this.validateIds(ids);
+        const at = this.now();
+        const existing = await this.call('read', () => this.store.existingIds(account, wanted));
+        const updated = existing.length
+            ? await this.call('read', () => this.store.markSeen({ accountId: account, at: at, ids: existing }))
+            : 0;
+        const unreadCount = await this.unreadCount(account);
+        if (updated) {
+            await this.publish(() => ({
+                kind: 'read', accountId: account, ids: existing, seen: at, unreadCount: unreadCount,
+            }));
+        }
+        return {
+            updated: updated,
+            notFound: wanted.filter((id) => !existing.includes(id)),
+            unreadCount: unreadCount,
+        };
+    }
+    /**
+     * Marks every unread notification created at or before `upTo` read. Pass the time the user SAW the list (default:
+     * now), so a notification that arrived later stays unread.
+     */
+    async markAllRead(accountId, upTo) {
+        const account = this.validateAccount(accountId);
+        const at = this.now();
+        const requested = upTo === undefined || upTo === null ? at : new Date(upTo);
+        if (Number.isNaN(requested.getTime())) {
+            throw this.invalid(['upTo must be a date']);
+        }
+        // never later than this request: a fast client clock must not reach notifications created meanwhile
+        const watermark = requested.getTime() > at.getTime() ? at : requested;
+        const updated = await this.call('read-all', () => (this.store.markSeen({ accountId: account, at: at, upTo: watermark })));
+        const unreadCount = await this.unreadCount(account);
+        if (updated) {
+            await this.publish(() => ({
+                kind: 'read-all', accountId: account, upTo: watermark, seen: at, unreadCount: unreadCount,
+            }));
+        }
+        return { updated: updated, notFound: [], unreadCount: unreadCount };
+    }
+    /** The opaque paging cursor of a record. */
+    static cursorOf(record) {
+        return Buffer.from(`${record.__created.toISOString()}|${record._id}`).toString('base64url');
+    }
+    static parseCursor(cursor) {
+        const [iso, id] = Buffer.from(String(cursor), 'base64url').toString('utf8').split('|');
+        const created = new Date(iso);
+        if (!id || Number.isNaN(created.getTime())) {
+            throw DyNTS_Notification_Service.invalidStatic(['before is not a valid cursor']);
+        }
+        return { created: created, id: id };
+    }
+    static limitOf(limit) {
+        const value = Math.floor(Number(limit ?? 20));
+        return Number.isFinite(value) ? Math.min(100, Math.max(1, value)) : 20;
+    }
+    validateCreate(input) {
+        const problems = [];
+        const text = (value, max) => typeof value === 'string' && value.trim().length > 0
+            && value.length <= max;
+        const eventType = String(input?.eventType ?? '');
+        if (!text(input?.accountId, 200)) {
+            problems.push('accountId is required (at most 200 characters)');
+        }
+        if (!/^[a-z0-9][a-z0-9._-]{0,99}$/.test(eventType)) {
+            problems.push('eventType must be a lowercase identifier (a-z, 0-9, . _ -), at most 100 characters');
+        }
+        else if (this.eventTypes && !this.eventTypes.has(eventType)) {
+            problems.push(`eventType ${eventType} is not one of the configured event types`);
+        }
+        if (!text(input?.title, 200)) {
+            problems.push('title is required (at most 200 characters)');
+        }
+        if (input?.message !== undefined && (typeof input.message !== 'string' || input.message.length > 4000)) {
+            problems.push('message must be a string of at most 4000 characters');
+        }
+        if (input?.type !== undefined && !KINDS.includes(input.type)) {
+            problems.push(`type must be one of ${KINDS.join(', ')}`);
+        }
+        if (input?.routerLink !== undefined
+            && (typeof input.routerLink !== 'string' || !/^\/(?!\/)/.test(input.routerLink)
+                || input.routerLink.length > 2000)) {
+            // an app route only: an absolute, protocol-relative or `javascript:` link would turn a notification into a lure
+            problems.push('routerLink must be an app-internal path starting with a single /');
+        }
+        if (input?.queryParams !== undefined && !DyNTS_Notification_Service.isQueryParams(input.queryParams)) {
+            problems.push('queryParams must be an object of at most 20 string or number values');
+        }
+        if (input?.payload !== undefined && !DyNTS_Notification_Service.isSmallJsonObject(input.payload)) {
+            problems.push('payload must be a JSON object of at most 16 KB');
+        }
+        if (input?.dedupeKey !== undefined && !text(input.dedupeKey, 200)) {
+            problems.push('dedupeKey must be a non-empty string of at most 200 characters');
+        }
+        if (problems.length) {
+            throw this.invalid(problems);
+        }
+        return {
+            _id: (0, crypto_1.randomUUID)(),
+            accountId: input.accountId.trim(),
+            eventType: eventType,
+            title: input.title.trim(),
+            message: input.message,
+            type: input.type ?? 'info',
+            routerLink: input.routerLink,
+            queryParams: input.queryParams ? { ...input.queryParams } : undefined,
+            payload: input.payload ? JSON.parse(JSON.stringify(input.payload)) : undefined,
+            dedupeKey: input.dedupeKey,
+            seen: null,
+            __created: this.now(),
+        };
+    }
+    validateAccount(accountId) {
+        if (typeof accountId !== 'string' || !accountId.trim() || accountId.length > 200) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                status: 401,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-NTF-AU0`,
+                message: 'Notifications: no account on the request.',
+                userMessage: 'Please sign in to see your notifications.',
+            });
+        }
+        return accountId.trim();
+    }
+    validateIds(ids) {
+        if (!Array.isArray(ids) || !ids.length || ids.length > 500
+            || ids.some((id) => typeof id !== 'string' || !id || id.length > 200)) {
+            throw this.invalid(['ids must be 1–500 non-empty strings']);
+        }
+        return [...new Set(ids)];
+    }
+    static isQueryParams(value) {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            return false;
+        }
+        const entries = Object.entries(value);
+        return entries.length <= 20 && entries.every(([, item]) => (typeof item === 'string' || (typeof item === 'number' && Number.isFinite(item))));
+    }
+    static isSmallJsonObject(value) {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            return false;
+        }
+        try {
+            return Buffer.byteLength(JSON.stringify(value), 'utf8') <= 16 * 1024;
+        }
+        catch {
+            return false;
+        }
+    }
+    invalid(problems) {
+        return DyNTS_Notification_Service.invalidStatic(problems);
+    }
+    static invalidStatic(problems) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: 400,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-NTF-IN0`,
+            message: `Notification request rejected: ${problems.join('; ')}`,
+            userMessage: 'The notification request is invalid.',
+            additionalContent: { problems: problems },
+        });
+    }
+    /** A store call; a failure becomes a retryable 503 (every operation is idempotent). */
+    async call(operation, run) {
+        try {
+            return await run();
+        }
+        catch (error) {
+            if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                throw error;
+            }
+            throw new fsm_dynamo_1.DyFM_Error({
+                status: 503,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-NTF-ST0`,
+                message: `Notification store ${operation} failed: `
+                    + secret_redaction_util_1.DyNTS_SecretRedaction_Util.redactText(fsm_dynamo_1.DyFM_Error.getErrorMessage(error)),
+                userMessage: 'Notifications are not available at the moment. Please try again.',
+                error: secret_redaction_util_1.DyNTS_SecretRedaction_Util.redactErrorForLog(error),
+                additionalContent: { operation: operation, retryable: true },
+            });
+        }
+    }
+    /** Best effort: a failing publisher (or its unread count) is logged, never thrown. */
+    async publish(build) {
+        if (!this.publisher) {
+            return;
+        }
+        try {
+            await this.publisher(await build());
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn(`[DyNTS notifications] the push failed (the stored state is intact): ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`);
+        }
+    }
+}
+exports.DyNTS_Notification_Service = DyNTS_Notification_Service;
+//# sourceMappingURL=notification.service.js.map

package/build/_modules/notifications/notification.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.service.js","sourceRoot":"","sources":["../../../src/_modules/notifications/notification.service.ts"],"names":[],"mappings":"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"}

package/build/_modules/notifications/notifications.controller.d.ts

@@ -0,0 +1,31 @@
+import { Request, Response } from 'express';
+import { DyNTS_Controller } from '../../_services/route/controller.service';
+import { DyNTS_Notification_Service } from './notification.service';
+/** BFR-OLDLIGHTSITE-001 — the notification routes' configuration. */
+export interface DyNTS_NotificationsController_Config {
+    service: DyNTS_Notification_Service;
+    /** REQUIRED: every route is per account, so it must be authenticated. */
+    authPreProcess: (req: Request, res: Response) => Promise<void>;
+    /** The account of the request (default: the auth service's issuer — `fdp-issuer-is-account-id`). */
+    resolveAccountId?: (req: Request) => string | undefined;
+}
+/**
+ * BFR-OLDLIGHTSITE-001 — the account's own notifications over HTTP (creating one is a server-side call of the
+ * service, never a route):
+ *
+ * - `GET  /list?limit=20&before=<cursor>&unreadOnly=true` → `{ items, nextCursor, unreadCount }`
+ * - `GET  /unread-count` → `{ unreadCount }`
+ * - `POST /read` `{ ids: string[] }` → `{ updated, notFound, unreadCount }`
+ * - `POST /read-all` `{ upTo?: ISO date }` → `{ updated, notFound: [], unreadCount }`
+ */
+export declare class DyNTS_Notifications_Controller extends DyNTS_Controller {
+    private static config;
+    static configure(config: DyNTS_NotificationsController_Config): void;
+    static getInstance(): DyNTS_Notifications_Controller;
+    /** The current configuration — read on EVERY request, so a reconfiguration never leaves a stale service or auth. */
+    static requireConfig(): DyNTS_NotificationsController_Config;
+    setupEndpoints(): void;
+    /** The request's account — a missing one is a 401 (never an "empty account" read). */
+    static accountOf(req: Request): string;
+}
+//# sourceMappingURL=notifications.controller.d.ts.map

package/build/_modules/notifications/notifications.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.controller.d.ts","sourceRoot":"","sources":["../../../src/_modules/notifications/notifications.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAO5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,qEAAqE;AACrE,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,0BAA0B,CAAC;IACpC,yEAAyE;IACzE,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,qBAAa,8BAA+B,SAAQ,gBAAgB;IAClE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAqD;IAE1E,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,oCAAoC,GAAG,IAAI;IAOpE,MAAM,CAAC,WAAW,IAAI,8BAA8B;IAIpD,oHAAoH;IACpH,MAAM,CAAC,aAAa,IAAI,oCAAoC;IAY5D,cAAc,IAAI,IAAI;IA8DtB,sFAAsF;IACtF,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;CAuBvC"}

package/build/_modules/notifications/notifications.controller.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Notifications_Controller = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const endpoint_params_control_model_1 = require("../../_models/control-models/endpoint-params.control-model");
+const global_service_1 = require("../../_services/core/global.service");
+const controller_service_1 = require("../../_services/route/controller.service");
+/**
+ * BFR-OLDLIGHTSITE-001 — the account's own notifications over HTTP (creating one is a server-side call of the
+ * service, never a route):
+ *
+ * - `GET  /list?limit=20&before=<cursor>&unreadOnly=true` → `{ items, nextCursor, unreadCount }`
+ * - `GET  /unread-count` → `{ unreadCount }`
+ * - `POST /read` `{ ids: string[] }` → `{ updated, notFound, unreadCount }`
+ * - `POST /read-all` `{ upTo?: ISO date }` → `{ updated, notFound: [], unreadCount }`
+ */
+class DyNTS_Notifications_Controller extends controller_service_1.DyNTS_Controller {
+    static config = null;
+    static configure(config) {
+        if (!config?.service || typeof config.authPreProcess !== 'function') {
+            throw new Error('DYNTS_NOTIFICATIONS_CONTROLLER_CONFIG_INVALID: a service and an authPreProcess are required');
+        }
+        DyNTS_Notifications_Controller.config = config;
+    }
+    static getInstance() {
+        return DyNTS_Notifications_Controller.getSingletonInstance();
+    }
+    /** The current configuration — read on EVERY request, so a reconfiguration never leaves a stale service or auth. */
+    static requireConfig() {
+        const config = DyNTS_Notifications_Controller.config;
+        if (!config) {
+            throw new Error('DYNTS_NOTIFICATIONS_CONTROLLER_NOT_CONFIGURED: call DyNTS_getNotificationsRoutingModule(config)');
+        }
+        return config;
+    }
+    setupEndpoints() {
+        DyNTS_Notifications_Controller.requireConfig();
+        const auth = [
+            (req, res) => (DyNTS_Notifications_Controller.requireConfig().authPreProcess(req, res)),
+        ];
+        const service = () => DyNTS_Notifications_Controller.requireConfig().service;
+        this.endpoints = [
+            new endpoint_params_control_model_1.DyNTS_Endpoint_Params({
+                name: 'listNotifications',
+                type: fsm_dynamo_1.DyFM_HttpCallType.get,
+                endpoint: '/list',
+                preProcesses: auth,
+                tasks: [
+                    async (req, res) => {
+                        res.send(await service().listForAccount(DyNTS_Notifications_Controller.accountOf(req), {
+                            limit: req.query.limit === undefined ? undefined : Number(req.query.limit),
+                            before: typeof req.query.before === 'string' ? req.query.before : undefined,
+                            unreadOnly: req.query.unreadOnly === 'true',
+                        }));
+                    },
+                ],
+            }),
+            new endpoint_params_control_model_1.DyNTS_Endpoint_Params({
+                name: 'unreadNotificationCount',
+                type: fsm_dynamo_1.DyFM_HttpCallType.get,
+                endpoint: '/unread-count',
+                preProcesses: auth,
+                tasks: [
+                    async (req, res) => {
+                        res.send({ unreadCount: await service().unreadCount(DyNTS_Notifications_Controller.accountOf(req)) });
+                    },
+                ],
+            }),
+            new endpoint_params_control_model_1.DyNTS_Endpoint_Params({
+                name: 'markNotificationsRead',
+                type: fsm_dynamo_1.DyFM_HttpCallType.post,
+                endpoint: '/read',
+                preProcesses: auth,
+                tasks: [
+                    async (req, res) => {
+                        res.send(await service().markRead(DyNTS_Notifications_Controller.accountOf(req), req.body?.ids));
+                    },
+                ],
+            }),
+            new endpoint_params_control_model_1.DyNTS_Endpoint_Params({
+                name: 'markAllNotificationsRead',
+                type: fsm_dynamo_1.DyFM_HttpCallType.post,
+                endpoint: '/read-all',
+                preProcesses: auth,
+                tasks: [
+                    async (req, res) => {
+                        res.send(await service().markAllRead(DyNTS_Notifications_Controller.accountOf(req), req.body?.upTo));
+                    },
+                ],
+            }),
+        ];
+    }
+    /** The request's account — a missing one is a 401 (never an "empty account" read). */
+    static accountOf(req) {
+        const config = DyNTS_Notifications_Controller.config;
+        let accountId;
+        try {
+            accountId = config?.resolveAccountId
+                ? config.resolveAccountId(req)
+                : global_service_1.DyNTS_GlobalService.getAuthService()?.getIssuerFromRequest(req);
+        }
+        catch {
+            accountId = undefined;
+        }
+        if (!accountId || accountId === 'unknown') {
+            throw new fsm_dynamo_1.DyFM_Error({
+                status: 401,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-NTF-AU0`,
+                message: 'Notifications: the request has no account.',
+                userMessage: 'Please sign in to see your notifications.',
+            });
+        }
+        return accountId;
+    }
+}
+exports.DyNTS_Notifications_Controller = DyNTS_Notifications_Controller;
+//# sourceMappingURL=notifications.controller.js.map

package/build/_modules/notifications/notifications.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.controller.js","sourceRoot":"","sources":["../../../src/_modules/notifications/notifications.controller.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.362",
+  "version": "01.15.363",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -332,6 +332,12 @@
       "module": "./build/_modules/git-sync/index.js",
       "types": "./build/_modules/git-sync/index.d.ts",
       "typings": "./build/_modules/git-sync/index.d.ts"
+    },
+    "./notifications": {
+      "default": "./build/_modules/notifications/index.js",
+      "module": "./build/_modules/notifications/index.js",
+      "types": "./build/_modules/notifications/index.d.ts",
+      "typings": "./build/_modules/notifications/index.d.ts"
     }
   },
   "typesVersions": {
@@ -461,6 +467,9 @@
       ],
       "git-sync": [
         "build/_modules/git-sync/index.d.ts"
+      ],
+      "notifications": [
+        "build/_modules/notifications/index.d.ts"
       ]
     }
   },