@carlonicora/nestjs-neo4jsonapi 1.115.0 → 1.116.0

package/dist/foundations/index.d.ts

@@ -15,6 +15,7 @@ export * from "./content";
 export * from "./discord";
 export * from "./discord-user";
 export * from "./feature";
+export * from "./google-user";
 export * from "./how-to";
 export * from "./keyconcept";
 export * from "./membership";
@@ -30,5 +31,7 @@ export * from "./stripe";
 export * from "./tokenusage";
 export * from "./two-factor";
 export * from "./user";
+export * from "./user-activity";
+export * from "./waitlist";
 export * from "./rbac";
 //# sourceMappingURL=index.d.ts.map

package/dist/foundations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,uBAAuB,CAAC;AAGtC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,uBAAuB,CAAC;AAGtC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC"}

package/dist/foundations/index.js

@@ -33,6 +33,7 @@ __exportStar(require("./content"), exports);
 __exportStar(require("./discord"), exports);
 __exportStar(require("./discord-user"), exports);
 __exportStar(require("./feature"), exports);
+__exportStar(require("./google-user"), exports);
 __exportStar(require("./how-to"), exports);
 __exportStar(require("./keyconcept"), exports);
 __exportStar(require("./membership"), exports);
@@ -48,5 +49,7 @@ __exportStar(require("./stripe"), exports);
 __exportStar(require("./tokenusage"), exports);
 __exportStar(require("./two-factor"), exports);
 __exportStar(require("./user"), exports);
+__exportStar(require("./user-activity"), exports);
+__exportStar(require("./waitlist"), exports);
 __exportStar(require("./rbac"), exports);
 //# sourceMappingURL=index.js.map

package/dist/foundations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,sFAAsF;AACtF,wDAAsC;AAEtC,iFAAiF;AACjF,8CAA4B;AAC5B,qDAAmC;AACnC,sDAAoC;AACpC,+CAA6B;AAC7B,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,iDAA+B;AAC/B,4CAA0B;AAC1B,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,yCAAuB;AACvB,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,uCAAqB;AACrB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/foundations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,sFAAsF;AACtF,wDAAsC;AAEtC,iFAAiF;AACjF,8CAA4B;AAC5B,qDAAmC;AACnC,sDAAoC;AACpC,+CAA6B;AAC7B,0CAAwB;AACxB,yCAAuB;AACvB,0CAAwB;AACxB,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,iDAA+B;AAC/B,4CAA0B;AAC1B,gDAA8B;AAC9B,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,yCAAuB;AACvB,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,uCAAqB;AACrB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,yCAAuB;AACvB,kDAAgC;AAChC,6CAA2B;AAC3B,yCAAuB"}

package/dist/foundations/membership/entities/membership.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../../../../src/foundations/membership/entities/membership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAMvD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;EAgB/B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,oBAAoB,CAAC"}
+{"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../../../../src/foundations/membership/entities/membership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,iBAAiB,CAAC;AAMvD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;EAqB/B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,oBAAoB,CAAC"}

package/dist/foundations/membership/entities/membership.js

@@ -8,6 +8,10 @@ const user_meta_1 = require("../../user/entities/user.meta");
 const membership_meta_1 = require("./membership.meta");
 exports.MembershipDescriptor = (0, common_1.defineEntity)()({
     ...membership_meta_1.membershipMeta,
+    // Platform-level memberships have NO IN_COMPANY edge (global Administrator).
+    // A company-scoped default would BELONGS_TO-filter any future generic read
+    // and silently hide platform memberships.
+    isCompanyScoped: false,
     fields: {},
     relationships: {
         user: { model: user_meta_1.userMeta, direction: "in", relationship: "HAS_MEMBERSHIP", cardinality: "one", dtoKey: "user" },

package/dist/foundations/membership/entities/membership.js.map

@@ -1 +1 @@
-{"version":3,"file":"membership.js","sourceRoot":"","sources":["../../../../src/foundations/membership/entities/membership.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,sEAAkE;AAClE,6DAAyD;AACzD,6DAAyD;AACzD,uDAAmD;AAWtC,QAAA,oBAAoB,GAAG,IAAA,qBAAY,GAAc,CAAC;IAC7D,GAAG,gCAAc;IAEjB,MAAM,EAAE,EAAE;IAEV,aAAa,EAAE;QACb,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;QAC9G,OAAO,EAAE;YACP,KAAK,EAAE,0BAAW;YAClB,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,SAAS;SAClB;QACD,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;KAC5G;CACF,CAAC,CAAC"}
+{"version":3,"file":"membership.js","sourceRoot":"","sources":["../../../../src/foundations/membership/entities/membership.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,sEAAkE;AAClE,6DAAyD;AACzD,6DAAyD;AACzD,uDAAmD;AAWtC,QAAA,oBAAoB,GAAG,IAAA,qBAAY,GAAc,CAAC;IAC7D,GAAG,gCAAc;IAEjB,6EAA6E;IAC7E,2EAA2E;IAC3E,0CAA0C;IAC1C,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE,EAAE;IAEV,aAAa,EAAE;QACb,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;QAC9G,OAAO,EAAE;YACP,KAAK,EAAE,0BAAW;YAClB,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,SAAS;SAClB;QACD,IAAI,EAAE,EAAE,KAAK,EAAE,oBAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;KAC5G;CACF,CAAC,CAAC"}

package/dist/foundations/notification/controllers/notification.controller.js

@@ -26,10 +26,10 @@ let NotificationController = class NotificationController {
         this.cacheService = cacheService;
     }
     async findList(request, query, isArchived) {
-        return await this.service.find({ query: query, userId: request.user.userId, isArchived: isArchived });
+        return await this.service.findForUser({ query: query, userId: request.user.userId, isArchived: isArchived });
     }
     async findById(request, notificationId) {
-        return await this.service.findById({ notificationId: notificationId, userId: request.user.id });
+        return await this.service.findByIdForUser({ notificationId: notificationId, userId: request.user.id });
     }
     async markAsRead(request, query, body) {
         return await this.service.markAsRead({

package/dist/foundations/notification/controllers/notification.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification.controller.js","sourceRoot":"","sources":["../../../../src/foundations/notification/controllers/notification.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwH;AAExH,sGAAwF;AACxF,0EAAqE;AACrE,8EAA0E;AAC1E,2FAAoH;AACpH,qFAAiF;AACjF,2FAAwF;AAIjF,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YACmB,OAA6B,EAC7B,YAA0B;QAD1B,YAAO,GAAP,OAAO,CAAsB;QAC7B,iBAAY,GAAZ,YAAY,CAAc;IAC1C,CAAC;IAGE,AAAN,KAAK,CAAC,QAAQ,CAAQ,OAAY,EAAW,KAAU,EAAuB,UAAoB;QAChG,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IACxG,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ,CAAQ,OAAY,EAA2B,cAAsB;QACjF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IAKK,AAAN,KAAK,CAAC,UAAU,CAAQ,OAAY,EAAW,KAAU,EAAU,IAA8B;QAC/F,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YACnC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;YAC3B,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAsC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;SAC5F,CAAC,CAAC;IACL,CAAC;IAKK,AAAN,KAAK,CAAC,OAAO,CAAQ,OAAY,EAAW,KAAU,EAA2B,cAAsB;QACrG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,cAAc,EAAE,cAAc;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlCY,wDAAsB;AAO3B;IADL,IAAA,YAAG,EAAC,oCAAgB,CAAC,QAAQ,CAAC;IACf,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,cAAK,EAAC,YAAY,CAAC,CAAA;;;;sDAE5E;AAGK;IADL,IAAA,YAAG,EAAC,GAAG,oCAAgB,CAAC,QAAQ,kBAAkB,CAAC;IACpC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,EAAC,gBAAgB,CAAC,CAAA;;;;sDAE3D;AAKK;IAHL,IAAA,cAAK,EAAC,oCAAgB,CAAC,QAAQ,CAAC;IAChC,IAAA,iBAAQ,EAAC,mBAAU,CAAC,UAAU,CAAC;IAC/B,IAAA,4CAAe,EAAC,oCAAgB,EAAE,gBAAgB,CAAC;IAClC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,aAAI,GAAE,CAAA;;qDAAO,iDAAwB;;wDAKhG;AAKK;IAHL,IAAA,aAAI,EAAC,GAAG,oCAAgB,CAAC,QAAQ,0BAA0B,CAAC;IAC5D,IAAA,iBAAQ,EAAC,mBAAU,CAAC,UAAU,CAAC;IAC/B,IAAA,4CAAe,EAAC,oCAAgB,EAAE,gBAAgB,CAAC;IACrC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,cAAK,EAAC,gBAAgB,CAAC,CAAA;;;;qDAI/E;iCAjCU,sBAAsB;IAFlC,IAAA,kBAAS,EAAC,6BAAY,CAAC;IACvB,IAAA,mBAAU,GAAE;qCAGiB,2CAAoB;QACf,4BAAY;GAHlC,sBAAsB,CAkClC"}
+{"version":3,"file":"notification.controller.js","sourceRoot":"","sources":["../../../../src/foundations/notification/controllers/notification.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwH;AAExH,sGAAwF;AACxF,0EAAqE;AACrE,8EAA0E;AAC1E,2FAAoH;AACpH,qFAAiF;AACjF,2FAAwF;AAIjF,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YACmB,OAA6B,EAC7B,YAA0B;QAD1B,YAAO,GAAP,OAAO,CAAsB;QAC7B,iBAAY,GAAZ,YAAY,CAAc;IAC1C,CAAC;IAGE,AAAN,KAAK,CAAC,QAAQ,CAAQ,OAAY,EAAW,KAAU,EAAuB,UAAoB;QAChG,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/G,CAAC;IAGK,AAAN,KAAK,CAAC,QAAQ,CAAQ,OAAY,EAA2B,cAAsB;QACjF,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IAKK,AAAN,KAAK,CAAC,UAAU,CAAQ,OAAY,EAAW,KAAU,EAAU,IAA8B;QAC/F,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;YACnC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;YAC3B,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAsC,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;SAC5F,CAAC,CAAC;IACL,CAAC;IAKK,AAAN,KAAK,CAAC,OAAO,CAAQ,OAAY,EAAW,KAAU,EAA2B,cAAsB;QACrG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACzB,cAAc,EAAE,cAAc;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAlCY,wDAAsB;AAO3B;IADL,IAAA,YAAG,EAAC,oCAAgB,CAAC,QAAQ,CAAC;IACf,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,cAAK,EAAC,YAAY,CAAC,CAAA;;;;sDAE5E;AAGK;IADL,IAAA,YAAG,EAAC,GAAG,oCAAgB,CAAC,QAAQ,kBAAkB,CAAC;IACpC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,EAAC,gBAAgB,CAAC,CAAA;;;;sDAE3D;AAKK;IAHL,IAAA,cAAK,EAAC,oCAAgB,CAAC,QAAQ,CAAC;IAChC,IAAA,iBAAQ,EAAC,mBAAU,CAAC,UAAU,CAAC;IAC/B,IAAA,4CAAe,EAAC,oCAAgB,EAAE,gBAAgB,CAAC;IAClC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,aAAI,GAAE,CAAA;;qDAAO,iDAAwB;;wDAKhG;AAKK;IAHL,IAAA,aAAI,EAAC,GAAG,oCAAgB,CAAC,QAAQ,0BAA0B,CAAC;IAC5D,IAAA,iBAAQ,EAAC,mBAAU,CAAC,UAAU,CAAC;IAC/B,IAAA,4CAAe,EAAC,oCAAgB,EAAE,gBAAgB,CAAC;IACrC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,cAAK,EAAC,gBAAgB,CAAC,CAAA;;;;qDAI/E;iCAjCU,sBAAsB;IAFlC,IAAA,kBAAS,EAAC,6BAAY,CAAC;IACvB,IAAA,mBAAU,GAAE;qCAGiB,2CAAoB;QACf,4BAAY;GAHlC,sBAAsB,CAkClC"}

package/dist/foundations/notification/entities/notification.d.ts

@@ -0,0 +1,75 @@
+import { Entity } from "../../../common/abstracts/entity";
+import { User } from "../../user/entities/user";
+/**
+ * Notification Entity Type
+ *
+ * An in-app notification raised for a single recipient user. The graph shape is
+ * `(notification)-[:TRIGGERED_FOR]->(:User)` for the recipient,
+ * `(notification)-[:TRIGGERED_BY]->(:User)` for the actor, and
+ * `(notification)-[:REFERS_TO]->(subject)` for whatever the notification is
+ * about (the "subject"). The list query REQUIRES at least one REFERS_TO edge —
+ * see `NotificationRepository.findForUser` — so a notification created without
+ * a subject is invisible to the very list it was created for.
+ *
+ * Replaces the hand-written quartet (`notification.entity.ts`,
+ * `notification.map.ts`, `notification.model.ts`,
+ * `serialisers/notifications.serialiser.ts` — all deleted). The attribute and
+ * relationship surface below reproduces the old `NotificationSerialiser.create()`
+ * byte for byte: attributes `notificationType`, `isRead`, `message`,
+ * `actionUrl`; a single to-one `actor` relationship pointing at the User model
+ * (the old serialiser declared it under key `user` with `name: "actor"`, which
+ * put `actor` on the wire — the descriptor reaches the same wire key with key
+ * `actor` + `dtoKey: "actor"`).
+ */
+export type Notification = Entity & {
+    notificationType: string;
+    isRead: boolean;
+    message?: string;
+    actionUrl?: string;
+    actor?: User;
+};
+/**
+ * Notification Entity Descriptor
+ *
+ * Single source of truth for the Notification entity configuration. Generates
+ * the mapper, the children tokens and the DataModelInterface automatically.
+ *
+ * `isCompanyScoped` is left at its default (`true`): every notification is
+ * written with a `(notification)-[:BELONGS_TO]->(company)` edge and every query
+ * in the repository joins `company`. The old hand-written model declared
+ * `singleChildrenTokens: [userMeta.nodeName]`; the descriptor derives
+ * `["company", "user"]` — the extra `company` token is inert on the wire (the
+ * serialiser only emits `relationships` declared below) and inert in entity
+ * mapping (no query RETURNs a `notification_company` column).
+ *
+ * No top-level `description`/`chat` block: the chatbot copy for a notification
+ * is application-specific (it describes each app's own notification types and
+ * subjects) and is supplied by the consuming app's extended descriptor. The
+ * per-field `description`s live here so an extended descriptor can spread
+ * `NotificationDescriptor.fields` and inherit them.
+ *
+ * Consuming apps that need more attributes, more subjects or a polymorphic
+ * actor register an EXTENDED descriptor (`modelRegistry`, last write wins) and
+ * subclass `NotificationRepository` — the narrowed-extend pattern used for
+ * user/auth/company/tokenusage. The package default stays User-only actor +
+ * `message`/`actionUrl`.
+ */
+export declare const NotificationDescriptor: import("../../..").EntityDescriptor<Notification, {
+    actor: {
+        model: import("../../..").DataMeta;
+        direction: "out";
+        relationship: string;
+        cardinality: "one";
+        required: false;
+        dtoKey: string;
+        description: string;
+    };
+}>;
+export type NotificationDescriptorType = typeof NotificationDescriptor;
+/**
+ * Back-compat alias for the pre-descriptor `NotificationModel` export (the
+ * `entities/notification.model.ts` file it used to live in is deleted). Mirrors
+ * `FeatureModel` in `foundations/feature/entities/feature.model.ts`.
+ */
+export declare const NotificationModel: import("../../..").DataModelInterface<Notification>;
+//# sourceMappingURL=notification.d.ts.map

package/dist/foundations/notification/entities/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../../src/foundations/notification/entities/notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,KAAK,CAAC,EAAE,IAAI,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;EAoCjC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,OAAO,sBAAsB,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,qDAA+B,CAAC"}

package/dist/foundations/notification/entities/notification.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationModel = exports.NotificationDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const user_meta_1 = require("../../user/entities/user.meta");
+const notification_meta_1 = require("./notification.meta");
+/**
+ * Notification Entity Descriptor
+ *
+ * Single source of truth for the Notification entity configuration. Generates
+ * the mapper, the children tokens and the DataModelInterface automatically.
+ *
+ * `isCompanyScoped` is left at its default (`true`): every notification is
+ * written with a `(notification)-[:BELONGS_TO]->(company)` edge and every query
+ * in the repository joins `company`. The old hand-written model declared
+ * `singleChildrenTokens: [userMeta.nodeName]`; the descriptor derives
+ * `["company", "user"]` — the extra `company` token is inert on the wire (the
+ * serialiser only emits `relationships` declared below) and inert in entity
+ * mapping (no query RETURNs a `notification_company` column).
+ *
+ * No top-level `description`/`chat` block: the chatbot copy for a notification
+ * is application-specific (it describes each app's own notification types and
+ * subjects) and is supplied by the consuming app's extended descriptor. The
+ * per-field `description`s live here so an extended descriptor can spread
+ * `NotificationDescriptor.fields` and inherit them.
+ *
+ * Consuming apps that need more attributes, more subjects or a polymorphic
+ * actor register an EXTENDED descriptor (`modelRegistry`, last write wins) and
+ * subclass `NotificationRepository` — the narrowed-extend pattern used for
+ * user/auth/company/tokenusage. The package default stays User-only actor +
+ * `message`/`actionUrl`.
+ */
+exports.NotificationDescriptor = (0, define_entity_1.defineEntity)()({
+    ...notification_meta_1.notificationMeta,
+    fields: {
+        notificationType: {
+            type: "string",
+            required: true,
+            description: 'The event that triggered the notification (e.g. "MENTION", "TASK_ASSIGNED"). Drives the message text and icon shown to the recipient.',
+        },
+        isRead: {
+            type: "boolean",
+            required: true,
+            description: "Whether the recipient has opened/acknowledged this notification.",
+        },
+        message: {
+            type: "string",
+            description: "Pre-rendered message text shown to the recipient.",
+        },
+        actionUrl: {
+            type: "string",
+            description: "URL the recipient is sent to when acting on the notification.",
+        },
+    },
+    relationships: {
+        actor: {
+            model: user_meta_1.userMeta,
+            direction: "out",
+            relationship: "TRIGGERED_BY",
+            cardinality: "one",
+            required: false,
+            dtoKey: "actor",
+            description: "The user whose action triggered this notification.",
+        },
+    },
+});
+/**
+ * Back-compat alias for the pre-descriptor `NotificationModel` export (the
+ * `entities/notification.model.ts` file it used to live in is deleted). Mirrors
+ * `FeatureModel` in `foundations/feature/entities/feature.model.ts`.
+ */
+exports.NotificationModel = exports.NotificationDescriptor.model;
+//# sourceMappingURL=notification.js.map

package/dist/foundations/notification/entities/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../../../src/foundations/notification/entities/notification.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AAErE,6DAAyD;AACzD,2DAAuD;AAgCvD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACU,QAAA,sBAAsB,GAAG,IAAA,4BAAY,GAAgB,CAAC;IACjE,GAAG,oCAAgB;IAEnB,MAAM,EAAE;QACN,gBAAgB,EAAE;YAChB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,uIAAuI;SAC1I;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kEAAkE;SAChF;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;SACjE;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+DAA+D;SAC7E;KACF;IAED,aAAa,EAAE;QACb,KAAK,EAAE;YACL,KAAK,EAAE,oBAAQ;YACf,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,cAAc;YAC5B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,oDAAoD;SAClE;KACF;CACF,CAAC,CAAC;AAIH;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,8BAAsB,CAAC,KAAK,CAAC"}

package/dist/foundations/notification/index.d.ts

@@ -1,4 +1,8 @@
 export { NotificationModule } from "./notification.module";
-export { NotificationModel } from "./entities/notification.model";
-export { Notification } from "./entities/notification.entity";
+export { Notification, NotificationDescriptor, NotificationDescriptorType, NotificationModel, } from "./entities/notification";
+export { notificationMeta } from "./entities/notification.meta";
+export { NotificationController } from "./controllers/notification.controller";
+export { NotificationDataPatchDTO, NotificationPatchAttributesDTO, NotificationPatchDTO, NotificationPatchListDTO, } from "./dtos/notification.patch.dto";
+export { NotificationRepository, NotificationTarget } from "./repositories/notification.repository";
+export { NotificationServices } from "./services/notification.service";
 //# sourceMappingURL=index.d.ts.map

package/dist/foundations/notification/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/notification/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/notification/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/foundations/notification/index.js

@@ -1,8 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NotificationModel = exports.NotificationModule = void 0;
+exports.NotificationServices = exports.NotificationRepository = exports.NotificationPatchListDTO = exports.NotificationPatchDTO = exports.NotificationPatchAttributesDTO = exports.NotificationDataPatchDTO = exports.NotificationController = exports.notificationMeta = exports.NotificationModel = exports.NotificationDescriptor = exports.NotificationModule = void 0;
 var notification_module_1 = require("./notification.module");
 Object.defineProperty(exports, "NotificationModule", { enumerable: true, get: function () { return notification_module_1.NotificationModule; } });
-var notification_model_1 = require("./entities/notification.model");
-Object.defineProperty(exports, "NotificationModel", { enumerable: true, get: function () { return notification_model_1.NotificationModel; } });
+var notification_1 = require("./entities/notification");
+Object.defineProperty(exports, "NotificationDescriptor", { enumerable: true, get: function () { return notification_1.NotificationDescriptor; } });
+Object.defineProperty(exports, "NotificationModel", { enumerable: true, get: function () { return notification_1.NotificationModel; } });
+var notification_meta_1 = require("./entities/notification.meta");
+Object.defineProperty(exports, "notificationMeta", { enumerable: true, get: function () { return notification_meta_1.notificationMeta; } });
+var notification_controller_1 = require("./controllers/notification.controller");
+Object.defineProperty(exports, "NotificationController", { enumerable: true, get: function () { return notification_controller_1.NotificationController; } });
+var notification_patch_dto_1 = require("./dtos/notification.patch.dto");
+Object.defineProperty(exports, "NotificationDataPatchDTO", { enumerable: true, get: function () { return notification_patch_dto_1.NotificationDataPatchDTO; } });
+Object.defineProperty(exports, "NotificationPatchAttributesDTO", { enumerable: true, get: function () { return notification_patch_dto_1.NotificationPatchAttributesDTO; } });
+Object.defineProperty(exports, "NotificationPatchDTO", { enumerable: true, get: function () { return notification_patch_dto_1.NotificationPatchDTO; } });
+Object.defineProperty(exports, "NotificationPatchListDTO", { enumerable: true, get: function () { return notification_patch_dto_1.NotificationPatchListDTO; } });
+var notification_repository_1 = require("./repositories/notification.repository");
+Object.defineProperty(exports, "NotificationRepository", { enumerable: true, get: function () { return notification_repository_1.NotificationRepository; } });
+var notification_service_1 = require("./services/notification.service");
+Object.defineProperty(exports, "NotificationServices", { enumerable: true, get: function () { return notification_service_1.NotificationServices; } });
 //# sourceMappingURL=index.js.map

package/dist/foundations/notification/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/notification/index.ts"],"names":[],"mappings":";;;AAAA,6DAA2D;AAAlD,yHAAA,kBAAkB,OAAA;AAC3B,oEAAkE;AAAzD,uHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/notification/index.ts"],"names":[],"mappings":";;;AAAA,6DAA2D;AAAlD,yHAAA,kBAAkB,OAAA;AAC3B,wDAKiC;AAH/B,sHAAA,sBAAsB,OAAA;AAEtB,iHAAA,iBAAiB,OAAA;AAEnB,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,iFAA+E;AAAtE,iIAAA,sBAAsB,OAAA;AAC/B,wEAKuC;AAJrC,kIAAA,wBAAwB,OAAA;AACxB,wIAAA,8BAA8B,OAAA;AAC9B,8HAAA,oBAAoB,OAAA;AACpB,kIAAA,wBAAwB,OAAA;AAE1B,kFAAoG;AAA3F,iIAAA,sBAAsB,OAAA;AAC/B,wEAAuE;AAA9D,4HAAA,oBAAoB,OAAA"}

package/dist/foundations/notification/notification.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/notification/notification.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQtD,qBAMa,kBAAmB,YAAW,YAAY;IACrD,YAAY;CAGb"}
+{"version":3,"file":"notification.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/notification/notification.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAOtD,qBAMa,kBAAmB,YAAW,YAAY;IACrD,YAAY;CAGb"}

package/dist/foundations/notification/notification.module.js

@@ -10,20 +10,19 @@ exports.NotificationModule = void 0;
 const common_1 = require("@nestjs/common");
 const registry_1 = require("../../common/registries/registry");
 const notification_controller_1 = require("./controllers/notification.controller");
-const notification_model_1 = require("./entities/notification.model");
+const notification_1 = require("./entities/notification");
 const notification_repository_1 = require("./repositories/notification.repository");
-const notifications_serialiser_1 = require("./serialisers/notifications.serialiser");
 const notification_service_1 = require("./services/notification.service");
 let NotificationModule = class NotificationModule {
     onModuleInit() {
-        registry_1.modelRegistry.register(notification_model_1.NotificationModel);
+        registry_1.modelRegistry.register(notification_1.NotificationDescriptor.model);
     }
 };
 exports.NotificationModule = NotificationModule;
 exports.NotificationModule = NotificationModule = __decorate([
     (0, common_1.Module)({
         controllers: [notification_controller_1.NotificationController],
-        providers: [notification_repository_1.NotificationRepository, notification_service_1.NotificationServices, notifications_serialiser_1.NotificationSerialiser],
+        providers: [notification_repository_1.NotificationRepository, notification_service_1.NotificationServices, notification_1.NotificationDescriptor.model.serialiser],
         exports: [notification_repository_1.NotificationRepository],
         imports: [],
     })

package/dist/foundations/notification/notification.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification.module.js","sourceRoot":"","sources":["../../../src/foundations/notification/notification.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AACtD,+DAAiE;AACjE,mFAA+E;AAC/E,sEAAkE;AAClE,oFAAgF;AAChF,qFAAgF;AAChF,0EAAuE;AAQhE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,sCAAiB,CAAC,CAAC;IAC5C,CAAC;CACF,CAAA;AAJY,gDAAkB;6BAAlB,kBAAkB;IAN9B,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,gDAAsB,CAAC;QACrC,SAAS,EAAE,CAAC,gDAAsB,EAAE,2CAAoB,EAAE,iDAAsB,CAAC;QACjF,OAAO,EAAE,CAAC,gDAAsB,CAAC;QACjC,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,kBAAkB,CAI9B"}
+{"version":3,"file":"notification.module.js","sourceRoot":"","sources":["../../../src/foundations/notification/notification.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AACtD,+DAAiE;AACjE,mFAA+E;AAC/E,0DAAiE;AACjE,oFAAgF;AAChF,0EAAuE;AAQhE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,qCAAsB,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;CACF,CAAA;AAJY,gDAAkB;6BAAlB,kBAAkB;IAN9B,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,gDAAsB,CAAC;QACrC,SAAS,EAAE,CAAC,gDAAsB,EAAE,2CAAoB,EAAE,qCAAsB,CAAC,KAAK,CAAC,UAAU,CAAC;QAClG,OAAO,EAAE,CAAC,gDAAsB,CAAC;QACjC,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,kBAAkB,CAI9B"}

package/dist/foundations/notification/repositories/notification.repository.d.ts

@@ -1,17 +1,97 @@
-import { OnModuleInit } from "@nestjs/common";
+import { ClsService } from "nestjs-cls";
+import { DataModelInterface } from "../../../common/interfaces/datamodel.interface";
 import { JsonApiCursorInterface } from "../../../core/jsonapi/interfaces/jsonapi.cursor.interface";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
 import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
-import { Notification } from "../../notification/entities/notification.entity";
-export declare class NotificationRepository implements OnModuleInit {
-    private readonly neo4j;
-    constructor(neo4j: Neo4jService);
+import { SecurityService } from "../../../core/security/services/security.service";
+import { Notification, NotificationDescriptor } from "../../notification/entities/notification";
+/** A node a notification refers to (its "subject"), written as `-[:REFERS_TO]->`. */
+export type NotificationTarget = {
+    /** `id` property of an EXISTING node. */
+    id: string;
+    /** Neo4j label of that node (e.g. "Task", "Document"). */
+    label: string;
+};
+/**
+ * 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.)
+ */
+export declare class NotificationRepository extends AbstractRepository<Notification, typeof NotificationDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<Notification, {
+        actor: {
+            model: import("../../../common/interfaces/datamodel.interface").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+            description: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * 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.
+     */
     onModuleInit(): Promise<void>;
-    find(params: {
+    /**
+     * 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.
+     */
+    protected getNotificationModel(): DataModelInterface<Notification>;
+    /** Guards a caller-supplied Neo4j label before it is interpolated into Cypher. */
+    protected assertSafeLabel(label: string): string;
+    findForUser(params: {
         userId: string;
         cursor?: JsonApiCursorInterface;
         isArchived?: boolean;
     }): Promise<Notification[]>;
-    findById(params: {
+    findByIdForUser(params: {
         notificationId: string;
         userId: string;
     }): Promise<Notification>;
@@ -22,10 +102,47 @@ export declare class NotificationRepository implements OnModuleInit {
     archive(params: {
         notificationId: string;
     }): Promise<void>;
-    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.
+     */
+    createNotification(params: {
         notificationType: string;
         userId: string;
         actorId?: string;
+        targets?: NotificationTarget[];
     }): Promise<Notification>;
+    /**
+     * 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.
+     */
+    createIdempotent(params: {
+        notificationType: string;
+        userId: string;
+        actorId?: string;
+        actorLabel?: string;
+        targets?: NotificationTarget[];
+        idempotencyKey: string;
+    }): Promise<{
+        created: boolean;
+    }>;
 }
 //# sourceMappingURL=notification.repository.d.ts.map

package/dist/foundations/notification/repositories/notification.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/notification/repositories/notification.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AAEnG,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAK/E,qBACa,sBAAuB,YAAW,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAE1C,YAAY;IAMZ,IAAI,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,sBAAsB,CAAC;QAChC,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2BrB,QAAQ,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAoBnF,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE;IAmBhE,OAAO,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;IAgB1C,MAAM,CAAC,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;CA2D5G"}
+{"version":3,"file":"notification.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/notification/repositories/notification.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAEpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAIhG,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AASF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBACa,sBAAuB,SAAQ,kBAAkB,CAC5D,YAAY,EACZ,OAAO,sBAAsB,CAAC,aAAa,CAC5C;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;OAA0B;gBAE3C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;;;;;OAQG;IACG,YAAY;IASlB;;;;;;;;;OASG;IACH,SAAS,CAAC,oBAAoB,IAAI,kBAAkB,CAAC,YAAY,CAAC;IAIlE,kFAAkF;IAClF,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK1C,WAAW,CAAC,MAAM,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,sBAAsB,CAAC;QAChC,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2BrB,eAAe,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAoB1F,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE;IAmBhE,OAAO,CAAC,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;IAgBhD;;;;;;;;;;;;;OAaG;IACG,kBAAkB,CAAC,MAAM,EAAE;QAC/B,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;KAChC,GAAG,OAAO,CAAC,YAAY,CAAC;IAkGzB;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAC7B,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;CA2ElC"}