@carlonicora/nestjs-neo4jsonapi 1.115.1 → 1.117.0

package/dist/foundations/content/services/content.cypher.service.js

@@ -36,8 +36,16 @@ let ContentCypherService = class ContentCypherService {
             // Base MATCH clauses for core relationships
             let query = `
       MATCH (${content_meta_1.contentMeta.nodeName})-[:BELONGS_TO]->(${content_meta_1.contentMeta.nodeName}_${company_meta_1.companyMeta.nodeName}:${company_meta_1.companyMeta.labelName})
-      MATCH (${content_meta_1.contentMeta.nodeName})<-[:PUBLISHED]-(${content_meta_1.contentMeta.nodeName}_${user_meta_1.ownerMeta.nodeName}:${user_meta_1.ownerMeta.labelName})
-      MATCH (${content_meta_1.contentMeta.nodeName})<-[:PUBLISHED]-(${content_meta_1.contentMeta.nodeName}_${user_meta_1.authorMeta.nodeName}:${user_meta_1.authorMeta.labelName})`;
+      ${this.ownerMatch({ target: `${content_meta_1.contentMeta.nodeName}_${user_meta_1.ownerMeta.nodeName}:${user_meta_1.ownerMeta.labelName}` })}`;
+            // The author match is OPTIONAL: it traverses the SAME `PUBLISHED` edge as
+            // the owner match above, so on package data every row surviving the owner
+            // match already resolves it — the row set is unchanged by default. Making
+            // it optional stops it from silently dropping every row for apps whose
+            // owner edge is not `PUBLISHED` (see `ownerMatchPattern`).
+            if (this.serialiseAuthor) {
+                query += `
+      OPTIONAL MATCH (${content_meta_1.contentMeta.nodeName})<-[:PUBLISHED]-(${content_meta_1.contentMeta.nodeName}_${user_meta_1.authorMeta.nodeName}:${user_meta_1.authorMeta.labelName})`;
+            }
             // Add OPTIONAL MATCH for extension relationships
             if (this.extension?.additionalRelationships) {
                 for (const rel of this.extension.additionalRelationships) {
@@ -51,12 +59,22 @@ let ContentCypherService = class ContentCypherService {
       OPTIONAL MATCH ${relPattern}`;
                 }
             }
+            // Add the config-driven meta-field clauses (appended verbatim)
+            if (this.extension?.metaFields) {
+                for (const metaField of this.extension.metaFields) {
+                    query += `
+      ${metaField.optionalMatch}`;
+                }
+            }
             // Base RETURN clause
             query += `
       RETURN ${content_meta_1.contentMeta.nodeName},
         ${content_meta_1.contentMeta.nodeName}_${company_meta_1.companyMeta.nodeName},
-        ${content_meta_1.contentMeta.nodeName}_${user_meta_1.ownerMeta.nodeName},
+        ${content_meta_1.contentMeta.nodeName}_${user_meta_1.ownerMeta.nodeName}`;
+            if (this.serialiseAuthor) {
+                query += `,
         ${content_meta_1.contentMeta.nodeName}_${user_meta_1.authorMeta.nodeName}`;
+            }
             // Add extension relationship nodes to RETURN
             if (this.extension?.additionalRelationships) {
                 for (const rel of this.extension.additionalRelationships) {
@@ -64,6 +82,13 @@ let ContentCypherService = class ContentCypherService {
         ${content_meta_1.contentMeta.nodeName}_${rel.model.nodeName}`;
                 }
             }
+            // Add the config-driven meta-field projections
+            if (this.extension?.metaFields) {
+                for (const metaField of this.extension.metaFields) {
+                    query += `,
+        ${metaField.returnAlias} AS ${metaField.key}`;
+                }
+            }
             // Add optional totalScore
             if (params?.useTotalScore) {
                 query += `,
@@ -76,16 +101,52 @@ let ContentCypherService = class ContentCypherService {
         const types = this.configService.get("contentTypes")?.types ?? [];
         return types.length > 0 ? types : [content_meta_1.contentMeta.labelName];
     }
+    /** Whether the `author` relationship is matched and returned (default: yes). */
+    get serialiseAuthor() {
+        return this.extension?.serialiseAuthor !== false;
+    }
     default(params) {
         return `
       MATCH (${content_meta_1.contentMeta.nodeName}:${this.getContentTypes().join("|")} ${params ? ` {${params.searchField}: $searchValue}` : ``})
-      WHERE $companyId IS NULL
+      WHERE ${this.extension?.requireTldr
+            ? `${content_meta_1.contentMeta.nodeName}.tldr IS NOT NULL
+      AND ${content_meta_1.contentMeta.nodeName}.tldr <> ""
+      AND `
+            : ``}$companyId IS NULL
       OR EXISTS {
         MATCH (${content_meta_1.contentMeta.nodeName})-[:BELONGS_TO]-(company)
       }
       WITH ${content_meta_1.contentMeta.nodeName}${params?.blockCompanyAndUser ? `` : `, company, currentUser`}
     `;
     }
+    /**
+     * The `requireTldr` filter as trailing `AND` predicates, for callers that
+     * already opened a WHERE clause of their own (e.g. `ContentRepository.findByIds`).
+     * Returns an empty string when the filter is disabled (the default).
+     */
+    tldrFilter() {
+        if (!this.extension?.requireTldr)
+            return ``;
+        return `
+        AND ${content_meta_1.contentMeta.nodeName}.tldr IS NOT NULL
+        AND ${content_meta_1.contentMeta.nodeName}.tldr <> ""`;
+    }
+    /**
+     * The Content → owner MATCH clause, driven by `ownerMatchPattern`.
+     *
+     * Default: `MATCH (content)<-[:PUBLISHED]-(<target>)`.
+     *
+     * @param params.target - The pattern's node body, e.g. `"content_owner:User"`
+     *   (bind an alias) or `":User {id: $ownerId}"` (filter without binding).
+     */
+    ownerMatch(params) {
+        const pattern = this.extension?.ownerMatchPattern;
+        const relationships = pattern?.relationships?.length ? pattern.relationships : ["PUBLISHED"];
+        const relationshipTypes = relationships.join("|");
+        return pattern?.undirected
+            ? `MATCH (${content_meta_1.contentMeta.nodeName})-[:${relationshipTypes}]-(${params.target})`
+            : `MATCH (${content_meta_1.contentMeta.nodeName})<-[:${relationshipTypes}]-(${params.target})`;
+    }
 };
 exports.ContentCypherService = ContentCypherService;
 exports.ContentCypherService = ContentCypherService = __decorate([

package/dist/foundations/content/services/content.cypher.service.js.map

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

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

@@ -13,7 +13,7 @@ exports.ContentService = void 0;
 const common_1 = require("@nestjs/common");
 const jsonapi_paginator_1 = require("../../../core/jsonapi/serialisers/jsonapi.paginator");
 const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
-const content_model_1 = require("../../content/entities/content.model");
+const content_1 = require("../../content/entities/content");
 const content_repository_1 = require("../../content/repositories/content.repository");
 let ContentService = class ContentService {
     constructor(builder, contentRepository) {
@@ -22,7 +22,7 @@ let ContentService = class ContentService {
     }
     async find(params) {
         const paginator = new jsonapi_paginator_1.JsonApiPaginator(params.query);
-        return this.builder.buildList(content_model_1.ContentModel, await this.contentRepository.find({
+        return this.builder.buildList((0, content_1.getContentModel)(), await this.contentRepository.find({
             fetchAll: params.fetchAll,
             term: params.term,
             orderBy: params.orderBy,
@@ -30,13 +30,13 @@ let ContentService = class ContentService {
         }), paginator);
     }
     async findByIds(params) {
-        return this.builder.buildList(content_model_1.ContentModel, await this.contentRepository.findByIds({
+        return this.builder.buildList((0, content_1.getContentModel)(), await this.contentRepository.findByIds({
             contentIds: params.contentIds,
         }));
     }
     async findByOwner(params) {
         const paginator = new jsonapi_paginator_1.JsonApiPaginator(params.query);
-        return this.builder.buildList(content_model_1.ContentModel, await this.contentRepository.findByOwner({
+        return this.builder.buildList((0, content_1.getContentModel)(), await this.contentRepository.findByOwner({
             ownerId: params.ownerId,
             fetchAll: params.fetchAll,
             term: params.term,

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

@@ -1 +1 @@
-{"version":3,"file":"content.service.js","sourceRoot":"","sources":["../../../../src/foundations/content/services/content.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,2FAAuF;AACvF,oFAAgF;AAChF,wEAAoE;AACpE,sFAAkF;AAG3E,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,YACmB,OAAuB,EACvB,iBAAoC;QADpC,YAAO,GAAP,OAAO,CAAgB;QACvB,sBAAiB,GAAjB,iBAAiB,CAAmB;IACpD,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,MAKV;QACC,MAAM,SAAS,GAAqB,IAAI,oCAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,4BAAY,EACZ,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;SACnC,CAAC,EACF,SAAS,CACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAgC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,4BAAY,EACZ,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACrC,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA4F;QAC5G,MAAM,SAAS,GAAqB,IAAI,oCAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,4BAAY,EACZ,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC;YACvC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;SACnC,CAAC,EACF,SAAS,CACV,CAAC;IACJ,CAAC;CACF,CAAA;AAlDY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAGiB,gCAAc;QACJ,sCAAiB;GAH5C,cAAc,CAkD1B"}
+{"version":3,"file":"content.service.js","sourceRoot":"","sources":["../../../../src/foundations/content/services/content.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAE5C,2FAAuF;AACvF,oFAAgF;AAChF,4DAAiE;AACjE,sFAAkF;AAG3E,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,YACmB,OAAuB,EACvB,iBAAoC;QADpC,YAAO,GAAP,OAAO,CAAgB;QACvB,sBAAiB,GAAjB,iBAAiB,CAAmB;IACpD,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,MAKV;QACC,MAAM,SAAS,GAAqB,IAAI,oCAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,IAAA,yBAAe,GAAE,EACjB,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;SACnC,CAAC,EACF,SAAS,CACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAgC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,IAAA,yBAAe,GAAE,EACjB,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC;YACrC,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA4F;QAC5G,MAAM,SAAS,GAAqB,IAAI,oCAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,IAAA,yBAAe,GAAE,EACjB,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC;YACvC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;SACnC,CAAC,EACF,SAAS,CACV,CAAC;IACJ,CAAC;CACF,CAAA;AAlDY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAGiB,gCAAc;QACJ,sCAAiB;GAH5C,cAAc,CAkD1B"}

package/dist/foundations/discord-user/services/discord-user.service.js

@@ -27,11 +27,11 @@ let DiscordUserService = class DiscordUserService {
     async create(params) {
         this.clsService.set("companyId", params.companyId);
         this.clsService.set("userId", params.userId);
-        await this.companyRepository.create({
+        await this.companyRepository.createCompanyNode({
             companyId: params.companyId,
             name: `${params.userDetails.username}`,
         });
-        await this.userRepository.create({
+        await this.userRepository.createUser({
             userId: params.userId,
             email: params.userDetails.email ?? params.userDetails.id,
             name: params.userDetails.username,

package/dist/foundations/discord-user/services/discord-user.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"discord-user.service.js","sourceRoot":"","sources":["../../../../src/foundations/discord-user/services/discord-user.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,mCAAoC;AACpC,2CAAwC;AACxC,4CAAyC;AACzC,2CAAkD;AAClD,qCAA4C;AAC5C,qFAAgF;AAIzE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YACmB,qBAA4C,EAC5C,cAA8B,EAC9B,iBAAoC,EACpC,UAAsB;QAHtB,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,eAAU,GAAV,UAAU,CAAY;IACtC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,MAOZ;QACC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAE7C,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE;SACvC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE;YACxD,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ;YACjC,QAAQ,EAAE,IAAA,mBAAU,GAAE;YACtB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;YACjC,OAAO,EAAE,CAAC,eAAM,CAAC,oBAAoB,CAAC;YACtC,QAAQ,EAAE,IAAI;YACd,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,SAAS;SAC3D,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC;YACtC,EAAE,EAAE,MAAM,CAAC,MAAM;YACjB,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE;YAChC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ;YACjC,IAAI,EAAE,MAAM,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA7CY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;qCAG+B,+CAAqB;QAC5B,qBAAc;QACX,2BAAiB;QACxB,uBAAU;GAL9B,kBAAkB,CA6C9B"}
+{"version":3,"file":"discord-user.service.js","sourceRoot":"","sources":["../../../../src/foundations/discord-user/services/discord-user.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,mCAAoC;AACpC,2CAAwC;AACxC,4CAAyC;AACzC,2CAAkD;AAClD,qCAA4C;AAC5C,qFAAgF;AAIzE,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAC7B,YACmB,qBAA4C,EAC5C,cAA8B,EAC9B,iBAAoC,EACpC,UAAsB;QAHtB,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,eAAU,GAAV,UAAU,CAAY;IACtC,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,MAOZ;QACC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAE7C,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC;YAC7C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE;SACvC,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;YACnC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE;YACxD,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ;YACjC,QAAQ,EAAE,IAAA,mBAAU,GAAE;YACtB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;YACjC,OAAO,EAAE,CAAC,eAAM,CAAC,oBAAoB,CAAC;YACtC,QAAQ,EAAE,IAAI;YACd,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,SAAS;SAC3D,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC;YACtC,EAAE,EAAE,MAAM,CAAC,MAAM;YACjB,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE;YAChC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ;YACjC,IAAI,EAAE,MAAM,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA7CY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,mBAAU,GAAE;qCAG+B,+CAAqB;QAC5B,qBAAc;QACX,2BAAiB;QACxB,uBAAU;GAL9B,kBAAkB,CA6C9B"}

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

@@ -0,0 +1,32 @@
+import { Entity } from "../../../common/abstracts/entity";
+import { Module } from "../../module/entities/module.entity";
+/**
+ * Feature Entity Type
+ */
+export type Feature = Entity & {
+    name: string;
+    isCore: boolean;
+    module: Module[];
+};
+/**
+ * Feature Entity Descriptor
+ *
+ * Single source of truth for the Feature entity configuration.
+ * Generates mapper, childrenTokens, and DataModelInterface automatically.
+ */
+export declare const FeatureDescriptor: import("../../..").EntityDescriptor<Feature, {
+    module: {
+        model: import("../../..").DataMeta;
+        direction: "in";
+        relationship: string;
+        cardinality: "many";
+        dtoKey: string;
+        description: string;
+        reverse: {
+            name: string;
+            description: string;
+        };
+    };
+}>;
+export type FeatureDescriptorType = typeof FeatureDescriptor;
+//# sourceMappingURL=feature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../../src/foundations/feature/entities/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAI7D;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAEhB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAyD5B,CAAC;AAGH,MAAM,MAAM,qBAAqB,GAAG,OAAO,iBAAiB,CAAC"}

package/dist/foundations/feature/entities/feature.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const module_meta_1 = require("../../module/entities/module.meta");
+const feature_meta_1 = require("./feature.meta");
+/**
+ * Feature Entity Descriptor
+ *
+ * Single source of truth for the Feature entity configuration.
+ * Generates mapper, childrenTokens, and DataModelInterface automatically.
+ */
+exports.FeatureDescriptor = (0, define_entity_1.defineEntity)()({
+    ...feature_meta_1.featureMeta,
+    // Features are global RBAC building blocks seeded once for the whole platform —
+    // there is no (Feature)-[:BELONGS_TO]->(Company) edge in the graph. Companies opt
+    // into features via a separate (Company)-[:HAS_FEATURE]->(Feature) edge (see
+    // FeatureRepository.findByCompany). Leaving this unset (defaults to true) would
+    // make the inherited buildDefaultMatch()/create()/put() require a BELONGS_TO edge
+    // that never exists, silently returning zero rows / failing writes.
+    isCompanyScoped: false,
+    // Catalog metadata: consumed by GraphDescriptorRegistry/GraphCatalogService when a
+    // host app graph-registers this descriptor. Inert for apps that never register it,
+    // and invisible to JSON:API — but the catalog contract REQUIRES a top-level
+    // description plus at least one described field, so these are not optional copy.
+    description: "A platform feature flag: a named capability of the product that can be enabled per company " +
+        "and that groups the RBAC modules (screens/entities) a company's users may access when the feature is on.",
+    chat: {
+        summary: (d) => d.name ?? d.id,
+        textSearchFields: ["name"],
+    },
+    // Field definitions
+    fields: {
+        name: {
+            type: "string",
+            required: true,
+            description: "The feature's display name.",
+        },
+        isCore: {
+            type: "boolean",
+            required: true,
+            default: false,
+            description: "Whether this feature is a core platform capability that every company has, as opposed to an opt-in add-on.",
+        },
+    },
+    // Relationship definitions
+    relationships: {
+        module: {
+            model: module_meta_1.moduleMeta,
+            direction: "in",
+            relationship: "IN_FEATURE",
+            cardinality: "many",
+            dtoKey: "modules",
+            description: "The RBAC modules (screens/entities) grouped under this feature.",
+            // `reverse.description` is a REQUIRED key on RelationshipDef["reverse"] —
+            // ported verbatim from the app descriptor (it was already English).
+            reverse: {
+                name: "feature",
+                description: "The feature this RBAC module belongs to.",
+            },
+        },
+    },
+});
+//# sourceMappingURL=feature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","sourceRoot":"","sources":["../../../../src/foundations/feature/entities/feature.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AAErE,mEAA+D;AAC/D,iDAA6C;AAY7C;;;;;GAKG;AACU,QAAA,iBAAiB,GAAG,IAAA,4BAAY,GAAW,CAAC;IACvD,GAAG,0BAAW;IAEd,gFAAgF;IAChF,kFAAkF;IAClF,6EAA6E;IAC7E,gFAAgF;IAChF,kFAAkF;IAClF,oEAAoE;IACpE,eAAe,EAAE,KAAK;IAEtB,mFAAmF;IACnF,mFAAmF;IACnF,4EAA4E;IAC5E,iFAAiF;IACjF,WAAW,EACT,6FAA6F;QAC7F,0GAA0G;IAE5G,IAAI,EAAE;QACJ,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE;QAC9B,gBAAgB,EAAE,CAAC,MAAM,CAAC;KAC3B;IAED,oBAAoB;IACpB,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,6BAA6B;SAC3C;QACD,MAAM,EAAE;YACN,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,KAAK;YACd,WAAW,EACT,4GAA4G;SAC/G;KACF;IAED,2BAA2B;IAC3B,aAAa,EAAE;QACb,MAAM,EAAE;YACN,KAAK,EAAE,wBAAU;YACjB,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,iEAAiE;YAC9E,0EAA0E;YAC1E,oEAAoE;YACpE,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0CAA0C;aACxD;SACF;KACF;CACF,CAAC,CAAC"}

package/dist/foundations/feature/entities/feature.model.d.ts

@@ -1,4 +1,2 @@
-import { DataModelInterface } from "../../../common/interfaces/datamodel.interface";
-import { Feature } from "../../feature/entities/feature.entity";
-export declare const FeatureModel: DataModelInterface<Feature>;
+export declare const FeatureModel: import("../../..").DataModelInterface<import("./feature").Feature>;
 //# sourceMappingURL=feature.model.d.ts.map

package/dist/foundations/feature/entities/feature.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feature.model.d.ts","sourceRoot":"","sources":["../../../../src/foundations/feature/entities/feature.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAMhE,eAAO,MAAM,YAAY,EAAE,kBAAkB,CAAC,OAAO,CAMpD,CAAC"}
+{"version":3,"file":"feature.model.d.ts","sourceRoot":"","sources":["../../../../src/foundations/feature/entities/feature.model.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,oEAA0B,CAAC"}

package/dist/foundations/feature/entities/feature.model.js

@@ -1,15 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeatureModel = void 0;
-const feature_map_1 = require("../../feature/entities/feature.map");
-const feature_meta_1 = require("../../feature/entities/feature.meta");
-const feature_serialiser_1 = require("../../feature/serialisers/feature.serialiser");
-const module_meta_1 = require("../../module/entities/module.meta");
-exports.FeatureModel = {
-    ...feature_meta_1.featureMeta,
-    entity: undefined,
-    mapper: feature_map_1.mapFeature,
-    serialiser: feature_serialiser_1.FeatureSerialiser,
-    childrenTokens: [module_meta_1.moduleMeta.nodeName],
-};
+// Backward-compatibility aliases for pre-descriptor consumers (e.g. stripe-price serialiser).
+const feature_1 = require("./feature");
+exports.FeatureModel = feature_1.FeatureDescriptor.model;
 //# sourceMappingURL=feature.model.js.map

package/dist/foundations/feature/entities/feature.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature.model.js","sourceRoot":"","sources":["../../../../src/foundations/feature/entities/feature.model.ts"],"names":[],"mappings":";;;AAEA,oEAAgE;AAChE,sEAAkE;AAClE,qFAAiF;AACjF,mEAA+D;AAElD,QAAA,YAAY,GAAgC;IACvD,GAAG,0BAAW;IACd,MAAM,EAAE,SAA+B;IACvC,MAAM,EAAE,wBAAU;IAClB,UAAU,EAAE,sCAAiB;IAC7B,cAAc,EAAE,CAAC,wBAAU,CAAC,QAAQ,CAAC;CACtC,CAAC"}
+{"version":3,"file":"feature.model.js","sourceRoot":"","sources":["../../../../src/foundations/feature/entities/feature.model.ts"],"names":[],"mappings":";;;AAAA,8FAA8F;AAC9F,uCAA8C;AAEjC,QAAA,YAAY,GAAG,2BAAiB,CAAC,KAAK,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"feature.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/feature/feature.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAStD,qBAKa,aAAc,YAAW,YAAY;IAChD,YAAY;CAGb"}
+{"version":3,"file":"feature.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/feature/feature.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQtD,qBAKa,aAAc,YAAW,YAAY;IAChD,YAAY;CAGb"}

package/dist/foundations/feature/feature.module.js

@@ -10,21 +10,20 @@ exports.FeatureModule = void 0;
 const common_1 = require("@nestjs/common");
 const registry_1 = require("../../common/registries/registry");
 const feature_controller_1 = require("./controllers/feature.controller");
-const feature_model_1 = require("./entities/feature.model");
-const feature_serialiser_1 = require("./serialisers/feature.serialiser");
+const feature_1 = require("./entities/feature");
 const feature_repository_1 = require("./repositories/feature.repository");
 const feature_service_1 = require("./services/feature.service");
 let FeatureModule = class FeatureModule {
     onModuleInit() {
-        registry_1.modelRegistry.register(feature_model_1.FeatureModel);
+        registry_1.modelRegistry.register(feature_1.FeatureDescriptor.model);
     }
 };
 exports.FeatureModule = FeatureModule;
 exports.FeatureModule = FeatureModule = __decorate([
     (0, common_1.Module)({
         controllers: [feature_controller_1.FeatureController],
-        providers: [feature_repository_1.FeatureRepository, feature_service_1.FeatureService, feature_serialiser_1.FeatureSerialiser],
-        exports: [feature_service_1.FeatureService, feature_repository_1.FeatureRepository, feature_serialiser_1.FeatureSerialiser],
+        providers: [feature_repository_1.FeatureRepository, feature_service_1.FeatureService, feature_1.FeatureDescriptor.model.serialiser],
+        exports: [feature_service_1.FeatureService, feature_repository_1.FeatureRepository, feature_1.FeatureDescriptor.model.serialiser],
     })
 ], FeatureModule);
 //# sourceMappingURL=feature.module.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"feature.module.js","sourceRoot":"","sources":["../../../src/foundations/feature/feature.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AAEtD,+DAAiE;AACjE,yEAAqE;AACrE,4DAAwD;AACxD,yEAAqE;AACrE,0EAAsE;AACtE,gEAA4D;AAOrD,IAAM,aAAa,GAAnB,MAAM,aAAa;IACxB,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,4BAAY,CAAC,CAAC;IACvC,CAAC;CACF,CAAA;AAJY,sCAAa;wBAAb,aAAa;IALzB,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,sCAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,sCAAiB,EAAE,gCAAc,EAAE,sCAAiB,CAAC;QACjE,OAAO,EAAE,CAAC,gCAAc,EAAE,sCAAiB,EAAE,sCAAiB,CAAC;KAChE,CAAC;GACW,aAAa,CAIzB"}
+{"version":3,"file":"feature.module.js","sourceRoot":"","sources":["../../../src/foundations/feature/feature.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAsD;AAEtD,+DAAiE;AACjE,yEAAqE;AACrE,gDAAuD;AACvD,0EAAsE;AACtE,gEAA4D;AAOrD,IAAM,aAAa,GAAnB,MAAM,aAAa;IACxB,YAAY;QACV,wBAAa,CAAC,QAAQ,CAAC,2BAAiB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF,CAAA;AAJY,sCAAa;wBAAb,aAAa;IALzB,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,sCAAiB,CAAC;QAChC,SAAS,EAAE,CAAC,sCAAiB,EAAE,gCAAc,EAAE,2BAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;QAClF,OAAO,EAAE,CAAC,gCAAc,EAAE,sCAAiB,EAAE,2BAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;KACjF,CAAC;GACW,aAAa,CAIzB"}

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

@@ -1,2 +1,14 @@
 export { FeatureModule } from "./feature.module";
+export { Feature, FeatureDescriptor, FeatureDescriptorType } from "./entities/feature";
+export { featureMeta } from "./entities/feature.meta";
+export { FeatureModel } from "./entities/feature.model";
+export { FeatureRepository } from "./repositories/feature.repository";
+export { FeatureService } from "./services/feature.service";
+export { FeatureDTO, FeatureDataDTO, FeatureDataListDTO } from "./dtos/feature.dto";
+/**
+ * Compat alias: the hand-written FeatureSerialiser class was replaced by the
+ * descriptor's auto-generated serialiser. The exported name is kept so existing
+ * consumers (DI providers, serialiser factories) keep resolving.
+ */
+export declare const FeatureSerialiser: new (...args: any[]) => import("../..").SerialiserType;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/feature/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/feature/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEpF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,wDAAsC,CAAC"}

package/dist/foundations/feature/index.js

@@ -1,6 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FeatureModule = void 0;
+exports.FeatureSerialiser = exports.FeatureDataListDTO = exports.FeatureDataDTO = exports.FeatureDTO = exports.FeatureService = exports.FeatureRepository = exports.FeatureModel = exports.featureMeta = exports.FeatureDescriptor = exports.FeatureModule = void 0;
+const feature_1 = require("./entities/feature");
 var feature_module_1 = require("./feature.module");
 Object.defineProperty(exports, "FeatureModule", { enumerable: true, get: function () { return feature_module_1.FeatureModule; } });
+var feature_2 = require("./entities/feature");
+Object.defineProperty(exports, "FeatureDescriptor", { enumerable: true, get: function () { return feature_2.FeatureDescriptor; } });
+var feature_meta_1 = require("./entities/feature.meta");
+Object.defineProperty(exports, "featureMeta", { enumerable: true, get: function () { return feature_meta_1.featureMeta; } });
+var feature_model_1 = require("./entities/feature.model");
+Object.defineProperty(exports, "FeatureModel", { enumerable: true, get: function () { return feature_model_1.FeatureModel; } });
+var feature_repository_1 = require("./repositories/feature.repository");
+Object.defineProperty(exports, "FeatureRepository", { enumerable: true, get: function () { return feature_repository_1.FeatureRepository; } });
+var feature_service_1 = require("./services/feature.service");
+Object.defineProperty(exports, "FeatureService", { enumerable: true, get: function () { return feature_service_1.FeatureService; } });
+var feature_dto_1 = require("./dtos/feature.dto");
+Object.defineProperty(exports, "FeatureDTO", { enumerable: true, get: function () { return feature_dto_1.FeatureDTO; } });
+Object.defineProperty(exports, "FeatureDataDTO", { enumerable: true, get: function () { return feature_dto_1.FeatureDataDTO; } });
+Object.defineProperty(exports, "FeatureDataListDTO", { enumerable: true, get: function () { return feature_dto_1.FeatureDataListDTO; } });
+/**
+ * Compat alias: the hand-written FeatureSerialiser class was replaced by the
+ * descriptor's auto-generated serialiser. The exported name is kept so existing
+ * consumers (DI providers, serialiser factories) keep resolving.
+ */
+exports.FeatureSerialiser = feature_1.FeatureDescriptor.model.serialiser;
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/feature/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/feature/index.ts"],"names":[],"mappings":";;;AAAA,gDAA6E;AAE7E,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,8CAAuF;AAArE,4GAAA,iBAAiB,OAAA;AACnC,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,0DAAwD;AAA/C,6GAAA,YAAY,OAAA;AACrB,wEAAsE;AAA7D,uHAAA,iBAAiB,OAAA;AAC1B,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AACvB,kDAAoF;AAA3E,yGAAA,UAAU,OAAA;AAAE,6GAAA,cAAc,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAEvD;;;;GAIG;AACU,QAAA,iBAAiB,GAAG,2BAAkB,CAAC,KAAK,CAAC,UAAU,CAAC"}

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

@@ -1,19 +1,43 @@
-import { OnModuleInit } from "@nestjs/common";
-import { JsonApiCursorInterface } from "../../../core/jsonapi/interfaces/jsonapi.cursor.interface";
-import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
 import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
-import { Feature } from "../../feature/entities/feature.entity";
-export declare class FeatureRepository implements OnModuleInit {
-    private readonly neo4j;
-    private readonly logger;
-    constructor(neo4j: Neo4jService, logger: AppLoggingService);
-    onModuleInit(): Promise<void>;
+import { SecurityService } from "../../../core/security/services/security.service";
+import { Feature, FeatureDescriptor } from "../entities/feature";
+export declare class FeatureRepository extends AbstractRepository<Feature, typeof FeatureDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<Feature, {
+        module: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "many";
+            dtoKey: string;
+            description: string;
+            reverse: {
+                name: string;
+                description: string;
+            };
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Companies opt into features via a (Company)-[:HAS_FEATURE]->(Feature) edge that
+     * is NOT modelled as a descriptor relationship (Feature.isCompanyScoped is false —
+     * it is a global entity many companies point to, not something a Feature "belongs"
+     * to). The explicit Company MATCH is the intended cross-tenant opt-in for a global
+     * entity, not a bypass of buildDefaultMatch(). Keep the name and signature stable —
+     * external consumers depend on them.
+     */
     findByCompany(params: {
         companyId: string;
     }): Promise<Feature[]>;
-    find(params: {
-        term?: string;
-        cursor: JsonApiCursorInterface;
-    }): Promise<Feature[]>;
+    /**
+     * Case-insensitive exact-name lookup — not the fulltext CONTAINS search the
+     * inherited find({ term }) performs. Feature is a global entity, so the bare
+     * label MATCH is correct here. Keep the name and signature stable — external
+     * consumers depend on them.
+     */
+    findByName(params: {
+        name: string;
+    }): Promise<Feature>;
 }
 //# sourceMappingURL=feature.repository.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"feature.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/feature/repositories/feature.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAGhE,qBACa,iBAAkB,YAAW,YAAY;IAElD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,iBAAiB;IAGtC,YAAY;IAMZ,aAAa,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAehE,IAAI,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,sBAAsB,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAsB1F"}
+{"version":3,"file":"feature.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/feature/repositories/feature.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGjE,qBACa,iBAAkB,SAAQ,kBAAkB,CAAC,OAAO,EAAE,OAAO,iBAAiB,CAAC,aAAa,CAAC;IACxG,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;OAAqB;gBAEtC,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAWzF;;;;;;;OAOG;IACG,aAAa,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAatE;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAa7D"}

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

@@ -11,54 +11,60 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeatureRepository = void 0;
 const common_1 = require("@nestjs/common");
-const logging_service_1 = require("../../../core/logging/services/logging.service");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
 const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
-const feature_model_1 = require("../../feature/entities/feature.model");
-let FeatureRepository = class FeatureRepository {
-    constructor(neo4j, logger) {
-        this.neo4j = neo4j;
-        this.logger = logger;
-    }
-    async onModuleInit() {
-        await this.neo4j.writeOne({
-            query: `CREATE CONSTRAINT feature_id IF NOT EXISTS FOR (feature:Feature) REQUIRE feature.id IS UNIQUE`,
-        });
+const security_service_1 = require("../../../core/security/services/security.service");
+const feature_1 = require("../entities/feature");
+const feature_meta_1 = require("../entities/feature.meta");
+let FeatureRepository = class FeatureRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = feature_1.FeatureDescriptor;
     }
+    // onModuleInit() (id constraint + fulltext index) and find({ term, cursor, orderBy })
+    // (search + module relationship) are inherited — the descriptor declares `module` as a
+    // cardinality-many relationship, so buildReturnStatement() already emits the
+    // `OPTIONAL MATCH (feature)<-[:IN_FEATURE]-(feature_module:Module)` the old bespoke
+    // find() had, and the `name` string field auto-generates the fulltext index the
+    // inherited find() searches against for `term`.
+    /**
+     * Companies opt into features via a (Company)-[:HAS_FEATURE]->(Feature) edge that
+     * is NOT modelled as a descriptor relationship (Feature.isCompanyScoped is false —
+     * it is a global entity many companies point to, not something a Feature "belongs"
+     * to). The explicit Company MATCH is the intended cross-tenant opt-in for a global
+     * entity, not a bypass of buildDefaultMatch(). Keep the name and signature stable —
+     * external consumers depend on them.
+     */
     async findByCompany(params) {
-        const query = this.neo4j.initQuery({ serialiser: feature_model_1.FeatureModel });
-        query.queryParams = {
-            companyId: params.companyId,
-        };
+        const query = this.neo4j.initQuery({ serialiser: feature_1.FeatureDescriptor.model });
+        query.queryParams = { ...query.queryParams, companyId: params.companyId };
         query.query = `
-      MATCH (company:Company {id: $companyId})-[:HAS_FEATURE]->(feature:Feature)
-      RETURN feature
+      MATCH (company:Company {id: $companyId})-[:HAS_FEATURE]->(${feature_meta_1.featureMeta.nodeName}:${feature_meta_1.featureMeta.labelName})
+      RETURN ${feature_meta_1.featureMeta.nodeName}
     `;
         return this.neo4j.readMany(query);
     }
-    async find(params) {
-        const query = this.neo4j.initQuery({ serialiser: feature_model_1.FeatureModel, cursor: params.cursor });
-        query.queryParams = {
-            term: params.term,
-        };
+    /**
+     * Case-insensitive exact-name lookup — not the fulltext CONTAINS search the
+     * inherited find({ term }) performs. Feature is a global entity, so the bare
+     * label MATCH is correct here. Keep the name and signature stable — external
+     * consumers depend on them.
+     */
+    async findByName(params) {
+        const query = this.neo4j.initQuery({ serialiser: feature_1.FeatureDescriptor.model });
+        query.queryParams = { ...query.queryParams, name: params.name };
         query.query = `
-      MATCH (feature:Feature)
-      ${params.term ? "WHERE toLower(feature.name) CONTAINS toLower($term)" : ""}
-      
-      WITH feature
-      ORDER BY feature.name ASC
-      {CURSOR}
-      
-      OPTIONAL MATCH (feature)<-[:IN_FEATURE]-(feature_module:Module)
-
-      RETURN feature, feature_module
+      MATCH (${feature_meta_1.featureMeta.nodeName}:${feature_meta_1.featureMeta.labelName})
+      WHERE toLower(${feature_meta_1.featureMeta.nodeName}.name) = toLower($name)
+      ${this.buildReturnStatement()}
     `;
-        return this.neo4j.readMany(query);
+        return this.neo4j.readOne(query);
     }
 };
 exports.FeatureRepository = FeatureRepository;
 exports.FeatureRepository = FeatureRepository = __decorate([
     (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService,
-        logging_service_1.AppLoggingService])
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
 ], FeatureRepository);
 //# sourceMappingURL=feature.repository.js.map