@huloglobal/vendure-plugin-email-tracking 0.1.0

package/dist/email-tracking.controller.js

@@ -0,0 +1,260 @@
+"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.EmailTrackingController = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const email_log_entity_1 = require("./email-log.entity");
+const email_tracking_service_1 = require("./email-tracking.service");
+const loggerCtx = 'EmailTrackingController';
+// 1×1 transparent GIF (43 bytes) returned by the open-tracking endpoint.
+const ONE_PX_GIF = Buffer.from('R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7', 'base64');
+const proxy_headers_1 = require("./proxy-headers");
+function realIp(req) { return (0, proxy_headers_1.getRealIp)(req); }
+function requireAdmin(ctx, res, write = false) {
+    if (!(ctx === null || ctx === void 0 ? void 0 : ctx.activeUserId)) {
+        res.status(401).json({ error: 'Authentication required' });
+        return false;
+    }
+    const needed = write ? [core_1.Permission.UpdateCustomer] : [core_1.Permission.ReadCustomer];
+    if (!ctx.userHasPermissions(needed)) {
+        res.status(403).json({ error: 'Insufficient permissions' });
+        return false;
+    }
+    return true;
+}
+let EmailTrackingController = class EmailTrackingController {
+    constructor(connection, tracking) {
+        this.connection = connection;
+        this.tracking = tracking;
+    }
+    /**
+     * Open-tracking pixel. Returns a 1×1 transparent GIF and logs the
+     * open against the event. No-cache so privacy-protecting prefetchers
+     * still get caught per fetch (and we count opens accurately).
+     *
+     * GET /email-track/open/:id.gif
+     */
+    async open(idParam, req, res) {
+        const id = parseInt(idParam, 10);
+        if (!isNaN(id) && id > 0) {
+            this.tracking.recordOpen(id, realIp(req), req.headers['user-agent'] || null)
+                .catch((e) => core_1.Logger.warn(`open log fail #${id}: ${e === null || e === void 0 ? void 0 : e.message}`, loggerCtx));
+        }
+        res.setHeader('Content-Type', 'image/gif');
+        res.setHeader('Cache-Control', 'no-store, no-cache, must-revalidate, proxy-revalidate, max-age=0');
+        res.setHeader('Pragma', 'no-cache');
+        res.setHeader('Expires', '0');
+        return res.end(ONE_PX_GIF);
+    }
+    /**
+     * Click redirect. Logs the click then 302-redirects to the original
+     * URL. Returns 400 if the URL is missing or malformed (we never
+     * redirect to an empty / javascript: target).
+     *
+     * GET /email-track/click/:id?u=<encoded>
+     */
+    async click(idParam, u, req, res) {
+        const id = parseInt(idParam, 10);
+        const url = (u || '').trim();
+        if (!url || !/^https?:\/\//i.test(url)) {
+            return res.status(400).send('Invalid redirect target');
+        }
+        if (!isNaN(id) && id > 0) {
+            await this.tracking.recordClick(id, url, realIp(req), req.headers['user-agent'] || null)
+                .catch((e) => core_1.Logger.warn(`click log fail #${id}: ${e === null || e === void 0 ? void 0 : e.message}`, loggerCtx));
+        }
+        res.setHeader('Cache-Control', 'no-store');
+        return res.redirect(302, url);
+    }
+    /**
+     * Bounce webhook. Wire up a postmaster / mail-server hook (or have a
+     * scheduled DSN-parser POST here) to mark messages as bounced or
+     * complained. Both fields are required; the messageId is the
+     * `<...@domain>` value Gmail returned at submit time.
+     *
+     * POST /email-track/bounce
+     * Body: { messageId, status: 'bounced'|'complained', reason? }
+     *
+     * Currently unauthenticated to keep the integration simple — gate
+     * behind a shared secret header if you expose the endpoint to the
+     * public internet (it's fine on a private network).
+     */
+    async bounce(body, res) {
+        const messageId = String((body === null || body === void 0 ? void 0 : body.messageId) || '').trim();
+        const status = (body === null || body === void 0 ? void 0 : body.status) === 'complained' ? 'complained' : 'bounced';
+        if (!messageId)
+            return res.status(400).json({ error: 'messageId required' });
+        const ok = await this.tracking.recordBounce(messageId, status, body === null || body === void 0 ? void 0 : body.reason);
+        return res.json({ ok, matched: ok });
+    }
+    /**
+     * Admin: list email events, with filtering for the "Email Log" page
+     * and the per-customer Emails tab. Filterable by customerId, orderId,
+     * orderCode, status, type, recipient, and a date range.
+     *
+     * GET /email-track/log?customerId=&orderId=&status=&take=
+     */
+    async listLog(ctx, req, res) {
+        if (!requireAdmin(ctx, res, false))
+            return;
+        const q = req.query;
+        const take = Math.min(parseInt(q.take, 10) || 100, 500);
+        const skip = parseInt(q.skip, 10) || 0;
+        const where = [];
+        const params = [];
+        if (q.customerId) {
+            where.push('customerId = ?');
+            params.push(parseInt(q.customerId, 10));
+        }
+        if (q.orderId) {
+            where.push('orderId = ?');
+            params.push(parseInt(q.orderId, 10));
+        }
+        if (q.orderCode) {
+            where.push('orderCode = ?');
+            params.push(String(q.orderCode));
+        }
+        if (q.invoiceId) {
+            where.push('invoiceId = ?');
+            params.push(parseInt(q.invoiceId, 10));
+        }
+        if (q.status) {
+            where.push('status = ?');
+            params.push(String(q.status));
+        }
+        if (q.type) {
+            where.push('type = ?');
+            params.push(String(q.type));
+        }
+        if (q.recipient) {
+            where.push('recipient LIKE ?');
+            params.push(`%${String(q.recipient)}%`);
+        }
+        if (q.from) {
+            where.push('createdAt >= ?');
+            params.push(new Date(String(q.from)));
+        }
+        if (q.to) {
+            where.push('createdAt <= ?');
+            params.push(new Date(String(q.to)));
+        }
+        const whereClause = where.length ? ` WHERE ${where.join(' AND ')}` : '';
+        const rows = await this.connection.rawConnection.query(`SELECT id, createdAt, type, recipient, subject, status,
+                    customerId, orderId, orderCode, invoiceId, applicationId,
+                    channelId, openCount, firstOpenedAt, lastOpenedAt,
+                    clickCount, firstClickedAt, smtpResponse, errorMessage
+             FROM email_log
+             ${whereClause}
+             ORDER BY createdAt DESC
+             LIMIT ? OFFSET ?`, [...params, take, skip]);
+        const [{ total }] = await this.connection.rawConnection.query(`SELECT COUNT(*) AS total FROM email_log${whereClause}`, params);
+        return res.json({ items: rows, total: Number(total) || 0, take, skip });
+    }
+    /** Admin: aggregate counts by status for a quick dashboard tile. */
+    async logSummary(ctx, req, res) {
+        if (!requireAdmin(ctx, res, false))
+            return;
+        const fromDays = parseInt(req.query.fromDays, 10) || 30;
+        const rows = await this.connection.rawConnection.query(`SELECT status, COUNT(*) AS n, SUM(openCount) AS opens, SUM(clickCount) AS clicks
+             FROM email_log
+             WHERE createdAt >= DATE_SUB(NOW(), INTERVAL ? DAY)
+             GROUP BY status`, [fromDays]);
+        const summary = { sent: 0, failed: 0, deferred: 0, bounced: 0, complained: 0, opens: 0, clicks: 0, fromDays };
+        for (const r of rows) {
+            summary[r.status] = Number(r.n);
+            summary.opens += Number(r.opens) || 0;
+            summary.clicks += Number(r.clicks) || 0;
+        }
+        return res.json(summary);
+    }
+    /** Admin: full detail for one event including the clicks JSON. */
+    async logDetail(ctx, idParam, res) {
+        if (!requireAdmin(ctx, res, false))
+            return;
+        const id = parseInt(idParam, 10);
+        if (!id)
+            return res.status(400).json({ error: 'Invalid id' });
+        const row = await this.connection.rawConnection.getRepository(email_log_entity_1.EmailLog).findOne({ where: { id } });
+        if (!row)
+            return res.status(404).json({ error: 'Not found' });
+        let clicks = [];
+        try {
+            clicks = JSON.parse(row.clicksJson || '[]');
+        }
+        catch { }
+        return res.json({ ...row, clicks, clicksJson: undefined });
+    }
+};
+exports.EmailTrackingController = EmailTrackingController;
+__decorate([
+    (0, common_1.Get)('open/:id.gif'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Req)()),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object]),
+    __metadata("design:returntype", Promise)
+], EmailTrackingController.prototype, "open", null);
+__decorate([
+    (0, common_1.Get)('click/:id'),
+    __param(0, (0, common_1.Param)('id')),
+    __param(1, (0, common_1.Query)('u')),
+    __param(2, (0, common_1.Req)()),
+    __param(3, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object, Object]),
+    __metadata("design:returntype", Promise)
+], EmailTrackingController.prototype, "click", null);
+__decorate([
+    (0, common_1.Post)('bounce'),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], EmailTrackingController.prototype, "bounce", null);
+__decorate([
+    (0, common_1.Get)('log'),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Req)()),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object, Object]),
+    __metadata("design:returntype", Promise)
+], EmailTrackingController.prototype, "listLog", null);
+__decorate([
+    (0, common_1.Get)('log/summary'),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Req)()),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object, Object]),
+    __metadata("design:returntype", Promise)
+], EmailTrackingController.prototype, "logSummary", null);
+__decorate([
+    (0, common_1.Get)('log/:id'),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, common_1.Param)('id')),
+    __param(2, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, String, Object]),
+    __metadata("design:returntype", Promise)
+], EmailTrackingController.prototype, "logDetail", null);
+exports.EmailTrackingController = EmailTrackingController = __decorate([
+    (0, common_1.Controller)('email-track'),
+    __metadata("design:paramtypes", [core_1.TransactionalConnection,
+        email_tracking_service_1.EmailTrackingService])
+], EmailTrackingController);
+//# sourceMappingURL=email-tracking.controller.js.map

package/dist/email-tracking.controller.js.map

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

package/dist/email-tracking.service.d.ts

@@ -0,0 +1,48 @@
+import { TransactionalConnection } from '@vendure/core';
+import * as nodemailer from 'nodemailer';
+import { EmailLog } from './email-log.entity';
+interface SendTrackedMeta {
+    /** Logical email type — e.g. 'welcome', 'order-confirmation', 'invoice'. */
+    type: string;
+    /** Optional context string, e.g. chase stage 'T-7' / 'due' / 'T+14'. */
+    context?: string;
+    /** Channel id (1 = elite, 2 = LD). Defaults to 1. */
+    channelId?: number;
+    customerId?: number;
+    orderId?: number;
+    orderCode?: string;
+    invoiceId?: number;
+    applicationId?: number;
+}
+export declare class EmailTrackingService {
+    private connection;
+    constructor(connection: TransactionalConnection);
+    /**
+     * Send an email through nodemailer with full tracking: creates an
+     * EmailLog row, injects a 1×1 open-tracking pixel, rewrites every
+     * `href` in the html to go through our click-tracker, records the
+     * SMTP response on success / failure.
+     *
+     * Returns the created EmailLog row (with id). Throws only if the
+     * transport configuration itself is invalid; SMTP delivery failures
+     * are caught and recorded as status='failed' / 'deferred'.
+     */
+    sendTracked(transporter: nodemailer.Transporter, mail: nodemailer.SendMailOptions, meta: SendTrackedMeta): Promise<EmailLog>;
+    /** Wrap an HTML body for tracking: rewrite links + append open pixel. */
+    wrapHtml(html: string, eventId: number): string;
+    /** Rewrite every <a href> in the html to go through the click tracker.
+     *  Skips mailto:, tel:, #anchors, our own tracking endpoints, and the
+     *  unsubscribe link (always passthrough). */
+    private rewriteLinks;
+    /** Record a pixel-hit open. Idempotent re-counting; firstOpenedAt only
+     *  set the first time. */
+    recordOpen(id: number, ip: string | null, ua: string | null): Promise<void>;
+    /** Record a click + return the original URL so the controller can 302. */
+    recordClick(id: number, url: string, ip: string | null, ua: string | null): Promise<string | null>;
+    /** SMTP DSN (bounce / complaint) hook — wire up if you point Postmaster
+     *  Tools / a bounce-processor at /email-track/bounce. */
+    recordBounce(messageId: string, status: 'bounced' | 'complained', reason?: string): Promise<boolean>;
+    private firstAddress;
+}
+export {};
+//# sourceMappingURL=email-tracking.service.d.ts.map

package/dist/email-tracking.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-tracking.service.d.ts","sourceRoot":"","sources":["../src/email-tracking.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,UAAU,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAkB,MAAM,oBAAoB,CAAC;AAK9D,UAAU,eAAe;IACrB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBACa,oBAAoB;IACjB,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,uBAAuB;IAEvD;;;;;;;;;OASG;IACG,WAAW,CACb,WAAW,EAAE,UAAU,CAAC,WAAW,EACnC,IAAI,EAAE,UAAU,CAAC,eAAe,EAChC,IAAI,EAAE,eAAe,GACtB,OAAO,CAAC,QAAQ,CAAC;IAwDpB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAW/C;;iDAE6C;IAC7C,OAAO,CAAC,YAAY;IAepB;8BAC0B;IACpB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAejE,0EAA0E;IACpE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAuBxG;6DACyD;IACnD,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM;IAUvF,OAAO,CAAC,YAAY;CAOvB"}

package/dist/email-tracking.service.js

@@ -0,0 +1,196 @@
+"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.EmailTrackingService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const email_log_entity_1 = require("./email-log.entity");
+const options_1 = require("./options");
+const loggerCtx = 'EmailTrackingService';
+let EmailTrackingService = class EmailTrackingService {
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Send an email through nodemailer with full tracking: creates an
+     * EmailLog row, injects a 1×1 open-tracking pixel, rewrites every
+     * `href` in the html to go through our click-tracker, records the
+     * SMTP response on success / failure.
+     *
+     * Returns the created EmailLog row (with id). Throws only if the
+     * transport configuration itself is invalid; SMTP delivery failures
+     * are caught and recorded as status='failed' / 'deferred'.
+     */
+    async sendTracked(transporter, mail, meta) {
+        const repo = this.connection.rawConnection.getRepository(email_log_entity_1.EmailLog);
+        // Create the row up-front so the pixel/click URLs have an id to
+        // reference. status starts as 'sent' optimistically; we update
+        // it if the SMTP submit throws or returns 4xx/5xx.
+        const row = repo.create({
+            type: meta.type,
+            recipient: this.firstAddress(mail.to),
+            subject: String(mail.subject || ''),
+            fromAddress: this.firstAddress(mail.from),
+            bcc: this.firstAddress(mail.bcc),
+            replyTo: this.firstAddress(mail.replyTo),
+            context: meta.context,
+            channelId: meta.channelId || 1,
+            customerId: meta.customerId,
+            orderId: meta.orderId,
+            orderCode: meta.orderCode,
+            invoiceId: meta.invoiceId,
+            applicationId: meta.applicationId,
+            status: 'sent',
+            tracked: true,
+        });
+        const saved = await repo.save(row);
+        // Wrap the HTML — clicks first (so the pixel itself isn't rewritten),
+        // then the pixel append. Plain-text-only emails are unaffected.
+        const html = mail.html ? String(mail.html) : '';
+        if (html) {
+            const wrapped = this.wrapHtml(html, Number(saved.id));
+            mail = { ...mail, html: wrapped };
+        }
+        // Send.
+        try {
+            const info = await transporter.sendMail(mail);
+            saved.smtpResponse = String(info.response || '').slice(0, 500);
+            saved.smtpMessageId = String(info.messageId || '').slice(0, 500);
+            // Gmail's "250 2.0.0 OK" → sent. 4xx → deferred. 5xx → failed.
+            const code = parseInt((info.response || '').split(' ')[0], 10);
+            if (code >= 500)
+                saved.status = 'failed';
+            else if (code >= 400)
+                saved.status = 'deferred';
+            else
+                saved.status = 'sent';
+            await repo.save(saved);
+        }
+        catch (e) {
+            saved.status = 'failed';
+            saved.errorMessage = String((e === null || e === void 0 ? void 0 : e.message) || e).slice(0, 2000);
+            saved.smtpResponse = (e === null || e === void 0 ? void 0 : e.response) ? String(e.response).slice(0, 500) : '';
+            await repo.save(saved);
+            core_1.Logger.error(`Tracked send FAILED [${meta.type}] to ${saved.recipient}: ${e === null || e === void 0 ? void 0 : e.message}`, loggerCtx);
+            throw e;
+        }
+        core_1.Logger.info(`Tracked send OK [${meta.type}] to ${saved.recipient} (id=${saved.id})`, loggerCtx);
+        return saved;
+    }
+    /** Wrap an HTML body for tracking: rewrite links + append open pixel. */
+    wrapHtml(html, eventId) {
+        const base = (0, options_1.trackingBaseUrl)();
+        const trackedHtml = this.rewriteLinks(html, eventId, base);
+        const pixel = `<img src="${base}/email-track/open/${eventId}.gif" width="1" height="1" alt="" border="0" style="display:none;border:0;max-height:1px;max-width:1px;outline:none;overflow:hidden;visibility:hidden">`;
+        // Insert the pixel just before </body> if possible, otherwise append.
+        if (/<\/body>/i.test(trackedHtml)) {
+            return trackedHtml.replace(/<\/body>/i, `${pixel}</body>`);
+        }
+        return trackedHtml + pixel;
+    }
+    /** Rewrite every <a href> in the html to go through the click tracker.
+     *  Skips mailto:, tel:, #anchors, our own tracking endpoints, and the
+     *  unsubscribe link (always passthrough). */
+    rewriteLinks(html, eventId, base) {
+        const ownPrefixes = (0, options_1.ownTrackingPrefixes)();
+        return html.replace(/<a\b([^>]*?)\bhref\s*=\s*(["'])(.*?)\2/gi, (match, attrs, quote, url) => {
+            const trimmed = String(url).trim();
+            if (!trimmed)
+                return match;
+            if (/^(mailto:|tel:|#)/i.test(trimmed))
+                return match;
+            if (ownPrefixes.some(p => trimmed.startsWith(p)))
+                return match;
+            // unsubscribe / list-unsubscribe links — never rewrite (ESP rules
+            // and recipient privacy expectations).
+            if (/unsubscribe/i.test(trimmed) || /\bopt[-_]?out\b/i.test(trimmed))
+                return match;
+            const encoded = encodeURIComponent(trimmed);
+            return `<a${attrs}href=${quote}${base}/email-track/click/${eventId}?u=${encoded}${quote}`;
+        });
+    }
+    /** Record a pixel-hit open. Idempotent re-counting; firstOpenedAt only
+     *  set the first time. */
+    async recordOpen(id, ip, ua) {
+        const repo = this.connection.rawConnection.getRepository(email_log_entity_1.EmailLog);
+        const row = await repo.findOne({ where: { id } });
+        if (!row)
+            return;
+        const now = new Date();
+        row.lastOpenedAt = now;
+        row.openCount = (row.openCount || 0) + 1;
+        if (!row.firstOpenedAt) {
+            row.firstOpenedAt = now;
+            row.firstOpenIp = ip || undefined;
+            row.firstOpenUserAgent = ua ? ua.slice(0, 1000) : undefined;
+        }
+        await repo.save(row);
+    }
+    /** Record a click + return the original URL so the controller can 302. */
+    async recordClick(id, url, ip, ua) {
+        const repo = this.connection.rawConnection.getRepository(email_log_entity_1.EmailLog);
+        const row = await repo.findOne({ where: { id } });
+        if (!row)
+            return null;
+        const now = new Date();
+        if (!row.firstClickedAt)
+            row.firstClickedAt = now;
+        row.clickCount = (row.clickCount || 0) + 1;
+        let clicks = [];
+        try {
+            clicks = JSON.parse(row.clicksJson || '[]');
+        }
+        catch { }
+        clicks.push({
+            url: url.slice(0, 1000),
+            ts: now.toISOString(),
+            ip,
+            ua: ua ? ua.slice(0, 300) : null,
+        });
+        // Cap the JSON at the most recent 50 events; older ones live as
+        // a per-row clickCount only.
+        if (clicks.length > 50)
+            clicks = clicks.slice(-50);
+        row.clicksJson = JSON.stringify(clicks);
+        await repo.save(row);
+        return url;
+    }
+    /** SMTP DSN (bounce / complaint) hook — wire up if you point Postmaster
+     *  Tools / a bounce-processor at /email-track/bounce. */
+    async recordBounce(messageId, status, reason) {
+        const repo = this.connection.rawConnection.getRepository(email_log_entity_1.EmailLog);
+        const row = await repo.findOne({ where: { smtpMessageId: messageId } });
+        if (!row)
+            return false;
+        row.status = status;
+        if (reason)
+            row.errorMessage = reason.slice(0, 2000);
+        await repo.save(row);
+        return true;
+    }
+    firstAddress(addr) {
+        if (!addr)
+            return undefined;
+        if (typeof addr === 'string')
+            return addr.slice(0, 500);
+        if (Array.isArray(addr))
+            return addr.map(a => typeof a === 'string' ? a : a === null || a === void 0 ? void 0 : a.address).filter(Boolean).join(', ').slice(0, 500);
+        if (addr.address)
+            return String(addr.address).slice(0, 500);
+        return String(addr).slice(0, 500);
+    }
+};
+exports.EmailTrackingService = EmailTrackingService;
+exports.EmailTrackingService = EmailTrackingService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.TransactionalConnection])
+], EmailTrackingService);
+//# sourceMappingURL=email-tracking.service.js.map

package/dist/email-tracking.service.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@huloglobal/vendure-plugin-email-tracking` — public exports.
+ *
+ * Consumers wire the plugin into Vendure via `EmailTrackingPlugin.init()`,
+ * pass `new TrackingEmailSender()` to the `@vendure/email-plugin`'s
+ * `emailSender` option, and (optionally) inject `EmailTrackingService`
+ * into their own custom controllers to send tracked emails outside the
+ * email-plugin pipeline (e.g. ad-hoc transactional sends from plugin
+ * code).
+ */
+export { EmailTrackingPlugin } from './plugin';
+export { TrackingEmailSender } from './tracking-email-sender';
+export { EmailTrackingService } from './email-tracking.service';
+export { EmailLog, EmailLogStatus } from './email-log.entity';
+export { EmailTrackingPluginOptions } from './options';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * `@huloglobal/vendure-plugin-email-tracking` — public exports.
+ *
+ * Consumers wire the plugin into Vendure via `EmailTrackingPlugin.init()`,
+ * pass `new TrackingEmailSender()` to the `@vendure/email-plugin`'s
+ * `emailSender` option, and (optionally) inject `EmailTrackingService`
+ * into their own custom controllers to send tracked emails outside the
+ * email-plugin pipeline (e.g. ad-hoc transactional sends from plugin
+ * code).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailLog = exports.EmailTrackingService = exports.TrackingEmailSender = exports.EmailTrackingPlugin = void 0;
+var plugin_1 = require("./plugin");
+Object.defineProperty(exports, "EmailTrackingPlugin", { enumerable: true, get: function () { return plugin_1.EmailTrackingPlugin; } });
+var tracking_email_sender_1 = require("./tracking-email-sender");
+Object.defineProperty(exports, "TrackingEmailSender", { enumerable: true, get: function () { return tracking_email_sender_1.TrackingEmailSender; } });
+var email_tracking_service_1 = require("./email-tracking.service");
+Object.defineProperty(exports, "EmailTrackingService", { enumerable: true, get: function () { return email_tracking_service_1.EmailTrackingService; } });
+var email_log_entity_1 = require("./email-log.entity");
+Object.defineProperty(exports, "EmailLog", { enumerable: true, get: function () { return email_log_entity_1.EmailLog; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mCAA+C;AAAtC,6GAAA,mBAAmB,OAAA;AAC5B,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA;AAC5B,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAC7B,uDAA8D;AAArD,4GAAA,QAAQ,OAAA"}

package/dist/options.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Module-scoped plugin options. Populated by `EmailTrackingPlugin.init()`
+ * at boot and read by the service / sender / controller via the
+ * exported helpers below. Keeping options in module scope rather than
+ * threading them through every constructor avoids a refactor of the
+ * Nest providers — Nest creates services lazily and we want options
+ * available before that happens.
+ */
+import { LicenceStatus } from '@huloglobal/vendure-licence-sdk';
+export interface EmailTrackingPluginOptions {
+    /**
+     * Public base URL where the tracking endpoints are reachable. Must
+     * be the externally-resolvable hostname of your Vendure server —
+     * the pixel + click URLs we embed in outgoing email point to this
+     * host. Example: `https://shop.example.com`.
+     */
+    publicBaseUrl: string;
+    /**
+     * Required licence JWT for production use. Without a valid key the
+     * plugin still registers and writes basic delivery rows to the
+     * EmailLog table, but the open/click tracking endpoints respond
+     * with 410 Gone and the admin UI shows an "Unlicensed" banner.
+     */
+    licenceKey?: string;
+    /**
+     * Hostnames considered "self" — used by the click rewriter to
+     * detect that a link points to our tracking endpoint and shouldn't
+     * be rewritten a second time. Defaults to `[publicBaseUrl]` if
+     * omitted.
+     */
+    trackedHosts?: string[];
+}
+export declare function setOptions(opts: EmailTrackingPluginOptions): void;
+export declare function getOptions(): EmailTrackingPluginOptions;
+export declare function setLicenceStatus(status: LicenceStatus): void;
+export declare function getLicenceStatus(): LicenceStatus | null;
+/** Public tracking base URL — used by both the click-rewriter and the
+ *  open-pixel injector. Always returns a value without a trailing slash. */
+export declare function trackingBaseUrl(): string;
+/** Hostname prefixes the click-rewriter should treat as already-ours
+ *  and skip rewriting. */
+export declare function ownTrackingPrefixes(): string[];
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,MAAM,WAAW,0BAA0B;IACvC;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AASD,wBAAgB,UAAU,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,CAMjE;AAED,wBAAgB,UAAU,IAAI,0BAA0B,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAE5D;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD;AAED;4EAC4E;AAC5E,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;0BAC0B;AAC1B,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAK9C"}