@pvh-afl/core 1.2.36 → 1.2.38

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export * from './integrations';
 export * from './queue';
 export * from './messaging';
 export * from './theme';
+export * from './notifications';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAC;AAGvB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAC;AAGvB,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -24,4 +24,6 @@ tslib_1.__exportStar(require("./queue"), exports);
 tslib_1.__exportStar(require("./messaging"), exports);
 // Theme (placeholder)
 tslib_1.__exportStar(require("./theme"), exports);
+// Order notifications (shared across brands)
+tslib_1.__exportStar(require("./notifications"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,OAAO;AACP,iDAAuB;AAEvB,QAAQ;AACR,kDAAwB;AAExB,SAAS;AACT,mDAAyB;AAEzB,mBAAmB;AACnB,mDAAyB;AAEzB,2EAA2E;AAC3E,oDAA0B;AAE1B,eAAe;AACf,yDAA+B;AAE/B,sBAAsB;AACtB,kDAAwB;AAExB,0CAA0C;AAC1C,sDAA4B;AAE5B,sBAAsB;AACtB,kDAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,OAAO;AACP,iDAAuB;AAEvB,QAAQ;AACR,kDAAwB;AAExB,SAAS;AACT,mDAAyB;AAEzB,mBAAmB;AACnB,mDAAyB;AAEzB,2EAA2E;AAC3E,oDAA0B;AAE1B,eAAe;AACf,yDAA+B;AAE/B,sBAAsB;AACtB,kDAAwB;AAExB,0CAA0C;AAC1C,sDAA4B;AAE5B,sBAAsB;AACtB,kDAAwB;AAExB,6CAA6C;AAC7C,0DAAgC"}

package/dist/integrations/engagement/index.d.ts

@@ -0,0 +1,3 @@
+export * from './netcore-email.types';
+export * from './netcore-email.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/engagement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/engagement/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/integrations/engagement/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./netcore-email.types"), exports);
+tslib_1.__exportStar(require("./netcore-email.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/integrations/engagement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/engagement/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,kEAAwC"}

package/dist/integrations/engagement/netcore-email.service.d.ts

@@ -0,0 +1,32 @@
+import { IntegrationResponse } from '../integration.types';
+import { IEmailService, NetcoreConfig, NetcoreSendRequest, NetcoreSendResult } from './netcore-email.types';
+/**
+ * Netcore (ex-Pepipost) Email API service.
+ *
+ * Sends transactional email. Auth is an `api_key` header, so this does not
+ * extend BaseIntegrationService — that helper forces `Authorization: Bearer`.
+ *
+ * A send is accepted with 202 and a `message_id`; acceptance means Netcore
+ * queued the mail, NOT that it reached the inbox. Delivery outcome arrives on
+ * Netcore's own webhooks/reports.
+ *
+ * @see https://cpaasdocs.netcore.ai/docs/pepipost-api/c2d895762f832-send-an-email
+ */
+export declare class NetcoreEmailService implements IEmailService {
+    private config;
+    private brand;
+    private readonly defaultTimeout;
+    configure(brand: string, config: NetcoreConfig): void;
+    isConfigured(): boolean;
+    /**
+     * Send one email.
+     *
+     * Requires `templateId` or `content` — Netcore has nothing to render
+     * otherwise, and rejects the request.
+     */
+    send(request: NetcoreSendRequest): Promise<IntegrationResponse<NetcoreSendResult>>;
+    private parseBody;
+    private notConfiguredError;
+    private normalizeError;
+}
+//# sourceMappingURL=netcore-email.service.d.ts.map

package/dist/integrations/engagement/netcore-email.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netcore-email.service.d.ts","sourceRoot":"","sources":["../../../src/integrations/engagement/netcore-email.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAoB,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAa/B;;;;;;;;;;;GAWG;AACH,qBACa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAgBrD,YAAY,IAAI,OAAO;IAIvB;;;;;OAKG;IACG,IAAI,CACR,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAiHlD,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/integrations/engagement/netcore-email.service.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetcoreEmailService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../../common/logger");
+const DEFAULT_BASE_URL = 'https://emailapi.netcorecloud.net';
+const SEND_PATH = '/v5.1/mail/send';
+/**
+ * Netcore (ex-Pepipost) Email API service.
+ *
+ * Sends transactional email. Auth is an `api_key` header, so this does not
+ * extend BaseIntegrationService — that helper forces `Authorization: Bearer`.
+ *
+ * A send is accepted with 202 and a `message_id`; acceptance means Netcore
+ * queued the mail, NOT that it reached the inbox. Delivery outcome arrives on
+ * Netcore's own webhooks/reports.
+ *
+ * @see https://cpaasdocs.netcore.ai/docs/pepipost-api/c2d895762f832-send-an-email
+ */
+let NetcoreEmailService = class NetcoreEmailService {
+    config = null;
+    brand = '';
+    defaultTimeout = 10000;
+    configure(brand, config) {
+        this.brand = brand;
+        // Spread first, then apply defaults with `??`. A caller that passes the key
+        // explicitly as undefined (a brand config omitting `baseUrl`) would
+        // otherwise overwrite the default and produce `undefined/v5.1/mail/send`.
+        this.config = {
+            ...config,
+            baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+            timeout: config.timeout ?? this.defaultTimeout,
+        };
+        logger_1.logger.info('Netcore email service configured', {
+            brand,
+            fromEmail: config.fromEmail,
+        });
+    }
+    isConfigured() {
+        return this.config !== null;
+    }
+    /**
+     * Send one email.
+     *
+     * Requires `templateId` or `content` — Netcore has nothing to render
+     * otherwise, and rejects the request.
+     */
+    async send(request) {
+        if (!this.config) {
+            return this.notConfiguredError();
+        }
+        const recipients = request.personalizations?.some((p) => p.to?.length);
+        if (!recipients) {
+            return {
+                success: false,
+                error: {
+                    code: 'MISSING_RECIPIENT',
+                    message: 'Netcore send requires at least one recipient',
+                },
+            };
+        }
+        if (!request.templateId && !request.content?.length) {
+            return {
+                success: false,
+                error: {
+                    code: 'MISSING_BODY',
+                    message: 'Netcore send requires either templateId or content',
+                },
+            };
+        }
+        const body = {
+            from: request.from ?? {
+                email: this.config.fromEmail,
+                name: this.config.fromName,
+            },
+            ...(request.replyTo || this.config.replyTo
+                ? { reply_to: request.replyTo ?? this.config.replyTo }
+                : {}),
+            subject: request.subject,
+            ...(request.templateId ? { template_id: request.templateId } : {}),
+            ...(request.content?.length ? { content: request.content } : {}),
+            ...(request.tags?.length ? { tags: request.tags } : {}),
+            personalizations: request.personalizations.map((p) => ({
+                to: p.to,
+                ...(p.cc?.length ? { cc: p.cc } : {}),
+                ...(p.bcc?.length ? { bcc: p.bcc } : {}),
+                ...(p.attributes ? { attributes: p.attributes } : {}),
+            })),
+            ...(request.settings ? { settings: request.settings } : {}),
+            ...(request.schedule ? { schedule: request.schedule } : {}),
+        };
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.config.timeout ?? this.defaultTimeout);
+            const response = await fetch(`${this.config.baseUrl}${SEND_PATH}`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json',
+                    api_key: this.config.apiKey,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            const raw = await response.text();
+            if (!response.ok) {
+                return { success: false, error: this.normalizeError(response.status, raw) };
+            }
+            const parsed = this.parseBody(raw);
+            // A 2xx can still carry status:"error" — treat only an explicit success as sent.
+            if (parsed?.status && parsed.status !== 'success') {
+                return {
+                    success: false,
+                    error: {
+                        code: 'SEND_REJECTED',
+                        message: parsed.message ?? 'Netcore rejected the send',
+                        details: parsed,
+                    },
+                };
+            }
+            const messageId = parsed?.data?.message_id;
+            if (!messageId) {
+                logger_1.logger.warn('Netcore accepted send without a message_id', {
+                    brand: this.brand,
+                });
+            }
+            return { success: true, data: { messageId: messageId ?? '' } };
+        }
+        catch (error) {
+            logger_1.logger.error('Netcore send failed', {
+                brand: this.brand,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return {
+                success: false,
+                error: {
+                    code: 'REQUEST_FAILED',
+                    message: error instanceof Error ? error.message : 'Request failed',
+                    details: error,
+                },
+            };
+        }
+    }
+    parseBody(raw) {
+        try {
+            return raw ? JSON.parse(raw) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    notConfiguredError() {
+        return {
+            success: false,
+            error: {
+                code: 'NOT_CONFIGURED',
+                message: 'Netcore email service is not configured',
+            },
+        };
+    }
+    normalizeError(status, body) {
+        const errorMap = {
+            400: 'BAD_REQUEST',
+            401: 'UNAUTHORIZED',
+            403: 'FORBIDDEN',
+            404: 'NOT_FOUND',
+            429: 'RATE_LIMITED',
+            500: 'INTERNAL_ERROR',
+            502: 'BAD_GATEWAY',
+            503: 'SERVICE_UNAVAILABLE',
+        };
+        return {
+            code: errorMap[status] ?? 'UNKNOWN_ERROR',
+            message: body || `HTTP ${status}`,
+        };
+    }
+};
+exports.NetcoreEmailService = NetcoreEmailService;
+exports.NetcoreEmailService = NetcoreEmailService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], NetcoreEmailService);
+//# sourceMappingURL=netcore-email.service.js.map

package/dist/integrations/engagement/netcore-email.service.js.map

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

package/dist/integrations/engagement/netcore-email.types.d.ts

@@ -0,0 +1,74 @@
+import { IntegrationResponse } from '../integration.types';
+/**
+ * Netcore (ex-Pepipost) Email API types.
+ *
+ * @see https://cpaasdocs.netcore.ai/docs/pepipost-api/c2d895762f832-send-an-email
+ */
+export interface NetcoreConfig {
+    /** API host (default: https://emailapi.netcorecloud.net). EU accounts use https://apieu.netcorecloud.net */
+    baseUrl?: string;
+    /** Email API key, from Settings -> Integrations in the Netcore account */
+    apiKey: string;
+    /** Default sender. The domain must be active in the Netcore account or the send is rejected. */
+    fromEmail: string;
+    fromName?: string;
+    replyTo?: string;
+    /** Request timeout in milliseconds (default: 10000) */
+    timeout?: number;
+}
+export interface NetcoreRecipient {
+    email: string;
+    name?: string;
+}
+export interface NetcorePersonalization {
+    to: NetcoreRecipient[];
+    cc?: NetcoreRecipient[];
+    bcc?: NetcoreRecipient[];
+    /**
+     * Values substituted into `[%KEY%]` placeholders in the subject and template.
+     * Flat key/value only — Netcore cannot iterate, so a repeating block (order
+     * line items) must be pre-rendered into a single attribute by the caller.
+     */
+    attributes?: Record<string, string>;
+}
+export interface NetcoreContent {
+    type: 'html' | 'amp';
+    value: string;
+}
+export interface NetcoreSettings {
+    open_track?: boolean;
+    click_track?: boolean;
+    unsubscribe_track?: boolean;
+    ip_pool?: string;
+}
+/**
+ * One send request.
+ *
+ * Supply `templateId` to use a Netcore-hosted template, or `content` to send
+ * HTML inline. The API documents `content` as required, so a caller passing
+ * only `templateId` should verify its account accepts that before relying on it.
+ */
+export interface NetcoreSendRequest {
+    subject: string;
+    personalizations: NetcorePersonalization[];
+    templateId?: number;
+    content?: NetcoreContent[];
+    /** Groups sends for per-segment delivery reporting in the Netcore dashboard. */
+    tags?: string[];
+    /** Overrides the configured default sender. */
+    from?: NetcoreRecipient;
+    replyTo?: string;
+    settings?: NetcoreSettings;
+    /** Unix epoch seconds; Netcore rejects times beyond 72 hours out. */
+    schedule?: number;
+}
+export interface NetcoreSendResult {
+    messageId: string;
+}
+/** Contract for the email channel. WhatsApp and SMS have their own shapes. */
+export interface IEmailService {
+    configure(brand: string, config: NetcoreConfig): void;
+    isConfigured(): boolean;
+    send(request: NetcoreSendRequest): Promise<IntegrationResponse<NetcoreSendResult>>;
+}
+//# sourceMappingURL=netcore-email.types.d.ts.map

package/dist/integrations/engagement/netcore-email.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"netcore-email.types.d.ts","sourceRoot":"","sources":["../../../src/integrations/engagement/netcore-email.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,4GAA4G;IAC5G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,gGAAgG;IAChG,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,gBAAgB,EAAE,CAAC;IACvB,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,OAAO,CAAC;IACxB,IAAI,CACF,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC;CACpD"}

package/dist/integrations/engagement/netcore-email.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=netcore-email.types.js.map

package/dist/integrations/engagement/netcore-email.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"netcore-email.types.js","sourceRoot":"","sources":["../../../src/integrations/engagement/netcore-email.types.ts"],"names":[],"mappings":""}

package/dist/integrations/index.d.ts

@@ -8,6 +8,7 @@ export * from './search';
 export * from './reviews';
 export * from './swish';
 export * from './storage';
+export * from './engagement';
 export * from './integration.factory';
 export * from './integrations.module';
 //# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,YAAY,CAAC;AAG3B,cAAc,OAAO,CAAC;AAGtB,cAAc,WAAW,CAAC;AAG1B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,YAAY,CAAC;AAG3B,cAAc,OAAO,CAAC;AAGtB,cAAc,WAAW,CAAC;AAG1B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/integrations/index.js

@@ -20,6 +20,8 @@ tslib_1.__exportStar(require("./reviews"), exports);
 tslib_1.__exportStar(require("./swish"), exports);
 // Storage integrations (Azure Blob)
 tslib_1.__exportStar(require("./storage"), exports);
+// Engagement integrations (Netcore email)
+tslib_1.__exportStar(require("./engagement"), exports);
 // Integration factory and module
 tslib_1.__exportStar(require("./integration.factory"), exports);
 tslib_1.__exportStar(require("./integrations.module"), exports);

package/dist/integrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":";;;AAAA,sCAAsC;AACtC,8DAAoC;AACpC,qEAA2C;AAE3C,kCAAkC;AAClC,qDAA2B;AAE3B,2BAA2B;AAC3B,gDAAsB;AAEtB,mCAAmC;AACnC,oDAA0B;AAE1B,oBAAoB;AACpB,0DAAgC;AAEhC,8BAA8B;AAC9B,mDAAyB;AAEzB,kCAAkC;AAClC,oDAA0B;AAE1B,gCAAgC;AAChC,kDAAwB;AAExB,oCAAoC;AACpC,oDAA0B;AAE1B,iCAAiC;AACjC,gEAAsC;AACtC,gEAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":";;;AAAA,sCAAsC;AACtC,8DAAoC;AACpC,qEAA2C;AAE3C,kCAAkC;AAClC,qDAA2B;AAE3B,2BAA2B;AAC3B,gDAAsB;AAEtB,mCAAmC;AACnC,oDAA0B;AAE1B,oBAAoB;AACpB,0DAAgC;AAEhC,8BAA8B;AAC9B,mDAAyB;AAEzB,kCAAkC;AAClC,oDAA0B;AAE1B,gCAAgC;AAChC,kDAAwB;AAExB,oCAAoC;AACpC,oDAA0B;AAE1B,0CAA0C;AAC1C,uDAA6B;AAE7B,iCAAiC;AACjC,gEAAsC;AACtC,gEAAsC"}

package/dist/integrations/integrations.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.module.d.ts","sourceRoot":"","sources":["../../src/integrations/integrations.module.ts"],"names":[],"mappings":"AA0BA,qBA0Ca,kBAAkB;CAAG"}
+{"version":3,"file":"integrations.module.d.ts","sourceRoot":"","sources":["../../src/integrations/integrations.module.ts"],"names":[],"mappings":"AA4BA,qBA6Ca,kBAAkB;CAAG"}

package/dist/integrations/integrations.module.js

@@ -24,6 +24,8 @@ const swish_service_1 = require("./swish/swish.service");
 // Storage
 const azure_blob_service_1 = require("./storage/azure-blob.service");
 const shopify_files_service_1 = require("./storage/shopify-files.service");
+// Engagement
+const netcore_email_service_1 = require("./engagement/netcore-email.service");
 // CacheModule and ConfigModule are @Global() so no import needed
 let IntegrationsModule = class IntegrationsModule {
 };
@@ -53,6 +55,8 @@ exports.IntegrationsModule = IntegrationsModule = tslib_1.__decorate([
             // Storage
             azure_blob_service_1.AzureBlobService,
             shopify_files_service_1.ShopifyFilesService,
+            // Engagement
+            netcore_email_service_1.NetcoreEmailService,
         ],
         exports: [
             integration_factory_1.IntegrationFactory,
@@ -69,6 +73,7 @@ exports.IntegrationsModule = IntegrationsModule = tslib_1.__decorate([
             swish_service_1.SwishService,
             azure_blob_service_1.AzureBlobService,
             shopify_files_service_1.ShopifyFilesService,
+            netcore_email_service_1.NetcoreEmailService,
         ],
     })
 ], IntegrationsModule);

package/dist/integrations/integrations.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.module.js","sourceRoot":"","sources":["../../src/integrations/integrations.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAwC;AACxC,+DAA2D;AAC3D,yEAAoE;AAEpE,8BAA8B;AAC9B,gEAAoE;AACpE,4EAAuE;AACvE,kFAA6E;AAC7E,iEAA4D;AAC5D,uDAAmD;AACnD,oBAAoB;AACpB,6EAAwE;AACxE,iFAA4E;AAC5E,SAAS;AACT,0DAAsD;AACtD,8EAAyE;AACzE,UAAU;AACV,+DAA2D;AAC3D,WAAW;AACX,yDAAqD;AACrD,UAAU;AACV,qEAAgE;AAChE,2EAAsE;AAEtE,iEAAiE;AA4C1D,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAAG,CAAA;AAArB,gDAAkB;6BAAlB,kBAAkB;IA1C9B,IAAA,eAAM,EAAC;QACN,SAAS,EAAE;YACT,wCAAkB;YAClB,iDAAsB;YACtB,WAAW;YACX,wCAAsB;YACtB,2CAAmB;YACnB,iDAAsB;YACtB,MAAM;YACN,qCAAgB;YAChB,4BAAY;YACZ,UAAU;YACV,6CAAoB;YACpB,iDAAsB;YACtB,SAAS;YACT,4BAAY;YACZ,+CAAqB;YACrB,UAAU;YACV,gCAAc;YACd,WAAW;YACX,4BAAY;YACZ,UAAU;YACV,qCAAgB;YAChB,2CAAmB;SACpB;QACD,OAAO,EAAE;YACP,wCAAkB;YAClB,gEAAgE;YAChE,wCAAsB;YACtB,2CAAmB;YACnB,iDAAsB;YACtB,4BAAY;YACZ,6CAAoB;YACpB,iDAAsB;YACtB,4BAAY;YACZ,+CAAqB;YACrB,gCAAc;YACd,4BAAY;YACZ,qCAAgB;YAChB,2CAAmB;SACpB;KACF,CAAC;GACW,kBAAkB,CAAG"}
+{"version":3,"file":"integrations.module.js","sourceRoot":"","sources":["../../src/integrations/integrations.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAwC;AACxC,+DAA2D;AAC3D,yEAAoE;AAEpE,8BAA8B;AAC9B,gEAAoE;AACpE,4EAAuE;AACvE,kFAA6E;AAC7E,iEAA4D;AAC5D,uDAAmD;AACnD,oBAAoB;AACpB,6EAAwE;AACxE,iFAA4E;AAC5E,SAAS;AACT,0DAAsD;AACtD,8EAAyE;AACzE,UAAU;AACV,+DAA2D;AAC3D,WAAW;AACX,yDAAqD;AACrD,UAAU;AACV,qEAAgE;AAChE,2EAAsE;AACtE,aAAa;AACb,8EAAyE;AAEzE,iEAAiE;AA+C1D,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAAG,CAAA;AAArB,gDAAkB;6BAAlB,kBAAkB;IA7C9B,IAAA,eAAM,EAAC;QACN,SAAS,EAAE;YACT,wCAAkB;YAClB,iDAAsB;YACtB,WAAW;YACX,wCAAsB;YACtB,2CAAmB;YACnB,iDAAsB;YACtB,MAAM;YACN,qCAAgB;YAChB,4BAAY;YACZ,UAAU;YACV,6CAAoB;YACpB,iDAAsB;YACtB,SAAS;YACT,4BAAY;YACZ,+CAAqB;YACrB,UAAU;YACV,gCAAc;YACd,WAAW;YACX,4BAAY;YACZ,UAAU;YACV,qCAAgB;YAChB,2CAAmB;YACnB,aAAa;YACb,2CAAmB;SACpB;QACD,OAAO,EAAE;YACP,wCAAkB;YAClB,gEAAgE;YAChE,wCAAsB;YACtB,2CAAmB;YACnB,iDAAsB;YACtB,4BAAY;YACZ,6CAAoB;YACpB,iDAAsB;YACtB,4BAAY;YACZ,+CAAqB;YACrB,gCAAc;YACd,4BAAY;YACZ,qCAAgB;YAChB,2CAAmB;YACnB,2CAAmB;SACpB;KACF,CAAC;GACW,kBAAkB,CAAG"}

package/dist/notifications/index.d.ts

@@ -0,0 +1,6 @@
+export * from './order-notification.types';
+export * from './order.source';
+export * from './order-email.mapper';
+export * from './order-email.service';
+export * from './notifications.module';
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC"}

package/dist/notifications/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./order-notification.types"), exports);
+tslib_1.__exportStar(require("./order.source"), exports);
+tslib_1.__exportStar(require("./order-email.mapper"), exports);
+tslib_1.__exportStar(require("./order-email.service"), exports);
+tslib_1.__exportStar(require("./notifications.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":";;;AAAA,qEAA2C;AAC3C,yDAA+B;AAC/B,+DAAqC;AACrC,gEAAsC;AACtC,iEAAuC"}

package/dist/notifications/notifications.module.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Order notifications, shared by every brand.
+ *
+ * `OrderSource` is channel-neutral, so WhatsApp and SMS senders added later
+ * consume the same snapshot rather than re-querying Shopify.
+ */
+export declare class NotificationsModule {
+}
+//# sourceMappingURL=notifications.module.d.ts.map

package/dist/notifications/notifications.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.module.d.ts","sourceRoot":"","sources":["../../src/notifications/notifications.module.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,qBAKa,mBAAmB;CAAG"}

package/dist/notifications/notifications.module.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationsModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const integrations_module_1 = require("../integrations/integrations.module");
+const order_email_service_1 = require("./order-email.service");
+const order_source_1 = require("./order.source");
+/**
+ * Order notifications, shared by every brand.
+ *
+ * `OrderSource` is channel-neutral, so WhatsApp and SMS senders added later
+ * consume the same snapshot rather than re-querying Shopify.
+ */
+let NotificationsModule = class NotificationsModule {
+};
+exports.NotificationsModule = NotificationsModule;
+exports.NotificationsModule = NotificationsModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        imports: [integrations_module_1.IntegrationsModule],
+        providers: [order_source_1.OrderSource, order_email_service_1.OrderEmailService],
+        exports: [order_source_1.OrderSource, order_email_service_1.OrderEmailService],
+    })
+], NotificationsModule);
+//# sourceMappingURL=notifications.module.js.map

package/dist/notifications/notifications.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.module.js","sourceRoot":"","sources":["../../src/notifications/notifications.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAwC;AACxC,6EAAyE;AACzE,+DAA0D;AAC1D,iDAA6C;AAE7C;;;;;GAKG;AAMI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;CAAG,CAAA;AAAtB,kDAAmB;8BAAnB,mBAAmB;IAL/B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,wCAAkB,CAAC;QAC7B,SAAS,EAAE,CAAC,0BAAW,EAAE,uCAAiB,CAAC;QAC3C,OAAO,EAAE,CAAC,0BAAW,EAAE,uCAAiB,CAAC;KAC1C,CAAC;GACW,mBAAmB,CAAG"}

package/dist/notifications/order-email.mapper.d.ts

@@ -0,0 +1,15 @@
+import { OrderSnapshot } from './order.source';
+import { OrderEmailBranding, OrderEvent } from './order-notification.types';
+/** Money as the templates show it, e.g. `Rs. 2,245.00`. */
+export declare const formatMoney: (amount: number, currency: string) => string;
+export declare const escapeHtml: (value: string) => string;
+export declare const renderItemsHtml: (items: OrderSnapshot["items"], currency: string, branding: OrderEmailBranding) => string;
+export declare const renderAddressHtml: (lines: string[]) => string;
+/**
+ * Build the merge attributes for one email.
+ *
+ * `trackingUrl` overrides the order's own tracking link, so a shipped email
+ * points at the parcel that triggered it rather than the first fulfillment.
+ */
+export declare const buildAttributes: (event: OrderEvent, order: OrderSnapshot, branding: OrderEmailBranding, trackingUrl?: string) => Record<string, string>;
+//# sourceMappingURL=order-email.mapper.d.ts.map

package/dist/notifications/order-email.mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-email.mapper.d.ts","sourceRoot":"","sources":["../../src/notifications/order-email.mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA+B5E,2DAA2D;AAC3D,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,MAG9D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAKf,CAAC;AAsD7B,eAAO,MAAM,eAAe,GAC1B,OAAO,aAAa,CAAC,OAAO,CAAC,EAC7B,UAAU,MAAM,EAChB,UAAU,kBAAkB,KAC3B,MAKE,CAAC;AAEN,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,KAAG,MACd,CAAC;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,UAAU,EACjB,OAAO,aAAa,EACpB,UAAU,kBAAkB,EAC5B,cAAc,MAAM,KACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAwCvB,CAAC"}

package/dist/notifications/order-email.mapper.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAttributes = exports.renderAddressHtml = exports.renderItemsHtml = exports.escapeHtml = exports.formatMoney = void 0;
+/**
+ * Turns an order into the flat `[%KEY%]` values Netcore substitutes.
+ *
+ * Netcore merge cannot iterate, so the line items and the address blocks are
+ * rendered to HTML here and passed as single attributes. That makes this the
+ * one part of the email the Netcore panel cannot restyle — its fonts, colours
+ * and labels come from `integrations.engagement.options` in the brand config,
+ * so they at least live beside the rest of the email settings rather than here.
+ */
+/** Symbol shown for a currency; anything unmapped falls back to its ISO code. */
+const CURRENCY_PREFIX = { INR: 'Rs.' };
+const formatters = new Map();
+/** Indian grouping (1,23,456.00) for INR; Western grouping elsewhere. */
+const numberFormat = (currency) => {
+    const locale = currency === 'INR' ? 'en-IN' : 'en-US';
+    let formatter = formatters.get(locale);
+    if (!formatter) {
+        formatter = new Intl.NumberFormat(locale, {
+            minimumFractionDigits: 2,
+            maximumFractionDigits: 2,
+        });
+        formatters.set(locale, formatter);
+    }
+    return formatter;
+};
+/** Money as the templates show it, e.g. `Rs. 2,245.00`. */
+const formatMoney = (amount, currency) => {
+    const value = Number.isFinite(amount) ? amount : 0;
+    return `${CURRENCY_PREFIX[currency] ?? currency} ${numberFormat(currency).format(value)}`;
+};
+exports.formatMoney = formatMoney;
+const escapeHtml = (value) => value
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+exports.escapeHtml = escapeHtml;
+/** Gateway names arrive lower-cased; short ones are acronyms (UPI, COD, EMI). */
+const prettyGateway = (name) => {
+    const trimmed = name.trim();
+    if (!trimmed)
+        return '';
+    return trimmed.length <= 4
+        ? trimmed.toUpperCase()
+        : trimmed.charAt(0).toUpperCase() + trimmed.slice(1);
+};
+const specRow = (label, value, { fontFamily, textColor }) => {
+    const cell = `font-family:${fontFamily}; font-size:15px; line-height:26px; color:${textColor};`;
+    return `<tr>
+      <td width="110" style="${cell}">${(0, exports.escapeHtml)(label)}</td>
+      <td width="16" style="${cell}">:</td>
+      <td style="${cell}">${(0, exports.escapeHtml)(value)}</td>
+    </tr>`;
+};
+/** One item block: bold title with its price, then the spec rows beneath. */
+const renderItem = (item, currency, branding) => {
+    const { fontFamily, textColor, labels } = branding;
+    const heading = `font-family:${fontFamily}; font-size:17px; line-height:24px; font-weight:bold; color:${textColor};`;
+    const specs = [
+        item.size ? specRow(labels.size, item.size, branding) : '',
+        item.colour ? specRow(labels.colour, item.colour, branding) : '',
+        specRow(labels.quantity, String(item.quantity), branding),
+        item.itemNumber ? specRow(labels.itemNumber, item.itemNumber, branding) : '',
+    ]
+        .filter(Boolean)
+        .join('\n    ');
+    return `<table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%">
+    <tr>
+      <td style="${heading} padding-right:12px;">${(0, exports.escapeHtml)(item.title)}</td>
+      <td align="right" valign="top" style="${heading} white-space:nowrap;">${(0, exports.formatMoney)(item.amount, currency)}</td>
+    </tr>
+  </table>
+  <div style="height:16px; line-height:16px; font-size:0;">&nbsp;</div>
+  <table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%">
+    ${specs}
+  </table>`;
+};
+const renderItemsHtml = (items, currency, branding) => items
+    .map((item) => renderItem(item, currency, branding))
+    .join('\n  <div style="height:22px; line-height:22px; font-size:0;">&nbsp;</div>\n  ');
+exports.renderItemsHtml = renderItemsHtml;
+const renderAddressHtml = (lines) => lines.map(exports.escapeHtml).join('<br />');
+exports.renderAddressHtml = renderAddressHtml;
+/**
+ * Build the merge attributes for one email.
+ *
+ * `trackingUrl` overrides the order's own tracking link, so a shipped email
+ * points at the parcel that triggered it rather than the first fulfillment.
+ */
+const buildAttributes = (event, order, branding, trackingUrl) => {
+    const money = (amount) => (0, exports.formatMoney)(amount, order.currency);
+    const attributes = {
+        LOGO_URL: branding.logoUrl,
+        CUSTOMER_NAME: order.customerName || 'there',
+        ORDER_NUMBER: order.orderNumber,
+        ITEMS_HTML: (0, exports.renderItemsHtml)(order.items, order.currency, branding),
+        // Whole row, or nothing — Netcore has no conditionals, so an empty string
+        // is the only way to drop the line on orders without a discount. Carries no
+        // styling: the totals table sets font and colour, so this inherits them.
+        DISCOUNT_ROW: order.totalDiscount > 0
+            ? `<tr><td align="left">${(0, exports.escapeHtml)(branding.discountLabel)}</td>` +
+                `<td align="right" style="font-weight:bold;">- ${money(order.totalDiscount)}</td></tr>`
+            : '',
+        GST_AMOUNT: money(order.totalTax),
+        SHIPPING_AMOUNT: money(order.totalShipping),
+        TOTAL_AMOUNT: money(order.totalPrice),
+        BILLING_ADDRESS_HTML: (0, exports.renderAddressHtml)(order.billingAddress),
+        SHIPPING_ADDRESS_HTML: (0, exports.renderAddressHtml)(order.shippingAddress),
+        PAYMENT_METHOD: order.paymentMethod
+            .split(',')
+            .map(prettyGateway)
+            .filter(Boolean)
+            .join(', '),
+        SHIPPING_METHOD: order.shippingMethod,
+        SUPPORT_PHONE: branding.supportPhone,
+        SUPPORT_EMAIL: branding.supportEmail,
+    };
+    if (event === 'order_shipped') {
+        // A carrier Shopify doesn't recognise yields a tracking number with no URL,
+        // which would render the button pointing nowhere. Fall back to the order
+        // status page so it always goes somewhere useful.
+        attributes.TRACKING_URL =
+            trackingUrl ?? order.trackingUrl ?? order.orderStatusUrl ?? '';
+    }
+    return attributes;
+};
+exports.buildAttributes = buildAttributes;
+//# sourceMappingURL=order-email.mapper.js.map

package/dist/notifications/order-email.mapper.js.map

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

package/dist/notifications/order-email.service.d.ts

@@ -0,0 +1,30 @@
+import { ConfigService } from '../config/config.service';
+import { NetcoreEmailService } from '../integrations/engagement/netcore-email.service';
+import { OrderSource } from './order.source';
+import { OrderEmailResult, OrderEvent } from './order-notification.types';
+/**
+ * Sends one transactional order email for any brand.
+ *
+ * Everything brand-specific arrives through `integrations.engagement` in the
+ * brand config: sender, support details, per-event template ids and subjects.
+ * The email body is the provider-hosted template, so design and copy changes
+ * are made in the provider panel without a deploy — this only supplies the
+ * merge values.
+ */
+export declare class OrderEmailService {
+    private readonly configService;
+    private readonly netcore;
+    private readonly source;
+    constructor(configService: ConfigService, netcore: NetcoreEmailService, source: OrderSource);
+    send(brand: string, event: OrderEvent, orderId: string | number, trackingUrl?: string): Promise<OrderEmailResult>;
+    /**
+     * Presentation values come from the brand config only — no defaults live here,
+     * because a fallback would be one brand's colours quietly applied to another.
+     * A missing key renders visibly unstyled and is logged, which is preferable to
+     * an email that looks deliberate but belongs to a different brand.
+     */
+    private buildBranding;
+    /** Returns the engagement options, or null when the brand has no email setup. */
+    private configureProvider;
+}
+//# sourceMappingURL=order-email.service.d.ts.map

package/dist/notifications/order-email.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-email.service.d.ts","sourceRoot":"","sources":["../../src/notifications/order-email.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAEL,gBAAgB,EAChB,UAAU,EAGX,MAAM,4BAA4B,CAAC;AAmBpC;;;;;;;;GAQG;AACH,qBACa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,WAAW;IAGhC,IAAI,CACR,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAgE5B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAgCrB,iFAAiF;IACjF,OAAO,CAAC,iBAAiB;CA8B1B"}

package/dist/notifications/order-email.service.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderEmailService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../common/logger");
+const config_service_1 = require("../config/config.service");
+const netcore_email_service_1 = require("../integrations/engagement/netcore-email.service");
+const order_email_mapper_1 = require("./order-email.mapper");
+const order_source_1 = require("./order.source");
+/**
+ * Sends one transactional order email for any brand.
+ *
+ * Everything brand-specific arrives through `integrations.engagement` in the
+ * brand config: sender, support details, per-event template ids and subjects.
+ * The email body is the provider-hosted template, so design and copy changes
+ * are made in the provider panel without a deploy — this only supplies the
+ * merge values.
+ */
+let OrderEmailService = class OrderEmailService {
+    configService;
+    netcore;
+    source;
+    constructor(configService, netcore, source) {
+        this.configService = configService;
+        this.netcore = netcore;
+        this.source = source;
+    }
+    async send(brand, event, orderId, trackingUrl) {
+        const options = this.configureProvider(brand);
+        if (!options)
+            return 'skipped';
+        const eventConfig = options.events?.[event];
+        if (!eventConfig?.templateId) {
+            logger_1.logger.warn('No template configured for order event - skipping email', {
+                brand,
+                event,
+            });
+            return 'skipped';
+        }
+        const order = await this.source.load(brand, orderId);
+        if (!order)
+            return 'failed';
+        if (!order.email) {
+            logger_1.logger.warn('Order has no email address - skipping email', {
+                brand,
+                event,
+                orderId,
+            });
+            return 'skipped';
+        }
+        const branding = this.buildBranding(brand, options);
+        const result = await this.netcore.send({
+            subject: eventConfig.subject,
+            templateId: eventConfig.templateId,
+            // The provider-hosted template is what renders. `content` is only here
+            // because the API rejects a send without it, and anything sent in it is
+            // prepended to the template — hence an invisible comment.
+            content: [{ type: 'html', value: '<!-- -->' }],
+            tags: [eventConfig.tag ?? event],
+            personalizations: [
+                {
+                    to: [{ email: order.email, name: order.customerName || undefined }],
+                    attributes: (0, order_email_mapper_1.buildAttributes)(event, order, branding, trackingUrl),
+                },
+            ],
+        });
+        if (!result.success) {
+            logger_1.logger.error('Failed to send order email', {
+                brand,
+                event,
+                orderId,
+                errorCode: result.error?.code,
+                errorMessage: result.error?.message,
+            });
+            // A rejected payload will be rejected identically next time.
+            return result.error?.code === 'BAD_REQUEST' ? 'skipped' : 'failed';
+        }
+        logger_1.logger.info('Order email sent', {
+            brand,
+            event,
+            orderId,
+            messageId: result.data?.messageId,
+        });
+        return 'sent';
+    }
+    /**
+     * Presentation values come from the brand config only — no defaults live here,
+     * because a fallback would be one brand's colours quietly applied to another.
+     * A missing key renders visibly unstyled and is logged, which is preferable to
+     * an email that looks deliberate but belongs to a different brand.
+     */
+    buildBranding(brand, options) {
+        const missing = ['fontFamily', 'textColor', 'discountLabel', 'itemLabels'].filter((key) => !options[key]);
+        if (missing.length) {
+            logger_1.logger.warn('Brand engagement config is missing presentation values', {
+                brand,
+                missing,
+            });
+        }
+        const labels = options.itemLabels;
+        return {
+            logoUrl: options.logoUrl ?? '',
+            supportPhone: options.supportPhone ?? '',
+            supportEmail: options.supportEmail ?? '',
+            fontFamily: options.fontFamily ?? '',
+            textColor: options.textColor ?? '',
+            discountLabel: options.discountLabel ?? '',
+            labels: {
+                size: labels?.size ?? '',
+                colour: labels?.colour ?? '',
+                quantity: labels?.quantity ?? '',
+                itemNumber: labels?.itemNumber ?? '',
+            },
+        };
+    }
+    /** Returns the engagement options, or null when the brand has no email setup. */
+    configureProvider(brand) {
+        const engagement = this.configService.getBrand(brand)?.integrations
+            ?.engagement;
+        if (!engagement?.apiKey) {
+            logger_1.logger.warn('Engagement integration not configured - skipping email', {
+                brand,
+            });
+            return null;
+        }
+        const options = (engagement.options ?? {});
+        if (!options.fromEmail) {
+            logger_1.logger.warn('Engagement integration missing fromEmail', { brand });
+            return null;
+        }
+        if (!this.netcore.isConfigured()) {
+            this.netcore.configure(brand, {
+                baseUrl: engagement.baseUrl,
+                apiKey: engagement.apiKey,
+                fromEmail: options.fromEmail,
+                fromName: options.fromName,
+                replyTo: options.replyTo,
+            });
+        }
+        return options;
+    }
+};
+exports.OrderEmailService = OrderEmailService;
+exports.OrderEmailService = OrderEmailService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [config_service_1.ConfigService,
+        netcore_email_service_1.NetcoreEmailService,
+        order_source_1.OrderSource])
+], OrderEmailService);
+//# sourceMappingURL=order-email.service.js.map

package/dist/notifications/order-email.service.js.map

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

package/dist/notifications/order-notification.types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Order notification types, shared by every brand and channel.
+ *
+ * The event list is channel-neutral: email, WhatsApp and SMS all react to the
+ * same order lifecycle. Only the per-channel send settings differ.
+ */
+export declare const ORDER_EVENTS: readonly ["order_confirmed", "order_shipped", "order_delivered", "order_cancelled", "return_initiated", "return_complete", "refund_initiated", "refund_complete"];
+export type OrderEvent = (typeof ORDER_EVENTS)[number];
+/**
+ * Per-event email settings, read from the brand's
+ * `integrations.engagement.options.events` config.
+ */
+export interface OrderEventEmailConfig {
+    /** Id of the provider-hosted template. */
+    templateId: number;
+    /** Subject line; may carry `[%KEY%]` merge placeholders. */
+    subject: string;
+    /** Provider tag, for per-event delivery reporting. Defaults to the event name. */
+    tag?: string;
+}
+/** Row labels in the line-item block. */
+export interface OrderItemLabels {
+    size: string;
+    colour: string;
+    quantity: string;
+    itemNumber: string;
+}
+/** Brand presentation values for the parts rendered in code. */
+export interface OrderEmailBranding {
+    logoUrl: string;
+    supportPhone: string;
+    supportEmail: string;
+    /** Must match the provider-hosted template, or the item block looks pasted in. */
+    fontFamily: string;
+    textColor: string;
+    labels: OrderItemLabels;
+    discountLabel: string;
+}
+/** `skipped` means nothing a retry can fix; `failed` is transient. */
+export type OrderEmailResult = 'sent' | 'skipped' | 'failed';
+//# sourceMappingURL=order-notification.types.d.ts.map

package/dist/notifications/order-notification.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-notification.types.d.ts","sourceRoot":"","sources":["../../src/notifications/order-notification.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,YAAY,mKASf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/dist/notifications/order-notification.types.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Order notification types, shared by every brand and channel.
+ *
+ * The event list is channel-neutral: email, WhatsApp and SMS all react to the
+ * same order lifecycle. Only the per-channel send settings differ.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORDER_EVENTS = void 0;
+exports.ORDER_EVENTS = [
+    'order_confirmed',
+    'order_shipped',
+    'order_delivered',
+    'order_cancelled',
+    'return_initiated',
+    'return_complete',
+    'refund_initiated',
+    'refund_complete',
+];
+//# sourceMappingURL=order-notification.types.js.map

package/dist/notifications/order-notification.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-notification.types.js","sourceRoot":"","sources":["../../src/notifications/order-notification.types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,YAAY,GAAG;IAC1B,iBAAiB;IACjB,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;CACT,CAAC"}

package/dist/notifications/order.source.d.ts

@@ -0,0 +1,47 @@
+import { ShopifyAdminService } from '../integrations/commerce/shopify-admin.service';
+/** The order, flattened to what a notification needs. Formatting is the caller's job. */
+export interface OrderSnapshot {
+    orderNumber: string;
+    email: string | null;
+    /**
+     * Raw Shopify phone, unnormalised — WhatsApp needs E.164 and Indian SMS/DLT
+     * may want another form, so each channel converts rather than this guessing.
+     */
+    phone: string | null;
+    /** ISO code from the order, e.g. INR. Drives the money prefix. */
+    currency: string;
+    customerName: string;
+    totalPrice: number;
+    totalTax: number;
+    /** Order-level discount. Line items keep their list price, so this is the only place it shows. */
+    totalDiscount: number;
+    totalShipping: number;
+    billingAddress: string[];
+    shippingAddress: string[];
+    paymentMethod: string;
+    shippingMethod: string;
+    trackingUrl: string | null;
+    /** Shopify's order-status page — the fallback when a parcel has no tracking link. */
+    orderStatusUrl: string | null;
+    items: Array<{
+        title: string;
+        quantity: number;
+        amount: number;
+        size: string | null;
+        colour: string | null;
+        itemNumber: string | null;
+    }>;
+}
+export declare class OrderSource {
+    private readonly shopifyAdminService;
+    constructor(shopifyAdminService: ShopifyAdminService);
+    /**
+     * Fetch one order. `orderId` may be a numeric Shopify id or a full GID.
+     * Returns null when the order is gone or the query errored — the caller
+     * decides whether that is worth retrying.
+     */
+    load(brand: string, orderId: string | number): Promise<OrderSnapshot | null>;
+    private delay;
+    private toSnapshot;
+}
+//# sourceMappingURL=order.source.d.ts.map

package/dist/notifications/order.source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.source.d.ts","sourceRoot":"","sources":["../../src/notifications/order.source.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAkErF,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qFAAqF;IACrF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC,CAAC;CACJ;AAwED,qBACa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBAAnB,mBAAmB,EAAE,mBAAmB;IAErE;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA4ClF,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,UAAU;CA0CnB"}

package/dist/notifications/order.source.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderSource = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const logger_1 = require("../common/logger");
+const shopify_admin_service_1 = require("../integrations/commerce/shopify-admin.service");
+const ORDER_QUERY = `
+  query OrderEmailSnapshot($id: ID!) {
+    order(id: $id) {
+      id
+      name
+      email
+      phone
+      statusPageUrl
+      totalPriceSet { shopMoney { amount currencyCode } }
+      totalTaxSet { shopMoney { amount } }
+      totalDiscountsSet { shopMoney { amount } }
+      totalShippingPriceSet { shopMoney { amount } }
+      customer { firstName lastName email phone }
+      billingAddress { address1 address2 city province zip country }
+      shippingAddress { address1 address2 city province zip country phone }
+      shippingLine { title }
+      paymentGatewayNames
+      lineItems(first: 50) {
+        edges {
+          node {
+            title
+            quantity
+            sku
+            variantTitle
+            originalTotalSet { shopMoney { amount } }
+            variant {
+              barcode
+              sku
+              selectedOptions { name value }
+            }
+          }
+        }
+      }
+      fulfillments(first: 10) {
+        trackingInfo { url number }
+      }
+    }
+  }
+`;
+const toNumber = (value) => {
+    const n = parseFloat(value ?? '0');
+    return Number.isFinite(n) ? n : 0;
+};
+const formatAddress = (address) => {
+    if (!address)
+        return [];
+    const cityLine = [address.city, address.zip].filter(Boolean).join(' ');
+    return [address.address1, address.address2, address.province, cityLine]
+        .map((part) => (part ?? '').trim())
+        .filter((part) => part.length > 0);
+};
+/** Reads a variant option by name, e.g. "Size" / "Colour". */
+const option = (node, ...names) => {
+    const wanted = names.map((n) => n.toLowerCase());
+    const match = node.variant?.selectedOptions?.find((o) => wanted.includes((o.name ?? '').toLowerCase()));
+    return match?.value?.trim() || null;
+};
+/**
+ * Backoff before re-reading an order that came back empty. `orders/create` can
+ * arrive before the Admin API will return the order, and an abandoned message
+ * is redelivered with no backoff — so without this the whole delivery budget
+ * burns in seconds. Total wait stays well inside the queue's lock duration.
+ */
+const NOT_READABLE_RETRY_MS = [2000, 5000, 10000];
+let OrderSource = class OrderSource {
+    shopifyAdminService;
+    constructor(shopifyAdminService) {
+        this.shopifyAdminService = shopifyAdminService;
+    }
+    /**
+     * Fetch one order. `orderId` may be a numeric Shopify id or a full GID.
+     * Returns null when the order is gone or the query errored — the caller
+     * decides whether that is worth retrying.
+     */
+    async load(brand, orderId) {
+        const gid = String(orderId).startsWith('gid://')
+            ? String(orderId)
+            : `gid://shopify/Order/${orderId}`;
+        for (let attempt = 0;; attempt++) {
+            const response = await this.shopifyAdminService.adminGraphQL(brand, ORDER_QUERY, { id: gid });
+            if (response.errors?.length) {
+                logger_1.logger.error('Order email snapshot query failed', {
+                    brand,
+                    orderId: gid,
+                    error: response.errors[0]?.message,
+                });
+                return null;
+            }
+            const order = response.data?.order;
+            if (order) {
+                return this.toSnapshot(order);
+            }
+            const wait = NOT_READABLE_RETRY_MS[attempt];
+            if (wait === undefined) {
+                logger_1.logger.warn('Order email snapshot not found', {
+                    brand,
+                    orderId: gid,
+                    attempts: attempt + 1,
+                });
+                return null;
+            }
+            logger_1.logger.info('Order not readable yet - retrying', {
+                brand,
+                orderId: gid,
+                attempt: attempt + 1,
+                waitMs: wait,
+            });
+            await this.delay(wait);
+        }
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    toSnapshot(order) {
+        const firstName = order.customer?.firstName?.trim() ?? '';
+        const lastName = order.customer?.lastName?.trim() ?? '';
+        const trackingUrl = order.fulfillments
+            ?.flatMap((f) => f.trackingInfo ?? [])
+            .map((t) => t.url)
+            .find((url) => Boolean(url)) ?? null;
+        return {
+            // `name` is the customer-facing number (e.g. "#31083220934").
+            orderNumber: (order.name ?? '').replace(/^#/, ''),
+            email: order.email ?? order.customer?.email ?? null,
+            phone: order.phone ??
+                order.customer?.phone ??
+                order.shippingAddress?.phone ??
+                null,
+            currency: order.totalPriceSet?.shopMoney?.currencyCode ?? 'INR',
+            customerName: [firstName, lastName].filter(Boolean).join(' '),
+            totalPrice: toNumber(order.totalPriceSet?.shopMoney?.amount),
+            totalTax: toNumber(order.totalTaxSet?.shopMoney?.amount),
+            totalDiscount: toNumber(order.totalDiscountsSet?.shopMoney?.amount),
+            totalShipping: toNumber(order.totalShippingPriceSet?.shopMoney?.amount),
+            billingAddress: formatAddress(order.billingAddress),
+            shippingAddress: formatAddress(order.shippingAddress),
+            paymentMethod: (order.paymentGatewayNames ?? []).join(', '),
+            shippingMethod: order.shippingLine?.title?.trim() ?? '',
+            trackingUrl,
+            orderStatusUrl: order.statusPageUrl ?? null,
+            items: (order.lineItems?.edges ?? []).map(({ node }) => ({
+                title: node.title ?? '',
+                quantity: node.quantity ?? 1,
+                amount: toNumber(node.originalTotalSet?.shopMoney?.amount),
+                size: option(node, 'Size'),
+                colour: option(node, 'Colour', 'Color'),
+                // The design's "Item nr." is a 13-digit EAN, i.e. the variant barcode.
+                itemNumber: node.variant?.barcode ?? node.variant?.sku ?? node.sku ?? null,
+            })),
+        };
+    }
+};
+exports.OrderSource = OrderSource;
+exports.OrderSource = OrderSource = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [shopify_admin_service_1.ShopifyAdminService])
+], OrderSource);
+//# sourceMappingURL=order.source.js.map

package/dist/notifications/order.source.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pvh-afl/core",
-  "version": "1.2.36",
+  "version": "1.2.38",
   "description": "AFL Core - Shared services for multi-brand commerce platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",