@endora-commerce/mod-transactional-emails 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-transactional-emails
+
+Admin-editable transactional email content and look (global + per sales channel), email-safe blocks/templates, variables, and preview.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `transactional_emails` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-transactional-emails` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-transactional-emails/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-transactional-emails/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-transactional-emails/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-transactional-emails/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/email-components`
+- `@endora-commerce/page-builder-admin` — *optional*
+- `@endora-commerce/page-builder-core`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@measured/puck` ^0 — *optional*
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+- `react-router-dom` ^7 — *optional*
+- `zod` ^4
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-transactional-emails
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/api/transactional-emails-client.d.ts

@@ -0,0 +1,43 @@
+import type { CreateEmailBlockRequest, CreateEmailTemplateRequest, EmailBlockDetail, EmailBlockSummary, EmailBranding, EmailPageBuilderDescriptor, EmailTemplateDetail, EmailTemplateSummary, PatchEmailBlockRequest, PatchEmailTemplateRequest, PreviewEmailResponse, PutEmailBlockContentRequest, PutEmailBrandingRequest, PutEmailContentRequest, ResolvedEmailContent, TransactionalEmailDetail, TransactionalEmailSummary } from '@endora-commerce/contracts';
+/** Typed admin client for the transactional_emails module (feature 047). */
+export declare const transactionalEmailsClient: {
+    pageBuilderConfig: () => Promise<EmailPageBuilderDescriptor>;
+    list: () => Promise<{
+        items: TransactionalEmailSummary[];
+    }>;
+    get: (code: string, salesChannelId: string | null, language?: string) => Promise<TransactionalEmailDetail>;
+    saveContent: (code: string, salesChannelId: string | null, language: string, body: PutEmailContentRequest) => Promise<ResolvedEmailContent>;
+    resetContent: (code: string, salesChannelId: string | null, language: string) => Promise<ResolvedEmailContent>;
+    /**
+     * Issue #89 — switch one email on or off. No optimistic update: the server's
+     * recomputed summary is what the list re-renders from, so a refusal or a
+     * protection the client did not know about cannot leave a stale toggle on
+     * screen.
+     */
+    setActive: (code: string, active: boolean) => Promise<TransactionalEmailSummary>;
+    preview: (code: string, body: {
+        salesChannelId?: string;
+        language?: string;
+        draftSubject?: string;
+        draftContent?: unknown;
+    }) => Promise<PreviewEmailResponse>;
+    branding: (salesChannelId: string | null) => Promise<EmailBranding>;
+    putBranding: (salesChannelId: string | null, body: PutEmailBrandingRequest) => Promise<EmailBranding>;
+    listBlocks: (salesChannelId?: string) => Promise<{
+        items: EmailBlockSummary[];
+    }>;
+    getBlock: (id: string) => Promise<EmailBlockDetail>;
+    createBlock: (body: CreateEmailBlockRequest) => Promise<EmailBlockDetail>;
+    patchBlock: (id: string, body: PatchEmailBlockRequest) => Promise<EmailBlockDetail>;
+    putBlockContent: (id: string, language: string, body: PutEmailBlockContentRequest) => Promise<EmailBlockDetail>;
+    deleteBlock: (id: string) => Promise<void>;
+    listTemplates: (salesChannelId?: string) => Promise<{
+        items: EmailTemplateSummary[];
+    }>;
+    getTemplate: (id: string) => Promise<EmailTemplateDetail>;
+    createTemplate: (body: CreateEmailTemplateRequest) => Promise<EmailTemplateDetail>;
+    patchTemplate: (id: string, body: PatchEmailTemplateRequest) => Promise<EmailTemplateDetail>;
+    putTemplateContent: (id: string, language: string, body: PutEmailBlockContentRequest) => Promise<EmailTemplateDetail>;
+    deleteTemplate: (id: string) => Promise<void>;
+};
+//# sourceMappingURL=transactional-emails-client.d.ts.map

package/dist/admin/api/transactional-emails-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactional-emails-client.d.ts","sourceRoot":"","sources":["../../../src/admin/api/transactional-emails-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EAEpB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,4BAA4B,CAAC;AAepC,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB;6BACb,OAAO,CAAC,0BAA0B,CAAC;gBAIhD,OAAO,CAAC;QAAE,KAAK,EAAE,yBAAyB,EAAE,CAAA;KAAE,CAAC;gBAG7C,MAAM,kBAAkB,MAAM,GAAG,IAAI,aAAa,MAAM,KAAG,OAAO,CAAC,wBAAwB,CAAC;wBAIhG,MAAM,kBACI,MAAM,GAAG,IAAI,YACnB,MAAM,QACV,sBAAsB,KAC3B,OAAO,CAAC,oBAAoB,CAAC;yBAQX,MAAM,kBAAkB,MAAM,GAAG,IAAI,YAAY,MAAM,KAAG,OAAO,CAAC,oBAAoB,CAAC;IAO5G;;;;;OAKG;sBACe,MAAM,UAAU,OAAO,KAAG,OAAO,CAAC,yBAAyB,CAAC;oBAStE,MAAM,QACN;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAClG,OAAO,CAAC,oBAAoB,CAAC;+BAIL,MAAM,GAAG,IAAI,KAAG,OAAO,CAAC,aAAa,CAAC;kCAEnC,MAAM,GAAG,IAAI,QAAQ,uBAAuB,KAAG,OAAO,CAAC,aAAa,CAAC;kCAIrE,MAAM,KAAG,OAAO,CAAC;QAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;mBAE/D,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAC;wBAE7B,uBAAuB,KAAG,OAAO,CAAC,gBAAgB,CAAC;qBAEtD,MAAM,QAAQ,sBAAsB,KAAG,OAAO,CAAC,gBAAgB,CAAC;0BAE3D,MAAM,YAAY,MAAM,QAAQ,2BAA2B,KAAG,OAAO,CAAC,gBAAgB,CAAC;sBAE3F,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;qCAIP,MAAM,KAAG,OAAO,CAAC;QAAE,KAAK,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;sBAElE,MAAM,KAAG,OAAO,CAAC,mBAAmB,CAAC;2BAEhC,0BAA0B,KAAG,OAAO,CAAC,mBAAmB,CAAC;wBAE5D,MAAM,QAAQ,yBAAyB,KAAG,OAAO,CAAC,mBAAmB,CAAC;6BAEjE,MAAM,YAAY,MAAM,QAAQ,2BAA2B,KAAG,OAAO,CAAC,mBAAmB,CAAC;yBAE9F,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;CAE5C,CAAC"}

package/dist/admin/api/transactional-emails-client.js

@@ -0,0 +1,47 @@
+import { apiClient } from '@endora-commerce/admin-kit/lib';
+const unwrap = (p) => p.then((r) => r.data);
+const BASE = '/api/v1/admin/transactional-emails';
+function scopeQs(salesChannelId, language) {
+    const params = new URLSearchParams();
+    if (salesChannelId)
+        params.set('salesChannelId', salesChannelId);
+    if (language)
+        params.set('language', language);
+    const s = params.toString();
+    return s ? `?${s}` : '';
+}
+/** Typed admin client for the transactional_emails module (feature 047). */
+export const transactionalEmailsClient = {
+    pageBuilderConfig: () => unwrap(apiClient.get(`${BASE}/page-builder/config`)),
+    // Definitions
+    list: () => unwrap(apiClient.get(BASE)),
+    get: (code, salesChannelId, language) => unwrap(apiClient.get(`${BASE}/${encodeURIComponent(code)}${scopeQs(salesChannelId, language)}`)),
+    saveContent: (code, salesChannelId, language, body) => unwrap(apiClient.put(`${BASE}/${encodeURIComponent(code)}/content${scopeQs(salesChannelId, language)}`, body)),
+    resetContent: (code, salesChannelId, language) => unwrap(apiClient.delete(`${BASE}/${encodeURIComponent(code)}/content${scopeQs(salesChannelId, language)}`)),
+    /**
+     * Issue #89 — switch one email on or off. No optimistic update: the server's
+     * recomputed summary is what the list re-renders from, so a refusal or a
+     * protection the client did not know about cannot leave a stale toggle on
+     * screen.
+     */
+    setActive: (code, active) => unwrap(apiClient.post(`${BASE}/${encodeURIComponent(code)}/activation`, { active })),
+    preview: (code, body) => unwrap(apiClient.post(`${BASE}/${encodeURIComponent(code)}/preview`, body)),
+    // Branding (read + write)
+    branding: (salesChannelId) => unwrap(apiClient.get(`${BASE}/branding${scopeQs(salesChannelId)}`)),
+    putBranding: (salesChannelId, body) => unwrap(apiClient.put(`${BASE}/branding${scopeQs(salesChannelId)}`, body)),
+    // Blocks
+    listBlocks: (salesChannelId) => unwrap(apiClient.get(`${BASE}/blocks${scopeQs(salesChannelId ?? null)}`)),
+    getBlock: (id) => unwrap(apiClient.get(`${BASE}/blocks/${encodeURIComponent(id)}`)),
+    createBlock: (body) => unwrap(apiClient.post(`${BASE}/blocks`, body)),
+    patchBlock: (id, body) => unwrap(apiClient.patch(`${BASE}/blocks/${encodeURIComponent(id)}`, body)),
+    putBlockContent: (id, language, body) => unwrap(apiClient.put(`${BASE}/blocks/${encodeURIComponent(id)}/content/${language}`, body)),
+    deleteBlock: (id) => apiClient.delete(`${BASE}/blocks/${encodeURIComponent(id)}`).then(() => undefined),
+    // Templates
+    listTemplates: (salesChannelId) => unwrap(apiClient.get(`${BASE}/templates${scopeQs(salesChannelId ?? null)}`)),
+    getTemplate: (id) => unwrap(apiClient.get(`${BASE}/templates/${encodeURIComponent(id)}`)),
+    createTemplate: (body) => unwrap(apiClient.post(`${BASE}/templates`, body)),
+    patchTemplate: (id, body) => unwrap(apiClient.patch(`${BASE}/templates/${encodeURIComponent(id)}`, body)),
+    putTemplateContent: (id, language, body) => unwrap(apiClient.put(`${BASE}/templates/${encodeURIComponent(id)}/content/${language}`, body)),
+    deleteTemplate: (id) => apiClient.delete(`${BASE}/templates/${encodeURIComponent(id)}`).then(() => undefined),
+};
+//# sourceMappingURL=transactional-emails-client.js.map

package/dist/admin/api/transactional-emails-client.js.map

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

package/dist/admin/components/BrandingPanel.d.ts

@@ -0,0 +1,10 @@
+export interface BrandingPanelProps {
+    /** null = global scope. */
+    salesChannelId: string | null;
+}
+/**
+ * Email branding editor (feature 047, US2). Logo (asset picker) + accent color,
+ * resolved and persisted per scope through the Settings-backed branding service.
+ */
+export declare function BrandingPanel({ salesChannelId }: BrandingPanelProps): React.ReactElement;
+//# sourceMappingURL=BrandingPanel.d.ts.map

package/dist/admin/components/BrandingPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandingPanel.d.ts","sourceRoot":"","sources":["../../../src/admin/components/BrandingPanel.tsx"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,cAAc,EAAE,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA6FxF"}

package/dist/admin/components/BrandingPanel.js

@@ -0,0 +1,58 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { AssetFieldPicker } from '@endora-commerce/admin-kit/components';
+import { useAuth } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Button, Card, CardContent, CardHeader, CardTitle, ColorPicker, Label } from '@endora-commerce/admin-kit/ui';
+import { toAbsoluteAssetUrl } from '@endora-commerce/admin-kit/lib';
+import { transactionalEmailsClient } from '../api/transactional-emails-client.js';
+/**
+ * Email branding editor (feature 047, US2). Logo (asset picker) + accent color,
+ * resolved and persisted per scope through the Settings-backed branding service.
+ */
+export function BrandingPanel({ salesChannelId }) {
+    const { hasPermission } = useAuth();
+    const canWrite = hasPermission('transactional_emails:write');
+    const [branding, setBranding] = useState(null);
+    const [logoAssetId, setLogoAssetId] = useState('');
+    const [accentColor, setAccentColor] = useState('');
+    const [error, setError] = useState(null);
+    const [notice, setNotice] = useState(null);
+    const [busy, setBusy] = useState(false);
+    useEffect(() => {
+        let live = true;
+        transactionalEmailsClient
+            .branding(salesChannelId)
+            .then((b) => {
+            if (!live)
+                return;
+            setBranding(b);
+            setLogoAssetId(b.logoAssetId);
+            setAccentColor(b.accentColor);
+        })
+            .catch((err) => {
+            if (live)
+                setError(err instanceof Error ? err.message : String(err));
+        });
+        return () => {
+            live = false;
+        };
+    }, [salesChannelId]);
+    const save = async () => {
+        setBusy(true);
+        setError(null);
+        setNotice(null);
+        try {
+            const updated = await transactionalEmailsClient.putBranding(salesChannelId, { logoAssetId, accentColor });
+            setBranding(updated);
+            setNotice('Branding saved.');
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    return (_jsxs(Card, { children: [_jsx(CardHeader, { children: _jsxs(CardTitle, { children: ["Branding ", salesChannelId ? '(channel)' : '(global)'] }) }), _jsxs(CardContent, { className: "space-y-4", children: [error ? (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })) : null, notice ? (_jsx(Alert, { children: _jsx(AlertDescription, { children: notice }) })) : null, _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { htmlFor: "te-logo", children: "Header logo" }), _jsx(AssetFieldPicker, { id: "te-logo", value: logoAssetId, onChange: setLogoAssetId, acceptMimePrefix: "image/", allowUpload: true, disabled: !canWrite, placeholder: "Select a logo from the Assets Library" }), branding?.logoUrl ? (_jsxs("p", { className: "text-xs text-muted-foreground", children: ["Resolved URL:", ' ', _jsx("span", { className: "font-mono", children: toAbsoluteAssetUrl(branding.logoUrl) })] })) : null] }), _jsxs("div", { className: "space-y-1", children: [_jsx(Label, { children: "Accent color" }), _jsx(ColorPicker, { value: accentColor, onChange: setAccentColor, label: "Accent color", customLabel: "Custom accent color", disabled: !canWrite })] }), _jsx(Button, { onClick: () => void save(), disabled: !canWrite || busy, children: "Save branding" })] })] }));
+}
+//# sourceMappingURL=BrandingPanel.js.map

package/dist/admin/components/BrandingPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandingPanel.js","sourceRoot":"","sources":["../../../src/admin/components/BrandingPanel.tsx"],"names":[],"mappings":"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"}

package/dist/admin/components/EmailEditorPane.d.ts

@@ -0,0 +1,7 @@
+import { type EmailEditorPaneProps } from '@endora-commerce/page-builder-admin/email';
+/**
+ * Transactional-emails editor pane — loads TE blocks for embeds,
+ * then delegates to the shared EmailEditorPane.
+ */
+export declare function EmailEditorPane(props: Omit<EmailEditorPaneProps, 'blockOptions' | 'embeds' | 'embedTrees' | 'builderContext'>): React.ReactElement;
+//# sourceMappingURL=EmailEditorPane.d.ts.map

package/dist/admin/components/EmailEditorPane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailEditorPane.d.ts","sourceRoot":"","sources":["../../../src/admin/components/EmailEditorPane.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,2CAA2C,CAAC;AAOnD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC,GAC7F,KAAK,CAAC,YAAY,CA6CpB"}

package/dist/admin/components/EmailEditorPane.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { EmailEditorPane as SharedEmailEditorPane, previewNode, } from '@endora-commerce/page-builder-admin/email';
+import { transactionalEmailsClient } from '../api/transactional-emails-client.js';
+function pickLanguageTree(content) {
+    return content['pl-PL'] ?? content['en-US'] ?? Object.values(content)[0] ?? null;
+}
+/**
+ * Transactional-emails editor pane — loads TE blocks for embeds,
+ * then delegates to the shared EmailEditorPane.
+ */
+export function EmailEditorPane(props) {
+    const [blockOptions, setBlockOptions] = useState([]);
+    const [embeds, setEmbeds] = useState({ blocks: {}, templates: {} });
+    const [embedTrees, setEmbedTrees] = useState({ blocks: {}, templates: {} });
+    useEffect(() => {
+        let live = true;
+        void (async () => {
+            const blockRes = await transactionalEmailsClient.listBlocks().catch(() => ({ items: [] }));
+            if (!live)
+                return;
+            setBlockOptions(blockRes.items.map((b) => ({ label: `${b.name} (${b.code})`, value: b.code })));
+            const blockPreviews = {};
+            const blockTrees = {};
+            await Promise.all(blockRes.items.map(async (b) => {
+                try {
+                    const detail = await transactionalEmailsClient.getBlock(b.id);
+                    const tree = pickLanguageTree(detail.content);
+                    if (tree)
+                        blockTrees[b.code] = tree;
+                    blockPreviews[b.code] = previewNode(detail.content);
+                }
+                catch {
+                    /* leave the code-only fallback */
+                }
+            }));
+            if (live) {
+                setEmbeds({ blocks: blockPreviews, templates: {} });
+                setEmbedTrees({ blocks: blockTrees, templates: {} });
+            }
+        })();
+        return () => {
+            live = false;
+        };
+    }, []);
+    return (_jsx(SharedEmailEditorPane, { ...props, builderContext: "email", blockOptions: blockOptions, embeds: embeds, embedTrees: embedTrees }));
+}
+//# sourceMappingURL=EmailEditorPane.js.map

package/dist/admin/components/EmailEditorPane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailEditorPane.js","sourceRoot":"","sources":["../../../src/admin/components/EmailEditorPane.tsx"],"names":[],"mappings":"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"}

package/dist/admin/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `transactional_emails`' admin surface — six routes and three sidebar
+ * entries, declared by the module that owns them (feature 091, Phase 4, batch
+ * 11; `specs/091-module-owned-admin-surfaces/contracts/admin-contribution.md`).
+ *
+ * **Its drain is zero, re-derived on this branch before anything moved**, on
+ * the same evidence as its batch partner: no shard in
+ * `backend/scripts/ledgers/cross-module-imports/`, no key in
+ * `admin-surface.ts`, none in `foreign-module-ids.ts`. The reaches the plan
+ * recorded were into `admin/src/modules/_shared/email-builder/`, and P5b made
+ * them stop existing rather than repairing them — they are bare specifiers
+ * into `@endora-commerce/page-builder-admin/email` now.
+ *
+ * **`EmailEditorPane` here is this module's own and wraps the package's.** The
+ * one in `components/` loads this module's blocks so the builder can offer
+ * them as embeds, then delegates; the generic pane it delegates to is the
+ * package's. Two names, one of them a thin adapter holding the module
+ * knowledge the package must not have.
+ *
+ * **Two route files exist only to carry an argument.** `App.tsx` wrote
+ * `element={<EmailFragmentEditor kind="block" />}` and its template twin; a
+ * contribution declaration has nowhere to put a prop, so
+ * `EmailBlockEditorPage` and `EmailTemplateEditorPage` hold the two lines the
+ * host used to. That is batch 10's `CredentialsNewPage` decision arriving
+ * twice.
+ *
+ * **One palette action is declared here for the first time** —
+ * `open-email-blocks`, replacing the hand-written `PALETTE_ITEMS` row this
+ * batch deletes, with the same destination, code and keywords.
+ * `open-transactional-emails` and `open-email-templates` were already declared
+ * and are untouched.
+ *
+ * **`nonDeactivatable`, so the operator axis is the platform's** (`plan.md`
+ * Ruling 2). The manifest says why in its own words — this module is the
+ * platform's only acknowledgement path to a buyer, and the granularity a
+ * business wants is the individual e-mail, which `EmailsList` is the screen
+ * for. The permission axis is what this module still has and is what the
+ * off-state test drives; the missing axis is read off the manifest rather than
+ * skipped.
+ *
+ * **This entry exports data and nothing else** (R2); every component is a
+ * dynamic-import factory (R6).
+ */
+import type { AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAoBnF,eAAO,MAAM,aAAa,EAAE,kBA2E3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,92 @@
+/** The module's landing route: the list of editable e-mails. */
+const ROUTE_PATH = '/transactional-emails';
+const BLOCKS_ROUTE = `${ROUTE_PATH}/blocks`;
+const TEMPLATES_ROUTE = `${ROUTE_PATH}/templates`;
+/**
+ * The one code every screen below needs to open.
+ *
+ * All eight `GET`s under `/api/v1/admin/transactional-emails` enforce it —
+ * the list, one e-mail, the blocks, the templates and the branding read — and
+ * every screen gates its own saves on `transactional_emails:write` through
+ * `useAuth().hasPermission`, which is the split the API already makes. It is
+ * the code the three hand-written sidebar rows carried and the code both
+ * declared palette actions carry.
+ */
+const READ_PERMISSION = 'transactional_emails:read';
+export const contributions = {
+    routes: [
+        {
+            path: ROUTE_PATH,
+            component: () => import('./pages/EmailsList.js'),
+            requiredPermission: READ_PERMISSION,
+            index: true,
+        },
+        {
+            path: BLOCKS_ROUTE,
+            component: () => import('./pages/EmailBlocksPage.js'),
+            requiredPermission: READ_PERMISSION,
+        },
+        {
+            path: `${BLOCKS_ROUTE}/:id`,
+            component: () => import('./pages/EmailBlockEditorPage.js'),
+            requiredPermission: READ_PERMISSION,
+        },
+        {
+            path: TEMPLATES_ROUTE,
+            component: () => import('./pages/EmailTemplatesPage.js'),
+            requiredPermission: READ_PERMISSION,
+        },
+        {
+            path: `${TEMPLATES_ROUTE}/:id`,
+            component: () => import('./pages/EmailTemplateEditorPage.js'),
+            requiredPermission: READ_PERMISSION,
+        },
+        {
+            // Declared last, and it is the one route here whose order used to be
+            // load-bearing: `/transactional-emails/:code` matches `/blocks` and
+            // `/templates` too. `<Routes>` ranks by specificity rather than by
+            // declaration order, so a static segment wins over a dynamic one — but
+            // the ordering is kept anyway, because a reader should not have to know
+            // that to see why the editor is safe here.
+            path: `${ROUTE_PATH}/:code`,
+            component: () => import('./pages/EmailEditor.js'),
+            requiredPermission: READ_PERMISSION,
+        },
+    ],
+    nav: [
+        {
+            to: ROUTE_PATH,
+            // Module-relative (R8), resolved in this module's own namespace out of
+            // `packages/modules/transactional_emails/i18n/`. It was
+            // `appShell.nav.transactionalEmails` in the shared `_i18n` bundle, one of
+            // the four shared files a module author had to edit.
+            labelKey: 'nav.transactionalEmails.label',
+            // The glyph `AppShell.tsx` rendered by hand for all three rows, and the
+            // one this module's `open-transactional-emails` action already names.
+            icon: 'Inbox',
+            section: 'messaging',
+            // The hand-written position times a hundred (batch four's convention).
+            // *Messaging* holds no host row once these three leave, so the weights
+            // are the whole order.
+            weight: 100,
+            requiredPermission: READ_PERMISSION,
+        },
+        {
+            to: BLOCKS_ROUTE,
+            labelKey: 'nav.emailBlocks.label',
+            icon: 'Inbox',
+            section: 'messaging',
+            weight: 200,
+            requiredPermission: READ_PERMISSION,
+        },
+        {
+            to: TEMPLATES_ROUTE,
+            labelKey: 'nav.emailTemplates.label',
+            icon: 'Inbox',
+            section: 'messaging',
+            weight: 300,
+            requiredPermission: READ_PERMISSION,
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AA6CA,gEAAgE;AAChE,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAE3C,MAAM,YAAY,GAAG,GAAG,UAAU,SAAS,CAAC;AAC5C,MAAM,eAAe,GAAG,GAAG,UAAU,YAAY,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAEpD,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uBAAuB,CAAC;YAChD,kBAAkB,EAAE,eAAe;YACnC,KAAK,EAAE,IAAI;SACZ;QACD;YACE,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC;YACrD,kBAAkB,EAAE,eAAe;SACpC;QACD;YACE,IAAI,EAAE,GAAG,YAAY,MAAM;YAC3B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,iCAAiC,CAAC;YAC1D,kBAAkB,EAAE,eAAe;SACpC;QACD;YACE,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,+BAA+B,CAAC;YACxD,kBAAkB,EAAE,eAAe;SACpC;QACD;YACE,IAAI,EAAE,GAAG,eAAe,MAAM;YAC9B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oCAAoC,CAAC;YAC7D,kBAAkB,EAAE,eAAe;SACpC;QACD;YACE,qEAAqE;YACrE,oEAAoE;YACpE,mEAAmE;YACnE,uEAAuE;YACvE,wEAAwE;YACxE,2CAA2C;YAC3C,IAAI,EAAE,GAAG,UAAU,QAAQ;YAC3B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wBAAwB,CAAC;YACjD,kBAAkB,EAAE,eAAe;SACpC;KACF;IACD,GAAG,EAAE;QACH;YACE,EAAE,EAAE,UAAU;YACd,uEAAuE;YACvE,wDAAwD;YACxD,0EAA0E;YAC1E,qDAAqD;YACrD,QAAQ,EAAE,+BAA+B;YACzC,wEAAwE;YACxE,sEAAsE;YACtE,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,WAAW;YACpB,uEAAuE;YACvE,uEAAuE;YACvE,uBAAuB;YACvB,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,eAAe;SACpC;QACD;YACE,EAAE,EAAE,YAAY;YAChB,QAAQ,EAAE,uBAAuB;YACjC,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,eAAe;SACpC;QACD;YACE,EAAE,EAAE,eAAe;YACnB,QAAQ,EAAE,0BAA0B;YACpC,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,GAAG;YACX,kBAAkB,EAAE,eAAe;SACpC;KACF;CACF,CAAC"}

package/dist/admin/pages/EmailBlockEditorPage.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+/**
+ * `/transactional-emails/blocks/:id` — the fragment editor, opened on a
+ * **block** (feature 047 US3; feature 091, Phase 4, batch 11).
+ *
+ * A file rather than a prop on the declaration, for `CredentialsNewPage`'s
+ * reason (batch 10): `AdminRouteDeclaration.component` is a factory returning a
+ * module and reads its `default`, so there is nowhere in the declaration to put
+ * an argument, and adding one would be a props channel the registry has to
+ * interpret for every module. `App.tsx` wrote
+ * `element={<EmailFragmentEditor kind="block" />}` here — the same two lines,
+ * with the host holding them.
+ */
+export declare function EmailBlockEditorPage(): ReactNode;
+export default EmailBlockEditorPage;
+//# sourceMappingURL=EmailBlockEditorPage.d.ts.map

package/dist/admin/pages/EmailBlockEditorPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailBlockEditorPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/EmailBlockEditorPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,CAEhD;AAED,eAAe,oBAAoB,CAAC"}

package/dist/admin/pages/EmailBlockEditorPage.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { EmailFragmentEditor } from './EmailFragmentEditor.js';
+/**
+ * `/transactional-emails/blocks/:id` — the fragment editor, opened on a
+ * **block** (feature 047 US3; feature 091, Phase 4, batch 11).
+ *
+ * A file rather than a prop on the declaration, for `CredentialsNewPage`'s
+ * reason (batch 10): `AdminRouteDeclaration.component` is a factory returning a
+ * module and reads its `default`, so there is nowhere in the declaration to put
+ * an argument, and adding one would be a props channel the registry has to
+ * interpret for every module. `App.tsx` wrote
+ * `element={<EmailFragmentEditor kind="block" />}` here — the same two lines,
+ * with the host holding them.
+ */
+export function EmailBlockEditorPage() {
+    return _jsx(EmailFragmentEditor, { kind: "block" });
+}
+export default EmailBlockEditorPage;
+//# sourceMappingURL=EmailBlockEditorPage.js.map

package/dist/admin/pages/EmailBlockEditorPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailBlockEditorPage.js","sourceRoot":"","sources":["../../../src/admin/pages/EmailBlockEditorPage.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAC,mBAAmB,IAAC,IAAI,EAAC,OAAO,GAAG,CAAC;AAC9C,CAAC;AAED,eAAe,oBAAoB,CAAC"}

package/dist/admin/pages/EmailBlocksPage.d.ts

@@ -0,0 +1,8 @@
+export declare function EmailBlocksPage(): React.ReactElement;
+/**
+ * The registry loads a route component through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013). The named export stays: it is
+ * the spelling this module's own code and its tests use.
+ */
+export default EmailBlocksPage;
+//# sourceMappingURL=EmailBlocksPage.d.ts.map

package/dist/admin/pages/EmailBlocksPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailBlocksPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/EmailBlocksPage.tsx"],"names":[],"mappings":"AAOA,wBAAgB,eAAe,IAAI,KAAK,CAAC,YAAY,CAuGpD;AAED;;;;GAIG;AACH,eAAe,eAAe,CAAC"}

package/dist/admin/pages/EmailBlocksPage.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Link } from 'react-router-dom';
+import { useAuth } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Button, Card, CardContent, Input, PageHeader } from '@endora-commerce/admin-kit/ui';
+import { transactionalEmailsClient } from '../api/transactional-emails-client.js';
+export function EmailBlocksPage() {
+    const { hasPermission } = useAuth();
+    const canWrite = hasPermission('transactional_emails:write');
+    const [items, setItems] = useState([]);
+    const [error, setError] = useState(null);
+    const [code, setCode] = useState('');
+    const [name, setName] = useState('');
+    const reload = () => {
+        transactionalEmailsClient
+            .listBlocks()
+            .then((res) => setItems(res.items))
+            .catch((err) => setError(err instanceof Error ? err.message : String(err)));
+    };
+    useEffect(reload, []);
+    const create = async () => {
+        setError(null);
+        try {
+            await transactionalEmailsClient.createBlock({ code, name, languages: ['en-US', 'pl-PL'] });
+            setCode('');
+            setName('');
+            reload();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+    };
+    const remove = async (id) => {
+        if (!window.confirm('Delete this block?'))
+            return;
+        try {
+            await transactionalEmailsClient.deleteBlock(id);
+            reload();
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+    };
+    if (!hasPermission('transactional_emails:read')) {
+        return (_jsx(Alert, { children: _jsx(AlertDescription, { children: "You do not have permission to view email blocks." }) }));
+    }
+    return (_jsxs("div", { className: "space-y-4", children: [_jsx(PageHeader, { title: "Email Blocks", description: "Reusable email-safe blocks (e.g. header, footer)." }), error ? (_jsx(Alert, { variant: "destructive", children: _jsx(AlertDescription, { children: error }) })) : null, canWrite ? (_jsx(Card, { children: _jsxs(CardContent, { className: "flex flex-wrap items-end gap-3 pt-6", children: [_jsx(Input, { placeholder: "code", value: code, onChange: (e) => setCode(e.target.value), className: "max-w-[200px]" }), _jsx(Input, { placeholder: "name", value: name, onChange: (e) => setName(e.target.value), className: "max-w-[240px]" }), _jsx(Button, { onClick: () => void create(), disabled: !code || !name, children: "Create block" })] }) })) : null, _jsx(Card, { children: _jsx(CardContent, { className: "p-0", children: _jsxs("table", { className: "w-full text-sm", children: [_jsx("thead", { className: "border-b text-left text-muted-foreground", children: _jsxs("tr", { children: [_jsx("th", { className: "p-3 font-medium", children: "Name" }), _jsx("th", { className: "p-3 font-medium", children: "Code" }), _jsx("th", { className: "p-3 font-medium", children: "Scope" }), _jsx("th", { className: "p-3 font-medium", children: "System" }), _jsx("th", { className: "p-3" })] }) }), _jsx("tbody", { children: items.map((b) => (_jsxs("tr", { className: "border-b last:border-0", children: [_jsx("td", { className: "p-3", children: _jsx(Link, { className: "font-medium text-primary hover:underline", to: `/transactional-emails/blocks/${b.id}`, children: b.name }) }), _jsx("td", { className: "p-3 font-mono text-xs", children: b.code }), _jsx("td", { className: "p-3", children: b.scope }), _jsx("td", { className: "p-3", children: b.isSystem ? 'Yes' : '—' }), _jsx("td", { className: "p-3 text-right", children: canWrite && !b.isSystem ? (_jsx(Button, { variant: "outline", size: "sm", onClick: () => void remove(b.id), children: "Delete" })) : null })] }, b.id))) })] }) }) })] }));
+}
+/**
+ * The registry loads a route component through a dynamic-import factory and
+ * reads its default export (feature 091, FR-013). The named export stays: it is
+ * the spelling this module's own code and its tests use.
+ */
+export default EmailBlocksPage;
+//# sourceMappingURL=EmailBlocksPage.js.map

package/dist/admin/pages/EmailBlocksPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailBlocksPage.js","sourceRoot":"","sources":["../../../src/admin/pages/EmailBlocksPage.tsx"],"names":[],"mappings":"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"}