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

package/dist/abandoned-cart.entity.js

@@ -0,0 +1,143 @@
+"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.AbandonedCart = void 0;
+const typeorm_1 = require("typeorm");
+/**
+ * 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).
+ */
+let AbandonedCart = class AbandonedCart {
+};
+exports.AbandonedCart = AbandonedCart;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], AbandonedCart.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 64 }),
+    __metadata("design:type", String)
+], AbandonedCart.prototype, "visitorId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 64 }),
+    __metadata("design:type", String)
+], AbandonedCart.prototype, "sessionId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "customerId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', default: 1 }),
+    __metadata("design:type", Number)
+], AbandonedCart.prototype, "channelId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 3 }),
+    __metadata("design:type", String)
+], AbandonedCart.prototype, "currency", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int' }),
+    __metadata("design:type", Number)
+], AbandonedCart.prototype, "totalMinor", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int' }),
+    __metadata("design:type", Number)
+], AbandonedCart.prototype, "itemCount", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text' }),
+    __metadata("design:type", String)
+], AbandonedCart.prototype, "itemsJson", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 255, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "email", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 64, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "emailHash", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', precision: 3 }),
+    __metadata("design:type", Date)
+], AbandonedCart.prototype, "firstSnapshotAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', precision: 3 }),
+    __metadata("design:type", Date)
+], AbandonedCart.prototype, "lastSnapshotAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', precision: 3 }),
+    __metadata("design:type", Date)
+], AbandonedCart.prototype, "abandonedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', precision: 3, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "recoveredAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 128, nullable: true, unique: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "recoveryToken", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'datetime', precision: 3, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "recoveryTokenExpiresAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 32, default: 'abandoned' }),
+    __metadata("design:type", String)
+], AbandonedCart.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'int', nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "recoveryOrderId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 2048, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "lastKnownUrl", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 2048, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "lastKnownReferrer", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 100, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "utmSource", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 100, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "utmMedium", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 200, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "utmCampaign", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16, nullable: true }),
+    __metadata("design:type", Object)
+], AbandonedCart.prototype, "countryCode", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'boolean', default: false }),
+    __metadata("design:type", Boolean)
+], AbandonedCart.prototype, "notificationSent", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ precision: 3 }),
+    __metadata("design:type", Date)
+], AbandonedCart.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)({ precision: 3 }),
+    __metadata("design:type", Date)
+], AbandonedCart.prototype, "updatedAt", void 0);
+exports.AbandonedCart = AbandonedCart = __decorate([
+    (0, typeorm_1.Entity)('abandoned_cart'),
+    (0, typeorm_1.Index)('abandoned_cart_session_uniq', ['sessionId'], { unique: true }),
+    (0, typeorm_1.Index)('abandoned_cart_visitor_idx', ['visitorId', 'abandonedAt']),
+    (0, typeorm_1.Index)('abandoned_cart_status_idx', ['status', 'abandonedAt']),
+    (0, typeorm_1.Index)('abandoned_cart_email_idx', ['emailHash']),
+    (0, typeorm_1.Index)('abandoned_cart_customer_idx', ['customerId'])
+], AbandonedCart);
+//# sourceMappingURL=abandoned-cart.entity.js.map

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

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

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

@@ -0,0 +1,34 @@
+import { OnApplicationBootstrap, OnApplicationShutdown } from '@nestjs/common';
+import { ProcessContext } from '@vendure/core';
+import { AbandonedCartService } from './abandoned-cart.service';
+import { RecommendationsService } from './recommendations.service';
+/**
+ * Runs the two periodic sweeps this plugin depends on:
+ *
+ *   1. Abandoned-cart detection — every 5 minutes.
+ *      Any session with `cart_snapshot` events but no
+ *      `checkout_completed` in the abandonment window gets promoted.
+ *
+ *   2. Product co-view aggregation — every 6 hours.
+ *      Walks recent `product_view` events and accumulates the
+ *      pair counter used by the recommendations endpoints.
+ *
+ * Runs on the *worker* process only, not the server, so a horizontally
+ * scaled deployment doesn't run the sweeps N times per interval.
+ * Falls through cleanly on the server (bootstrap is a no-op).
+ *
+ * Uses `setInterval` rather than `@nestjs/schedule` — that package
+ * is only present on installs that opt in to it. This keeps the
+ * plugin's runtime footprint minimal.
+ */
+export declare class AbandonedCartScanner implements OnApplicationBootstrap, OnApplicationShutdown {
+    private readonly cartSvc;
+    private readonly recsSvc;
+    private readonly processContext;
+    private cartTimer;
+    private recsTimer;
+    constructor(cartSvc: AbandonedCartService, recsSvc: RecommendationsService, processContext: ProcessContext);
+    onApplicationBootstrap(): void;
+    onApplicationShutdown(): void;
+}
+//# sourceMappingURL=abandoned-cart.scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abandoned-cart.scanner.d.ts","sourceRoot":"","sources":["../src/abandoned-cart.scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAInE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,oBAAqB,YAAW,sBAAsB,EAAE,qBAAqB;IAKlF,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc;IANnC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,SAAS,CAA+B;gBAG3B,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,sBAAsB,EAC/B,cAAc,EAAE,cAAc;IAGnD,sBAAsB;IAyBtB,qBAAqB;CAIxB"}

package/dist/abandoned-cart.scanner.js

@@ -0,0 +1,85 @@
+"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.AbandonedCartScanner = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const abandoned_cart_service_1 = require("./abandoned-cart.service");
+const recommendations_service_1 = require("./recommendations.service");
+const loggerCtx = 'HuloAnalyticsScanner';
+/**
+ * Runs the two periodic sweeps this plugin depends on:
+ *
+ *   1. Abandoned-cart detection — every 5 minutes.
+ *      Any session with `cart_snapshot` events but no
+ *      `checkout_completed` in the abandonment window gets promoted.
+ *
+ *   2. Product co-view aggregation — every 6 hours.
+ *      Walks recent `product_view` events and accumulates the
+ *      pair counter used by the recommendations endpoints.
+ *
+ * Runs on the *worker* process only, not the server, so a horizontally
+ * scaled deployment doesn't run the sweeps N times per interval.
+ * Falls through cleanly on the server (bootstrap is a no-op).
+ *
+ * Uses `setInterval` rather than `@nestjs/schedule` — that package
+ * is only present on installs that opt in to it. This keeps the
+ * plugin's runtime footprint minimal.
+ */
+let AbandonedCartScanner = class AbandonedCartScanner {
+    constructor(cartSvc, recsSvc, processContext) {
+        this.cartSvc = cartSvc;
+        this.recsSvc = recsSvc;
+        this.processContext = processContext;
+        this.cartTimer = null;
+        this.recsTimer = null;
+    }
+    onApplicationBootstrap() {
+        // Only the worker process runs the sweeps. Guard here rather
+        // than throwing — a mono-process dev setup still works.
+        if (!this.processContext.isWorker)
+            return;
+        this.cartTimer = setInterval(() => {
+            this.cartSvc.scan().catch((e) => {
+                common_1.Logger.error(`Abandoned-cart scan failed: ${e === null || e === void 0 ? void 0 : e.message}`, loggerCtx);
+            });
+        }, 5 * 60000);
+        // Fire once at boot so a fresh install doesn't wait 5 min for
+        // its first sweep.
+        this.cartSvc.scan().catch((e) => {
+            common_1.Logger.error(`Initial abandoned-cart scan failed: ${e === null || e === void 0 ? void 0 : e.message}`, loggerCtx);
+        });
+        this.recsTimer = setInterval(() => {
+            this.recsSvc.aggregateCoViews(6).catch((e) => {
+                common_1.Logger.error(`Co-view aggregation failed: ${e === null || e === void 0 ? void 0 : e.message}`, loggerCtx);
+            });
+        }, 6 * 60 * 60000);
+        common_1.Logger.log('Abandoned-cart + recommendations scanners started (worker)', loggerCtx);
+    }
+    onApplicationShutdown() {
+        if (this.cartTimer) {
+            clearInterval(this.cartTimer);
+            this.cartTimer = null;
+        }
+        if (this.recsTimer) {
+            clearInterval(this.recsTimer);
+            this.recsTimer = null;
+        }
+    }
+};
+exports.AbandonedCartScanner = AbandonedCartScanner;
+exports.AbandonedCartScanner = AbandonedCartScanner = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [abandoned_cart_service_1.AbandonedCartService,
+        recommendations_service_1.RecommendationsService,
+        core_1.ProcessContext])
+], AbandonedCartScanner);
+//# sourceMappingURL=abandoned-cart.scanner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abandoned-cart.scanner.js","sourceRoot":"","sources":["../src/abandoned-cart.scanner.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAmG;AACnG,wCAA+C;AAC/C,qEAAgE;AAChE,uEAAmE;AAEnE,MAAM,SAAS,GAAG,sBAAsB,CAAC;AAEzC;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAI7B,YACqB,OAA6B,EAC7B,OAA+B,EAC/B,cAA8B;QAF9B,YAAO,GAAP,OAAO,CAAsB;QAC7B,YAAO,GAAP,OAAO,CAAwB;QAC/B,mBAAc,GAAd,cAAc,CAAgB;QAN3C,cAAS,GAA0B,IAAI,CAAC;QACxC,cAAS,GAA0B,IAAI,CAAC;IAM7C,CAAC;IAEJ,sBAAsB;QAClB,6DAA6D;QAC7D,wDAAwD;QACxD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ;YAAE,OAAO;QAE1C,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE;gBACjC,eAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;QACP,CAAC,EAAE,CAAC,GAAG,KAAM,CAAC,CAAC;QACf,8DAA8D;QAC9D,mBAAmB;QACnB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE;YACjC,eAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE;gBAC9C,eAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;QACP,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAM,CAAC,CAAC;QAEpB,eAAM,CAAC,GAAG,CAAC,4DAA4D,EAAE,SAAS,CAAC,CAAC;IACxF,CAAC;IAED,qBAAqB;QACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAAC,CAAC;IACjF,CAAC;CACJ,CAAA;AAvCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;qCAMqB,6CAAoB;QACpB,gDAAsB;QACf,qBAAc;GAP1C,oBAAoB,CAuChC"}

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

@@ -0,0 +1,92 @@
+import { TransactionalConnection } from '@vendure/core';
+import { AbandonedCartStatus } from './abandoned-cart.entity';
+/** Payload of a `cart_snapshot` custom event as posted by the storefront. */
+export interface CartSnapshotMeta {
+    currency?: string;
+    totalMinor?: number;
+    itemCount?: number;
+    items?: Array<{
+        variantId?: number | string;
+        productId?: number | string;
+        name?: string;
+        qty?: number;
+        unitPriceMinor?: number;
+        sku?: string;
+    }>;
+    /** Optional — email captured at checkout step 1. */
+    email?: string;
+    countryCode?: string;
+}
+/**
+ * Config knobs. All optional; defaults tuned for the common case of a
+ * B2C storefront with a ~15 min average checkout time. Set via
+ * VisitorAnalyticsPluginOptions.abandonment.
+ */
+export interface AbandonmentOptions {
+    /** Minutes since the last `cart_snapshot` before we mark a session
+     *  as abandoned. Default 30 — long enough that a paused checkout
+     *  isn't premature, short enough that recovery emails still feel
+     *  timely. */
+    windowMinutes?: number;
+    /** Currency-minor threshold below which we don't emit a Slack
+     *  notification. Prevents 3-figure inbox noise from every £5 cart
+     *  drop-off. Default 5000 (£50 / $50). */
+    slackMinValueMinor?: number;
+    /** Slack webhook URL. When unset, notifications are logged only. */
+    slackWebhookUrl?: string;
+    /** Recovery-link HMAC secret. When unset, recovery-link generation
+     *  returns null (feature disabled). Set this to something long and
+     *  random. */
+    recoveryLinkSecret?: string;
+    /** Recovery-link TTL in hours. Default 72. */
+    recoveryLinkTtlHours?: number;
+    /** Storefront base URL — where the recovery link lands. Something
+     *  like `https://shop.example.com`. Default: publicBaseUrl. */
+    storefrontBaseUrl?: string;
+}
+export declare class AbandonedCartService {
+    private connection;
+    constructor(connection: TransactionalConnection);
+    private opts;
+    /**
+     * Full detection pass. Runs periodically (cron). Finds every session
+     * that:
+     *   1. Fired ≥1 `cart_snapshot` event
+     *   2. Did NOT fire `checkout_completed` since
+     *   3. Last snapshot is older than `windowMinutes`
+     *   4. Not already covered by an `abandoned_cart` row with same sessionId
+     *
+     * Upserts a row per matched session. Marks any existing `abandoned`
+     * row as `converted` when a matching `checkout_completed` is seen.
+     * Fires the Slack notification for fresh rows above the threshold.
+     */
+    scan(): Promise<{
+        opened: number;
+        converted: number;
+        slacked: number;
+    }>;
+    /**
+     * Generate a signed recovery link that the storefront can decode to
+     * restore the cart. Returns null when the recovery-link secret is
+     * unset (feature disabled). Idempotent: reissues a fresh token so
+     * you can safely regenerate before every send.
+     */
+    issueRecoveryLink(cartId: number): Promise<string | null>;
+    /**
+     * Look up an abandoned cart by its recovery token. Returns null if
+     * the token is unknown, expired, or the cart is already recovered.
+     * Storefront calls this via `/ees/recover-cart?t=...` to rebuild the
+     * cart from the persisted itemsJson.
+     */
+    findByRecoveryToken(token: string): Promise<{
+        id: number;
+        currency: string;
+        items: any[];
+        email: string | null;
+    } | null>;
+    markStatus(cartId: number, status: AbandonedCartStatus): Promise<boolean>;
+    private parseMeta;
+    private postSlack;
+    private formatMoney;
+}
+//# sourceMappingURL=abandoned-cart.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abandoned-cart.service.d.ts","sourceRoot":"","sources":["../src/abandoned-cart.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAiB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAK7E,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;QACV,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,GAAG,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;kBAGc;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;8CAE0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;kBAEc;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;mEAC+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBACa,oBAAoB;IACjB,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,uBAAuB;IAEvD,OAAO,CAAC,IAAI;IAYZ;;;;;;;;;;;OAWG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAmJ7E;;;;;OAKG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB/D;;;;;OAKG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9C,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,GAAG,EAAE,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,IAAI,CAAC;IAsBH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAY/E,OAAO,CAAC,SAAS;YAYH,SAAS;IA4BvB,OAAO,CAAC,WAAW;CAUtB"}

package/dist/abandoned-cart.service.js

@@ -0,0 +1,276 @@
+"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.AbandonedCartService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const crypto_1 = require("crypto");
+const plugin_1 = require("./plugin");
+const loggerCtx = 'HuloAbandonedCartService';
+let AbandonedCartService = class AbandonedCartService {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    opts() {
+        var _a, _b, _c, _d, _e, _f;
+        const raw = (0, plugin_1.getOptions)().abandonment;
+        return {
+            windowMinutes: (_a = raw === null || raw === void 0 ? void 0 : raw.windowMinutes) !== null && _a !== void 0 ? _a : 30,
+            slackMinValueMinor: (_b = raw === null || raw === void 0 ? void 0 : raw.slackMinValueMinor) !== null && _b !== void 0 ? _b : 5000,
+            slackWebhookUrl: (_c = raw === null || raw === void 0 ? void 0 : raw.slackWebhookUrl) !== null && _c !== void 0 ? _c : '',
+            recoveryLinkSecret: (_d = raw === null || raw === void 0 ? void 0 : raw.recoveryLinkSecret) !== null && _d !== void 0 ? _d : '',
+            recoveryLinkTtlHours: (_e = raw === null || raw === void 0 ? void 0 : raw.recoveryLinkTtlHours) !== null && _e !== void 0 ? _e : 72,
+            storefrontBaseUrl: (_f = raw === null || raw === void 0 ? void 0 : raw.storefrontBaseUrl) !== null && _f !== void 0 ? _f : (0, plugin_1.getOptions)().publicBaseUrl,
+        };
+    }
+    /**
+     * Full detection pass. Runs periodically (cron). Finds every session
+     * that:
+     *   1. Fired ≥1 `cart_snapshot` event
+     *   2. Did NOT fire `checkout_completed` since
+     *   3. Last snapshot is older than `windowMinutes`
+     *   4. Not already covered by an `abandoned_cart` row with same sessionId
+     *
+     * Upserts a row per matched session. Marks any existing `abandoned`
+     * row as `converted` when a matching `checkout_completed` is seen.
+     * Fires the Slack notification for fresh rows above the threshold.
+     */
+    async scan() {
+        var _a, _b, _c, _d, _e;
+        const o = this.opts();
+        const conn = this.connection.rawConnection;
+        const cutoff = new Date(Date.now() - o.windowMinutes * 60000);
+        // 1. Auto-mark existing abandoned rows as converted when a
+        //    matching checkout_completed lands afterwards.
+        const converted = await conn.query(`UPDATE abandoned_cart ac
+             SET ac.status = 'converted', ac.recoveredAt = NOW()
+             WHERE ac.status = 'abandoned'
+               AND EXISTS (
+                 SELECT 1 FROM visitor_event ve
+                 WHERE ve.sessionId = ac.sessionId
+                   AND ve.type = 'event'
+                   AND ve.meta LIKE '%"eventType":"checkout_completed"%'
+                   AND ve.createdAt > ac.abandonedAt
+               )`);
+        const convertedCount = Number((_b = (_a = converted === null || converted === void 0 ? void 0 : converted.affectedRows) !== null && _a !== void 0 ? _a : converted === null || converted === void 0 ? void 0 : converted[1]) !== null && _b !== void 0 ? _b : 0);
+        // 2. Find candidate sessions.
+        const candidates = await conn.query(`SELECT
+                ve.sessionId,
+                MAX(ve.visitorId) AS visitorId,
+                MAX(ve.customerId) AS customerId,
+                MAX(ve.channelId) AS channelId,
+                MIN(ve.createdAt) AS firstAt,
+                MAX(ve.createdAt) AS lastAt,
+                MAX(ve.url) AS lastUrl,
+                MAX(ve.referrer) AS lastReferrer,
+                MAX(ve.utmSource) AS utmSource,
+                MAX(ve.utmMedium) AS utmMedium,
+                MAX(ve.utmCampaign) AS utmCampaign,
+                MAX(ve.country) AS countryCode,
+                SUBSTRING_INDEX(GROUP_CONCAT(ve.meta ORDER BY ve.createdAt DESC SEPARATOR '¦'), '¦', 1) AS lastMeta
+             FROM visitor_event ve
+             WHERE ve.type = 'event'
+               AND ve.meta LIKE '%"eventType":"cart_snapshot"%'
+               AND ve.createdAt >= (NOW() - INTERVAL 48 HOUR)
+               AND ve.createdAt <= ?
+               AND NOT EXISTS (
+                 SELECT 1 FROM visitor_event ve2
+                 WHERE ve2.sessionId = ve.sessionId
+                   AND ve2.type = 'event'
+                   AND ve2.meta LIKE '%"eventType":"checkout_completed"%'
+                   AND ve2.createdAt >= ve.createdAt
+               )
+               AND NOT EXISTS (
+                 SELECT 1 FROM visitor_event ve3
+                 WHERE ve3.sessionId = ve.sessionId
+                   AND ve3.type = 'event'
+                   AND ve3.meta LIKE '%"eventType":"cart_snapshot"%'
+                   AND ve3.createdAt > ?
+               )
+             GROUP BY ve.sessionId
+             LIMIT 500`, [cutoff, cutoff]);
+        let opened = 0;
+        let slacked = 0;
+        for (const c of candidates) {
+            const meta = this.parseMeta(c.lastMeta);
+            if (!meta)
+                continue;
+            const totalMinor = Number(meta.totalMinor || 0);
+            const itemCount = Number((_e = (_c = meta.itemCount) !== null && _c !== void 0 ? _c : (_d = meta.items) === null || _d === void 0 ? void 0 : _d.length) !== null && _e !== void 0 ? _e : 0);
+            if (!itemCount)
+                continue; // empty cart isn't abandonment
+            const items = Array.isArray(meta.items) ? meta.items : [];
+            const email = (meta.email || '').trim().toLowerCase() || null;
+            const emailHash = email ? (0, crypto_1.createHash)('sha256').update(email).digest('hex') : null;
+            const existing = await conn.query(`SELECT id, status, notificationSent FROM abandoned_cart WHERE sessionId = ? LIMIT 1`, [c.sessionId]);
+            if (existing === null || existing === void 0 ? void 0 : existing.length) {
+                // Refresh in place — but never resurrect a converted/dismissed row.
+                if (existing[0].status !== 'abandoned')
+                    continue;
+                await conn.query(`UPDATE abandoned_cart SET
+                        totalMinor = ?, itemCount = ?, itemsJson = ?,
+                        email = COALESCE(?, email),
+                        emailHash = COALESCE(?, emailHash),
+                        lastSnapshotAt = ?, lastKnownUrl = ?,
+                        countryCode = COALESCE(?, countryCode),
+                        updatedAt = NOW(3)
+                     WHERE id = ?`, [
+                    totalMinor, itemCount, JSON.stringify(items),
+                    email, emailHash,
+                    new Date(c.lastAt), c.lastUrl,
+                    meta.countryCode || c.countryCode,
+                    existing[0].id,
+                ]);
+                continue;
+            }
+            await conn.query(`INSERT INTO abandoned_cart (
+                    visitorId, sessionId, customerId, channelId,
+                    currency, totalMinor, itemCount, itemsJson,
+                    email, emailHash,
+                    firstSnapshotAt, lastSnapshotAt, abandonedAt,
+                    status, lastKnownUrl, lastKnownReferrer,
+                    utmSource, utmMedium, utmCampaign, countryCode,
+                    notificationSent, createdAt, updatedAt
+                 ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, NOW(3), 'abandoned', ?, ?, ?, ?, ?, ?, 0, NOW(3), NOW(3))`, [
+                c.visitorId, c.sessionId, c.customerId, c.channelId || 1,
+                (meta.currency || 'GBP').slice(0, 3), totalMinor, itemCount, JSON.stringify(items),
+                email, emailHash,
+                new Date(c.firstAt), new Date(c.lastAt),
+                c.lastUrl, c.lastReferrer,
+                c.utmSource, c.utmMedium, c.utmCampaign,
+                meta.countryCode || c.countryCode,
+            ]);
+            opened += 1;
+            if (totalMinor >= o.slackMinValueMinor && o.slackWebhookUrl) {
+                try {
+                    await this.postSlack(o.slackWebhookUrl, {
+                        totalMinor, itemCount, items, email,
+                        countryCode: meta.countryCode || c.countryCode,
+                        lastUrl: c.lastUrl,
+                        currency: (meta.currency || 'GBP').slice(0, 3),
+                    });
+                    await conn.query(`UPDATE abandoned_cart SET notificationSent = 1 WHERE sessionId = ?`, [c.sessionId]);
+                    slacked += 1;
+                }
+                catch (e) {
+                    common_1.Logger.warn(`Slack notify failed for session=${c.sessionId}: ${e === null || e === void 0 ? void 0 : e.message}`, loggerCtx);
+                }
+            }
+        }
+        if (opened || convertedCount) {
+            common_1.Logger.log(`Abandonment scan: +${opened} opened / +${convertedCount} converted / ${slacked} slacked`, loggerCtx);
+        }
+        return { opened, converted: convertedCount, slacked };
+    }
+    /**
+     * Generate a signed recovery link that the storefront can decode to
+     * restore the cart. Returns null when the recovery-link secret is
+     * unset (feature disabled). Idempotent: reissues a fresh token so
+     * you can safely regenerate before every send.
+     */
+    async issueRecoveryLink(cartId) {
+        const o = this.opts();
+        if (!o.recoveryLinkSecret)
+            return null;
+        const conn = this.connection.rawConnection;
+        const rows = await conn.query(`SELECT sessionId, visitorId FROM abandoned_cart WHERE id = ? LIMIT 1`, [cartId]);
+        if (!(rows === null || rows === void 0 ? void 0 : rows.length))
+            return null;
+        const token = (0, crypto_1.randomBytes)(24).toString('base64url');
+        const expiresAt = new Date(Date.now() + o.recoveryLinkTtlHours * 3600000);
+        await conn.query(`UPDATE abandoned_cart SET recoveryToken = ?, recoveryTokenExpiresAt = ? WHERE id = ?`, [token, expiresAt, cartId]);
+        const base = (o.storefrontBaseUrl || '').replace(/\/$/, '');
+        return `${base}/cart/restore?t=${token}`;
+    }
+    /**
+     * Look up an abandoned cart by its recovery token. Returns null if
+     * the token is unknown, expired, or the cart is already recovered.
+     * Storefront calls this via `/ees/recover-cart?t=...` to rebuild the
+     * cart from the persisted itemsJson.
+     */
+    async findByRecoveryToken(token) {
+        const conn = this.connection.rawConnection;
+        const rows = await conn.query(`SELECT id, currency, itemsJson, email, recoveryTokenExpiresAt, status
+             FROM abandoned_cart WHERE recoveryToken = ? LIMIT 1`, [token]);
+        if (!(rows === null || rows === void 0 ? void 0 : rows.length))
+            return null;
+        const r = rows[0];
+        if (r.status === 'expired' || r.status === 'converted')
+            return null;
+        if (r.recoveryTokenExpiresAt && new Date(r.recoveryTokenExpiresAt).getTime() < Date.now()) {
+            await conn.query(`UPDATE abandoned_cart SET status = 'expired' WHERE id = ?`, [r.id]);
+            return null;
+        }
+        let items = [];
+        try {
+            items = JSON.parse(r.itemsJson || '[]');
+        }
+        catch { }
+        return { id: Number(r.id), currency: String(r.currency || 'GBP'), items, email: r.email };
+    }
+    async markStatus(cartId, status) {
+        var _a;
+        const conn = this.connection.rawConnection;
+        const setRecovered = status === 'recovered' ? ', recoveredAt = NOW(3)' : '';
+        const res = await conn.query(`UPDATE abandoned_cart SET status = ? ${setRecovered} WHERE id = ?`, [status, cartId]);
+        return Number((_a = res === null || res === void 0 ? void 0 : res.affectedRows) !== null && _a !== void 0 ? _a : 0) > 0;
+    }
+    // ── helpers ─────────────────────────────────────────────────────
+    parseMeta(raw) {
+        if (!raw)
+            return null;
+        try {
+            const parsed = JSON.parse(raw);
+            // Custom-event rows have `{ eventType, ... }` — the payload
+            // is the rest of the object.
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    async postSlack(url, payload) {
+        const money = this.formatMoney(payload.totalMinor, payload.currency);
+        const itemList = payload.items.slice(0, 5)
+            .map(i => { var _a, _b; return `• ${(_a = i.qty) !== null && _a !== void 0 ? _a : 1}× ${(_b = i.name) !== null && _b !== void 0 ? _b : '(unnamed item)'}`; })
+            .join('\n');
+        const more = payload.items.length > 5 ? `\n_…and ${payload.items.length - 5} more_` : '';
+        const parts = [
+            `🛒 *Abandoned cart* — ${money} · ${payload.itemCount} item${payload.itemCount === 1 ? '' : 's'}`,
+            payload.email ? `Contact: \`${payload.email}\`` : '_(no email captured)_',
+            payload.countryCode ? `Country: ${payload.countryCode}` : '',
+            payload.lastUrl ? `Last URL: ${payload.lastUrl}` : '',
+            itemList + more,
+        ].filter(Boolean);
+        await fetch(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ text: parts.join('\n') }),
+        });
+    }
+    formatMoney(minor, currency) {
+        const major = (minor || 0) / 100;
+        try {
+            return new Intl.NumberFormat('en-GB', {
+                style: 'currency', currency,
+            }).format(major);
+        }
+        catch {
+            return `${currency} ${major.toFixed(2)}`;
+        }
+    }
+};
+exports.AbandonedCartService = AbandonedCartService;
+exports.AbandonedCartService = AbandonedCartService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.TransactionalConnection])
+], AbandonedCartService);
+//# sourceMappingURL=abandoned-cart.service.js.map