@huloglobal/vendure-plugin-visitor-analytics 0.7.0 → 0.8.1

package/dist/journey-buffs.service.js

@@ -0,0 +1,141 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JourneyBuffsService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+/**
+ * Zero-schema-cost enrichment endpoints for the per-visitor Journey
+ * drawer and store-wide UX signals.
+ *
+ * Each of these queries reads back over the existing `visitor_event`
+ * table where the storefront has fired named custom events. No new
+ * columns, no new tables — the storefront helper is documented in the
+ * plugin README and dispatches events into the existing
+ * `POST /ees/track` endpoint.
+ */
+let JourneyBuffsService = class JourneyBuffsService {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Store-wide rage-click hot spots — the URLs where visitors are
+     * most frustrated. `hulo.rageClick(url, selector)` on the
+     * storefront populates the underlying event.
+     */
+    async rageClickHotSpots(sinceDays = 7, channelId = 1, limit = 20) {
+        const since = new Date(Date.now() - sinceDays * 86400000);
+        const rows = await this.connection.rawConnection.query(`SELECT
+                url,
+                COUNT(*) AS rageClicks,
+                COUNT(DISTINCT visitorId) AS uniqueVisitors
+             FROM visitor_event
+             WHERE type = 'event'
+               AND meta LIKE '%"eventType":"rage_click"%'
+               AND channelId = ?
+               AND createdAt >= ?
+             GROUP BY url
+             ORDER BY rageClicks DESC
+             LIMIT ?`, [channelId, since, Math.min(Math.max(1, limit), 200)]);
+        return rows.map(r => ({
+            url: String(r.url || ''),
+            rageClicks: Number(r.rageClicks),
+            uniqueVisitors: Number(r.uniqueVisitors),
+        }));
+    }
+    /**
+     * Dead-click hot spots — clicks on non-interactive elements. Same
+     * shape as rage-click aggregation but keyed on the `dead_click`
+     * event type. Useful for spotting elements that LOOK clickable
+     * (styled headings, disabled buttons, decorative cards).
+     */
+    async deadClickHotSpots(sinceDays = 7, channelId = 1, limit = 20) {
+        const since = new Date(Date.now() - sinceDays * 86400000);
+        const rows = await this.connection.rawConnection.query(`SELECT
+                url,
+                COUNT(*) AS deadClicks,
+                COUNT(DISTINCT visitorId) AS uniqueVisitors
+             FROM visitor_event
+             WHERE type = 'event'
+               AND meta LIKE '%"eventType":"dead_click"%'
+               AND channelId = ?
+               AND createdAt >= ?
+             GROUP BY url
+             ORDER BY deadClicks DESC
+             LIMIT ?`, [channelId, since, Math.min(Math.max(1, limit), 200)]);
+        return rows.map(r => ({
+            url: String(r.url || ''),
+            deadClicks: Number(r.deadClicks),
+            uniqueVisitors: Number(r.uniqueVisitors),
+        }));
+    }
+    /**
+     * Per-visitor session summary — one row per session with a
+     * heuristic `intent` label. Used to enrich the Journey drawer
+     * with a one-line "what did this session do".
+     */
+    async sessionSummary(visitorId, limit = 25) {
+        const rows = await this.connection.rawConnection.query(`SELECT
+                sessionId,
+                MIN(createdAt) AS startedAt,
+                MAX(createdAt) AS endedAt,
+                COUNT(*) AS pageCount,
+                SUM(type = 'event' AND meta LIKE '%"eventType":"add_to_cart"%') > 0        AS addedToCart,
+                SUM(type = 'event' AND meta LIKE '%"eventType":"checkout_completed"%') > 0 AS checkedOut,
+                SUM(type = 'event' AND meta LIKE '%"eventType":"cart_snapshot"%') > 0      AS hadCartSnapshot,
+                SUM(type = 'event' AND meta LIKE '%"eventType":"rage_click"%') > 0         AS rageClicked
+             FROM visitor_event
+             WHERE visitorId = ?
+             GROUP BY sessionId
+             ORDER BY startedAt DESC
+             LIMIT ?`, [visitorId, Math.min(Math.max(1, limit), 200)]);
+        return rows.map(r => {
+            const start = new Date(r.startedAt);
+            const end = new Date(r.endedAt);
+            const durationSec = Math.max(0, Math.round((end.getTime() - start.getTime()) / 1000));
+            const pageCount = Number(r.pageCount);
+            const addedToCart = !!Number(r.addedToCart);
+            const checkedOut = !!Number(r.checkedOut);
+            const hadCartSnapshot = !!Number(r.hadCartSnapshot);
+            const rageClicked = !!Number(r.rageClicked);
+            let intent;
+            if (checkedOut)
+                intent = 'purchase';
+            else if (hadCartSnapshot || addedToCart)
+                intent = 'abandon';
+            else if (rageClicked)
+                intent = 'frustrate';
+            else if (pageCount <= 1 && durationSec < 15)
+                intent = 'bounce';
+            else if (pageCount >= 5)
+                intent = 'consider';
+            else
+                intent = 'browse';
+            return {
+                sessionId: String(r.sessionId),
+                startedAt: start.toISOString(),
+                endedAt: end.toISOString(),
+                durationSec,
+                pageCount,
+                addedToCart,
+                checkedOut,
+                rageClicked,
+                intent,
+            };
+        });
+    }
+};
+exports.JourneyBuffsService = JourneyBuffsService;
+exports.JourneyBuffsService = JourneyBuffsService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.TransactionalConnection])
+], JourneyBuffsService);
+//# sourceMappingURL=journey-buffs.service.js.map

package/dist/journey-buffs.service.js.map

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

package/dist/plugin.d.ts

@@ -1,5 +1,6 @@
 import { Type } from '@vendure/core';
 import { LicenceStatus, RetentionOptions, UpdateChecker } from '@huloglobal/vendure-licence-sdk';
+import { AbandonmentOptions } from './abandoned-cart.service';
 export interface VisitorAnalyticsPluginOptions {
     /** Public host of the Vendure server. Used in licence host-match. */
     publicBaseUrl: string;
@@ -38,6 +39,10 @@ export interface VisitorAnalyticsPluginOptions {
     corsAllowedOrigins?: string[];
     /** Auto-prune `visitor_event` rows older than `days` days. */
     retention?: RetentionOptions;
+    /** Options for the abandoned-cart feature. Storefront must fire
+     *  `cart_snapshot` custom events for anything to be detected. See
+     *  the README for the recommended storefront helper. */
+    abandonment?: AbandonmentOptions;
 }
 declare const DEFAULT_OPTIONS: VisitorAnalyticsPluginOptions;
 export declare function getOptions(): typeof DEFAULT_OPTIONS & VisitorAnalyticsPluginOptions;

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,EAAmC,aAAa,EAAE,gBAAgB,EAAqB,aAAa,EAA4C,MAAM,iCAAiC,CAAC;AAW/L,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;IAoDjF,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,EAA4C,MAAM,iCAAiC,CAAC;AAM/L,OAAO,EAAwB,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAiBpF,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;IAG7B;;4DAEwD;IACxD,WAAW,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAgBD,QAAA,MAAM,eAAe,EAAE,6BAMtB,CAAC;AAGF,wBAAgB,UAAU,IAAI,OAAO,eAAe,GAAG,6BAA6B,CAEnF;AAED;;;;;;;;;;;GAWG;AACH,qBA0Ba,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;IAoDjF,MAAM,CAAC,YAAY;;;;;;;;MAUjB;CACL"}

package/dist/plugin.js

@@ -13,9 +13,21 @@ const core_1 = require("@vendure/core");
 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 abandoned_cart_entity_1 = require("./abandoned-cart.entity");
+const product_co_view_entity_1 = require("./product-co-view.entity");
 const visitor_tracking_service_1 = require("./visitor-tracking.service");
+const abandoned_cart_service_1 = require("./abandoned-cart.service");
+const recommendations_service_1 = require("./recommendations.service");
+const search_analytics_service_1 = require("./search-analytics.service");
+const journey_buffs_service_1 = require("./journey-buffs.service");
+const abandoned_cart_scanner_1 = require("./abandoned-cart.scanner");
 const admin_api_1 = require("./admin-api");
 const visitor_tracking_controller_1 = require("./visitor-tracking.controller");
+const abandoned_cart_controller_1 = require("./abandoned-cart.controller");
+const recommendations_controller_1 = require("./recommendations.controller");
+const search_analytics_controller_1 = require("./search-analytics.controller");
+const journey_buffs_controller_1 = require("./journey-buffs.controller");
+const storefront_helper_controller_1 = require("./storefront-helper.controller");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const PKG_VERSION = require('../package.json').version;
 const PKG_NAME = '@huloglobal/vendure-plugin-visitor-analytics';
@@ -122,9 +134,24 @@ VisitorAnalyticsPlugin.uiExtensions = {
 exports.VisitorAnalyticsPlugin = VisitorAnalyticsPlugin = VisitorAnalyticsPlugin_1 = __decorate([
     (0, core_1.VendurePlugin)({
         imports: [core_1.PluginCommonModule],
-        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],
+        providers: [
+            visitor_tracking_service_1.VisitorTrackingService,
+            admin_api_1.VisitorAnalyticsAdminResolver,
+            abandoned_cart_service_1.AbandonedCartService,
+            recommendations_service_1.RecommendationsService,
+            search_analytics_service_1.SearchAnalyticsService,
+            journey_buffs_service_1.JourneyBuffsService,
+            abandoned_cart_scanner_1.AbandonedCartScanner,
+        ],
+        controllers: [
+            visitor_tracking_controller_1.VisitorTrackingController,
+            abandoned_cart_controller_1.AbandonedCartController,
+            recommendations_controller_1.RecommendationsController,
+            search_analytics_controller_1.SearchAnalyticsController,
+            journey_buffs_controller_1.JourneyBuffsController,
+            storefront_helper_controller_1.StorefrontHelperController,
+        ],
+        entities: [visitor_event_entity_1.VisitorEvent, conversion_goal_entity_1.ConversionGoal, abandoned_cart_entity_1.AbandonedCart, product_co_view_entity_1.ProductCoView],
         compatibility: '^3.0.0',
         adminApiExtensions: {
             schema: admin_api_1.visitorAnalyticsAdminApiSchema,

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":";;;;;;;;;;AAgGA,gCAEC;AAlGD,wCAAwE;AACxE,yEAA+L;AAC/L,qEAA0D;AAC1D,iEAAsD;AACtD,mEAAwD;AACxD,qEAAyD;AACzD,yEAAoE;AACpE,qEAAoF;AACpF,uEAAmE;AACnE,yEAAoE;AACpE,mEAA8D;AAC9D,qEAAgE;AAChE,2CAA4F;AAC5F,+EAA0E;AAC1E,2EAAsE;AACtE,6EAAyE;AACzE,+EAA0E;AAC1E,yEAAoE;AACpE,iFAA4E;AAE5E,8DAA8D;AAC9D,MAAM,WAAW,GAAW,OAAO,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC;AAC/D,MAAM,QAAQ,GAAG,8CAA8C,CAAC;AAmDhE,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;AA2BI,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,yDAAyD;QACzD,iDAAiD;QACjD,IAAA,+CAAyB,EAAC;YACtB,iBAAiB,EAAE,QAAQ;YAC3B,oBAAoB,EAAE,WAAW;YACjC,cAAc,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE;SACjD,CAAC,CAAC;QAEH,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;;AA7DQ,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;AA2DnD,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;iCAzEO,sBAAsB;IA1BlC,IAAA,oBAAa,EAAC;QACX,OAAO,EAAE,CAAC,yBAAkB,CAAC;QAC7B,SAAS,EAAE;YACP,iDAAsB;YACtB,yCAA6B;YAC7B,6CAAoB;YACpB,gDAAsB;YACtB,iDAAsB;YACtB,2CAAmB;YACnB,6CAAoB;SACvB;QACD,WAAW,EAAE;YACT,uDAAyB;YACzB,mDAAuB;YACvB,sDAAyB;YACzB,uDAAyB;YACzB,iDAAsB;YACtB,yDAA0B;SAC7B;QACD,QAAQ,EAAE,CAAC,mCAAY,EAAE,uCAAc,EAAE,qCAAa,EAAE,sCAAa,CAAC;QACtE,aAAa,EAAE,QAAQ;QACvB,kBAAkB,EAAE;YAChB,MAAM,EAAE,0CAA8B;YACtC,SAAS,EAAE,CAAC,yCAA6B,CAAC;SAC7C;KACJ,CAAC;GACW,sBAAsB,CA0ElC"}

package/dist/product-co-view.entity.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Aggregate table for "customers who viewed X also viewed Y".
+ *
+ * Denormalised: we store both `(A, B)` and `(B, A)` so lookups by either
+ * side are a single indexed scan. Cheap on disk (int, int, int, int),
+ * expensive nowhere.
+ *
+ * Rebuilt by a nightly cron that walks recent `product_view` events per
+ * session, extracts all ordered pairs, and increments the counter. The
+ * scanner also decays old scores so trending products bubble up.
+ */
+export declare class ProductCoView {
+    productIdA: number;
+    productIdB: number;
+    channelId: number;
+    viewsTogether: number;
+    lastUpdated: Date;
+}
+//# sourceMappingURL=product-co-view.entity.d.ts.map

package/dist/product-co-view.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-co-view.entity.d.ts","sourceRoot":"","sources":["../src/product-co-view.entity.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,qBAEa,aAAa;IAEtB,UAAU,EAAG,MAAM,CAAC;IAGpB,UAAU,EAAG,MAAM,CAAC;IAGpB,SAAS,EAAG,MAAM,CAAC;IAGnB,aAAa,EAAG,MAAM,CAAC;IAGvB,WAAW,EAAG,IAAI,CAAC;CACtB"}

package/dist/product-co-view.entity.js

@@ -0,0 +1,52 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductCoView = void 0;
+const typeorm_1 = require("typeorm");
+/**
+ * Aggregate table for "customers who viewed X also viewed Y".
+ *
+ * Denormalised: we store both `(A, B)` and `(B, A)` so lookups by either
+ * side are a single indexed scan. Cheap on disk (int, int, int, int),
+ * expensive nowhere.
+ *
+ * Rebuilt by a nightly cron that walks recent `product_view` events per
+ * session, extracts all ordered pairs, and increments the counter. The
+ * scanner also decays old scores so trending products bubble up.
+ */
+let ProductCoView = class ProductCoView {
+};
+exports.ProductCoView = ProductCoView;
+__decorate([
+    (0, typeorm_1.PrimaryColumn)({ type: 'int' }),
+    __metadata("design:type", Number)
+], ProductCoView.prototype, "productIdA", void 0);
+__decorate([
+    (0, typeorm_1.PrimaryColumn)({ type: 'int' }),
+    __metadata("design:type", Number)
+], ProductCoView.prototype, "productIdB", void 0);
+__decorate([
+    (0, typeorm_1.PrimaryColumn)({ type: 'int', default: 1 }),
+    __metadata("design:type", Number)
+], ProductCoView.prototype, "channelId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', default: 0 }),
+    __metadata("design:type", Number)
+], ProductCoView.prototype, "viewsTogether", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', precision: 3 }),
+    __metadata("design:type", Date)
+], ProductCoView.prototype, "lastUpdated", void 0);
+exports.ProductCoView = ProductCoView = __decorate([
+    (0, typeorm_1.Entity)('product_co_view'),
+    (0, typeorm_1.Index)('product_co_view_score_idx', ['productIdA', 'channelId', 'viewsTogether'])
+], ProductCoView);
+//# sourceMappingURL=product-co-view.entity.js.map

package/dist/product-co-view.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-co-view.entity.js","sourceRoot":"","sources":["../src/product-co-view.entity.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAA+D;AAE/D;;;;;;;;;;GAUG;AAGI,IAAM,aAAa,GAAnB,MAAM,aAAa;CAezB,CAAA;AAfY,sCAAa;AAEtB;IADC,IAAA,uBAAa,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;;iDACX;AAGpB;IADC,IAAA,uBAAa,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;;iDACX;AAGpB;IADC,IAAA,uBAAa,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;gDACxB;AAGnB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;;oDACb;AAGvB;IADC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;8BAC7B,IAAI;kDAAC;wBAdV,aAAa;IAFzB,IAAA,gBAAM,EAAC,iBAAiB,CAAC;IACzB,IAAA,eAAK,EAAC,2BAA2B,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;GACpE,aAAa,CAezB"}

package/dist/recommendations.controller.d.ts

@@ -0,0 +1,72 @@
+import { RequestContext } from '@vendure/core';
+import { RecommendationsService } from './recommendations.service';
+/**
+ * Public + admin API for the co-view recommendations feature.
+ *
+ * The `also-viewed`, `personal` and `trending` endpoints are safe to
+ * hit from the storefront directly — they return only product ids +
+ * scores, no PII. Restricting them to Vendure admin would break the
+ * primary use case (rendering a recs rail on the product page).
+ */
+export declare class RecommendationsController {
+    private readonly service;
+    constructor(service: RecommendationsService);
+    /**
+     * "Customers who viewed X also viewed…"
+     *   /ees/recommendations/also-viewed?productId=42&channelId=1&limit=10
+     */
+    alsoViewed(pRaw?: string, chRaw?: string, lRaw?: string): Promise<{
+        error: string;
+        productId?: undefined;
+        items?: undefined;
+    } | {
+        productId: number;
+        items: {
+            productId: number;
+            score: number;
+        }[];
+        error?: undefined;
+    }>;
+    /**
+     * Personalised recs for a returning visitor:
+     *   /ees/recommendations/personal?visitorId=abc&channelId=1&limit=10
+     *
+     * Storefronts should send the current `ees_vid` cookie value —
+     * the same one the ingest endpoint issues.
+     */
+    personal(vRaw?: string, chRaw?: string, lRaw?: string): Promise<{
+        error: string;
+        visitorId?: undefined;
+        items?: undefined;
+    } | {
+        visitorId: string;
+        items: {
+            productId: number;
+            score: number;
+        }[];
+        error?: undefined;
+    }>;
+    /**
+     * Most-viewed products in the window:
+     *   /ees/recommendations/trending?channelId=1&hours=24&limit=10
+     */
+    trending(chRaw?: string, hRaw?: string, lRaw?: string): Promise<{
+        channelId: number;
+        hours: number;
+        items: {
+            productId: number;
+            views: number;
+        }[];
+    }>;
+    /**
+     * Admin-only: manually kick the aggregation cron. Normally runs
+     * nightly, but this is useful for smoke-testing after a data
+     * backfill, or for pushing a big spike through immediately.
+     */
+    aggregateNow(ctx: RequestContext, hRaw?: string): Promise<{
+        pairs: number;
+        ok: boolean;
+        hours: number;
+    }>;
+}
+//# sourceMappingURL=recommendations.controller.d.ts.map

package/dist/recommendations.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.controller.d.ts","sourceRoot":"","sources":["../src/recommendations.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,cAAc,EAAqB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;;;GAOG;AACH,qBACa,yBAAyB;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,sBAAsB;IAE5D;;;OAGG;IAEG,UAAU,CACQ,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM;;;;;;;;;;;;IAUrC;;;;;;OAMG;IAEG,QAAQ,CACU,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM;;;;;;;;;;;;IAUrC;;;OAGG;IAEG,QAAQ,CACU,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM;;;;;;;;IASrC;;;;OAIG;IAGG,YAAY,CAAQ,GAAG,EAAE,cAAc,EAAkB,IAAI,CAAC,EAAE,MAAM;;;;;CAK/E"}

package/dist/recommendations.controller.js

@@ -0,0 +1,123 @@
+"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.RecommendationsController = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const recommendations_service_1 = require("./recommendations.service");
+/**
+ * Public + admin API for the co-view recommendations feature.
+ *
+ * The `also-viewed`, `personal` and `trending` endpoints are safe to
+ * hit from the storefront directly — they return only product ids +
+ * scores, no PII. Restricting them to Vendure admin would break the
+ * primary use case (rendering a recs rail on the product page).
+ */
+let RecommendationsController = class RecommendationsController {
+    constructor(service) {
+        this.service = service;
+    }
+    /**
+     * "Customers who viewed X also viewed…"
+     *   /ees/recommendations/also-viewed?productId=42&channelId=1&limit=10
+     */
+    async alsoViewed(pRaw, chRaw, lRaw) {
+        const productId = parseInt(pRaw || '0', 10);
+        if (!productId)
+            return { error: 'productId-required' };
+        const channelId = parseInt(chRaw || '1', 10) || 1;
+        const limit = parseInt(lRaw || '10', 10) || 10;
+        const items = await this.service.alsoViewed(productId, channelId, limit);
+        return { productId, items };
+    }
+    /**
+     * Personalised recs for a returning visitor:
+     *   /ees/recommendations/personal?visitorId=abc&channelId=1&limit=10
+     *
+     * Storefronts should send the current `ees_vid` cookie value —
+     * the same one the ingest endpoint issues.
+     */
+    async personal(vRaw, chRaw, lRaw) {
+        const visitorId = String(vRaw || '').trim();
+        if (!visitorId)
+            return { error: 'visitorId-required' };
+        const channelId = parseInt(chRaw || '1', 10) || 1;
+        const limit = parseInt(lRaw || '10', 10) || 10;
+        const items = await this.service.personalRecommendations(visitorId, channelId, limit);
+        return { visitorId, items };
+    }
+    /**
+     * Most-viewed products in the window:
+     *   /ees/recommendations/trending?channelId=1&hours=24&limit=10
+     */
+    async trending(chRaw, hRaw, lRaw) {
+        const channelId = parseInt(chRaw || '1', 10) || 1;
+        const hours = Math.min(Math.max(1, parseInt(hRaw || '24', 10) || 24), 24 * 30);
+        const limit = parseInt(lRaw || '10', 10) || 10;
+        const items = await this.service.trending(channelId, hours, limit);
+        return { channelId, hours, items };
+    }
+    /**
+     * Admin-only: manually kick the aggregation cron. Normally runs
+     * nightly, but this is useful for smoke-testing after a data
+     * backfill, or for pushing a big spike through immediately.
+     */
+    async aggregateNow(ctx, hRaw) {
+        const hours = Math.min(Math.max(1, parseInt(hRaw || '24', 10) || 24), 24 * 30);
+        const result = await this.service.aggregateCoViews(hours);
+        return { ok: true, hours, ...result };
+    }
+};
+exports.RecommendationsController = RecommendationsController;
+__decorate([
+    (0, common_1.Get)('recommendations/also-viewed'),
+    __param(0, (0, common_1.Query)('productId')),
+    __param(1, (0, common_1.Query)('channelId')),
+    __param(2, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], RecommendationsController.prototype, "alsoViewed", null);
+__decorate([
+    (0, common_1.Get)('recommendations/personal'),
+    __param(0, (0, common_1.Query)('visitorId')),
+    __param(1, (0, common_1.Query)('channelId')),
+    __param(2, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], RecommendationsController.prototype, "personal", null);
+__decorate([
+    (0, common_1.Get)('recommendations/trending'),
+    __param(0, (0, common_1.Query)('channelId')),
+    __param(1, (0, common_1.Query)('hours')),
+    __param(2, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String]),
+    __metadata("design:returntype", Promise)
+], RecommendationsController.prototype, "trending", null);
+__decorate([
+    (0, common_1.Get)('recommendations/aggregate-now'),
+    (0, core_1.Allow)(core_1.Permission.SuperAdmin),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Query)('hours')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String]),
+    __metadata("design:returntype", Promise)
+], RecommendationsController.prototype, "aggregateNow", null);
+exports.RecommendationsController = RecommendationsController = __decorate([
+    (0, common_1.Controller)('ees'),
+    __metadata("design:paramtypes", [recommendations_service_1.RecommendationsService])
+], RecommendationsController);
+//# sourceMappingURL=recommendations.controller.js.map

package/dist/recommendations.controller.js.map

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

package/dist/recommendations.service.d.ts

@@ -0,0 +1,62 @@
+import { TransactionalConnection } from '@vendure/core';
+/**
+ * Product recommendations driven by observed co-viewing behaviour.
+ *
+ * The scanner walks recent `product_view` custom events grouped by
+ * session, extracts every ordered pair, and increments a counter per
+ * `(productIdA, productIdB, channelId)` triple. We denormalise both
+ * directions (`A → B` AND `B → A`) so read-side lookups are one
+ * indexed scan.
+ *
+ * "Also viewed" is far simpler than "also bought" — you need orders
+ * data for the latter, and small stores don't have enough of it for
+ * useful signals. Co-views come from every browsing session, so a
+ * store with 1k daily visitors gets useful recs from day one.
+ */
+export declare class RecommendationsService {
+    private connection;
+    constructor(connection: TransactionalConnection);
+    /**
+     * Rebuild the co-view aggregate from `visitor_event`. Idempotent
+     * per (A, B, channelId) — repeated calls over the same window
+     * accumulate, so schedule this as a nightly cron with a rolling
+     * lookback (e.g. last 24h) rather than a full-history rescan.
+     *
+     * Returns the number of pair-triples updated. Uses a bounded
+     * ordered-pair extractor (max 20 events per session) so a single
+     * bot session can't skew the table.
+     */
+    aggregateCoViews(sinceHours?: number): Promise<{
+        pairs: number;
+    }>;
+    /**
+     * Read side: "customers who viewed X also viewed Y" for one
+     * product, ordered by co-view score, capped at `limit`. Returns
+     * bare product ids so the storefront can hydrate names / images
+     * from its usual product-fetch path.
+     */
+    alsoViewed(productId: number, channelId?: number, limit?: number): Promise<Array<{
+        productId: number;
+        score: number;
+    }>>;
+    /**
+     * Personalised recommendations for a returning visitor: look at
+     * the last N products they viewed, and rank co-viewed products by
+     * combined score across those seed products (excluding the seeds
+     * themselves).
+     */
+    personalRecommendations(visitorId: string, channelId?: number, limit?: number): Promise<Array<{
+        productId: number;
+        score: number;
+    }>>;
+    /**
+     * "Trending now" — most-viewed products in the last N hours.
+     * Useful for a homepage rail; uses `product_view` events, so it
+     * reflects real interest, not just search-console clicks.
+     */
+    trending(channelId?: number, sinceHours?: number, limit?: number): Promise<Array<{
+        productId: number;
+        views: number;
+    }>>;
+}
+//# sourceMappingURL=recommendations.service.d.ts.map

package/dist/recommendations.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.service.d.ts","sourceRoot":"","sources":["../src/recommendations.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAIxD;;;;;;;;;;;;;GAaG;AACH,qBACa,sBAAsB;IACnB,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,uBAAuB;IAEvD;;;;;;;;;OASG;IACG,gBAAgB,CAAC,UAAU,SAAK,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAyDnE;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1E,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAYH;;;;;OAKG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAI,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QACvF,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IA+BH;;;;OAIG;IACG,QAAQ,CAAC,SAAS,SAAI,EAAE,UAAU,SAAK,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QACtE,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CAmBN"}