@rovela-ai/sdk 0.21.0 → 0.22.0

package/dist/core/db/queries.js

@@ -37,6 +37,9 @@ export async function ensureCatalogTranslationsSchema() {
     `);
         await db.execute(sql `
       ALTER TABLE products ADD COLUMN IF NOT EXISTS metafields jsonb NOT NULL DEFAULT '[]'::jsonb
+    `);
+        await db.execute(sql `
+      ALTER TABLE products ADD COLUMN IF NOT EXISTS tax_class varchar(50)
     `);
         catalogTranslationsEnsured = true;
     }
@@ -59,7 +62,10 @@ export async function findProducts(options = {}) {
     const db = getDb();
     const conditions = [];
     if (options.categoryId) {
-        conditions.push(eq(schema.products.categoryId, options.categoryId));
+        const categoryIds = options.categoryId;
+        conditions.push(Array.isArray(categoryIds)
+            ? inArray(schema.products.categoryId, categoryIds)
+            : eq(schema.products.categoryId, categoryIds));
     }
     if (options.status) {
         conditions.push(eq(schema.products.status, options.status));
@@ -156,7 +162,10 @@ export async function countProducts(options = {}) {
     const db = getDb();
     const conditions = [];
     if (options.categoryId) {
-        conditions.push(eq(schema.products.categoryId, options.categoryId));
+        const categoryIds = options.categoryId;
+        conditions.push(Array.isArray(categoryIds)
+            ? inArray(schema.products.categoryId, categoryIds)
+            : eq(schema.products.categoryId, categoryIds));
     }
     if (options.status) {
         conditions.push(eq(schema.products.status, options.status));
@@ -429,6 +438,51 @@ export async function findCategories() {
         .from(schema.categories)
         .orderBy(asc(schema.categories.order), asc(schema.categories.name));
 }
+/**
+ * productId → tax_class for a set of products, one query. Used by the
+ * pre-checkout estimate endpoint so its per-class tax preview matches the
+ * final quote. Unknown ids are simply absent from the map.
+ */
+export async function findTaxClassesByProductIds(productIds) {
+    if (productIds.length === 0)
+        return {};
+    await ensureCatalogTranslationsSchemaSafe();
+    const db = getDb();
+    const rows = await db
+        .select({ id: schema.products.id, taxClass: schema.products.taxClass })
+        .from(schema.products)
+        .where(inArray(schema.products.id, productIds));
+    const out = {};
+    for (const row of rows)
+        out[row.id] = row.taxClass ?? null;
+    return out;
+}
+/**
+ * All descendant category ids of a category (children, grandchildren, …),
+ * excluding the category itself. Recursive CTE over categories.parent_id —
+ * correct at any depth, one round trip. Powers the tree-aware public catalog
+ * filter: a parent-category link shows its leaves' products (imported
+ * PrestaShop catalogs assign products to LEAF categories).
+ */
+export async function findCategoryDescendantIds(categoryId) {
+    const db = getDb();
+    const result = await db.execute(sql `
+    WITH RECURSIVE descendants AS (
+      SELECT id FROM categories WHERE parent_id = ${categoryId}
+      UNION ALL
+      SELECT c.id FROM categories c
+      INNER JOIN descendants d ON c.parent_id = d.id
+    )
+    SELECT id FROM descendants
+  `);
+    // Driver-shape hedge (same as the redemption claim below): neon-http returns
+    // { rows } on current drizzle, a bare array on older ones.
+    const raw = result;
+    const rows = Array.isArray(raw)
+        ? raw
+        : (raw.rows ?? []);
+    return rows.map((r) => String(r.id));
+}
 /**
  * Find a category by slug
  */
@@ -1825,6 +1879,8 @@ export async function ensureVisibilityColumns() {
         await db.execute(sql `ALTER TABLE payment_methods ADD COLUMN IF NOT EXISTS visible_to_groups jsonb NOT NULL DEFAULT '[]'::jsonb`);
         await db.execute(sql `ALTER TABLE shipping_rates ADD COLUMN IF NOT EXISTS visible_to_groups jsonb NOT NULL DEFAULT '[]'::jsonb`);
         await db.execute(sql `ALTER TABLE tax_zones ADD COLUMN IF NOT EXISTS visible_to_groups jsonb NOT NULL DEFAULT '[]'::jsonb`);
+        // Per-class rates (0.22.0) ride the same tax-zone chokepoints.
+        await db.execute(sql `ALTER TABLE tax_zones ADD COLUMN IF NOT EXISTS class_rates jsonb NOT NULL DEFAULT '{}'::jsonb`);
         visibilityColumnsEnsured = true;
     }
     catch (err) {
@@ -1882,6 +1938,7 @@ export async function ensurePaymentMethodsSchema() {
         await db.execute(sql `CREATE INDEX IF NOT EXISTS payment_methods_sort_order_idx ON payment_methods (sort_order)`);
         await db.execute(sql `ALTER TABLE orders ADD COLUMN IF NOT EXISTS payment_provider varchar(20) NOT NULL DEFAULT 'stripe'`);
         await db.execute(sql `ALTER TABLE orders ADD COLUMN IF NOT EXISTS payment_method_id uuid`);
+        await db.execute(sql `ALTER TABLE orders ADD COLUMN IF NOT EXISTS tax_breakdown jsonb`);
         await db.execute(sql `ALTER TABLE orders ADD COLUMN IF NOT EXISTS payment_method_label varchar(100)`);
         // Per-order currency snapshot (SDK 0.7.0 — pricing core). Rides this
         // ensure because it already covers every order read/write chokepoint.
@@ -3401,6 +3458,25 @@ export async function findShippingOptionsForCountry(country, orderAmount, groupI
     // Convert to array and sort by carrier name
     return Array.from(carrierMap.values()).sort((a, b) => a.carrier.name.localeCompare(b.carrier.name));
 }
+/**
+ * Sanitize a class-rates map at the write boundary: string keys (trimmed,
+ * ≤50 chars — the products.tax_class width), finite rates clamped 0-100.
+ * Invalid entries are dropped, never thrown — a bad row must not brick the
+ * zone editor.
+ */
+export function sanitizeClassRates(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(input)) {
+        const name = String(key).trim().slice(0, 50);
+        const rate = typeof value === 'number' ? value : Number(value);
+        if (!name || !Number.isFinite(rate) || rate < 0 || rate > 100)
+            continue;
+        out[name] = rate;
+    }
+    return out;
+}
 /**
  * Find all tax zones ordered by priority (sortOrder ascending)
  */
@@ -3418,6 +3494,7 @@ export async function findTaxZones() {
         countries: zone.countries || [],
         states: zone.states || [],
         taxRate: Number(zone.taxRate),
+        classRates: sanitizeClassRates(zone.classRates),
         isActive: zone.isActive,
         sortOrder: zone.sortOrder,
         visibleToGroups: Array.isArray(zone.visibleToGroups) ? zone.visibleToGroups : [],
@@ -3452,6 +3529,7 @@ export async function createTaxZone(data) {
         countries: data.countries.map((c) => c.toUpperCase()),
         states: (data.states || []).map((s) => s.toUpperCase()),
         taxRate: String(data.taxRate),
+        classRates: sanitizeClassRates(data.classRates),
         isActive: data.isActive ?? true,
         sortOrder: data.sortOrder ?? 0,
         visibleToGroups: data.visibleToGroups ?? [],
@@ -3474,6 +3552,8 @@ export async function updateTaxZone(id, data) {
         updateData.states = data.states.map((s) => s.toUpperCase());
     if (data.taxRate !== undefined)
         updateData.taxRate = String(data.taxRate);
+    if (data.classRates !== undefined)
+        updateData.classRates = sanitizeClassRates(data.classRates);
     if (data.isActive !== undefined)
         updateData.isActive = data.isActive;
     if (data.sortOrder !== undefined)
@@ -3537,6 +3617,7 @@ export async function findTaxRateForAddress(country, state, groupId) {
             zoneId: zone.id,
             zoneName: zone.name,
             taxRate: zone.taxRate,
+            classRates: zone.classRates,
         };
     }
     return null; // No matching tax zone