@huloglobal/vendure-plugin-visitor-analytics 0.4.3 → 0.6.0

package/dist/admin-api.d.ts

@@ -0,0 +1,12 @@
+import { RequestContext, TransactionalConnection } from '@vendure/core';
+export declare const visitorAnalyticsAdminApiSchema: import("graphql").DocumentNode;
+export declare class VisitorAnalyticsAdminResolver {
+    private connection;
+    constructor(connection: TransactionalConnection);
+    huloVisitorSummary(ctx: RequestContext, channelId?: number, daysInput?: number): Promise<any>;
+    huloVisitorSources(channelId?: number, daysInput?: number): Promise<any[]>;
+    huloVisitorTopPages(channelId?: number, daysInput?: number): Promise<any[]>;
+    huloVisitorFunnel(input: any): Promise<any>;
+    huloVisitorJourney(visitorId: string): Promise<any[]>;
+}
+//# sourceMappingURL=admin-api.d.ts.map

package/dist/admin-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-api.d.ts","sourceRoot":"","sources":["../src/admin-api.ts"],"names":[],"mappings":"AAYA,OAAO,EAA0B,cAAc,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAEhG,eAAO,MAAM,8BAA8B,gCAsE1C,CAAC;AAUF,qBAEa,6BAA6B;IAC1B,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,uBAAuB;IAIjD,kBAAkB,CACb,GAAG,EAAE,cAAc,EACP,SAAS,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,MAAM,GACjC,OAAO,CAAC,GAAG,CAAC;IAsCT,kBAAkB,CAAoB,SAAS,CAAC,EAAE,MAAM,EAAgB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAqB3G,mBAAmB,CAAoB,SAAS,CAAC,EAAE,MAAM,EAAgB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IA0B5G,iBAAiB,CAAgB,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA8B1D,kBAAkB,CAAoB,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAajF"}

package/dist/admin-api.js

@@ -0,0 +1,264 @@
+"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.VisitorAnalyticsAdminResolver = exports.visitorAnalyticsAdminApiSchema = void 0;
+/**
+ * Vendure Admin API extensions for HULO Visitor Analytics.
+ *
+ * Mirrors the operator queries from the REST controller — summary,
+ * sources, top-pages, funnel, journey — so any GraphQL client can
+ * drive the dashboards. The high-frequency public path POST /ees/track
+ * stays REST: it's an anonymous beacon, ingests potentially millions
+ * of events / day, and benefits from being outside the resolver stack.
+ */
+const common_1 = require("@nestjs/common");
+const graphql_1 = require("@nestjs/graphql");
+const graphql_tag_1 = require("graphql-tag");
+const core_1 = require("@vendure/core");
+exports.visitorAnalyticsAdminApiSchema = (0, graphql_tag_1.gql) `
+    type HuloVisitorSummary {
+        days: Int!
+        channelId: Int
+        visitors: Int!
+        sessions: Int!
+        pageViews: Int!
+        events: Int!
+        bounceRate: Float!
+        avgSessionSec: Float!
+    }
+
+    type HuloVisitorSource {
+        source: String!
+        visitors: Int!
+        sessions: Int!
+    }
+
+    type HuloVisitorPage {
+        url: String!
+        title: String
+        views: Int!
+        uniqueVisitors: Int!
+        avgTimeOnPageSec: Float!
+    }
+
+    type HuloFunnelStep {
+        index: Int!
+        urlPattern: String!
+        label: String
+        users: Int!
+        dropOffPct: Float!
+    }
+
+    type HuloVisitorFunnel {
+        days: Int!
+        steps: [HuloFunnelStep!]!
+    }
+
+    type HuloVisitorEvent {
+        id: ID!
+        createdAt: DateTime!
+        type: String!
+        url: String
+        title: String
+        referrerDomain: String
+        country: String
+        region: String
+        city: String
+        browser: String
+        os: String
+        device: String
+        sessionId: String!
+        visitorId: String!
+        customerId: Int
+    }
+
+    input HuloVisitorFunnelInput {
+        channelId: Int
+        days: Int
+        steps: [String!]!
+    }
+
+    extend type Query {
+        huloVisitorSummary(channelId: Int, days: Int): HuloVisitorSummary!
+        huloVisitorSources(channelId: Int, days: Int): [HuloVisitorSource!]!
+        huloVisitorTopPages(channelId: Int, days: Int): [HuloVisitorPage!]!
+        huloVisitorFunnel(input: HuloVisitorFunnelInput!): HuloVisitorFunnel!
+        huloVisitorJourney(visitorId: String!): [HuloVisitorEvent!]!
+    }
+`;
+function clampDays(input) {
+    return Math.min(Math.max(Number(input) || 7, 1), 365);
+}
+function channelFilter(channelId) {
+    if (channelId)
+        return { where: ' AND channelId = ?', params: [channelId] };
+    return { where: '', params: [] };
+}
+let VisitorAnalyticsAdminResolver = class VisitorAnalyticsAdminResolver {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    async huloVisitorSummary(ctx, channelId, daysInput) {
+        const days = clampDays(daysInput);
+        const c = channelFilter(channelId);
+        const totals = await this.connection.rawConnection.query(`SELECT COUNT(DISTINCT visitorId) AS visitors,
+                    COUNT(DISTINCT sessionId) AS sessions,
+                    SUM(type = 'pageview') AS pageViews,
+                    COUNT(*) AS events
+             FROM visitor_event
+             WHERE createdAt >= DATE_SUB(NOW(), INTERVAL ? DAY)${c.where}`, [days, ...c.params]);
+        const t = totals[0] || {};
+        const sessionRows = await this.connection.rawConnection.query(`SELECT sessionId,
+                    TIMESTAMPDIFF(SECOND, MIN(createdAt), MAX(createdAt)) AS dur,
+                    COUNT(*) AS n
+             FROM visitor_event
+             WHERE createdAt >= DATE_SUB(NOW(), INTERVAL ? DAY)${c.where}
+             GROUP BY sessionId`, [days, ...c.params]);
+        const ssRows = sessionRows;
+        const bounces = ssRows.filter((s) => Number(s.n) <= 1).length;
+        const avg = ssRows.length ? ssRows.reduce((a, s) => a + Number(s.dur || 0), 0) / ssRows.length : 0;
+        return {
+            days, channelId: channelId || null,
+            visitors: Number(t.visitors) || 0,
+            sessions: Number(t.sessions) || 0,
+            pageViews: Number(t.pageViews) || 0,
+            events: Number(t.events) || 0,
+            bounceRate: ssRows.length ? bounces / ssRows.length : 0,
+            avgSessionSec: avg,
+        };
+    }
+    async huloVisitorSources(channelId, daysInput) {
+        const days = clampDays(daysInput);
+        const c = channelFilter(channelId);
+        const rows = await this.connection.rawConnection.query(`SELECT COALESCE(NULLIF(referrerDomain, ''), '(direct)') AS source,
+                    COUNT(DISTINCT visitorId) AS visitors,
+                    COUNT(DISTINCT sessionId) AS sessions
+             FROM visitor_event
+             WHERE createdAt >= DATE_SUB(NOW(), INTERVAL ? DAY)${c.where}
+             GROUP BY source ORDER BY sessions DESC LIMIT 50`, [days, ...c.params]);
+        return rows.map((r) => ({
+            source: r.source,
+            visitors: Number(r.visitors) || 0,
+            sessions: Number(r.sessions) || 0,
+        }));
+    }
+    async huloVisitorTopPages(channelId, daysInput) {
+        const days = clampDays(daysInput);
+        const c = channelFilter(channelId);
+        const rows = await this.connection.rawConnection.query(`SELECT url,
+                    MAX(title) AS title,
+                    COUNT(*) AS views,
+                    COUNT(DISTINCT visitorId) AS uniqueVisitors,
+                    AVG(COALESCE(timeOnPageMs, 0)) / 1000 AS avgTimeOnPageSec
+             FROM visitor_event
+             WHERE type = 'pageview'
+               AND createdAt >= DATE_SUB(NOW(), INTERVAL ? DAY)${c.where}
+             GROUP BY url ORDER BY views DESC LIMIT 50`, [days, ...c.params]);
+        return rows.map((r) => ({
+            url: r.url || '',
+            title: r.title || null,
+            views: Number(r.views) || 0,
+            uniqueVisitors: Number(r.uniqueVisitors) || 0,
+            avgTimeOnPageSec: Number(r.avgTimeOnPageSec) || 0,
+        }));
+    }
+    async huloVisitorFunnel(input) {
+        var _a;
+        const days = clampDays(input === null || input === void 0 ? void 0 : input.days);
+        const c = channelFilter(input === null || input === void 0 ? void 0 : input.channelId);
+        const steps = Array.isArray(input === null || input === void 0 ? void 0 : input.steps) ? input.steps.map(String) : [];
+        if (!steps.length)
+            return { days, steps: [] };
+        // For each step, count distinct visitors who hit it. This is a
+        // pageview-funnel approximation; ordered funnel (visitor must
+        // have hit step i-1 before i) is a future enhancement.
+        const out = [];
+        let prevUsers = null;
+        for (let i = 0; i < steps.length; i++) {
+            const pattern = steps[i];
+            const rows = await this.connection.rawConnection.query(`SELECT COUNT(DISTINCT visitorId) AS n
+                 FROM visitor_event
+                 WHERE type = 'pageview'
+                   AND url LIKE ?
+                   AND createdAt >= DATE_SUB(NOW(), INTERVAL ? DAY)${c.where}`, [pattern.replace(/\*/g, '%'), days, ...c.params]);
+            const users = Number((_a = rows[0]) === null || _a === void 0 ? void 0 : _a.n) || 0;
+            const dropOff = prevUsers && prevUsers > 0 ? 1 - (users / prevUsers) : 0;
+            out.push({ index: i, urlPattern: pattern, label: null, users, dropOffPct: dropOff });
+            prevUsers = users;
+        }
+        return { days, steps: out };
+    }
+    async huloVisitorJourney(visitorId) {
+        if (!visitorId)
+            return [];
+        const rows = await this.connection.rawConnection.query(`SELECT id, createdAt, type, url, title, referrerDomain,
+                    country, region, city, browser, os, device,
+                    sessionId, visitorId, customerId
+             FROM visitor_event
+             WHERE visitorId = ?
+             ORDER BY createdAt ASC LIMIT 1000`, [String(visitorId)]);
+        return rows;
+    }
+};
+exports.VisitorAnalyticsAdminResolver = VisitorAnalyticsAdminResolver;
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Args)('channelId')),
+    __param(2, (0, graphql_1.Args)('days')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Number, Number]),
+    __metadata("design:returntype", Promise)
+], VisitorAnalyticsAdminResolver.prototype, "huloVisitorSummary", null);
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, graphql_1.Args)('channelId')),
+    __param(1, (0, graphql_1.Args)('days')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number, Number]),
+    __metadata("design:returntype", Promise)
+], VisitorAnalyticsAdminResolver.prototype, "huloVisitorSources", null);
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, graphql_1.Args)('channelId')),
+    __param(1, (0, graphql_1.Args)('days')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number, Number]),
+    __metadata("design:returntype", Promise)
+], VisitorAnalyticsAdminResolver.prototype, "huloVisitorTopPages", null);
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, graphql_1.Args)('input')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], VisitorAnalyticsAdminResolver.prototype, "huloVisitorFunnel", null);
+__decorate([
+    (0, graphql_1.Query)(),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, graphql_1.Args)('visitorId')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], VisitorAnalyticsAdminResolver.prototype, "huloVisitorJourney", null);
+exports.VisitorAnalyticsAdminResolver = VisitorAnalyticsAdminResolver = __decorate([
+    (0, graphql_1.Resolver)(),
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.TransactionalConnection])
+], VisitorAnalyticsAdminResolver);
+//# sourceMappingURL=admin-api.js.map

package/dist/admin-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-api.js","sourceRoot":"","sources":["../src/admin-api.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA;;;;;;;;GAQG;AACH,2CAA4C;AAC5C,6CAAwD;AACxD,6CAAkC;AAClC,wCAAgG;AAEnF,QAAA,8BAA8B,GAAG,IAAA,iBAAG,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsEhD,CAAC;AAEF,SAAS,SAAS,CAAC,KAAU;IACzB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AACD,SAAS,aAAa,CAAC,SAAkB;IACrC,IAAI,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;IAC3E,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAIM,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IACtC,YAAoB,UAAmC;QAAnC,eAAU,GAAV,UAAU,CAAyB;IAAG,CAAC;IAIrD,AAAN,KAAK,CAAC,kBAAkB,CACb,GAAmB,EACP,SAAkB,EACvB,SAAkB;QAEhC,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CACpD;;;;;iEAKqD,CAAC,CAAC,KAAK,EAAE,EAC9D,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CACtB,CAAC;QACF,MAAM,CAAC,GAAI,MAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CACzD;;;;iEAIqD,CAAC,CAAC,KAAK;gCACxC,EACpB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CACtB,CAAC;QACF,MAAM,MAAM,GAAG,WAAoB,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACnE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,CAAM,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAChH,OAAO;YACH,IAAI,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI;YAClC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;YACnC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,aAAa,EAAE,GAAG;SACrB,CAAC;IACN,CAAC;IAIK,AAAN,KAAK,CAAC,kBAAkB,CAAoB,SAAkB,EAAgB,SAAkB;QAC5F,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAClD;;;;iEAIqD,CAAC,CAAC,KAAK;6DACX,EACjD,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CACtB,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACzB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;SACpC,CAAC,CAAC,CAAC;IACR,CAAC;IAIK,AAAN,KAAK,CAAC,mBAAmB,CAAoB,SAAkB,EAAgB,SAAkB;QAC7F,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAClD;;;;;;;iEAOqD,CAAC,CAAC,KAAK;uDACjB,EAC3C,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CACtB,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACzB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;YACtB,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YAC3B,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC;YAC7C,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;SACpD,CAAC,CAAC,CAAC;IACR,CAAC;IAIK,AAAN,KAAK,CAAC,iBAAiB,CAAgB,KAAU;;QAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAa,KAAK,CAAC,OAAO,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAC9C,+DAA+D;QAC/D,8DAA8D;QAC9D,uDAAuD;QACvD,MAAM,GAAG,GAAU,EAAE,CAAC;QACtB,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAClD;;;;qEAIqD,CAAC,CAAC,KAAK,EAAE,EAC9D,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,CACnD,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAC,IAAc,CAAC,CAAC,CAAC,0CAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,SAAS,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;YACrF,SAAS,GAAG,KAAK,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAChC,CAAC;IAIK,AAAN,KAAK,CAAC,kBAAkB,CAAoB,SAAiB;QACzD,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAClD;;;;;+CAKmC,EACnC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CACtB,CAAC;QACF,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAA;AAzIY,sEAA6B;AAKhC;IAFL,IAAA,eAAK,GAAE;IACP,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IAE1B,WAAA,IAAA,UAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAI,EAAC,WAAW,CAAC,CAAA;IACjB,WAAA,IAAA,cAAI,EAAC,MAAM,CAAC,CAAA;;qCAFD,qBAAc;;uEAqC7B;AAIK;IAFL,IAAA,eAAK,GAAE;IACP,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IACL,WAAA,IAAA,cAAI,EAAC,WAAW,CAAC,CAAA;IAAsB,WAAA,IAAA,cAAI,EAAC,MAAM,CAAC,CAAA;;;;uEAiB5E;AAIK;IAFL,IAAA,eAAK,GAAE;IACP,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IACJ,WAAA,IAAA,cAAI,EAAC,WAAW,CAAC,CAAA;IAAsB,WAAA,IAAA,cAAI,EAAC,MAAM,CAAC,CAAA;;;;wEAsB7E;AAIK;IAFL,IAAA,eAAK,GAAE;IACP,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IACN,WAAA,IAAA,cAAI,EAAC,OAAO,CAAC,CAAA;;;;sEA0BrC;AAIK;IAFL,IAAA,eAAK,GAAE;IACP,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IACL,WAAA,IAAA,cAAI,EAAC,WAAW,CAAC,CAAA;;;;uEAY1C;wCAxIQ,6BAA6B;IAFzC,IAAA,kBAAQ,GAAE;IACV,IAAA,mBAAU,GAAE;qCAEuB,8BAAuB;GAD9C,6BAA6B,CAyIzC"}

package/dist/plugin.d.ts

@@ -1,5 +1,5 @@
 import { Type } from '@vendure/core';
-import { RetentionOptions, UpdateChecker } from '@huloglobal/vendure-licence-sdk';
+import { LicenceStatus, RetentionOptions, UpdateChecker } from '@huloglobal/vendure-licence-sdk';
 export interface VisitorAnalyticsPluginOptions {
     /** Public host of the Vendure server. Used in licence host-match. */
     publicBaseUrl: string;
@@ -56,9 +56,12 @@ export declare function getOptions(): typeof DEFAULT_OPTIONS & VisitorAnalyticsP
 export declare class VisitorAnalyticsPlugin {
     private static revocation;
     private static updateChecker;
+    private static heartbeat;
+    private static licenceStatus;
     static getUpdateChecker(): UpdateChecker | null;
     static getPackageVersion(): string;
     static getPackageName(): string;
+    static getLicenceStatus(): LicenceStatus | null;
     static init(options: VisitorAnalyticsPluginOptions): Type<VisitorAnalyticsPlugin>;
     static uiExtensions: {
         extensionPath: string;

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,IAAI,EAAiB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAqB,aAAa,EAAiB,MAAM,iCAAiC,CAAC;AAUpH,MAAM,WAAW,6BAA6B;IAC1C,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB;;;gDAG4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB;6EACyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;yEAEqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;qEAEiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;6CAEyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,mDAAmD;IACnD,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD;;yEAEqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;2EAEuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAG9B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAgBD,QAAA,MAAM,eAAe,EAAE,6BAMtB,CAAC;AAGF,wBAAgB,UAAU,IAAI,OAAO,eAAe,GAAG,6BAA6B,CAEnF;AAED;;;;;;;;;;;GAWG;AACH,qBAOa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAkC;IAC3D,OAAO,CAAC,MAAM,CAAC,aAAa,CAA8B;IAE1D,MAAM,CAAC,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAC/C,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAClC,MAAM,CAAC,cAAc,IAAI,MAAM;IAE/B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC,sBAAsB,CAAC;IAiCjF,MAAM,CAAC,YAAY;;;;;;;;MAUjB;CACL"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,IAAI,EAAiB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAmC,aAAa,EAAE,gBAAgB,EAAqB,aAAa,EAAiB,MAAM,iCAAiC,CAAC;AAWpK,MAAM,WAAW,6BAA6B;IAC1C,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB;;;gDAG4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB;6EACyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;yEAEqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;qEAEiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;6CAEyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,mDAAmD;IACnD,SAAS,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD;;yEAEqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;2EAEuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAG9B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChC;AAgBD,QAAA,MAAM,eAAe,EAAE,6BAMtB,CAAC;AAGF,wBAAgB,UAAU,IAAI,OAAO,eAAe,GAAG,6BAA6B,CAEnF;AAED;;;;;;;;;;;GAWG;AACH,qBAWa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAkC;IAC3D,OAAO,CAAC,MAAM,CAAC,aAAa,CAA8B;IAC1D,OAAO,CAAC,MAAM,CAAC,SAAS,CAA0B;IAClD,OAAO,CAAC,MAAM,CAAC,aAAa,CAA8B;IAE1D,MAAM,CAAC,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAC/C,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAClC,MAAM,CAAC,cAAc,IAAI,MAAM;IAC/B,MAAM,CAAC,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAE/C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC,sBAAsB,CAAC;IA4CjF,MAAM,CAAC,YAAY;;;;;;;;MAUjB;CACL"}

package/dist/plugin.js

@@ -14,6 +14,7 @@ const vendure_licence_sdk_1 = require("@huloglobal/vendure-licence-sdk");
 const conversion_goal_entity_1 = require("./conversion-goal.entity");
 const visitor_event_entity_1 = require("./visitor-event.entity");
 const visitor_tracking_service_1 = require("./visitor-tracking.service");
+const admin_api_1 = require("./admin-api");
 const visitor_tracking_controller_1 = require("./visitor-tracking.controller");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const PKG_VERSION = require('../package.json').version;
@@ -57,6 +58,7 @@ let VisitorAnalyticsPlugin = VisitorAnalyticsPlugin_1 = class VisitorAnalyticsPl
     static getUpdateChecker() { return VisitorAnalyticsPlugin_1.updateChecker; }
     static getPackageVersion() { return PKG_VERSION; }
     static getPackageName() { return PKG_NAME; }
+    static getLicenceStatus() { return VisitorAnalyticsPlugin_1.licenceStatus; }
     static init(options) {
         cachedOptions = options;
         if (!VisitorAnalyticsPlugin_1.revocation) {
@@ -76,10 +78,20 @@ let VisitorAnalyticsPlugin = VisitorAnalyticsPlugin_1 = class VisitorAnalyticsPl
             publicKey: HULO_PUBLIC_KEY,
             revokedIds: VisitorAnalyticsPlugin_1.revocation.getRevokedIds(),
         });
+        VisitorAnalyticsPlugin_1.licenceStatus = status;
         if (!status.valid) {
             // eslint-disable-next-line no-console
             console.warn(`[@huloglobal/vendure-plugin-visitor-analytics] ${status.message}` +
-                ` — Running in unlicensed mode (ingest works, admin dashboards disabled). Purchase a key at https://elite-software.co.uk/licence/buy/${PLUGIN_ID}`);
+                ` — Running in FREE tier: 100 events/day cap, conversion goals disabled, live SSE feed disabled, CSV export disabled. Buy a licence at https://elite.charity/licence/buy/${PLUGIN_ID}`);
+        }
+        if (!VisitorAnalyticsPlugin_1.heartbeat) {
+            VisitorAnalyticsPlugin_1.heartbeat = new vendure_licence_sdk_1.Heartbeat({
+                packageName: PKG_NAME,
+                packageVersion: PKG_VERSION,
+                licenceKey: options.licenceKey,
+                publicKeyFingerprint: (0, vendure_licence_sdk_1.fingerprintPublicKey)(HULO_PUBLIC_KEY),
+            });
+            VisitorAnalyticsPlugin_1.heartbeat.start();
         }
         return VisitorAnalyticsPlugin_1;
     }
@@ -87,6 +99,8 @@ let VisitorAnalyticsPlugin = VisitorAnalyticsPlugin_1 = class VisitorAnalyticsPl
 exports.VisitorAnalyticsPlugin = VisitorAnalyticsPlugin;
 VisitorAnalyticsPlugin.revocation = null;
 VisitorAnalyticsPlugin.updateChecker = null;
+VisitorAnalyticsPlugin.heartbeat = null;
+VisitorAnalyticsPlugin.licenceStatus = null;
 VisitorAnalyticsPlugin.uiExtensions = {
     extensionPath: __dirname + '/../ui',
     ngModules: [
@@ -101,10 +115,14 @@ VisitorAnalyticsPlugin.uiExtensions = {
 exports.VisitorAnalyticsPlugin = VisitorAnalyticsPlugin = VisitorAnalyticsPlugin_1 = __decorate([
     (0, core_1.VendurePlugin)({
         imports: [core_1.PluginCommonModule],
-        providers: [visitor_tracking_service_1.VisitorTrackingService],
+        providers: [visitor_tracking_service_1.VisitorTrackingService, admin_api_1.VisitorAnalyticsAdminResolver],
         controllers: [visitor_tracking_controller_1.VisitorTrackingController],
         entities: [visitor_event_entity_1.VisitorEvent, conversion_goal_entity_1.ConversionGoal],
         compatibility: '^3.0.0',
+        adminApiExtensions: {
+            schema: admin_api_1.visitorAnalyticsAdminApiSchema,
+            resolvers: [admin_api_1.VisitorAnalyticsAdminResolver],
+        },
     })
 ], VisitorAnalyticsPlugin);
 //# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":";;;;;;;;;;AA8EA,gCAEC;AAhFD,wCAAwE;AACxE,yEAAoK;AACpK,qEAA0D;AAC1D,iEAAsD;AACtD,yEAAoE;AACpE,2CAA4F;AAC5F,+EAA0E;AAE1E,8DAA8D;AAC9D,MAAM,WAAW,GAAW,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC;AAC/D,MAAM,QAAQ,GAAG,8CAA8C,CAAC;AA6ChE,MAAM,eAAe,GAAG;;;;;;;;yBAQC,CAAC;AAE1B,MAAM,SAAS,GAAG,kCAAkC,CAAC;AACrD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B;OACvD,4CAA4C,CAAC;AAEpD,MAAM,eAAe,GAAkC;IACnD,aAAa,EAAE,uBAAuB;IACtC,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;CACvB,CAAC;AAEF,IAAI,aAAa,GAAkC,eAAsB,CAAC;AAC1E,SAAgB,UAAU;IACtB,OAAO,EAAE,GAAG,eAAe,EAAE,GAAG,aAAa,EAAS,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;GAWG;AAYI,IAAM,sBAAsB,8BAA5B,MAAM,sBAAsB;IAM/B,MAAM,CAAC,gBAAgB,KAA2B,OAAO,wBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IAChG,MAAM,CAAC,iBAAiB,KAAa,OAAO,WAAW,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,cAAc,KAAa,OAAO,QAAQ,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,gBAAgB,KAA2B,OAAO,wBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IAEhG,MAAM,CAAC,IAAI,CAAC,OAAsC;QAC9C,aAAa,GAAG,OAAO,CAAC;QAExB,IAAI,CAAC,wBAAsB,CAAC,UAAU,EAAE,CAAC;YACrC,wBAAsB,CAAC,UAAU,GAAG,IAAI,uCAAiB,CAAC,cAAc,CAAC,CAAC;YAC1E,wBAAsB,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,wBAAsB,CAAC,aAAa,EAAE,CAAC;YACxC,wBAAsB,CAAC,aAAa,GAAG,IAAI,mCAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAChF,wBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;aACrC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAA,mCAAa,EAAC;YACzB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,SAAS;YACnB,IAAI;YACJ,SAAS,EAAE,eAAe;YAC1B,UAAU,EAAE,wBAAsB,CAAC,UAAU,CAAC,aAAa,EAAE;SAChE,CAAC,CAAC;QACH,wBAAsB,CAAC,aAAa,GAAG,MAAM,CAAC;QAE9C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAChB,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACR,kDAAkD,MAAM,CAAC,OAAO,EAAE;gBAClE,2KAA2K,SAAS,EAAE,CACzL,CAAC;QACN,CAAC;QAED,IAAI,CAAC,wBAAsB,CAAC,SAAS,EAAE,CAAC;YACpC,wBAAsB,CAAC,SAAS,GAAG,IAAI,+BAAS,CAAC;gBAC7C,WAAW,EAAE,QAAQ;gBACrB,cAAc,EAAE,WAAW;gBAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,oBAAoB,EAAE,IAAA,0CAAoB,EAAC,eAAe,CAAC;aAC9D,CAAC,CAAC;YACH,wBAAsB,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC7C,CAAC;QAED,OAAO,wBAAsB,CAAC;IAClC,CAAC;;AArDQ,wDAAsB;AAChB,iCAAU,GAA6B,IAAI,AAAjC,CAAkC;AAC5C,oCAAa,GAAyB,IAAI,AAA7B,CAA8B;AAC3C,gCAAS,GAAqB,IAAI,AAAzB,CAA0B;AACnC,oCAAa,GAAyB,IAAI,AAA7B,CAA8B;AAmDnD,mCAAY,GAAG;IAClB,aAAa,EAAE,SAAS,GAAG,QAAQ;IACnC,SAAS,EAAE;QACP;YACI,IAAI,EAAE,MAAe;YACrB,KAAK,EAAE,UAAU;YACjB,gBAAgB,EAAE,oBAAoB;YACtC,YAAY,EAAE,gBAAgB;SACjC;KACJ;CACJ,AAVkB,CAUjB;iCAjEO,sBAAsB;IAXlC,IAAA,oBAAa,EAAC;QACX,OAAO,EAAE,CAAC,yBAAkB,CAAC;QAC7B,SAAS,EAAE,CAAC,iDAAsB,EAAE,yCAA6B,CAAC;QAClE,WAAW,EAAE,CAAC,uDAAyB,CAAC;QACxC,QAAQ,EAAE,CAAC,mCAAY,EAAE,uCAAc,CAAC;QACxC,aAAa,EAAE,QAAQ;QACvB,kBAAkB,EAAE;YAChB,MAAM,EAAE,0CAA8B;YACtC,SAAS,EAAE,CAAC,yCAA6B,CAAC;SAC7C;KACJ,CAAC;GACW,sBAAsB,CAkElC"}

package/dist/visitor-tracking.controller.d.ts

@@ -56,7 +56,7 @@ export declare class VisitorTrackingController implements OnApplicationBootstrap
      * Each event payload:
      *   data: { ts, activeCount, recent: [{ visitorId, url, country, secondsAgo }] }
      */
-    live(ctx: RequestContext, req: Request, res: Response): Promise<void>;
+    live(ctx: RequestContext, req: Request, res: Response): Promise<Response<any, Record<string, any>> | undefined>;
     /** Journey timeline for one visitor — every event in order. */
     journey(ctx: RequestContext, visitorId: string, res: Response): Promise<Response<any, Record<string, any>> | undefined>;
     /** Recent visitors — paginated via take + skip. */

package/dist/visitor-tracking.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visitor-tracking.controller.d.ts","sourceRoot":"","sources":["../src/visitor-tracking.controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"visitor-tracking.controller.d.ts","sourceRoot":"","sources":["../src/visitor-tracking.controller.ts"],"names":[],"mappings":"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"}

package/dist/visitor-tracking.controller.js

@@ -24,6 +24,35 @@ const COOKIE_VISITOR = 'ees_vid';
 const COOKIE_SESSION = 'ees_sid';
 const VISITOR_TTL_DAYS = 730; // ~2 years
 const SESSION_IDLE_MIN = 30; // 30-minute idle session timeout
+/** Free-tier daily event cap. 100 / UTC day across the whole install
+ *  — enough to evaluate, not enough to run a real store on. The
+ *  counter is in-memory only (acceptable: free-tier installs aren't
+ *  multi-instance anyway, and resetting on restart works in the
+ *  customer's favour). */
+const FREE_TIER_DAILY_CAP = 100;
+const freeTierBudget = (() => {
+    let day = '';
+    let used = 0;
+    return {
+        consume(n) {
+            const today = new Date().toISOString().slice(0, 10);
+            if (today !== day) {
+                day = today;
+                used = 0;
+            }
+            if (used + n > FREE_TIER_DAILY_CAP)
+                return false;
+            used += n;
+            return true;
+        },
+        snapshot() {
+            const today = new Date().toISOString().slice(0, 10);
+            if (today !== day)
+                return { day: today, used: 0, cap: FREE_TIER_DAILY_CAP };
+            return { day, used, cap: FREE_TIER_DAILY_CAP };
+        },
+    };
+})();
 function requireAdmin(ctx, res) {
     if (!(ctx === null || ctx === void 0 ? void 0 : ctx.activeUserId)) {
         res.status(401).json({ error: 'Authentication required' });
@@ -107,6 +136,15 @@ let VisitorTrackingController = class VisitorTrackingController {
             return res.status(204).end();
         if (this.rateLimited(req, res, 'track'))
             return;
+        // Tier-gate: unlicensed installs are capped at 100 events / UTC day.
+        // Once the cap is hit, /track returns 200 with `skipped: 'free-tier-cap'`
+        // so the storefront's beacon doesn't surface errors to end users.
+        if (!(0, vendure_licence_sdk_1.isLicensed)(plugin_1.VisitorAnalyticsPlugin.getLicenceStatus())) {
+            const eventsLen = Array.isArray((body || {}).events) ? body.events.length : 1;
+            if (!freeTierBudget.consume(eventsLen)) {
+                return res.json({ stored: 0, skipped: 'free-tier-cap', cap: FREE_TIER_DAILY_CAP });
+            }
+        }
         const opts = (0, plugin_1.getOptions)();
         // Privacy: honour Do-Not-Track when configured. We still return 200
         // so the storefront can't tell the difference between "stored" and
@@ -397,6 +435,9 @@ let VisitorTrackingController = class VisitorTrackingController {
         var _a;
         if (!requireAdmin(ctx, res))
             return;
+        if (!(0, vendure_licence_sdk_1.isLicensed)(plugin_1.VisitorAnalyticsPlugin.getLicenceStatus())) {
+            return res.status(402).json((0, vendure_licence_sdk_1.premiumFeatureError)('vendure-plugin-visitor-analytics'));
+        }
         res.setHeader('Content-Type', 'text/event-stream');
         res.setHeader('Cache-Control', 'no-cache, no-transform');
         res.setHeader('Connection', 'keep-alive');
@@ -656,6 +697,9 @@ let VisitorTrackingController = class VisitorTrackingController {
     async createGoal(ctx, body, res) {
         if (!requireAdmin(ctx, res))
             return;
+        if (!(0, vendure_licence_sdk_1.isLicensed)(plugin_1.VisitorAnalyticsPlugin.getLicenceStatus())) {
+            return res.status(402).json((0, vendure_licence_sdk_1.premiumFeatureError)('vendure-plugin-visitor-analytics'));
+        }
         const repo = this.connection.rawConnection.getRepository(conversion_goal_entity_1.ConversionGoal);
         const row = repo.create({
             channelId: Number(body === null || body === void 0 ? void 0 : body.channelId) || 1,
@@ -727,6 +771,9 @@ let VisitorTrackingController = class VisitorTrackingController {
     async exportCsv(ctx, req, res) {
         if (!requireAdmin(ctx, res))
             return;
+        if (!(0, vendure_licence_sdk_1.isLicensed)(plugin_1.VisitorAnalyticsPlugin.getLicenceStatus())) {
+            return res.status(402).json((0, vendure_licence_sdk_1.premiumFeatureError)('vendure-plugin-visitor-analytics'));
+        }
         const days = Math.min(Math.max(parseInt(String(req.query.days || '7'), 10) || 7, 1), 90);
         const rows = await this.connection.rawConnection.query(`SELECT createdAt, visitorId, sessionId, customerId, channelId,
                     type, url, title, referrerDomain,