@carlonicora/nestjs-neo4jsonapi 1.115.0 → 1.116.0

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

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

@@ -1 +1 @@
-{"version":3,"file":"feature.repository.js","sourceRoot":"","sources":["../../../../src/foundations/feature/repositories/feature.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0D;AAE1D,oFAAmF;AACnF,8EAA0E;AAE1E,wEAAoE;AAG7D,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YACmB,KAAmB,EACnB,MAAyB;QADzB,UAAK,GAAL,KAAK,CAAc;QACnB,WAAM,GAAN,MAAM,CAAmB;IACzC,CAAC;IAEJ,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE,+FAA+F;SACvG,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA6B;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,4BAAY,EAAE,CAAC,CAAC;QAEjE,KAAK,CAAC,WAAW,GAAG;YAClB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG;;;KAGb,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAyD;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,4BAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAExF,KAAK,CAAC,WAAW,GAAG;YAClB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;QAEF,KAAK,CAAC,KAAK,GAAG;;QAEV,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,qDAAqD,CAAC,CAAC,CAAC,EAAE;;;;;;;;;KAS3E,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AAjDY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAGe,4BAAY;QACX,mCAAiB;GAHjC,iBAAiB,CAiD7B"}
+{"version":3,"file":"feature.repository.js","sourceRoot":"","sources":["../../../../src/foundations/feature/repositories/feature.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,iDAAiE;AACjE,2DAAuD;AAGhD,IAAM,iBAAiB,GAAvB,MAAM,iBAAkB,SAAQ,wCAAmE;IAGxG,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,2BAAiB,CAAC;IAIlD,CAAC;IAED,sFAAsF;IACtF,uFAAuF;IACvF,6EAA6E;IAC7E,oFAAoF;IACpF,gFAAgF;IAChF,gDAAgD;IAEhD;;;;;;;OAOG;IACH,KAAK,CAAC,aAAa,CAAC,MAA6B;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,2BAAiB,CAAC,KAAK,EAAE,CAAC,CAAC;QAE5E,KAAK,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAE1E,KAAK,CAAC,KAAK,GAAG;kEACgD,0BAAW,CAAC,QAAQ,IAAI,0BAAW,CAAC,SAAS;eAChG,0BAAW,CAAC,QAAQ;KAC9B,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,2BAAiB,CAAC,KAAK,EAAE,CAAC,CAAC;QAE5E,KAAK,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAEhE,KAAK,CAAC,KAAK,GAAG;eACH,0BAAW,CAAC,QAAQ,IAAI,0BAAW,CAAC,SAAS;sBACtC,0BAAW,CAAC,QAAQ;QAClC,IAAI,CAAC,oBAAoB,EAAE;KAC9B,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AAtDY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAIQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAH9E,iBAAiB,CAsD7B"}

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

@@ -1,14 +1,41 @@
+import { ClsService } from "nestjs-cls";
 import { JsonApiDataInterface } from "../../../core/jsonapi/interfaces/jsonapi.data.interface";
 import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { Feature, FeatureDescriptor } from "../entities/feature";
 import { FeatureRepository } from "../repositories/feature.repository";
-export declare class FeatureService {
-    private readonly builder;
+export declare class FeatureService extends AbstractService<Feature, typeof FeatureDescriptor.relationships> {
     private readonly featureRepository;
-    constructor(builder: JsonApiService, featureRepository: FeatureRepository);
+    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(jsonApiService: JsonApiService, featureRepository: FeatureRepository, clsService: ClsService);
+    /**
+     * Overrides the inherited find() only to preserve the old bespoke repository's
+     * `ORDER BY feature.name ASC` default — the framework's inherited default order
+     * is `updatedAt DESC` (EntityDescriptor.defaultOrderBy is not schema-overridable).
+     */
     find(params: {
-        term?: string;
         query: any;
+        term?: string;
+        fetchAll?: boolean;
+        orderBy?: string;
     }): Promise<JsonApiDataInterface>;
+    /**
+     * findByCompany wraps a repository query that is not a declared descriptor
+     * relationship (Feature.isCompanyScoped is false) — kept with its original name.
+     */
     findByCompany(params: {
         companyId: string;
     }): Promise<JsonApiDataInterface>;

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

@@ -1 +1 @@
-{"version":3,"file":"feature.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/feature/services/feature.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yDAAyD,CAAC;AAE/F,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,qBACa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBADjB,OAAO,EAAE,cAAc,EACvB,iBAAiB,EAAE,iBAAiB;IAGjD,IAAI,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAa1E,aAAa,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAQlF"}
+{"version":3,"file":"feature.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/feature/services/feature.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yDAAyD,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,qBACa,cAAe,SAAQ,eAAe,CAAC,OAAO,EAAE,OAAO,iBAAiB,CAAC,aAAa,CAAC;IAKhG,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAJpC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;OAAqB;gBAGhD,cAAc,EAAE,cAAc,EACb,iBAAiB,EAAE,iBAAiB,EACrD,UAAU,EAAE,UAAU;IAKxB;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,GAAG,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIjC;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAQlF"}

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

@@ -11,24 +11,31 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeatureService = void 0;
 const common_1 = require("@nestjs/common");
-const jsonapi_paginator_1 = require("../../../core/jsonapi/serialisers/jsonapi.paginator");
+const nestjs_cls_1 = require("nestjs-cls");
 const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
-const feature_model_1 = require("../../feature/entities/feature.model");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const feature_1 = require("../entities/feature");
 const feature_repository_1 = require("../repositories/feature.repository");
-let FeatureService = class FeatureService {
-    constructor(builder, featureRepository) {
-        this.builder = builder;
+let FeatureService = class FeatureService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, featureRepository, clsService) {
+        super(jsonApiService, featureRepository, clsService, feature_1.FeatureDescriptor.model);
         this.featureRepository = featureRepository;
+        this.descriptor = feature_1.FeatureDescriptor;
     }
+    /**
+     * Overrides the inherited find() only to preserve the old bespoke repository's
+     * `ORDER BY feature.name ASC` default — the framework's inherited default order
+     * is `updatedAt DESC` (EntityDescriptor.defaultOrderBy is not schema-overridable).
+     */
     async find(params) {
-        const paginator = new jsonapi_paginator_1.JsonApiPaginator(params.query);
-        return this.builder.buildList(feature_model_1.FeatureModel, await this.featureRepository.find({
-            term: params.term,
-            cursor: paginator.generateCursor(),
-        }), paginator);
+        return super.find({ ...params, orderBy: params.orderBy ?? "name ASC" });
     }
+    /**
+     * findByCompany wraps a repository query that is not a declared descriptor
+     * relationship (Feature.isCompanyScoped is false) — kept with its original name.
+     */
     async findByCompany(params) {
-        return this.builder.buildList(feature_model_1.FeatureModel, await this.featureRepository.findByCompany({
+        return this.jsonApiService.buildList(feature_1.FeatureDescriptor.model, await this.featureRepository.findByCompany({
             companyId: params.companyId,
         }));
     }
@@ -37,6 +44,7 @@ exports.FeatureService = FeatureService;
 exports.FeatureService = FeatureService = __decorate([
     (0, common_1.Injectable)(),
     __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
-        feature_repository_1.FeatureRepository])
+        feature_repository_1.FeatureRepository,
+        nestjs_cls_1.ClsService])
 ], FeatureService);
 //# sourceMappingURL=feature.service.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"feature.service.js","sourceRoot":"","sources":["../../../../src/foundations/feature/services/feature.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAG5C,2FAAuF;AACvF,oFAAgF;AAChF,wEAAoE;AACpE,2EAAuE;AAGhE,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,MAAqC;QAC9C,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,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;SACnC,CAAC,EACF,SAAS,CACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAA6B;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAC3B,4BAAY,EACZ,MAAM,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC;YACzC,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CACH,CAAC;IACJ,CAAC;CACF,CAAA;AA3BY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAGiB,gCAAc;QACJ,sCAAiB;GAH5C,cAAc,CA2B1B"}
+{"version":3,"file":"feature.service.js","sourceRoot":"","sources":["../../../../src/foundations/feature/services/feature.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AAExC,oFAAgF;AAChF,qFAAiF;AACjF,iDAAiE;AACjE,2EAAuE;AAGhE,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,kCAAgE;IAGlG,YACE,cAA8B,EACb,iBAAoC,EACrD,UAAsB;QAEtB,KAAK,CAAC,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,2BAAiB,CAAC,KAAK,CAAC,CAAC;QAH7D,sBAAiB,GAAjB,iBAAiB,CAAmB;QAJpC,eAAU,GAAG,2BAAiB,CAAC;IAQlD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAKV;QACC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,MAA6B;QAC/C,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAClC,2BAAiB,CAAC,KAAK,EACvB,MAAM,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC;YACzC,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CACH,CAAC;IACJ,CAAC;CACF,CAAA;AArCY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAKO,gCAAc;QACM,sCAAiB;QACzC,uBAAU;GANb,cAAc,CAqC1B"}

package/dist/foundations/foundations.modules.d.ts

@@ -1,6 +1,7 @@
 import { DynamicModule, Type } from "@nestjs/common";
 import { ContentExtensionConfig } from "./content/interfaces/content.extension.interface";
 import { ReferralModuleConfig } from "./referral/interfaces/referral.config.interface";
+import { UserActivityModuleConfig } from "./user-activity/interfaces/user-activity.config.interface";
 /**
  * Configuration options for FoundationsModule.
  */
@@ -9,9 +10,14 @@ export interface FoundationsModuleConfig {
     contentExtension?: ContentExtensionConfig;
     /** Optional configuration for the referral feature module */
     referral?: ReferralModuleConfig;
+    /** Optional configuration for the user-activity feature module */
+    userActivity?: UserActivityModuleConfig;
     /**
      * Foundation module classes to exclude from registration.
      * Default [] keeps all modules registered (neural-erp behavior unchanged).
+     *
+     * Dynamic modules are excluded by the same class reference as static ones:
+     * `exclude: [ContentModule, UserActivityModule]`.
      */
     exclude?: Type<any>[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"foundations.modules.d.ts","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAS7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AA2BvF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CAShE"}
+{"version":3,"file":"foundations.modules.d.ts","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAS7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AA0BvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AAGrG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,kEAAkE;IAClE,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AA0CD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CAoBhE"}

package/dist/foundations/foundations.modules.js

@@ -42,9 +42,11 @@ const stripe_trial_module_1 = require("./stripe-trial/stripe-trial.module");
 const tokenusage_module_1 = require("./tokenusage/tokenusage.module");
 const two_factor_module_1 = require("./two-factor/two-factor.module");
 const user_module_1 = require("./user/user.module");
+const user_activity_module_1 = require("./user-activity/user-activity.module");
 const waitlist_module_1 = require("./waitlist/waitlist.module");
 /**
- * All static foundation modules (excluding ContentModule which is dynamic).
+ * All static foundation modules. The dynamic ones (ContentModule,
+ * UserActivityModule, ReferralModule) are assembled inside forRoot().
  * Queue registration is handled centrally by QueueModule (via baseConfig.chunkQueues).
  */
 const STATIC_FOUNDATION_MODULES = [
@@ -118,10 +120,19 @@ let FoundationsModule = FoundationsModule_1 = class FoundationsModule {
     static forRoot(config) {
         const excluded = new Set(config?.exclude ?? []);
         const modules = STATIC_FOUNDATION_MODULES.filter((m) => !excluded.has(m));
+        // Dynamic foundation modules are excluded by class reference exactly like
+        // the static ones: the pair keeps the class (matched against `exclude`)
+        // next to the factory that configures it, and the factory only runs for
+        // modules that survive the filter.
+        const dynamicModules = [
+            { classRef: content_module_1.ContentModule, factory: () => content_module_1.ContentModule.forRoot(config?.contentExtension) },
+            { classRef: user_activity_module_1.UserActivityModule, factory: () => user_activity_module_1.UserActivityModule.forRoot(config?.userActivity) },
+            { classRef: referral_module_1.ReferralModule, factory: () => referral_module_1.ReferralModule.forRoot(config?.referral) },
+        ].filter((entry) => !excluded.has(entry.classRef));
         return {
             module: FoundationsModule_1,
-            imports: [...modules, content_module_1.ContentModule.forRoot(config?.contentExtension), referral_module_1.ReferralModule.forRoot(config?.referral)],
-            exports: [...modules, content_module_1.ContentModule, referral_module_1.ReferralModule],
+            imports: [...modules, ...dynamicModules.map((entry) => entry.factory())],
+            exports: [...modules, ...dynamicModules.map((entry) => entry.classRef)],
         };
     }
 };

package/dist/foundations/foundations.modules.js.map

@@ -1 +1 @@
-{"version":3,"file":"foundations.modules.js","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA6D;AAC7D,mEAA+D;AAC/D,sEAAkE;AAClE,uDAAmD;AACnD,oDAAgD;AAChD,uDAAmD;AACnD,6DAAyD;AACzD,6DAAyD;AACzD,6DAAyD;AAEzD,gEAA4D;AAE5D,4EAAuE;AACvE,6DAAyD;AACzD,0DAAqD;AACrD,sEAAkE;AAClE,sEAAkE;AAClE,0DAAsD;AACtD,4EAAwE;AACxE,uDAAmD;AACnD,oDAAgD;AAChD,mEAA+D;AAC/D,oDAAgD;AAChD,8CAA0C;AAC1C,kFAA6E;AAC7E,iDAAmD;AACnD,qDAAuD;AACvD,mEAAoE;AACpE,+DAAiE;AACjE,4EAAuE;AACvE,kFAA6E;AAC7E,0DAAsD;AACtD,4EAAuE;AACvE,sEAAkE;AAClE,sEAAiE;AACjE,oDAAgD;AAChD,gEAA4D;AAiB5D;;;GAGG;AACH,MAAM,yBAAyB,GAAG;IAChC,kCAAe;IACf,oCAAgB;IAChB,0BAAW;IACX,wBAAU;IACV,0BAAW;IACX,8BAAa;IACb,8BAAa;IACb,uCAAiB;IACjB,8BAAa;IACb,2BAAW;IACX,oCAAgB;IAChB,oCAAgB;IAChB,4BAAY;IACZ,wCAAkB;IAClB,0BAAW;IACX,wBAAU;IACV,kCAAe;IACf,wBAAU;IACV,oBAAQ;IACR,oCAAgB;IAChB,mCAAe;IACf,wBAAU;IACV,gCAAc;IACd,4BAAY;IACZ,iDAAyB;IACzB,8CAAwB;IACxB,gCAAiB;IACjB,oCAAmB;IACnB,2CAAmB;IACnB,uCAAiB;IACjB,2CAAmB;IACnB,uCAAiB;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,iBAAiB,yBAAvB,MAAM,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAgC;QAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAY,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO;YACL,MAAM,EAAE,mBAAiB;YACzB,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,8BAAa,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,gCAAc,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChH,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,8BAAa,EAAE,gCAAc,CAAC;SACrD,CAAC;IACJ,CAAC;CACF,CAAA;AAhBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,iBAAiB,CAgB7B"}
+{"version":3,"file":"foundations.modules.js","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":"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"}

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

@@ -27,11 +27,11 @@ let GoogleUserService = class GoogleUserService {
     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.name}`,
         });
-        await this.userRepository.create({
+        await this.userRepository.createUser({
             userId: params.userId,
             email: params.userDetails.email ?? params.userDetails.id,
             name: params.userDetails.name,

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

@@ -1 +1 @@
-{"version":3,"file":"google-user.service.js","sourceRoot":"","sources":["../../../../src/foundations/google-user/services/google-user.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,mCAAoC;AACpC,2CAAwC;AACxC,4CAAyC;AACzC,2CAAkD;AAClD,qCAA4C;AAC5C,mFAA8E;AAIvE,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YACmB,oBAA0C,EAC1C,cAA8B,EAC9B,iBAAoC,EACpC,UAAsB;QAHtB,yBAAoB,GAApB,oBAAoB,CAAsB;QAC1C,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,IAAI,EAAE;SACnC,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,IAAI;YAC7B,QAAQ,EAAE,IAAA,mBAAU,GAAE;YACtB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO;YAClC,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,oBAAoB,CAAC,MAAM,CAAC;YACrC,EAAE,EAAE,MAAM,CAAC,MAAM;YACjB,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE;YAC/B,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI;YAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA7CY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAG8B,6CAAoB;QAC1B,qBAAc;QACX,2BAAiB;QACxB,uBAAU;GAL9B,iBAAiB,CA6C7B"}
+{"version":3,"file":"google-user.service.js","sourceRoot":"","sources":["../../../../src/foundations/google-user/services/google-user.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,mCAAoC;AACpC,2CAAwC;AACxC,4CAAyC;AACzC,2CAAkD;AAClD,qCAA4C;AAC5C,mFAA8E;AAIvE,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,YACmB,oBAA0C,EAC1C,cAA8B,EAC9B,iBAAoC,EACpC,UAAsB;QAHtB,yBAAoB,GAApB,oBAAoB,CAAsB;QAC1C,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,IAAI,EAAE;SACnC,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,IAAI;YAC7B,QAAQ,EAAE,IAAA,mBAAU,GAAE;YACtB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO;YAClC,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,oBAAoB,CAAC,MAAM,CAAC;YACrC,EAAE,EAAE,MAAM,CAAC,MAAM;YACjB,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE;YAC/B,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI;YAC7B,IAAI,EAAE,MAAM,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA7CY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;qCAG8B,6CAAoB;QAC1B,qBAAc;QACX,2BAAiB;QACxB,uBAAU;GAL9B,iBAAiB,CA6C7B"}