@carlonicora/nestjs-neo4jsonapi 4.14.0 → 4.15.0

package/dist/foundations/analytics/services/analytics.admin.service.js

@@ -0,0 +1,126 @@
+"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.AnalyticsAdminService = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const jsonapi_paginator_1 = require("../../../core/jsonapi/serialisers/jsonapi.paginator");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const analytics_breakdown_1 = require("../entities/analytics-breakdown");
+const analytics_page_view_1 = require("../entities/analytics-page-view");
+const analytics_session_1 = require("../entities/analytics-session");
+const analytics_summary_1 = require("../entities/analytics-summary");
+const analytics_timeline_1 = require("../entities/analytics-timeline");
+const analytics_config_interface_1 = require("../interfaces/analytics.config.interface");
+const analytics_page_view_repository_1 = require("../repositories/analytics-page-view.repository");
+const analytics_session_repository_1 = require("../repositories/analytics-session.repository");
+const analytics_admin_repository_1 = require("../repositories/analytics.admin.repository");
+/**
+ * Serialises the platform-wide web analytics reports as JSON:API documents.
+ *
+ * Extends AbstractService over the AnalyticsSession descriptor and its
+ * repository, mirroring TokenUsageAdminService: the inherited CRUD is not
+ * reachable from any route on AnalyticsAdminController, but keeps the base
+ * class coherent. Summary, timeline and breakdown serialise with the
+ * AGGREGATE descriptors' models, because their rows are rollups, not nodes.
+ *
+ * JSON:API documents are built exclusively by the framework — nothing here
+ * hand-assembles a { data: { type, attributes } } object.
+ */
+let AnalyticsAdminService = class AnalyticsAdminService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, analyticsSessionRepository, clsService, analyticsAdminRepository, analyticsPageViewRepository, config) {
+        super(jsonApiService, analyticsSessionRepository, clsService, analytics_session_1.AnalyticsSessionDescriptor.model);
+        this.analyticsSessionRepository = analyticsSessionRepository;
+        this.analyticsAdminRepository = analyticsAdminRepository;
+        this.analyticsPageViewRepository = analyticsPageViewRepository;
+        this.config = config;
+        this.descriptor = analytics_session_1.AnalyticsSessionDescriptor;
+    }
+    async getSummary(params) {
+        const rows = await this.analyticsAdminRepository.findSummary({
+            from: params.from,
+            to: params.to,
+            section: params.section,
+            retentionCutoff: this.retentionCutoff(),
+        });
+        return this.jsonApiService.buildList(analytics_summary_1.AnalyticsSummaryDescriptor.model, rows);
+    }
+    async getTimeline(params) {
+        const rows = await this.analyticsAdminRepository.findTimeline({
+            from: params.from,
+            to: params.to,
+            section: params.section,
+            granularity: params.granularity,
+            retentionCutoff: this.retentionCutoff(),
+        });
+        return this.jsonApiService.buildList(analytics_timeline_1.AnalyticsTimelineDescriptor.model, rows);
+    }
+    async getBreakdown(params) {
+        const rows = await this.analyticsAdminRepository.findBreakdown({
+            from: params.from,
+            to: params.to,
+            section: params.section,
+            dimension: params.dimension,
+            limit: params.limit,
+            retentionCutoff: this.retentionCutoff(),
+        });
+        return this.jsonApiService.buildList(analytics_breakdown_1.AnalyticsBreakdownDescriptor.model, rows);
+    }
+    async getSessions(params) {
+        const paginator = new jsonapi_paginator_1.JsonApiPaginator(params.query);
+        const rows = await this.analyticsSessionRepository.findForAdmin({
+            cursor: paginator.generateCursor(),
+            from: params.from,
+            to: params.to,
+            section: params.section,
+            visitorId: params.visitorId,
+            userId: params.userId,
+        });
+        return this.jsonApiService.buildList(analytics_session_1.AnalyticsSessionDescriptor.model, rows, paginator);
+    }
+    async getSessionPageViews(params) {
+        // Throws NotFoundException for an unknown session, so a missing session is
+        // a 404 rather than an empty list.
+        await this.analyticsSessionRepository.findById({ id: params.sessionId });
+        const rows = await this.analyticsPageViewRepository.findBySession({ sessionId: params.sessionId });
+        return this.jsonApiService.buildList(analytics_page_view_1.AnalyticsPageViewDescriptor.model, rows);
+    }
+    /**
+     * ISO date (YYYY-MM-DD, UTC) `retentionMonths` before today. Raw events older
+     * than this are gone (rolled up into daily summaries), so it is the boundary
+     * between the two sources the aggregate queries read. Shared with the cron.
+     * The day is clamped to the target month's length (31 March − 1 month → 28/29 February).
+     */
+    retentionCutoff() {
+        const today = new Date();
+        const totalMonths = today.getUTCFullYear() * 12 + today.getUTCMonth() - this.config.retentionMonths;
+        const year = Math.floor(totalMonths / 12);
+        const month = totalMonths - year * 12;
+        const lastDayOfMonth = new Date(Date.UTC(year, month + 1, 0)).getUTCDate();
+        const day = Math.min(today.getUTCDate(), lastDayOfMonth);
+        return new Date(Date.UTC(year, month, day)).toISOString().slice(0, 10);
+    }
+};
+exports.AnalyticsAdminService = AnalyticsAdminService;
+exports.AnalyticsAdminService = AnalyticsAdminService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(5, (0, common_1.Inject)(analytics_config_interface_1.ANALYTICS_CONFIG)),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        analytics_session_repository_1.AnalyticsSessionRepository,
+        nestjs_cls_1.ClsService,
+        analytics_admin_repository_1.AnalyticsAdminRepository,
+        analytics_page_view_repository_1.AnalyticsPageViewRepository, Object])
+], AnalyticsAdminService);
+//# sourceMappingURL=analytics.admin.service.js.map

package/dist/foundations/analytics/services/analytics.admin.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.admin.service.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/services/analytics.admin.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AACpD,2CAAwC;AACxC,oFAAgF;AAChF,2FAAuF;AACvF,qFAAiF;AACjF,yEAA+E;AAC/E,yEAA8E;AAC9E,qEAA6F;AAC7F,qEAA2E;AAC3E,uEAA6E;AAC7E,yFAAmG;AACnG,mGAA6F;AAC7F,+FAA0F;AAC1F,2FAAuH;AAEvH;;;;;;;;;;;GAWG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,kCAG1C;IAGC,YACE,cAA8B,EACX,0BAAsD,EACzE,UAAsB,EACH,wBAAkD,EAClD,2BAAwD,EACjD,MAAwD;QAElF,KAAK,CAAC,cAAc,EAAE,0BAA0B,EAAE,UAAU,EAAE,8CAA0B,CAAC,KAAK,CAAC,CAAC;QAN7E,+BAA0B,GAA1B,0BAA0B,CAA4B;QAEtD,6BAAwB,GAAxB,wBAAwB,CAA0B;QAClD,gCAA2B,GAA3B,2BAA2B,CAA6B;QAChC,WAAM,GAAN,MAAM,CAAiC;QARjE,eAAU,GAAG,8CAA0B,CAAC;IAW3D,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAsD;QACrE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC;YAC3D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;SACxC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,8CAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAgF;QAChG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC;YAC5D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;SACxC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,gDAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAMlB;QACC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,aAAa,CAAC;YAC7D,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;SACxC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,kDAA4B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAOjB;QACC,MAAM,SAAS,GAAG,IAAI,oCAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,YAAY,CAAC;YAC9D,MAAM,EAAE,SAAS,CAAC,cAAc,EAAE;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,8CAA0B,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1F,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAA6B;QACrD,2EAA2E;QAC3E,mCAAmC;QACnC,MAAM,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAEzE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,2BAA2B,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAEnG,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,iDAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChF,CAAC;IAED;;;;;OAKG;IACH,eAAe;QACb,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;QACpG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QACtC,MAAM,cAAc,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,cAAc,CAAC,CAAC;QAEzD,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;CACF,CAAA;AA3GY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAaR,WAAA,IAAA,eAAM,EAAC,6CAAgB,CAAC,CAAA;qCALT,gCAAc;QACiB,yDAA0B;QAC7D,uBAAU;QACuB,qDAAwB;QACrB,4DAA2B;GAXlE,qBAAqB,CA2GjC"}

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

@@ -0,0 +1,31 @@
+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 { AnalyticsSession, AnalyticsSessionDescriptor } from "../entities/analytics-session";
+import { AnalyticsModuleConfig } from "../interfaces/analytics.config.interface";
+import { AnalyticsPageViewInput } from "../interfaces/analytics.page-view.input";
+import { AnalyticsSessionRepository } from "../repositories/analytics-session.repository";
+export declare class AnalyticsService extends AbstractService<AnalyticsSession, typeof AnalyticsSessionDescriptor.relationships> {
+    private readonly queue;
+    private readonly logger;
+    protected readonly descriptor: import("../../..").EntityDescriptor<AnalyticsSession, {
+        user: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+        };
+    }>;
+    private readonly jobName;
+    constructor(jsonApiService: JsonApiService, analyticsSessionRepository: AnalyticsSessionRepository, clsService: ClsService, queue: Queue, logger: AppLoggingService, config: Required<AnalyticsModuleConfig>);
+    /**
+     * Enqueue a page view for async write. Never throws — analytics must not
+     * break the caller's request path.
+     */
+    track(input: AnalyticsPageViewInput): Promise<void>;
+}
+//# sourceMappingURL=analytics.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/services/analytics.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,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAqC,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACpH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAE1F,qBACa,gBAAiB,SAAQ,eAAe,CACnD,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IAQ4B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAG/B,cAAc,EAAE,cAAc,EAC9B,0BAA0B,EAAE,0BAA0B,EACtD,UAAU,EAAE,UAAU,EACoB,KAAK,EAAE,KAAK,EACrC,MAAM,EAAE,iBAAiB,EAChB,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC;IAMnE;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;CAO1D"}

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

@@ -0,0 +1,57 @@
+"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.AnalyticsService = 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 analytics_session_1 = require("../entities/analytics-session");
+const analytics_config_interface_1 = require("../interfaces/analytics.config.interface");
+const analytics_session_repository_1 = require("../repositories/analytics-session.repository");
+let AnalyticsService = class AnalyticsService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, analyticsSessionRepository, clsService, queue, logger, config) {
+        super(jsonApiService, analyticsSessionRepository, clsService, analytics_session_1.AnalyticsSessionDescriptor.model);
+        this.queue = queue;
+        this.logger = logger;
+        this.descriptor = analytics_session_1.AnalyticsSessionDescriptor;
+        this.jobName = config.jobName;
+    }
+    /**
+     * Enqueue a page view for async write. Never throws — analytics must not
+     * break the caller's request path.
+     */
+    async track(input) {
+        try {
+            await this.queue.add(this.jobName, input);
+        }
+        catch (err) {
+            this.logger.error(`AnalyticsService.track enqueue failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+};
+exports.AnalyticsService = AnalyticsService;
+exports.AnalyticsService = AnalyticsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(3, (0, common_1.Inject)(analytics_config_interface_1.ANALYTICS_QUEUE)),
+    __param(5, (0, common_1.Inject)(analytics_config_interface_1.ANALYTICS_CONFIG)),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        analytics_session_repository_1.AnalyticsSessionRepository,
+        nestjs_cls_1.ClsService,
+        bullmq_1.Queue,
+        logging_service_1.AppLoggingService, Object])
+], AnalyticsService);
+//# sourceMappingURL=analytics.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.service.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/services/analytics.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AACpD,mCAA+B;AAC/B,2CAAwC;AACxC,oFAAgF;AAChF,oFAAmF;AACnF,qFAAiF;AACjF,qEAA6F;AAC7F,yFAAoH;AAEpH,+FAA0F;AAGnF,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,kCAGrC;IAIC,YACE,cAA8B,EAC9B,0BAAsD,EACtD,UAAsB,EACG,KAA6B,EACrC,MAAyB,EAChB,MAAuC;QAEjE,KAAK,CAAC,cAAc,EAAE,0BAA0B,EAAE,UAAU,EAAE,8CAA0B,CAAC,KAAK,CAAC,CAAC;QAJtD,UAAK,GAAL,KAAK,CAAO;QACrC,WAAM,GAAN,MAAM,CAAmB;QARzB,eAAU,GAAG,8CAA0B,CAAC;QAYzD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,KAA6B;QACvC,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,CAAC,0CAA0C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClH,CAAC;IACH,CAAC;CACF,CAAA;AA9BY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;IAYR,WAAA,IAAA,eAAM,EAAC,4CAAe,CAAC,CAAA;IAEvB,WAAA,IAAA,eAAM,EAAC,6CAAgB,CAAC,CAAA;qCALT,gCAAc;QACF,yDAA0B;QAC1C,uBAAU;QAC2B,cAAK;QAC7B,mCAAiB;GAZjC,gBAAgB,CA8B5B"}

package/dist/foundations/analytics/services/analytics.visitor-id.service.d.ts

@@ -0,0 +1,34 @@
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { RedisClientStorageService } from "../../../core/redis/services/redis.client.storage.service";
+export declare const DAILY_HASH_PREFIX = "d:";
+export declare const COOKIE_ID_PREFIX = "c:";
+/**
+ * Resolves the visitor id an analytics event is attributed to.
+ *
+ * With consent the browser sends the `analytics_visitor` cookie id, used as
+ * `c:<uuid>`. Without consent the id is `d:` + sha256(daily salt + IP + user
+ * agent). The salt lives in Redis for 48 hours with set-if-absent semantics, so
+ * every worker shares one salt per day and no salt outlives its usefulness.
+ * IP and user agent are only hashed or classified here; they are never returned
+ * and never stored.
+ */
+export declare class AnalyticsVisitorIdService {
+    private readonly redis;
+    private readonly logger;
+    private readonly localSalts;
+    private readonly warnedDays;
+    constructor(redis: RedisClientStorageService, logger: AppLoggingService);
+    isBot(userAgent: string): boolean;
+    deviceType(userAgent: string): "desktop" | "mobile" | "tablet";
+    resolve(input: {
+        visitorId?: string;
+        clientIp: string;
+        userAgent: string;
+        receivedAt: string;
+    }): Promise<{
+        visitorId: string;
+        consented: boolean;
+    }>;
+    dailySalt(day: string): Promise<string>;
+}
+//# sourceMappingURL=analytics.visitor-id.service.d.ts.map

package/dist/foundations/analytics/services/analytics.visitor-id.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.visitor-id.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/services/analytics.visitor-id.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAEtG,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAWrC;;;;;;;;;GASG;AACH,qBACa,yBAAyB;IAKlC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAG7B,KAAK,EAAE,yBAAyB,EAChC,MAAM,EAAE,iBAAiB;IAG5C,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIjC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ;IAOxD,OAAO,CAAC,KAAK,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAWhD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA0B9C"}

package/dist/foundations/analytics/services/analytics.visitor-id.service.js

@@ -0,0 +1,93 @@
+"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 AnalyticsVisitorIdService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsVisitorIdService = exports.COOKIE_ID_PREFIX = exports.DAILY_HASH_PREFIX = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const redis_client_storage_service_1 = require("../../../core/redis/services/redis.client.storage.service");
+exports.DAILY_HASH_PREFIX = "d:";
+exports.COOKIE_ID_PREFIX = "c:";
+/** 48 hours: long enough to cover a day in any worker, too short to re-derive yesterday's ids later. */
+const SALT_TTL_SECONDS = 172800;
+const SALT_KEY_PREFIX = "analytics:salt:";
+const BOT_PATTERN = /bot|crawler|spider|curl|wget|python-requests|headlesschrome|facebookexternalhit|slackbot|twitterbot|linkedinbot|ahrefs|semrush|bingpreview/i;
+const TABLET_PATTERN = /ipad|tablet|kindle|silk/i;
+const MOBILE_PATTERN = /mobi|iphone|android.*mobile|windows phone/i;
+/**
+ * Resolves the visitor id an analytics event is attributed to.
+ *
+ * With consent the browser sends the `analytics_visitor` cookie id, used as
+ * `c:<uuid>`. Without consent the id is `d:` + sha256(daily salt + IP + user
+ * agent). The salt lives in Redis for 48 hours with set-if-absent semantics, so
+ * every worker shares one salt per day and no salt outlives its usefulness.
+ * IP and user agent are only hashed or classified here; they are never returned
+ * and never stored.
+ */
+let AnalyticsVisitorIdService = AnalyticsVisitorIdService_1 = class AnalyticsVisitorIdService {
+    constructor(redis, logger) {
+        this.redis = redis;
+        this.logger = logger;
+        this.localSalts = new Map();
+        this.warnedDays = new Set();
+    }
+    isBot(userAgent) {
+        return BOT_PATTERN.test(userAgent ?? "");
+    }
+    deviceType(userAgent) {
+        const ua = userAgent ?? "";
+        if (TABLET_PATTERN.test(ua))
+            return "tablet";
+        if (MOBILE_PATTERN.test(ua))
+            return "mobile";
+        return "desktop";
+    }
+    async resolve(input) {
+        if (input.visitorId)
+            return { visitorId: `${exports.COOKIE_ID_PREFIX}${input.visitorId}`, consented: true };
+        const salt = await this.dailySalt(input.receivedAt.slice(0, 10));
+        const hash = (0, crypto_1.createHash)("sha256")
+            .update(salt + input.clientIp + input.userAgent)
+            .digest("hex");
+        return { visitorId: `${exports.DAILY_HASH_PREFIX}${hash}`, consented: false };
+    }
+    async dailySalt(day) {
+        const key = `${SALT_KEY_PREFIX}${day}`;
+        try {
+            const client = this.redis.getRedisClient();
+            await client.set(key, (0, crypto_1.randomBytes)(32).toString("hex"), "EX", SALT_TTL_SECONDS, "NX");
+            const salt = await client.get(key);
+            if (!salt)
+                throw new Error(`salt ${key} missing after SET NX`);
+            return salt;
+        }
+        catch (error) {
+            if (!this.warnedDays.has(day)) {
+                this.warnedDays.add(day);
+                this.logger.warn(`Redis unavailable for ${key}, using a process-local salt: ${error?.message ?? error}`, AnalyticsVisitorIdService_1.name);
+            }
+            let salt = this.localSalts.get(day);
+            if (!salt) {
+                salt = (0, crypto_1.randomBytes)(32).toString("hex");
+                this.localSalts.set(day, salt);
+            }
+            return salt;
+        }
+    }
+};
+exports.AnalyticsVisitorIdService = AnalyticsVisitorIdService;
+exports.AnalyticsVisitorIdService = AnalyticsVisitorIdService = AnalyticsVisitorIdService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [redis_client_storage_service_1.RedisClientStorageService,
+        logging_service_1.AppLoggingService])
+], AnalyticsVisitorIdService);
+//# sourceMappingURL=analytics.visitor-id.service.js.map

package/dist/foundations/analytics/services/analytics.visitor-id.service.js.map

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

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

@@ -1,4 +1,5 @@
 import { DynamicModule, Type } from "@nestjs/common";
+import { AnalyticsModuleConfig } from "./analytics/interfaces/analytics.config.interface";
 import { ContentExtensionConfig } from "./content/interfaces/content.extension.interface";
 import { ReferralModuleConfig } from "./referral/interfaces/referral.config.interface";
 import { HandbookModuleConfig } from "./handbook/interfaces/handbook.config.interface";
@@ -18,6 +19,8 @@ export interface FoundationsModuleConfig {
     handbook?: HandbookModuleConfig;
     /** Optional configuration for the how-to feature module (opt-in public routes) */
     howTo?: HowToModuleConfig;
+    /** Optional override for the analytics feature module (normally switched on by `ANALYTICS_ENABLED=true`) */
+    analytics?: AnalyticsModuleConfig;
     /**
      * Foundation module classes to exclude from registration.
      * Default [] keeps all modules registered (neural-erp behavior unchanged).

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;AAU7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAIvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAwBhF,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,gEAAgE;IAChE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,kFAAkF;IAClF,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AAwDD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CAsBhE"}
+{"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;AAG7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAS1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAIvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAwBhF,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,gEAAgE;IAChE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,kFAAkF;IAClF,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,4GAA4G;IAC5G,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AAwDD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CAuBhE"}

package/dist/foundations/foundations.modules.js

@@ -10,6 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FoundationsModule = void 0;
 const common_1 = require("@nestjs/common");
 const ai_connection_module_1 = require("./ai-connection/ai-connection.module");
+const analytics_module_1 = require("./analytics/analytics.module");
 const assistant_module_1 = require("./assistant/assistant.module");
 const atomicfact_module_1 = require("./atomicfact/atomicfact.module");
 const audit_module_1 = require("./audit/audit.module");
@@ -49,7 +50,7 @@ const user_activity_module_1 = require("./user-activity/user-activity.module");
 const waitlist_module_1 = require("./waitlist/waitlist.module");
 /**
  * All static foundation modules. The dynamic ones (ContentModule,
- * UserActivityModule, ReferralModule, HandbookModule, HowToModule) are
+ * UserActivityModule, ReferralModule, HandbookModule, HowToModule, AnalyticsModule) are
  * assembled inside forRoot().
  *
  * HowToModule is dynamic solely so an app can reach
@@ -147,6 +148,7 @@ let FoundationsModule = FoundationsModule_1 = class FoundationsModule {
             { classRef: referral_module_1.ReferralModule, factory: () => referral_module_1.ReferralModule.forRoot(config?.referral) },
             { classRef: handbook_module_1.HandbookModule, factory: () => handbook_module_1.HandbookModule.forRoot(config?.handbook) },
             { classRef: how_to_module_1.HowToModule, factory: () => how_to_module_1.HowToModule.forRoot(config?.howTo) },
+            { classRef: analytics_module_1.AnalyticsModule, factory: () => analytics_module_1.AnalyticsModule.forRoot(config?.analytics) },
         ].filter((entry) => !excluded.has(entry.classRef));
         return {
             module: FoundationsModule_1,

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

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

package/dist/foundations/index.d.ts

@@ -35,6 +35,7 @@ export * from "./tokenusage";
 export * from "./two-factor";
 export * from "./user";
 export * from "./user-activity";
+export * from "./analytics";
 export * from "./waitlist";
 export * from "./rbac";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/foundations/index.js

@@ -53,6 +53,7 @@ __exportStar(require("./tokenusage"), exports);
 __exportStar(require("./two-factor"), exports);
 __exportStar(require("./user"), exports);
 __exportStar(require("./user-activity"), exports);
+__exportStar(require("./analytics"), exports);
 __exportStar(require("./waitlist"), exports);
 __exportStar(require("./rbac"), exports);
 //# sourceMappingURL=index.js.map

package/dist/foundations/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nestjs-neo4jsonapi",
-  "version": "4.14.0",
+  "version": "4.15.0",
   "description": "NestJS foundation package with JSON:API, Neo4j, Redis, LangChain agents, and common utilities",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",