@endora-commerce/mod-transactional-emails 0.100.0

package/dist/backend/services/branding.service.js

@@ -0,0 +1,119 @@
+/**
+ * BrandingService — feature 047 (R5/US2).
+ *
+ * Resolves email branding (header logo, accent, default header/footer block
+ * codes) globally and per sales channel via the Settings module, and exposes the
+ * resolved logo URL as the `branding.logoUrl` variable for rendering.
+ */
+import { z } from 'zod';
+import { SettingNotRegistered, SettingOutOfScopeForChannel } from '@endora-commerce/platform/kernel';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { TRANSACTIONAL_EMAILS_SETTING_CODES } from '../../manifest.js';
+/**
+ * Conditions this service has already reported (D-43's warn-once). Module scope
+ * and never reset: branding is read on every rendered email.
+ */
+const warnedConditions = new Set();
+function warnOnce(condition, message) {
+    if (warnedConditions.has(condition))
+        return;
+    warnedConditions.add(condition);
+    console.warn(message);
+}
+export class BrandingService {
+    settings;
+    resolveAssetUrl;
+    writeDeps;
+    constructor(settings, resolveAssetUrl, writeDeps) {
+        this.settings = settings;
+        this.resolveAssetUrl = resolveAssetUrl;
+        this.writeDeps = writeDeps;
+    }
+    /**
+     * Two conditions degrade, and both to the caller's compiled-in default:
+     * the setting is not registered (the module has not reconciled its manifest
+     * yet), and the setting is scoped to a subset of channels that this read is
+     * not inside. Everything else propagates — the bare `catch` this replaces
+     * would have swallowed a `MODULE_DISABLED` envelope with equal enthusiasm,
+     * which is fail-open dressed as robustness (composition rule 7, D-43).
+     */
+    async readString(code, salesChannelId, fallback) {
+        try {
+            return await this.settings.get(code, salesChannelId, z.string());
+        }
+        catch (error) {
+            if (error instanceof SettingNotRegistered)
+                return fallback;
+            if (error instanceof SettingOutOfScopeForChannel) {
+                warnOnce(`out-of-scope:${code}`, `[transactional_emails] branding setting "${code}" is scoped to specific sales ` +
+                    `channels, so it has no value for this read — falling back to the built-in ` +
+                    `default (logged once per process).`);
+                return fallback;
+            }
+            throw error;
+        }
+    }
+    /**
+     * `salesChannelId === null` is the platform-wide read, and it is passed
+     * through as `null` (D-41). It used to become the nil UUID: well-formed
+     * enough to pass the seam guard, matching no row, so the right tier by
+     * accident — and cached under a fake channel key that no invalidation ever
+     * targeted, instead of the reserved `__global__` segment.
+     */
+    async resolve(salesChannelId) {
+        const C = TRANSACTIONAL_EMAILS_SETTING_CODES;
+        const logoAssetId = await this.readString(C.LOGO_ASSET_ID, salesChannelId, '');
+        const accentColor = await this.readString(C.ACCENT_COLOR, salesChannelId, '#1f2937');
+        const headerBlockCode = await this.readString(C.HEADER_BLOCK_CODE, salesChannelId, 'default_email_header');
+        const footerBlockCode = await this.readString(C.FOOTER_BLOCK_CODE, salesChannelId, 'default_email_footer');
+        let logoUrl = '';
+        if (logoAssetId && this.resolveAssetUrl) {
+            try {
+                logoUrl = (await this.resolveAssetUrl(logoAssetId)) ?? '';
+            }
+            catch {
+                logoUrl = '';
+            }
+        }
+        return {
+            salesChannelId,
+            logoAssetId,
+            logoUrl,
+            accentColor,
+            headerBlockCode,
+            footerBlockCode,
+            source: salesChannelId ? 'channel' : 'global',
+        };
+    }
+    /** Persist branding values at the given scope (global when salesChannelId is null). */
+    async update(salesChannelId, patch, actor) {
+        if (!this.writeDeps) {
+            throw new Error('Branding write is not configured.');
+        }
+        const C = TRANSACTIONAL_EMAILS_SETTING_CODES;
+        const entries = [];
+        if (patch.logoAssetId !== undefined)
+            entries.push([C.LOGO_ASSET_ID, patch.logoAssetId]);
+        if (patch.accentColor !== undefined)
+            entries.push([C.ACCENT_COLOR, patch.accentColor]);
+        if (patch.headerBlockCode !== undefined)
+            entries.push([C.HEADER_BLOCK_CODE, patch.headerBlockCode]);
+        if (patch.footerBlockCode !== undefined)
+            entries.push([C.FOOTER_BLOCK_CODE, patch.footerBlockCode]);
+        let channelCodes = null;
+        if (salesChannelId) {
+            const channel = await this.writeDeps.emFactory().findOne(SalesChannel, { id: salesChannelId });
+            channelCodes = channel ? [channel.code] : [];
+        }
+        for (const [code, value] of entries) {
+            if (channelCodes) {
+                await this.writeDeps.admin.setValueForSubset(code, channelCodes, value, null, actor);
+            }
+            else {
+                await this.writeDeps.admin.setValueForAllChannels(code, value, null, actor);
+            }
+        }
+        return this.resolve(salesChannelId);
+    }
+}
+//# sourceMappingURL=branding.service.js.map

package/dist/backend/services/branding.service.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * Content resolver — feature 047 (R5/US1/US2).
+ *
+ * Resolves the effective subject + content for an email definition at a given
+ * scope and language: per-channel override -> global override -> module default,
+ * each with a language fallback to the channel default language.
+ */
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { PuckDataTree } from '@endora-commerce/email-components/schema/envelope';
+import type { TransactionalEmail } from '../entities/transactional-email.entity.js';
+export type ContentSource = 'channel' | 'global' | 'default';
+export interface ResolvedContent {
+    subject: string;
+    content: PuckDataTree;
+    source: ContentSource;
+    version: number | null;
+    language: string;
+}
+export interface ResolveOptions {
+    salesChannelId: string | null;
+    language: string;
+    /** Fallback language when the requested language has no content. */
+    fallbackLanguage?: string;
+}
+export declare class ContentResolver {
+    resolve(em: EntityManager, email: TransactionalEmail, opts: ResolveOptions): Promise<ResolvedContent>;
+}
+//# sourceMappingURL=content-resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/content-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAGpF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAuBD,qBAAa,eAAe;IACpB,OAAO,CACX,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,eAAe,CAAC;CAsC5B"}

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

@@ -0,0 +1,64 @@
+/**
+ * Content resolver — feature 047 (R5/US1/US2).
+ *
+ * Resolves the effective subject + content for an email definition at a given
+ * scope and language: per-channel override -> global override -> module default,
+ * each with a language fallback to the channel default language.
+ */
+import { TransactionalEmailContent } from '../entities/transactional-email-content.entity.js';
+function envelopeTree(envelope, language) {
+    if (!envelope || typeof envelope !== 'object')
+        return null;
+    const langs = envelope.languages;
+    if (!langs || typeof langs !== 'object')
+        return null;
+    const tree = langs[language];
+    return tree && typeof tree === 'object' ? tree : null;
+}
+function defaultSubject(email, language, fallback) {
+    const map = email.defaultSubject ?? {};
+    return map[language] ?? (fallback ? map[fallback] : undefined) ?? Object.values(map)[0] ?? '';
+}
+function defaultContent(email, language, fallback) {
+    return (envelopeTree(email.defaultContent, language) ??
+        (fallback ? envelopeTree(email.defaultContent, fallback) : null) ??
+        { root: { props: {} }, content: [] });
+}
+export class ContentResolver {
+    async resolve(em, email, opts) {
+        const langs = [opts.language, ...(opts.fallbackLanguage ? [opts.fallbackLanguage] : [])];
+        // 1. Per-channel override (requested language, then fallback language).
+        if (opts.salesChannelId) {
+            for (const lang of langs) {
+                const row = await em.findOne(TransactionalEmailContent, {
+                    emailId: email.id,
+                    salesChannelId: opts.salesChannelId,
+                    language: lang,
+                });
+                if (row) {
+                    return { subject: row.subject, content: row.content, source: 'channel', version: row.version, language: lang };
+                }
+            }
+        }
+        // 2. Global override (requested language, then fallback language).
+        for (const lang of langs) {
+            const row = await em.findOne(TransactionalEmailContent, {
+                emailId: email.id,
+                salesChannelId: null,
+                language: lang,
+            });
+            if (row) {
+                return { subject: row.subject, content: row.content, source: 'global', version: row.version, language: lang };
+            }
+        }
+        // 3. Module default.
+        return {
+            subject: defaultSubject(email, opts.language, opts.fallbackLanguage),
+            content: defaultContent(email, opts.language, opts.fallbackLanguage),
+            source: 'default',
+            version: null,
+            language: opts.language,
+        };
+    }
+}
+//# sourceMappingURL=content-resolver.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * EmailBlockService — feature 047 (US3). CRUD for reusable email-safe blocks,
+ * including per-channel scoping via the bridge table, optimistic concurrency,
+ * email-safe validation, system-block protection, and a reference check on
+ * delete (a block embedded by any email/block/template cannot be removed).
+ */
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CreateEmailBlockRequest, type EmailBlockDetail, type EmailBlockSummary, type PatchEmailBlockRequest, type PutEmailBlockContentRequest } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+export declare class EmailBlockService {
+    #private;
+    private readonly emFactory;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, auditLog?: AuditPort | undefined);
+    private channelIds;
+    private summary;
+    list(salesChannelId?: string): Promise<EmailBlockSummary[]>;
+    private loadOrThrow;
+    get(id: string): Promise<EmailBlockDetail>;
+    create(req: CreateEmailBlockRequest, actor?: unknown): Promise<EmailBlockDetail>;
+    patch(id: string, req: PatchEmailBlockRequest): Promise<EmailBlockDetail>;
+    setContent(id: string, language: string, req: PutEmailBlockContentRequest): Promise<EmailBlockDetail>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=email-block.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-block.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/email-block.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAMpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAalE,qBAAa,iBAAiB;;IAE1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,CAAC,EAAE,SAAS,YAAA;YAqBzB,UAAU;YAKV,OAAO;IAcf,IAAI,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAenD,WAAW;IAMnB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY1C,MAAM,CAAC,GAAG,EAAE,uBAAuB,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBhF,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqBzE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiBrG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQxC"}

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

@@ -0,0 +1,162 @@
+/**
+ * EmailBlockService — feature 047 (US3). CRUD for reusable email-safe blocks,
+ * including per-channel scoping via the bridge table, optimistic concurrency,
+ * email-safe validation, system-block protection, and a reference check on
+ * delete (a block embedded by any email/block/template cannot be removed).
+ */
+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 { EmailBlock } from '../entities/email-block.entity.js';
+import { EmailBlockSalesChannel } from '../entities/email-block-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 EmailBlockService {
+    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_block',
+                objectId,
+                stateBefore,
+                stateAfter,
+            });
+        }
+    }
+    async channelIds(em, blockId) {
+        const rows = await em.find(EmailBlockSalesChannel, { blockId });
+        return rows.map((r) => r.salesChannelId);
+    }
+    async summary(em, b) {
+        const ids = await this.channelIds(em, b.id);
+        return {
+            id: b.id,
+            code: b.code,
+            name: b.name,
+            active: b.active,
+            isSystem: b.isSystem,
+            scope: ids.length > 0 ? 'channel' : 'global',
+            languages: b.languages,
+            version: b.version,
+        };
+    }
+    async list(salesChannelId) {
+        const em = this.emFactory();
+        const blocks = await em.find(EmailBlock, {}, { orderBy: { name: 'asc' } });
+        const out = [];
+        for (const b of blocks) {
+            const summary = await this.summary(em, b);
+            if (salesChannelId && summary.scope === 'channel') {
+                const ids = await this.channelIds(em, b.id);
+                if (!ids.includes(salesChannelId))
+                    continue;
+            }
+            out.push(summary);
+        }
+        return out;
+    }
+    async loadOrThrow(em, id) {
+        const b = await em.findOne(EmailBlock, { id });
+        if (!b)
+            throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Email block ${id} not found.`);
+        return b;
+    }
+    async get(id) {
+        const em = this.emFactory();
+        const b = await this.loadOrThrow(em, id);
+        const ids = await this.channelIds(em, b.id);
+        return {
+            ...(await this.summary(em, b)),
+            description: b.description,
+            content: b.content.languages ?? {},
+            salesChannelIds: ids,
+        };
+    }
+    async create(req, actor) {
+        void actor;
+        const em = this.emFactory();
+        const existing = await em.findOne(EmailBlock, { code: req.code });
+        if (existing)
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, `Block code "${req.code}" already exists.`);
+        const block = em.create(EmailBlock, {
+            code: req.code,
+            name: req.name,
+            description: req.description ?? null,
+            active: req.active ?? true,
+            content: { schema_version: 1, languages: {} },
+            languages: req.languages,
+            isSystem: false,
+            version: 1,
+        });
+        await em.persistAndFlush(block);
+        for (const scId of req.salesChannelIds ?? []) {
+            em.persist(em.create(EmailBlockSalesChannel, { blockId: block.id, salesChannelId: scId, code: block.code }));
+        }
+        this.#audit(em, 'email_block.create', block.id, null, { code: block.code, name: block.name });
+        await em.flush();
+        return this.get(block.id);
+    }
+    async patch(id, req) {
+        const em = this.emFactory();
+        const b = await this.loadOrThrow(em, id);
+        if (req.expectedVersion !== undefined && req.expectedVersion !== b.version) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Block was modified by someone else.');
+        }
+        if (req.name !== undefined)
+            b.name = req.name;
+        if (req.description !== undefined)
+            b.description = req.description;
+        if (req.active !== undefined && !b.isSystem)
+            b.active = req.active;
+        if (req.salesChannelIds !== undefined && !b.isSystem) {
+            const current = await em.find(EmailBlockSalesChannel, { blockId: b.id });
+            await em.removeAndFlush(current);
+            for (const scId of req.salesChannelIds) {
+                em.persist(em.create(EmailBlockSalesChannel, { blockId: b.id, salesChannelId: scId, code: b.code }));
+            }
+        }
+        this.#audit(em, 'email_block.update', b.id, null, { code: b.code, name: b.name });
+        await em.flush();
+        return this.get(id);
+    }
+    async setContent(id, language, req) {
+        validateTree(req.content);
+        const em = this.emFactory();
+        const b = await this.loadOrThrow(em, id);
+        if (req.expectedVersion !== b.version) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Block was modified by someone else.');
+        }
+        const env = b.content ?? {};
+        const languages = { ...(env.languages ?? {}), [language]: req.content };
+        b.content = { schema_version: env.schema_version ?? 1, languages };
+        if (!b.languages.includes(language))
+            b.languages = [...b.languages, language];
+        b.version += 1;
+        this.#audit(em, 'email_block.set_content', b.id, null, { language, version: b.version });
+        await em.flush();
+        return this.get(id);
+    }
+    async delete(id) {
+        const em = this.emFactory();
+        const b = await this.loadOrThrow(em, id);
+        if (b.isSystem)
+            throw new HttpError(409, ERROR_CODES.VALIDATION_FAILED, 'System blocks cannot be deleted.');
+        const bridges = await em.find(EmailBlockSalesChannel, { blockId: b.id });
+        this.#audit(em, 'email_block.delete', b.id, { code: b.code }, null);
+        await em.removeAndFlush([...bridges, b]);
+    }
+}
+//# sourceMappingURL=email-block.service.js.map

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

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

package/dist/backend/services/email-builder-registry.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Email page-builder descriptor (feature 047). The admin merges this with the
+ * bundled `defaultEmailBuilderConfig` from @endora-commerce/email-components to present an
+ * email-safe palette. Names are the single source of truth shared with the
+ * renderer and save-time validation.
+ */
+import type { EmailPageBuilderDescriptor } from '@endora-commerce/contracts';
+export declare function describeEmailBuilder(): EmailPageBuilderDescriptor;
+//# sourceMappingURL=email-builder-registry.d.ts.map

package/dist/backend/services/email-builder-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-builder-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/email-builder-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE7E,wBAAgB,oBAAoB,IAAI,0BAA0B,CAKjE"}

package/dist/backend/services/email-builder-registry.js

@@ -0,0 +1,14 @@
+/**
+ * Email page-builder descriptor (feature 047). The admin merges this with the
+ * bundled `defaultEmailBuilderConfig` from @endora-commerce/email-components to present an
+ * email-safe palette. Names are the single source of truth shared with the
+ * renderer and save-time validation.
+ */
+import { EMAIL_SAFE_COMPONENT_NAMES } from '@endora-commerce/email-components/schema/component-types';
+export function describeEmailBuilder() {
+    return {
+        schemaVersion: 1,
+        components: EMAIL_SAFE_COMPONENT_NAMES.map((name) => ({ name })),
+    };
+}
+//# sourceMappingURL=email-builder-registry.js.map

package/dist/backend/services/email-builder-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-builder-registry.js","sourceRoot":"","sources":["../../../src/backend/services/email-builder-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,0DAA0D,CAAC;AAGtG,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,0BAA0B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;KACjE,CAAC;AACJ,CAAC"}

package/dist/backend/services/email-defaults-registry.d.ts

@@ -0,0 +1,63 @@
+import type { EmailDefaults, EmailDefaultsRegistryPort } from '@endora-commerce/contracts';
+/**
+ * EmailDefaultsRegistry — feature 047 (R6).
+ *
+ * In-process registry where each owning module registers the default subject +
+ * content for the transactional emails it declares in its manifest. Kept out of
+ * the static manifest because content envelopes are large. The reconciler reads
+ * this at boot to seed `transactional_emails.default_*`.
+ */
+/**
+ * `EmailDefaults` moved to `@endora-commerce/contracts` in feature 075's Phase P — seven
+ * modules push one from their own boot hook, which makes it a boundary shape
+ * rather than an internal. Re-exported here for the length of Phase P, which
+ * cuts no consumer.
+ */
+export type { EmailDefaults };
+/**
+ * `implements` the shape Phase P published, which is what stops the registry
+ * and its contract drifting: seven modules read the published type, and `tsc`
+ * refuses the day a method here stops matching.
+ */
+export declare class EmailDefaultsRegistry implements EmailDefaultsRegistryPort {
+    private readonly byCode;
+    private readonly ownerByCode;
+    /**
+     * `ownerModuleId` is required since D-39: a contribution seam records who
+     * contributed, so the honour/skip question above has something to key on and
+     * so an entry can be attributed without guessing. It became required rather
+     * than optional because an optional owner makes "nobody stated a policy for
+     * this entry" indistinguishable from "this entry has no owner".
+     */
+    register(code: string, defaults: EmailDefaults, ownerModuleId: string): void;
+    ownerOf(code: string): string | undefined;
+    /** Every registered code with its contributing module — the owner ledger. */
+    owners(): ReadonlyMap<string, string>;
+    /**
+     * The owning module's sentence for why this email may not be switched off,
+     * or `null` when it may (issue #89).
+     *
+     * An **unregistered** code answers `null`, and that is not a fail-open: a
+     * definition row exists only because a module declared the code in its
+     * manifest, and a module that declares a protected email declares its
+     * defaults in the same boot hook. A code with no entry here is one nobody
+     * seeded content for — already the degenerate case, and switching it off
+     * changes nothing that was going to be delivered.
+     */
+    nonDeactivatableReasonOf(code: string): string | null;
+    get(code: string): EmailDefaults | undefined;
+    has(code: string): boolean;
+}
+/**
+ * Process-wide singleton, kept only for callers that have not moved to the
+ * container-scoped instance.
+ *
+ * **Prefer the `emailDefaultsPort` registration**, which `transactional_emails`
+ * provides per composition. This one is shared by every composition in a
+ * process — harmless for static content that every composition registers
+ * identically, but it means a module absent from one composition can still have
+ * its defaults present there, courtesy of another. With ~950 compositions in a
+ * test run that is a real, if benign, cross-composition leak.
+ */
+export declare const emailDefaultsRegistry: EmailDefaultsRegistry;
+//# sourceMappingURL=email-defaults-registry.d.ts.map

package/dist/backend/services/email-defaults-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-defaults-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/services/email-defaults-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC3F;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,yBAAyB;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAK5E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,6EAA6E;IAC7E,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAIrC;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

package/dist/backend/services/email-defaults-registry.js

@@ -0,0 +1,60 @@
+/**
+ * `implements` the shape Phase P published, which is what stops the registry
+ * and its contract drifting: seven modules read the published type, and `tsc`
+ * refuses the day a method here stops matching.
+ */
+export class EmailDefaultsRegistry {
+    byCode = new Map();
+    ownerByCode = new Map();
+    /**
+     * `ownerModuleId` is required since D-39: a contribution seam records who
+     * contributed, so the honour/skip question above has something to key on and
+     * so an entry can be attributed without guessing. It became required rather
+     * than optional because an optional owner makes "nobody stated a policy for
+     * this entry" indistinguishable from "this entry has no owner".
+     */
+    register(code, defaults, ownerModuleId) {
+        this.byCode.set(code, defaults);
+        this.ownerByCode.set(code, ownerModuleId);
+    }
+    ownerOf(code) {
+        return this.ownerByCode.get(code);
+    }
+    /** Every registered code with its contributing module — the owner ledger. */
+    owners() {
+        return new Map(this.ownerByCode);
+    }
+    /**
+     * The owning module's sentence for why this email may not be switched off,
+     * or `null` when it may (issue #89).
+     *
+     * An **unregistered** code answers `null`, and that is not a fail-open: a
+     * definition row exists only because a module declared the code in its
+     * manifest, and a module that declares a protected email declares its
+     * defaults in the same boot hook. A code with no entry here is one nobody
+     * seeded content for — already the degenerate case, and switching it off
+     * changes nothing that was going to be delivered.
+     */
+    nonDeactivatableReasonOf(code) {
+        return this.byCode.get(code)?.nonDeactivatable?.reason ?? null;
+    }
+    get(code) {
+        return this.byCode.get(code);
+    }
+    has(code) {
+        return this.byCode.has(code);
+    }
+}
+/**
+ * Process-wide singleton, kept only for callers that have not moved to the
+ * container-scoped instance.
+ *
+ * **Prefer the `emailDefaultsPort` registration**, which `transactional_emails`
+ * provides per composition. This one is shared by every composition in a
+ * process — harmless for static content that every composition registers
+ * identically, but it means a module absent from one composition can still have
+ * its defaults present there, courtesy of another. With ~950 compositions in a
+ * test run that is a real, if benign, cross-composition leak.
+ */
+export const emailDefaultsRegistry = new EmailDefaultsRegistry();
+//# sourceMappingURL=email-defaults-registry.js.map

package/dist/backend/services/email-defaults-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-defaults-registry.js","sourceRoot":"","sources":["../../../src/backend/services/email-defaults-registry.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IACf,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC1C,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAY,EAAE,QAAuB,EAAE,aAAqB;QACnE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,6EAA6E;IAC7E,MAAM;QACJ,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,IAAY;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,MAAM,IAAI,IAAI,CAAC;IACjE,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * EmailTemplateService — feature 047 (US3). CRUD for reusable email-safe
+ * templates. Same surface as EmailBlockService without an `active` flag.
+ */
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CreateEmailTemplateRequest, type EmailTemplateDetail, type EmailTemplateSummary, type PatchEmailTemplateRequest, type PutEmailBlockContentRequest } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+export declare class EmailTemplateService {
+    #private;
+    private readonly emFactory;
+    private readonly auditLog?;
+    constructor(emFactory: () => EntityManager, auditLog?: AuditPort | undefined);
+    private channelIds;
+    private summary;
+    list(salesChannelId?: string): Promise<EmailTemplateSummary[]>;
+    private loadOrThrow;
+    get(id: string): Promise<EmailTemplateDetail>;
+    create(req: CreateEmailTemplateRequest): Promise<EmailTemplateDetail>;
+    patch(id: string, req: PatchEmailTemplateRequest): Promise<EmailTemplateDetail>;
+    setContent(id: string, language: string, req: PutEmailBlockContentRequest): Promise<EmailTemplateDetail>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=email-template.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-template.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/email-template.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAMpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAalE,qBAAa,oBAAoB;;IAE7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBADT,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,CAAC,EAAE,SAAS,YAAA;YAqBzB,UAAU;YAKV,OAAO;IAaf,IAAI,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;YAetD,WAAW;IAMnB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAY7C,MAAM,CAAC,GAAG,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsBrE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoB/E,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAiBxG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQxC"}