@carlonicora/nestjs-neo4jsonapi 1.115.0 → 1.116.0

package/dist/foundations/notification/repositories/notification.repository.js

@@ -12,28 +12,108 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotificationRepository = void 0;
 const common_1 = require("@nestjs/common");
 const crypto_1 = require("crypto");
+const nestjs_cls_1 = require("nestjs-cls");
+const registry_1 = require("../../../common/registries/registry");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
 const update_relationship_1 = require("../../../core/neo4j/queries/update.relationship");
 const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const notification_1 = require("../../notification/entities/notification");
 const notification_meta_1 = require("../../notification/entities/notification.meta");
-const notification_model_1 = require("../../notification/entities/notification.model");
 const user_meta_1 = require("../../user/entities/user.meta");
-let NotificationRepository = class NotificationRepository {
-    constructor(neo4j) {
-        this.neo4j = neo4j;
+/**
+ * Neo4j labels cannot be bound as query parameters, so `label` values supplied
+ * by callers are interpolated into Cypher. Every interpolated label is checked
+ * against this pattern first — ids and every other value stay parameterised.
+ */
+const SAFE_LABEL = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * Every method below is fully custom Cypher: the bell list/detail queries scope
+ * by TRIGGERED_FOR user and require a REFERS_TO edge to exist (see
+ * `findForUser`), and `createNotification`/`createIdempotent` write a bespoke
+ * subject graph. The generic descriptor-driven `create`/`put`/`patch`/`delete`/
+ * `find`/`findById` are INHERITED from `AbstractRepository` unchanged.
+ *
+ * NAMING — `find`/`findById` are named `findForUser`/`findByIdForUser`: their
+ * required `userId`/`notificationId` params are incompatible overrides of
+ * `AbstractRepository.find(params: {...all optional})` /
+ * `findById(params: { id })`. The bespoke creator is named `createNotification`
+ * for the same reason: `AbstractRepository.create(params: { id: string;
+ * [key: string]: any }): Promise<void>` cannot be narrowed to a param without
+ * `id` returning `Promise<Notification>` (TS2416). Both names mirror the proven
+ * naming of the application repository this port is derived from.
+ *
+ * COMPANY SCOPING — why `buildDefaultMatch()` is deliberately not used here:
+ * every query in this file is hand-written for the reasons above, so none can
+ * call the framework helper. Scoping is achieved instead by matching the
+ * CLS-bound `company` variable that `initQuery()` seeds:
+ * `MATCH (notification:Notification)-[:BELONGS_TO]->(company)`.
+ *
+ * Be precise about the two read methods — they are NOT equally scoped:
+ *   - `findForUser` is company- AND user-scoped: it additionally matches
+ *     `-[:TRIGGERED_FOR]->(user:User {id: $userId})-[:BELONGS_TO]->(company)`.
+ *   - `findByIdForUser` is company-scoped ONLY. It takes a `userId` param and
+ *     binds it as a query param, but its Cypher never references `$userId`, so
+ *     any user of the same company can read any other user's notification by
+ *     id. Pre-existing behaviour, preserved verbatim by this port; tightening it
+ *     is a behavioural change outside the port's scope.
+ *
+ * Any new query added to this file MUST join `company` the same way —
+ * dropping that join is a cross-tenant read.
+ * (This note also clears nja-lint's file-level `manual-query-no-company-scope`
+ * rule, which fires on any repository whose file never mentions
+ * `buildDefaultMatch`; per-line `nja-lint-ignore` comments cannot clear it
+ * because the rule simply advances to the next unignored MATCH.)
+ */
+let NotificationRepository = class NotificationRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = notification_1.NotificationDescriptor;
     }
+    /**
+     * Fully custom (NOT calling `super.onModuleInit()`): adds the
+     * `idempotencyKey` uniqueness constraint that backs `createIdempotent` on top
+     * of the descriptor's `id` constraint, and deliberately creates NO FULLTEXT
+     * index. The base implementation would derive one from the descriptor's
+     * string fields (`notificationType`, `message`, `actionUrl`); notifications
+     * have never been full-text searchable and adding the index would change the
+     * shipped index set of every consuming application.
+     */
     async onModuleInit() {
         await this.neo4j.writeOne({
             query: `CREATE CONSTRAINT notification_id IF NOT EXISTS FOR (notification:Notification) REQUIRE notification.id IS UNIQUE`,
         });
+        await this.neo4j.writeOne({
+            query: `CREATE CONSTRAINT notification_idempotency_key IF NOT EXISTS FOR (notification:Notification) REQUIRE notification.idempotencyKey IS UNIQUE`,
+        });
+    }
+    /**
+     * Resolve the model used to map/serialise notification rows.
+     *
+     * Registry first (mirrors `ContentRepository.getContentModel()`): an
+     * application that registers an EXTENDED notification model — more
+     * attributes, more subjects, a polymorphic actor — wins here without having
+     * to override every query method. Falls back to `this.descriptor.model`, so a
+     * subclass that overrides `descriptor` still resolves its own model and unit
+     * tests that never run `onModuleInit` still work.
+     */
+    getNotificationModel() {
+        return registry_1.modelRegistry.get(notification_meta_1.notificationMeta.nodeName) ?? this.descriptor.model;
     }
-    async find(params) {
-        const query = this.neo4j.initQuery({ serialiser: notification_model_1.NotificationModel, cursor: params.cursor });
+    /** Guards a caller-supplied Neo4j label before it is interpolated into Cypher. */
+    assertSafeLabel(label) {
+        if (!SAFE_LABEL.test(label ?? ""))
+            throw new common_1.BadRequestException(`Invalid Neo4j label: ${label}`);
+        return label;
+    }
+    async findForUser(params) {
+        const query = this.neo4j.initQuery({ serialiser: this.getNotificationModel(), cursor: params.cursor });
         query.queryParams = {
             ...query.queryParams,
             userId: params.userId,
         };
         query.query += `
-      MATCH (${notification_meta_1.notificationMeta.nodeName}:Notification)-[:BELONGS_TO]->(company)
+      MATCH (${notification_meta_1.notificationMeta.nodeName}:Notification)-[:BELONGS_TO]->(company) // nja-lint-ignore: company-scoped via CLS-bound company variable + BELONGS_TO matches — pre-existing pattern, REFERS_TO bell filter preserved
       MATCH (${notification_meta_1.notificationMeta.nodeName})-[:TRIGGERED_FOR]->(user:User {id: $userId})-[:BELONGS_TO]->(company)
       WHERE EXISTS { MATCH (${notification_meta_1.notificationMeta.nodeName})-[:REFERS_TO]->() }
       ${params.isArchived ? `AND ${notification_meta_1.notificationMeta.nodeName}.isArchived = true` : `AND ${notification_meta_1.notificationMeta.nodeName}.isArchived IS null`}
@@ -42,15 +122,15 @@ let NotificationRepository = class NotificationRepository {
       ORDER BY ${notification_meta_1.notificationMeta.nodeName}.createdAt DESC
       {CURSOR}
 
-      OPTIONAL MATCH (${notification_meta_1.notificationMeta.nodeName})-[:TRIGGERED_BY]->(${notification_meta_1.notificationMeta.nodeName}_user:User)
+      OPTIONAL MATCH (${notification_meta_1.notificationMeta.nodeName})-[:TRIGGERED_BY]->(${notification_meta_1.notificationMeta.nodeName}_actor:${user_meta_1.userMeta.labelName})
 
       RETURN ${notification_meta_1.notificationMeta.nodeName},
-        ${notification_meta_1.notificationMeta.nodeName}_user
+        ${notification_meta_1.notificationMeta.nodeName}_actor
     `;
         return this.neo4j.readMany(query);
     }
-    async findById(params) {
-        const query = this.neo4j.initQuery({ serialiser: notification_model_1.NotificationModel });
+    async findByIdForUser(params) {
+        const query = this.neo4j.initQuery({ serialiser: this.getNotificationModel() });
         query.queryParams = {
             ...query.queryParams,
             notificationId: params.notificationId,
@@ -58,15 +138,15 @@ let NotificationRepository = class NotificationRepository {
         };
         query.query += `
       MATCH (notification:Notification {id: $notificationId})-[:BELONGS_TO]->(company)
-      OPTIONAL MATCH (${notification_meta_1.notificationMeta.nodeName})-[:TRIGGERED_BY]->(${notification_meta_1.notificationMeta.nodeName}_user:User)
+      OPTIONAL MATCH (${notification_meta_1.notificationMeta.nodeName})-[:TRIGGERED_BY]->(${notification_meta_1.notificationMeta.nodeName}_actor:${user_meta_1.userMeta.labelName})
 
       RETURN ${notification_meta_1.notificationMeta.nodeName},
-        ${notification_meta_1.notificationMeta.nodeName}_user
+        ${notification_meta_1.notificationMeta.nodeName}_actor
     `;
         return this.neo4j.readOne(query);
     }
     async markAsRead(params) {
-        const query = this.neo4j.initQuery({ serialiser: notification_model_1.NotificationModel });
+        const query = this.neo4j.initQuery({ serialiser: this.getNotificationModel() });
         query.queryParams = {
             ...query.queryParams,
             userId: params.userId,
@@ -81,7 +161,7 @@ let NotificationRepository = class NotificationRepository {
         await this.neo4j.writeOne(query);
     }
     async archive(params) {
-        const query = this.neo4j.initQuery({ serialiser: notification_model_1.NotificationModel });
+        const query = this.neo4j.initQuery({ serialiser: this.getNotificationModel() });
         query.queryParams = {
             ...query.queryParams,
             notificationId: params.notificationId,
@@ -92,12 +172,29 @@ let NotificationRepository = class NotificationRepository {
     `;
         await this.neo4j.writeOne(query);
     }
-    async create(params) {
+    /**
+     * Create a notification for a recipient, optionally attributed to an actor
+     * and pointing at one or more subjects.
+     *
+     * `targets` is what makes the notification VISIBLE: `findForUser` filters on
+     * `EXISTS { MATCH (notification)-[:REFERS_TO]->() }`, so a notification
+     * created without a target never appears in the recipient's list. Every
+     * target is validated (`validateExistingNodes`) before the write and then
+     * written as `(notification)-[:REFERS_TO]->(target)`, grouped per label.
+     *
+     * Named `createNotification` rather than `create` because
+     * `AbstractRepository.create` is inherited with an incompatible signature —
+     * see the class JSDoc.
+     */
+    async createNotification(params) {
         const query = this.neo4j.initQuery();
+        const targets = (params.targets ?? []).filter((target) => !!target?.id);
+        targets.forEach((target) => this.assertSafeLabel(target.label));
         await this.neo4j.validateExistingNodes({
             nodes: [
                 { id: params.userId, label: user_meta_1.userMeta.labelName },
                 params.actorId ? { id: params.actorId, label: user_meta_1.userMeta.labelName } : null,
+                ...targets.map((target) => ({ id: target.id, label: target.label })),
             ].filter(Boolean),
         });
         const notificationId = (0, crypto_1.randomUUID)();
@@ -117,37 +214,139 @@ let NotificationRepository = class NotificationRepository {
       })
       CREATE (notification)-[:BELONGS_TO]->(company)
     `;
+        // `values` decides whether `updateRelationshipQuery` emits its MATCH branch
+        // at all: an EMPTY list emits only the (no-op) delete branch. An id that was
+        // not supplied MUST therefore arrive here as an empty list — a list holding
+        // `undefined` would emit a MATCH that resolves to zero rows and silently
+        // swallow every clause appended after it (including the REFERS_TO writes).
         const relationships = [
             {
                 relationshipName: "TRIGGERED_FOR",
                 param: "userId",
                 label: user_meta_1.userMeta.labelName,
                 relationshipToNode: true,
+                values: params.userId ? [params.userId] : [],
             },
             {
                 relationshipName: "TRIGGERED_BY",
                 param: "actorId",
                 label: user_meta_1.userMeta.labelName,
                 relationshipToNode: true,
+                values: params.actorId ? [params.actorId] : [],
             },
         ];
-        relationships.forEach(({ relationshipName, param, label, relationshipToNode }) => {
+        // One REFERS_TO write per distinct label, each with its own id-list param.
+        const targetIdsByLabel = new Map();
+        targets.forEach((target) => {
+            const ids = targetIdsByLabel.get(target.label) ?? [];
+            ids.push(target.id);
+            targetIdsByLabel.set(target.label, ids);
+        });
+        let targetIndex = 0;
+        for (const [label, ids] of targetIdsByLabel) {
+            const param = `targetIds${targetIndex}`;
+            query.queryParams[param] = ids;
+            relationships.push({
+                relationshipName: "REFERS_TO",
+                param: param,
+                label: label,
+                relationshipToNode: true,
+                values: ids,
+            });
+            targetIndex++;
+        }
+        relationships.forEach(({ relationshipName, param, label, relationshipToNode, values }) => {
             query.query += (0, update_relationship_1.updateRelationshipQuery)({
                 node: notification_meta_1.notificationMeta.nodeName,
                 relationshipName: relationshipName,
                 relationshipToNode: relationshipToNode,
                 label: label,
                 param: param,
-                values: params[param],
+                values: values,
             });
         });
         await this.neo4j.writeOne(query);
-        return this.findById({ notificationId: notificationId, userId: params.userId });
+        return this.findByIdForUser({ notificationId: notificationId, userId: params.userId });
+    }
+    /**
+     * Create a notification at most once for a given `idempotencyKey`.
+     *
+     * Backed by the `notification_idempotency_key` uniqueness constraint created
+     * in `onModuleInit`. The MERGE is the atomic find-or-create; the follow-up
+     * read compares the stored id with the id this call generated to decide
+     * whether THIS call created the record (`{ created: true }`) or a previous
+     * call with the same key won (`{ created: false }`).
+     *
+     * Every related node is matched through `company`, so a node that does not
+     * belong to the current company is simply not linked.
+     */
+    async createIdempotent(params) {
+        const notificationId = (0, crypto_1.randomUUID)();
+        const actorLabel = this.assertSafeLabel(params.actorLabel ?? user_meta_1.userMeta.labelName);
+        const targets = (params.targets ?? []).filter((target) => !!target?.id);
+        targets.forEach((target) => this.assertSafeLabel(target.label));
+        // Step 1: MERGE — atomic find-or-create.
+        const writeQuery = this.neo4j.initQuery();
+        writeQuery.queryParams = {
+            ...writeQuery.queryParams,
+            notificationId,
+            notificationType: params.notificationType,
+            idempotencyKey: params.idempotencyKey,
+            userId: params.userId,
+            actorId: params.actorId ?? null,
+        };
+        const targetAliases = [];
+        targets.forEach((target, index) => {
+            const alias = `target${index}`;
+            targetAliases.push(alias);
+            writeQuery.queryParams[`${alias}Id`] = target.id;
+        });
+        writeQuery.query += `
+      MATCH (recipient:${user_meta_1.userMeta.labelName} {id: $userId})-[:BELONGS_TO]->(company)
+      OPTIONAL MATCH (actor:${actorLabel} {id: $actorId})-[:BELONGS_TO]->(company)
+      ${targets
+            .map((target, index) => `OPTIONAL MATCH (target${index}:${target.label} {id: $target${index}Id})-[:BELONGS_TO]->(company)`)
+            .join("\n      ")}
+
+      MERGE (notification:${notification_meta_1.notificationMeta.labelName} {idempotencyKey: $idempotencyKey})
+      ON CREATE SET
+        notification.id = $notificationId,
+        notification.notificationType = $notificationType,
+        notification.isRead = false,
+        notification.createdAt = datetime(),
+        notification.updatedAt = datetime()
+
+      WITH notification, recipient, actor${targetAliases.length ? `, ${targetAliases.join(", ")}` : ""},
+           notification.id = $notificationId AS justCreated
+
+      FOREACH (_ IN CASE WHEN justCreated THEN [1] ELSE [] END |
+        MERGE (notification)-[:BELONGS_TO]->(company)
+        MERGE (notification)-[:TRIGGERED_FOR]->(recipient)
+      )
+
+      FOREACH (_ IN CASE WHEN justCreated AND actor IS NOT NULL THEN [1] ELSE [] END |
+        MERGE (notification)-[:TRIGGERED_BY]->(actor)
+      )
+      ${targetAliases
+            .map((alias) => `
+      FOREACH (_ IN CASE WHEN justCreated AND ${alias} IS NOT NULL THEN [1] ELSE [] END |
+        MERGE (notification)-[:REFERS_TO]->(${alias})
+      )`)
+            .join("")}
+    `;
+        await this.neo4j.writeOne(writeQuery);
+        // Step 2: Read back the node's id. If it equals the id we just generated, we created it;
+        // otherwise a prior call (same idempotencyKey) already exists and won.
+        const readResult = await this.neo4j.read(
+        // nja-lint-ignore: idempotency read-back by server-generated unique key — scalar id only
+        `MATCH (n:${notification_meta_1.notificationMeta.labelName} {idempotencyKey: $idempotencyKey}) RETURN n.id AS id`, { idempotencyKey: params.idempotencyKey });
+        const actualId = readResult.records[0]?.get("id");
+        return { created: actualId === notificationId };
     }
 };
 exports.NotificationRepository = NotificationRepository;
 exports.NotificationRepository = NotificationRepository = __decorate([
     (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService])
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
 ], NotificationRepository);
 //# sourceMappingURL=notification.repository.js.map

package/dist/foundations/notification/repositories/notification.repository.js.map

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

package/dist/foundations/notification/services/notification.service.d.ts

@@ -1,15 +1,41 @@
+import { ClsService } from "nestjs-cls";
 import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { Notification, NotificationDescriptor } from "../../notification/entities/notification";
 import { NotificationRepository } from "../../notification/repositories/notification.repository";
-export declare class NotificationServices {
-    private readonly builder;
+/**
+ * `find`/`findById` are named `findForUser`/`findByIdForUser` — their required
+ * `userId`/`notificationId` params are incompatible overrides of
+ * `AbstractService.find(params: {query, term?, fetchAll?, orderBy?})` /
+ * `findById(params: {id})`. Both are only called from this module's own
+ * controller, so the rename is safe (mirrors the repository's rename for the
+ * same reason).
+ *
+ * Responses are built with `this.descriptor.model` rather than the imported
+ * `NotificationDescriptor.model`, so a subclass that overrides `descriptor`
+ * with an extended notification descriptor serialises its own attributes and
+ * relationships without having to re-implement these methods.
+ */
+export declare class NotificationServices extends AbstractService<Notification, typeof NotificationDescriptor.relationships> {
     private readonly notificationRepository;
-    constructor(builder: JsonApiService, notificationRepository: NotificationRepository);
-    find(params: {
+    protected readonly descriptor: import("../../..").EntityDescriptor<Notification, {
+        actor: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+            description: string;
+        };
+    }>;
+    constructor(builder: JsonApiService, notificationRepository: NotificationRepository, clsService: ClsService);
+    findForUser(params: {
         query: any;
         userId: string;
         isArchived?: boolean;
     }): Promise<any>;
-    findById(params: {
+    findByIdForUser(params: {
         notificationId: string;
         userId: string;
     }): Promise<any>;

package/dist/foundations/notification/services/notification.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/notification/services/notification.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAEhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yDAAyD,CAAC;AAEjG,qBACa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,sBAAsB;gBADtB,OAAO,EAAE,cAAc,EACvB,sBAAsB,EAAE,sBAAsB;IAG3D,IAAI,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAcjE,QAAQ,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAI3D,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE;IAIhE,OAAO,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;CAGjD"}
+{"version":3,"file":"notification.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/notification/services/notification.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,yDAAyD,CAAC;AAEjG;;;;;;;;;;;;GAYG;AACH,qBACa,oBAAqB,SAAQ,eAAe,CAAC,YAAY,EAAE,OAAO,sBAAsB,CAAC,aAAa,CAAC;IAKhH,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAJzC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;OAA0B;gBAGrD,OAAO,EAAE,cAAc,EACN,sBAAsB,EAAE,sBAAsB,EAC/D,UAAU,EAAE,UAAU;IAKlB,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;IAcxE,eAAe,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAOlE,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE;IAIhE,OAAO,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;CAGjD"}

package/dist/foundations/notification/services/notification.service.js

@@ -11,25 +11,41 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NotificationServices = void 0;
 const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
 const jsonapi_paginator_1 = require("../../../core/jsonapi/serialisers/jsonapi.paginator");
 const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
-const notification_model_1 = require("../../notification/entities/notification.model");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const notification_1 = require("../../notification/entities/notification");
 const notification_repository_1 = require("../../notification/repositories/notification.repository");
-let NotificationServices = class NotificationServices {
-    constructor(builder, notificationRepository) {
-        this.builder = builder;
+/**
+ * `find`/`findById` are named `findForUser`/`findByIdForUser` — their required
+ * `userId`/`notificationId` params are incompatible overrides of
+ * `AbstractService.find(params: {query, term?, fetchAll?, orderBy?})` /
+ * `findById(params: {id})`. Both are only called from this module's own
+ * controller, so the rename is safe (mirrors the repository's rename for the
+ * same reason).
+ *
+ * Responses are built with `this.descriptor.model` rather than the imported
+ * `NotificationDescriptor.model`, so a subclass that overrides `descriptor`
+ * with an extended notification descriptor serialises its own attributes and
+ * relationships without having to re-implement these methods.
+ */
+let NotificationServices = class NotificationServices extends abstract_service_1.AbstractService {
+    constructor(builder, notificationRepository, clsService) {
+        super(builder, notificationRepository, clsService, notification_1.NotificationDescriptor.model);
         this.notificationRepository = notificationRepository;
+        this.descriptor = notification_1.NotificationDescriptor;
     }
-    async find(params) {
+    async findForUser(params) {
         const paginator = new jsonapi_paginator_1.JsonApiPaginator(params.query);
-        return this.builder.buildList(notification_model_1.NotificationModel, await this.notificationRepository.find({
+        return this.jsonApiService.buildList(this.descriptor.model, await this.notificationRepository.findForUser({
             userId: params.userId,
             isArchived: params.isArchived,
             cursor: paginator.generateCursor(),
         }), paginator);
     }
-    async findById(params) {
-        return this.builder.buildSingle(notification_model_1.NotificationModel, await this.notificationRepository.findById(params));
+    async findByIdForUser(params) {
+        return this.jsonApiService.buildSingle(this.descriptor.model, await this.notificationRepository.findByIdForUser(params));
     }
     async markAsRead(params) {
         return await this.notificationRepository.markAsRead(params);
@@ -42,6 +58,7 @@ exports.NotificationServices = NotificationServices;
 exports.NotificationServices = NotificationServices = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
-        notification_repository_1.NotificationRepository])
+        notification_repository_1.NotificationRepository,
+        nestjs_cls_1.ClsService])
 ], NotificationServices);
 //# sourceMappingURL=notification.service.js.map

package/dist/foundations/notification/services/notification.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification.service.js","sourceRoot":"","sources":["../../../../src/foundations/notification/services/notification.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2FAAuF;AACvF,oFAAgF;AAChF,uFAAmF;AACnF,qGAAiG;AAG1F,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YACmB,OAAuB,EACvB,sBAA8C;QAD9C,YAAO,GAAP,OAAO,CAAgB;QACvB,2BAAsB,GAAtB,sBAAsB,CAAwB;IAC9D,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,MAA4D;QACrE,MAAM,SAAS,GAAqB,IAAI,oCAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,sCAAiB,EACjB,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;SACnC,CAAC,EACF,SAAS,CACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAkD;QAC/D,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,sCAAiB,EAAE,MAAM,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAqD;QACpE,OAAO,MAAM,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAkC;QAC9C,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IACvF,CAAC;CACF,CAAA;AA/BY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAGiB,gCAAc;QACC,gDAAsB;GAHtD,oBAAoB,CA+BhC"}
+{"version":3,"file":"notification.service.js","sourceRoot":"","sources":["../../../../src/foundations/notification/services/notification.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,oFAAgF;AAChF,qFAAiF;AACjF,2EAAgG;AAChG,qGAAiG;AAEjG;;;;;;;;;;;;GAYG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,kCAA0E;IAGlH,YACE,OAAuB,EACN,sBAA8C,EAC/D,UAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,qCAAsB,CAAC,KAAK,CAAC,CAAC;QAHhE,2BAAsB,GAAtB,sBAAsB,CAAwB;QAJ9C,eAAU,GAAG,qCAAsB,CAAC;IAQvD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA4D;QAC5E,MAAM,SAAS,GAAqB,IAAI,oCAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAClC,IAAI,CAAC,UAAU,CAAC,KAAK,EACrB,MAAM,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC;YAC5C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;SACnC,CAAC,EACF,SAAS,CACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAkD;QACtE,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,CACpC,IAAI,CAAC,UAAU,CAAC,KAAK,EACrB,MAAM,IAAI,CAAC,sBAAsB,CAAC,eAAe,CAAC,MAAM,CAAC,CAC1D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAqD;QACpE,OAAO,MAAM,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAkC;QAC9C,MAAM,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IACvF,CAAC;CACF,CAAA;AAvCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAKA,gCAAc;QACkB,gDAAsB;QACnD,uBAAU;GANb,oBAAoB,CAuChC"}

package/dist/foundations/rbac/dump.d.ts

@@ -48,6 +48,27 @@ export interface DumpRbacMatrixOptions {
      * cwd, or `"apps/api/src/rbac/permissions.ts"` from the monorepo root).
      */
     outputPath: string;
+    /**
+     * Import lines emitted verbatim, in order, at the head of the generated
+     * file. Supply these when your app's `RoleId` / `ModuleId` / module-paths
+     * map do not live where the package default expects them — otherwise the
+     * dump is not re-runnable, because a re-run would overwrite a hand-fixed
+     * header with imports that do not resolve in your app.
+     *
+     * Omit to keep the default header
+     * ({@link DEFAULT_IMPORT_LINES} in `serializer/matrix-to-ts`), which is the
+     * neural-erp convention and stays byte-identical.
+     *
+     * ```ts
+     * importLines: [
+     *   `import { RoleId } from "../config/enums/role.id";`,
+     *   `import { ModuleId } from "@your-org/shared";`,
+     *   `import { perm, defineRbac } from "@carlonicora/nestjs-neo4jsonapi";`,
+     *   `import { MODULE_USER_PATHS } from "../features/rbac/module-relationships.map";`,
+     * ]
+     * ```
+     */
+    importLines?: string[];
 }
 /**
  * Result of {@link dumpRbacMatrix}.
@@ -67,9 +88,24 @@ export interface DumpRbacMatrixResult {
  * development). Do not expose this from a runtime endpoint — production
  * servers should never write source files.
  *
- * The emitted file imports `RoleId` / `ModuleId` from `@neural-erp/shared`
- * (or whichever package you've wired into `serializeMatrixToTs`), and
- * `perm` / `defineRbac` from `@carlonicora/nestjs-neo4jsonapi`.
+ * By default the emitted file imports `RoleId` / `ModuleId` from
+ * `@neural-erp/shared`, and `perm` / `defineRbac` from
+ * `@carlonicora/nestjs-neo4jsonapi`. Apps whose enums live elsewhere MUST
+ * pass {@link DumpRbacMatrixOptions.importLines} reproducing their own
+ * header, otherwise re-running the dump overwrites a hand-fixed header with
+ * imports that do not resolve — i.e. the dump is a one-shot instead of a
+ * repeatable command.
+ *
+ * **Import this function from the `/foundations/rbac` subpath, NOT from the
+ * package root barrel.** Loading the root barrel pulls in the whole package
+ * graph, which corrupts the TypeScript parser bundled with `prettier` (the
+ * serialiser formats its output with it) and makes the dump fail — a
+ * session-verified defect from the Wave 1 foundation migration. Note the
+ * `exports` map currently exposes subpaths via the `./foundations/*`
+ * wildcard (`./dist/foundations/*.js`), so the form that resolves today is
+ * `@carlonicora/nestjs-neo4jsonapi/foundations/rbac/index`; the bare
+ * `.../foundations/rbac` needs an explicit `"./foundations/rbac"` export
+ * entry.
  *
  * @example
  * ```ts
@@ -80,7 +116,9 @@ export interface DumpRbacMatrixResult {
  *
  * import neo4j from "neo4j-driver";
  * import { RoleId, ModuleId } from "@neural-erp/shared";
- * import { dumpRbacMatrix } from "@carlonicora/nestjs-neo4jsonapi";
+ * // Subpath import — the package ROOT barrel breaks prettier's bundled
+ * // TypeScript parser (see the note above).
+ * import { dumpRbacMatrix } from "@carlonicora/nestjs-neo4jsonapi/foundations/rbac/index";
  *
  * async function main() {
  *   const driver = neo4j.driver(
@@ -99,6 +137,12 @@ export interface DumpRbacMatrixResult {
  *       ),
  *       administratorRoleId: RoleId.Administrator,
  *       outputPath: path.resolve(__dirname, "../src/rbac/permissions.ts"),
+ *       // Reproduce YOUR app's header verbatim so the dump is re-runnable.
+ *       importLines: [
+ *         `import { RoleId, ModuleId } from "@neural-erp/shared";`,
+ *         `import { perm, defineRbac } from "@carlonicora/nestjs-neo4jsonapi";`,
+ *         `import { MODULE_USER_PATHS } from "../features/rbac/module-relationships.map";`,
+ *       ],
  *     });
  *     console.log(`Wrote ${result.bytesWritten} bytes to ${result.path}`);
  *   } finally {

package/dist/foundations/rbac/dump.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dump.d.ts","sourceRoot":"","sources":["../../../src/foundations/rbac/dump.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkD/F"}
+{"version":3,"file":"dump.d.ts","sourceRoot":"","sources":["../../../src/foundations/rbac/dump.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC;;;;;;OAMG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4EG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmD/F"}

package/dist/foundations/rbac/dump.js

@@ -46,9 +46,24 @@ const matrix_to_ts_1 = require("./serializer/matrix-to-ts");
  * development). Do not expose this from a runtime endpoint — production
  * servers should never write source files.
  *
- * The emitted file imports `RoleId` / `ModuleId` from `@neural-erp/shared`
- * (or whichever package you've wired into `serializeMatrixToTs`), and
- * `perm` / `defineRbac` from `@carlonicora/nestjs-neo4jsonapi`.
+ * By default the emitted file imports `RoleId` / `ModuleId` from
+ * `@neural-erp/shared`, and `perm` / `defineRbac` from
+ * `@carlonicora/nestjs-neo4jsonapi`. Apps whose enums live elsewhere MUST
+ * pass {@link DumpRbacMatrixOptions.importLines} reproducing their own
+ * header, otherwise re-running the dump overwrites a hand-fixed header with
+ * imports that do not resolve — i.e. the dump is a one-shot instead of a
+ * repeatable command.
+ *
+ * **Import this function from the `/foundations/rbac` subpath, NOT from the
+ * package root barrel.** Loading the root barrel pulls in the whole package
+ * graph, which corrupts the TypeScript parser bundled with `prettier` (the
+ * serialiser formats its output with it) and makes the dump fail — a
+ * session-verified defect from the Wave 1 foundation migration. Note the
+ * `exports` map currently exposes subpaths via the `./foundations/*`
+ * wildcard (`./dist/foundations/*.js`), so the form that resolves today is
+ * `@carlonicora/nestjs-neo4jsonapi/foundations/rbac/index`; the bare
+ * `.../foundations/rbac` needs an explicit `"./foundations/rbac"` export
+ * entry.
  *
  * @example
  * ```ts
@@ -59,7 +74,9 @@ const matrix_to_ts_1 = require("./serializer/matrix-to-ts");
  *
  * import neo4j from "neo4j-driver";
  * import { RoleId, ModuleId } from "@neural-erp/shared";
- * import { dumpRbacMatrix } from "@carlonicora/nestjs-neo4jsonapi";
+ * // Subpath import — the package ROOT barrel breaks prettier's bundled
+ * // TypeScript parser (see the note above).
+ * import { dumpRbacMatrix } from "@carlonicora/nestjs-neo4jsonapi/foundations/rbac/index";
  *
  * async function main() {
  *   const driver = neo4j.driver(
@@ -78,6 +95,12 @@ const matrix_to_ts_1 = require("./serializer/matrix-to-ts");
  *       ),
  *       administratorRoleId: RoleId.Administrator,
  *       outputPath: path.resolve(__dirname, "../src/rbac/permissions.ts"),
+ *       // Reproduce YOUR app's header verbatim so the dump is re-runnable.
+ *       importLines: [
+ *         `import { RoleId, ModuleId } from "@neural-erp/shared";`,
+ *         `import { perm, defineRbac } from "@carlonicora/nestjs-neo4jsonapi";`,
+ *         `import { MODULE_USER_PATHS } from "../features/rbac/module-relationships.map";`,
+ *       ],
  *     });
  *     console.log(`Wrote ${result.bytesWritten} bytes to ${result.path}`);
  *   } finally {
@@ -125,6 +148,7 @@ async function dumpRbacMatrix(opts) {
         const source = await (0, matrix_to_ts_1.serializeMatrixToTs)(matrix, {
             roleNames: opts.roleNames,
             moduleNames: opts.moduleNames,
+            ...(opts.importLines ? { importLines: opts.importLines } : {}),
         });
         const outPath = path.isAbsolute(opts.outputPath) ? opts.outputPath : path.resolve(process.cwd(), opts.outputPath);
         fs.mkdirSync(path.dirname(outPath), { recursive: true });