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

package/dist/abandoned-cart.service.js.map

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

package/dist/hulo-storefront.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The single-file storefront helper the plugin serves at /ees/hulo.js.
+ *
+ * Written as a string constant (not a bundled module) because:
+ *   - It's tiny (< 6kB minified) — a bundler adds more than the code
+ *   - It ships to the browser verbatim, no compile step
+ *   - Customers can inspect / audit it without a source map
+ *   - It has ZERO npm dependencies at runtime
+ *
+ * The controller wraps this in a small template that injects the
+ * public base URL and a default channel id, so a storefront paste
+ * of `<script src="https://backend/ees/hulo.js"></script>` Just Works
+ * with no config. Advanced users can call `hulo.configure({ ... })`
+ * to override.
+ */
+export declare const HULO_STOREFRONT_JS: (backendBaseUrl: string, defaultChannelId?: number) => string;
+//# sourceMappingURL=hulo-storefront.d.ts.map

package/dist/hulo-storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hulo-storefront.d.ts","sourceRoot":"","sources":["../src/hulo-storefront.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,GAAI,gBAAgB,MAAM,EAAE,yBAAoB,KAAG,MA4QjF,CAAC"}

package/dist/hulo-storefront.js

@@ -0,0 +1,289 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HULO_STOREFRONT_JS = void 0;
+/**
+ * The single-file storefront helper the plugin serves at /ees/hulo.js.
+ *
+ * Written as a string constant (not a bundled module) because:
+ *   - It's tiny (< 6kB minified) — a bundler adds more than the code
+ *   - It ships to the browser verbatim, no compile step
+ *   - Customers can inspect / audit it without a source map
+ *   - It has ZERO npm dependencies at runtime
+ *
+ * The controller wraps this in a small template that injects the
+ * public base URL and a default channel id, so a storefront paste
+ * of `<script src="https://backend/ees/hulo.js"></script>` Just Works
+ * with no config. Advanced users can call `hulo.configure({ ... })`
+ * to override.
+ */
+const HULO_STOREFRONT_JS = (backendBaseUrl, defaultChannelId = 1) => `
+// hulo storefront helper — @huloglobal/vendure-plugin-visitor-analytics
+// Public domain when served from your own store; do not resell.
+(function (global) {
+  var CONFIG = {
+    endpoint: ${JSON.stringify(backendBaseUrl.replace(/\/$/, '') + '/ees/track')},
+    recoverEndpoint: ${JSON.stringify(backendBaseUrl.replace(/\/$/, '') + '/ees/recover-cart')},
+    channelId: ${defaultChannelId},
+    debug: false,
+    autoRageClick: true,
+    autoDeadClick: true,
+    autoScroll: false,   // not implemented yet — flag reserved
+  };
+
+  // ── queue + batched send ─────────────────────────────────────────
+  // Every helper below pushes into a queue. Flush on requestIdleCallback
+  // or 2s max. Coalesces bursts of events into one HTTP roundtrip.
+  var QUEUE = [];
+  var FLUSH_TIMER = null;
+  function enqueue(event) {
+    event.url = event.url || location.href;
+    event.channelId = event.channelId || CONFIG.channelId;
+    QUEUE.push(event);
+    scheduleFlush();
+    if (CONFIG.debug) console.log('[hulo]', event);
+  }
+  function scheduleFlush() {
+    if (FLUSH_TIMER) return;
+    FLUSH_TIMER = setTimeout(flush, 1500);
+  }
+  function flush() {
+    FLUSH_TIMER = null;
+    if (!QUEUE.length) return;
+    var batch = QUEUE.splice(0, QUEUE.length);
+    var payload = JSON.stringify({ events: batch });
+    // Prefer sendBeacon on unload (survives page transitions) and
+    // fall back to fetch keepalive for normal calls.
+    try {
+      if (navigator.sendBeacon) {
+        var blob = new Blob([payload], { type: 'application/json' });
+        if (navigator.sendBeacon(CONFIG.endpoint, blob)) return;
+      }
+    } catch (_e) {}
+    try {
+      fetch(CONFIG.endpoint, {
+        method: 'POST', credentials: 'include', keepalive: true,
+        headers: { 'content-type': 'application/json' },
+        body: payload,
+      }).catch(function () { /* silent */ });
+    } catch (_e) {}
+  }
+  // Flush before the page dies.
+  window.addEventListener('pagehide', flush, { capture: true });
+  window.addEventListener('beforeunload', flush, { capture: true });
+
+  // ── public API ───────────────────────────────────────────────────
+  var hulo = {
+    configure: function (opts) { Object.assign(CONFIG, opts || {}); },
+    flush: flush,
+
+    /** Fire once per pageview. Optional — the ingest endpoint infers
+     *  pageviews from the referrer / URL, but calling this explicitly
+     *  captures the title too. */
+    pageview: function (extra) {
+      enqueue(Object.assign({ type: 'pageview', title: document.title }, extra || {}));
+    },
+
+    /** Product detail viewed. Store the product id you would use to
+     *  fetch the product server-side (Vendure product.id). If your
+     *  storefront uses variants primarily, pass variantId too. */
+    productView: function (productId, productVariantId) {
+      if (!productId && productId !== 0) return;
+      enqueue({
+        type: 'event',
+        meta: JSON.stringify({
+          eventType: 'product_view',
+          productId: Number(productId),
+          productVariantId: productVariantId != null ? Number(productVariantId) : undefined,
+        }),
+      });
+    },
+
+    /** Item added to cart. Fire on every add — not just the first. */
+    addToCart: function (variantId, qty, unitPriceMinor) {
+      enqueue({
+        type: 'event',
+        meta: JSON.stringify({
+          eventType: 'add_to_cart',
+          variantId: variantId != null ? Number(variantId) : undefined,
+          qty: qty != null ? Number(qty) : 1,
+          unitPriceMinor: unitPriceMinor != null ? Number(unitPriceMinor) : undefined,
+        }),
+      });
+    },
+
+    /** Cart snapshot — fire on every cart change (add / remove / qty).
+     *  The abandonment scanner reads only this event, so fire it
+     *  liberally. Payload shape:
+     *   { currency, totalMinor, itemCount, items: [{ variantId, name, qty, unitPriceMinor }], email? } */
+    cartSnapshot: function (cart) {
+      if (!cart || !cart.items || !cart.items.length) return;
+      enqueue({
+        type: 'event',
+        meta: JSON.stringify({
+          eventType: 'cart_snapshot',
+          currency: (cart.currency || 'GBP').toUpperCase().slice(0, 3),
+          totalMinor: Number(cart.totalMinor || 0),
+          itemCount: Number(cart.itemCount || cart.items.length),
+          items: cart.items.map(function (i) {
+            return {
+              variantId: i.variantId != null ? Number(i.variantId) : undefined,
+              productId: i.productId != null ? Number(i.productId) : undefined,
+              name: i.name != null ? String(i.name).slice(0, 200) : undefined,
+              qty: Number(i.qty != null ? i.qty : (i.quantity != null ? i.quantity : 1)),
+              unitPriceMinor: Number(i.unitPriceMinor != null ? i.unitPriceMinor : (i.unitPrice != null ? i.unitPrice : 0)),
+              sku: i.sku != null ? String(i.sku).slice(0, 100) : undefined,
+            };
+          }).slice(0, 100),
+          email: cart.email || undefined,
+          countryCode: cart.countryCode || undefined,
+        }),
+      });
+    },
+
+    /** Storefront site search executed. Pass the raw query + the
+     *  resulting hit count so no-result queries can be aggregated. */
+    search: function (query, resultsCount) {
+      var q = String(query || '').trim();
+      if (!q) return;
+      enqueue({
+        type: 'event',
+        meta: JSON.stringify({
+          eventType: 'search',
+          query: q.slice(0, 200),
+          resultsCount: Math.max(0, Number(resultsCount || 0)),
+        }),
+      });
+    },
+
+    /** Checkout finished — fires the counter that closes any open
+     *  abandoned-cart row for this session. Call from your thank-you
+     *  page. Optionally pass the order code + total. */
+    checkoutCompleted: function (orderCode, totalMinor) {
+      enqueue({
+        type: 'event',
+        meta: JSON.stringify({
+          eventType: 'checkout_completed',
+          orderCode: orderCode ? String(orderCode).slice(0, 64) : undefined,
+          totalMinor: totalMinor != null ? Number(totalMinor) : undefined,
+        }),
+      });
+      flush(); // don't wait — the visitor may close the tab immediately
+    },
+
+    /** Rage-click event — fire it yourself if you have a better signal
+     *  than the built-in detector. */
+    rageClick: function (selector, extraMeta) {
+      enqueue({
+        type: 'event',
+        meta: JSON.stringify(Object.assign({
+          eventType: 'rage_click',
+          selector: selector ? String(selector).slice(0, 200) : undefined,
+        }, extraMeta || {})),
+      });
+    },
+
+    /** Click landed on a non-interactive element. */
+    deadClick: function (selector, extraMeta) {
+      enqueue({
+        type: 'event',
+        meta: JSON.stringify(Object.assign({
+          eventType: 'dead_click',
+          selector: selector ? String(selector).slice(0, 200) : undefined,
+        }, extraMeta || {})),
+      });
+    },
+
+    /**
+     * Restore a cart from a signed recovery token. Fetches the items
+     * from the backend and returns them. Your storefront is responsible
+     * for calling its own Vendure order API to actually re-add them,
+     * because different storefronts frame that call differently.
+     */
+    restoreCart: function (token) {
+      var t = String(token || '').trim();
+      if (!t) return Promise.reject(new Error('missing-token'));
+      return fetch(CONFIG.recoverEndpoint + '?t=' + encodeURIComponent(t), {
+        credentials: 'include',
+      }).then(function (r) { return r.json(); });
+    },
+  };
+
+  // ── auto rage-click detector ─────────────────────────────────────
+  // Any pointerdown ≥ 3 within 500ms in a 20x20px zone counts.
+  if (CONFIG.autoRageClick) {
+    var recent = [];
+    document.addEventListener('pointerdown', function (e) {
+      var now = Date.now();
+      recent = recent.filter(function (r) { return now - r.t < 500; });
+      recent.push({ t: now, x: e.clientX, y: e.clientY, target: e.target });
+      var close = recent.filter(function (r) {
+        return Math.abs(r.x - e.clientX) < 20 && Math.abs(r.y - e.clientY) < 20;
+      });
+      if (close.length >= 3) {
+        hulo.rageClick(cssPathOf(e.target));
+        recent = []; // reset so we don't fire again on the 4th, 5th, etc.
+      }
+    }, { capture: true, passive: true });
+  }
+
+  // ── auto dead-click detector ─────────────────────────────────────
+  // A click that lands on an element with no href / not a button /
+  // not a form control and doesn't produce a navigation within 400ms.
+  if (CONFIG.autoDeadClick) {
+    document.addEventListener('click', function (e) {
+      var target = e.target;
+      if (!target || target.nodeType !== 1) return;
+      if (isInteractive(target)) return;
+      var beforeUrl = location.href;
+      var beforeScroll = window.scrollY;
+      setTimeout(function () {
+        if (location.href !== beforeUrl) return;
+        if (Math.abs(window.scrollY - beforeScroll) > 50) return;
+        // Was there an ancestor with a click handler? Best-effort:
+        // walk up and check for onclick, role='button', tabindex.
+        var node = target;
+        for (var i = 0; i < 4 && node; i++) {
+          if (isInteractive(node) || node.onclick) return;
+          node = node.parentElement;
+        }
+        hulo.deadClick(cssPathOf(target));
+      }, 400);
+    }, { capture: true, passive: true });
+  }
+
+  function isInteractive(el) {
+    if (!el || !el.tagName) return false;
+    var tag = el.tagName.toLowerCase();
+    if (tag === 'a' || tag === 'button' || tag === 'input' || tag === 'select'
+        || tag === 'textarea' || tag === 'label' || tag === 'summary'
+        || tag === 'details') return true;
+    if (el.getAttribute && (el.getAttribute('role') === 'button'
+        || el.getAttribute('role') === 'link'
+        || el.hasAttribute('tabindex'))) return true;
+    return false;
+  }
+
+  function cssPathOf(el) {
+    if (!el || el.nodeType !== 1) return '';
+    var parts = [];
+    while (el && el.nodeType === 1 && parts.length < 5) {
+      var p = el.tagName.toLowerCase();
+      if (el.id) { p += '#' + el.id; parts.unshift(p); break; }
+      if (el.className && typeof el.className === 'string') {
+        var cls = el.className.trim().split(/\\s+/).slice(0, 2).join('.');
+        if (cls) p += '.' + cls;
+      }
+      parts.unshift(p);
+      el = el.parentElement;
+    }
+    return parts.join(' > ');
+  }
+
+  global.hulo = hulo;
+  // Auto pageview on load — most callers want it.
+  if (document.readyState === 'complete') hulo.pageview();
+  else window.addEventListener('load', function () { hulo.pageview(); });
+})(window);
+`;
+exports.HULO_STOREFRONT_JS = HULO_STOREFRONT_JS;
+//# sourceMappingURL=hulo-storefront.js.map

package/dist/hulo-storefront.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hulo-storefront.js","sourceRoot":"","sources":["../src/hulo-storefront.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;GAcG;AACI,MAAM,kBAAkB,GAAG,CAAC,cAAsB,EAAE,gBAAgB,GAAG,CAAC,EAAU,EAAE,CAAC;;;;;gBAK5E,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC;uBACzD,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,mBAAmB,CAAC;iBAC7E,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqQhC,CAAC;AA5QW,QAAA,kBAAkB,sBA4Q7B"}

package/dist/index.d.ts

@@ -4,4 +4,10 @@
 export { VisitorAnalyticsPlugin, VisitorAnalyticsPluginOptions } from './plugin';
 export { VisitorTrackingService } from './visitor-tracking.service';
 export { VisitorEvent } from './visitor-event.entity';
+export { AbandonedCart, AbandonedCartStatus } from './abandoned-cart.entity';
+export { ProductCoView } from './product-co-view.entity';
+export { AbandonedCartService, CartSnapshotMeta, AbandonmentOptions, } from './abandoned-cart.service';
+export { RecommendationsService } from './recommendations.service';
+export { SearchAnalyticsService } from './search-analytics.service';
+export { JourneyBuffsService } from './journey-buffs.service';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EACH,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -3,11 +3,23 @@
  * `@huloglobal/vendure-plugin-visitor-analytics` — public exports.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VisitorEvent = exports.VisitorTrackingService = exports.VisitorAnalyticsPlugin = void 0;
+exports.JourneyBuffsService = exports.SearchAnalyticsService = exports.RecommendationsService = exports.AbandonedCartService = exports.ProductCoView = exports.AbandonedCart = exports.VisitorEvent = exports.VisitorTrackingService = exports.VisitorAnalyticsPlugin = void 0;
 var plugin_1 = require("./plugin");
 Object.defineProperty(exports, "VisitorAnalyticsPlugin", { enumerable: true, get: function () { return plugin_1.VisitorAnalyticsPlugin; } });
 var visitor_tracking_service_1 = require("./visitor-tracking.service");
 Object.defineProperty(exports, "VisitorTrackingService", { enumerable: true, get: function () { return visitor_tracking_service_1.VisitorTrackingService; } });
 var visitor_event_entity_1 = require("./visitor-event.entity");
 Object.defineProperty(exports, "VisitorEvent", { enumerable: true, get: function () { return visitor_event_entity_1.VisitorEvent; } });
+var abandoned_cart_entity_1 = require("./abandoned-cart.entity");
+Object.defineProperty(exports, "AbandonedCart", { enumerable: true, get: function () { return abandoned_cart_entity_1.AbandonedCart; } });
+var product_co_view_entity_1 = require("./product-co-view.entity");
+Object.defineProperty(exports, "ProductCoView", { enumerable: true, get: function () { return product_co_view_entity_1.ProductCoView; } });
+var abandoned_cart_service_1 = require("./abandoned-cart.service");
+Object.defineProperty(exports, "AbandonedCartService", { enumerable: true, get: function () { return abandoned_cart_service_1.AbandonedCartService; } });
+var recommendations_service_1 = require("./recommendations.service");
+Object.defineProperty(exports, "RecommendationsService", { enumerable: true, get: function () { return recommendations_service_1.RecommendationsService; } });
+var search_analytics_service_1 = require("./search-analytics.service");
+Object.defineProperty(exports, "SearchAnalyticsService", { enumerable: true, get: function () { return search_analytics_service_1.SearchAnalyticsService; } });
+var journey_buffs_service_1 = require("./journey-buffs.service");
+Object.defineProperty(exports, "JourneyBuffsService", { enumerable: true, get: function () { return journey_buffs_service_1.JourneyBuffsService; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAAiF;AAAxE,gHAAA,sBAAsB,OAAA;AAC/B,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAC/B,+DAAsD;AAA7C,oHAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAAiF;AAAxE,gHAAA,sBAAsB,OAAA;AAC/B,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAC/B,+DAAsD;AAA7C,oHAAA,YAAY,OAAA;AACrB,iEAA6E;AAApE,sHAAA,aAAa,OAAA;AACtB,mEAAyD;AAAhD,uHAAA,aAAa,OAAA;AACtB,mEAIkC;AAH9B,8HAAA,oBAAoB,OAAA;AAIxB,qEAAmE;AAA1D,iIAAA,sBAAsB,OAAA;AAC/B,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAC/B,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA"}

package/dist/journey-buffs.controller.d.ts

@@ -0,0 +1,43 @@
+import { RequestContext } from '@vendure/core';
+import { JourneyBuffsService } from './journey-buffs.service';
+export declare class JourneyBuffsController {
+    private readonly service;
+    constructor(service: JourneyBuffsService);
+    /** GET /ees/journey/rage-clicks?days=7&channelId=1&limit=20 */
+    rage(ctx: RequestContext, d?: string, ch?: string, l?: string): Promise<{
+        items: {
+            url: string;
+            rageClicks: number;
+            uniqueVisitors: number;
+        }[];
+    }>;
+    /** GET /ees/journey/dead-clicks?days=7&channelId=1&limit=20 */
+    dead(ctx: RequestContext, d?: string, ch?: string, l?: string): Promise<{
+        items: {
+            url: string;
+            deadClicks: number;
+            uniqueVisitors: number;
+        }[];
+    }>;
+    /** GET /ees/journey/session-summary?visitorId=abc&limit=25 */
+    summary(ctx: RequestContext, v?: string, l?: string): Promise<{
+        error: string;
+        visitorId?: undefined;
+        items?: undefined;
+    } | {
+        visitorId: string;
+        items: {
+            sessionId: string;
+            startedAt: string;
+            endedAt: string;
+            durationSec: number;
+            pageCount: number;
+            addedToCart: boolean;
+            checkedOut: boolean;
+            rageClicked: boolean;
+            intent: "browse" | "consider" | "purchase" | "abandon" | "frustrate" | "bounce";
+        }[];
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=journey-buffs.controller.d.ts.map

package/dist/journey-buffs.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-buffs.controller.d.ts","sourceRoot":"","sources":["../src/journey-buffs.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,cAAc,EAAqB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,qBACa,sBAAsB;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAEzD,+DAA+D;IAGzD,IAAI,CACC,GAAG,EAAE,cAAc,EACX,CAAC,CAAC,EAAE,MAAM,EACL,EAAE,CAAC,EAAE,MAAM,EACf,CAAC,CAAC,EAAE,MAAM;;;;;;;IAQ9B,+DAA+D;IAGzD,IAAI,CACC,GAAG,EAAE,cAAc,EACX,CAAC,CAAC,EAAE,MAAM,EACL,EAAE,CAAC,EAAE,MAAM,EACf,CAAC,CAAC,EAAE,MAAM;;;;;;;IAQ9B,8DAA8D;IAGxD,OAAO,CACF,GAAG,EAAE,cAAc,EACN,CAAC,CAAC,EAAE,MAAM,EACd,CAAC,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;CAOjC"}

package/dist/journey-buffs.controller.js

@@ -0,0 +1,79 @@
+"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.JourneyBuffsController = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const journey_buffs_service_1 = require("./journey-buffs.service");
+let JourneyBuffsController = class JourneyBuffsController {
+    constructor(service) {
+        this.service = service;
+    }
+    /** GET /ees/journey/rage-clicks?days=7&channelId=1&limit=20 */
+    async rage(ctx, d, ch, l) {
+        const items = await this.service.rageClickHotSpots(+(d || 7), +(ch || 1), +(l || 20));
+        return { items };
+    }
+    /** GET /ees/journey/dead-clicks?days=7&channelId=1&limit=20 */
+    async dead(ctx, d, ch, l) {
+        const items = await this.service.deadClickHotSpots(+(d || 7), +(ch || 1), +(l || 20));
+        return { items };
+    }
+    /** GET /ees/journey/session-summary?visitorId=abc&limit=25 */
+    async summary(ctx, v, l) {
+        const visitorId = String(v || '').trim();
+        if (!visitorId)
+            return { error: 'visitorId-required' };
+        const items = await this.service.sessionSummary(visitorId, +(l || 25));
+        return { visitorId, items };
+    }
+};
+exports.JourneyBuffsController = JourneyBuffsController;
+__decorate([
+    (0, common_1.Get)('journey/rage-clicks'),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Query)('days')),
+    __param(2, (0, common_1.Query)('channelId')),
+    __param(3, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String, String, String]),
+    __metadata("design:returntype", Promise)
+], JourneyBuffsController.prototype, "rage", null);
+__decorate([
+    (0, common_1.Get)('journey/dead-clicks'),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Query)('days')),
+    __param(2, (0, common_1.Query)('channelId')),
+    __param(3, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String, String, String]),
+    __metadata("design:returntype", Promise)
+], JourneyBuffsController.prototype, "dead", null);
+__decorate([
+    (0, common_1.Get)('journey/session-summary'),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Query)('visitorId')),
+    __param(2, (0, common_1.Query)('limit')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String, String]),
+    __metadata("design:returntype", Promise)
+], JourneyBuffsController.prototype, "summary", null);
+exports.JourneyBuffsController = JourneyBuffsController = __decorate([
+    (0, common_1.Controller)('ees'),
+    __metadata("design:paramtypes", [journey_buffs_service_1.JourneyBuffsService])
+], JourneyBuffsController);
+//# sourceMappingURL=journey-buffs.controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"journey-buffs.controller.js","sourceRoot":"","sources":["../src/journey-buffs.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAwD;AACxD,wCAAuE;AACvE,mEAA8D;AAGvD,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAC/B,YAA6B,OAA4B;QAA5B,YAAO,GAAP,OAAO,CAAqB;IAAG,CAAC;IAE7D,+DAA+D;IAGzD,AAAN,KAAK,CAAC,IAAI,CACC,GAAmB,EACX,CAAU,EACL,EAAW,EACf,CAAU;QAE1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAC9C,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACpC,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,+DAA+D;IAGzD,AAAN,KAAK,CAAC,IAAI,CACC,GAAmB,EACX,CAAU,EACL,EAAW,EACf,CAAU;QAE1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAC9C,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACpC,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,8DAA8D;IAGxD,AAAN,KAAK,CAAC,OAAO,CACF,GAAmB,EACN,CAAU,EACd,CAAU;QAE1B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACvE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAChC,CAAC;CACJ,CAAA;AA9CY,wDAAsB;AAMzB;IAFL,IAAA,YAAG,EAAC,qBAAqB,CAAC;IAC1B,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IAE1B,WAAA,IAAA,UAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAClB,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;;qCAHH,qBAAc;;kDAS7B;AAKK;IAFL,IAAA,YAAG,EAAC,qBAAqB,CAAC;IAC1B,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IAE1B,WAAA,IAAA,UAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAClB,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;;qCAHH,qBAAc;;kDAS7B;AAKK;IAFL,IAAA,YAAG,EAAC,yBAAyB,CAAC;IAC9B,IAAA,YAAK,EAAC,iBAAU,CAAC,YAAY,CAAC;IAE1B,WAAA,IAAA,UAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAClB,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;;qCAFH,qBAAc;;qDAQ7B;iCA7CQ,sBAAsB;IADlC,IAAA,mBAAU,EAAC,KAAK,CAAC;qCAEwB,2CAAmB;GADhD,sBAAsB,CA8ClC"}

package/dist/journey-buffs.service.d.ts

@@ -0,0 +1,53 @@
+import { TransactionalConnection } from '@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.
+ */
+export declare class JourneyBuffsService {
+    private connection;
+    constructor(connection: TransactionalConnection);
+    /**
+     * Store-wide rage-click hot spots — the URLs where visitors are
+     * most frustrated. `hulo.rageClick(url, selector)` on the
+     * storefront populates the underlying event.
+     */
+    rageClickHotSpots(sinceDays?: number, channelId?: number, limit?: number): Promise<Array<{
+        url: string;
+        rageClicks: number;
+        uniqueVisitors: number;
+    }>>;
+    /**
+     * 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).
+     */
+    deadClickHotSpots(sinceDays?: number, channelId?: number, limit?: number): Promise<Array<{
+        url: string;
+        deadClicks: number;
+        uniqueVisitors: number;
+    }>>;
+    /**
+     * 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".
+     */
+    sessionSummary(visitorId: string, limit?: number): Promise<Array<{
+        sessionId: string;
+        startedAt: string;
+        endedAt: string;
+        durationSec: number;
+        pageCount: number;
+        addedToCart: boolean;
+        checkedOut: boolean;
+        rageClicked: boolean;
+        intent: 'browse' | 'consider' | 'purchase' | 'abandon' | 'frustrate' | 'bounce';
+    }>>;
+}
+//# sourceMappingURL=journey-buffs.service.d.ts.map

package/dist/journey-buffs.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-buffs.service.d.ts","sourceRoot":"","sources":["../src/journey-buffs.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;;;;GASG;AACH,qBACa,mBAAmB;IAChB,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,uBAAuB;IAEvD;;;;OAIG;IACG,iBAAiB,CAAC,SAAS,SAAI,EAAE,SAAS,SAAI,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7E,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IAwBH;;;;;OAKG;IACG,iBAAiB,CAAC,SAAS,SAAI,EAAE,SAAS,SAAI,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7E,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IAwBH;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC/D,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,OAAO,CAAC;QACrB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;KACnF,CAAC,CAAC;CA+CN"}