@endora-commerce/mod-transactional-emails 0.100.0

package/dist/backend/services/transactional-email.service.d.ts

@@ -0,0 +1,138 @@
+/**
+ * TransactionalEmailService — feature 047 (US1/US2/US4).
+ *
+ * Implements the TransactionalEmailSender port: resolve effective subject +
+ * content (channel -> global -> default), resolve embeds, render email-safe HTML
+ * + plain text, substitute variables (Magento-style directives, HTML-escaped in
+ * HTML), and send through the shared Mailer. Also powers the admin list/detail,
+ * save/reset content, and preview endpoints.
+ */
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type PreviewEmailResponse, type ResolvedEmailContent, type TransactionalEmailDetail, type TransactionalEmailSender, type TransactionalEmailSendInput, type TransactionalEmailSummary, type TransactionalSendOutcome } from '@endora-commerce/contracts';
+import type { PuckDataTree } from '@endora-commerce/email-components/schema/envelope';
+import type { EmailDeliveryRecorder, EmailMailerPort } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { ContentResolver } from './content-resolver.js';
+import type { BrandingService } from './branding.service.js';
+import type { EmbedResolver } from './embed-resolver.js';
+import type { EmailDefaultsRegistry } from './email-defaults-registry.js';
+export interface SaveContentInput {
+    subject: string;
+    content: PuckDataTree;
+    expectedVersion?: number;
+}
+export interface RenderResult {
+    subject: string;
+    html: string;
+    text: string;
+}
+export interface TransactionalEmailServiceDeps {
+    emFactory: () => EntityManager;
+    contentResolver: ContentResolver;
+    branding: BrandingService;
+    embeds: EmbedResolver;
+    /**
+     * The owner ledger the admin projection reads for the per-email protection
+     * (issue #89). Required rather than optional: an absent registry would make
+     * every email report itself deactivatable, which is the one wrong answer —
+     * the admin would offer a switch for `email_verification` and the write path
+     * would refuse it.
+     */
+    defaults: EmailDefaultsRegistry;
+    /**
+     * The transport, named by `email`'s published contract since feature 075's
+     * Phase C. `email` registers it ungated and declares itself
+     * non-deactivatable, so this edge has no absent state to fail closed onto —
+     * the `undefined` below is a composition that wired no transport at all,
+     * which `send` reports as `no_transport`.
+     */
+    mailer?: EmailMailerPort;
+    /**
+     * Where the three outcomes decided **before** the transport are recorded
+     * (D-59). Optional: a composition with no recorder loses the row, not the
+     * send, which is the same tolerance the recorder itself states.
+     */
+    deliveryRecorder?: EmailDeliveryRecorder;
+    auditLog?: AuditPort;
+}
+export declare class TransactionalEmailService implements TransactionalEmailSender {
+    private readonly emFactory;
+    private readonly contentResolver;
+    private readonly branding;
+    private readonly embeds;
+    private readonly defaults;
+    private readonly mailer;
+    private readonly deliveryRecorder;
+    private readonly auditLog;
+    constructor(deps: TransactionalEmailServiceDeps);
+    /**
+     * Delivers the email and reports what happened. The three non-`sent` outcomes
+     * used to be one silent `return`, which left every caller unable to tell an
+     * operator's "off" from a code with no template — and suppressing its own
+     * fallback for both.
+     *
+     * Since D-59 each of those three also leaves a **row**. They are the outcomes
+     * decided before the transport is reached, so the record `RecordingMailer`
+     * writes never gets the chance — and one of them, `deactivated`, is the whole
+     * reason the record has to tell a deliberate configuration from an outage.
+     * A delivered message is deliberately *not* recorded here: the transport
+     * records it, so one send stays one row.
+     */
+    send(input: TransactionalEmailSendInput): Promise<TransactionalSendOutcome>;
+    /**
+     * One row for a message this layer decided not to send.
+     *
+     * No `catch`: the recorder answers `null` for a row it could not write and
+     * never throws (its own contract), so there is nothing here to contain — and
+     * a `catch` around a collaborator another module owns is how a presence
+     * answer stops travelling.
+     */
+    private recordNotSent;
+    private renderWith;
+    /**
+     * Whether an operator may switch this one email off (issue #89).
+     *
+     * Resolved from the registry on every read rather than persisted on the row:
+     * the declaration is shipped code owned by the sending module, so a stored
+     * copy would go stale the moment that module changed its mind, and the
+     * reconciler would have one more column to fight over.
+     */
+    private protectionOf;
+    private summarize;
+    list(): Promise<TransactionalEmailSummary[]>;
+    /**
+     * One email's summary, re-read from the database.
+     *
+     * The activation route answers with this rather than with what it just
+     * wrote — the flip runs on the Command Bus's own forked EM, so the only
+     * honest report of the committed state is a fresh read. Hence `refresh`
+     * rather than `em.clear()`: the request-scoped identity map may hold entities
+     * the auth guard put there, and discarding those to re-read one row is a
+     * wider blast radius than the question needs.
+     */
+    summary(code: string): Promise<TransactionalEmailSummary>;
+    private loadEmailOrThrow;
+    getDetail(code: string, salesChannelId: string | null, language?: string): Promise<TransactionalEmailDetail>;
+    private validateContent;
+    saveContent(code: string, scope: {
+        salesChannelId: string | null;
+        language: string;
+    }, input: SaveContentInput, actor?: {
+        adminUserId?: string | null;
+    }): Promise<ResolvedEmailContent>;
+    resetContent(code: string, scope: {
+        salesChannelId: string | null;
+        language: string;
+    }, actor?: {
+        adminUserId?: string | null;
+    }): Promise<ResolvedEmailContent>;
+    preview(code: string, input: {
+        salesChannelId: string | null;
+        language?: string;
+        draftSubject?: string;
+        draftContent?: PuckDataTree;
+    }): Promise<PreviewEmailResponse>;
+    private sampleVariables;
+    private audit;
+}
+//# sourceMappingURL=transactional-email.service.d.ts.map

package/dist/backend/services/transactional-email.service.d.ts.map

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

package/dist/backend/services/transactional-email.service.js

@@ -0,0 +1,410 @@
+/**
+ * TransactionalEmailService — feature 047 (US1/US2/US4).
+ *
+ * Implements the TransactionalEmailSender port: resolve effective subject +
+ * content (channel -> global -> default), resolve embeds, render email-safe HTML
+ * + plain text, substitute variables (Magento-style directives, HTML-escaped in
+ * HTML), and send through the shared Mailer. Also powers the admin list/detail,
+ * save/reset content, and preview endpoints.
+ */
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { EMAIL_SAFE_COMPONENT_NAMES } from '@endora-commerce/email-components/schema/component-types';
+import { walkUnknownComponents } from '@endora-commerce/email-components/tree/walk-embeds';
+import { renderEmailHtml } from '@endora-commerce/email-components/render/render-email-html';
+import { renderEmailText } from '@endora-commerce/email-components/render/render-email-text';
+import { renderDirectives } from '@endora-commerce/email-components/directives/directive-engine';
+import { HttpError } from '@endora-commerce/platform/http';
+import { TransactionalEmail } from '../entities/transactional-email.entity.js';
+import { TransactionalEmailContent } from '../entities/transactional-email-content.entity.js';
+import {} from './content-resolver.js';
+import {} from './branding.service.js';
+const KNOWN_COMPONENTS = new Set(EMAIL_SAFE_COMPONENT_NAMES);
+/**
+ * A missing transport is a deployment fact, not a per-message one: it holds for
+ * every send until someone fixes the composition. The guard is deliberately
+ * **per process** (module scope, never reset) so a misconfigured deployment
+ * gets one line instead of one per email.
+ */
+let noTransportWarned = false;
+export class TransactionalEmailService {
+    emFactory;
+    contentResolver;
+    branding;
+    embeds;
+    defaults;
+    mailer;
+    deliveryRecorder;
+    auditLog;
+    constructor(deps) {
+        this.emFactory = deps.emFactory;
+        this.contentResolver = deps.contentResolver;
+        this.branding = deps.branding;
+        this.embeds = deps.embeds;
+        this.defaults = deps.defaults;
+        this.mailer = deps.mailer;
+        this.deliveryRecorder = deps.deliveryRecorder;
+        this.auditLog = deps.auditLog;
+    }
+    // --- Sending (port) -----------------------------------------------------
+    /**
+     * Delivers the email and reports what happened. The three non-`sent` outcomes
+     * used to be one silent `return`, which left every caller unable to tell an
+     * operator's "off" from a code with no template — and suppressing its own
+     * fallback for both.
+     *
+     * Since D-59 each of those three also leaves a **row**. They are the outcomes
+     * decided before the transport is reached, so the record `RecordingMailer`
+     * writes never gets the chance — and one of them, `deactivated`, is the whole
+     * reason the record has to tell a deliberate configuration from an outage.
+     * A delivered message is deliberately *not* recorded here: the transport
+     * records it, so one send stays one row.
+     */
+    async send(input) {
+        if (!this.mailer) {
+            if (!noTransportWarned) {
+                noTransportWarned = true;
+                console.warn('[transactional_emails] no mailer configured — transactional emails are not being delivered (logged once per process).');
+            }
+            await this.recordNotSent(input, 'failed', 'no_transport');
+            return { status: 'no_transport' };
+        }
+        const em = this.emFactory();
+        const email = await em.findOne(TransactionalEmail, { code: input.code });
+        // No definition: the caller may still have a legacy in-code builder for
+        // this code. Deactivated: the operator chose silence, so nothing goes out.
+        if (!email) {
+            await this.recordNotSent(input, 'failed', 'no_definition');
+            return { status: 'no_definition' };
+        }
+        if (!email.active) {
+            await this.recordNotSent(input, 'suppressed', 'deactivated');
+            return { status: 'deactivated' };
+        }
+        const fallbackLanguage = email.languages[0];
+        const resolved = await this.contentResolver.resolve(em, email, {
+            salesChannelId: input.salesChannelId,
+            language: input.language,
+            ...(fallbackLanguage ? { fallbackLanguage } : {}),
+        });
+        const branding = await this.branding.resolve(input.salesChannelId);
+        const rendered = await this.renderWith(em, resolved, branding, input.variables, {
+            salesChannelId: input.salesChannelId,
+            language: resolved.language,
+            ...(fallbackLanguage ? { fallbackLanguage } : {}),
+        });
+        // The transport's own answer (`sent` / `suppressed`, D-59) is deliberately
+        // not carried further, and this is the decision rather than an oversight:
+        // its one suppression reason is `duplicate_message_id`, meaning this exact
+        // message id was already accepted, so the message did go out. What
+        // `TransactionalSendOutcome` exists to tell a caller is whether it may fall
+        // back to its own in-code builder, and neither transport answer permits
+        // that. The row is not lost either — `RecordingMailer` writes the
+        // `suppressed` delivery record before returning. Widening the union here
+        // would publish a distinction no caller can act on.
+        await this.mailer.send({
+            messageId: input.messageId,
+            to: input.to,
+            subject: rendered.subject,
+            text: rendered.text,
+            html: rendered.html,
+            // What the delivery record needs and only this layer holds: the code the
+            // message was rendered from, the channel it was rendered for, and the
+            // document it delivers.
+            kind: input.code,
+            salesChannelId: input.salesChannelId,
+            ...(input.document ? { document: input.document } : {}),
+            ...(input.attachments ? { attachments: input.attachments } : {}),
+            ...(input.meta ? { meta: input.meta } : {}),
+        });
+        return { status: 'sent' };
+    }
+    /**
+     * One row for a message this layer decided not to send.
+     *
+     * No `catch`: the recorder answers `null` for a row it could not write and
+     * never throws (its own contract), so there is nothing here to contain — and
+     * a `catch` around a collaborator another module owns is how a presence
+     * answer stops travelling.
+     */
+    async recordNotSent(input, status, reason) {
+        await this.deliveryRecorder?.record({
+            messageId: input.messageId,
+            recipient: input.to,
+            kind: input.code,
+            status,
+            reason,
+            salesChannelId: input.salesChannelId,
+            ...(input.document
+                ? { documentType: input.document.type, documentId: input.document.id }
+                : {}),
+            ...(input.meta ? { context: input.meta } : {}),
+        });
+    }
+    // --- Rendering ----------------------------------------------------------
+    async renderWith(em, resolved, branding, variables, scope) {
+        const embeds = await this.embeds.resolve(em, resolved.content, scope);
+        const ctx = {
+            ...variables,
+            branding: { logoUrl: branding.logoUrl, accentColor: branding.accentColor },
+        };
+        const html = renderDirectives(renderEmailHtml(resolved.content, {
+            embeds,
+            accentColor: branding.accentColor,
+            language: scope.language,
+        }), ctx, { escape: true });
+        const text = renderDirectives(renderEmailText(resolved.content, { embeds }), ctx);
+        const subject = renderDirectives(resolved.subject, ctx);
+        return { subject, html, text };
+    }
+    // --- Admin: list / detail ----------------------------------------------
+    /**
+     * Whether an operator may switch this one email off (issue #89).
+     *
+     * Resolved from the registry on every read rather than persisted on the row:
+     * the declaration is shipped code owned by the sending module, so a stored
+     * copy would go stale the moment that module changed its mind, and the
+     * reconciler would have one more column to fight over.
+     */
+    protectionOf(code) {
+        const reason = this.defaults.nonDeactivatableReasonOf(code);
+        return { deactivatable: reason === null, nonDeactivatableReason: reason };
+    }
+    async summarize(em, email) {
+        const globalCount = await em.count(TransactionalEmailContent, { emailId: email.id, salesChannelId: null });
+        const channelCount = await em.count(TransactionalEmailContent, { emailId: email.id, salesChannelId: { $ne: null } });
+        return {
+            code: email.code,
+            name: email.name,
+            ownerModule: email.ownerModule,
+            group: email.groupCode,
+            active: email.active,
+            languages: email.languages,
+            hasGlobalOverride: globalCount > 0,
+            hasChannelOverride: channelCount > 0,
+            ...this.protectionOf(email.code),
+        };
+    }
+    async list() {
+        const em = this.emFactory();
+        const emails = await em.find(TransactionalEmail, {}, { orderBy: { name: 'asc' } });
+        const out = [];
+        for (const e of emails) {
+            out.push(await this.summarize(em, e));
+        }
+        return out;
+    }
+    /**
+     * One email's summary, re-read from the database.
+     *
+     * The activation route answers with this rather than with what it just
+     * wrote — the flip runs on the Command Bus's own forked EM, so the only
+     * honest report of the committed state is a fresh read. Hence `refresh`
+     * rather than `em.clear()`: the request-scoped identity map may hold entities
+     * the auth guard put there, and discarding those to re-read one row is a
+     * wider blast radius than the question needs.
+     */
+    async summary(code) {
+        const em = this.emFactory();
+        const email = await em.findOne(TransactionalEmail, { code }, { refresh: true });
+        if (!email)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Transactional email "${code}" not found.`);
+        return this.summarize(em, email);
+    }
+    async loadEmailOrThrow(em, code) {
+        const email = await em.findOne(TransactionalEmail, { code });
+        if (!email)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Transactional email "${code}" not found.`);
+        return email;
+    }
+    async getDetail(code, salesChannelId, language) {
+        const em = this.emFactory();
+        const email = await this.loadEmailOrThrow(em, code);
+        const lang = language ?? email.languages[0] ?? 'en-US';
+        const fallbackLanguage = email.languages[0];
+        const resolved = await this.contentResolver.resolve(em, email, {
+            salesChannelId,
+            language: lang,
+            ...(fallbackLanguage ? { fallbackLanguage } : {}),
+        });
+        const globalCount = await em.count(TransactionalEmailContent, { emailId: email.id, salesChannelId: null });
+        const channelCount = await em.count(TransactionalEmailContent, { emailId: email.id, salesChannelId: { $ne: null } });
+        const defaultContentTree = email.defaultContent.languages?.[lang] ?? { root: { props: {} }, content: [] };
+        const effective = {
+            subject: resolved.subject,
+            content: resolved.content,
+            source: resolved.source,
+            version: resolved.version,
+        };
+        return {
+            code: email.code,
+            name: email.name,
+            ownerModule: email.ownerModule,
+            group: email.groupCode,
+            description: email.description,
+            active: email.active,
+            languages: email.languages,
+            variables: email.variables,
+            scope: { salesChannelId, language: lang },
+            effective,
+            default: { subject: email.defaultSubject[lang] ?? '', content: defaultContentTree },
+            hasGlobalOverride: globalCount > 0,
+            hasChannelOverride: channelCount > 0,
+            ...this.protectionOf(email.code),
+        };
+    }
+    // --- Admin: save / reset -----------------------------------------------
+    validateContent(content) {
+        const unknown = walkUnknownComponents(content, KNOWN_COMPONENTS);
+        if (unknown.size > 0) {
+            throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, `Email content contains non-email-safe components: ${[...unknown].join(', ')}`);
+        }
+    }
+    async saveContent(code, scope, input, actor = {}) {
+        if (!input.subject.trim()) {
+            throw new HttpError(422, ERROR_CODES.VALIDATION_FAILED, 'Subject is required.');
+        }
+        this.validateContent(input.content);
+        const em = this.emFactory();
+        const email = await this.loadEmailOrThrow(em, code);
+        let row = await em.findOne(TransactionalEmailContent, {
+            emailId: email.id,
+            salesChannelId: scope.salesChannelId,
+            language: scope.language,
+        });
+        if (row) {
+            if (input.expectedVersion !== undefined && input.expectedVersion !== row.version) {
+                throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Email content was modified by someone else.');
+            }
+            row.subject = input.subject;
+            row.content = input.content;
+            row.version += 1;
+        }
+        else {
+            row = em.create(TransactionalEmailContent, {
+                emailId: email.id,
+                salesChannelId: scope.salesChannelId,
+                language: scope.language,
+                subject: input.subject,
+                content: input.content,
+                version: 1,
+            });
+        }
+        await em.flush();
+        await this.audit(actor, 'transactional_email.content.saved', email.code, { scope });
+        return { subject: row.subject, content: row.content, source: scope.salesChannelId ? 'channel' : 'global', version: row.version };
+    }
+    async resetContent(code, scope, actor = {}) {
+        const em = this.emFactory();
+        const email = await this.loadEmailOrThrow(em, code);
+        const row = await em.findOne(TransactionalEmailContent, {
+            emailId: email.id,
+            salesChannelId: scope.salesChannelId,
+            language: scope.language,
+        });
+        if (row) {
+            await em.removeAndFlush(row);
+            await this.audit(actor, 'transactional_email.content.reset', email.code, { scope });
+        }
+        const fallbackLanguage = email.languages[0];
+        const resolved = await this.contentResolver.resolve(em, email, {
+            salesChannelId: scope.salesChannelId,
+            language: scope.language,
+            ...(fallbackLanguage ? { fallbackLanguage } : {}),
+        });
+        return { subject: resolved.subject, content: resolved.content, source: resolved.source, version: resolved.version };
+    }
+    // --- Admin: preview -----------------------------------------------------
+    async preview(code, input) {
+        const em = this.emFactory();
+        const email = await this.loadEmailOrThrow(em, code);
+        const lang = input.language ?? email.languages[0] ?? 'en-US';
+        const fallbackLanguage = email.languages[0];
+        let resolved;
+        if (input.draftContent !== undefined || input.draftSubject !== undefined) {
+            const base = await this.contentResolver.resolve(em, email, {
+                salesChannelId: input.salesChannelId,
+                language: lang,
+                ...(fallbackLanguage ? { fallbackLanguage } : {}),
+            });
+            resolved = {
+                subject: input.draftSubject ?? base.subject,
+                content: input.draftContent ?? base.content,
+                source: base.source,
+                version: base.version,
+                language: lang,
+            };
+        }
+        else {
+            resolved = await this.contentResolver.resolve(em, email, {
+                salesChannelId: input.salesChannelId,
+                language: lang,
+                ...(fallbackLanguage ? { fallbackLanguage } : {}),
+            });
+        }
+        const branding = await this.branding.resolve(input.salesChannelId);
+        // Sample data drives the preview (FR-024).
+        const variables = this.sampleVariables(email.variables);
+        const rendered = await this.renderWith(em, resolved, branding, variables, {
+            salesChannelId: input.salesChannelId,
+            language: lang,
+            ...(fallbackLanguage ? { fallbackLanguage } : {}),
+        });
+        return { subject: rendered.subject, html: rendered.html, text: rendered.text };
+    }
+    sampleVariables(variables) {
+        // Prefer shared helper (JSON sampleValue for lists like order.items).
+        // Local inline fallback mirrors packages/email-components sample-variables.
+        const ctx = {};
+        for (const v of variables) {
+            const parts = v.key.split('.');
+            let cur = ctx;
+            for (let i = 0; i < parts.length - 1; i += 1) {
+                const part = parts[i];
+                if (!part)
+                    continue;
+                if (typeof cur[part] !== 'object' || cur[part] === null || Array.isArray(cur[part])) {
+                    cur[part] = {};
+                }
+                cur = cur[part];
+            }
+            const leaf = parts[parts.length - 1];
+            if (!leaf)
+                continue;
+            const raw = v.sampleValue;
+            if (raw == null || raw === '') {
+                cur[leaf] = `{${v.key}}`;
+                continue;
+            }
+            const trimmed = raw.trim();
+            if ((trimmed.startsWith('{') && trimmed.endsWith('}')) ||
+                (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
+                try {
+                    cur[leaf] = JSON.parse(trimmed);
+                    continue;
+                }
+                catch {
+                    /* fall through */
+                }
+            }
+            cur[leaf] = raw;
+        }
+        return ctx;
+    }
+    async audit(actor, action, objectId, meta) {
+        if (!this.auditLog)
+            return;
+        try {
+            await this.auditLog.record({
+                actorAdminUserId: actor.adminUserId ?? null,
+                action,
+                objectType: 'transactional_email',
+                objectId,
+                stateAfter: meta,
+            });
+        }
+        catch {
+            // Audit is best-effort; never block the operation.
+        }
+    }
+}
+//# sourceMappingURL=transactional-email.service.js.map

package/dist/backend/services/transactional-email.service.js.map

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