@carlonicora/nestjs-neo4jsonapi 4.14.0 → 4.15.0

package/dist/foundations/analytics/controllers/analytics.admin.controller.js

@@ -0,0 +1,197 @@
+"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.AnalyticsAdminController = void 0;
+const common_1 = require("@nestjs/common");
+const system_roles_1 = require("../../../common/constants/system.roles");
+const roles_decorator_1 = require("../../../common/decorators/roles.decorator");
+const crud_handlers_1 = require("../../../common/handlers/crud.handlers");
+const audit_decorator_1 = require("../../../common/decorators/audit.decorator");
+const jwt_auth_guard_1 = require("../../../common/guards/jwt.auth.guard");
+const audit_service_1 = require("../../audit/services/audit.service");
+const analytics_breakdown_meta_1 = require("../entities/analytics-breakdown.meta");
+const analytics_page_view_meta_1 = require("../entities/analytics-page-view.meta");
+const analytics_session_meta_1 = require("../entities/analytics-session.meta");
+const analytics_summary_meta_1 = require("../entities/analytics-summary.meta");
+const analytics_timeline_meta_1 = require("../entities/analytics-timeline.meta");
+const analytics_admin_repository_1 = require("../repositories/analytics.admin.repository");
+const analytics_admin_service_1 = require("../services/analytics.admin.service");
+const DEFAULT_WINDOW_DAYS = 30;
+const MAX_WINDOW_DAYS = 400;
+const DEFAULT_BREAKDOWN_LIMIT = 20;
+const MAX_BREAKDOWN_LIMIT = 100;
+const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+/**
+ * Platform-wide web analytics reporting. Every route is administrator-only:
+ * JwtAuthGuard._validateRoles enforces @Roles and always admits the
+ * Administrator role, so a non-administrator receives 401.
+ *
+ * Mounted at /analytics/administration/* — the only other analytics route is
+ * the public POST /analytics/events beacon, so there is no Fastify overlap.
+ *
+ * Enum-valued query params are validated against a closed allowlist here rather
+ * than in a DTO: DTOs are body validation for POST/PUT/PATCH, and GET filters
+ * use bare @Query() params. The allowlist matters — the repository interpolates
+ * granularity and dimension into Cypher (they select a clause, they are not
+ * values), so an unvalidated string would be an injection vector.
+ */
+let AnalyticsAdminController = class AnalyticsAdminController {
+    constructor(service, auditService) {
+        this.service = service;
+        this.auditService = auditService;
+        this.crud = (0, crud_handlers_1.createCrudHandlers)(() => this.service);
+    }
+    async getSummary(reply, from, to, section) {
+        const range = this._range(from, to);
+        reply.send(await this.service.getSummary({
+            ...range,
+            section: this._oneOf(section, analytics_admin_repository_1.SECTIONS, "all"),
+        }));
+    }
+    async getTimeline(reply, from, to, section, granularity) {
+        const range = this._range(from, to);
+        reply.send(await this.service.getTimeline({
+            ...range,
+            section: this._oneOf(section, analytics_admin_repository_1.SECTIONS, "all"),
+            granularity: this._oneOf(granularity, analytics_admin_repository_1.GRANULARITIES, "day"),
+        }));
+    }
+    async getBreakdown(reply, from, to, section, dimension, limit) {
+        const range = this._range(from, to);
+        const parsedLimit = limit === undefined ? DEFAULT_BREAKDOWN_LIMIT : Number(limit);
+        if (!Number.isInteger(parsedLimit) || parsedLimit < 1 || parsedLimit > MAX_BREAKDOWN_LIMIT)
+            throw new common_1.BadRequestException(`limit must be an integer between 1 and ${MAX_BREAKDOWN_LIMIT}`);
+        reply.send(await this.service.getBreakdown({
+            ...range,
+            section: this._oneOf(section, analytics_admin_repository_1.SECTIONS, "all"),
+            dimension: this._oneOf(dimension, analytics_admin_repository_1.DIMENSIONS, "source"),
+            limit: parsedLimit,
+        }));
+    }
+    async getSessions(reply, query, from, to, section, visitorId, userId) {
+        const range = this._range(from, to);
+        reply.send(await this.service.getSessions({
+            query,
+            ...range,
+            section: this._oneOf(section, analytics_admin_repository_1.SECTIONS, "all"),
+            visitorId,
+            userId,
+        }));
+    }
+    // The inherited AbstractService.findById builds the single JSON:API document,
+    // with the optional `user` relationship included from the descriptor.
+    async getSession(reply, sessionId) {
+        return this.crud.findById(reply, sessionId);
+    }
+    async getSessionPageViews(reply, sessionId) {
+        reply.send(await this.service.getSessionPageViews({ sessionId }));
+    }
+    _oneOf(value, allowed, fallback) {
+        if (value === undefined)
+            return fallback;
+        if (!allowed.includes(value))
+            throw new common_1.BadRequestException(`Expected one of ${allowed.join(", ")}, received "${value}"`);
+        return value;
+    }
+    _range(from, to) {
+        const toDate = to ? new Date(to) : new Date();
+        if (Number.isNaN(toDate.getTime()))
+            throw new common_1.BadRequestException("`to` is not a valid date");
+        const fromDate = from ? new Date(from) : new Date(toDate.getTime() - DEFAULT_WINDOW_DAYS * ONE_DAY_MS);
+        if (Number.isNaN(fromDate.getTime()))
+            throw new common_1.BadRequestException("`from` is not a valid date");
+        if (fromDate > toDate)
+            throw new common_1.BadRequestException("`from` must not be later than `to`");
+        if (toDate.getTime() - fromDate.getTime() > MAX_WINDOW_DAYS * ONE_DAY_MS)
+            throw new common_1.BadRequestException(`The range must not exceed ${MAX_WINDOW_DAYS} days`);
+        return { from: fromDate.toISOString(), to: toDate.toISOString() };
+    }
+};
+exports.AnalyticsAdminController = AnalyticsAdminController;
+__decorate([
+    (0, common_1.Get)(analytics_summary_meta_1.analyticsSummaryMeta.endpoint),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)("from")),
+    __param(2, (0, common_1.Query)("to")),
+    __param(3, (0, common_1.Query)("section")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String]),
+    __metadata("design:returntype", Promise)
+], AnalyticsAdminController.prototype, "getSummary", null);
+__decorate([
+    (0, common_1.Get)(analytics_timeline_meta_1.analyticsTimelineMeta.endpoint),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)("from")),
+    __param(2, (0, common_1.Query)("to")),
+    __param(3, (0, common_1.Query)("section")),
+    __param(4, (0, common_1.Query)("granularity")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], AnalyticsAdminController.prototype, "getTimeline", null);
+__decorate([
+    (0, common_1.Get)(analytics_breakdown_meta_1.analyticsBreakdownMeta.endpoint),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)("from")),
+    __param(2, (0, common_1.Query)("to")),
+    __param(3, (0, common_1.Query)("section")),
+    __param(4, (0, common_1.Query)("dimension")),
+    __param(5, (0, common_1.Query)("limit")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], AnalyticsAdminController.prototype, "getBreakdown", null);
+__decorate([
+    (0, common_1.Get)(analytics_session_meta_1.analyticsSessionMeta.endpoint),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)()),
+    __param(2, (0, common_1.Query)("from")),
+    __param(3, (0, common_1.Query)("to")),
+    __param(4, (0, common_1.Query)("section")),
+    __param(5, (0, common_1.Query)("visitorId")),
+    __param(6, (0, common_1.Query)("userId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], AnalyticsAdminController.prototype, "getSessions", null);
+__decorate([
+    (0, common_1.Get)(`${analytics_session_meta_1.analyticsSessionMeta.endpoint}/:sessionId`),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    (0, audit_decorator_1.Audit)(analytics_session_meta_1.analyticsSessionMeta, "sessionId"),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Param)("sessionId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], AnalyticsAdminController.prototype, "getSession", null);
+__decorate([
+    (0, common_1.Get)(`${analytics_session_meta_1.analyticsSessionMeta.endpoint}/:sessionId/${analytics_page_view_meta_1.analyticsPageViewMeta.endpoint}`),
+    (0, roles_decorator_1.Roles)(system_roles_1.SystemRoles.Administrator),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Param)("sessionId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], AnalyticsAdminController.prototype, "getSessionPageViews", null);
+exports.AnalyticsAdminController = AnalyticsAdminController = __decorate([
+    (0, common_1.UseGuards)(jwt_auth_guard_1.JwtAuthGuard),
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [analytics_admin_service_1.AnalyticsAdminService,
+        audit_service_1.AuditService])
+], AnalyticsAdminController);
+//# sourceMappingURL=analytics.admin.controller.js.map

package/dist/foundations/analytics/controllers/analytics.admin.controller.js.map

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

package/dist/foundations/analytics/controllers/analytics.controller.d.ts

@@ -0,0 +1,29 @@
+import { FastifyRequest } from "fastify";
+import { AnalyticsEventPostDTO } from "../dtos/analytics-event.post.dto";
+import { AnalyticsService } from "../services/analytics.service";
+/**
+ * Public page-view beacon. Anonymous visitors are accepted; when a valid JWT is
+ * present OptionalJwtAuthGuard attaches the user so the session can be linked.
+ *
+ * The controller only enriches the DTO with the request-derived values
+ * (client IP, user agent, user id, receive time) and hands the job to
+ * AnalyticsService.track, which queues it and never throws. Raw IP and user
+ * agent travel only inside the queued job: the worker hashes / classifies them
+ * and nothing raw reaches Neo4j.
+ */
+export declare class AnalyticsController {
+    private readonly analyticsService;
+    constructor(analyticsService: AnalyticsService);
+    track(request: FastifyRequest & {
+        user?: {
+            userId?: string;
+        };
+    }, body: AnalyticsEventPostDTO): Promise<void>;
+    /**
+     * First comma-separated hop of X-Forwarded-For, trimmed; request.ip otherwise.
+     * Later hops are proxies and would split one visitor across several hashes.
+     */
+    private _clientIp;
+    private _header;
+}
+//# sourceMappingURL=analytics.controller.d.ts.map

package/dist/foundations/analytics/controllers/analytics.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/controllers/analytics.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;;;;;;;;GASG;AACH,qBACa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAAhB,gBAAgB,EAAE,gBAAgB;IAMzD,KAAK,CACF,OAAO,EAAE,cAAc,GAAG;QAAE,IAAI,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EACvD,IAAI,EAAE,qBAAqB,GAClC,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,OAAO;CAGhB"}

package/dist/foundations/analytics/controllers/analytics.controller.js

@@ -0,0 +1,85 @@
+"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.AnalyticsController = void 0;
+const common_1 = require("@nestjs/common");
+const throttler_1 = require("@nestjs/throttler");
+const jwt_auth_optional_guard_1 = require("../../../common/guards/jwt.auth.optional.guard");
+const analytics_event_post_dto_1 = require("../dtos/analytics-event.post.dto");
+const analytics_event_meta_1 = require("../entities/analytics-event.meta");
+const analytics_service_1 = require("../services/analytics.service");
+/**
+ * Public page-view beacon. Anonymous visitors are accepted; when a valid JWT is
+ * present OptionalJwtAuthGuard attaches the user so the session can be linked.
+ *
+ * The controller only enriches the DTO with the request-derived values
+ * (client IP, user agent, user id, receive time) and hands the job to
+ * AnalyticsService.track, which queues it and never throws. Raw IP and user
+ * agent travel only inside the queued job: the worker hashes / classifies them
+ * and nothing raw reaches Neo4j.
+ */
+let AnalyticsController = class AnalyticsController {
+    constructor(analyticsService) {
+        this.analyticsService = analyticsService;
+    }
+    async track(request, body) {
+        const attributes = body.data.attributes;
+        const input = {
+            path: attributes.path,
+            section: attributes.section,
+            referrer: attributes.referrer,
+            utmSource: attributes.utmSource,
+            utmMedium: attributes.utmMedium,
+            utmCampaign: attributes.utmCampaign,
+            utmTerm: attributes.utmTerm,
+            utmContent: attributes.utmContent,
+            visitorId: attributes.visitorId,
+            screenWidth: attributes.screenWidth,
+            clientIp: this._clientIp(request),
+            userAgent: this._header(request.headers["user-agent"]) ?? "",
+            userId: request.user?.userId,
+            receivedAt: new Date().toISOString(),
+        };
+        await this.analyticsService.track(input);
+    }
+    /**
+     * First comma-separated hop of X-Forwarded-For, trimmed; request.ip otherwise.
+     * Later hops are proxies and would split one visitor across several hashes.
+     */
+    _clientIp(request) {
+        const forwarded = this._header(request.headers["x-forwarded-for"]);
+        const firstHop = forwarded?.split(",")[0]?.trim();
+        return firstHop || request.ip;
+    }
+    _header(value) {
+        return Array.isArray(value) ? value[0] : value;
+    }
+};
+exports.AnalyticsController = AnalyticsController;
+__decorate([
+    (0, common_1.Post)(analytics_event_meta_1.analyticsEventMeta.endpoint),
+    (0, common_1.UseGuards)(jwt_auth_optional_guard_1.OptionalJwtAuthGuard),
+    (0, throttler_1.Throttle)({ default: { limit: 60, ttl: 60000 }, ip: { limit: 60, ttl: 60000 } }),
+    (0, common_1.HttpCode)(common_1.HttpStatus.ACCEPTED),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, analytics_event_post_dto_1.AnalyticsEventPostDTO]),
+    __metadata("design:returntype", Promise)
+], AnalyticsController.prototype, "track", null);
+exports.AnalyticsController = AnalyticsController = __decorate([
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [analytics_service_1.AnalyticsService])
+], AnalyticsController);
+//# sourceMappingURL=analytics.controller.js.map

package/dist/foundations/analytics/controllers/analytics.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.controller.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/controllers/analytics.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8F;AAC9F,iDAA6C;AAE7C,4FAAsF;AACtF,+EAAyE;AACzE,2EAAsE;AAEtE,qEAAiE;AAEjE;;;;;;;;;GASG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,YAA6B,gBAAkC;QAAlC,qBAAgB,GAAhB,gBAAgB,CAAkB;IAAG,CAAC;IAM7D,AAAN,KAAK,CAAC,KAAK,CACF,OAAwD,EACvD,IAA2B;QAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;QAExC,MAAM,KAAK,GAA2B;YACpC,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE;YAC5D,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM;YAC5B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QAEF,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACK,SAAS,CAAC,OAAuB;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAClD,OAAO,QAAQ,IAAI,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;IAEO,OAAO,CAAC,KAAoC;QAClD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjD,CAAC;CACF,CAAA;AA9CY,kDAAmB;AAOxB;IAJL,IAAA,aAAI,EAAC,yCAAkB,CAAC,QAAQ,CAAC;IACjC,IAAA,kBAAS,EAAC,8CAAoB,CAAC;IAC/B,IAAA,oBAAQ,EAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;IAC/E,IAAA,iBAAQ,EAAC,mBAAU,CAAC,QAAQ,CAAC;IAE3B,WAAA,IAAA,YAAG,GAAE,CAAA;IACL,WAAA,IAAA,aAAI,GAAE,CAAA;;6CAAO,gDAAqB;;gDAsBpC;8BA/BU,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;qCAEoC,oCAAgB;GADpD,mBAAmB,CA8C/B"}

package/dist/foundations/analytics/cron/analytics-retention.cron.d.ts

@@ -0,0 +1,13 @@
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { AnalyticsDailySummaryRepository } from "../repositories/analytics-daily-summary.repository";
+import { AnalyticsSessionRepository } from "../repositories/analytics-session.repository";
+import { AnalyticsAdminService } from "../services/analytics.admin.service";
+export declare class AnalyticsRetentionCron {
+    private readonly analyticsSessionRepository;
+    private readonly analyticsDailySummaryRepository;
+    private readonly analyticsAdminService;
+    private readonly logger;
+    constructor(analyticsSessionRepository: AnalyticsSessionRepository, analyticsDailySummaryRepository: AnalyticsDailySummaryRepository, analyticsAdminService: AnalyticsAdminService, logger: AppLoggingService);
+    run(): Promise<void>;
+}
+//# sourceMappingURL=analytics-retention.cron.d.ts.map

package/dist/foundations/analytics/cron/analytics-retention.cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-retention.cron.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/cron/analytics-retention.cron.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,+BAA+B,EAAE,MAAM,oDAAoD,CAAC;AACrG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAK5E,qBACa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAC3C,OAAO,CAAC,QAAQ,CAAC,+BAA+B;IAChD,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,0BAA0B,EAAE,0BAA0B,EACtD,+BAA+B,EAAE,+BAA+B,EAChE,qBAAqB,EAAE,qBAAqB,EAC5C,MAAM,EAAE,iBAAiB;IAItC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyB3B"}

package/dist/foundations/analytics/cron/analytics-retention.cron.js

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsRetentionCron = void 0;
+const common_1 = require("@nestjs/common");
+const schedule_1 = require("@nestjs/schedule");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const analytics_daily_summary_repository_1 = require("../repositories/analytics-daily-summary.repository");
+const analytics_session_repository_1 = require("../repositories/analytics-session.repository");
+const analytics_admin_service_1 = require("../services/analytics.admin.service");
+/** Maximum calendar days drained per run, so a backlog empties over a month. */
+const MAX_DAYS_PER_RUN = 31;
+let AnalyticsRetentionCron = class AnalyticsRetentionCron {
+    constructor(analyticsSessionRepository, analyticsDailySummaryRepository, analyticsAdminService, logger) {
+        this.analyticsSessionRepository = analyticsSessionRepository;
+        this.analyticsDailySummaryRepository = analyticsDailySummaryRepository;
+        this.analyticsAdminService = analyticsAdminService;
+        this.logger = logger;
+    }
+    async run() {
+        const expiredDays = await this.analyticsSessionRepository.findExpiredDays({
+            cutoff: this.analyticsAdminService.retentionCutoff(),
+            limit: MAX_DAYS_PER_RUN,
+        });
+        for (const date of expiredDays) {
+            try {
+                const summaryRows = await this.analyticsDailySummaryRepository.rollupDay({ date });
+                const deleted = await this.analyticsSessionRepository.deleteDay({ date });
+                this.logger.log(`Analytics day ${date}: ${summaryRows} summary rows written, ${deleted.sessions} sessions and ${deleted.pageViews} page views deleted`, "AnalyticsRetentionCron");
+            }
+            catch (error) {
+                this.logger.error(`Failed to roll up and delete analytics day ${date}: ${error.message}`, "AnalyticsRetentionCron");
+            }
+        }
+        const unlinked = await this.analyticsSessionRepository.unlinkDeletedUsers();
+        this.logger.log(`Analytics sessions unlinked from deleted users: ${unlinked}`, "AnalyticsRetentionCron");
+    }
+};
+exports.AnalyticsRetentionCron = AnalyticsRetentionCron;
+__decorate([
+    (0, schedule_1.Cron)("0 3 * * *"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AnalyticsRetentionCron.prototype, "run", null);
+exports.AnalyticsRetentionCron = AnalyticsRetentionCron = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [analytics_session_repository_1.AnalyticsSessionRepository,
+        analytics_daily_summary_repository_1.AnalyticsDailySummaryRepository,
+        analytics_admin_service_1.AnalyticsAdminService,
+        logging_service_1.AppLoggingService])
+], AnalyticsRetentionCron);
+//# sourceMappingURL=analytics-retention.cron.js.map

package/dist/foundations/analytics/cron/analytics-retention.cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-retention.cron.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/cron/analytics-retention.cron.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,+CAAwC;AACxC,oFAAmF;AACnF,2GAAqG;AACrG,+FAA0F;AAC1F,iFAA4E;AAE5E,gFAAgF;AAChF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAGrB,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IACjC,YACmB,0BAAsD,EACtD,+BAAgE,EAChE,qBAA4C,EAC5C,MAAyB;QAHzB,+BAA0B,GAA1B,0BAA0B,CAA4B;QACtD,oCAA+B,GAA/B,+BAA+B,CAAiC;QAChE,0BAAqB,GAArB,qBAAqB,CAAuB;QAC5C,WAAM,GAAN,MAAM,CAAmB;IACzC,CAAC;IAGE,AAAN,KAAK,CAAC,GAAG;QACP,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,eAAe,CAAC;YACxE,MAAM,EAAE,IAAI,CAAC,qBAAqB,CAAC,eAAe,EAAE;YACpD,KAAK,EAAE,gBAAgB;SACxB,CAAC,CAAC;QAEH,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,+BAA+B,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,iBAAiB,IAAI,KAAK,WAAW,0BAA0B,OAAO,CAAC,QAAQ,iBAAiB,OAAO,CAAC,SAAS,qBAAqB,EACtI,wBAAwB,CACzB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,8CAA8C,IAAI,KAAM,KAAe,CAAC,OAAO,EAAE,EACjF,wBAAwB,CACzB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,0BAA0B,CAAC,kBAAkB,EAAE,CAAC;QAC5E,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mDAAmD,QAAQ,EAAE,EAAE,wBAAwB,CAAC,CAAC;IAC3G,CAAC;CACF,CAAA;AAlCY,wDAAsB;AAS3B;IADL,IAAA,eAAI,EAAC,WAAW,CAAC;;;;iDAyBjB;iCAjCU,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAGoC,yDAA0B;QACrB,oEAA+B;QACzC,+CAAqB;QACpC,mCAAiB;GALjC,sBAAsB,CAkClC"}

package/dist/foundations/analytics/dtos/analytics-event.post.dto.d.ts

@@ -0,0 +1,21 @@
+export declare class AnalyticsEventPostAttributesDTO {
+    path: string;
+    section: "public" | "app";
+    referrer?: string;
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    utmTerm?: string;
+    utmContent?: string;
+    visitorId?: string;
+    screenWidth?: number;
+}
+export declare class AnalyticsEventPostDataDTO {
+    type: string;
+    id?: string;
+    attributes: AnalyticsEventPostAttributesDTO;
+}
+export declare class AnalyticsEventPostDTO {
+    data: AnalyticsEventPostDataDTO;
+}
+//# sourceMappingURL=analytics-event.post.dto.d.ts.map

package/dist/foundations/analytics/dtos/analytics-event.post.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-event.post.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/dtos/analytics-event.post.dto.ts"],"names":[],"mappings":"AAgBA,qBAAa,+BAA+B;IAK1C,IAAI,EAAE,MAAM,CAAC;IAIb,OAAO,EAAE,QAAQ,GAAG,KAAK,CAAC;IAK1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAKjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAIpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,yBAAyB;IAEpC,IAAI,EAAE,MAAM,CAAC;IAIb,EAAE,CAAC,EAAE,MAAM,CAAC;IAKZ,UAAU,EAAE,+BAA+B,CAAC;CAC7C;AAED,qBAAa,qBAAqB;IAIhC,IAAI,EAAE,yBAAyB,CAAC;CACjC"}

package/dist/foundations/analytics/dtos/analytics-event.post.dto.js

@@ -0,0 +1,105 @@
+"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.AnalyticsEventPostDTO = exports.AnalyticsEventPostDataDTO = exports.AnalyticsEventPostAttributesDTO = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const analytics_event_meta_1 = require("../entities/analytics-event.meta");
+class AnalyticsEventPostAttributesDTO {
+}
+exports.AnalyticsEventPostAttributesDTO = AnalyticsEventPostAttributesDTO;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2048),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsIn)(["public", "app"]),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "section", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2048),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "referrer", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "utmSource", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "utmMedium", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "utmCampaign", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "utmTerm", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "utmContent", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], AnalyticsEventPostAttributesDTO.prototype, "visitorId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], AnalyticsEventPostAttributesDTO.prototype, "screenWidth", void 0);
+class AnalyticsEventPostDataDTO {
+}
+exports.AnalyticsEventPostDataDTO = AnalyticsEventPostDataDTO;
+__decorate([
+    (0, class_validator_1.Equals)(analytics_event_meta_1.analyticsEventMeta.type),
+    __metadata("design:type", String)
+], AnalyticsEventPostDataDTO.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], AnalyticsEventPostDataDTO.prototype, "id", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_transformer_1.Type)(() => AnalyticsEventPostAttributesDTO),
+    __metadata("design:type", AnalyticsEventPostAttributesDTO)
+], AnalyticsEventPostDataDTO.prototype, "attributes", void 0);
+class AnalyticsEventPostDTO {
+}
+exports.AnalyticsEventPostDTO = AnalyticsEventPostDTO;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsDefined)(),
+    (0, class_transformer_1.Type)(() => AnalyticsEventPostDataDTO),
+    __metadata("design:type", AnalyticsEventPostDataDTO)
+], AnalyticsEventPostDTO.prototype, "data", void 0);
+//# sourceMappingURL=analytics-event.post.dto.js.map

package/dist/foundations/analytics/dtos/analytics-event.post.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-event.post.dto.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/dtos/analytics-event.post.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAYyB;AACzB,2EAAsE;AAEtE,MAAa,+BAA+B;CAiD3C;AAjDD,0EAiDC;AA5CC;IAJC,IAAA,2BAAS,GAAE;IACX,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,IAAI,CAAC;;6DACH;AAIb;IAFC,IAAA,2BAAS,GAAE;IACX,IAAA,sBAAI,EAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;;gEACE;AAK1B;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,IAAI,CAAC;;iEACE;AAKlB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;kEACI;AAKnB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;kEACI;AAKnB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;oEACM;AAKrB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;gEACE;AAKjB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;mEACK;AAIpB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,GAAE;;kEACU;AAKnB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAG,EAAC,CAAC,CAAC;;oEACc;AAGvB,MAAa,yBAAyB;CAYrC;AAZD,8DAYC;AAVC;IADC,IAAA,wBAAM,EAAC,yCAAkB,CAAC,IAAI,CAAC;;uDACnB;AAIb;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,GAAE;;qDACG;AAKZ;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,2BAAS,GAAE;IACX,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,+BAA+B,CAAC;8BAChC,+BAA+B;6DAAC;AAG9C,MAAa,qBAAqB;CAKjC;AALD,sDAKC;AADC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,2BAAS,GAAE;IACX,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC;8BAChC,yBAAyB;mDAAC"}

package/dist/foundations/analytics/entities/analytics-breakdown.d.ts

@@ -0,0 +1,17 @@
+import { Entity } from "../../../common/abstracts/entity";
+/**
+ * One (dimension, key) row of the admin breakdown tables: traffic grouped by
+ * source, medium, campaign, referrer, route or landing route.
+ *
+ * NOT a Neo4j node — serialisation shape only (see the summary descriptor).
+ */
+export type AnalyticsBreakdownEntity = Entity & {
+    dimension: string;
+    key: string;
+    visitors: number;
+    sessions: number;
+    pageViews: number;
+};
+export declare const AnalyticsBreakdownDescriptor: import("../../..").EntityDescriptor<AnalyticsBreakdownEntity, {}>;
+export type AnalyticsBreakdownDescriptorType = typeof AnalyticsBreakdownDescriptor;
+//# sourceMappingURL=analytics-breakdown.d.ts.map

package/dist/foundations/analytics/entities/analytics-breakdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-breakdown.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-breakdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,4BAA4B,mEAcvC,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG,OAAO,4BAA4B,CAAC"}

package/dist/foundations/analytics/entities/analytics-breakdown.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsBreakdownDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const analytics_breakdown_meta_1 = require("./analytics-breakdown.meta");
+exports.AnalyticsBreakdownDescriptor = (0, define_entity_1.defineEntity)()({
+    ...analytics_breakdown_meta_1.analyticsBreakdownMeta,
+    isCompanyScoped: false,
+    fields: {
+        dimension: { type: "string", required: true },
+        key: { type: "string", required: true },
+        visitors: { type: "number", required: true },
+        sessions: { type: "number", required: true },
+        pageViews: { type: "number", required: true },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=analytics-breakdown.js.map

package/dist/foundations/analytics/entities/analytics-breakdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-breakdown.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-breakdown.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,yEAAoE;AAgBvD,QAAA,4BAA4B,GAAG,IAAA,4BAAY,GAA4B,CAAC;IACnF,GAAG,iDAAsB;IAEzB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACvC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC9C;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/analytics/entities/analytics-breakdown.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const analyticsBreakdownMeta: DataMeta;
+//# sourceMappingURL=analytics-breakdown.meta.d.ts.map

package/dist/foundations/analytics/entities/analytics-breakdown.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-breakdown.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-breakdown.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,sBAAsB,EAAE,QAKpC,CAAC"}

package/dist/foundations/analytics/entities/analytics-breakdown.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsBreakdownMeta = void 0;
+exports.analyticsBreakdownMeta = {
+    type: "analytics-breakdowns",
+    endpoint: "analytics/administration/breakdown",
+    nodeName: "analyticsBreakdown",
+    labelName: "AnalyticsBreakdown",
+};
+//# sourceMappingURL=analytics-breakdown.meta.js.map

package/dist/foundations/analytics/entities/analytics-breakdown.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-breakdown.meta.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-breakdown.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAa;IAC9C,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,oCAAoC;IAC9C,QAAQ,EAAE,oBAAoB;IAC9B,SAAS,EAAE,oBAAoB;CAChC,CAAC"}