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

package/CHANGELOG.md

@@ -2,46 +2,181 @@
 
 All notable changes to `@huloglobal/vendure-plugin-visitor-analytics` are
 documented here. The format follows
-[Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this
-project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
+[Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project
+adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.4.1]
+## [0.8.0] — 2026-07-04
+
+### Added
+
+**Cart abandonment — end-to-end.**
+- New `AbandonedCart` entity, keyed on session id. One row per
+  abandoned session, refreshed in place until it either converts
+  (order placed) or expires (recovery window elapses).
+- `AbandonedCartService.scan()` — periodic sweep finds sessions with
+  `cart_snapshot` events but no `checkout_completed` in the
+  abandonment window (default 30 min). Auto-promotes previously
+  abandoned rows to `converted` when the customer later checks out.
+- Ships with a boot-time timer (worker-only, 5-minute cadence).
+  Idempotent — safe to horizontally scale, only the worker runs it.
+- Signed recovery links — `POST /ees/abandoned-carts/:id/recovery-link`
+  returns a time-bounded opaque token the storefront exchanges via
+  `GET /ees/recover-cart?t=…` to rebuild the exact cart. Storefront
+  never sees the underlying items until the token is presented.
+- Slack notification for high-value abandonments — configurable
+  threshold and webhook via the `abandonment` plugin option.
+- Admin API:
+  - `GET  /ees/abandoned-carts` — paginated list with status,
+    value and email filters.
+  - `GET  /ees/abandoned-carts/summary` — totals, recovery rate,
+    recovered vs. lost value in the window.
+  - `GET  /ees/abandoned-carts/:id` — detail incl. parsed items.
+  - `POST /ees/abandoned-carts/:id/status` — mark recovered /
+    dismissed / re-open.
+  - `GET  /ees/abandoned-carts/export.csv` — CSV export.
+
+**Co-view product recommendations.**
+- New `ProductCoView` aggregate table. Scanner walks recent
+  `product_view` events per session, extracts every ordered pair,
+  and increments a per-triple counter. Bounded to 20 events per
+  session so runaway bot sessions can't skew the table.
+- Denormalised — both `(A, B)` and `(B, A)` stored — so read-side
+  lookups are one indexed scan.
+- Runs every 6 hours on the worker; also exposed as
+  `GET /ees/recommendations/aggregate-now` for admins to kick a
+  fresh run after a data backfill.
+- Public read endpoints (safe from the storefront):
+  - `GET /ees/recommendations/also-viewed?productId=…` — the
+    "customers who viewed X also viewed…" rail on a product page.
+  - `GET /ees/recommendations/personal?visitorId=…` — personalised
+    recs for a returning visitor, from their last 10 product views
+    over 30 days. Excludes seeds.
+  - `GET /ees/recommendations/trending?hours=24` — most-viewed
+    products in the window. Reflects real interest, not search-
+    console clicks.
+
+**Site search analytics.**
+- Reads back over `visitor_event` where the storefront has fired
+  `hulo.search(query, resultsCount)`. Zero new schema.
+- `GET /ees/search-analytics/top` — top queries by volume with
+  average results count.
+- `GET /ees/search-analytics/no-results` — top zero-result queries.
+  Direct catalogue-gap intel.
+- `GET /ees/search-analytics/conversion` — of sessions that
+  searched, what fraction went on to fire `add_to_cart`.
+
+**Journey drawer buffs.**
+- Rage-click + dead-click aggregation, keyed on URL. Store-wide
+  hot-spot lists for pages where visitors are stuck or frustrated.
+- Per-visitor session summary with a heuristic `intent` label
+  (`purchase` / `abandon` / `frustrate` / `consider` / `browse` /
+  `bounce`) computed from event history — one glance per session
+  in the Journey drawer instead of scrolling event rows.
+
+**Storefront helper events (documented in the README).**
+- `hulo.cartSnapshot({ currency, totalMinor, itemCount, items, email })`
+- `hulo.productView(productId, productVariantId?)`
+- `hulo.search(query, resultsCount)`
+- `hulo.rageClick(url, selector?)` / `hulo.deadClick(url, selector)`
+- `hulo.checkoutCompleted()`
+- All flow into the existing `POST /ees/track` endpoint with a
+  standard shape, so admins can also fire them from any language.
+
+### Changed
+- `checkout_completed` is now a first-class recognised event type
+  — the abandonment scanner uses it to auto-close matched rows.
+
+## [0.7.0] — 2026-07-04
+
+### Added
+- Boot-time compatibility check via the new SDK helper
+  `warnIfIncompatibleVendure()`. Logs a non-fatal warning when the runtime
+  `@vendure/core` version is outside the tested range. Silent when inside;
+  fail-open on unparseable versions.
+
+### Changed
+- Peer dep on `@vendure/core` tightened to `>=3.5.0 <4.0.0` — Vendure 3.5,
+  3.6 and 3.7 are all covered. Anything under 3.5 has never been tested;
+  anything from 4.0 upwards is deferred until the changelog is reviewed.
+- Uses `@huloglobal/vendure-licence-sdk@^0.6.0`.
+
+## [0.6.0] — 2026-06-23
+
+### Added
+- Vendure Admin API GraphQL extensions. Operator endpoints are now
+  first-class GraphQL queries alongside the existing REST admin
+  endpoints: `huloVisitorSummary`, `huloVisitorSources`,
+  `huloVisitorTopPages`, `huloVisitorFunnel`, `huloVisitorJourney`.
+- Storefront path (`POST /ees/track`) stays REST — it's anonymous,
+  high-frequency, and can ingest millions of events a day; the
+  resolver stack would add pointless overhead per event.
+
+## [0.5.0] — 2026-06-23
+
+### Added
+- Tier-gating on every premium feature via the SDK's `isLicensed()`
+  helper. Unlicensed installs get:
+  - a hard 100 events / UTC day cap on `POST /ees/track` (returns
+    `{skipped: 'free-tier-cap'}` after that);
+  - live SSE feed 402;
+  - conversion-goal creation 402;
+  - CSV export 402.
+- Anti-tamper heartbeat via the SDK.
+
+### Changed
+- Relicensed the GitHub source to AGPL-3.0. Published npm builds remain
+  under the commercial licence documented at
+  <https://huloglobal.com/legal/terms/>.
+- npm builds now include Sigstore provenance attestations.
+
+## [0.4.3] — 2026-06-21
+
+### Fixed
+- Dropped the conflicting `display: block` on mobile tables that broke
+  the row / cell alignment.
+
+## [0.4.2] — 2026-06-21
+
+### Changed
+- 44px minimum tap targets on every interactive element in the admin UI.
+
+## [0.4.1] — 2026-06-21
 
 ### Changed
 - Comprehensive README refresh — documents the full v0.4 feature set
   with the storefront snippet, every privacy + security option, and
   the conversion-goals API.
 
-## [0.4.0]
+## [0.4.0] — 2026-06-20
 
 ### Added
 - Signed visitor + session cookies via the licence-sdk `signValue` /
   `verifySignedValue` helpers — tampered cookies are rejected.
 - `Secure` cookie flag is set automatically when serving over HTTPS.
-- Rate limiter (240/60s default) on `POST /ees/track`.
+- Rate limiter (240 requests / 60s default) on `POST /ees/track`.
 - `corsAllowedOrigins` option restricts CORS reflection to the
   configured list (legacy wildcard preserved when empty).
 - Security headers on every response.
 - Opt-in retention sweeper via `options.retention`.
 
-## [0.3.3]
+## [0.3.3] — 2026-06-20
 
 ### Changed
-- Mobile-friendly admin UI — summary cards reflow, tables scroll
-  inside their card, profile drawer goes full-width.
+- Mobile-friendly admin UI — summary cards reflow, tables scroll inside
+  their card, profile drawer goes full-width.
 
-## [0.3.2]
+## [0.3.2] — 2026-06-20
 
 ### Changed
 - Republish targeting `@huloglobal/vendure-licence-sdk@^0.2.0`.
 
-## [0.3.1]
+## [0.3.1] — 2026-06-20
 
 ### Added
 - `UpdateChecker` integration — `/ees/visitors/status` endpoint returns
   version + update info; admin banner appears on new releases.
 
-## [0.3.0]
+## [0.3.0] — 2026-06-20
 
 ### Added
 - **Conversion goals** — new `ConversionGoal` entity with a URL-glob
@@ -62,7 +197,7 @@ project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
     `consent:true` or cookie `ees_consent=1`
 - **CSV export** — `GET /ees/visitors/export.csv?days=N` (max 90).
 
-## [0.2.0]
+## [0.2.0] — 2026-06-19
 
 ### Added
 - **UTM attribution** — `utmSource` / `utmMedium` / `utmCampaign` /
@@ -78,7 +213,7 @@ project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 - **Custom event recipes** — README section with copy-paste storefront
   snippets for add-to-cart, search, quote-request, newsletter signup.
 
-## [0.1.0] — Unreleased
+## [0.1.0] — 2026-06-19
 
 ### Added
 - `VisitorAnalyticsPlugin` — ingest endpoint + admin dashboards.
@@ -92,5 +227,20 @@ project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
   profile + journey.
 - Admin UI: summary tiles, funnel bars, top + exit page tables,
   recent visitors table with clickable profile drawer.
-- Licence verification via `@huloglobal/vendure-licence-sdk` with revocation
-  polling.
+- Licence verification via `@huloglobal/vendure-licence-sdk` with
+  revocation polling.
+
+[0.8.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.8.0
+[0.7.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.7.0
+[0.6.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.6.0
+[0.5.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.5.0
+[0.4.3]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.4.3
+[0.4.2]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.4.2
+[0.4.1]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.4.1
+[0.4.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.4.0
+[0.3.3]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.3.3
+[0.3.2]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.3.2
+[0.3.1]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.3.1
+[0.3.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.3.0
+[0.2.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.2.0
+[0.1.0]: https://github.com/exceeded/vendure-plugin-visitor-analytics/releases/tag/v0.1.0

package/dist/abandoned-cart.controller.d.ts

@@ -0,0 +1,78 @@
+import { RequestContext } from '@vendure/core';
+import { Request, Response } from 'express';
+import { AbandonedCartService } from './abandoned-cart.service';
+/**
+ * Admin API for the Abandoned Cart feature.
+ *
+ * Endpoints:
+ *   GET  /ees/abandoned-carts                — paginated list with filters
+ *   GET  /ees/abandoned-carts/summary        — totals + top-value + recovery rate
+ *   GET  /ees/abandoned-carts/:id            — detail incl. parsed items
+ *   POST /ees/abandoned-carts/:id/recovery-link  — mint/reissue signed URL
+ *   POST /ees/abandoned-carts/:id/status     — mark recovered/dismissed
+ *   GET  /ees/abandoned-carts/export.csv     — CSV export
+ *
+ * Storefront-side (unauthenticated):
+ *   GET  /ees/recover-cart?t=...             — resolve a token → items
+ */
+export declare class AbandonedCartController {
+    private readonly service;
+    constructor(service: AbandonedCartService);
+    list(ctx: RequestContext, takeRaw?: string, skipRaw?: string, status?: string, minValueRaw?: string, email?: string): Promise<{
+        items: any;
+        total: number;
+        take: number;
+        skip: number;
+    }>;
+    summary(ctx: RequestContext, daysRaw?: string): Promise<{
+        windowDays: number;
+        total: number;
+        openCount: number;
+        recoveredCount: number;
+        convertedCount: number;
+        expiredCount: number;
+        dismissedCount: number;
+        recoveryRatePct: number;
+        totalValueMinor: number;
+        recoveredValueMinor: number;
+        avgValueMinor: number;
+    }>;
+    exportCsv(ctx: RequestContext, res: Response, daysRaw?: string): Promise<void>;
+    detail(ctx: RequestContext, idRaw: string): Promise<any>;
+    issueRecoveryLink(ctx: RequestContext, idRaw: string): Promise<{
+        error: string;
+        hint: string;
+        ok?: undefined;
+        url?: undefined;
+    } | {
+        ok: boolean;
+        url: string;
+        error?: undefined;
+        hint?: undefined;
+    }>;
+    setStatus(ctx: RequestContext, idRaw: string, body: {
+        status?: string;
+    }): Promise<{
+        error: string;
+        ok?: undefined;
+    } | {
+        ok: boolean;
+        error?: undefined;
+    }>;
+    /**
+     * Public storefront endpoint — decodes a recovery token into a set
+     * of cart items the storefront can restore. Rate-limited by the
+     * plugin's usual ingest limiter (same origin as the tracker).
+     */
+    recover(req: Request, token?: string): Promise<{
+        error: string;
+    } | {
+        id: number;
+        currency: string;
+        items: any[];
+        email: string | null;
+        ok: boolean;
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=abandoned-cart.controller.d.ts.map

package/dist/abandoned-cart.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abandoned-cart.controller.d.ts","sourceRoot":"","sources":["../src/abandoned-cart.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,cAAc,EAAqB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,qBACa,uBAAuB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,oBAAoB;IAIpD,IAAI,CACC,GAAG,EAAE,cAAc,EACX,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACvB,KAAK,CAAC,EAAE,MAAM;;;;;;IAuC5B,OAAO,CAAQ,GAAG,EAAE,cAAc,EAAiB,OAAO,CAAC,EAAE,MAAM;;;;;;;;;;;;;IAuCnE,SAAS,CAAQ,GAAG,EAAE,cAAc,EAAS,GAAG,EAAE,QAAQ,EAAiB,OAAO,CAAC,EAAE,MAAM;IA+B3F,MAAM,CAAQ,GAAG,EAAE,cAAc,EAAe,KAAK,EAAE,MAAM;IAgB7D,iBAAiB,CAAQ,GAAG,EAAE,cAAc,EAAe,KAAK,EAAE,MAAM;;;;;;;;;;;IASxE,SAAS,CACJ,GAAG,EAAE,cAAc,EACb,KAAK,EAAE,MAAM,EAClB,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;IAWrC;;;;OAIG;IAEG,OAAO,CAAQ,GAAG,EAAE,OAAO,EAAc,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;CAOhE"}

package/dist/abandoned-cart.controller.js

@@ -0,0 +1,251 @@
+"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.AbandonedCartController = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const abandoned_cart_service_1 = require("./abandoned-cart.service");
+/**
+ * Admin API for the Abandoned Cart feature.
+ *
+ * Endpoints:
+ *   GET  /ees/abandoned-carts                — paginated list with filters
+ *   GET  /ees/abandoned-carts/summary        — totals + top-value + recovery rate
+ *   GET  /ees/abandoned-carts/:id            — detail incl. parsed items
+ *   POST /ees/abandoned-carts/:id/recovery-link  — mint/reissue signed URL
+ *   POST /ees/abandoned-carts/:id/status     — mark recovered/dismissed
+ *   GET  /ees/abandoned-carts/export.csv     — CSV export
+ *
+ * Storefront-side (unauthenticated):
+ *   GET  /ees/recover-cart?t=...             — resolve a token → items
+ */
+let AbandonedCartController = class AbandonedCartController {
+    constructor(service) {
+        this.service = service;
+    }
+    async list(ctx, takeRaw, skipRaw, status, minValueRaw, email) {
+        var _a;
+        const take = Math.min(Math.max(1, parseInt(takeRaw || '25', 10) || 25), 200);
+        const skip = Math.max(0, parseInt(skipRaw || '0', 10) || 0);
+        const where = [];
+        const params = [];
+        if (status) {
+            where.push('status = ?');
+            params.push(status);
+        }
+        if (minValueRaw) {
+            const v = parseInt(minValueRaw, 10);
+            if (Number.isFinite(v)) {
+                where.push('totalMinor >= ?');
+                params.push(v);
+            }
+        }
+        if (email) {
+            where.push('LOWER(email) LIKE ?');
+            params.push(`%${email.toLowerCase()}%`);
+        }
+        const clause = where.length ? `WHERE ${where.join(' AND ')}` : '';
+        const conn = this.service.connection.rawConnection;
+        const [rows, totalRow] = await Promise.all([
+            conn.query(`SELECT id, sessionId, visitorId, customerId, currency, totalMinor, itemCount,
+                        email, status, abandonedAt, recoveredAt, notificationSent,
+                        utmSource, utmMedium, countryCode
+                 FROM abandoned_cart
+                 ${clause}
+                 ORDER BY abandonedAt DESC
+                 LIMIT ? OFFSET ?`, [...params, take, skip]),
+            conn.query(`SELECT COUNT(*) AS c FROM abandoned_cart ${clause}`, params),
+        ]);
+        return {
+            items: rows,
+            total: Number(((_a = totalRow === null || totalRow === void 0 ? void 0 : totalRow[0]) === null || _a === void 0 ? void 0 : _a.c) || 0),
+            take, skip,
+        };
+    }
+    async summary(ctx, daysRaw) {
+        const days = Math.min(Math.max(1, parseInt(daysRaw || '30', 10) || 30), 365);
+        const since = new Date(Date.now() - days * 86400000);
+        const conn = this.service.connection.rawConnection;
+        const rows = await conn.query(`SELECT
+                COUNT(*) AS total,
+                SUM(status = 'abandoned') AS openCount,
+                SUM(status = 'recovered') AS recoveredCount,
+                SUM(status = 'converted') AS convertedCount,
+                SUM(status = 'expired')   AS expiredCount,
+                SUM(status = 'dismissed') AS dismissedCount,
+                SUM(totalMinor) AS totalValueMinor,
+                SUM(CASE WHEN status IN ('recovered','converted') THEN totalMinor ELSE 0 END) AS recoveredValueMinor,
+                AVG(totalMinor) AS avgValueMinor
+             FROM abandoned_cart
+             WHERE abandonedAt >= ?`, [since]);
+        const s = (rows === null || rows === void 0 ? void 0 : rows[0]) || {};
+        const total = Number(s.total || 0);
+        const rec = Number(s.recoveredCount || 0) + Number(s.convertedCount || 0);
+        return {
+            windowDays: days,
+            total,
+            openCount: Number(s.openCount || 0),
+            recoveredCount: Number(s.recoveredCount || 0),
+            convertedCount: Number(s.convertedCount || 0),
+            expiredCount: Number(s.expiredCount || 0),
+            dismissedCount: Number(s.dismissedCount || 0),
+            recoveryRatePct: total ? Math.round((rec / total) * 1000) / 10 : 0,
+            totalValueMinor: Number(s.totalValueMinor || 0),
+            recoveredValueMinor: Number(s.recoveredValueMinor || 0),
+            avgValueMinor: Math.round(Number(s.avgValueMinor || 0)),
+        };
+    }
+    async exportCsv(ctx, res, daysRaw) {
+        const days = Math.min(Math.max(1, parseInt(daysRaw || '30', 10) || 30), 365);
+        const since = new Date(Date.now() - days * 86400000);
+        const conn = this.service.connection.rawConnection;
+        const rows = await conn.query(`SELECT id, sessionId, visitorId, customerId, currency, totalMinor, itemCount,
+                    email, status, abandonedAt, recoveredAt, utmSource, utmMedium, utmCampaign, countryCode
+             FROM abandoned_cart
+             WHERE abandonedAt >= ?
+             ORDER BY abandonedAt DESC
+             LIMIT 50000`, [since]);
+        res.setHeader('content-type', 'text/csv; charset=utf-8');
+        res.setHeader('content-disposition', `attachment; filename="abandoned-carts-${new Date().toISOString().slice(0, 10)}.csv"`);
+        const esc = (v) => {
+            const s = v == null ? '' : String(v);
+            return /[,"\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+        };
+        const cols = ['id', 'sessionId', 'visitorId', 'customerId', 'currency', 'totalMinor', 'itemCount',
+            'email', 'status', 'abandonedAt', 'recoveredAt', 'utmSource', 'utmMedium', 'utmCampaign', 'countryCode'];
+        res.write(cols.join(',') + '\n');
+        for (const r of rows) {
+            res.write(cols.map(c => esc(r[c])).join(',') + '\n');
+        }
+        res.end();
+    }
+    async detail(ctx, idRaw) {
+        const id = parseInt(idRaw, 10);
+        const conn = this.service.connection.rawConnection;
+        const rows = await conn.query(`SELECT * FROM abandoned_cart WHERE id = ? LIMIT 1`, [id]);
+        if (!(rows === null || rows === void 0 ? void 0 : rows.length))
+            return { error: 'not-found' };
+        const r = rows[0];
+        let items = [];
+        try {
+            items = JSON.parse(r.itemsJson || '[]');
+        }
+        catch { }
+        return { ...r, items };
+    }
+    async issueRecoveryLink(ctx, idRaw) {
+        const id = parseInt(idRaw, 10);
+        const url = await this.service.issueRecoveryLink(id);
+        if (!url)
+            return { error: 'recovery-disabled-or-not-found', hint: 'Set abandonment.recoveryLinkSecret in plugin options' };
+        return { ok: true, url };
+    }
+    async setStatus(ctx, idRaw, body) {
+        const id = parseInt(idRaw, 10);
+        const status = String((body === null || body === void 0 ? void 0 : body.status) || '');
+        if (!['recovered', 'dismissed', 'abandoned'].includes(status)) {
+            return { error: 'invalid-status' };
+        }
+        const ok = await this.service.markStatus(id, status);
+        return ok ? { ok: true } : { error: 'not-found' };
+    }
+    /**
+     * Public storefront endpoint — decodes a recovery token into a set
+     * of cart items the storefront can restore. Rate-limited by the
+     * plugin's usual ingest limiter (same origin as the tracker).
+     */
+    async recover(req, token) {
+        const t = String(token || '').trim();
+        if (!t)
+            return { error: 'missing-token' };
+        const result = await this.service.findByRecoveryToken(t);
+        if (!result)
+            return { error: 'expired-or-invalid' };
+        return { ok: true, ...result };
+    }
+};
+exports.AbandonedCartController = AbandonedCartController;
+__decorate([
+    (0, common_1.Get)('abandoned-carts'),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Query)('take')),
+    __param(2, (0, common_1.Query)('skip')),
+    __param(3, (0, common_1.Query)('status')),
+    __param(4, (0, common_1.Query)('minValue')),
+    __param(5, (0, common_1.Query)('email')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String, String, String, String, String]),
+    __metadata("design:returntype", Promise)
+], AbandonedCartController.prototype, "list", null);
+__decorate([
+    (0, common_1.Get)('abandoned-carts/summary'),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Query)('days')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String]),
+    __metadata("design:returntype", Promise)
+], AbandonedCartController.prototype, "summary", null);
+__decorate([
+    (0, common_1.Get)('abandoned-carts/export.csv'),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Res)()),
+    __param(2, (0, common_1.Query)('days')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object, String]),
+    __metadata("design:returntype", Promise)
+], AbandonedCartController.prototype, "exportCsv", null);
+__decorate([
+    (0, common_1.Get)('abandoned-carts/:id'),
+    (0, core_1.Allow)(core_1.Permission.ReadCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String]),
+    __metadata("design:returntype", Promise)
+], AbandonedCartController.prototype, "detail", null);
+__decorate([
+    (0, common_1.Post)('abandoned-carts/:id/recovery-link'),
+    (0, core_1.Allow)(core_1.Permission.UpdateCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String]),
+    __metadata("design:returntype", Promise)
+], AbandonedCartController.prototype, "issueRecoveryLink", null);
+__decorate([
+    (0, common_1.Post)('abandoned-carts/:id/status'),
+    (0, core_1.Allow)(core_1.Permission.UpdateCustomer),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Param)('id')),
+    __param(2, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String, Object]),
+    __metadata("design:returntype", Promise)
+], AbandonedCartController.prototype, "setStatus", null);
+__decorate([
+    (0, common_1.Get)('recover-cart'),
+    __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Query)('t')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], AbandonedCartController.prototype, "recover", null);
+exports.AbandonedCartController = AbandonedCartController = __decorate([
+    (0, common_1.Controller)('ees'),
+    __metadata("design:paramtypes", [abandoned_cart_service_1.AbandonedCartService])
+], AbandonedCartController);
+//# sourceMappingURL=abandoned-cart.controller.js.map

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

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

package/dist/abandoned-cart.entity.d.ts

@@ -0,0 +1,61 @@
+export type AbandonedCartStatus = 'abandoned' | 'recovered' | 'converted' | 'expired' | 'dismissed';
+/**
+ * One row per abandoned cart, keyed on the visitor session that produced
+ * it. Rebuilt fresh from `cart_snapshot` events by the periodic scanner,
+ * so a session can be updated in-place until it either converts (order
+ * placed) or expires (recovery window elapses without any action).
+ */
+export declare class AbandonedCart {
+    id: number;
+    visitorId: string;
+    sessionId: string;
+    /** Set when the visitor is signed in. Guest carts stay NULL and are
+     *  matched to a customer only if they later sign in (via the same
+     *  visitorId) or check out with a linkable email. */
+    customerId: number | null;
+    channelId: number;
+    currency: string;
+    /** Total value in the smallest currency unit (pence/cents). Storing
+     *  minor units avoids float drift and matches Vendure's convention. */
+    totalMinor: number;
+    itemCount: number;
+    /** JSON array of cart items:
+     *  [{ variantId, name, qty, unitPriceMinor, productId?, sku? }, …]
+     *  Held as text because the recovery link needs to reconstruct the
+     *  cart exactly — we don't want to join back to a live catalog that
+     *  may have changed price by the time recovery is attempted. */
+    itemsJson: string;
+    /** Plain email if the storefront passed one (checkout step 1 usually
+     *  captures this). NULL for cold browsers. */
+    email: string | null;
+    /** SHA-256 of the lowercased email — safe to keep even under
+     *  aggressive privacy defaults, and used to link recurring sessions
+     *  from the same buyer without exposing the raw address. */
+    emailHash: string | null;
+    firstSnapshotAt: Date;
+    lastSnapshotAt: Date;
+    /** Moment the scanner promoted the session from "active" to
+     *  "abandoned" — i.e. no checkout_completed and no fresh
+     *  cart_snapshot within the abandonment window. */
+    abandonedAt: Date;
+    recoveredAt: Date | null;
+    /** Signed opaque token that recovers the cart on the storefront.
+     *  Regenerated by the admin/recover endpoint; time-bounded. */
+    recoveryToken: string | null;
+    recoveryTokenExpiresAt: Date | null;
+    status: AbandonedCartStatus;
+    recoveryOrderId: number | null;
+    lastKnownUrl: string | null;
+    lastKnownReferrer: string | null;
+    utmSource: string | null;
+    utmMedium: string | null;
+    utmCampaign: string | null;
+    countryCode: string | null;
+    /** True once we've fired the Slack / email notification for this
+     *  abandonment. Prevents duplicate notifications when the scanner
+     *  re-runs. */
+    notificationSent: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=abandoned-cart.entity.d.ts.map

package/dist/abandoned-cart.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abandoned-cart.entity.d.ts","sourceRoot":"","sources":["../src/abandoned-cart.entity.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,mBAAmB,GACzB,WAAW,GACX,WAAW,GACX,WAAW,GACX,SAAS,GACT,WAAW,CAAC;AAElB;;;;;GAKG;AACH,qBAMa,aAAa;IAEtB,EAAE,EAAG,MAAM,CAAC;IAGZ,SAAS,EAAG,MAAM,CAAC;IAGnB,SAAS,EAAG,MAAM,CAAC;IAEnB;;yDAEqD;IAErD,UAAU,EAAG,MAAM,GAAG,IAAI,CAAC;IAG3B,SAAS,EAAG,MAAM,CAAC;IAGnB,QAAQ,EAAG,MAAM,CAAC;IAElB;2EACuE;IAEvE,UAAU,EAAG,MAAM,CAAC;IAGpB,SAAS,EAAG,MAAM,CAAC;IAEnB;;;;oEAIgE;IAEhE,SAAS,EAAG,MAAM,CAAC;IAEnB;kDAC8C;IAE9C,KAAK,EAAG,MAAM,GAAG,IAAI,CAAC;IAEtB;;gEAE4D;IAE5D,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAG1B,eAAe,EAAG,IAAI,CAAC;IAGvB,cAAc,EAAG,IAAI,CAAC;IAEtB;;uDAEmD;IAEnD,WAAW,EAAG,IAAI,CAAC;IAGnB,WAAW,EAAG,IAAI,GAAG,IAAI,CAAC;IAE1B;mEAC+D;IAE/D,aAAa,EAAG,MAAM,GAAG,IAAI,CAAC;IAG9B,sBAAsB,EAAG,IAAI,GAAG,IAAI,CAAC;IAGrC,MAAM,EAAG,mBAAmB,CAAC;IAG7B,eAAe,EAAG,MAAM,GAAG,IAAI,CAAC;IAGhC,YAAY,EAAG,MAAM,GAAG,IAAI,CAAC;IAG7B,iBAAiB,EAAG,MAAM,GAAG,IAAI,CAAC;IAGlC,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAG1B,SAAS,EAAG,MAAM,GAAG,IAAI,CAAC;IAG1B,WAAW,EAAG,MAAM,GAAG,IAAI,CAAC;IAG5B,WAAW,EAAG,MAAM,GAAG,IAAI,CAAC;IAE5B;;mBAEe;IAEf,gBAAgB,EAAG,OAAO,CAAC;IAG3B,SAAS,EAAG,IAAI,CAAC;IAGjB,SAAS,EAAG,IAAI,CAAC;CACpB"}