@carlonicora/nestjs-neo4jsonapi 4.14.0 → 4.16.0

package/dist/foundations/analytics/index.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ANALYTICS_CONFIG = exports.ANALYTICS_QUEUE = exports.ANALYTICS_CONFIG = exports.AnalyticsRetentionCron = exports.AnalyticsProcessor = exports.AnalyticsAdminService = exports.AnalyticsService = exports.AnalyticsVisitorIdService = exports.AnalyticsAdminRepository = exports.AnalyticsDailySummaryRepository = exports.AnalyticsPageViewRepository = exports.AnalyticsSessionRepository = exports.analyticsEventMeta = exports.analyticsBreakdownMeta = exports.AnalyticsBreakdownDescriptor = exports.analyticsTimelineMeta = exports.AnalyticsTimelineDescriptor = exports.analyticsSummaryMeta = exports.AnalyticsSummaryDescriptor = exports.analyticsDailySummaryMeta = exports.AnalyticsDailySummaryDescriptor = exports.analyticsPageViewMeta = exports.AnalyticsPageViewDescriptor = exports.analyticsSessionMeta = exports.AnalyticsSessionDescriptor = exports.AnalyticsModule = void 0;
+var analytics_module_1 = require("./analytics.module");
+Object.defineProperty(exports, "AnalyticsModule", { enumerable: true, get: function () { return analytics_module_1.AnalyticsModule; } });
+var analytics_session_1 = require("./entities/analytics-session");
+Object.defineProperty(exports, "AnalyticsSessionDescriptor", { enumerable: true, get: function () { return analytics_session_1.AnalyticsSessionDescriptor; } });
+var analytics_session_meta_1 = require("./entities/analytics-session.meta");
+Object.defineProperty(exports, "analyticsSessionMeta", { enumerable: true, get: function () { return analytics_session_meta_1.analyticsSessionMeta; } });
+var analytics_page_view_1 = require("./entities/analytics-page-view");
+Object.defineProperty(exports, "AnalyticsPageViewDescriptor", { enumerable: true, get: function () { return analytics_page_view_1.AnalyticsPageViewDescriptor; } });
+var analytics_page_view_meta_1 = require("./entities/analytics-page-view.meta");
+Object.defineProperty(exports, "analyticsPageViewMeta", { enumerable: true, get: function () { return analytics_page_view_meta_1.analyticsPageViewMeta; } });
+var analytics_daily_summary_1 = require("./entities/analytics-daily-summary");
+Object.defineProperty(exports, "AnalyticsDailySummaryDescriptor", { enumerable: true, get: function () { return analytics_daily_summary_1.AnalyticsDailySummaryDescriptor; } });
+var analytics_daily_summary_meta_1 = require("./entities/analytics-daily-summary.meta");
+Object.defineProperty(exports, "analyticsDailySummaryMeta", { enumerable: true, get: function () { return analytics_daily_summary_meta_1.analyticsDailySummaryMeta; } });
+var analytics_summary_1 = require("./entities/analytics-summary");
+Object.defineProperty(exports, "AnalyticsSummaryDescriptor", { enumerable: true, get: function () { return analytics_summary_1.AnalyticsSummaryDescriptor; } });
+var analytics_summary_meta_1 = require("./entities/analytics-summary.meta");
+Object.defineProperty(exports, "analyticsSummaryMeta", { enumerable: true, get: function () { return analytics_summary_meta_1.analyticsSummaryMeta; } });
+var analytics_timeline_1 = require("./entities/analytics-timeline");
+Object.defineProperty(exports, "AnalyticsTimelineDescriptor", { enumerable: true, get: function () { return analytics_timeline_1.AnalyticsTimelineDescriptor; } });
+var analytics_timeline_meta_1 = require("./entities/analytics-timeline.meta");
+Object.defineProperty(exports, "analyticsTimelineMeta", { enumerable: true, get: function () { return analytics_timeline_meta_1.analyticsTimelineMeta; } });
+var analytics_breakdown_1 = require("./entities/analytics-breakdown");
+Object.defineProperty(exports, "AnalyticsBreakdownDescriptor", { enumerable: true, get: function () { return analytics_breakdown_1.AnalyticsBreakdownDescriptor; } });
+var analytics_breakdown_meta_1 = require("./entities/analytics-breakdown.meta");
+Object.defineProperty(exports, "analyticsBreakdownMeta", { enumerable: true, get: function () { return analytics_breakdown_meta_1.analyticsBreakdownMeta; } });
+var analytics_event_meta_1 = require("./entities/analytics-event.meta");
+Object.defineProperty(exports, "analyticsEventMeta", { enumerable: true, get: function () { return analytics_event_meta_1.analyticsEventMeta; } });
+var analytics_session_repository_1 = require("./repositories/analytics-session.repository");
+Object.defineProperty(exports, "AnalyticsSessionRepository", { enumerable: true, get: function () { return analytics_session_repository_1.AnalyticsSessionRepository; } });
+var analytics_page_view_repository_1 = require("./repositories/analytics-page-view.repository");
+Object.defineProperty(exports, "AnalyticsPageViewRepository", { enumerable: true, get: function () { return analytics_page_view_repository_1.AnalyticsPageViewRepository; } });
+var analytics_daily_summary_repository_1 = require("./repositories/analytics-daily-summary.repository");
+Object.defineProperty(exports, "AnalyticsDailySummaryRepository", { enumerable: true, get: function () { return analytics_daily_summary_repository_1.AnalyticsDailySummaryRepository; } });
+var analytics_admin_repository_1 = require("./repositories/analytics.admin.repository");
+Object.defineProperty(exports, "AnalyticsAdminRepository", { enumerable: true, get: function () { return analytics_admin_repository_1.AnalyticsAdminRepository; } });
+var analytics_visitor_id_service_1 = require("./services/analytics.visitor-id.service");
+Object.defineProperty(exports, "AnalyticsVisitorIdService", { enumerable: true, get: function () { return analytics_visitor_id_service_1.AnalyticsVisitorIdService; } });
+var analytics_service_1 = require("./services/analytics.service");
+Object.defineProperty(exports, "AnalyticsService", { enumerable: true, get: function () { return analytics_service_1.AnalyticsService; } });
+var analytics_admin_service_1 = require("./services/analytics.admin.service");
+Object.defineProperty(exports, "AnalyticsAdminService", { enumerable: true, get: function () { return analytics_admin_service_1.AnalyticsAdminService; } });
+var analytics_processor_1 = require("./processors/analytics.processor");
+Object.defineProperty(exports, "AnalyticsProcessor", { enumerable: true, get: function () { return analytics_processor_1.AnalyticsProcessor; } });
+var analytics_retention_cron_1 = require("./cron/analytics-retention.cron");
+Object.defineProperty(exports, "AnalyticsRetentionCron", { enumerable: true, get: function () { return analytics_retention_cron_1.AnalyticsRetentionCron; } });
+var analytics_config_interface_1 = require("./interfaces/analytics.config.interface");
+Object.defineProperty(exports, "ANALYTICS_CONFIG", { enumerable: true, get: function () { return analytics_config_interface_1.ANALYTICS_CONFIG; } });
+Object.defineProperty(exports, "ANALYTICS_QUEUE", { enumerable: true, get: function () { return analytics_config_interface_1.ANALYTICS_QUEUE; } });
+Object.defineProperty(exports, "DEFAULT_ANALYTICS_CONFIG", { enumerable: true, get: function () { return analytics_config_interface_1.DEFAULT_ANALYTICS_CONFIG; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/analytics/index.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,kEAIsC;AAFpC,+HAAA,0BAA0B,OAAA;AAG5B,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAC7B,sEAIwC;AAFtC,kIAAA,2BAA2B,OAAA;AAG7B,gFAA4E;AAAnE,iIAAA,qBAAqB,OAAA;AAC9B,8EAI4C;AAF1C,0IAAA,+BAA+B,OAAA;AAGjC,wFAAoF;AAA3E,yIAAA,yBAAyB,OAAA;AAClC,kEAIsC;AAFpC,+HAAA,0BAA0B,OAAA;AAG5B,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAC7B,oEAIuC;AAFrC,iIAAA,2BAA2B,OAAA;AAG7B,8EAA2E;AAAlE,gIAAA,qBAAqB,OAAA;AAC9B,sEAIwC;AAFtC,mIAAA,4BAA4B,OAAA;AAG9B,gFAA6E;AAApE,kIAAA,sBAAsB,OAAA;AAC/B,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAC3B,4FAAyF;AAAhF,0IAAA,0BAA0B,OAAA;AACnC,gGAA4F;AAAnF,6IAAA,2BAA2B,OAAA;AACpC,wGAAoG;AAA3F,qJAAA,+BAA+B,OAAA;AACxC,wFAAqF;AAA5E,sIAAA,wBAAwB,OAAA;AACjC,wFAAoF;AAA3E,yIAAA,yBAAyB,OAAA;AAClC,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AACzB,8EAA2E;AAAlE,gIAAA,qBAAqB,OAAA;AAC9B,wEAAsE;AAA7D,yHAAA,kBAAkB,OAAA;AAC3B,4EAAyE;AAAhE,kIAAA,sBAAsB,OAAA;AAG/B,sFAKiD;AAH/C,8HAAA,gBAAgB,OAAA;AAChB,6HAAA,eAAe,OAAA;AACf,sIAAA,wBAAwB,OAAA"}

package/dist/foundations/analytics/interfaces/analytics.config.interface.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Configuration interface for the AnalyticsModule.
+ *
+ * The normal way to configure analytics is the environment: `ANALYTICS_ENABLED`,
+ * `ANALYTICS_RETENTION_MONTHS` and `ANALYTICS_SESSION_TIMEOUT_MINUTES`, read
+ * through `baseConfig.analytics`. Values passed here are an override and win
+ * over the environment. With the variable unset and no override, nothing is
+ * registered: no controller, no queue and no processor.
+ */
+export interface AnalyticsModuleConfig {
+    /**
+     * When true, the module registers the public event endpoint, the admin
+     * endpoints, the queue, the processor and the retention cron.
+     *
+     * Normally set through `ANALYTICS_ENABLED=true`; a value here overrides the
+     * environment. Default false: analytics collection is an app-visible
+     * behaviour change and must be opted into explicitly.
+     *
+     * @default false (env: ANALYTICS_ENABLED)
+     */
+    enabled?: boolean;
+    /**
+     * How many months raw sessions and page views are kept before the retention
+     * cron rolls them up into daily summaries and deletes them.
+     *
+     * @default 13 (env: ANALYTICS_RETENTION_MONTHS)
+     */
+    retentionMonths?: number;
+    /**
+     * Inactivity window after which the next event from the same visitor starts
+     * a new session.
+     *
+     * @default 30 (env: ANALYTICS_SESSION_TIMEOUT_MINUTES)
+     */
+    sessionTimeoutMinutes?: number;
+    /**
+     * BullMQ queue the producer (`AnalyticsService.track()`) 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 (`AnalyticsProcessor`) binds to `QueueId.ANALYTICS`
+     * 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.ANALYTICS ("analytics")
+     */
+    queueId?: string;
+    /**
+     * BullMQ job name used for the enqueue/dispatch handshake between
+     * `AnalyticsService.track()` and `AnalyticsProcessor.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 "analytics:pageView"
+     */
+    jobName?: string;
+}
+/**
+ * Injection token for the resolved analytics configuration.
+ * Always resolves to a `Required<AnalyticsModuleConfig>` (defaults merged in).
+ */
+export declare const ANALYTICS_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 ANALYTICS_QUEUE: unique symbol;
+/**
+ * Default configuration values.
+ */
+export declare const DEFAULT_ANALYTICS_CONFIG: Required<AnalyticsModuleConfig>;
+//# sourceMappingURL=analytics.config.interface.d.ts.map

package/dist/foundations/analytics/interfaces/analytics.config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.config.interface.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/interfaces/analytics.config.interface.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,qBAAqB,CAMpE,CAAC"}

package/dist/foundations/analytics/interfaces/analytics.config.interface.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ANALYTICS_CONFIG = exports.ANALYTICS_QUEUE = exports.ANALYTICS_CONFIG = void 0;
+const queue_id_1 = require("../../../config/enums/queue.id");
+/**
+ * Injection token for the resolved analytics configuration.
+ * Always resolves to a `Required<AnalyticsModuleConfig>` (defaults merged in).
+ */
+exports.ANALYTICS_CONFIG = Symbol("ANALYTICS_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.ANALYTICS_QUEUE = Symbol("ANALYTICS_QUEUE");
+/**
+ * Default configuration values.
+ */
+exports.DEFAULT_ANALYTICS_CONFIG = {
+    enabled: false,
+    retentionMonths: 13,
+    sessionTimeoutMinutes: 30,
+    queueId: queue_id_1.QueueId.ANALYTICS,
+    jobName: "analytics:pageView",
+};
+//# sourceMappingURL=analytics.config.interface.js.map

package/dist/foundations/analytics/interfaces/analytics.config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.config.interface.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/interfaces/analytics.config.interface.ts"],"names":[],"mappings":";;;AAAA,6DAAyD;AAqEzD;;;GAGG;AACU,QAAA,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAE3D;;;;;;GAMG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD;;GAEG;AACU,QAAA,wBAAwB,GAAoC;IACvE,OAAO,EAAE,KAAK;IACd,eAAe,EAAE,EAAE;IACnB,qBAAqB,EAAE,EAAE;IACzB,OAAO,EAAE,kBAAO,CAAC,SAAS;IAC1B,OAAO,EAAE,oBAAoB;CAC9B,CAAC"}

package/dist/foundations/analytics/interfaces/analytics.page-view.input.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Input accepted by `AnalyticsService.track()` and queued as the BullMQ job
+ * payload consumed by `AnalyticsProcessor`.
+ *
+ * `clientIp` and `userAgent` travel only as far as the worker: they are hashed
+ * into the daily visitor id and classified into a `deviceType`, then discarded.
+ * Neither ever reaches Neo4j.
+ */
+export interface AnalyticsPageViewInput {
+    path: string;
+    section: "public" | "app";
+    referrer?: string;
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    utmTerm?: string;
+    utmContent?: string;
+    /** UUID from the consent cookie; absent when the visitor has not consented. */
+    visitorId?: string;
+    screenWidth?: number;
+    /** First `X-Forwarded-For` hop or `request.ip`. Hashed in the worker, never stored. */
+    clientIp: string;
+    /** Hashed and classified in the worker, never stored. */
+    userAgent: string;
+    /** Set by `OptionalJwtAuthGuard` when the request carries a valid token. */
+    userId?: string;
+    /** ISO instant set by the controller when the request arrived. */
+    receivedAt: string;
+}
+//# sourceMappingURL=analytics.page-view.input.d.ts.map

package/dist/foundations/analytics/interfaces/analytics.page-view.input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.page-view.input.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/interfaces/analytics.page-view.input.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/foundations/analytics/interfaces/analytics.page-view.input.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=analytics.page-view.input.js.map

package/dist/foundations/analytics/interfaces/analytics.page-view.input.js.map

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

package/dist/foundations/analytics/interfaces/analytics.resolved-page-view.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Input accepted by `AnalyticsSessionRepository.recordPageView()`.
+ *
+ * Built by `AnalyticsProcessor` from an `AnalyticsPageViewInput` once the
+ * visitor id is resolved, the route normalised and the user agent reduced to a
+ * `deviceType`. Optional values are `null` rather than `undefined` so they can
+ * be bound straight into Cypher parameters.
+ */
+export interface AnalyticsResolvedPageView {
+    /** `c:<uuid>` from the consent cookie or `d:<sha256>` daily hash. */
+    visitorId: string;
+    consented: boolean;
+    path: string;
+    /** `path` with UUID segments replaced by `:id`. */
+    route: string;
+    section: "public" | "app";
+    /** Hostname of the external referrer, `null` for internal or missing referrers. */
+    referrerHost: string | null;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    utmTerm: string | null;
+    utmContent: string | null;
+    deviceType: string;
+    userId: string | null;
+    /** ISO instant; becomes the page view's `createdAt` and the session's `lastSeenAt`. */
+    receivedAt: string;
+    sessionTimeoutMinutes: number;
+}
+//# sourceMappingURL=analytics.resolved-page-view.d.ts.map

package/dist/foundations/analytics/interfaces/analytics.resolved-page-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.resolved-page-view.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/interfaces/analytics.resolved-page-view.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC1B,mFAAmF;IACnF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,MAAM,CAAC;CAC/B"}

package/dist/foundations/analytics/interfaces/analytics.resolved-page-view.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=analytics.resolved-page-view.js.map

package/dist/foundations/analytics/interfaces/analytics.resolved-page-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.resolved-page-view.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/interfaces/analytics.resolved-page-view.ts"],"names":[],"mappings":""}

package/dist/foundations/analytics/processors/analytics.processor.d.ts

@@ -0,0 +1,33 @@
+import { WorkerHost } from "@nestjs/bullmq";
+import { Job } from "bullmq";
+import { ClsService } from "nestjs-cls";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { AnalyticsModuleConfig } from "../interfaces/analytics.config.interface";
+import { AnalyticsPageViewInput } from "../interfaces/analytics.page-view.input";
+import { AnalyticsSessionRepository } from "../repositories/analytics-session.repository";
+import { AnalyticsVisitorIdService } from "../services/analytics.visitor-id.service";
+/**
+ * Worker-side of `AnalyticsService.track()`.
+ *
+ * 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 `ANALYTICS_CONFIG` at construction
+ * time, so producer and consumer always agree on it.
+ *
+ * Concurrency 1 so two events from one visitor can never both create a session.
+ */
+export declare class AnalyticsProcessor extends WorkerHost {
+    private readonly logger;
+    private readonly repository;
+    private readonly visitorIds;
+    private readonly cls;
+    private readonly jobName;
+    private readonly sessionTimeoutMinutes;
+    constructor(logger: AppLoggingService, repository: AnalyticsSessionRepository, visitorIds: AnalyticsVisitorIdService, cls: ClsService, config: Required<AnalyticsModuleConfig>);
+    onError(job: Job): void;
+    process(job: Job<AnalyticsPageViewInput>): Promise<void>;
+    private normaliseRoute;
+    private referrerHost;
+}
+//# sourceMappingURL=analytics.processor.d.ts.map

package/dist/foundations/analytics/processors/analytics.processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.processor.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/processors/analytics.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,EAAoB,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAQrF;;;;;;;;;;GAUG;AACH,qBACa,kBAAmB,SAAQ,UAAU;IAK9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAG5B,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,0BAA0B,EACtC,UAAU,EAAE,yBAAyB,EACrC,GAAG,EAAE,UAAU,EACN,MAAM,EAAE,QAAQ,CAAC,qBAAqB,CAAC;IAQnE,OAAO,CAAC,GAAG,EAAE,GAAG;IAIV,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgD9D,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;CAQrB"}

package/dist/foundations/analytics/processors/analytics.processor.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.AnalyticsProcessor = 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 analytics_config_interface_1 = require("../interfaces/analytics.config.interface");
+const analytics_session_repository_1 = require("../repositories/analytics-session.repository");
+const analytics_visitor_id_service_1 = require("../services/analytics.visitor-id.service");
+/**
+ * UUID v1–v5 path segment. Same regex as the web helper
+ * (`nextjs-jsonapi/src/features/analytics/lib/routeNormaliser.ts`).
+ */
+const UUID_SEGMENT = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Worker-side of `AnalyticsService.track()`.
+ *
+ * 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 `ANALYTICS_CONFIG` at construction
+ * time, so producer and consumer always agree on it.
+ *
+ * Concurrency 1 so two events from one visitor can never both create a session.
+ */
+let AnalyticsProcessor = class AnalyticsProcessor extends bullmq_1.WorkerHost {
+    constructor(logger, repository, visitorIds, cls, config) {
+        super();
+        this.logger = logger;
+        this.repository = repository;
+        this.visitorIds = visitorIds;
+        this.cls = cls;
+        this.jobName = config.jobName;
+        this.sessionTimeoutMinutes = config.sessionTimeoutMinutes;
+    }
+    onError(job) {
+        this.logger.error(`Analytics pageView failed (jobId=${job.id}): ${job.failedReason ?? "unknown"}`);
+    }
+    async process(job) {
+        if (job.name !== this.jobName) {
+            throw new Error(`Job ${job.name} not handled by AnalyticsProcessor`);
+        }
+        const input = job.data;
+        if (this.visitorIds.isBot(input.userAgent)) {
+            this.logger.debug(`analytics pageView dropped reason=bot path=${input.path}`);
+            return;
+        }
+        // The worker runs outside any HTTP request, so CLS is empty: seed it
+        // explicitly or SecurityService has no context to work from.
+        await this.cls.run(async () => {
+            this.cls.set("isAutomatedJob", true);
+            const { visitorId, consented } = await this.visitorIds.resolve({
+                visitorId: input.visitorId,
+                clientIp: input.clientIp,
+                userAgent: input.userAgent,
+                receivedAt: input.receivedAt,
+            });
+            const resolved = {
+                visitorId,
+                consented,
+                path: input.path,
+                route: this.normaliseRoute(input.path),
+                section: input.section,
+                referrerHost: this.referrerHost(input.referrer),
+                utmSource: input.utmSource ?? null,
+                utmMedium: input.utmMedium ?? null,
+                utmCampaign: input.utmCampaign ?? null,
+                utmTerm: input.utmTerm ?? null,
+                utmContent: input.utmContent ?? null,
+                deviceType: this.visitorIds.deviceType(input.userAgent),
+                userId: input.userId ?? null,
+                receivedAt: input.receivedAt,
+                sessionTimeoutMinutes: this.sessionTimeoutMinutes,
+            };
+            const { sessionId, created } = await this.repository.recordPageView(resolved);
+            this.logger.debug(`analytics pageView visitor=${visitorId} session=${sessionId} created=${created}`);
+        });
+    }
+    normaliseRoute(path) {
+        return path
+            .split("/")
+            .map((segment) => (UUID_SEGMENT.test(segment) ? ":id" : segment))
+            .join("/");
+    }
+    referrerHost(referrer) {
+        if (!referrer)
+            return null;
+        try {
+            return new URL(referrer).hostname || null;
+        }
+        catch {
+            return null;
+        }
+    }
+};
+exports.AnalyticsProcessor = AnalyticsProcessor;
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("failed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], AnalyticsProcessor.prototype, "onError", null);
+exports.AnalyticsProcessor = AnalyticsProcessor = __decorate([
+    (0, bullmq_1.Processor)(queue_id_1.QueueId.ANALYTICS, { concurrency: 1 }),
+    __param(4, (0, common_1.Inject)(analytics_config_interface_1.ANALYTICS_CONFIG)),
+    __metadata("design:paramtypes", [logging_service_1.AppLoggingService,
+        analytics_session_repository_1.AnalyticsSessionRepository,
+        analytics_visitor_id_service_1.AnalyticsVisitorIdService,
+        nestjs_cls_1.ClsService, Object])
+], AnalyticsProcessor);
+//# sourceMappingURL=analytics.processor.js.map

package/dist/foundations/analytics/processors/analytics.processor.js.map

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

package/dist/foundations/analytics/repositories/analytics-daily-summary.repository.d.ts

@@ -0,0 +1,38 @@
+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 { AnalyticsDailySummary, AnalyticsDailySummaryDescriptor } from "../entities/analytics-daily-summary";
+/**
+ * Daily roll-ups written by the retention job before a day's raw sessions and
+ * page views are deleted. Platform-level, written outside HTTP/CLS context.
+ *
+ * The aggregate reads RETURN scalar columns, not graph nodes, so
+ * readOne()/readMany() cannot map them; they read the columns off the driver
+ * result, the same shape and rationale as TokenUsageAdminRepository.
+ */
+export declare class AnalyticsDailySummaryRepository extends AbstractRepository<AnalyticsDailySummary, typeof AnalyticsDailySummaryDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<AnalyticsDailySummary, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /** Adds the (date, dimension) index on top of the id constraint AbstractRepository creates from the descriptor. */
+    onModuleInit(): Promise<void>;
+    /**
+     * MERGEs one row per (section, dimension, key) for the sessions that started
+     * on `date`: `total` plus source, medium, campaign, referrer and landing from
+     * the sessions, and route from their page views. Sessions without a value for
+     * a dimension (no UTM, no external referrer) are written under the key
+     * '(none)', the same key AnalyticsAdminRepository's breakdown uses for raw
+     * rows, so raw and summarised rows merge.
+     *
+     * Every property is set ON CREATE only, so an existing row is never
+     * overwritten. That keeps a re-run idempotent after a crash part-way through
+     * the raw delete: the next night's rollup sees only the sessions that
+     * survived, and a plain SET would replace the stored totals with those
+     * smaller counts.
+     * Returns the number of rows written.
+     */
+    rollupDay(params: {
+        date: string;
+    }): Promise<number>;
+}
+//# sourceMappingURL=analytics-daily-summary.repository.d.ts.map

package/dist/foundations/analytics/repositories/analytics-daily-summary.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-daily-summary.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/repositories/analytics-daily-summary.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,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AA4B7G;;;;;;;GAOG;AACH,qBACa,+BAAgC,SAAQ,kBAAkB,CACrE,qBAAqB,EACrB,OAAO,+BAA+B,CAAC,aAAa,CACrD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU,iEAAmC;gBAEpD,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,mHAAmH;IACpG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5C;;;;;;;;;;;;;;OAcG;IACG,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA6E3D"}

package/dist/foundations/analytics/repositories/analytics-daily-summary.repository.js

@@ -0,0 +1,142 @@
+"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.AnalyticsDailySummaryRepository = void 0;
+const common_1 = require("@nestjs/common");
+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 security_service_1 = require("../../../core/security/services/security.service");
+const analytics_daily_summary_1 = require("../entities/analytics-daily-summary");
+const analytics_page_view_meta_1 = require("../entities/analytics-page-view.meta");
+const analytics_session_meta_1 = require("../entities/analytics-session.meta");
+const toNumber = (v) => {
+    if (v === null || v === undefined)
+        return 0;
+    if (typeof v === "number")
+        return v;
+    if (typeof v.toNumber === "function")
+        return v.toNumber();
+    return Number(v) || 0;
+};
+const S = analytics_session_meta_1.analyticsSessionMeta.nodeName; // "analyticsSession"
+const PV = analytics_page_view_meta_1.analyticsPageViewMeta.nodeName; // "analyticsPageView"
+/** Key for a session with no value for a dimension; must match AnalyticsAdminRepository's coalesce. */
+const NONE_KEY = "(none)";
+/**
+ * Daily roll-ups written by the retention job before a day's raw sessions and
+ * page views are deleted. Platform-level, written outside HTTP/CLS context.
+ *
+ * The aggregate reads RETURN scalar columns, not graph nodes, so
+ * readOne()/readMany() cannot map them; they read the columns off the driver
+ * result, the same shape and rationale as TokenUsageAdminRepository.
+ */
+let AnalyticsDailySummaryRepository = class AnalyticsDailySummaryRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = analytics_daily_summary_1.AnalyticsDailySummaryDescriptor;
+    }
+    /** Adds the (date, dimension) index on top of the id constraint AbstractRepository creates from the descriptor. */
+    async onModuleInit() {
+        await super.onModuleInit();
+        const { nodeName, labelName } = this.descriptor.model;
+        await this.neo4j.writeOne({
+            query: `CREATE INDEX ${nodeName}_date_dimension IF NOT EXISTS FOR (${nodeName}:${labelName}) ON (${nodeName}.date, ${nodeName}.dimension)`,
+        });
+    }
+    /**
+     * MERGEs one row per (section, dimension, key) for the sessions that started
+     * on `date`: `total` plus source, medium, campaign, referrer and landing from
+     * the sessions, and route from their page views. Sessions without a value for
+     * a dimension (no UTM, no external referrer) are written under the key
+     * '(none)', the same key AnalyticsAdminRepository's breakdown uses for raw
+     * rows, so raw and summarised rows merge.
+     *
+     * Every property is set ON CREATE only, so an existing row is never
+     * overwritten. That keeps a re-run idempotent after a crash part-way through
+     * the raw delete: the next night's rollup sees only the sessions that
+     * survived, and a plain SET would replace the stored totals with those
+     * smaller counts.
+     * Returns the number of rows written.
+     */
+    async rollupDay(params) {
+        const sessionResult = await this.neo4j.read(`
+        MATCH (${S}:${analytics_session_meta_1.analyticsSessionMeta.labelName})
+        WHERE date(${S}.startedAt) = date($date)
+        UNWIND [
+          ['total', ''],
+          ['source', coalesce(${S}.utmSource, $noneKey)],
+          ['medium', coalesce(${S}.utmMedium, $noneKey)],
+          ['campaign', coalesce(${S}.utmCampaign, $noneKey)],
+          ['referrer', coalesce(${S}.referrerHost, $noneKey)],
+          ['landing', coalesce(${S}.landingRoute, $noneKey)]
+        ] AS pair
+        WITH ${S}, pair[0] AS dimension, pair[1] AS key
+        RETURN ${S}.section AS section,
+          dimension,
+          key,
+          count(DISTINCT ${S}.visitorId) AS visitors,
+          count(DISTINCT ${S}) AS sessions,
+          sum(${S}.pageViews) AS pageViews
+      `, { date: params.date, noneKey: NONE_KEY });
+        const pageViewResult = await this.neo4j.read(`
+        MATCH (${PV}:${analytics_page_view_meta_1.analyticsPageViewMeta.labelName})-[:IN_SESSION]->(${S}:${analytics_session_meta_1.analyticsSessionMeta.labelName})
+        WHERE date(${S}.startedAt) = date($date)
+        RETURN ${PV}.section AS section,
+          'route' AS dimension,
+          ${PV}.route AS key,
+          count(DISTINCT ${S}.visitorId) AS visitors,
+          count(DISTINCT ${S}) AS sessions,
+          count(${PV}) AS pageViews
+      `, { date: params.date });
+        const rows = [...sessionResult.records, ...pageViewResult.records].map((r) => {
+            const section = r.get("section");
+            const dimension = r.get("dimension");
+            const key = r.get("key") ?? "";
+            return {
+                id: `${params.date}|${section}|${dimension}|${key}`,
+                section,
+                dimension,
+                key,
+                visitors: toNumber(r.get("visitors")),
+                sessions: toNumber(r.get("sessions")),
+                pageViews: toNumber(r.get("pageViews")),
+            };
+        });
+        if (rows.length === 0)
+            return 0;
+        const { nodeName, labelName } = this.descriptor.model;
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, date: params.date, rows };
+        query.query = `
+      UNWIND $rows AS row
+      MERGE (${nodeName}:${labelName} {id: row.id})
+      ON CREATE SET
+        ${nodeName}.date = date(left($date, 10)),
+        ${nodeName}.section = row.section,
+        ${nodeName}.dimension = row.dimension,
+        ${nodeName}.key = row.key,
+        ${nodeName}.visitors = row.visitors,
+        ${nodeName}.sessions = row.sessions,
+        ${nodeName}.pageViews = row.pageViews,
+        ${nodeName}.createdAt = datetime(),
+        ${nodeName}.updatedAt = datetime()
+    `;
+        await this.neo4j.writeOne(query);
+        return rows.length;
+    }
+};
+exports.AnalyticsDailySummaryRepository = AnalyticsDailySummaryRepository;
+exports.AnalyticsDailySummaryRepository = AnalyticsDailySummaryRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], AnalyticsDailySummaryRepository);
+//# sourceMappingURL=analytics-daily-summary.repository.js.map