@endora-commerce/mod-transactional-emails 0.100.0

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

@@ -0,0 +1,155 @@
+/**
+ * EmailTemplateService — feature 047 (US3). CRUD for reusable email-safe
+ * templates. Same surface as EmailBlockService without an `active` flag.
+ */
+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 { HttpError } from '@endora-commerce/platform/http';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+import { EmailTemplate } from '../entities/email-template.entity.js';
+import { EmailTemplateSalesChannel } from '../entities/email-template-sales-channel.entity.js';
+const KNOWN = new Set(EMAIL_SAFE_COMPONENT_NAMES);
+function validateTree(content) {
+    const unknown = walkUnknownComponents(content, KNOWN);
+    if (unknown.size > 0) {
+        throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, `Non-email-safe components: ${[...unknown].join(', ')}`);
+    }
+}
+export class EmailTemplateService {
+    emFactory;
+    auditLog;
+    constructor(emFactory, auditLog) {
+        this.emFactory = emFactory;
+        this.auditLog = auditLog;
+    }
+    #audit(em, action, objectId, stateBefore, stateAfter) {
+        if (this.auditLog) {
+            recordAuditFromContext(this.auditLog, em, {
+                action,
+                objectType: 'email_template',
+                objectId,
+                stateBefore,
+                stateAfter,
+            });
+        }
+    }
+    async channelIds(em, templateId) {
+        const rows = await em.find(EmailTemplateSalesChannel, { templateId });
+        return rows.map((r) => r.salesChannelId);
+    }
+    async summary(em, t) {
+        const ids = await this.channelIds(em, t.id);
+        return {
+            id: t.id,
+            code: t.code,
+            name: t.name,
+            isSystem: t.isSystem,
+            scope: ids.length > 0 ? 'channel' : 'global',
+            languages: t.languages,
+            version: t.version,
+        };
+    }
+    async list(salesChannelId) {
+        const em = this.emFactory();
+        const templates = await em.find(EmailTemplate, {}, { orderBy: { name: 'asc' } });
+        const out = [];
+        for (const t of templates) {
+            const s = await this.summary(em, t);
+            if (salesChannelId && s.scope === 'channel') {
+                const ids = await this.channelIds(em, t.id);
+                if (!ids.includes(salesChannelId))
+                    continue;
+            }
+            out.push(s);
+        }
+        return out;
+    }
+    async loadOrThrow(em, id) {
+        const t = await em.findOne(EmailTemplate, { id });
+        if (!t)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Email template ${id} not found.`);
+        return t;
+    }
+    async get(id) {
+        const em = this.emFactory();
+        const t = await this.loadOrThrow(em, id);
+        const ids = await this.channelIds(em, t.id);
+        return {
+            ...(await this.summary(em, t)),
+            description: t.description,
+            content: t.content.languages ?? {},
+            salesChannelIds: ids,
+        };
+    }
+    async create(req) {
+        const em = this.emFactory();
+        const existing = await em.findOne(EmailTemplate, { code: req.code });
+        if (existing)
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, `Template code "${req.code}" already exists.`);
+        const tpl = em.create(EmailTemplate, {
+            code: req.code,
+            name: req.name,
+            description: req.description ?? null,
+            content: { schema_version: 1, languages: {} },
+            languages: req.languages,
+            isSystem: false,
+            version: 1,
+        });
+        await em.persistAndFlush(tpl);
+        for (const scId of req.salesChannelIds ?? []) {
+            em.persist(em.create(EmailTemplateSalesChannel, { templateId: tpl.id, salesChannelId: scId, code: tpl.code }));
+        }
+        this.#audit(em, 'email_template.create', tpl.id, null, { code: tpl.code, name: tpl.name });
+        await em.flush();
+        return this.get(tpl.id);
+    }
+    async patch(id, req) {
+        const em = this.emFactory();
+        const t = await this.loadOrThrow(em, id);
+        if (req.expectedVersion !== undefined && req.expectedVersion !== t.version) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Template was modified by someone else.');
+        }
+        if (req.name !== undefined)
+            t.name = req.name;
+        if (req.description !== undefined)
+            t.description = req.description;
+        if (req.salesChannelIds !== undefined && !t.isSystem) {
+            const current = await em.find(EmailTemplateSalesChannel, { templateId: t.id });
+            await em.removeAndFlush(current);
+            for (const scId of req.salesChannelIds) {
+                em.persist(em.create(EmailTemplateSalesChannel, { templateId: t.id, salesChannelId: scId, code: t.code }));
+            }
+        }
+        this.#audit(em, 'email_template.update', t.id, null, { code: t.code, name: t.name });
+        await em.flush();
+        return this.get(id);
+    }
+    async setContent(id, language, req) {
+        validateTree(req.content);
+        const em = this.emFactory();
+        const t = await this.loadOrThrow(em, id);
+        if (req.expectedVersion !== t.version) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Template was modified by someone else.');
+        }
+        const env = t.content ?? {};
+        const languages = { ...(env.languages ?? {}), [language]: req.content };
+        t.content = { schema_version: env.schema_version ?? 1, languages };
+        if (!t.languages.includes(language))
+            t.languages = [...t.languages, language];
+        t.version += 1;
+        this.#audit(em, 'email_template.set_content', t.id, null, { language, version: t.version });
+        await em.flush();
+        return this.get(id);
+    }
+    async delete(id) {
+        const em = this.emFactory();
+        const t = await this.loadOrThrow(em, id);
+        if (t.isSystem)
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'System templates cannot be deleted.');
+        const bridges = await em.find(EmailTemplateSalesChannel, { templateId: t.id });
+        this.#audit(em, 'email_template.delete', t.id, { code: t.code }, null);
+        await em.removeAndFlush([...bridges, t]);
+    }
+}
+//# sourceMappingURL=email-template.service.js.map

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

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

package/dist/backend/services/embed-resolver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * EmbedResolver — feature 047 (R4). Resolves email block/template embeds
+ * referenced in a content tree to their single-language Puck trees, preferring
+ * channel-scoped rows over global ones. Used by the send + preview render path.
+ */
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { PuckDataTree } from '@endora-commerce/email-components/schema/envelope';
+export interface ResolvedEmbeds {
+    blocks: Record<string, PuckDataTree>;
+    templates: Record<string, PuckDataTree>;
+}
+export declare class EmbedResolver {
+    resolve(em: EntityManager, rootTree: PuckDataTree, opts: {
+        salesChannelId: string | null;
+        language: string;
+        fallbackLanguage?: string;
+    }): Promise<ResolvedEmbeds>;
+    private pickBlock;
+    private pickTemplate;
+}
+//# sourceMappingURL=embed-resolver.d.ts.map

package/dist/backend/services/embed-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/embed-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAOtF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAUD,qBAAa,aAAa;IAClB,OAAO,CACX,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE;QAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GACnF,OAAO,CAAC,cAAc,CAAC;YAuBZ,SAAS;YAYT,YAAY;CAU3B"}

package/dist/backend/services/embed-resolver.js

@@ -0,0 +1,68 @@
+/**
+ * EmbedResolver — feature 047 (R4). Resolves email block/template embeds
+ * referenced in a content tree to their single-language Puck trees, preferring
+ * channel-scoped rows over global ones. Used by the send + preview render path.
+ */
+import { walkBlockEmbeds, walkTemplateEmbeds } from '@endora-commerce/email-components/tree/walk-embeds';
+import { EmailBlock } from '../entities/email-block.entity.js';
+import { EmailTemplate } from '../entities/email-template.entity.js';
+import { EmailBlockSalesChannel } from '../entities/email-block-sales-channel.entity.js';
+import { EmailTemplateSalesChannel } from '../entities/email-template-sales-channel.entity.js';
+function treeForLanguage(content, language, fallback) {
+    if (!content || typeof content !== 'object')
+        return null;
+    const langs = content.languages;
+    if (!langs)
+        return null;
+    const tree = langs[language] ?? (fallback ? langs[fallback] : undefined);
+    return tree && typeof tree === 'object' ? tree : null;
+}
+export class EmbedResolver {
+    async resolve(em, rootTree, opts) {
+        const blockCodes = walkBlockEmbeds(rootTree);
+        const templateCodes = walkTemplateEmbeds(rootTree);
+        const blocks = {};
+        const templates = {};
+        for (const code of blockCodes) {
+            const block = await this.pickBlock(em, code, opts.salesChannelId);
+            if (block) {
+                const tree = treeForLanguage(block.content, opts.language, opts.fallbackLanguage);
+                if (tree)
+                    blocks[code] = tree;
+            }
+        }
+        for (const code of templateCodes) {
+            const tpl = await this.pickTemplate(em, code, opts.salesChannelId);
+            if (tpl) {
+                const tree = treeForLanguage(tpl.content, opts.language, opts.fallbackLanguage);
+                if (tree)
+                    templates[code] = tree;
+            }
+        }
+        return { blocks, templates };
+    }
+    async pickBlock(em, code, salesChannelId) {
+        if (salesChannelId) {
+            const bridge = await em.findOne(EmailBlockSalesChannel, { code, salesChannelId });
+            if (bridge) {
+                const scoped = await em.findOne(EmailBlock, { id: bridge.blockId });
+                if (scoped)
+                    return scoped;
+            }
+        }
+        // Global block: a block with no bridge rows. Resolve by code, prefer active.
+        return em.findOne(EmailBlock, { code, active: true });
+    }
+    async pickTemplate(em, code, salesChannelId) {
+        if (salesChannelId) {
+            const bridge = await em.findOne(EmailTemplateSalesChannel, { code, salesChannelId });
+            if (bridge) {
+                const scoped = await em.findOne(EmailTemplate, { id: bridge.templateId });
+                if (scoped)
+                    return scoped;
+            }
+        }
+        return em.findOne(EmailTemplate, { code });
+    }
+}
+//# sourceMappingURL=embed-resolver.js.map

package/dist/backend/services/embed-resolver.js.map

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

package/dist/backend/services/manifest-reconciler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TransactionalEmailReconciler — feature 047 (R6/US1/US5).
+ *
+ * At boot, upserts `transactional_emails` rows from module manifests +
+ * registered defaults. Refreshes module-owned columns (name, variables,
+ * defaults, ...) but NEVER touches `transactional_email_contents`, so admin
+ * customizations are preserved across module-default updates (FR-027). Reports
+ * a code collision when two modules declare the same email code (FR-006).
+ */
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ModuleManifest } from '@endora-commerce/contracts';
+import type { EmailDefaultsRegistry } from './email-defaults-registry.js';
+export declare class TransactionalEmailCodeCollision extends Error {
+    constructor(code: string, modules: string[]);
+}
+export interface ReconcileResult {
+    created: number;
+    updated: number;
+    pruned: number;
+}
+export declare class TransactionalEmailReconciler {
+    private readonly emFactory;
+    private readonly defaults;
+    private readonly fallbackLanguages;
+    constructor(emFactory: () => EntityManager, defaults: EmailDefaultsRegistry, fallbackLanguages?: readonly string[]);
+    reconcile(manifests: ReadonlyArray<ModuleManifest>): Promise<ReconcileResult>;
+}
+//# sourceMappingURL=manifest-reconciler.d.ts.map

package/dist/backend/services/manifest-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-reconciler.d.ts","sourceRoot":"","sources":["../../../src/backend/services/manifest-reconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,qBAAa,+BAAgC,SAAQ,KAAK;gBAC5C,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;CAI5C;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,4BAA4B;IAErC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAFjB,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,qBAAqB,EAC/B,iBAAiB,GAAE,SAAS,MAAM,EAAc;IAG7D,SAAS,CAAC,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;CA4EpF"}

package/dist/backend/services/manifest-reconciler.js

@@ -0,0 +1,98 @@
+/**
+ * TransactionalEmailReconciler — feature 047 (R6/US1/US5).
+ *
+ * At boot, upserts `transactional_emails` rows from module manifests +
+ * registered defaults. Refreshes module-owned columns (name, variables,
+ * defaults, ...) but NEVER touches `transactional_email_contents`, so admin
+ * customizations are preserved across module-default updates (FR-027). Reports
+ * a code collision when two modules declare the same email code (FR-006).
+ */
+import { TransactionalEmail } from '../entities/transactional-email.entity.js';
+export class TransactionalEmailCodeCollision extends Error {
+    constructor(code, modules) {
+        super(`Transactional email code "${code}" declared by multiple modules: ${modules.join(', ')}`);
+        this.name = 'TransactionalEmailCodeCollision';
+    }
+}
+export class TransactionalEmailReconciler {
+    emFactory;
+    defaults;
+    fallbackLanguages;
+    constructor(emFactory, defaults, fallbackLanguages = ['en-US']) {
+        this.emFactory = emFactory;
+        this.defaults = defaults;
+        this.fallbackLanguages = fallbackLanguages;
+    }
+    async reconcile(manifests) {
+        // command-coverage-ignore: idempotent boot reconciler — seeds/updates the
+        // module-declared email blocks/templates from manifests; a system bootstrap,
+        // not an operator-initiated write.
+        const em = this.emFactory();
+        let created = 0;
+        let updated = 0;
+        // Detect cross-module code collisions first.
+        const owners = new Map();
+        for (const m of manifests) {
+            for (const entry of m.transactionalEmails ?? []) {
+                const list = owners.get(entry.code) ?? [];
+                list.push(m.id);
+                owners.set(entry.code, list);
+            }
+        }
+        for (const [code, mods] of owners) {
+            if (mods.length > 1)
+                throw new TransactionalEmailCodeCollision(code, mods);
+        }
+        for (const m of manifests) {
+            for (const entry of m.transactionalEmails ?? []) {
+                const def = this.defaults.get(entry.code);
+                const languages = def
+                    ? Object.keys(def.defaultContent && typeof def.defaultContent === 'object'
+                        ? (def.defaultContent.languages ?? {})
+                        : {})
+                    : [];
+                const resolvedLanguages = languages.length > 0 ? languages : [...this.fallbackLanguages];
+                let row = await em.findOne(TransactionalEmail, { code: entry.code });
+                if (!row) {
+                    row = em.create(TransactionalEmail, {
+                        code: entry.code,
+                        name: entry.name,
+                        ownerModule: m.id,
+                        description: entry.description ?? null,
+                        groupCode: entry.group ?? null,
+                        variables: entry.variables ?? [],
+                        languages: resolvedLanguages,
+                        defaultSubject: def?.defaultSubject ?? {},
+                        defaultContent: def?.defaultContent ?? { schema_version: 1, languages: {} },
+                        active: true,
+                    });
+                    created += 1;
+                }
+                else {
+                    row.name = entry.name;
+                    row.ownerModule = m.id;
+                    row.description = entry.description ?? null;
+                    row.groupCode = entry.group ?? null;
+                    row.variables = entry.variables ?? [];
+                    row.languages = resolvedLanguages;
+                    if (def) {
+                        row.defaultSubject = def.defaultSubject;
+                        row.defaultContent = def.defaultContent;
+                    }
+                    updated += 1;
+                }
+            }
+        }
+        await em.flush();
+        // Prune orphans (FR-028): definitions whose owning module is no longer
+        // installed / no longer declares the code. All rows are reconciler-owned, so
+        // anything not currently declared is safe to remove; the FK cascade drops
+        // the associated admin customizations.
+        const declaredCodes = [...owners.keys()];
+        const pruned = declaredCodes.length > 0
+            ? await em.nativeDelete(TransactionalEmail, { code: { $nin: declaredCodes } })
+            : await em.nativeDelete(TransactionalEmail, {});
+        return { created, updated, pruned };
+    }
+}
+//# sourceMappingURL=manifest-reconciler.js.map

package/dist/backend/services/manifest-reconciler.js.map

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

package/dist/backend/services/template-email.d.ts

@@ -0,0 +1,26 @@
+import type { TransactionalEmailSender } from '@endora-commerce/contracts';
+export interface TemplateEmailDeps {
+    getSender?: () => TransactionalEmailSender | undefined;
+    resolveScopeSalesChannelId?: () => Promise<string | null>;
+    resolveLanguage?: (salesChannelId: string) => Promise<string>;
+}
+export interface TemplateEmail {
+    /**
+     * `true` means "handled — do not use your legacy in-code builder". That
+     * covers a delivered email, one an operator deactivated, and a composition
+     * with no transport: in all three the platform decided what to send, and a
+     * fallback would either send mail the operator switched off or fail the same
+     * way. Only a code with no definition at all answers `false`.
+     */
+    trySend(input: {
+        code: string;
+        to: string;
+        messageId: string;
+        variables: Record<string, unknown>;
+        meta?: Record<string, unknown> | undefined;
+    }): Promise<boolean>;
+}
+export declare function makeTemplateEmail(deps: TemplateEmailDeps): TemplateEmail;
+/** No-op helper (sender not wired) — always falls back to the legacy builder. */
+export declare const noopTemplateEmail: TemplateEmail;
+//# sourceMappingURL=template-email.d.ts.map

package/dist/backend/services/template-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-email.d.ts","sourceRoot":"","sources":["../../../src/backend/services/template-email.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,wBAAwB,GAAG,SAAS,CAAC;IACvD,0BAA0B,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1D,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC5C,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CA4CxE;AAED,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,aAI/B,CAAC"}

package/dist/backend/services/template-email.js

@@ -0,0 +1,69 @@
+// Feature 047 — helper that routes an email through the admin-editable
+// transactional template when a sender is wired, returning false so the caller
+// can fall back to its legacy in-code builder otherwise.
+//
+// Feature 072 (T120) moved this here from `organizations/services/
+// org-template-email.ts`. It never was an organizations concern: every line of
+// it is about the transactional sender and the channel an unscoped email
+// resolves against. `organizations` owned it only because that module needed it
+// first, and `inventory` reached it through a root that imported across the
+// boundary and passed the result down — which stopped being expressible once
+// both modules composed themselves.
+//
+// Emails that are not naturally sales-channel-scoped resolve against the
+// system-default channel; global template editing still applies.
+export function makeTemplateEmail(deps) {
+    return {
+        async trySend(input) {
+            const sender = deps.getSender?.();
+            if (!sender)
+                return false;
+            const salesChannelId = (await deps.resolveScopeSalesChannelId?.()) ?? null;
+            // **Not the seventh site of the `''`-sentinel family (issue #103) — do
+            // not "fix" this line to pass `null` through.**
+            //
+            // `TransactionalEmailSendInput.salesChannelId` is `string | null` now, so
+            // the compiler would let it. Two things make this branch different from
+            // the six that were changed. It is a **producer**, and its `false` is not
+            // silence: it means "caller, use your legacy in-code builder", so the
+            // message still goes out — the other six turned an absent channel into a
+            // failed settings read that a `catch` then reported as "not configured".
+            // And the channel it wants is the **system-default** one, which D-47
+            // establishes always exists, so this is a near-dead branch rather than a
+            // wrong one.
+            //
+            // Passing `null` here would be a behaviour change for every module that
+            // holds `templateEmailPort`: each would start sending the platform-wide
+            // template where it sends its own builder's output today. That is a
+            // product decision about what mail goes out, not a sentinel repair.
+            if (!salesChannelId)
+                return false;
+            let language = 'en-US';
+            if (deps.resolveLanguage) {
+                try {
+                    language = await deps.resolveLanguage(salesChannelId);
+                }
+                catch {
+                    language = 'en-US';
+                }
+            }
+            const outcome = await sender.send({
+                code: input.code,
+                salesChannelId,
+                language,
+                to: input.to,
+                messageId: input.messageId,
+                variables: input.variables,
+                ...(input.meta ? { meta: input.meta } : {}),
+            });
+            return outcome.status !== 'no_definition';
+        },
+    };
+}
+/** No-op helper (sender not wired) — always falls back to the legacy builder. */
+export const noopTemplateEmail = {
+    async trySend() {
+        return false;
+    },
+};
+//# sourceMappingURL=template-email.js.map

package/dist/backend/services/template-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-email.js","sourceRoot":"","sources":["../../../src/backend/services/template-email.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+EAA+E;AAC/E,yDAAyD;AACzD,EAAE;AACF,mEAAmE;AACnE,+EAA+E;AAC/E,yEAAyE;AACzE,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAC7E,oCAAoC;AACpC,EAAE;AACF,yEAAyE;AACzE,iEAAiE;AA2BjE,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YAC1B,MAAM,cAAc,GAAG,CAAC,MAAM,IAAI,CAAC,0BAA0B,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;YAC3E,uEAAuE;YACvE,gDAAgD;YAChD,EAAE;YACF,0EAA0E;YAC1E,wEAAwE;YACxE,0EAA0E;YAC1E,sEAAsE;YACtE,yEAAyE;YACzE,yEAAyE;YACzE,qEAAqE;YACrE,yEAAyE;YACzE,aAAa;YACb,EAAE;YACF,wEAAwE;YACxE,wEAAwE;YACxE,oEAAoE;YACpE,oEAAoE;YACpE,IAAI,CAAC,cAAc;gBAAE,OAAO,KAAK,CAAC;YAClC,IAAI,QAAQ,GAAG,OAAO,CAAC;YACvB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;gBACxD,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,GAAG,OAAO,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAChC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,cAAc;gBACd,QAAQ;gBACR,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5C,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,MAAM,KAAK,eAAe,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,KAAK,CAAC,OAAO;QACX,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}