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

package/dist/search-analytics.service.js

@@ -0,0 +1,105 @@
+"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.SearchAnalyticsService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+/**
+ * Zero-schema-cost search analytics: reads back over the existing
+ * `visitor_event` table where the storefront has posted `type='event'`,
+ * `eventType='search'` custom events, and aggregates them per query
+ * string.
+ *
+ * The storefront just needs to fire:
+ *   hulo.search('rgb keyboard', 42)   // (query, resultsCount)
+ *
+ * Everything else lives in the read side.
+ */
+let SearchAnalyticsService = class SearchAnalyticsService {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /** Top search queries in the window, by volume. */
+    async topQueries(sinceDays = 7, channelId = 1, limit = 50) {
+        const since = new Date(Date.now() - sinceDays * 86400000);
+        const rows = await this.connection.rawConnection.query(`SELECT
+                LOWER(TRIM(BOTH '"' FROM SUBSTRING_INDEX(SUBSTRING_INDEX(meta, '"query":"', -1), '"', 1))) AS query,
+                COUNT(*) AS searches,
+                AVG(CAST(SUBSTRING_INDEX(SUBSTRING_INDEX(meta, '"resultsCount":', -1), ',', 1) AS UNSIGNED)) AS avgResults
+             FROM visitor_event
+             WHERE type = 'event'
+               AND meta LIKE '%"eventType":"search"%'
+               AND channelId = ?
+               AND createdAt >= ?
+             GROUP BY query
+             HAVING query <> ''
+             ORDER BY searches DESC
+             LIMIT ?`, [channelId, since, Math.min(Math.max(1, limit), 500)]);
+        return rows.map(r => ({
+            query: String(r.query || ''),
+            searches: Number(r.searches),
+            avgResults: Math.round(Number(r.avgResults || 0) * 10) / 10,
+        }));
+    }
+    /** Zero-result queries — catalogue-gap intel. */
+    async zeroResultQueries(sinceDays = 7, channelId = 1, limit = 50) {
+        const since = new Date(Date.now() - sinceDays * 86400000);
+        const rows = await this.connection.rawConnection.query(`SELECT
+                LOWER(TRIM(BOTH '"' FROM SUBSTRING_INDEX(SUBSTRING_INDEX(meta, '"query":"', -1), '"', 1))) AS query,
+                COUNT(*) AS searches
+             FROM visitor_event
+             WHERE type = 'event'
+               AND meta LIKE '%"eventType":"search"%'
+               AND meta LIKE '%"resultsCount":0%'
+               AND channelId = ?
+               AND createdAt >= ?
+             GROUP BY query
+             HAVING query <> ''
+             ORDER BY searches DESC
+             LIMIT ?`, [channelId, since, Math.min(Math.max(1, limit), 500)]);
+        return rows.map(r => ({ query: String(r.query || ''), searches: Number(r.searches) }));
+    }
+    /** Search-to-cart-add conversion — of sessions that searched, what
+     *  fraction went on to fire an add_to_cart. Coarse, but the direction
+     *  of movement is what matters for catalogue tuning. */
+    async searchToAddRate(sinceDays = 7, channelId = 1) {
+        const since = new Date(Date.now() - sinceDays * 86400000);
+        const rows = await this.connection.rawConnection.query(`SELECT
+                COUNT(DISTINCT ve.sessionId) AS sessionsSearched,
+                COUNT(DISTINCT CASE WHEN adds.sessionId IS NOT NULL THEN ve.sessionId END) AS sessionsAdded
+             FROM visitor_event ve
+             LEFT JOIN (
+                SELECT DISTINCT sessionId FROM visitor_event
+                WHERE type = 'event'
+                  AND meta LIKE '%"eventType":"add_to_cart"%'
+                  AND channelId = ?
+                  AND createdAt >= ?
+             ) adds ON adds.sessionId = ve.sessionId
+             WHERE ve.type = 'event'
+               AND ve.meta LIKE '%"eventType":"search"%'
+               AND ve.channelId = ?
+               AND ve.createdAt >= ?`, [channelId, since, channelId, since]);
+        const r = (rows === null || rows === void 0 ? void 0 : rows[0]) || {};
+        const searched = Number(r.sessionsSearched || 0);
+        const added = Number(r.sessionsAdded || 0);
+        return {
+            sessionsSearched: searched,
+            sessionsAdded: added,
+            conversion: searched ? Math.round((added / searched) * 1000) / 10 : 0,
+        };
+    }
+};
+exports.SearchAnalyticsService = SearchAnalyticsService;
+exports.SearchAnalyticsService = SearchAnalyticsService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.TransactionalConnection])
+], SearchAnalyticsService);
+//# sourceMappingURL=search-analytics.service.js.map

package/dist/search-analytics.service.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huloglobal/vendure-plugin-visitor-analytics",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Full-funnel visitor analytics for Vendure storefronts \u2014 pageviews, time-on-page, session journey, exit pages, funnel drop-off, and per-visitor profile drawer with parsed user-agent + MaxMind GeoLite2 enrichment. Auto-issues visitor + session cookies on first request; logs guest and signed-in events against the same visitor id so the journey survives login.",
   "license": "AGPL-3.0-or-later",
   "author": "Wayne Garrison <wayne@garrison.me.uk>",