@endora-commerce/email-components 0.100.0

package/dist/schema/component-types.d.ts

@@ -0,0 +1,269 @@
+export type EmailHeadingLevel = 'h1' | 'h2' | 'h3';
+export type EmailAlign = 'left' | 'center' | 'right';
+export interface EmailHeadingProps {
+    level: EmailHeadingLevel;
+    text: string;
+    align: EmailAlign;
+}
+export interface EmailTextProps {
+    /** Plain text; newlines become <br>. May contain {{var ...}} directives. */
+    text: string;
+    align: EmailAlign;
+}
+export interface EmailButtonProps {
+    label: string;
+    href: string;
+    align: EmailAlign;
+    backgroundColor: string;
+    textColor: string;
+}
+export interface EmailImageProps {
+    /** `url` = freeform `src`; `library` = assets library `assetId` (src synced to absolute URL in admin). */
+    imageSource?: 'url' | 'library';
+    src: string;
+    assetId?: string;
+    alt: string;
+    href: string;
+    width: number;
+    align: EmailAlign;
+}
+export interface EmailDividerProps {
+    /** Line thickness in px (1–8). */
+    thickness: number;
+    color: string;
+}
+export interface EmailSpacerProps {
+    height: number;
+}
+export interface EmailTableHeader {
+    label: string;
+}
+export interface EmailTableCell {
+    value: string;
+}
+export interface EmailTableRow {
+    cells: EmailTableCell[];
+}
+export interface EmailTableProps {
+    columns: EmailTableHeader[];
+    tableRows: EmailTableRow[];
+    striped: boolean;
+}
+export interface EmailInsertBlockProps {
+    code: string;
+}
+export interface EmailInsertTemplateProps {
+    code: string;
+}
+export interface EmailSectionProps {
+    backgroundColor: string;
+    paddingY: number;
+    paddingX: number;
+    /** Puck slot — nested email-safe nodes (also resolved from zones). */
+    content?: unknown;
+}
+export type EmailVerticalAlign = 'top' | 'middle' | 'bottom';
+/**
+ * Multi-column row for email — rendered as a fixed table (not responsive).
+ * Children must be {@link EmailColumn} nodes (Puck slot `allow`).
+ */
+export interface EmailRowProps {
+    /** Horizontal gap between columns (px); applied as cell padding in HTML. */
+    gap: number;
+    verticalAlign: EmailVerticalAlign;
+    content?: unknown;
+}
+/** A single column inside {@link EmailRow}; holds nested email-safe blocks. */
+export interface EmailColumnProps {
+    /** Width on a 12-column grid (canvas + HTML %). */
+    span: number;
+    content?: unknown;
+}
+/**
+ * Brand logo block. `src` is always the branding directive at send time;
+ * the admin canvas resolves the live logo URL from branding settings.
+ */
+export interface EmailLogoProps {
+    /** Persist as `{{var branding.logoUrl}}` — not author-edited. */
+    src: string;
+    alt: string;
+    href: string;
+    width: number;
+    align: EmailAlign;
+}
+export interface EmailRichTextProps {
+    /** TipTap JSON (editor round-trip). */
+    content: unknown;
+    /** Sanitized email-safe HTML; may contain {{var}} markers in text. */
+    html: string;
+    align: EmailAlign;
+}
+export interface EmailProductCardProps {
+    /** Catalog product slug (authoring picker). */
+    productSlug: string;
+    productId: string;
+    imageSrc: string;
+    title: string;
+    sku: string;
+    price: string;
+    href: string;
+    ctaLabel: string;
+    showImage: boolean;
+    showPrice: boolean;
+    showSku: boolean;
+    align: EmailAlign;
+}
+export interface EmailProductGridItem {
+    productId: string;
+    productSlug: string;
+    title: string;
+    sku: string;
+    price: string;
+    href: string;
+    imageSrc: string;
+}
+/** Multi-product table grid (email-safe; baked item snapshots at authoring time). */
+export interface EmailProductGridProps {
+    productSlugs: string[];
+    columns: number;
+    gap: number;
+    showImage: boolean;
+    showPrice: boolean;
+    showSku: boolean;
+    ctaLabel: string;
+    items: EmailProductGridItem[];
+}
+export interface EmailCategoryGridItem {
+    categoryId: string;
+    categorySlug: string;
+    title: string;
+    href: string;
+    imageSrc: string;
+}
+/** Multi-category table grid (email-safe; baked item snapshots at authoring time). */
+export interface EmailCategoryGridProps {
+    categorySlugs: string[];
+    columns: number;
+    gap: number;
+    showImage: boolean;
+    items: EmailCategoryGridItem[];
+}
+export interface EmailOrderSummaryProps {
+    /** Heading above the line items. */
+    title: string;
+    showSku: boolean;
+    showName: boolean;
+    showQuantity: boolean;
+    showPrice: boolean;
+    showTotals: boolean;
+    /** Outer spacing above the block (px). */
+    marginTop: number;
+    /** Outer spacing below the block (px). */
+    marginBottom: number;
+    /**
+     * @deprecated Prefer column toggles; kept for legacy trees.
+     * When set and no column flags are used, rendered as plain body.
+     */
+    body?: string;
+}
+/** Shared props for labeled order detail blocks (address, totals, methods, …). */
+export interface EmailOrderLabeledVarProps {
+    title: string;
+    /** Outer spacing above the block (px). */
+    marginTop: number;
+    /** Outer spacing below the block (px). */
+    marginBottom: number;
+}
+/** Default vertical rhythm for order detail blocks in the canvas / send HTML. */
+export declare const EMAIL_ORDER_BLOCK_MARGIN_DEFAULT = 12;
+/**
+ * Order-confirmation detail blocks → template variable they emit.
+ * Palette-gated via {@link EMAIL_COMPONENT_REQUIRED_VARIABLES}.
+ */
+export declare const EMAIL_ORDER_LABELED_FIELDS: {
+    readonly 'orders.EmailOrderId': {
+        readonly label: "Order ID";
+        readonly defaultTitle: "Order";
+        readonly varKey: "order.businessId";
+        readonly previewHint: "ORD-1042";
+    };
+    readonly 'orders.EmailBillingAddress': {
+        readonly label: "Billing address";
+        readonly defaultTitle: "Billing address";
+        readonly varKey: "order.billingAddressText";
+        readonly previewHint: "Acme Sp. z o.o.\nul. Główna 1";
+    };
+    readonly 'orders.EmailShippingAddress': {
+        readonly label: "Shipping address";
+        readonly defaultTitle: "Shipping address";
+        readonly varKey: "order.shippingAddressText";
+        readonly previewHint: "Anna Nowak\nul. Główna 1";
+    };
+    readonly 'orders.EmailOrderTotals': {
+        readonly label: "Summary";
+        readonly defaultTitle: "Summary";
+        readonly varKey: "order.summaryText";
+        readonly previewHint: "Suma częściowa: …\nVAT: …\nRazem: …";
+    };
+    readonly 'orders.EmailAppliedDiscounts': {
+        readonly label: "Applied discounts";
+        readonly defaultTitle: "Applied discounts";
+        readonly varKey: "order.discountsText";
+        readonly previewHint: "SUMMER10: -50,00 PLN";
+    };
+    readonly 'orders.EmailDeliveryMethod': {
+        readonly label: "Delivery method";
+        readonly defaultTitle: "Delivery method";
+        readonly varKey: "order.shippingLine";
+        readonly previewHint: "Courier — 15,00 PLN";
+    };
+    readonly 'orders.EmailPaymentMethod': {
+        readonly label: "Payment method";
+        readonly defaultTitle: "Payment method";
+        readonly varKey: "order.paymentLine";
+        readonly previewHint: "Card (+5,00 PLN)";
+    };
+};
+export type EmailOrderLabeledFieldName = keyof typeof EMAIL_ORDER_LABELED_FIELDS;
+export type EmailSocialNetwork = 'facebook' | 'instagram' | 'linkedin' | 'x' | 'youtube' | 'tiktok' | 'other';
+export interface EmailSocialLink {
+    network: EmailSocialNetwork;
+    href: string;
+    label?: string;
+    /** When false, the link is hidden. Default true. */
+    enabled?: boolean;
+}
+export interface EmailSocialProps {
+    links: EmailSocialLink[];
+    align: EmailAlign;
+    showIcons: boolean;
+    showLabels: boolean;
+    iconSize: number;
+    useBrandColors: boolean;
+    /** Used when useBrandColors is false. */
+    color: string;
+}
+export interface EmailCalloutProps {
+    text: string;
+    backgroundColor: string;
+    borderColor: string;
+    textColor: string;
+    align: EmailAlign;
+}
+export interface EmailFooterLegalProps {
+    text: string;
+    align: EmailAlign;
+}
+/**
+ * Canonical set of component names the email editor exposes and the renderer
+ * understands. Used by the admin palette and by backend save-time validation.
+ */
+export declare const EMAIL_SAFE_COMPONENT_NAMES: readonly ["transactional_emails.EmailHeading", "transactional_emails.EmailText", "transactional_emails.EmailButton", "transactional_emails.EmailImage", "transactional_emails.EmailDivider", "transactional_emails.EmailSpacer", "transactional_emails.EmailTable", "transactional_emails.EmailInsertBlock", "transactional_emails.EmailSection", "transactional_emails.EmailRow", "transactional_emails.EmailColumn", "transactional_emails.EmailLogo", "transactional_emails.EmailRichText", "catalog.EmailProductCard", "catalog.EmailProductGrid", "catalog.EmailCategoryGrid", "orders.EmailOrderSummary", "orders.EmailOrderId", "orders.EmailBillingAddress", "orders.EmailShippingAddress", "orders.EmailOrderTotals", "orders.EmailAppliedDiscounts", "orders.EmailDeliveryMethod", "orders.EmailPaymentMethod", "transactional_emails.EmailSocial", "transactional_emails.EmailCallout", "transactional_emails.EmailFooterLegal"];
+/**
+ * Palette components that only make sense when the email declares these variables.
+ * Used by the admin editor to hide commerce blocks outside their owning templates.
+ */
+export declare const EMAIL_COMPONENT_REQUIRED_VARIABLES: Readonly<Record<string, readonly string[]>>;
+export type EmailComponentName = (typeof EMAIL_SAFE_COMPONENT_NAMES)[number];
+export declare function isEmailSafeComponentName(name: string): name is EmailComponentName;
+//# sourceMappingURL=component-types.d.ts.map

package/dist/schema/component-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-types.d.ts","sourceRoot":"","sources":["../../src/schema/component-types.ts"],"names":[],"mappings":"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"}

package/dist/schema/component-types.js

@@ -0,0 +1,105 @@
+// Email-safe component prop shapes (feature 047 + email builder expansion).
+// Kept React-free so the pure backend renderer and the admin Puck editor share
+// one source of truth. Every component renders to table-based, inline-styled
+// HTML (no flexbox/grid/script).
+/** Default vertical rhythm for order detail blocks in the canvas / send HTML. */
+export const EMAIL_ORDER_BLOCK_MARGIN_DEFAULT = 12;
+/**
+ * Order-confirmation detail blocks → template variable they emit.
+ * Palette-gated via {@link EMAIL_COMPONENT_REQUIRED_VARIABLES}.
+ */
+export const EMAIL_ORDER_LABELED_FIELDS = {
+    'orders.EmailOrderId': {
+        label: 'Order ID',
+        defaultTitle: 'Order',
+        varKey: 'order.businessId',
+        previewHint: 'ORD-1042',
+    },
+    'orders.EmailBillingAddress': {
+        label: 'Billing address',
+        defaultTitle: 'Billing address',
+        varKey: 'order.billingAddressText',
+        previewHint: 'Acme Sp. z o.o.\nul. Główna 1',
+    },
+    'orders.EmailShippingAddress': {
+        label: 'Shipping address',
+        defaultTitle: 'Shipping address',
+        varKey: 'order.shippingAddressText',
+        previewHint: 'Anna Nowak\nul. Główna 1',
+    },
+    'orders.EmailOrderTotals': {
+        label: 'Summary',
+        defaultTitle: 'Summary',
+        varKey: 'order.summaryText',
+        previewHint: 'Suma częściowa: …\nVAT: …\nRazem: …',
+    },
+    'orders.EmailAppliedDiscounts': {
+        label: 'Applied discounts',
+        defaultTitle: 'Applied discounts',
+        varKey: 'order.discountsText',
+        previewHint: 'SUMMER10: -50,00 PLN',
+    },
+    'orders.EmailDeliveryMethod': {
+        label: 'Delivery method',
+        defaultTitle: 'Delivery method',
+        varKey: 'order.shippingLine',
+        previewHint: 'Courier — 15,00 PLN',
+    },
+    'orders.EmailPaymentMethod': {
+        label: 'Payment method',
+        defaultTitle: 'Payment method',
+        varKey: 'order.paymentLine',
+        previewHint: 'Card (+5,00 PLN)',
+    },
+};
+/**
+ * Canonical set of component names the email editor exposes and the renderer
+ * understands. Used by the admin palette and by backend save-time validation.
+ */
+export const EMAIL_SAFE_COMPONENT_NAMES = [
+    'transactional_emails.EmailHeading',
+    'transactional_emails.EmailText',
+    'transactional_emails.EmailButton',
+    'transactional_emails.EmailImage',
+    'transactional_emails.EmailDivider',
+    'transactional_emails.EmailSpacer',
+    'transactional_emails.EmailTable',
+    'transactional_emails.EmailInsertBlock',
+    'transactional_emails.EmailSection',
+    'transactional_emails.EmailRow',
+    'transactional_emails.EmailColumn',
+    'transactional_emails.EmailLogo',
+    'transactional_emails.EmailRichText',
+    'catalog.EmailProductCard',
+    'catalog.EmailProductGrid',
+    'catalog.EmailCategoryGrid',
+    'orders.EmailOrderSummary',
+    'orders.EmailOrderId',
+    'orders.EmailBillingAddress',
+    'orders.EmailShippingAddress',
+    'orders.EmailOrderTotals',
+    'orders.EmailAppliedDiscounts',
+    'orders.EmailDeliveryMethod',
+    'orders.EmailPaymentMethod',
+    'transactional_emails.EmailSocial',
+    'transactional_emails.EmailCallout',
+    'transactional_emails.EmailFooterLegal',
+];
+/**
+ * Palette components that only make sense when the email declares these variables.
+ * Used by the admin editor to hide commerce blocks outside their owning templates.
+ */
+export const EMAIL_COMPONENT_REQUIRED_VARIABLES = {
+    'orders.EmailOrderSummary': ['order.items'],
+    'orders.EmailOrderId': ['order.businessId'],
+    'orders.EmailBillingAddress': ['order.billingAddressText'],
+    'orders.EmailShippingAddress': ['order.shippingAddressText'],
+    'orders.EmailOrderTotals': ['order.summaryText'],
+    'orders.EmailAppliedDiscounts': ['order.discountsText'],
+    'orders.EmailDeliveryMethod': ['order.shippingLine'],
+    'orders.EmailPaymentMethod': ['order.paymentLine'],
+};
+export function isEmailSafeComponentName(name) {
+    return EMAIL_SAFE_COMPONENT_NAMES.includes(name);
+}
+//# sourceMappingURL=component-types.js.map

package/dist/schema/component-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-types.js","sourceRoot":"","sources":["../../src/schema/component-types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,iCAAiC;AA4MjC,iFAAiF;AACjF,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,qBAAqB,EAAE;QACrB,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,OAAO;QACrB,MAAM,EAAE,kBAAkB;QAC1B,WAAW,EAAE,UAAU;KACxB;IACD,4BAA4B,EAAE;QAC5B,KAAK,EAAE,iBAAiB;QACxB,YAAY,EAAE,iBAAiB;QAC/B,MAAM,EAAE,0BAA0B;QAClC,WAAW,EAAE,+BAA+B;KAC7C;IACD,6BAA6B,EAAE;QAC7B,KAAK,EAAE,kBAAkB;QACzB,YAAY,EAAE,kBAAkB;QAChC,MAAM,EAAE,2BAA2B;QACnC,WAAW,EAAE,0BAA0B;KACxC;IACD,yBAAyB,EAAE;QACzB,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,SAAS;QACvB,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE,qCAAqC;KACnD;IACD,8BAA8B,EAAE;QAC9B,KAAK,EAAE,mBAAmB;QAC1B,YAAY,EAAE,mBAAmB;QACjC,MAAM,EAAE,qBAAqB;QAC7B,WAAW,EAAE,sBAAsB;KACpC;IACD,4BAA4B,EAAE;QAC5B,KAAK,EAAE,iBAAiB;QACxB,YAAY,EAAE,iBAAiB;QAC/B,MAAM,EAAE,oBAAoB;QAC5B,WAAW,EAAE,qBAAqB;KACnC;IACD,2BAA2B,EAAE;QAC3B,KAAK,EAAE,gBAAgB;QACvB,YAAY,EAAE,gBAAgB;QAC9B,MAAM,EAAE,mBAAmB;QAC3B,WAAW,EAAE,kBAAkB;KAChC;CACO,CAAC;AA6CX;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,mCAAmC;IACnC,gCAAgC;IAChC,kCAAkC;IAClC,iCAAiC;IACjC,mCAAmC;IACnC,kCAAkC;IAClC,iCAAiC;IACjC,uCAAuC;IACvC,mCAAmC;IACnC,+BAA+B;IAC/B,kCAAkC;IAClC,gCAAgC;IAChC,oCAAoC;IACpC,0BAA0B;IAC1B,0BAA0B;IAC1B,2BAA2B;IAC3B,0BAA0B;IAC1B,qBAAqB;IACrB,4BAA4B;IAC5B,6BAA6B;IAC7B,yBAAyB;IACzB,8BAA8B;IAC9B,4BAA4B;IAC5B,2BAA2B;IAC3B,kCAAkC;IAClC,mCAAmC;IACnC,uCAAuC;CAC/B,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAgD;IAC7F,0BAA0B,EAAE,CAAC,aAAa,CAAC;IAC3C,qBAAqB,EAAE,CAAC,kBAAkB,CAAC;IAC3C,4BAA4B,EAAE,CAAC,0BAA0B,CAAC;IAC1D,6BAA6B,EAAE,CAAC,2BAA2B,CAAC;IAC5D,yBAAyB,EAAE,CAAC,mBAAmB,CAAC;IAChD,8BAA8B,EAAE,CAAC,qBAAqB,CAAC;IACvD,4BAA4B,EAAE,CAAC,oBAAoB,CAAC;IACpD,2BAA2B,EAAE,CAAC,mBAAmB,CAAC;CACnD,CAAC;AAIF,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAQ,0BAAgD,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/dist/schema/envelope.d.ts

@@ -0,0 +1,21 @@
+export declare const CURRENT_EMAIL_SCHEMA_VERSION: 1;
+/**
+ * A single Puck data tree as produced by the email editor for one language.
+ * Treated as opaque at this layer — Puck's actual type lives in
+ * `@measured/puck`; we round-trip the shape verbatim through the envelope.
+ */
+export type PuckDataTree = {
+    root?: {
+        props?: Record<string, unknown>;
+    };
+    content?: unknown[];
+    zones?: Record<string, unknown[]>;
+} & Record<string, unknown>;
+export interface EmailContentEnvelope {
+    /** Bumped only when the wire shape of a node changes. */
+    schema_version: number;
+    /** Per-language content trees keyed by BCP-47 language code. */
+    languages: Record<string, PuckDataTree>;
+}
+export declare function emptyEmailEnvelope(): EmailContentEnvelope;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/schema/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/schema/envelope.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;CACnC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED,wBAAgB,kBAAkB,IAAI,oBAAoB,CAEzD"}

package/dist/schema/envelope.js

@@ -0,0 +1,8 @@
+// Email content envelope (feature 047) — mirrors the CMS envelope shape so the
+// admin Puck editor produces the same wire format, but is owned here so the
+// backend never imports CMS internals (Constitution Principle I).
+export const CURRENT_EMAIL_SCHEMA_VERSION = 1;
+export function emptyEmailEnvelope() {
+    return { schema_version: CURRENT_EMAIL_SCHEMA_VERSION, languages: {} };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/schema/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/schema/envelope.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,kEAAkE;AAElE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC;AAoBvD,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AACzE,CAAC"}

package/dist/tree/walk-embeds.d.ts

@@ -0,0 +1,7 @@
+export declare function walkBlockEmbeds(tree: unknown): Set<string>;
+export declare function walkTemplateEmbeds(tree: unknown): Set<string>;
+/** Component type names present in the tree that are not in `knownNames`. */
+export declare function walkUnknownComponents(tree: unknown, knownNames: ReadonlySet<string>): Set<string>;
+/** Asset ids referenced anywhere in the tree (props whose key ends in `assetId`). */
+export declare function walkAssetIds(tree: unknown): Set<string>;
+//# sourceMappingURL=walk-embeds.d.ts.map

package/dist/tree/walk-embeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-embeds.d.ts","sourceRoot":"","sources":["../../src/tree/walk-embeds.ts"],"names":[],"mappings":"AA2EA,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAE1D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAE7D;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAQjG;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBvD"}

package/dist/tree/walk-embeds.js

@@ -0,0 +1,115 @@
+// Pure content-tree walkers (feature 047) — mirror the CMS content-tree-walker
+// for the email domain. Used to resolve block/template embeds before rendering
+// and to validate references / collect asset ids.
+/**
+ * TipTap authoring JSON lives on EmailRichText.props.content and uses node/mark
+ * types like `doc`, `paragraph`, `text`, `bold`. Those are not Puck components
+ * and must not be flagged by {@link walkUnknownComponents}.
+ */
+const TIPTAP_NODE_OR_MARK_TYPES = new Set([
+    'doc',
+    'paragraph',
+    'text',
+    'heading',
+    'bulletList',
+    'orderedList',
+    'listItem',
+    'hardBreak',
+    'horizontalRule',
+    'blockquote',
+    'codeBlock',
+    'image',
+    'bold',
+    'italic',
+    'underline',
+    'strike',
+    'code',
+    'link',
+]);
+function walk(node, visit) {
+    if (Array.isArray(node)) {
+        for (const child of node)
+            walk(child, visit);
+        return;
+    }
+    if (node && typeof node === 'object') {
+        const obj = node;
+        if (typeof obj['type'] === 'string')
+            visit(obj);
+        // EmailRichText.props.content is TipTap JSON — do not treat it as nested Puck.
+        if (obj['type'] === 'transactional_emails.EmailRichText') {
+            const props = obj['props'];
+            if (props && typeof props === 'object') {
+                for (const [key, value] of Object.entries(props)) {
+                    if (key === 'content')
+                        continue;
+                    if (value && typeof value === 'object')
+                        walk(value, visit);
+                }
+            }
+            for (const [key, value] of Object.entries(obj)) {
+                if (key === 'type' || key === 'props')
+                    continue;
+                if (value && typeof value === 'object')
+                    walk(value, visit);
+            }
+            return;
+        }
+        for (const value of Object.values(obj)) {
+            if (value && typeof value === 'object')
+                walk(value, visit);
+        }
+    }
+}
+function collectEmbedCodes(tree, typeName) {
+    const codes = new Set();
+    walk(tree, (n) => {
+        if (n.type === typeName && n.props && typeof n.props === 'object') {
+            const code = n.props['code'];
+            if (typeof code === 'string' && code.length > 0)
+                codes.add(code);
+        }
+    });
+    return codes;
+}
+export function walkBlockEmbeds(tree) {
+    return collectEmbedCodes(tree, 'transactional_emails.EmailInsertBlock');
+}
+export function walkTemplateEmbeds(tree) {
+    return collectEmbedCodes(tree, 'transactional_emails.EmailInsertTemplate');
+}
+/** Component type names present in the tree that are not in `knownNames`. */
+export function walkUnknownComponents(tree, knownNames) {
+    const unknown = new Set();
+    walk(tree, (n) => {
+        if (typeof n.type !== 'string')
+            return;
+        if (TIPTAP_NODE_OR_MARK_TYPES.has(n.type))
+            return;
+        if (!knownNames.has(n.type))
+            unknown.add(n.type);
+    });
+    return unknown;
+}
+/** Asset ids referenced anywhere in the tree (props whose key ends in `assetId`). */
+export function walkAssetIds(tree) {
+    const ids = new Set();
+    const visit = (node) => {
+        if (Array.isArray(node)) {
+            for (const c of node)
+                visit(c);
+            return;
+        }
+        if (node && typeof node === 'object') {
+            for (const [key, value] of Object.entries(node)) {
+                if (/assetId$/i.test(key) && typeof value === 'string' && value.length > 0)
+                    ids.add(value);
+                else if (value && typeof value === 'object')
+                    visit(value);
+            }
+        }
+    };
+    visit(tree);
+    return ids;
+}
+//# sourceMappingURL=walk-embeds.js.map

package/dist/tree/walk-embeds.js.map

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

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@endora-commerce/email-components",
+  "version": "0.100.0",
+  "type": "module",
+  "description": "Shared transactional-email building blocks (feature 047). Pure, React-free render/* + directives/* + tree/* + schema/* + defaults/* are imported by the backend to render email-client-safe HTML and plain text; the React components/* + config.ts power the admin's email-safe Puck editor. The split keeps React out of the backend send path (Principle I/IV).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/email-components"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./components/*": {
+      "types": "./dist/components/*.d.ts",
+      "default": "./dist/components/*.js"
+    },
+    "./tailwind.css": "./tailwind.css"
+  },
+  "files": [
+    "dist",
+    "tailwind.css"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "peerDependencies": {
+    "@measured/puck": "*",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@endora-commerce/page-builder-core": "^0.100.0"
+  },
+  "peerDependenciesMeta": {
+    "@measured/puck": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@measured/puck": "*",
+    "@types/react": "^19.2.14",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11",
+    "@endora-commerce/page-builder-core": "^0.100.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}

package/tailwind.css

@@ -0,0 +1,14 @@
+/* @endora-commerce/email-components — AUTO-GENERATED by `pnpm --filter backend run manifests:generate`.
+ *
+ * The `@source` directives this package asks its host to scan
+ * (`specs/110-instance-repository/contracts/admin-stylesheet-composition.md` R1).
+ * They resolve relative to **this file**, so they hold wherever the package is
+ * installed — a workspace link here, `node_modules` in a client's instance.
+ *
+ * The `dist` line is what a published tarball ships and is what an instance
+ * scans; the `src` line is inert there and is what keeps `pnpm --filter admin
+ * run dev` reading source in this repository. Do not edit: run
+ * `pnpm --filter backend run manifests:generate`.
+ */
+@source "./dist";
+@source "./src";