@carlonicora/nestjs-neo4jsonapi 1.115.1 → 1.116.0

package/dist/foundations/user-activity/interfaces/user-activity.config.interface.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Configuration interface for the UserActivityModule.
+ *
+ * Every option is optional and defaults to the inert/library-safe value, so
+ * `UserActivityModule.forRoot()` with no arguments changes nothing about a
+ * consuming app's HTTP surface: no global interceptor is registered and no
+ * activity is recorded unless the app calls `UserActivityService.record()`
+ * itself.
+ */
+export interface UserActivityModuleConfig {
+    /**
+     * BullMQ queue the producer (`UserActivityService.record()`) enqueues onto.
+     *
+     * The module registers this queue itself (`BullModule.registerQueue`), so an
+     * app does not have to add it to its own queue configuration.
+     *
+     * NOTE: the worker side (`UserActivityProcessor`) binds to `QueueId.USER_ACTIVITY`
+     * through the `@Processor()` decorator, which BullMQ evaluates at class-decoration
+     * time and therefore cannot read from this config. Overriding `queueId` with a
+     * different value moves the producer only — the consuming app must then run its
+     * own worker for that queue. Every package processor has the same constraint
+     * (see `CompanyProcessor`, `HowToProcessor`, `ChunkProcessor`).
+     *
+     * @default QueueId.USER_ACTIVITY ("user-activity")
+     */
+    queueId?: string;
+    /**
+     * BullMQ job name used for the enqueue/dispatch handshake between
+     * `UserActivityService.record()` and `UserActivityProcessor.process()`.
+     *
+     * Both sides read this same value, so an app may rename it freely (e.g. to
+     * match its own `JobName` enum) as long as it is configured once here.
+     *
+     * @default "userActivity:record"
+     */
+    jobName?: string;
+    /**
+     * When true, the module registers a global `APP_INTERCEPTOR`
+     * (`UserActivityInterceptor`) that records a coarse-grained
+     * `ENTITY`/`CREATE|UPDATE|DELETE` activity for every authenticated
+     * non-GET, non-OPTIONS request outside the health/metrics/auth paths.
+     *
+     * Default false: the interceptor is a cross-cutting, app-visible behaviour
+     * change and must be opted into explicitly.
+     *
+     * @default false
+     */
+    interceptorEnabled?: boolean;
+}
+/**
+ * Injection token for the resolved user-activity configuration.
+ * Always resolves to a `Required<UserActivityModuleConfig>` (defaults merged in).
+ */
+export declare const USER_ACTIVITY_CONFIG: unique symbol;
+/**
+ * Injection token for the BullMQ queue the module was configured with.
+ *
+ * `@InjectQueue()` cannot be used directly because the queue name is only known
+ * at `forRoot()` time; the module aliases the configured BullMQ queue token onto
+ * this stable token instead.
+ */
+export declare const USER_ACTIVITY_QUEUE: unique symbol;
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_USER_ACTIVITY_CONFIG: Required<UserActivityModuleConfig>;
+//# sourceMappingURL=user-activity.config.interface.d.ts.map

package/dist/foundations/user-activity/interfaces/user-activity.config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.config.interface.d.ts","sourceRoot":"","sources":["../../../../src/foundations/user-activity/interfaces/user-activity.config.interface.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,wBAAwB,CAI3E,CAAC"}

package/dist/foundations/user-activity/interfaces/user-activity.config.interface.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_USER_ACTIVITY_CONFIG = exports.USER_ACTIVITY_QUEUE = exports.USER_ACTIVITY_CONFIG = void 0;
+const queue_id_1 = require("../../../config/enums/queue.id");
+/**
+ * Injection token for the resolved user-activity configuration.
+ * Always resolves to a `Required<UserActivityModuleConfig>` (defaults merged in).
+ */
+exports.USER_ACTIVITY_CONFIG = Symbol("USER_ACTIVITY_CONFIG");
+/**
+ * Injection token for the BullMQ queue the module was configured with.
+ *
+ * `@InjectQueue()` cannot be used directly because the queue name is only known
+ * at `forRoot()` time; the module aliases the configured BullMQ queue token onto
+ * this stable token instead.
+ */
+exports.USER_ACTIVITY_QUEUE = Symbol("USER_ACTIVITY_QUEUE");
+/**
+ * Default configuration values.
+ */
+exports.DEFAULT_USER_ACTIVITY_CONFIG = {
+    queueId: queue_id_1.QueueId.USER_ACTIVITY,
+    jobName: "userActivity:record",
+    interceptorEnabled: false,
+};
+//# sourceMappingURL=user-activity.config.interface.js.map

package/dist/foundations/user-activity/interfaces/user-activity.config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.config.interface.js","sourceRoot":"","sources":["../../../../src/foundations/user-activity/interfaces/user-activity.config.interface.ts"],"names":[],"mappings":";;;AAAA,6DAAyD;AAsDzD;;;GAGG;AACU,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEnE;;;;;;GAMG;AACU,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE;;GAEG;AACU,QAAA,4BAA4B,GAAuC;IAC9E,OAAO,EAAE,kBAAO,CAAC,aAAa;IAC9B,OAAO,EAAE,qBAAqB;IAC9B,kBAAkB,EAAE,KAAK;CAC1B,CAAC"}

package/dist/foundations/user-activity/interfaces/user-activity.record.input.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Input accepted by `UserActivityService.record()` / `UserActivityRepository.createActivity()`.
+ *
+ * `category` and `action` are open strings on purpose: the library does not own
+ * the taxonomy. Consuming apps keep their own enums (e.g. `UserActivityCategory`
+ * / `UserActivityAction`) and pass their members straight through — every string
+ * enum member is assignable to `string`.
+ */
+export interface UserActivityRecordInput {
+    userId: string;
+    companyId: string;
+    category: string;
+    action: string;
+    entityType?: string;
+    entityId?: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=user-activity.record.input.d.ts.map

package/dist/foundations/user-activity/interfaces/user-activity.record.input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.record.input.d.ts","sourceRoot":"","sources":["../../../../src/foundations/user-activity/interfaces/user-activity.record.input.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/foundations/{auth/entities/auth.entity.js → user-activity/interfaces/user-activity.record.input.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=auth.entity.js.map
+//# sourceMappingURL=user-activity.record.input.js.map

package/dist/foundations/user-activity/interfaces/user-activity.record.input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.record.input.js","sourceRoot":"","sources":["../../../../src/foundations/user-activity/interfaces/user-activity.record.input.ts"],"names":[],"mappings":""}

package/dist/foundations/user-activity/processors/user-activity.processor.d.ts

@@ -0,0 +1,25 @@
+import { WorkerHost } from "@nestjs/bullmq";
+import { Job } from "bullmq";
+import { ClsService } from "nestjs-cls";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { UserActivityModuleConfig } from "../interfaces/user-activity.config.interface";
+import { UserActivityRepository } from "../repositories/user-activity.repository";
+/**
+ * Worker-side of `UserActivityService.record()`.
+ *
+ * The queue name must be a compile-time constant because `@Processor()` is
+ * evaluated at class-decoration time — the same constraint every other package
+ * processor lives with (CompanyProcessor, HowToProcessor, ChunkProcessor). The
+ * job name, by contrast, is read from `USER_ACTIVITY_CONFIG` at construction
+ * time, so producer and consumer always agree on it.
+ */
+export declare class UserActivityProcessor extends WorkerHost {
+    private readonly logger;
+    private readonly repository;
+    private readonly cls;
+    private readonly jobName;
+    constructor(logger: AppLoggingService, repository: UserActivityRepository, cls: ClsService, config: Required<UserActivityModuleConfig>);
+    onError(job: Job): void;
+    process(job: Job): Promise<void>;
+}
+//# sourceMappingURL=user-activity.processor.d.ts.map

package/dist/foundations/user-activity/processors/user-activity.processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.processor.d.ts","sourceRoot":"","sources":["../../../../src/foundations/user-activity/processors/user-activity.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAwB,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAE9G,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF;;;;;;;;GAQG;AACH,qBACa,qBAAsB,SAAQ,UAAU;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IALtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAGd,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,sBAAsB,EAClC,GAAG,EAAE,UAAU,EACF,MAAM,EAAE,QAAQ,CAAC,wBAAwB,CAAC;IAO1E,OAAO,CAAC,GAAG,EAAE,GAAG;IAIV,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBvC"}

package/dist/foundations/user-activity/processors/user-activity.processor.js

@@ -0,0 +1,74 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivityProcessor = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
+const bullmq_2 = require("bullmq");
+const nestjs_cls_1 = require("nestjs-cls");
+const queue_id_1 = require("../../../config/enums/queue.id");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const user_activity_config_interface_1 = require("../interfaces/user-activity.config.interface");
+const user_activity_repository_1 = require("../repositories/user-activity.repository");
+/**
+ * Worker-side of `UserActivityService.record()`.
+ *
+ * The queue name must be a compile-time constant because `@Processor()` is
+ * evaluated at class-decoration time — the same constraint every other package
+ * processor lives with (CompanyProcessor, HowToProcessor, ChunkProcessor). The
+ * job name, by contrast, is read from `USER_ACTIVITY_CONFIG` at construction
+ * time, so producer and consumer always agree on it.
+ */
+let UserActivityProcessor = class UserActivityProcessor extends bullmq_1.WorkerHost {
+    constructor(logger, repository, cls, config) {
+        super();
+        this.logger = logger;
+        this.repository = repository;
+        this.cls = cls;
+        this.jobName = config.jobName;
+    }
+    onError(job) {
+        this.logger.error(`UserActivity record failed (jobId=${job.id}): ${job.failedReason ?? "unknown"}`);
+    }
+    async process(job) {
+        if (job.name !== this.jobName) {
+            throw new Error(`Job ${job.name} not handled by UserActivityProcessor`);
+        }
+        const input = job.data;
+        // The worker runs outside any HTTP request, so CLS is empty: seed it
+        // explicitly (isAutomatedJob + userId + companyId) or SecurityService
+        // .userHasAccess() has no context to work from.
+        await this.cls.run(async () => {
+            this.cls.set("isAutomatedJob", true);
+            this.cls.set("userId", input.userId);
+            this.cls.set("companyId", input.companyId);
+            await this.repository.createActivity(input);
+        });
+    }
+};
+exports.UserActivityProcessor = UserActivityProcessor;
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("failed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], UserActivityProcessor.prototype, "onError", null);
+exports.UserActivityProcessor = UserActivityProcessor = __decorate([
+    (0, bullmq_1.Processor)(queue_id_1.QueueId.USER_ACTIVITY, { concurrency: 4 }),
+    __param(3, (0, common_1.Inject)(user_activity_config_interface_1.USER_ACTIVITY_CONFIG)),
+    __metadata("design:paramtypes", [logging_service_1.AppLoggingService,
+        user_activity_repository_1.UserActivityRepository,
+        nestjs_cls_1.ClsService, Object])
+], UserActivityProcessor);
+//# sourceMappingURL=user-activity.processor.js.map

package/dist/foundations/user-activity/processors/user-activity.processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.processor.js","sourceRoot":"","sources":["../../../../src/foundations/user-activity/processors/user-activity.processor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAsE;AACtE,2CAAwC;AACxC,mCAA6B;AAC7B,2CAAwC;AACxC,6DAAyD;AACzD,oFAAmF;AACnF,iGAA8G;AAE9G,uFAAkF;AAElF;;;;;;;;GAQG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,mBAAU;IAGnD,YACmB,MAAyB,EACzB,UAAkC,EAClC,GAAe,EACF,MAA0C;QAExE,KAAK,EAAE,CAAC;QALS,WAAM,GAAN,MAAM,CAAmB;QACzB,eAAU,GAAV,UAAU,CAAwB;QAClC,QAAG,GAAH,GAAG,CAAY;QAIhC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAGD,OAAO,CAAC,GAAQ;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;IACtG,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAQ;QACpB,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,uCAAuC,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,IAA+B,CAAC;QAElD,qEAAqE;QACrE,sEAAsE;QACtE,gDAAgD;QAChD,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAnCY,sDAAqB;AAchC;IADC,IAAA,sBAAa,EAAC,QAAQ,CAAC;;qCACX,YAAG;;oDAEf;gCAhBU,qBAAqB;IADjC,IAAA,kBAAS,EAAC,kBAAO,CAAC,aAAa,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAQhD,WAAA,IAAA,eAAM,EAAC,qDAAoB,CAAC,CAAA;qCAHJ,mCAAiB;QACb,iDAAsB;QAC7B,uBAAU;GANvB,qBAAqB,CAmCjC"}

package/dist/foundations/user-activity/repositories/user-activity.repository.d.ts

@@ -0,0 +1,47 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { UserActivity, UserActivityDescriptor } from "../entities/user-activity";
+import { UserActivityRecordInput } from "../interfaces/user-activity.record.input";
+export declare class UserActivityRepository extends AbstractRepository<UserActivity, typeof UserActivityDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<UserActivity, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Adds the activity-log-specific indexes (recent-activity scan by
+     * createdAt, category+action lookups) on top of the id constraint that
+     * AbstractRepository already creates from the descriptor. There is no
+     * declarative way to express a plain (non-FULLTEXT) composite index via
+     * defineEntity(), so these stay as an explicit override — mirrors the
+     * canonical pattern for repositories that need a bespoke index
+     * (e.g. a vector index) alongside the descriptor-derived constraints.
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * Records are written from the async BullMQ worker (see
+     * UserActivityProcessor), outside HTTP/CLS request context, so this stays a
+     * fully custom Cypher write (explicit userId/companyId params, explicit
+     * MATCH on both Company and User) rather than the inherited
+     * descriptor-driven create(), which expects CLS-derived company scoping.
+     * The explicit `(userActivity)-[:BELONGS_TO]->(company)` edge below is the
+     * deliberate, documented exception to buildDefaultMatch()-driven company
+     * scoping: there is no CLS company to derive at write time.
+     * Not renamed: the params shape is domain-specific (UserActivityRecordInput,
+     * not the generic `{id, [key: string]: any}`), which is allowed to coexist
+     * under the base class's bivariant method-parameter checking.
+     */
+    createActivity(input: UserActivityRecordInput): Promise<void>;
+    /**
+     * Fully custom traversal (by PERFORMED edge + date range), not expressible
+     * via the inherited findByRelated() because `user` is intentionally not a
+     * descriptor relationship (see entities/user-activity.ts) and the date
+     * filtering is bespoke.
+     */
+    findByUser(params: {
+        userId: string;
+        from?: Date;
+        to?: Date;
+        limit?: number;
+    }): Promise<UserActivity[]>;
+}
+//# sourceMappingURL=user-activity.repository.d.ts.map

package/dist/foundations/user-activity/repositories/user-activity.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/user-activity/repositories/user-activity.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAGnF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAEnF,qBACa,sBAAuB,SAAQ,kBAAkB,CAC5D,YAAY,EACZ,OAAO,sBAAsB,CAAC,aAAa,CAC5C;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU,wDAA0B;gBAE3C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;;;;;OAQG;IACY,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5C;;;;;;;;;;;;OAYG;IACG,cAAc,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCnE;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,EAAE,CAAC,EAAE,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAsB9G"}

package/dist/foundations/user-activity/repositories/user-activity.repository.js

@@ -0,0 +1,124 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivityRepository = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const nestjs_cls_1 = require("nestjs-cls");
+const neo4j_date_1 = require("../../../common/helpers/neo4j-date");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const company_meta_1 = require("../../company/entities/company.meta");
+const user_meta_1 = require("../../user/entities/user.meta");
+const user_activity_1 = require("../entities/user-activity");
+let UserActivityRepository = class UserActivityRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = user_activity_1.UserActivityDescriptor;
+    }
+    /**
+     * Adds the activity-log-specific indexes (recent-activity scan by
+     * createdAt, category+action lookups) on top of the id constraint that
+     * AbstractRepository already creates from the descriptor. There is no
+     * declarative way to express a plain (non-FULLTEXT) composite index via
+     * defineEntity(), so these stay as an explicit override — mirrors the
+     * canonical pattern for repositories that need a bespoke index
+     * (e.g. a vector index) alongside the descriptor-derived constraints.
+     */
+    async onModuleInit() {
+        await super.onModuleInit();
+        const { nodeName, labelName } = this.descriptor.model;
+        await this.neo4j.writeOne({
+            query: `CREATE INDEX ${nodeName}_createdAt IF NOT EXISTS FOR (${nodeName}:${labelName}) ON (${nodeName}.createdAt)`,
+        });
+        await this.neo4j.writeOne({
+            query: `CREATE INDEX ${nodeName}_category_action IF NOT EXISTS FOR (${nodeName}:${labelName}) ON (${nodeName}.category, ${nodeName}.action)`,
+        });
+    }
+    /**
+     * Records are written from the async BullMQ worker (see
+     * UserActivityProcessor), outside HTTP/CLS request context, so this stays a
+     * fully custom Cypher write (explicit userId/companyId params, explicit
+     * MATCH on both Company and User) rather than the inherited
+     * descriptor-driven create(), which expects CLS-derived company scoping.
+     * The explicit `(userActivity)-[:BELONGS_TO]->(company)` edge below is the
+     * deliberate, documented exception to buildDefaultMatch()-driven company
+     * scoping: there is no CLS company to derive at write time.
+     * Not renamed: the params shape is domain-specific (UserActivityRecordInput,
+     * not the generic `{id, [key: string]: any}`), which is allowed to coexist
+     * under the base class's bivariant method-parameter checking.
+     */
+    async createActivity(input) {
+        const { nodeName, labelName } = this.descriptor.model;
+        const query = this.neo4j.initQuery();
+        query.queryParams = {
+            ...query.queryParams,
+            id: (0, crypto_1.randomUUID)(),
+            userId: input.userId,
+            companyId: input.companyId,
+            category: input.category,
+            action: input.action,
+            entityType: input.entityType ?? null,
+            entityId: input.entityId ?? null,
+            metadata: input.metadata ? JSON.stringify(input.metadata) : null,
+        };
+        query.query = `
+      MATCH (${user_meta_1.userMeta.nodeName}:${user_meta_1.userMeta.labelName} {id: $userId})
+      MATCH (${company_meta_1.companyMeta.nodeName}Target:${company_meta_1.companyMeta.labelName} {id: $companyId})
+      CREATE (${nodeName}:${labelName} {
+        id: $id,
+        category: $category,
+        action: $action,
+        entityType: $entityType,
+        entityId: $entityId,
+        metadata: $metadata,
+        createdAt: datetime(),
+        updatedAt: datetime()
+      })
+      CREATE (${user_meta_1.userMeta.nodeName})-[:PERFORMED]->(${nodeName})
+      CREATE (${nodeName})-[:BELONGS_TO]->(${company_meta_1.companyMeta.nodeName}Target)
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    /**
+     * Fully custom traversal (by PERFORMED edge + date range), not expressible
+     * via the inherited findByRelated() because `user` is intentionally not a
+     * descriptor relationship (see entities/user-activity.ts) and the date
+     * filtering is bespoke.
+     */
+    async findByUser(params) {
+        const { nodeName, labelName } = this.descriptor.model;
+        const query = this.neo4j.initQuery({ serialiser: this.descriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            userId: params.userId,
+            from: params.from ? (0, neo4j_date_1.normalizeNeo4jTemporal)(params.from, "datetime") : null,
+            to: params.to ? (0, neo4j_date_1.normalizeNeo4jTemporal)(params.to, "datetime") : null,
+            limit: params.limit ?? 100,
+        };
+        query.query = `
+      MATCH (${user_meta_1.userMeta.nodeName}:${user_meta_1.userMeta.labelName} {id: $userId})-[:PERFORMED]->(${nodeName}:${labelName})
+      WHERE ($from IS NULL OR ${nodeName}.createdAt >= datetime($from))
+        AND ($to IS NULL OR ${nodeName}.createdAt < datetime($to))
+      RETURN ${nodeName}
+      ORDER BY ${nodeName}.createdAt DESC
+      LIMIT toInteger($limit)
+    `;
+        return this.neo4j.readMany(query);
+    }
+};
+exports.UserActivityRepository = UserActivityRepository;
+exports.UserActivityRepository = UserActivityRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], UserActivityRepository);
+//# sourceMappingURL=user-activity.repository.js.map

package/dist/foundations/user-activity/repositories/user-activity.repository.js.map

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

package/dist/foundations/user-activity/services/user-activity.service.d.ts

@@ -0,0 +1,29 @@
+import { Queue } from "bullmq";
+import { ClsService } from "nestjs-cls";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { UserActivity, UserActivityDescriptor } from "../entities/user-activity";
+import { UserActivityModuleConfig } from "../interfaces/user-activity.config.interface";
+import { UserActivityRecordInput } from "../interfaces/user-activity.record.input";
+import { UserActivityRepository } from "../repositories/user-activity.repository";
+export declare class UserActivityService extends AbstractService<UserActivity, typeof UserActivityDescriptor.relationships> {
+    private readonly userActivityRepository;
+    private readonly queue;
+    private readonly logger;
+    protected readonly descriptor: import("../../..").EntityDescriptor<UserActivity, {}>;
+    private readonly jobName;
+    constructor(jsonApiService: JsonApiService, userActivityRepository: UserActivityRepository, clsService: ClsService, queue: Queue, logger: AppLoggingService, config: Required<UserActivityModuleConfig>);
+    /**
+     * Enqueue an activity for async write. Never throws — the activity log
+     * must not break the caller's request path.
+     */
+    record(input: UserActivityRecordInput): Promise<void>;
+    findByUser(params: {
+        userId: string;
+        from?: Date;
+        to?: Date;
+        limit?: number;
+    }): Promise<UserActivity[]>;
+}
+//# sourceMappingURL=user-activity.service.d.ts.map

package/dist/foundations/user-activity/services/user-activity.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/user-activity/services/user-activity.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAGL,wBAAwB,EACzB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,qBACa,mBAAoB,SAAQ,eAAe,CAAC,YAAY,EAAE,OAAO,sBAAsB,CAAC,aAAa,CAAC;IAM/G,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAEV,OAAO,CAAC,QAAQ,CAAC,KAAK;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,SAAS,CAAC,QAAQ,CAAC,UAAU,wDAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAG/B,cAAc,EAAE,cAAc,EACb,sBAAsB,EAAE,sBAAsB,EAC/D,UAAU,EAAE,UAAU,EACwB,KAAK,EAAE,KAAK,EACzC,MAAM,EAAE,iBAAiB,EACZ,MAAM,EAAE,QAAQ,CAAC,wBAAwB,CAAC;IAM1E;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,EAAE,CAAC,EAAE,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAGpF"}

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

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActivityService = void 0;
+const common_1 = require("@nestjs/common");
+const bullmq_1 = require("bullmq");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const user_activity_1 = require("../entities/user-activity");
+const user_activity_config_interface_1 = require("../interfaces/user-activity.config.interface");
+const user_activity_repository_1 = require("../repositories/user-activity.repository");
+let UserActivityService = class UserActivityService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, userActivityRepository, clsService, queue, logger, config) {
+        super(jsonApiService, userActivityRepository, clsService, user_activity_1.UserActivityDescriptor.model);
+        this.userActivityRepository = userActivityRepository;
+        this.queue = queue;
+        this.logger = logger;
+        this.descriptor = user_activity_1.UserActivityDescriptor;
+        this.jobName = config.jobName;
+    }
+    /**
+     * Enqueue an activity for async write. Never throws — the activity log
+     * must not break the caller's request path.
+     */
+    async record(input) {
+        try {
+            await this.queue.add(this.jobName, input);
+        }
+        catch (err) {
+            this.logger.error(`UserActivityService.record enqueue failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    async findByUser(params) {
+        return this.userActivityRepository.findByUser(params);
+    }
+};
+exports.UserActivityService = UserActivityService;
+exports.UserActivityService = UserActivityService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(3, (0, common_1.Inject)(user_activity_config_interface_1.USER_ACTIVITY_QUEUE)),
+    __param(5, (0, common_1.Inject)(user_activity_config_interface_1.USER_ACTIVITY_CONFIG)),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        user_activity_repository_1.UserActivityRepository,
+        nestjs_cls_1.ClsService,
+        bullmq_1.Queue,
+        logging_service_1.AppLoggingService, Object])
+], UserActivityService);
+//# sourceMappingURL=user-activity.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.service.js","sourceRoot":"","sources":["../../../../src/foundations/user-activity/services/user-activity.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AACpD,mCAA+B;AAC/B,2CAAwC;AACxC,oFAAgF;AAChF,oFAAmF;AACnF,qFAAiF;AACjF,6DAAiF;AACjF,iGAIsD;AAEtD,uFAAkF;AAG3E,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,kCAA0E;IAIjH,YACE,cAA8B,EACb,sBAA8C,EAC/D,UAAsB,EACO,KAA6B,EACzC,MAAyB,EACZ,MAA0C;QAExE,KAAK,CAAC,cAAc,EAAE,sBAAsB,EAAE,UAAU,EAAE,sCAAsB,CAAC,KAAK,CAAC,CAAC;QANvE,2BAAsB,GAAtB,sBAAsB,CAAwB;QAEjB,UAAK,GAAL,KAAK,CAAO;QACzC,WAAM,GAAN,MAAM,CAAmB;QARzB,eAAU,GAAG,sCAAsB,CAAC;QAYrD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,KAA8B;QACzC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,8CAA8C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACjG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAkE;QACjF,OAAO,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;CACF,CAAA;AAjCY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;IASR,WAAA,IAAA,eAAM,EAAC,oDAAmB,CAAC,CAAA;IAE3B,WAAA,IAAA,eAAM,EAAC,qDAAoB,CAAC,CAAA;qCALb,gCAAc;QACW,iDAAsB;QACnD,uBAAU;QAC+B,cAAK;QACjC,mCAAiB;GATjC,mBAAmB,CAiC/B"}

package/dist/foundations/user-activity/user-activity.module.d.ts

@@ -0,0 +1,40 @@
+import { DynamicModule, OnModuleInit } from "@nestjs/common";
+import { UserActivityModuleConfig } from "./interfaces/user-activity.config.interface";
+/**
+ * UserActivityModule — append-only audit trail of user actions.
+ *
+ * Writes `(User)-[:PERFORMED]->(UserActivity)-[:BELONGS_TO]->(Company)` through a
+ * BullMQ worker, so recording never blocks (or breaks) the caller's request path.
+ * The module exposes NO HTTP routes: activities are produced by explicit
+ * `UserActivityService.record()` calls and — optionally — by a global interceptor.
+ *
+ * Defaults are deliberately inert: with `forRoot()` and no config, no
+ * APP_INTERCEPTOR is registered and nothing is recorded unless the app calls
+ * `record()` itself.
+ *
+ * The descriptor is NOT registered with the GraphDescriptorRegistry here —
+ * graph-catalog registration is an application-level policy decision.
+ *
+ * @example
+ * ```typescript
+ * // Inert (library default): producer available, no global interceptor
+ * UserActivityModule.forRoot()
+ *
+ * // Fully enabled, with app-owned queue/job identifiers
+ * UserActivityModule.forRoot({
+ *   queueId: QueueId.USER_ACTIVITY,
+ *   jobName: JobName.userActivity.Record,
+ *   interceptorEnabled: true,
+ * })
+ * ```
+ */
+export declare class UserActivityModule implements OnModuleInit {
+    /**
+     * Configure the UserActivityModule.
+     *
+     * @param config - Optional configuration merged over DEFAULT_USER_ACTIVITY_CONFIG
+     */
+    static forRoot(config?: UserActivityModuleConfig): DynamicModule;
+    onModuleInit(): void;
+}
+//# sourceMappingURL=user-activity.module.d.ts.map

package/dist/foundations/user-activity/user-activity.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-activity.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/user-activity/user-activity.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAU,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAM/E,OAAO,EAIL,wBAAwB,EACzB,MAAM,6CAA6C,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,kBAAmB,YAAW,YAAY;IACrD;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,wBAAwB,GAAG,aAAa;IAuChE,YAAY;CAGb"}