@carlonicora/nestjs-neo4jsonapi 4.14.0 → 4.15.0

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

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

package/dist/foundations/analytics/repositories/analytics-page-view.repository.d.ts

@@ -0,0 +1,30 @@
+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 { AnalyticsPageView, AnalyticsPageViewDescriptor } from "../entities/analytics-page-view";
+/**
+ * Page views are created by AnalyticsSessionRepository.recordPageView() in the
+ * same transaction as their session; this repository only owns the createdAt
+ * index and the per-session journey read.
+ */
+export declare class AnalyticsPageViewRepository extends AbstractRepository<AnalyticsPageView, typeof AnalyticsPageViewDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<AnalyticsPageView, {
+        session: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /** Adds the createdAt index on top of the id constraint AbstractRepository creates from the descriptor. */
+    onModuleInit(): Promise<void>;
+    /** Every page view of one session, in the order they were visited. */
+    findBySession(params: {
+        sessionId: string;
+    }): Promise<AnalyticsPageView[]>;
+}
+//# sourceMappingURL=analytics-page-view.repository.d.ts.map

package/dist/foundations/analytics/repositories/analytics-page-view.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-page-view.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/repositories/analytics-page-view.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,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAGjG;;;;GAIG;AACH,qBACa,2BAA4B,SAAQ,kBAAkB,CACjE,iBAAiB,EACjB,OAAO,2BAA2B,CAAC,aAAa,CACjD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA+B;gBAEhD,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,2GAA2G;IAC5F,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5C,sEAAsE;IAChE,aAAa,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAoBjF"}

package/dist/foundations/analytics/repositories/analytics-page-view.repository.js

@@ -0,0 +1,62 @@
+"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.AnalyticsPageViewRepository = 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_page_view_1 = require("../entities/analytics-page-view");
+const analytics_session_meta_1 = require("../entities/analytics-session.meta");
+/**
+ * Page views are created by AnalyticsSessionRepository.recordPageView() in the
+ * same transaction as their session; this repository only owns the createdAt
+ * index and the per-session journey read.
+ */
+let AnalyticsPageViewRepository = class AnalyticsPageViewRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = analytics_page_view_1.AnalyticsPageViewDescriptor;
+    }
+    /** Adds the createdAt 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}_createdAt IF NOT EXISTS FOR (${nodeName}:${labelName}) ON (${nodeName}.createdAt)`,
+        });
+    }
+    /** Every page view of one session, in the order they were visited. */
+    async findBySession(params) {
+        const { nodeName } = this.descriptor.model;
+        const query = this.neo4j.initQuery({ serialiser: this.descriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            sessionId: params.sessionId,
+            ...this.getPolyLabelParams(),
+        };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      MATCH (${nodeName})-[:IN_SESSION]->(:${analytics_session_meta_1.analyticsSessionMeta.labelName} {id: $sessionId})
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+      ORDER BY ${nodeName}.createdAt ASC
+    `;
+        return this.neo4j.readMany(query);
+    }
+};
+exports.AnalyticsPageViewRepository = AnalyticsPageViewRepository;
+exports.AnalyticsPageViewRepository = AnalyticsPageViewRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], AnalyticsPageViewRepository);
+//# sourceMappingURL=analytics-page-view.repository.js.map

package/dist/foundations/analytics/repositories/analytics-page-view.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-page-view.repository.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/repositories/analytics-page-view.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,yEAAiG;AACjG,+EAA0E;AAE1E;;;;GAIG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA4B,SAAQ,wCAGhD;IAGC,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,iDAA2B,CAAC;IAI5D,CAAC;IAED,2GAA2G;IAClG,KAAK,CAAC,YAAY;QACzB,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;QAE3B,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAEtD,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE,gBAAgB,QAAQ,iCAAiC,QAAQ,IAAI,SAAS,SAAS,QAAQ,aAAa;SACpH,CAAC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,aAAa,CAAC,MAA6B;QAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAE1E,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,IAAI,CAAC,kBAAkB,EAAE;SAC7B,CAAC;QAEF,KAAK,CAAC,KAAK,IAAI;QACX,IAAI,CAAC,iBAAiB,EAAE;eACjB,QAAQ,sBAAsB,6CAAoB,CAAC,SAAS;aAC9D,QAAQ;QACb,IAAI,CAAC,oBAAoB,EAAE;iBAClB,QAAQ;KACpB,CAAC;QAEF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AA1CY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,mBAAU,GAAE;qCAOQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAN9E,2BAA2B,CA0CvC"}

package/dist/foundations/analytics/repositories/analytics-session.repository.d.ts

@@ -0,0 +1,87 @@
+import { ClsService } from "nestjs-cls";
+import { JsonApiCursorInterface } from "../../../core/jsonapi/interfaces/jsonapi.cursor.interface";
+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 { AnalyticsSession, AnalyticsSessionDescriptor } from "../entities/analytics-session";
+import { AnalyticsResolvedPageView } from "../interfaces/analytics.resolved-page-view";
+/**
+ * Sessions are platform-level (`isCompanyScoped: false`) and are written from
+ * the BullMQ worker (see AnalyticsProcessor), outside HTTP/CLS context, so the
+ * writes are fully custom Cypher, as UserActivityRepository.createActivity()
+ * does. Every datetime write casts with `datetime($receivedAt)`.
+ *
+ * The retention methods (deleteDay, unlinkDeletedUsers, findExpiredDays) return
+ * scalar counts or days rather than graph nodes, so readOne()/readMany() cannot
+ * map them; they read the scalar columns off the driver result, the same shape
+ * and rationale as TokenUsageAdminRepository.
+ */
+export declare class AnalyticsSessionRepository extends AbstractRepository<AnalyticsSession, typeof AnalyticsSessionDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<AnalyticsSession, {
+        user: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Adds the session lookup index (visitor + recency, used by recordPageView)
+     * and the startedAt index (admin lists, retention) on top of the id
+     * constraint AbstractRepository creates from the descriptor.
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * One transaction for the whole session resolution of spec §4: find the
+     * visitor's open session (lastSeenAt within the timeout), create it with this
+     * event's attribution when there is none, otherwise bump lastSeenAt and
+     * pageViews; then create the page view and, when the event carries a user
+     * and the session has none yet, the BY_USER edge.
+     *
+     * The new session id is generated here, so `created` is simply whether the
+     * returned session carries it. The session is returned through the
+     * descriptor serialiser (writeOne + serialiser), never as a raw record.
+     */
+    recordPageView(input: AnalyticsResolvedPageView): Promise<{
+        sessionId: string;
+        created: boolean;
+    }>;
+    /**
+     * Administration list, newest first, with the `user` relationship included.
+     * Never binds its own companyId: the only one present is what initQuery()
+     * seeds from CLS for the calling administrator.
+     */
+    findForAdmin(params: {
+        cursor: JsonApiCursorInterface;
+        from: string;
+        to: string;
+        section: "all" | "public" | "app";
+        visitorId?: string;
+        userId?: string;
+    }): Promise<AnalyticsSession[]>;
+    /**
+     * Deletes the page views, then the sessions, of every session that started
+     * on `date`, at most DELETE_BATCH_SIZE nodes per transaction. A loop of
+     * batched transactions rather than `CALL { } IN TRANSACTIONS`: the latter
+     * only runs in an implicit (auto-commit) transaction, and every
+     * Neo4jService write path opens an explicit one.
+     */
+    deleteDay(params: {
+        date: string;
+    }): Promise<{
+        sessions: number;
+        pageViews: number;
+    }>;
+    /** Removes every BY_USER edge whose user has been soft-deleted. Returns the edges removed. */
+    unlinkDeletedUsers(): Promise<number>;
+    /** Distinct calendar days (`YYYY-MM-DD`) with raw sessions before `cutoff`, oldest first. */
+    findExpiredDays(params: {
+        cutoff: string;
+        limit: number;
+    }): Promise<string[]>;
+    private _deleteInBatches;
+}
+//# sourceMappingURL=analytics-session.repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-session.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/repositories/analytics-session.repository.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAavF;;;;;;;;;;GAUG;AACH,qBACa,0BAA2B,SAAQ,kBAAkB,CAChE,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA8B;gBAE/C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;OAIG;IACY,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5C;;;;;;;;;;OAUG;IACG,cAAc,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA+ExG;;;;OAIG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,MAAM,EAAE,sBAAsB,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;QAClC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA8B/B;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA+B3F,8FAA8F;IACxF,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAe3C,6FAA6F;IACvF,eAAe,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAkBrE,gBAAgB;CAc/B"}

package/dist/foundations/analytics/repositories/analytics-session.repository.js

@@ -0,0 +1,261 @@
+"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.AnalyticsSessionRepository = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const nestjs_cls_1 = require("nestjs-cls");
+const define_entity_1 = require("../../../common/helpers/define-entity");
+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 user_meta_1 = require("../../user/entities/user.meta");
+const analytics_session_1 = require("../entities/analytics-session");
+const analytics_page_view_meta_1 = require("../entities/analytics-page-view.meta");
+/** Nodes deleted per transaction by the retention job. */
+const DELETE_BATCH_SIZE = 1000;
+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;
+};
+/**
+ * Sessions are platform-level (`isCompanyScoped: false`) and are written from
+ * the BullMQ worker (see AnalyticsProcessor), outside HTTP/CLS context, so the
+ * writes are fully custom Cypher, as UserActivityRepository.createActivity()
+ * does. Every datetime write casts with `datetime($receivedAt)`.
+ *
+ * The retention methods (deleteDay, unlinkDeletedUsers, findExpiredDays) return
+ * scalar counts or days rather than graph nodes, so readOne()/readMany() cannot
+ * map them; they read the scalar columns off the driver result, the same shape
+ * and rationale as TokenUsageAdminRepository.
+ */
+let AnalyticsSessionRepository = class AnalyticsSessionRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = analytics_session_1.AnalyticsSessionDescriptor;
+    }
+    /**
+     * Adds the session lookup index (visitor + recency, used by recordPageView)
+     * and the startedAt index (admin lists, retention) 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}_visitorId_lastSeenAt IF NOT EXISTS FOR (${nodeName}:${labelName}) ON (${nodeName}.visitorId, ${nodeName}.lastSeenAt)`,
+        });
+        await this.neo4j.writeOne({
+            query: `CREATE INDEX ${nodeName}_startedAt IF NOT EXISTS FOR (${nodeName}:${labelName}) ON (${nodeName}.startedAt)`,
+        });
+    }
+    /**
+     * One transaction for the whole session resolution of spec §4: find the
+     * visitor's open session (lastSeenAt within the timeout), create it with this
+     * event's attribution when there is none, otherwise bump lastSeenAt and
+     * pageViews; then create the page view and, when the event carries a user
+     * and the session has none yet, the BY_USER edge.
+     *
+     * The new session id is generated here, so `created` is simply whether the
+     * returned session carries it. The session is returned through the
+     * descriptor serialiser (writeOne + serialiser), never as a raw record.
+     */
+    async recordPageView(input) {
+        const { nodeName, labelName } = this.descriptor.model;
+        const newSessionId = (0, crypto_1.randomUUID)();
+        const query = this.neo4j.initQuery({ serialiser: this.descriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            newSessionId,
+            pageViewId: (0, crypto_1.randomUUID)(),
+            visitorId: input.visitorId,
+            consented: input.consented,
+            path: input.path,
+            route: input.route,
+            section: input.section,
+            referrerHost: input.referrerHost ?? null,
+            utmSource: input.utmSource ?? null,
+            utmMedium: input.utmMedium ?? null,
+            utmCampaign: input.utmCampaign ?? null,
+            utmTerm: input.utmTerm ?? null,
+            utmContent: input.utmContent ?? null,
+            deviceType: input.deviceType,
+            userId: input.userId ?? null,
+            receivedAt: input.receivedAt,
+            sessionTimeoutMinutes: input.sessionTimeoutMinutes,
+            ...this.getPolyLabelParams(),
+        };
+        query.query = `
+      OPTIONAL MATCH (openSession:${labelName} {visitorId: $visitorId})
+      WHERE openSession.lastSeenAt >= datetime($receivedAt) - duration({minutes: $sessionTimeoutMinutes})
+      WITH openSession
+      ORDER BY openSession.lastSeenAt DESC
+      LIMIT 1
+      MERGE (${nodeName}:${labelName} {id: coalesce(openSession.id, $newSessionId)})
+      ON CREATE SET ${nodeName} += {
+        visitorId: $visitorId,
+        consented: $consented,
+        startedAt: datetime($receivedAt),
+        pageViews: 0,
+        section: $section,
+        landingRoute: $route,
+        referrerHost: $referrerHost,
+        utmSource: $utmSource,
+        utmMedium: $utmMedium,
+        utmCampaign: $utmCampaign,
+        utmTerm: $utmTerm,
+        utmContent: $utmContent,
+        deviceType: $deviceType,
+        createdAt: datetime($receivedAt)
+      }
+      SET ${nodeName}.lastSeenAt = datetime($receivedAt),
+        ${nodeName}.pageViews = ${nodeName}.pageViews + 1,
+        ${nodeName}.updatedAt = datetime($receivedAt)
+      CREATE (${analytics_page_view_meta_1.analyticsPageViewMeta.nodeName}:${analytics_page_view_meta_1.analyticsPageViewMeta.labelName} {
+        id: $pageViewId,
+        path: $path,
+        route: $route,
+        section: $section,
+        createdAt: datetime($receivedAt),
+        updatedAt: datetime($receivedAt)
+      })-[:IN_SESSION]->(${nodeName})
+      WITH ${nodeName}
+      OPTIONAL MATCH (${user_meta_1.userMeta.nodeName}:${user_meta_1.userMeta.labelName} {id: $userId})
+      WITH ${nodeName}, ${user_meta_1.userMeta.nodeName}
+      FOREACH (_ IN CASE
+        WHEN $userId IS NOT NULL AND ${user_meta_1.userMeta.nodeName} IS NOT NULL AND NOT EXISTS { (${nodeName})-[:BY_USER]->(:${user_meta_1.userMeta.labelName}) }
+        THEN [1] ELSE [] END |
+        MERGE (${nodeName})-[:BY_USER]->(${user_meta_1.userMeta.nodeName})
+      )
+      WITH ${nodeName}
+      ${this.buildReturnStatement()}
+    `;
+        const session = await this.neo4j.writeOne(query);
+        if (!session)
+            throw new Error(`Analytics page view for ${input.visitorId} returned no session`);
+        return { sessionId: session.id, created: session.id === newSessionId };
+    }
+    /**
+     * Administration list, newest first, with the `user` relationship included.
+     * Never binds its own companyId: the only one present is what initQuery()
+     * seeds from CLS for the calling administrator.
+     */
+    async findForAdmin(params) {
+        const { nodeName } = this.descriptor.model;
+        const query = this.neo4j.initQuery({ serialiser: this.descriptor.model, cursor: params.cursor });
+        query.queryParams = {
+            ...query.queryParams,
+            from: params.from,
+            to: params.to,
+            section: params.section,
+            visitorId: params.visitorId ?? null,
+            userId: params.userId ?? null,
+            ...this.getPolyLabelParams(),
+        };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${nodeName}.startedAt >= datetime($from)
+        AND ${nodeName}.startedAt <= datetime($to)
+        AND ($section = 'all' OR ${nodeName}.section = $section)
+        AND ($visitorId IS NULL OR ${nodeName}.visitorId = $visitorId)
+        AND ($userId IS NULL OR EXISTS { (${nodeName})-[:BY_USER]->(:${user_meta_1.userMeta.labelName} {id: $userId}) })
+      WITH ${nodeName}
+      ORDER BY ${nodeName}.startedAt DESC
+      {CURSOR}
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readMany(query);
+    }
+    /**
+     * Deletes the page views, then the sessions, of every session that started
+     * on `date`, at most DELETE_BATCH_SIZE nodes per transaction. A loop of
+     * batched transactions rather than `CALL { } IN TRANSACTIONS`: the latter
+     * only runs in an implicit (auto-commit) transaction, and every
+     * Neo4jService write path opens an explicit one.
+     */
+    async deleteDay(params) {
+        const { nodeName, labelName } = this.descriptor.model;
+        const pv = analytics_page_view_meta_1.analyticsPageViewMeta;
+        const pageViews = await this._deleteInBatches({
+            date: params.date,
+            query: `
+        MATCH (${pv.nodeName}:${pv.labelName})-[:IN_SESSION]->(${nodeName}:${labelName})
+        WHERE date(${nodeName}.startedAt) = date($date)
+        WITH ${pv.nodeName}
+        LIMIT toInteger($batchSize)
+        DETACH DELETE ${pv.nodeName}
+        RETURN count(*) AS deleted
+      `,
+        });
+        const sessions = await this._deleteInBatches({
+            date: params.date,
+            query: `
+        MATCH (${nodeName}:${labelName})
+        WHERE date(${nodeName}.startedAt) = date($date)
+        WITH ${nodeName}
+        LIMIT toInteger($batchSize)
+        DETACH DELETE ${nodeName}
+        RETURN count(*) AS deleted
+      `,
+        });
+        return { sessions, pageViews };
+    }
+    /** Removes every BY_USER edge whose user has been soft-deleted. Returns the edges removed. */
+    async unlinkDeletedUsers() {
+        const [result] = await this.neo4j.executeInTransaction([
+            {
+                query: `
+          MATCH (:${this.descriptor.model.labelName})-[r:BY_USER]->(${user_meta_1.userMeta.nodeName}:${user_meta_1.userMeta.labelName} {isDeleted: true})
+          DELETE r
+          RETURN count(*) AS unlinked
+        `,
+                params: {},
+            },
+        ]);
+        return toNumber(result?.records?.[0]?.get("unlinked"));
+    }
+    /** Distinct calendar days (`YYYY-MM-DD`) with raw sessions before `cutoff`, oldest first. */
+    async findExpiredDays(params) {
+        const { nodeName, labelName } = this.descriptor.model;
+        const result = await this.neo4j.read(`
+        MATCH (${nodeName}:${labelName})
+        WHERE date(${nodeName}.startedAt) < date($cutoff)
+        WITH DISTINCT date(${nodeName}.startedAt) AS day
+        RETURN day
+        ORDER BY day ASC
+        LIMIT toInteger($limit)
+      `, { cutoff: params.cutoff, limit: params.limit });
+        return result.records.map((r) => (0, define_entity_1.convertFieldValue)(r.get("day"), "date"));
+    }
+    async _deleteInBatches(params) {
+        let total = 0;
+        let deleted;
+        do {
+            const [result] = await this.neo4j.executeInTransaction([
+                { query: params.query, params: { date: params.date, batchSize: DELETE_BATCH_SIZE } },
+            ]);
+            deleted = toNumber(result?.records?.[0]?.get("deleted"));
+            total += deleted;
+        } while (deleted >= DELETE_BATCH_SIZE);
+        return total;
+    }
+};
+exports.AnalyticsSessionRepository = AnalyticsSessionRepository;
+exports.AnalyticsSessionRepository = AnalyticsSessionRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], AnalyticsSessionRepository);
+//# sourceMappingURL=analytics-session.repository.js.map

package/dist/foundations/analytics/repositories/analytics-session.repository.js.map

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

package/dist/foundations/analytics/repositories/analytics.admin.repository.d.ts

@@ -0,0 +1,145 @@
+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 { AnalyticsBreakdownEntity } from "../entities/analytics-breakdown";
+import { AnalyticsSession, AnalyticsSessionDescriptor } from "../entities/analytics-session";
+import { AnalyticsSummaryEntity } from "../entities/analytics-summary";
+import { AnalyticsTimelineEntity } from "../entities/analytics-timeline";
+/**
+ * The closed sets of values the admin endpoints accept. The controller
+ * validates query params against these tuples and the unions below are derived
+ * from them, so there is one declaration of each set.
+ */
+export declare const SECTIONS: readonly ["all", "public", "app"];
+export declare const GRANULARITIES: readonly ["day", "week", "month"];
+export declare const DIMENSIONS: readonly ["source", "medium", "campaign", "referrer", "route", "landing"];
+export type Section = (typeof SECTIONS)[number];
+export type Granularity = (typeof GRANULARITIES)[number];
+export type Dimension = (typeof DIMENSIONS)[number];
+/**
+ * Platform-wide reporting queries behind /analytics/administration/*.
+ *
+ * Extends AbstractRepository for the shared Neo4j/security/CLS plumbing and the
+ * descriptor typing; none of the inherited finders are used, for the reasons in
+ * the file header, and it deliberately does NOT override onModuleInit — the
+ * analytics indexes belong to the session, page-view and daily-summary
+ * repositories.
+ *
+ * Every aggregate is two reads merged in JS: the RAW part (sessions / page views
+ * on or after `retentionCutoff`) and the SUMMARISED part (daily summaries before
+ * it). Raw visitors are `count(DISTINCT visitorId)`; summarised visitors are the
+ * stored per-day distinct counts, summed — so a multi-day bucket over summarised
+ * data sums daily distinct visitors. The summary adds a third raw read for the
+ * cross-section visitor total (see _sectionTotals).
+ */
+export declare class AnalyticsAdminRepository extends AbstractRepository<AnalyticsSession, typeof AnalyticsSessionDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<AnalyticsSession, {
+        user: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Six rows: {public, app, total} × {current, previous}. The previous window is
+     * the equal-length span immediately preceding `from`, which is what the KPI
+     * tiles' deltas are computed against.
+     */
+    findSummary(params: {
+        from: string;
+        to: string;
+        section: Section;
+        retentionCutoff: string;
+    }): Promise<AnalyticsSummaryEntity[]>;
+    findTimeline(params: {
+        from: string;
+        to: string;
+        section: Section;
+        granularity: Granularity;
+        retentionCutoff: string;
+    }): Promise<AnalyticsTimelineEntity[]>;
+    /**
+     * Ranked rows, descending by visitors, truncated to `limit` with the exact
+     * remainder folded into a single "other" row. The full ordered set is fetched
+     * and sliced in JS so the remainder is exact rather than a second query's
+     * approximation.
+     */
+    findBreakdown(params: {
+        from: string;
+        to: string;
+        section: Section;
+        dimension: Dimension;
+        limit: number;
+        retentionCutoff: string;
+    }): Promise<AnalyticsBreakdownEntity[]>;
+    /**
+     * Raw + summarised totals split by section for one window, plus the window's
+     * total visitor count.
+     *
+     * `totalVisitors` cannot be the sum of the two sections: one visitor with
+     * sessions in both public and app would count twice. Its raw part is a third
+     * read with no section grouping (`count(DISTINCT visitorId)` across both); its
+     * summarised part is the stored per-day `total` rows summed, as for the
+     * sections, because summaries keep no visitor ids to de-duplicate.
+     */
+    private _sectionTotals;
+    /**
+     * Guarantees both sections are present (zero-filled when a window has no
+     * rows) and appends the "total" section, so the tiles never have to branch on
+     * a missing row. Total sessions and page views are the sections' sum; total
+     * visitors is the de-duplicated count from _sectionTotals. Consent share is
+     * measured on the raw part only: daily summaries carry no consent split.
+     */
+    private _withTotal;
+    /** Raw sessions inside the request range and on or after the retention cutoff. */
+    private _rawSessionWindow;
+    /** Summarised days inside the request range and before the retention cutoff. */
+    private _summaryWindow;
+    /**
+     * The query seed every aggregation in this file MUST use.
+     *
+     * It deliberately does NOT call `Neo4jService.initQuery()`. initQuery()
+     * PREPENDS `MATCH (company:Company {id: $companyId})` (plus a currentUser
+     * match hanging off it) whenever the CALLER's CLS session carries a
+     * `companyId` — the same CLS scoping the file header explains this dashboard
+     * must not have, reintroduced through a less obvious door than
+     * buildDefaultMatch().
+     *
+     * Reachable only for an Administrator who ALSO belongs to a company (CLS has
+     * no companyId otherwise), which is exactly the dual-role shape the platform
+     * admin fixture — and real deployments — have. In the token-usage dashboard
+     * that prepended MATCH reduced every aggregation to zero rows and the
+     * zero-fill rendered a successful, empty page (ADM-53..57).
+     *
+     * Analytics nodes have no company at all, so this seed binds no `companyId`
+     * parameter of any kind. `section`, `granularity` and `dimension` are bound
+     * only when the caller supplies them, and only with values echoed from this
+     * file's lookup tables.
+     */
+    private _adminQuery;
+    /** The equal-length span immediately preceding `from`. */
+    private _previousWindow;
+    /**
+     * Resolves a granularity to the `date.truncate` unit it may emit. Throws
+     * rather than interpolating anything the table does not know about.
+     */
+    private _truncationUnit;
+    /**
+     * Resolves the requested section to the value it binds (`null` for `all`).
+     * Returns the TABLE'S OWN string, never the caller's.
+     */
+    private _section;
+    /**
+     * Resolves the requested dimension against the whitelist. Returns the table's
+     * own key and expression, never the caller's string.
+     */
+    private _dimension;
+    private _add;
+    private _metrics;
+}
+//# sourceMappingURL=analytics.admin.repository.d.ts.map

package/dist/foundations/analytics/repositories/analytics.admin.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.admin.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/repositories/analytics.admin.repository.ts"],"names":[],"mappings":"AAsBA,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;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE7F,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAA+B,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEtG;;;;GAIG;AACH,eAAO,MAAM,QAAQ,mCAAoC,CAAC;AAC1D,eAAO,MAAM,aAAa,mCAAoC,CAAC;AAC/D,eAAO,MAAM,UAAU,2EAA4E,CAAC;AAEpG,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAuEpD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,wBAAyB,SAAQ,kBAAkB,CAC9D,gBAAgB,EAChB,OAAO,0BAA0B,CAAC,aAAa,CAChD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA8B;gBAE/C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;OAIG;IACG,WAAW,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAY/B,YAAY,CAAC,MAAM,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,WAAW,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC;IA8EtC;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,SAAS,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;IA+EvC;;;;;;;;;OASG;YACW,cAAc;IA+E5B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAuClB,kFAAkF;IAClF,OAAO,CAAC,iBAAiB;IAKzB,gFAAgF;IAChF,OAAO,CAAC,cAAc;IAKtB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,WAAW;IAwBnB,0DAA0D;IAC1D,OAAO,CAAC,eAAe;IAOvB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAMhB;;;OAGG;IACH,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,QAAQ;CAOjB"}