@antelopejs/dms-marketing 0.2.2

package/dist/services/experiments/results.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeExperimentResults = computeExperimentResults;
+const compute_1 = require("@/services/funnels/compute");
+const assign_1 = require("./assign");
+const stats_1 = require("./stats");
+const MIXED = null;
+function variationBySession(events, experiment) {
+    const armKeys = new Set(experiment.variations.map((v) => v.key));
+    const assignments = new Map();
+    for (const event of events) {
+        if (event.kind !== "exposure" || event.name !== experiment.key) {
+            continue;
+        }
+        const variation = event.data
+            ?.variation;
+        if (typeof variation !== "string" || !armKeys.has(variation)) {
+            continue;
+        }
+        const existing = assignments.get(event.sessionId);
+        if (existing === undefined) {
+            assignments.set(event.sessionId, variation);
+        }
+        else if (existing !== MIXED && existing !== variation) {
+            assignments.set(event.sessionId, MIXED);
+        }
+    }
+    return assignments;
+}
+function computeExperimentResults(events, goal, experiment, truncated) {
+    const assignments = variationBySession(events, experiment);
+    const funnelEventsByArm = new Map();
+    for (const event of events) {
+        if (event.kind === "exposure") {
+            continue;
+        }
+        const arm = assignments.get(event.sessionId);
+        if (arm === undefined || arm === MIXED) {
+            continue;
+        }
+        const bucket = funnelEventsByArm.get(arm);
+        if (bucket) {
+            bucket.push(event);
+        }
+        else {
+            funnelEventsByArm.set(arm, [event]);
+        }
+    }
+    const exposedByArm = new Map();
+    for (const arm of assignments.values()) {
+        if (arm !== MIXED) {
+            exposedByArm.set(arm, (exposedByArm.get(arm) ?? 0) + 1);
+        }
+    }
+    const counts = experiment.variations.map((variation) => {
+        const computation = (0, compute_1.computeFunnelOverSessions)(goal, (0, compute_1.groupBySession)(funnelEventsByArm.get(variation.key) ?? []).values());
+        const lastStep = computation.steps[computation.steps.length - 1];
+        return {
+            key: variation.key,
+            exposed: exposedByArm.get(variation.key) ?? 0,
+            conversions: lastStep?.sessions ?? 0,
+            computation,
+        };
+    });
+    const control = counts[0];
+    const controlRate = control.exposed > 0 ? control.conversions / control.exposed : 0;
+    const variations = counts.map((arm, index) => {
+        const rate = arm.exposed > 0 ? arm.conversions / arm.exposed : 0;
+        const isControl = index === 0;
+        const test = isControl || truncated
+            ? { pValue: null, significant: null }
+            : (0, stats_1.twoProportionTest)(control.conversions, control.exposed, arm.conversions, arm.exposed);
+        return {
+            key: arm.key,
+            exposedSessions: arm.exposed,
+            computation: arm.computation,
+            conversionRate: rate,
+            uplift: isControl || controlRate === 0
+                ? null
+                : (rate - controlRate) / controlRate,
+            pValue: test.pValue,
+            significant: test.significant,
+        };
+    });
+    return {
+        control: control.key,
+        variations,
+        srm: (0, stats_1.sampleRatioCheck)(counts.map((arm) => arm.exposed), (0, assign_1.normalizedWeights)(experiment.variations)),
+    };
+}
+//# sourceMappingURL=results.js.map

package/dist/services/experiments/results.js.map

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

package/dist/services/experiments/stats.d.ts

@@ -0,0 +1,12 @@
+export interface ProportionTest {
+    pValue: number | null;
+    significant: boolean | null;
+}
+export interface SrmCheck {
+    expected: number[];
+    observed: number[];
+    pValue: number | null;
+    mismatch: boolean;
+}
+export declare function twoProportionTest(controlConversions: number, controlTotal: number, variantConversions: number, variantTotal: number): ProportionTest;
+export declare function sampleRatioCheck(observed: number[], proportions: number[]): SrmCheck;

package/dist/services/experiments/stats.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.twoProportionTest = twoProportionTest;
+exports.sampleRatioCheck = sampleRatioCheck;
+const constants_1 = require("@/types/constants");
+const NO_VERDICT = { pValue: null, significant: null };
+function erf(x) {
+    const sign = x < 0 ? -1 : 1;
+    const abs = Math.abs(x);
+    const t = 1 / (1 + 0.3275911 * abs);
+    const poly = t *
+        (0.254829592 +
+            t *
+                (-0.284496736 +
+                    t * (1.421413741 + t * (-1.453152027 + t * 1.061405429))));
+    return sign * (1 - poly * Math.exp(-abs * abs));
+}
+function normalCdf(x) {
+    return 0.5 * (1 + erf(x / Math.SQRT2));
+}
+function twoProportionTest(controlConversions, controlTotal, variantConversions, variantTotal) {
+    const cells = [
+        controlConversions,
+        controlTotal - controlConversions,
+        variantConversions,
+        variantTotal - variantConversions,
+    ];
+    if (cells.some((count) => count < constants_1.MIN_OUTCOMES_PER_CELL)) {
+        return NO_VERDICT;
+    }
+    const pooled = (controlConversions + variantConversions) / (controlTotal + variantTotal);
+    const standardError = Math.sqrt(pooled * (1 - pooled) * (1 / controlTotal + 1 / variantTotal));
+    if (standardError === 0) {
+        return NO_VERDICT;
+    }
+    const z = (variantConversions / variantTotal - controlConversions / controlTotal) /
+        standardError;
+    const pValue = 2 * (1 - normalCdf(Math.abs(z)));
+    return { pValue, significant: pValue < constants_1.EXPERIMENT_SIGNIFICANCE_LEVEL };
+}
+function chiSquareTail(chi2, degreesOfFreedom) {
+    const scaled = chi2 / degreesOfFreedom;
+    const mean = 1 - 2 / (9 * degreesOfFreedom);
+    const deviation = Math.sqrt(2 / (9 * degreesOfFreedom));
+    return 1 - normalCdf((Math.cbrt(scaled) - mean) / deviation);
+}
+function sampleRatioCheck(observed, proportions) {
+    const total = observed.reduce((sum, count) => sum + count, 0);
+    const expected = proportions.map((share) => total * share);
+    if (expected.some((count) => count < constants_1.MIN_OUTCOMES_PER_CELL)) {
+        return { expected, observed, pValue: null, mismatch: false };
+    }
+    const chi2 = observed.reduce((sum, count, i) => sum + (count - expected[i]) ** 2 / expected[i], 0);
+    const pValue = chiSquareTail(chi2, observed.length - 1);
+    return {
+        expected,
+        observed,
+        pValue,
+        mismatch: pValue < constants_1.EXPERIMENT_SRM_P_THRESHOLD,
+    };
+}
+//# sourceMappingURL=stats.js.map

package/dist/services/experiments/stats.js.map

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

package/dist/services/funnels/compute.d.ts

@@ -0,0 +1,15 @@
+import type { Funnel, FunnelStep } from "@/db/tables/funnels.table";
+import type { MarketingEvent } from "@/db/tables/marketing_events.table";
+export type FunnelDefinition = Pick<Funnel, "steps" | "conversionWindowMs">;
+export interface FunnelStepResult {
+    step: FunnelStep;
+    sessions: number;
+    conversionRate: number;
+}
+export interface FunnelComputation {
+    totalSessions: number;
+    steps: FunnelStepResult[];
+}
+export type FunnelEvent = Pick<MarketingEvent, "sessionId" | "kind" | "url" | "name" | "timestamp">;
+export declare function groupBySession<T extends Pick<MarketingEvent, "sessionId">>(events: T[]): Map<string, T[]>;
+export declare function computeFunnelOverSessions(funnel: FunnelDefinition, sessions: Iterable<FunnelEvent[]>): FunnelComputation;

package/dist/services/funnels/compute.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groupBySession = groupBySession;
+exports.computeFunnelOverSessions = computeFunnelOverSessions;
+const STEP_MATCHERS = {
+    url: (event, value) => event.kind === "pageview" && event.url === value,
+    custom: (event, value) => event.kind === "custom" && event.name === value,
+};
+function eventMatchesStep(event, step) {
+    return STEP_MATCHERS[step.kind](event, step.value);
+}
+function groupBySession(events) {
+    const sessions = new Map();
+    for (const event of events) {
+        const bucket = sessions.get(event.sessionId);
+        if (bucket) {
+            bucket.push(event);
+        }
+        else {
+            sessions.set(event.sessionId, [event]);
+        }
+    }
+    return sessions;
+}
+function sessionProgress(events, funnel) {
+    let reached = 0;
+    let enteredAt;
+    for (const event of events) {
+        if (reached >= funnel.steps.length) {
+            break;
+        }
+        if (enteredAt !== undefined &&
+            event.timestamp.getTime() - enteredAt > funnel.conversionWindowMs) {
+            break;
+        }
+        if (eventMatchesStep(event, funnel.steps[reached])) {
+            if (reached === 0) {
+                enteredAt = event.timestamp.getTime();
+            }
+            reached++;
+        }
+    }
+    return reached;
+}
+function computeFunnelOverSessions(funnel, sessions) {
+    if (funnel.steps.length === 0) {
+        return { totalSessions: 0, steps: [] };
+    }
+    const reachedCounts = Array.from({
+        length: funnel.steps.length,
+    }).fill(0);
+    for (const sessionEvents of sessions) {
+        const reached = sessionProgress(sessionEvents, funnel);
+        for (let i = 0; i < reached; i++) {
+            reachedCounts[i]++;
+        }
+    }
+    const entered = reachedCounts[0] ?? 0;
+    return {
+        totalSessions: entered,
+        steps: funnel.steps.map((step, i) => ({
+            step,
+            sessions: reachedCounts[i],
+            conversionRate: entered > 0 ? reachedCounts[i] / entered : 0,
+        })),
+    };
+}
+//# sourceMappingURL=compute.js.map

package/dist/services/funnels/compute.js.map

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

package/dist/services/funnels/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./compute";
+export * from "./results";

package/dist/services/funnels/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./compute"), exports);
+__exportStar(require("./results"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/funnels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/funnels/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,4CAA0B"}

package/dist/services/funnels/results.d.ts

@@ -0,0 +1,14 @@
+import type { MarketingEventsModel } from "@/db";
+import type { Funnel } from "@/db/tables/funnels.table";
+import { type ExperimentResults } from "@/services/experiments/results";
+import { type FunnelComputation } from "./compute";
+export interface FunnelResults {
+    computation: FunnelComputation;
+    experiment?: ExperimentResults;
+    truncated: boolean;
+    window: {
+        since: number;
+        until: number;
+    };
+}
+export declare function computeFunnelResults(eventsModel: MarketingEventsModel, funnel: Funnel, since: Date, until: Date): Promise<FunnelResults>;

package/dist/services/funnels/results.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeFunnelResults = computeFunnelResults;
+const results_1 = require("@/services/experiments/results");
+const constants_1 = require("@/types/constants");
+const compute_1 = require("./compute");
+const FUNNEL_EVENT_KINDS = ["pageview", "custom"];
+const EXPERIMENT_EVENT_KINDS = [...FUNNEL_EVENT_KINDS, "exposure"];
+const EXPOSURE_KIND = "exposure";
+const FUNNEL_FIELDS = ["sessionId", "kind", "url", "name"];
+const EXPERIMENT_FIELDS = [...FUNNEL_FIELDS, "data"];
+function runWindows(experiment, until) {
+    if (experiment.status === "draft") {
+        return null;
+    }
+    return experiment.runs.map((run) => ({
+        since: new Date(run.startedAt),
+        until: run.stoppedAt === null ? until : new Date(run.stoppedAt),
+    }));
+}
+function readWindow(runs, funnel, until) {
+    const since = Math.min(...runs.map((run) => run.since.getTime()));
+    const last = Math.max(...runs.map((run) => run.until.getTime()));
+    return {
+        since: new Date(since),
+        until: new Date(Math.min(last + funnel.conversionWindowMs, until.getTime())),
+    };
+}
+function withinRuns(events, runs) {
+    const bounds = runs.map((run) => [run.since.getTime(), run.until.getTime()]);
+    return events.filter((event) => {
+        if (event.kind !== EXPOSURE_KIND) {
+            return true;
+        }
+        const at = event.timestamp.getTime();
+        return bounds.some(([since, until]) => at >= since && at <= until);
+    });
+}
+function coveredWindow(runs) {
+    return {
+        since: new Date(Math.min(...runs.map((run) => run.since.getTime()))),
+        until: new Date(Math.max(...runs.map((run) => run.until.getTime()))),
+    };
+}
+async function computeFunnelResults(eventsModel, funnel, since, until) {
+    const experiment = funnel.experiment;
+    const runs = experiment ? runWindows(experiment, until) : null;
+    const read = runs ? readWindow(runs, funnel, until) : { since, until };
+    const events = (await eventsModel.queryRange({
+        websiteIds: [funnel.websiteId],
+        since: read.since,
+        until: read.until,
+        kinds: runs ? EXPERIMENT_EVENT_KINDS : FUNNEL_EVENT_KINDS,
+        limit: constants_1.MAX_FUNNEL_EVENTS,
+        fields: runs ? EXPERIMENT_FIELDS : FUNNEL_FIELDS,
+    }));
+    const truncated = events.length >= constants_1.MAX_FUNNEL_EVENTS;
+    const usable = runs ? withinRuns(events, runs) : events;
+    const reported = runs ? coveredWindow(runs) : read;
+    return {
+        computation: (0, compute_1.computeFunnelOverSessions)(funnel, (0, compute_1.groupBySession)(usable).values()),
+        experiment: runs && experiment
+            ? (0, results_1.computeExperimentResults)(usable, funnel, experiment, truncated)
+            : undefined,
+        truncated,
+        window: {
+            since: reported.since.getTime(),
+            until: reported.until.getTime(),
+        },
+    };
+}
+//# sourceMappingURL=results.js.map

package/dist/services/funnels/results.js.map

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

package/dist/services/geoip.d.ts

@@ -0,0 +1,3 @@
+export declare function loadGeoipDatabase(): Promise<void>;
+export declare function isGeoipActive(): boolean;
+export declare function lookupCountry(ip: string): string | undefined;

package/dist/services/geoip.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadGeoipDatabase = loadGeoipDatabase;
+exports.isGeoipActive = isGeoipActive;
+exports.lookupCountry = lookupCountry;
+const logging_1 = require("@antelopejs/interface-core/logging");
+const maxmind_1 = require("maxmind");
+const config_1 = require("@/config");
+let reader;
+async function loadGeoipDatabase() {
+    const path = (0, config_1.getConfig)().geoipDatabasePath;
+    if (!path) {
+        return;
+    }
+    try {
+        reader = await (0, maxmind_1.open)(path);
+    }
+    catch (error) {
+        logging_1.Logging.Error(`[dms-marketing] GeoIP database unreadable (${path}):`, error);
+    }
+}
+function isGeoipActive() {
+    return reader !== undefined;
+}
+function lookupCountry(ip) {
+    if (!reader) {
+        return undefined;
+    }
+    let found;
+    try {
+        found = reader.get(ip);
+    }
+    catch {
+        return undefined;
+    }
+    return found?.country?.iso_code ?? found?.registered_country?.iso_code;
+}
+//# sourceMappingURL=geoip.js.map

package/dist/services/geoip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geoip.js","sourceRoot":"","sources":["../../src/services/geoip.ts"],"names":[],"mappings":";;AAYA,8CAaC;AAKD,sCAEC;AASD,sCAWC;AApDD,gEAA6D;AAC7D,qCAAkE;AAClE,qCAAqC;AAErC,IAAI,MAA2C,CAAC;AAQzC,KAAK,UAAU,iBAAiB;IACrC,MAAM,IAAI,GAAG,IAAA,kBAAS,GAAE,CAAC,iBAAiB,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAA,cAAI,EAAkB,IAAI,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iBAAO,CAAC,KAAK,CACX,8CAA8C,IAAI,IAAI,EACtD,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAKD,SAAgB,aAAa;IAC3B,OAAO,MAAM,KAAK,SAAS,CAAC;AAC9B,CAAC;AASD,SAAgB,aAAa,CAAC,EAAU;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAA6B,CAAC;IAClC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,IAAI,KAAK,EAAE,kBAAkB,EAAE,QAAQ,CAAC;AACzE,CAAC"}

package/dist/services/heatmap.d.ts

@@ -0,0 +1,10 @@
+import type { MarketingHeatmapPayload, MarketingHeatmapQuery } from "@antelopejs/interface-dms-marketing";
+export interface MarketingScrollDepthPayload {
+    views: number;
+    reached: number[];
+    truncated: boolean;
+}
+export declare function computeClickHeatmap(tenantId: string, websiteIds: string[], path: string, period?: string): Promise<MarketingHeatmapPayload>;
+export declare function computeScrollDepth(tenantId: string, websiteIds: string[], path: string, period?: string): Promise<MarketingScrollDepthPayload>;
+export declare function resetHeatmap(tenantId: string, websiteId: string, path?: string): Promise<number>;
+export declare function buildTenantHeatmap(query: MarketingHeatmapQuery): Promise<MarketingHeatmapPayload>;

package/dist/services/heatmap.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeClickHeatmap = computeClickHeatmap;
+exports.computeScrollDepth = computeScrollDepth;
+exports.resetHeatmap = resetHeatmap;
+exports.buildTenantHeatmap = buildTenantHeatmap;
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const db_1 = require("@/db");
+const constants_1 = require("@/types/constants");
+const period_1 = require("./period");
+const snapshots_1 = require("./snapshots");
+const CLICK_FIELDS = ["data"];
+const EMPTY_HEATMAP = {
+    points: [],
+    maxWeight: 0,
+    totalClicks: 0,
+    truncated: false,
+};
+const EMPTY_SCROLL_DEPTH = {
+    views: 0,
+    reached: [],
+    truncated: false,
+};
+function toGridIndex(normalized) {
+    return Math.min(Math.round(normalized * constants_1.HEATMAP_DIVISIONS_PER_AXIS), constants_1.HEATMAP_DIVISIONS_PER_AXIS);
+}
+function toFraction(index) {
+    return index / constants_1.HEATMAP_DIVISIONS_PER_AXIS;
+}
+function addToDocumentCell(cells, x, y, weight) {
+    const gx = toGridIndex(x);
+    const gy = toGridIndex(y);
+    const key = `d:${gx}:${gy}`;
+    const cell = cells.get(key) ?? {
+        x: toFraction(gx),
+        y: toFraction(gy),
+        weight: 0,
+    };
+    cell.weight += weight;
+    cells.set(key, cell);
+}
+function anchorOf(data) {
+    if (!data.selector) {
+        return null;
+    }
+    if (typeof data.ox !== "number" || typeof data.oy !== "number") {
+        return null;
+    }
+    return {
+        selector: data.selector,
+        ox: data.ox,
+        oy: data.oy,
+        nth: data.nth ?? 0,
+    };
+}
+function capAnchoredCells(cells) {
+    const anchored = [];
+    for (const [key, cell] of cells) {
+        if (cell.anchor) {
+            anchored.push({ key, cell });
+        }
+    }
+    if (anchored.length <= constants_1.MAX_ANCHORED_HEATMAP_CELLS) {
+        return;
+    }
+    anchored.sort((a, b) => b.cell.weight - a.cell.weight);
+    for (const { key, cell } of anchored.slice(constants_1.MAX_ANCHORED_HEATMAP_CELLS)) {
+        cells.delete(key);
+        addToDocumentCell(cells, cell.x, cell.y, cell.weight);
+    }
+}
+function addToAnchoredCell(cells, anchor, x, y) {
+    const gx = toGridIndex(anchor.ox);
+    const gy = toGridIndex(anchor.oy);
+    const key = `a:${anchor.selector}:${anchor.nth}:${gx}:${gy}`;
+    const cell = cells.get(key) ?? {
+        x,
+        y,
+        weight: 0,
+        anchor: { ...anchor, ox: toFraction(gx), oy: toFraction(gy) },
+    };
+    cell.weight++;
+    cells.set(key, cell);
+}
+function bucketClick(cells, data) {
+    const x = data.dx ?? data.x;
+    const y = data.dy ?? data.y;
+    if (typeof x !== "number" || typeof y !== "number") {
+        return false;
+    }
+    const anchor = anchorOf(data);
+    if (anchor) {
+        addToAnchoredCell(cells, anchor, x, y);
+    }
+    else {
+        addToDocumentCell(cells, x, y, 1);
+    }
+    return true;
+}
+function bucketClicks(payloads) {
+    const cells = new Map();
+    let totalClicks = 0;
+    for (const payload of payloads) {
+        const data = payload.data;
+        if (data && bucketClick(cells, data)) {
+            totalClicks++;
+        }
+    }
+    capAnchoredCells(cells);
+    const points = [...cells.values()];
+    return {
+        points,
+        maxWeight: points.reduce((top, point) => Math.max(top, point.weight), 0),
+        totalClicks,
+    };
+}
+async function computeClickHeatmap(tenantId, websiteIds, path, period) {
+    if (websiteIds.length === 0) {
+        return EMPTY_HEATMAP;
+    }
+    const days = (0, period_1.parsePeriodDays)(period);
+    const events = await (0, interface_database_decorators_1.GetModel)(db_1.MarketingEventsModel, tenantId).queryRange({
+        websiteIds,
+        since: (0, period_1.periodStart)(days),
+        until: new Date(),
+        kinds: ["click"],
+        url: path,
+        limit: constants_1.MAX_HEATMAP_EVENTS,
+        fields: CLICK_FIELDS,
+    });
+    return {
+        ...bucketClicks(events),
+        truncated: events.length >= constants_1.MAX_HEATMAP_EVENTS,
+    };
+}
+function cumulativeReach(buckets) {
+    const counts = Array.from({ length: constants_1.SCROLL_DEPTH_SCALE + 1 }).fill(0);
+    let views = 0;
+    for (const bucket of buckets) {
+        counts[bucket.depth] += bucket.views;
+        views += bucket.views;
+    }
+    const reached = Array.from({ length: constants_1.SCROLL_DEPTH_SCALE + 1 }).fill(0);
+    let running = 0;
+    for (let depth = constants_1.SCROLL_DEPTH_SCALE; depth >= 0; depth--) {
+        running += counts[depth];
+        reached[depth] = running;
+    }
+    return { views, reached };
+}
+async function computeScrollDepth(tenantId, websiteIds, path, period) {
+    if (websiteIds.length === 0) {
+        return EMPTY_SCROLL_DEPTH;
+    }
+    const days = (0, period_1.parsePeriodDays)(period);
+    const buckets = await (0, interface_database_decorators_1.GetModel)(db_1.MarketingEventsModel, tenantId).countScrollDepths({
+        websiteIds,
+        since: (0, period_1.periodStart)(days),
+        until: new Date(),
+        url: path,
+    });
+    return { ...cumulativeReach(buckets), truncated: false };
+}
+async function resetHeatmap(tenantId, websiteId, path) {
+    await (0, snapshots_1.deleteSnapshots)(tenantId, websiteId, path);
+    return (0, interface_database_decorators_1.GetModel)(db_1.MarketingEventsModel, tenantId).deleteHeatmapEvents(websiteId, path);
+}
+async function tenantHeatmapScope(tenantId, websiteId) {
+    const websites = (0, interface_database_decorators_1.GetModel)(db_1.WebsitesModel);
+    if (!websiteId) {
+        return websites.listIdsByTenant(tenantId);
+    }
+    const site = await websites.get(websiteId);
+    return site?.tenantId === tenantId ? [site._id] : [];
+}
+async function buildTenantHeatmap(query) {
+    const websiteIds = await tenantHeatmapScope(query.tenantId, query.websiteId);
+    return computeClickHeatmap(query.tenantId, websiteIds, query.path, query.period);
+}
+//# sourceMappingURL=heatmap.js.map

package/dist/services/heatmap.js.map

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