@rovela-ai/sdk 0.21.0 → 0.23.0

package/dist/emails/types.d.ts

@@ -151,6 +151,11 @@ export interface OrderConfirmationData {
     shippingCost: string;
     /** Formatted tax (e.g., "$8.00") */
     tax: string;
+    /** Per-rate VAT ventilation (0.22.0), pre-formatted. Multi-rate orders only. */
+    taxBreakdown?: Array<{
+        rate: number;
+        amount: string;
+    }>;
     /** Formatted total (e.g., "$112.00") */
     total: string;
     shippingAddress: EmailAddress;

package/dist/emails/types.d.ts.map

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

package/dist/products/api/products.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/products/api/products.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EACL,YAAY,EAIb,MAAM,uBAAuB,CAAA;AAQ9B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAA;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,GAAG,CACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,CAqG/D"}
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/products/api/products.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EACL,YAAY,EAKb,MAAM,uBAAuB,CAAA;AAQ9B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAA;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,GAAG,CACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,CAmH/D"}

package/dist/products/api/products.js

@@ -11,7 +11,7 @@
  * ```
  */
 import { NextResponse } from 'next/server';
-import { findProducts, countProducts, findCategoryBySlug, } from '../../core/db/queries';
+import { findProducts, countProducts, findCategoryBySlug, findCategoryDescendantIds, } from '../../core/db/queries';
 import { getRequestLocale } from '../../core/server/request-locale';
 import { localizeCatalogRows } from '../../core/i18n/catalog';
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -52,7 +52,7 @@ export async function GET(request) {
         // matched nothing and the link showed the full catalog. An unknown slug
         // returns an honest empty result instead.
         const categoryParam = searchParams.get('category') || undefined;
-        let categoryId = categoryParam;
+        let resolvedCategoryId = categoryParam;
         if (categoryParam && !UUID_RE.test(categoryParam)) {
             const category = await findCategoryBySlug(categoryParam);
             if (!category) {
@@ -64,7 +64,22 @@ export async function GET(request) {
                     hasMore: false,
                 });
             }
-            categoryId = category.id;
+            resolvedCategoryId = category.id;
+        }
+        // Tree-aware: a parent-category link includes its descendants' products
+        // (imported catalogs assign products to LEAF categories — PrestaShop-front
+        // behaviour). Leaf categories have no descendants → exact match, and a
+        // descendant-lookup failure degrades to exact match, never a 500.
+        let categoryId = resolvedCategoryId;
+        if (resolvedCategoryId) {
+            try {
+                const descendants = await findCategoryDescendantIds(resolvedCategoryId);
+                if (descendants.length > 0)
+                    categoryId = [resolvedCategoryId, ...descendants];
+            }
+            catch {
+                /* exact match fallback */
+            }
         }
         const onSaleParam = searchParams.get('onSale');
         const onSale = onSaleParam === '1' || onSaleParam === 'true' ? true : undefined;

package/dist/products/api/products.js.map

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

package/docs/changelog/epoch-09-catalog-tax.md

@@ -0,0 +1,91 @@
+# E9 Catalog & tax — 0.22.0..0.22.0
+
+## What landed
+Two catalog-commerce behaviors every PrestaShop-migrated store needs: the
+public category filter is now TREE-AWARE (a parent-category link includes its
+descendant categories' products — imported catalogs assign products to leaf
+categories), and TAX CLASSES bring per-product VAT rates (French 5.5%/20%
+food split): products carry a `tax_class`, tax zones carry per-class rates,
+and every money surface (quote, Stripe session, orders, emails, invoice,
+admin) computes and renders the per-rate VAT ventilation ("dont TVA par
+taux") French invoices legally require.
+
+## SDK-internal (free)
+- `findProducts`/`countProducts` accept `categoryId: string | string[]`
+  (IN-match). New `findCategoryDescendantIds(id)` (recursive CTE) and
+  `findTaxClassesByProductIds(ids)`.
+- `resolveTax` accepts optional `lines` — per-line computation grouped by
+  rate, order discount allocated pro-rata (largest-remainder, sums exact),
+  shipping taxed at the zone's base rate. Returns `taxBreakdown` +
+  `taxClassRates`. Without `lines`, or on a zone with no `class_rates`, the
+  original lump formula runs — cent-identical to 0.21.x.
+- `buildQuote` carries `taxBreakdown`/`taxClassRates` on the Quote; the
+  Stripe session divides each line by ITS OWN rate in tax-inclusive mode and
+  stamps `rovelaTaxBreakdown` metadata; both order writers persist
+  `orders.tax_breakdown`.
+- Admin: TaxSettings zone editor gains per-class rate rows; ProductForm
+  gains a Tax class field (datalist fed from the zones' class names);
+  tax-zones API accepts `classRates`; products API accepts `taxClass`.
+
+## Template contract
+- `app/account/orders/[id]/invoice/page.tsx` — the totals block renders one
+  `TVA {rate}%` row per `order.taxBreakdown` entry when the order carries a
+  multi-rate ventilation, else the single flat tax row (stock shape: gated
+  branch on `order.taxBreakdown?.length > 1`). Stores with a customized
+  invoice keep their layout and add the same branch.
+
+## Behavior contracts
+- **Public `/api/products?category=` is tree-aware.** A parent category id or
+  slug now returns its own products PLUS every descendant category's. Stores
+  whose nav deliberately relied on parent links showing ONLY directly-assigned
+  products (rare; usually a bug they worked around) will see more products.
+  Admin product filters are UNCHANGED (exact match).
+- **`OrderSummary` accepts `taxBreakdown`** and renders per-rate rows when
+  more than one rate is present; `CheckoutFlow` computes it from the estimate
+  response. Single-rate stores render byte-identically to 0.21.x.
+- The pre-checkout shipping estimate (`/api/checkout/shipping`) accepts an
+  optional `productId` per item and returns `tax.breakdown`. Clients that
+  omit `productId` get the previous base-rate estimate (totals unchanged in
+  tax-inclusive stores).
+
+## Custom-code hazards
+- `grep -rn "resolveTax(" app lib components` — custom callers keep working
+  (the `lines` param is optional; omitted = old math). If a custom checkout
+  displays tax recomputed from `taxRate` alone, it cannot reproduce a
+  multi-rate cart: read `tax.breakdown`/`quote.taxBreakdown` when present
+  (see CheckoutFlow's per-group recompute for the reference implementation).
+- `grep -rn "taxRate" app components` — any custom "TVA (20%)" label stays
+  correct for single-rate stores; multi-rate stores should render the
+  breakdown rows instead.
+- `grep -rn "category=" app components lib` — store-authored nav links to
+  PARENT categories now include leaf products (this is almost always the
+  desired fix, not a regression).
+
+## DB
+- `products.tax_class varchar(50)` NULL — self-heals via
+  `ensureCatalogTranslationsSchema` (every catalog chokepoint).
+- `tax_zones.class_rates jsonb NOT NULL DEFAULT '{}'` — self-heals via
+  `ensureVisibilityColumns`.
+- `orders.tax_breakdown jsonb` NULL — self-heals via
+  `ensurePaymentMethodsSchema`.
+- All three are additive with behavior-preserving defaults: no class rates
+  configured = 0.21.x math to the cent. Pre-applying is optional.
+
+## New surfaces
+- None. (TaxSettings/ProductForm gains are inside existing admin pages; no
+  new routes to mount.)
+
+## Verify
+1. `/products?category=<parent slug>` lists products assigned to child
+   categories; the admin Products page filtered to the same parent does NOT.
+2. Settings → Tax: add a class rate (e.g. `tva-5-5` = 5.5) on the active
+   zone; assign the class to one product (Product form → Pricing → Tax
+   class).
+3. Cart with one classed + one unclassed product → checkout review shows two
+   `TVA x%` rows summing to the receipt tax; totals unchanged
+   (tax-inclusive).
+4. Place a test order → `orders.tax_breakdown` populated; invoice page and
+   order-confirmation email render the ventilation; admin order detail shows
+   per-rate rows.
+5. A store that configures NO class rates: quote totals and every tax line
+   render exactly as before the update.

package/docs/changelog/epoch-10-email-transport.md

@@ -0,0 +1,97 @@
+# E10 Email sending & Brevo — 0.23.0..0.23.0
+
+## What landed
+Transactional-email delivery became merchant-configurable. Every store email
+(order confirmations, account emails, custom emails) already funnels through
+the SDK's one `sendEmail()` chokepoint; it now resolves a per-store
+TRANSPORT: `'platform'` (default — the pre-0.23 Resend path, byte-identical
+for the whole fleet), `'brevo'` (the store's connected Brevo account over
+its HTTP API — same API key as the marketing integration, no SMTP key
+needed), or `'smtp'` (the merchant's own server). The Brevo integration
+also gained a live status echo and a one-click, resumable HISTORY IMPORT
+that replaces per-store backfill scripts.
+
+## SDK-internal (free via pin bump)
+- `emails/transport.ts` — transport resolution + the two senders. **FAIL-SAFE
+  DELIVERY RULE**: a non-platform transport failure falls back to the
+  platform Resend path and logs loudly; a merchant's SMTP typo can never eat
+  an order confirmation. Misconfiguration surfaces at SAVE time instead
+  (real SMTP `verify()` handshake; Brevo verified-sender check).
+- New `store_settings` columns (drizzle + `ensureStoreSettingsSchema` +
+  parent-branch ALTER at ship time): `email_transport`,
+  `email_from_address`, `email_from_name`, `smtp_host`, `smtp_port`,
+  `smtp_secure`, `smtp_user`, `smtp_password` (SERVER-ONLY secret — stripped
+  from the admin settings GET like `colissimo_password`; write-only, blank
+  keeps the stored value).
+- `nodemailer` (pinned to the 7.x line — next-auth 4.x declares
+  `peerOptional nodemailer@^7` and npm refuses to hoist a different major)
+  became BOTH an SDK dependency and a TEMPLATE dependency (root-hoisted,
+  deterministic location). It loads through a BUNDLER-IGNORED dynamic
+  import (`webpackIgnore` + `turbopackIgnore`, isolated in
+  `emails/transport-smtp.ts`) — the emails graph is client-reachable, so a
+  static import breaks `next build`; the ignored import is native
+  server-runtime resolution, no path guessing.
+- `EmailSendingPanel` (Sending card on /admin/emails) + `EmailsManager`
+  mounts it; the "Send a test" button exercises the REAL saved transport.
+- Integrations registry entries gained `details` bullets (what each
+  integration actually does, rendered in the configure modal — all 10
+  entries authored).
+- Brevo configure modal extras: live "Connected as x@y · plan" echo,
+  verified-sender status, the "send transactional emails through Brevo"
+  toggle (writes the same `email_transport` column as the Sending panel —
+  the two surfaces can never disagree), and the history import UI
+  (progress bar, resumable, include-orders switch defaulted OFF when
+  Brevo's eCommerce module already holds orders — the double-count guard).
+
+## Template contract
+- `app/api/admin/emails/sending/route.ts` (NEW) — re-export
+  `getEmailSending as GET, putEmailSending as PUT`. Without it the Sending
+  panel shows a load error and the Brevo toggle cannot save.
+- `app/api/admin/integrations/brevo/route.ts` (NEW) — `getBrevoStatus as
+  GET`; `app/api/admin/integrations/brevo/backfill/route.ts` (NEW) —
+  `postBrevoBackfill as POST`. Without them the Brevo modal's extras show
+  an error state (credentials editing keeps working).
+- **Component-dependency note (the E4 precedent)**: two per-store
+  requirements for the Custom-SMTP option — `package.json` gains
+  `"nodemailer": "7.0.13"` (MUST stay on 7.x: next-auth's peerOptional
+  range; a 8/9 pin makes npm nest it where the runtime can't resolve it)
+  and `next.config.js` gains
+  `outputFileTracingIncludes: ['./node_modules/nodemailer/**']` (an ignored
+  import is invisible to Vercel's tracer). A store updating the SDK WITHOUT
+  these loses only the Custom-SMTP option at runtime (platform + Brevo
+  transports are unaffected — Brevo is plain fetch), with a loud
+  `[Email] nodemailer not loadable` log.
+
+## Behavior contracts
+- `sendEmail()` behavior is UNCHANGED while `email_transport` is NULL /
+  'platform' — the entire existing fleet keeps its exact sending path.
+- The Brevo history import is idempotent + resumable: contacts upsert by
+  email (`updateEnabled` — no duplicates, existing attributes/lists/consent
+  untouched, NO listIds ever sent), orders push with `historical: true`
+  (populates dashboards, NEVER fires an automation), chunked per request
+  (serverless-safe; the modal loops on the returned cursor).
+- Per-store backfill scripts are RETIRED: the connect-brevo card + the
+  credentials contract now forbid writing one-off sync scripts into the
+  repo — history imports live in the admin.
+
+## Custom-code hazards (audit greps for CC)
+- Grep `scripts/` for hand-written Brevo/marketing backfill or sync scripts
+  (e.g. EasyElec's `scripts/brevo-backfill.mjs`) — superseded by
+  Integrations → Brevo → "Import history"; delete them.
+- Grep for direct `getResend()` / `resend.emails.send` calls in store code —
+  they bypass the transport layer; route them through `sendEmail()` from
+  `@rovela-ai/sdk/emails`.
+
+## MERCHANT-DATA HAZARD
+None — no existing data changes meaning. The default transport is the
+existing behavior; Brevo/SMTP are opt-in.
+
+## Verify
+- /admin/emails shows the Sending card; saving Custom SMTP with a wrong
+  host is REJECTED at save time with the handshake error.
+- With Brevo connected: the integration modal shows "Connected as …", the
+  transactional toggle flips `email_transport`, and "Send a test" delivers
+  through Brevo (check the Brevo → Transactional log).
+- The history import runs to 100% with a progress bar, is resumable after
+  an interruption, and fires zero automations (historical flag).
+- A store with `email_transport` unset sends exactly as before.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rovela-ai/sdk",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "description": "Rovela SDK - Pre-built e-commerce components for AI-powered store generation",
   "type": "module",
   "license": "MIT",
@@ -320,6 +320,7 @@
     "lucide-react": "0.555.0",
     "nanoid": "5.1.6",
     "next-auth": "4.24.13",
+    "nodemailer": "7.0.13",
     "react-colorful": "^5.6.1",
     "recharts": "3.7.0",
     "resend": "6.9.1",

package/templates/store-template/.claude/skills/manage-products/SKILL.md

@@ -27,7 +27,7 @@ Usage: `nextjs_call` with `port="3000"` and `toolName="execute_sql"`
 
 | Table | Key Columns |
 |-------|-------------|
-| `products` | id, name, slug, price, status (`draft`/`active`/`archived`), categoryId, hasVariants, images (JSONB string[]), videos (JSONB string[]), metafields (JSONB key/label/value/type), translations (JSONB per-locale name/description) |
+| `products` | id, name, slug, price, status (`draft`/`active`/`archived`), categoryId, hasVariants, images (JSONB string[]), videos (JSONB string[]), metafields (JSONB key/label/value/type), translations (JSONB per-locale name/description), taxClass (0.22.0 — names a rate in tax_zones.class_rates; NULL = zone base rate) |
 | `product_variants` | id, productId (CASCADE), sku, name, price, inventory, attributes (JSONB), image, video |
 | `categories` | id, name, slug, parentId (self-ref), order, translations (JSONB) |
 | `orders` | id, customerId, email, status, total, currency (ISO snapshot — display orders in THIS currency), refundAmount, returnReason, shippingAddress (JSONB) |

package/templates/store-template/app/account/orders/[id]/invoice/page.tsx

@@ -42,6 +42,8 @@ interface InvoiceOrder {
   total: number
   subtotal: number
   tax: number
+  /** Per-rate VAT ventilation (0.22.0) — cents; null/absent = flat tax line. */
+  taxBreakdown?: Array<{ rate: number; baseCents: number; taxCents: number }> | null
   shipping: number
   discountAmount?: number | string
   discountCode?: string | null
@@ -245,10 +247,23 @@ function InvoiceContent({ orderId }: { orderId: string }) {
             <span>{t('common.shipping')}</span>
             <span>{order.shipping > 0 ? formatPrice(order.shipping, orderCurrency) : t('common.free')}</span>
           </div>
-          <div className="flex justify-between text-muted-foreground">
-            <span>{t('common.tax')}</span>
-            <span>{formatPrice(order.tax, orderCurrency)}</span>
-          </div>
+          {order.taxBreakdown && order.taxBreakdown.length > 1 ? (
+            // Per-rate VAT ventilation (0.22.0) — the legally required French
+            // invoice breakdown ("dont TVA par taux").
+            order.taxBreakdown.map((entry) => (
+              <div key={entry.rate} className="flex justify-between text-muted-foreground">
+                <span>
+                  {t('common.tax')} {entry.rate}%
+                </span>
+                <span>{formatPrice(entry.taxCents / 100, orderCurrency)}</span>
+              </div>
+            ))
+          ) : (
+            <div className="flex justify-between text-muted-foreground">
+              <span>{t('common.tax')}</span>
+              <span>{formatPrice(order.tax, orderCurrency)}</span>
+            </div>
+          )}
           <div className="flex justify-between border-t pt-2 text-base font-semibold text-foreground">
             <span>{t('common.total')}</span>
             <span>{formatPrice(order.total, orderCurrency)}</span>

package/templates/store-template/app/api/admin/emails/sending/route.ts

@@ -0,0 +1,9 @@
+/**
+ * Email Sending Configuration Route
+ *
+ * GET /api/admin/emails/sending - Current transactional-email transport
+ * PUT /api/admin/emails/sending - Save it (SMTP handshake / Brevo verified-
+ *                                 sender check run BEFORE persisting)
+ */
+
+export { getEmailSending as GET, putEmailSending as PUT } from '@rovela-ai/sdk/admin/api'

package/templates/store-template/app/api/admin/integrations/brevo/backfill/route.ts

@@ -0,0 +1,9 @@
+/**
+ * Brevo History Import Route
+ *
+ * POST /api/admin/integrations/brevo/backfill - One chunk of the resumable
+ * history import (contacts upsert, then orders with historical:true so no
+ * automation fires). The integrations modal loops on the returned cursor.
+ */
+
+export { postBrevoBackfill as POST } from '@rovela-ai/sdk/admin/api'

package/templates/store-template/app/api/admin/integrations/brevo/route.ts

@@ -0,0 +1,9 @@
+/**
+ * Brevo Integration Status Route
+ *
+ * GET /api/admin/integrations/brevo - Live Brevo status for the
+ * integrations modal (account identity, sender verification, whether the
+ * eCommerce module already holds orders, current email transport).
+ */
+
+export { getBrevoStatus as GET } from '@rovela-ai/sdk/admin/api'

package/templates/store-template/next.config.js

@@ -50,7 +50,10 @@ const nextConfig = {
   // the SDK's core/config get the file, and every other function (checkout,
   // webhooks, auth, admin emails) silently falls back to default styling.
   outputFileTracingIncludes: {
-    '/**': ['./.rovela/blueprint.json'],
+    // nodemailer is loaded via a bundler-invisible require (the emails graph
+    // is client-reachable, a static import breaks the build) so the tracer
+    // can't see it — force-include it or the SMTP transport 500s on Vercel.
+    '/**': ['./.rovela/blueprint.json', './node_modules/nodemailer/**'],
   },
 
   // Image domains for Unsplash, CDNs, and R2 storage

package/templates/store-template/package.json

@@ -9,13 +9,14 @@
     "lint": "eslint ."
   },
   "dependencies": {
-    "@rovela-ai/sdk": "0.21.0",
+    "@rovela-ai/sdk": "0.23.0",
     "@tailwindcss/forms": "0.5.11",
     "@tailwindcss/typography": "0.5.19",
     "autoprefixer": "10.4.24",
     "lucide-react": "0.555.0",
     "next": "16.2.10",
     "next-auth": "4.24.13",
+    "nodemailer": "7.0.13",
     "postcss": "8.5.6",
     "react": "19.2.4",
     "react-dom": "19.2.4",