@carlonicora/nestjs-neo4jsonapi 4.14.0 → 4.15.0

package/dist/foundations/analytics/entities/analytics-daily-summary.d.ts

@@ -0,0 +1,30 @@
+import { Entity } from "../../../common/abstracts/entity";
+/**
+ * AnalyticsDailySummary Entity Type
+ *
+ * One (date, section, dimension, key) roll-up row, produced by the retention job
+ * before a day's raw sessions and page views are deleted. `id` is
+ * `${date}|${section}|${dimension}|${key}`; `dimension` is `total`, `source`,
+ * `medium`, `campaign`, `referrer`, `route` or `landing`; `key` is the empty
+ * string for `total`.
+ */
+export type AnalyticsDailySummary = Entity & {
+    date: string;
+    section: string;
+    dimension: string;
+    key: string;
+    visitors: number;
+    sessions: number;
+    pageViews: number;
+};
+/**
+ * AnalyticsDailySummary Entity Descriptor
+ *
+ * Platform-level: no BELONGS_TO Company edge.
+ *
+ * `date` is a calendar day with no time component, so it is `type: "date"` —
+ * never `"string"`. See references/date-handling.md rule 1.
+ */
+export declare const AnalyticsDailySummaryDescriptor: import("../../..").EntityDescriptor<AnalyticsDailySummary, {}>;
+export type AnalyticsDailySummaryDescriptorType = typeof AnalyticsDailySummaryDescriptor;
+//# sourceMappingURL=analytics-daily-summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-daily-summary.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-daily-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,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;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,gEAgB1C,CAAC;AAEH,MAAM,MAAM,mCAAmC,GAAG,OAAO,+BAA+B,CAAC"}

package/dist/foundations/analytics/entities/analytics-daily-summary.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsDailySummaryDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const analytics_daily_summary_meta_1 = require("./analytics-daily-summary.meta");
+/**
+ * AnalyticsDailySummary Entity Descriptor
+ *
+ * Platform-level: no BELONGS_TO Company edge.
+ *
+ * `date` is a calendar day with no time component, so it is `type: "date"` —
+ * never `"string"`. See references/date-handling.md rule 1.
+ */
+exports.AnalyticsDailySummaryDescriptor = (0, define_entity_1.defineEntity)()({
+    ...analytics_daily_summary_meta_1.analyticsDailySummaryMeta,
+    isCompanyScoped: false,
+    fields: {
+        date: { type: "date", required: true },
+        section: { type: "string", required: true },
+        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-daily-summary.js.map

package/dist/foundations/analytics/entities/analytics-daily-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-daily-summary.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-daily-summary.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,iFAA2E;AAqB3E;;;;;;;GAOG;AACU,QAAA,+BAA+B,GAAG,IAAA,4BAAY,GAAyB,CAAC;IACnF,GAAG,wDAAyB;IAE5B,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,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-daily-summary.meta.d.ts

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

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

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

package/dist/foundations/analytics/entities/analytics-daily-summary.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsDailySummaryMeta = void 0;
+exports.analyticsDailySummaryMeta = {
+    type: "analytics-daily-summaries",
+    endpoint: "analytics/summaries",
+    nodeName: "analyticsDailySummary",
+    labelName: "AnalyticsDailySummary",
+};
+//# sourceMappingURL=analytics-daily-summary.meta.js.map

package/dist/foundations/analytics/entities/analytics-daily-summary.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-daily-summary.meta.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-daily-summary.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,yBAAyB,GAAa;IACjD,IAAI,EAAE,2BAA2B;IACjC,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ,EAAE,uBAAuB;IACjC,SAAS,EAAE,uBAAuB;CACnC,CAAC"}

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

@@ -0,0 +1,8 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+/**
+ * Write-only resource posted by the client tracker. There is no AnalyticsEvent
+ * node and no descriptor: the meta only supplies the JSON:API `type` checked by
+ * `AnalyticsEventPostDTO` and the public `endpoint` of `AnalyticsController`.
+ */
+export declare const analyticsEventMeta: DataMeta;
+//# sourceMappingURL=analytics-event.meta.d.ts.map

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

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

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsEventMeta = void 0;
+/**
+ * Write-only resource posted by the client tracker. There is no AnalyticsEvent
+ * node and no descriptor: the meta only supplies the JSON:API `type` checked by
+ * `AnalyticsEventPostDTO` and the public `endpoint` of `AnalyticsController`.
+ */
+exports.analyticsEventMeta = {
+    type: "analytics-events",
+    endpoint: "analytics/events",
+    nodeName: "analyticsEvent",
+    labelName: "AnalyticsEvent",
+};
+//# sourceMappingURL=analytics-event.meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-event.meta.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-event.meta.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACU,QAAA,kBAAkB,GAAa;IAC1C,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,gBAAgB;CAC5B,CAAC"}

package/dist/foundations/analytics/entities/analytics-page-view.d.ts

@@ -0,0 +1,39 @@
+import { Entity } from "../../../common/abstracts/entity";
+import { AnalyticsSession } from "./analytics-session";
+/**
+ * AnalyticsPageView Entity Type
+ *
+ * One route change inside a session. `path` is the pathname as visited (no
+ * query string, no hash); `route` is `path` with UUID segments replaced by
+ * `:id`, so pages can be grouped.
+ */
+export type AnalyticsPageView = Entity & {
+    createdAt: string;
+    path: string;
+    route: string;
+    section: string;
+    session?: AnalyticsSession;
+};
+/**
+ * AnalyticsPageView Entity Descriptor
+ *
+ * Platform-level: no BELONGS_TO Company edge. The graph shape is
+ * `(analyticsPageView)-[:IN_SESSION]->(analyticsSession)`. The resource is only
+ * served nested under a session:
+ * `${analyticsSessionMeta.endpoint}/:sessionId/${analyticsPageViewMeta.endpoint}`.
+ *
+ * `createdAt` is an instant, so `type: "datetime"`. See
+ * references/date-handling.md rule 2.
+ */
+export declare const AnalyticsPageViewDescriptor: import("../../..").EntityDescriptor<AnalyticsPageView, {
+    session: {
+        model: import("../../..").DataMeta;
+        direction: "out";
+        relationship: string;
+        cardinality: "one";
+        required: true;
+        dtoKey: string;
+    };
+}>;
+export type AnalyticsPageViewDescriptorType = typeof AnalyticsPageViewDescriptor;
+//# sourceMappingURL=analytics-page-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-page-view.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-page-view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;EAsBtC,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,OAAO,2BAA2B,CAAC"}

package/dist/foundations/analytics/entities/analytics-page-view.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsPageViewDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const analytics_page_view_meta_1 = require("./analytics-page-view.meta");
+const analytics_session_meta_1 = require("./analytics-session.meta");
+/**
+ * AnalyticsPageView Entity Descriptor
+ *
+ * Platform-level: no BELONGS_TO Company edge. The graph shape is
+ * `(analyticsPageView)-[:IN_SESSION]->(analyticsSession)`. The resource is only
+ * served nested under a session:
+ * `${analyticsSessionMeta.endpoint}/:sessionId/${analyticsPageViewMeta.endpoint}`.
+ *
+ * `createdAt` is an instant, so `type: "datetime"`. See
+ * references/date-handling.md rule 2.
+ */
+exports.AnalyticsPageViewDescriptor = (0, define_entity_1.defineEntity)()({
+    ...analytics_page_view_meta_1.analyticsPageViewMeta,
+    isCompanyScoped: false,
+    fields: {
+        createdAt: { type: "datetime", required: true },
+        path: { type: "string", required: true },
+        route: { type: "string", required: true },
+        section: { type: "string", required: true },
+    },
+    relationships: {
+        session: {
+            model: analytics_session_meta_1.analyticsSessionMeta,
+            direction: "out",
+            relationship: "IN_SESSION",
+            cardinality: "one",
+            required: true,
+            dtoKey: "session",
+        },
+    },
+});
+//# sourceMappingURL=analytics-page-view.js.map

package/dist/foundations/analytics/entities/analytics-page-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-page-view.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-page-view.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AAErE,yEAAmE;AACnE,qEAAgE;AAkBhE;;;;;;;;;;GAUG;AACU,QAAA,2BAA2B,GAAG,IAAA,4BAAY,GAAqB,CAAC;IAC3E,GAAG,gDAAqB;IAExB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC5C;IAED,aAAa,EAAE;QACb,OAAO,EAAE;YACP,KAAK,EAAE,6CAAoB;YAC3B,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,SAAS;SAClB;KACF;CACF,CAAC,CAAC"}

package/dist/foundations/analytics/entities/analytics-page-view.meta.d.ts

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

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

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

package/dist/foundations/analytics/entities/analytics-page-view.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsPageViewMeta = void 0;
+exports.analyticsPageViewMeta = {
+    type: "analytics-pageviews",
+    endpoint: "pageviews",
+    nodeName: "analyticsPageView",
+    labelName: "AnalyticsPageView",
+};
+//# sourceMappingURL=analytics-page-view.meta.js.map

package/dist/foundations/analytics/entities/analytics-page-view.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-page-view.meta.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-page-view.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,qBAAqB,GAAa;IAC7C,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,mBAAmB;CAC/B,CAAC"}

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

@@ -0,0 +1,52 @@
+import { Entity } from "../../../common/abstracts/entity";
+import { User } from "../../user/entities/user";
+/**
+ * AnalyticsSession Entity Type
+ *
+ * One visit: consecutive page views from the same visitor id with no gap longer
+ * than the session timeout. Attribution (landing route, referrer host, UTM) is
+ * taken from the first page view and never overwritten.
+ *
+ * `visitorId` is `c:<uuid>` when it came from the consent cookie (`consented`
+ * is then true) or `d:<sha256>` for the daily salted hash. Raw IP and raw user
+ * agent are never stored; `deviceType` is the only user-agent derivative.
+ */
+export type AnalyticsSession = Entity & {
+    visitorId: string;
+    consented: boolean;
+    startedAt: string;
+    lastSeenAt: string;
+    pageViews: number;
+    section: string;
+    landingRoute: string;
+    referrerHost?: string;
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    utmTerm?: string;
+    utmContent?: string;
+    deviceType: string;
+    user?: User;
+};
+/**
+ * AnalyticsSession Entity Descriptor
+ *
+ * Platform-level: no BELONGS_TO Company edge. Written by
+ * `AnalyticsSessionRepository.recordPageView()` from the BullMQ worker, outside
+ * HTTP/CLS context, and read only from the administration routes.
+ *
+ * `startedAt` / `lastSeenAt` are instants, so `type: "datetime"` — never
+ * `"string"`. See references/date-handling.md rule 2.
+ */
+export declare const AnalyticsSessionDescriptor: import("../../..").EntityDescriptor<AnalyticsSession, {
+    user: {
+        model: import("../../..").DataMeta;
+        direction: "out";
+        relationship: string;
+        cardinality: "one";
+        required: false;
+        dtoKey: string;
+    };
+}>;
+export type AnalyticsSessionDescriptorType = typeof AnalyticsSessionDescriptor;
+//# sourceMappingURL=analytics-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-session.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAIhD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,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,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;EAgCrC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,OAAO,0BAA0B,CAAC"}

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsSessionDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const user_meta_1 = require("../../user/entities/user.meta");
+const analytics_session_meta_1 = require("./analytics-session.meta");
+/**
+ * AnalyticsSession Entity Descriptor
+ *
+ * Platform-level: no BELONGS_TO Company edge. Written by
+ * `AnalyticsSessionRepository.recordPageView()` from the BullMQ worker, outside
+ * HTTP/CLS context, and read only from the administration routes.
+ *
+ * `startedAt` / `lastSeenAt` are instants, so `type: "datetime"` — never
+ * `"string"`. See references/date-handling.md rule 2.
+ */
+exports.AnalyticsSessionDescriptor = (0, define_entity_1.defineEntity)()({
+    ...analytics_session_meta_1.analyticsSessionMeta,
+    isCompanyScoped: false,
+    fields: {
+        visitorId: { type: "string", required: true },
+        consented: { type: "boolean", required: true },
+        startedAt: { type: "datetime", required: true },
+        lastSeenAt: { type: "datetime", required: true },
+        pageViews: { type: "number", required: true },
+        section: { type: "string", required: true },
+        landingRoute: { type: "string", required: true },
+        referrerHost: { type: "string" },
+        utmSource: { type: "string" },
+        utmMedium: { type: "string" },
+        utmCampaign: { type: "string" },
+        utmTerm: { type: "string" },
+        utmContent: { type: "string" },
+        deviceType: { type: "string", required: true },
+    },
+    relationships: {
+        user: {
+            model: user_meta_1.userMeta,
+            direction: "out",
+            relationship: "BY_USER",
+            cardinality: "one",
+            required: false,
+            dtoKey: "user",
+        },
+    },
+});
+//# sourceMappingURL=analytics-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-session.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-session.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AAErE,6DAAyD;AACzD,qEAAgE;AAgChE;;;;;;;;;GASG;AACU,QAAA,0BAA0B,GAAG,IAAA,4BAAY,GAAoB,CAAC;IACzE,GAAG,6CAAoB;IAEvB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC9C,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC7C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC/C;IAED,aAAa,EAAE;QACb,IAAI,EAAE;YACJ,KAAK,EAAE,oBAAQ;YACf,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,SAAS;YACvB,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;SACf;KACF;CACF,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsSessionMeta = void 0;
+exports.analyticsSessionMeta = {
+    type: "analytics-sessions",
+    endpoint: "analytics/administration/sessions",
+    nodeName: "analyticsSession",
+    labelName: "AnalyticsSession",
+};
+//# sourceMappingURL=analytics-session.meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-session.meta.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-session.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAa;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,mCAAmC;IAC7C,QAAQ,EAAE,kBAAkB;IAC5B,SAAS,EAAE,kBAAkB;CAC9B,CAAC"}

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

@@ -0,0 +1,24 @@
+import { Entity } from "../../../common/abstracts/entity";
+/**
+ * One row of the admin summary: a section observed over one time window.
+ *
+ * Six rows are returned per request — section ("public" | "app" | "total")
+ * crossed with window ("current" | "previous") — which is what lets the KPI
+ * tiles render both the value and its delta without a second call.
+ *
+ * NOT a Neo4j node: there is no AnalyticsSummary label and no repository for
+ * this descriptor. It is a serialisation shape only, exactly like
+ * `TokenUsageAdminSummaryDescriptor`.
+ */
+export type AnalyticsSummaryEntity = Entity & {
+    section: string;
+    window: string;
+    visitors: number;
+    sessions: number;
+    pageViews: number;
+    pagesPerSession: number;
+    consentShare: number;
+};
+export declare const AnalyticsSummaryDescriptor: import("../../..").EntityDescriptor<AnalyticsSummaryEntity, {}>;
+export type AnalyticsSummaryDescriptorType = typeof AnalyticsSummaryDescriptor;
+//# sourceMappingURL=analytics-summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-summary.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,0BAA0B,iEAgBrC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,OAAO,0BAA0B,CAAC"}

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsSummaryDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const analytics_summary_meta_1 = require("./analytics-summary.meta");
+exports.AnalyticsSummaryDescriptor = (0, define_entity_1.defineEntity)()({
+    ...analytics_summary_meta_1.analyticsSummaryMeta,
+    isCompanyScoped: false,
+    fields: {
+        section: { type: "string", required: true },
+        window: { type: "string", required: true },
+        visitors: { type: "number", required: true },
+        sessions: { type: "number", required: true },
+        pageViews: { type: "number", required: true },
+        pagesPerSession: { type: "number", required: true },
+        consentShare: { type: "number", required: true },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=analytics-summary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-summary.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-summary.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,qEAAgE;AAuBnD,QAAA,0BAA0B,GAAG,IAAA,4BAAY,GAA0B,CAAC;IAC/E,GAAG,6CAAoB;IAEvB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC1C,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;QAC7C,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnD,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;KACjD;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsSummaryMeta = void 0;
+exports.analyticsSummaryMeta = {
+    type: "analytics-summaries",
+    endpoint: "analytics/administration/summary",
+    nodeName: "analyticsSummary",
+    labelName: "AnalyticsSummary",
+};
+//# sourceMappingURL=analytics-summary.meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-summary.meta.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-summary.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAa;IAC5C,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,kCAAkC;IAC5C,QAAQ,EAAE,kBAAkB;IAC5B,SAAS,EAAE,kBAAkB;CAC9B,CAAC"}

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

@@ -0,0 +1,20 @@
+import { Entity } from "../../../common/abstracts/entity";
+/**
+ * One (bucket, section) cell of the traffic-over-time chart. Rows are flat; the
+ * frontend pivots them into series.
+ *
+ * `bucket` is a calendar day/week/month start with no time component, so it is
+ * `type: "date"` — never `"string"`. See references/date-handling.md rule 1.
+ *
+ * NOT a Neo4j node — serialisation shape only (see the summary descriptor).
+ */
+export type AnalyticsTimelineEntity = Entity & {
+    bucket: string;
+    section: string;
+    visitors: number;
+    sessions: number;
+    pageViews: number;
+};
+export declare const AnalyticsTimelineDescriptor: import("../../..").EntityDescriptor<AnalyticsTimelineEntity, {}>;
+export type AnalyticsTimelineDescriptorType = typeof AnalyticsTimelineDescriptor;
+//# sourceMappingURL=analytics-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-timeline.d.ts","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,2BAA2B,kEActC,CAAC;AAEH,MAAM,MAAM,+BAA+B,GAAG,OAAO,2BAA2B,CAAC"}

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsTimelineDescriptor = void 0;
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const analytics_timeline_meta_1 = require("./analytics-timeline.meta");
+exports.AnalyticsTimelineDescriptor = (0, define_entity_1.defineEntity)()({
+    ...analytics_timeline_meta_1.analyticsTimelineMeta,
+    isCompanyScoped: false,
+    fields: {
+        bucket: { type: "date", required: true },
+        section: { type: "string", required: true },
+        visitors: { type: "number", required: true },
+        sessions: { type: "number", required: true },
+        pageViews: { type: "number", required: true },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=analytics-timeline.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-timeline.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-timeline.ts"],"names":[],"mappings":";;;AACA,yEAAqE;AACrE,uEAAkE;AAmBrD,QAAA,2BAA2B,GAAG,IAAA,4BAAY,GAA2B,CAAC;IACjF,GAAG,+CAAqB;IAExB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,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-timeline.meta.d.ts

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

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

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

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsTimelineMeta = void 0;
+exports.analyticsTimelineMeta = {
+    type: "analytics-timelines",
+    endpoint: "analytics/administration/timeline",
+    nodeName: "analyticsTimeline",
+    labelName: "AnalyticsTimeline",
+};
+//# sourceMappingURL=analytics-timeline.meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-timeline.meta.js","sourceRoot":"","sources":["../../../../src/foundations/analytics/entities/analytics-timeline.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,qBAAqB,GAAa;IAC7C,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,mCAAmC;IAC7C,QAAQ,EAAE,mBAAmB;IAC7B,SAAS,EAAE,mBAAmB;CAC/B,CAAC"}

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

@@ -0,0 +1,27 @@
+export { AnalyticsModule } from "./analytics.module";
+export { AnalyticsSession, AnalyticsSessionDescriptor, AnalyticsSessionDescriptorType, } from "./entities/analytics-session";
+export { analyticsSessionMeta } from "./entities/analytics-session.meta";
+export { AnalyticsPageView, AnalyticsPageViewDescriptor, AnalyticsPageViewDescriptorType, } from "./entities/analytics-page-view";
+export { analyticsPageViewMeta } from "./entities/analytics-page-view.meta";
+export { AnalyticsDailySummary, AnalyticsDailySummaryDescriptor, AnalyticsDailySummaryDescriptorType, } from "./entities/analytics-daily-summary";
+export { analyticsDailySummaryMeta } from "./entities/analytics-daily-summary.meta";
+export { AnalyticsSummaryEntity, AnalyticsSummaryDescriptor, AnalyticsSummaryDescriptorType, } from "./entities/analytics-summary";
+export { analyticsSummaryMeta } from "./entities/analytics-summary.meta";
+export { AnalyticsTimelineEntity, AnalyticsTimelineDescriptor, AnalyticsTimelineDescriptorType, } from "./entities/analytics-timeline";
+export { analyticsTimelineMeta } from "./entities/analytics-timeline.meta";
+export { AnalyticsBreakdownEntity, AnalyticsBreakdownDescriptor, AnalyticsBreakdownDescriptorType, } from "./entities/analytics-breakdown";
+export { analyticsBreakdownMeta } from "./entities/analytics-breakdown.meta";
+export { analyticsEventMeta } from "./entities/analytics-event.meta";
+export { AnalyticsSessionRepository } from "./repositories/analytics-session.repository";
+export { AnalyticsPageViewRepository } from "./repositories/analytics-page-view.repository";
+export { AnalyticsDailySummaryRepository } from "./repositories/analytics-daily-summary.repository";
+export { AnalyticsAdminRepository } from "./repositories/analytics.admin.repository";
+export { AnalyticsVisitorIdService } from "./services/analytics.visitor-id.service";
+export { AnalyticsService } from "./services/analytics.service";
+export { AnalyticsAdminService } from "./services/analytics.admin.service";
+export { AnalyticsProcessor } from "./processors/analytics.processor";
+export { AnalyticsRetentionCron } from "./cron/analytics-retention.cron";
+export { AnalyticsPageViewInput } from "./interfaces/analytics.page-view.input";
+export { AnalyticsResolvedPageView } from "./interfaces/analytics.resolved-page-view";
+export { AnalyticsModuleConfig, ANALYTICS_CONFIG, ANALYTICS_QUEUE, DEFAULT_ANALYTICS_CONFIG, } from "./interfaces/analytics.config.interface";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,mCAAmC,GACpC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,gCAAgC,GACjC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,EAAE,+BAA+B,EAAE,MAAM,mDAAmD,CAAC;AACpG,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,GACzB,MAAM,yCAAyC,CAAC"}