includio-cms 0.28.0 → 0.33.0

package/dist/core/index.d.ts

@@ -1,5 +1,3 @@
-export { getCMS } from './cms.js';
-export { resolveMediaWithStyles, type ResolvedMedia } from './server/fields/utils/resolveMedia.js';
 export { resolveSeo, type ResolvedSeo } from './fields/resolveSeo.js';
-export { createEntityAPI } from '../entity/index.js';
-export { getAuth } from '../server/auth.js';
+export { getMailer, sendMail } from './cms.js';
+export type { EmailAdapter, SendMailOptions } from '../types/adapters/email.js';

package/dist/core/index.js

@@ -1,5 +1,2 @@
-export { getCMS } from './cms.js';
-export { resolveMediaWithStyles } from './server/fields/utils/resolveMedia.js';
 export { resolveSeo } from './fields/resolveSeo.js';
-export { createEntityAPI } from '../entity/index.js';
-export { getAuth } from '../server/auth.js';
+export { getMailer, sendMail } from './cms.js';

package/dist/core/server/index.d.ts

@@ -1 +1,4 @@
-export {};
+export { getCMS } from '../cms.js';
+export { resolveMediaWithStyles, type ResolvedMedia } from './fields/utils/resolveMedia.js';
+export { createEntityAPI } from '../../entity/index.js';
+export { getAuth } from '../../server/auth.js';

package/dist/core/server/index.js

@@ -1 +1,4 @@
-"use strict";
+export { getCMS } from '../cms.js';
+export { resolveMediaWithStyles } from './fields/utils/resolveMedia.js';
+export { createEntityAPI } from '../../entity/index.js';
+export { getAuth } from '../../server/auth.js';

package/dist/db-postgres/schema/shop/order.d.ts

@@ -565,6 +565,40 @@ export declare const shopOrdersTable: import("drizzle-orm/pg-core/table", { with
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        deletedAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "deleted_at";
+            tableName: "shop_orders";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deletedBy: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
+            name: "deleted_by";
+            tableName: "shop_orders";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core", { with: { "resolution-mode": "require" } }).PgColumn<{
             name: "created_at";
             tableName: "shop_orders";

package/dist/db-postgres/schema/shop/order.js

@@ -35,6 +35,10 @@ export const shopOrdersTable = pgTable('shop_orders', {
     accessToken: uuid('access_token').defaultRandom().notNull(),
     partialPayment: jsonb('partial_payment').$type(),
     balanceOwed: boolean('balance_owed').default(false).notNull(),
+    // Soft-delete: admin can hide an order from the admin list without losing
+    // the row (accounting/audit safety). NULL = visible. See softDeleteOrder.
+    deletedAt: timestamp('deleted_at', { withTimezone: true }),
+    deletedBy: text('deleted_by'),
     createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull()
 });

package/dist/shop/adapters/fakturownia/client.d.ts

@@ -23,6 +23,11 @@ export declare class FakturowniaClient {
     constructor(opts: FakturowniaClientOptions);
     createInvoice(invoice: FakturowniaInvoiceBody): Promise<FakturowniaInvoice>;
     sendByEmail(id: number | string): Promise<void>;
+    /**
+     * Read-only account lookup — used for connectivity/auth health checks.
+     * Does NOT create or modify anything. A 200 means domain + token are valid.
+     */
+    getAccount(): Promise<unknown>;
     private postRaw;
     private post;
 }

package/dist/shop/adapters/fakturownia/client.js

@@ -40,6 +40,26 @@ export class FakturowniaClient {
             api_token: this.apiToken
         });
     }
+    /**
+     * Read-only account lookup — used for connectivity/auth health checks.
+     * Does NOT create or modify anything. A 200 means domain + token are valid.
+     */
+    async getAccount() {
+        const res = await this.fetchFn(`${this.base}/account.json?api_token=${encodeURIComponent(this.apiToken)}`, { headers: { Accept: 'application/json' } });
+        if (!res.ok) {
+            let body;
+            try {
+                body = await res.json();
+            }
+            catch {
+                body = await res.text().catch(() => undefined);
+            }
+            const raw = body == null ? '' : typeof body === 'string' ? body : JSON.stringify(body);
+            const detail = raw ? `: ${raw.slice(0, 400)}` : '';
+            throw new FakturowniaApiError(`Fakturownia /account.json → ${res.status}${detail}`, res.status, body);
+        }
+        return res.json();
+    }
     async postRaw(path, payload) {
         const res = await this.fetchFn(`${this.base}${path}`, {
             method: 'POST',

package/dist/shop/adapters/fakturownia/index.js

@@ -32,5 +32,16 @@ export function fakturowniaAdapter(opts) {
             await client.sendByEmail(externalId);
         };
     }
+    adapter.healthCheck = async () => {
+        // Read-only /account.json lookup — verifies domain + token without
+        // issuing an invoice.
+        try {
+            await client.getAccount();
+            return { ok: true };
+        }
+        catch (e) {
+            return { ok: false, message: e instanceof Error ? e.message : String(e) };
+        }
+    };
     return adapter;
 }

package/dist/shop/adapters/payu/index.js

@@ -99,6 +99,17 @@ export function payuAdapter(opts) {
                 amount: input.amount ?? 0,
                 raw: result.raw
             };
+        },
+        async healthCheck() {
+            // OAuth client_credentials token fetch — reaches PayU and verifies
+            // posId/clientId/clientSecret without creating an order.
+            try {
+                await client.getAccessToken();
+                return { ok: true };
+            }
+            catch (e) {
+                return { ok: false, message: e instanceof Error ? e.message : String(e) };
+            }
         }
     };
 }

package/dist/shop/index.d.ts

@@ -12,5 +12,5 @@ export type { InpostAdapterOptions, InpostSenderAddress, GeowidgetConfigPreset,
 export { fakturowniaAdapter } from './adapters/fakturownia/index.js';
 export type { FakturowniaAdapterOptions } from './adapters/fakturownia/index.js';
 export { isValidNip } from './nip.js';
-export type { ShopConfig, ResolvedShopConfig, Currency, OrderStatus, PaymentAdapter, PaymentCreateContext, PaymentRefundInput, PaymentRefundResult, CarrierAdapter, CarrierEvent, ShipmentCreateInput, ShipmentCreateResult, ShipmentLabel, ConsentConfig, ShopFeatures, PaymentCreateResult, PaymentEvent, OrderRef, CouponRef, I18nText, VariantAttribute, VariantAttributeText, VariantAttributeNumber, VariantAttributeDatetime, VariantAttributeSelect, VariantAttributeBoolean, VariantAttributeImage, VariantAttributeEntry, VariantAttributeSlug, VariantLabelConfig, VariantExpiryConfig, PaymentPolicy, DepositAmount, PartialPayment, InvoicingAdapter, InvoiceIssuePolicy, InvoiceBuyer, InvoiceLineItem, InvoicePayload, InvoiceCreateResult, InvoiceContext } from './types.js';
+export type { ShopConfig, ResolvedShopConfig, Currency, Order, OrderStatus, PaymentAdapter, PaymentCreateContext, PaymentRefundInput, PaymentRefundResult, CarrierAdapter, CarrierEvent, ShipmentCreateInput, ShipmentCreateResult, ShipmentLabel, ConsentConfig, ShopFeatures, PaymentCreateResult, PaymentEvent, OrderRef, CouponRef, I18nText, VariantAttribute, VariantAttributeText, VariantAttributeNumber, VariantAttributeDatetime, VariantAttributeSelect, VariantAttributeBoolean, VariantAttributeImage, VariantAttributeEntry, VariantAttributeSlug, VariantLabelConfig, VariantExpiryConfig, PaymentPolicy, DepositAmount, PartialPayment, InvoicingAdapter, InvoiceIssuePolicy, InvoiceBuyer, InvoiceLineItem, InvoicePayload, InvoiceCreateResult, InvoiceContext } from './types.js';
 export { interpolateTemplate } from './template.js';

package/dist/shop/server/coupons.d.ts

@@ -51,3 +51,13 @@ export declare function recordCouponRedemption(input: {
  * row commits.
  */
 export declare function releaseCouponSlot(couponId: string): Promise<void>;
+/**
+ * Read the coupon applied to an order (if any), via the redemption row.
+ * Returns `null` when the order had no coupon or the redemption row is missing.
+ * Safe to call from email/admin/storefront — uses the same authoritative
+ * `shop_coupon_redemptions` table that `recordCouponRedemption` writes to.
+ */
+export declare function getOrderCoupon(orderId: string): Promise<{
+    code: string;
+    discountAmount: number;
+} | null>;

package/dist/shop/server/coupons.js

@@ -115,3 +115,22 @@ export async function releaseCouponSlot(couponId) {
     })
         .where(eq(shopCouponsTable.id, couponId));
 }
+/**
+ * Read the coupon applied to an order (if any), via the redemption row.
+ * Returns `null` when the order had no coupon or the redemption row is missing.
+ * Safe to call from email/admin/storefront — uses the same authoritative
+ * `shop_coupon_redemptions` table that `recordCouponRedemption` writes to.
+ */
+export async function getOrderCoupon(orderId) {
+    const db = getShopDb();
+    const [row] = await db
+        .select({
+        code: shopCouponsTable.code,
+        discountAmount: shopCouponRedemptionsTable.discountAmount
+    })
+        .from(shopCouponRedemptionsTable)
+        .innerJoin(shopCouponsTable, eq(shopCouponRedemptionsTable.couponId, shopCouponsTable.id))
+        .where(eq(shopCouponRedemptionsTable.orderId, orderId))
+        .limit(1);
+    return row ?? null;
+}

package/dist/shop/server/email.d.ts

@@ -1,11 +1,15 @@
 import type { OrderStatus } from '../types.js';
+/**
+ * List of template names a shop install must ship in `dist/shop/templates/`.
+ * Consumed by `validateBuiltinTemplates` at CMS bootstrap.
+ * @internal
+ */
+export declare const REQUIRED_TEMPLATE_NAMES: readonly string[];
 export declare function sendOrderStatusEmail(orderId: string, status: OrderStatus): Promise<void>;
 /**
  * Notify the shop admin that a product crossed its low-stock threshold.
  * Fire-and-forget — silently no-ops when no `shop.adminEmail` or no email
- * adapter is configured. Stays inside email.ts to keep the adapter call
- * site centralised (HTML, escaping, logging behaviour identical to status
- * emails).
+ * adapter is configured.
  *
  * @internal
  */

package/dist/shop/server/email.js

@@ -1,19 +1,10 @@
 import { getCMS } from '../../core/cms.js';
 import { resolveI18n } from '../pricing.js';
 import { getOrderById, getOrderItems } from './orders.js';
+import { getOrderCoupon } from './coupons.js';
 import { requireShopConfig } from './db.js';
 import { buildOrderViewUrl } from './order-access-url.js';
-const TRACKING_LABEL = {
-    pl: { label: 'Numer śledzenia', linkLabel: 'Sprawdź status przesyłki ↗' },
-    en: { label: 'Tracking number', linkLabel: 'Track your shipment ↗' }
-};
-function formatPrice(cents, currency) {
-    return new Intl.NumberFormat('pl-PL', {
-        style: 'currency',
-        currency,
-        minimumFractionDigits: 2
-    }).format(cents / 100);
-}
+import { renderEmailTemplate } from './emailTemplateRegistry.js';
 const STATUS_SUBJECTS = {
     new: { pl: 'Zamówienie przyjęte', en: 'Order received' },
     awaitingPayment: { pl: 'Oczekiwanie na płatność', en: 'Awaiting payment' },
@@ -25,92 +16,41 @@ const STATUS_SUBJECTS = {
     paymentRejected: { pl: 'Płatność odrzucona', en: 'Payment rejected' },
     refunded: { pl: 'Zamówienie zwrócone', en: 'Order refunded' }
 };
-const STATUS_INTRO = {
-    new: {
-        pl: 'Dziękujemy! Otrzymaliśmy Twoje zamówienie i wkrótce je przetworzymy.',
-        en: 'Thanks! We received your order and will process it shortly.'
-    },
-    awaitingPayment: {
-        pl: 'Otrzymaliśmy zamówienie. Czekamy na płatność zgodnie z wybraną metodą.',
-        en: 'Your order has been placed. Waiting for payment per the chosen method.'
-    },
-    paid: {
-        pl: 'Płatność została zaksięgowana. Przekazujemy zamówienie do realizacji.',
-        en: 'Payment has been received. Your order is moving to fulfilment.'
-    },
-    preparing: {
-        pl: 'Twoje zamówienie jest pakowane.',
-        en: 'Your order is being prepared.'
-    },
-    sent: {
-        pl: 'Zamówienie zostało wysłane.',
-        en: 'Your order has been shipped.'
-    },
-    done: {
-        pl: 'Zamówienie zostało zakończone. Dziękujemy za zakupy!',
-        en: 'Your order is complete. Thanks for shopping with us!'
-    },
-    cancelled: {
-        pl: 'Zamówienie zostało anulowane.',
-        en: 'Your order has been cancelled.'
-    },
-    paymentRejected: {
-        pl: 'Płatność nie została zaksięgowana. Skontaktuj się z nami w razie pytań.',
-        en: 'Payment was not received. Please contact us if you have questions.'
-    },
-    refunded: {
-        pl: 'Środki zostały zwrócone. Powinny pojawić się na koncie w ciągu kilku dni roboczych.',
-        en: 'Your refund has been issued. It should reach your account within a few business days.'
-    }
+const STATUS_TO_TEMPLATE = {
+    new: 'order-received',
+    awaitingPayment: 'awaiting-payment',
+    paid: 'payment-received',
+    preparing: 'preparing',
+    sent: 'shipped',
+    done: 'order-completed',
+    cancelled: 'cancelled',
+    paymentRejected: 'payment-rejected',
+    refunded: 'refunded'
+};
+const TRACKING_LABEL = {
+    pl: { label: 'Numer śledzenia', linkLabel: 'Sprawdź status przesyłki ↗' },
+    en: { label: 'Tracking number', linkLabel: 'Track your shipment ↗' }
 };
 const VIEW_LINK_LABEL = {
     pl: 'Zobacz zamówienie',
     en: 'View order'
 };
-function renderHtml(ctx, intro) {
-    const itemsRows = ctx.items
-        .map((i) => `<tr><td style="padding:6px 8px;border-bottom:1px solid #eee;">${escapeHtml(i.name)}</td><td style="padding:6px 8px;border-bottom:1px solid #eee;text-align:center;">${i.qty}</td><td style="padding:6px 8px;border-bottom:1px solid #eee;text-align:right;">${i.lineGross}</td></tr>`)
-        .join('');
-    return `<!doctype html>
-<html><body style="margin:0;padding:0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif;background:#f5f5f8;color:#1a1a2e;">
-<div style="max-width:560px;margin:0 auto;padding:24px;">
-  <div style="background:#fff;border-radius:12px;padding:28px;">
-    <h1 style="font-size:20px;font-weight:800;margin:0 0 8px;">Zamówienie ${escapeHtml(ctx.order.number)}</h1>
-    <p style="margin:0 0 20px;color:#555566;line-height:1.5;">${escapeHtml(intro)}</p>
-    <table style="width:100%;border-collapse:collapse;font-size:14px;">
-      <thead><tr style="background:#f4f2fa;"><th align="left" style="padding:8px;">Pozycja</th><th style="padding:8px;">Ilość</th><th align="right" style="padding:8px;">Suma</th></tr></thead>
-      <tbody>${itemsRows}</tbody>
-    </table>
-    <div style="margin-top:16px;text-align:right;font-size:14px;line-height:1.7;">
-      <div>Wysyłka: <strong>${ctx.order.shippingGross}</strong></div>
-      <div style="font-size:16px;">Razem (brutto): <strong style="color:#5B4A9E;">${ctx.order.totalGross}</strong></div>
-      <div style="color:#8888A0;font-size:12px;">netto ${ctx.order.totalNet} · VAT ${ctx.order.vatAmount}</div>
-    </div>
-    ${ctx.tracking
-        ? `<div style="margin-top:20px;padding:16px;background:#F4F2FA;border-radius:10px;font-size:14px;">
-    <div style="color:#555566;margin-bottom:4px;">${escapeHtml(ctx.tracking.label)}</div>
-    <div style="font-family:ui-monospace,monospace;font-weight:700;word-break:break-all;">${escapeHtml(ctx.tracking.number)}</div>
-    ${ctx.tracking.url
-            ? `<a href="${escapeHtml(ctx.tracking.url)}" style="display:inline-block;margin-top:8px;color:#5B4A9E;font-weight:600;text-decoration:none;">${escapeHtml(ctx.tracking.linkLabel)}</a>`
-            : ''}
-  </div>`
-        : ''}
-    ${ctx.viewUrl
-        ? `<div style="margin-top:24px;text-align:center;"><a href="${escapeHtml(ctx.viewUrl)}" style="display:inline-block;background:#5B4A9E;color:#fff;text-decoration:none;padding:10px 18px;border-radius:8px;font-weight:600;">${escapeHtml(ctx.viewLinkLabel)}</a></div>`
-        : ''}
-  </div>
-  <p style="text-align:center;color:#8888A0;font-size:12px;margin-top:16px;">AriaCMS · ${escapeHtml(ctx.order.customerEmail)}</p>
-</div>
-</body></html>`;
-}
-function escapeHtml(s) {
-    return s
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&#39;');
+function formatPrice(cents, currency) {
+    return new Intl.NumberFormat('pl-PL', {
+        style: 'currency',
+        currency,
+        minimumFractionDigits: 2
+    }).format(cents / 100);
 }
+/**
+ * List of template names a shop install must ship in `dist/shop/templates/`.
+ * Consumed by `validateBuiltinTemplates` at CMS bootstrap.
+ * @internal
+ */
+export const REQUIRED_TEMPLATE_NAMES = [
+    ...Object.values(STATUS_TO_TEMPLATE),
+    'low-stock'
+];
 export async function sendOrderStatusEmail(orderId, status) {
     const cms = getCMS();
     const shop = requireShopConfig();
@@ -123,6 +63,13 @@ export async function sendOrderStatusEmail(orderId, status) {
     if (!order)
         return;
     const items = await getOrderItems(orderId);
+    let coupon = null;
+    try {
+        coupon = await getOrderCoupon(orderId);
+    }
+    catch (err) {
+        console.error('[shop] Failed to load order coupon for email context:', err);
+    }
     const lang = (order.language || cms.languages[0] || 'pl');
     const subjectKey = (lang in STATUS_SUBJECTS[status] ? lang : 'pl');
     const viewUrl = /^https?:\/\//i.test(shop.orderViewUrl)
@@ -155,7 +102,7 @@ export async function sendOrderStatusEmail(orderId, status) {
             linkLabel: TRACKING_LABEL[subjectKey].linkLabel
         };
     }
-    const ctx = {
+    const context = {
         viewUrl,
         viewLinkLabel: VIEW_LINK_LABEL[subjectKey],
         tracking,
@@ -164,11 +111,15 @@ export async function sendOrderStatusEmail(orderId, status) {
             status: order.status,
             customerName: order.customerName ?? '',
             customerEmail: order.customerEmail,
+            language: order.language,
             totalGross: formatPrice(order.totalGross, order.currency),
             totalNet: formatPrice(order.totalNet, order.currency),
             vatAmount: formatPrice(order.vatAmount, order.currency),
             shippingGross: formatPrice(order.shippingGross, order.currency),
-            currency: order.currency
+            currency: order.currency,
+            couponCode: coupon?.code ?? null,
+            discountAmount: coupon ? formatPrice(coupon.discountAmount, order.currency) : null,
+            hasDiscount: Boolean(coupon && coupon.discountAmount > 0)
         },
         items: items.map((i) => ({
             name: resolveI18n(i.nameSnapshot?.product
@@ -176,11 +127,25 @@ export async function sendOrderStatusEmail(orderId, status) {
                 : undefined, lang) || '—',
             qty: i.qty,
             lineGross: formatPrice(i.priceGrossSnapshot * i.qty, order.currency)
-        }))
+        })),
+        shop: {
+            currency: order.currency,
+            adminEmail: shop.adminEmail ?? null
+        }
     };
     const subject = `${STATUS_SUBJECTS[status][subjectKey]} · ${order.number}`;
-    const intro = STATUS_INTRO[status][subjectKey];
-    const html = renderHtml(ctx, intro);
+    const templateName = STATUS_TO_TEMPLATE[status];
+    let html;
+    try {
+        html = await renderEmailTemplate(templateName, lang, context, {
+            projectDir: shop.emailTemplates?.dir,
+            strict: shop.emailTemplates?.strict
+        });
+    }
+    catch (err) {
+        console.error(`[shop] Failed to render template "${templateName}.${lang}.html" for order ${order.number}:`, err);
+        return;
+    }
     try {
         await emailAdapter.sendMail({
             to: order.customerEmail,
@@ -196,9 +161,7 @@ export async function sendOrderStatusEmail(orderId, status) {
 /**
  * Notify the shop admin that a product crossed its low-stock threshold.
  * Fire-and-forget — silently no-ops when no `shop.adminEmail` or no email
- * adapter is configured. Stays inside email.ts to keep the adapter call
- * site centralised (HTML, escaping, logging behaviour identical to status
- * emails).
+ * adapter is configured.
  *
  * @internal
  */
@@ -211,20 +174,31 @@ export async function sendLowStockEmail(input) {
     const emailAdapter = cms.emailAdapter;
     if (!emailAdapter)
         return;
+    const lang = (cms.languages[0] ?? 'pl');
     const subject = `Niski stan magazynowy · ${input.productTitle}`;
-    const html = `<!doctype html>
-<html><body style="margin:0;padding:0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif;background:#f5f5f8;color:#1a1a2e;">
-<div style="max-width:560px;margin:0 auto;padding:24px;">
-  <div style="background:#fff;border-radius:12px;padding:28px;">
-    <h1 style="font-size:20px;font-weight:800;margin:0 0 8px;color:#C4893A;">Niski stan magazynowy</h1>
-    <p style="margin:0 0 16px;color:#555566;line-height:1.5;">
-      Produkt <strong>${escapeHtml(input.productTitle)}</strong>${input.variantSku ? ` (SKU ${escapeHtml(input.variantSku)})` : ''}
-      ma już tylko <strong>${input.stock}</strong> sztuk w magazynie (próg alertu: ${input.threshold}).
-    </p>
-    <p style="margin:0;color:#8888A0;font-size:13px;">Uzupełnij stan w panelu admina, żeby uniknąć przerwy w sprzedaży.</p>
-  </div>
-</div>
-</body></html>`;
+    const context = {
+        product: {
+            title: input.productTitle,
+            variantSku: input.variantSku,
+            stock: input.stock,
+            threshold: input.threshold
+        },
+        shop: {
+            currency: shop.currency,
+            adminEmail
+        }
+    };
+    let html;
+    try {
+        html = await renderEmailTemplate('low-stock', lang, context, {
+            projectDir: shop.emailTemplates?.dir,
+            strict: shop.emailTemplates?.strict
+        });
+    }
+    catch (err) {
+        console.error('[shop] Failed to render low-stock template:', err);
+        return;
+    }
     try {
         await emailAdapter.sendMail({ to: adminEmail, subject, html });
     }

package/dist/shop/server/emailTemplateRegistry.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Shop email template registry — file-based Handlebars templates with
+ * 4-step resolution (project override → package default) and per-template
+ * CMS singleton auto-fetch. Used by `sendOrderStatusEmail` and
+ * `sendLowStockEmail` in email.ts.
+ *
+ * @internal — exported here for testing; not part of the public API.
+ */
+type Lang = string;
+interface ResolveResult {
+    filePath: string;
+    source: string;
+    isOverride: boolean;
+}
+/**
+ * 4-step lookup for a single template file.
+ * Returns `null` only if every step misses (shouldn't happen for built-in
+ * templates if the package is intact).
+ */
+declare function resolveTemplatePath(projectDir: string, name: string, lang: Lang, fallbackLang: Lang): ResolveResult | null;
+/**
+ * Traverse Handlebars AST and collect all `cms.<slug>.*` accessor slugs.
+ * Returns the unique set so the renderer can prefetch them.
+ */
+declare function extractCmsSlugs(ast: hbs.AST.Program): Set<string>;
+/**
+ * Public render entry — used by sendOrderStatusEmail / sendLowStockEmail.
+ * Looks up the template, prefetches required CMS singletons, renders.
+ */
+export declare function renderEmailTemplate(name: string, lang: Lang, context: Record<string, unknown>, opts?: {
+    projectDir?: string;
+    strict?: boolean;
+}): Promise<string>;
+/**
+ * Bootstrap-time smoke test — verify every required default template is
+ * present in the package. Called from initCMS after setShop.
+ * Lookup-only: does not compile or render, so cheap.
+ */
+export declare function validateBuiltinTemplates(requiredNames: string[], defaultLang: Lang): void;
+/** @internal — exposed for tests */
+export declare const __testExports: {
+    extractCmsSlugs: typeof extractCmsSlugs;
+    resolveTemplatePath: typeof resolveTemplatePath;
+    PACKAGE_TEMPLATES_DIR: string;
+    clearCache: () => void;
+};
+export {};