@fayz-ai/shop 0.6.0 → 0.8.0

package/README.md

@@ -5,6 +5,8 @@
 [![npm](https://img.shields.io/npm/v/@fayz-ai/shop.svg)](https://www.npmjs.com/package/@fayz-ai/shop)
 [![license](https://img.shields.io/npm/l/@fayz-ai/shop.svg)](https://github.com/FayaLabs/fayz-sdk/blob/main/LICENSE)
 
+**Status:** beta — published to npm and used across Fayz dogfood apps. Pre-1.0: minor APIs may change before 1.0.
+
 `@fayz-ai/shop` is the headless ecommerce engine: a `ShopProvider` contract plus the domain types for products, carts, orders, customers, discounts, and shipping. It owns *what commerce means* so the storefront (`@fayz-ai/storefront`) and admin surfaces only have to render it.
 
 It's provider-first by design. Ship a demo on `createMockShopProvider`, then drop in `createSupabaseShopProvider` (or your own `ShopProvider`) for real data — the UI doesn't change. Tenancy is resolved through a pluggable resolver, so the same engine serves one store or a marketplace of thousands.

package/dist/index.cjs

@@ -178,6 +178,7 @@ function now() {
 }
 var ORDERS_KEY = "fayz.shop.mock.orders.v1";
 var CUSTOMERS_KEY = "fayz.shop.mock.customers.v1";
+var ENQUIRIES_KEY = "fayz.shop.mock.enquiries.v1";
 function loadStored(key) {
   try {
     if (typeof localStorage === "undefined") return [];
@@ -198,6 +199,7 @@ var MockShopProvider = class {
   constructor(seed) {
     this.orders = loadStored(ORDERS_KEY);
     this.customers = loadStored(CUSTOMERS_KEY);
+    this.enquiries = loadStored(ENQUIRIES_KEY);
     this.products = (seed?.products ?? MOCK_PRODUCTS).map((p) => ({ ...p }));
     this.categories = (seed?.categories ?? MOCK_CATEGORIES).map((c) => ({ ...c }));
     this.discounts = (seed?.discounts ?? MOCK_DISCOUNTS).map((d) => ({ ...d }));
@@ -210,12 +212,18 @@ var MockShopProvider = class {
   syncCustomers() {
     this.customers = loadStored(CUSTOMERS_KEY);
   }
+  syncEnquiries() {
+    this.enquiries = loadStored(ENQUIRIES_KEY);
+  }
   persistOrders() {
     store(ORDERS_KEY, this.orders);
   }
   persistCustomers() {
     store(CUSTOMERS_KEY, this.customers);
   }
+  persistEnquiries() {
+    store(ENQUIRIES_KEY, this.enquiries);
+  }
   // ---------------------------------------------------------------------------
   // Products
   // ---------------------------------------------------------------------------
@@ -270,6 +278,44 @@ var MockShopProvider = class {
   }
   async deleteProductImage(_imageId) {
   }
+  async createProductEnquiry(input) {
+    this.syncEnquiries();
+    const ts = now();
+    const enquiry = {
+      id: uid(),
+      tenantId: "mock",
+      productId: input.productId ?? null,
+      productName: input.productName,
+      productSlug: input.productSlug ?? null,
+      customerName: input.customerName,
+      customerEmail: input.customerEmail,
+      customerPhone: input.customerPhone ?? null,
+      subject: input.subject ?? null,
+      message: input.message,
+      sourceUrl: input.sourceUrl ?? null,
+      status: "new",
+      metadata: input.metadata ?? {},
+      createdAt: ts,
+      updatedAt: ts
+    };
+    this.enquiries.unshift(enquiry);
+    this.persistEnquiries();
+    return enquiry;
+  }
+  async listProductEnquiries(opts) {
+    this.syncEnquiries();
+    let list = [...this.enquiries];
+    if (opts?.productId) list = list.filter((e) => e.productId === opts.productId);
+    if (opts?.customerEmail) {
+      const email = opts.customerEmail.toLowerCase();
+      list = list.filter((e) => e.customerEmail.toLowerCase() === email);
+    }
+    if (opts?.status) list = list.filter((e) => e.status === opts.status);
+    list.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    const offset = opts?.offset ?? 0;
+    if (offset || opts?.limit) list = list.slice(offset, opts?.limit ? offset + opts.limit : void 0);
+    return list;
+  }
   // ---------------------------------------------------------------------------
   // Categories
   // ---------------------------------------------------------------------------
@@ -605,6 +651,17 @@ function getShopTenantId() {
   }
 }
 
+// src/tables.ts
+var T = {
+  products: "plg_shop_products",
+  productImages: "plg_shop_product_images",
+  categories: "plg_shop_categories",
+  orders: "plg_shop_orders",
+  orderItems: "plg_shop_order_items",
+  customers: "plg_shop_customers",
+  discounts: "plg_shop_discounts"
+};
+
 // src/supabase-provider.ts
 function getDb() {
   const supabase = core.getSupabaseClientOptional();
@@ -732,7 +789,7 @@ var SupabaseShopProvider = class {
   async listProducts(options) {
     const db = getDb();
     const tenantId = getTenantId();
-    let q = db.from("shop_products").select("*, images:shop_product_images(*)");
+    let q = db.from(T.products).select(`*, images:${T.productImages}(*)`);
     if (tenantId) q = q.eq("tenant_id", tenantId);
     if (options?.status) q = q.eq("status", options.status);
     if (options?.categoryId) q = q.eq("category_id", options.categoryId);
@@ -747,14 +804,14 @@ var SupabaseShopProvider = class {
   }
   async getProduct(id) {
     const db = getDb();
-    const { data, error } = await db.from("shop_products").select("*, images:shop_product_images(*)").eq("id", id).maybeSingle();
+    const { data, error } = await db.from(T.products).select(`*, images:${T.productImages}(*)`).eq("id", id).maybeSingle();
     if (error) throw error;
     return data ? rowToProduct(data) : null;
   }
   async createProduct(input) {
     const db = getDb();
     const tenantId = getTenantId();
-    const { data, error } = await db.from("shop_products").insert({
+    const { data, error } = await db.from(T.products).insert({
       tenant_id: tenantId,
       name: input.name,
       slug: input.slug ?? slugify(input.name),
@@ -771,7 +828,7 @@ var SupabaseShopProvider = class {
       is_physical: input.isPhysical ?? true,
       weight: input.weight ?? null,
       weight_unit: input.weightUnit ?? "kg"
-    }).select("*, images:shop_product_images(*)").single();
+    }).select(`*, images:${T.productImages}(*)`).single();
     if (error) throw error;
     return rowToProduct(data);
   }
@@ -793,12 +850,12 @@ var SupabaseShopProvider = class {
     if (input.categoryId !== void 0) updates.category_id = input.categoryId;
     if (input.isPhysical !== void 0) updates.is_physical = input.isPhysical;
     if (input.weight !== void 0) updates.weight = input.weight;
-    const { data, error } = await db.from("shop_products").update(updates).eq("id", id).select("*, images:shop_product_images(*)").single();
+    const { data, error } = await db.from(T.products).update(updates).eq("id", id).select(`*, images:${T.productImages}(*)`).single();
     if (error) throw error;
     return rowToProduct(data);
   }
   async deleteProduct(id) {
-    const { error } = await getDb().from("shop_products").delete().eq("id", id);
+    const { error } = await getDb().from(T.products).delete().eq("id", id);
     if (error) throw error;
   }
   async uploadProductImage(productId, file) {
@@ -808,12 +865,12 @@ var SupabaseShopProvider = class {
     const { error: uploadErr } = await db.storage.from("shop-images").upload(path, file);
     if (uploadErr) throw uploadErr;
     const { data: { publicUrl } } = db.storage.from("shop-images").getPublicUrl(path);
-    const { data, error } = await db.from("shop_product_images").insert({ product_id: productId, tenant_id: tenantId, url: publicUrl, sort_order: 0, is_primary: false }).select().single();
+    const { data, error } = await db.from(T.productImages).insert({ product_id: productId, tenant_id: tenantId, url: publicUrl, sort_order: 0, is_primary: false }).select().single();
     if (error) throw error;
     return rowToImage(data);
   }
   async deleteProductImage(imageId) {
-    const { error } = await getDb().from("shop_product_images").delete().eq("id", imageId);
+    const { error } = await getDb().from(T.productImages).delete().eq("id", imageId);
     if (error) throw error;
   }
   // ---------------------------------------------------------------------------
@@ -822,7 +879,7 @@ var SupabaseShopProvider = class {
   async listCategories() {
     const db = getDb();
     const tenantId = getTenantId();
-    let q = db.from("shop_categories").select("*").order("sort_order", { ascending: true });
+    let q = db.from(T.categories).select("*").order("sort_order", { ascending: true });
     if (tenantId) q = q.eq("tenant_id", tenantId);
     const { data, error } = await q;
     if (error) throw error;
@@ -830,7 +887,7 @@ var SupabaseShopProvider = class {
   }
   async createCategory(input) {
     const db = getDb();
-    const { data, error } = await db.from("shop_categories").insert({ tenant_id: getTenantId(), name: input.name, slug: input.slug ?? slugify(input.name), description: input.description ?? null, parent_id: input.parentId ?? null, sort_order: input.sortOrder ?? 0 }).select().single();
+    const { data, error } = await db.from(T.categories).insert({ tenant_id: getTenantId(), name: input.name, slug: input.slug ?? slugify(input.name), description: input.description ?? null, parent_id: input.parentId ?? null, sort_order: input.sortOrder ?? 0 }).select().single();
     if (error) throw error;
     return rowToCategory(data);
   }
@@ -842,12 +899,12 @@ var SupabaseShopProvider = class {
     if (input.description !== void 0) updates.description = input.description;
     if (input.parentId !== void 0) updates.parent_id = input.parentId;
     if (input.sortOrder !== void 0) updates.sort_order = input.sortOrder;
-    const { data, error } = await db.from("shop_categories").update(updates).eq("id", id).select().single();
+    const { data, error } = await db.from(T.categories).update(updates).eq("id", id).select().single();
     if (error) throw error;
     return rowToCategory(data);
   }
   async deleteCategory(id) {
-    const { error } = await getDb().from("shop_categories").delete().eq("id", id);
+    const { error } = await getDb().from(T.categories).delete().eq("id", id);
     if (error) throw error;
   }
   // ---------------------------------------------------------------------------
@@ -856,7 +913,7 @@ var SupabaseShopProvider = class {
   async listOrders(options) {
     const db = getDb();
     const tenantId = getTenantId();
-    let q = db.from("shop_orders").select("*, items:shop_order_items(*)");
+    let q = db.from(T.orders).select(`*, items:${T.orderItems}(*)`);
     if (tenantId) q = q.eq("tenant_id", tenantId);
     if (options?.status) q = q.eq("status", options.status);
     if (options?.financialStatus) q = q.eq("financial_status", options.financialStatus);
@@ -871,7 +928,7 @@ var SupabaseShopProvider = class {
     return (data ?? []).map(rowToOrder);
   }
   async getOrder(id) {
-    const { data, error } = await getDb().from("shop_orders").select("*, items:shop_order_items(*)").eq("id", id).maybeSingle();
+    const { data, error } = await getDb().from(T.orders).select(`*, items:${T.orderItems}(*)`).eq("id", id).maybeSingle();
     if (error) throw error;
     return data ? rowToOrder(data) : null;
   }
@@ -882,10 +939,10 @@ var SupabaseShopProvider = class {
     const discountTotal = input.discountTotal ?? 0;
     const shippingTotal = input.shippingTotal ?? 0;
     const total = Math.round((subtotal - discountTotal + shippingTotal) * 100) / 100;
-    const { data: order, error: orderErr } = await db.from("shop_orders").insert({ tenant_id: tenantId, customer_id: input.customerId ?? null, customer_name: input.customerName ?? null, customer_email: input.customerEmail ?? null, currency: input.currency ?? "BRL", notes: input.notes ?? null, subtotal, discount_total: discountTotal, shipping_total: shippingTotal, discount_code: input.discountCode ?? null, total, status: "open", financial_status: "pending", fulfillment_status: "unfulfilled" }).select().single();
+    const { data: order, error: orderErr } = await db.from(T.orders).insert({ tenant_id: tenantId, customer_id: input.customerId ?? null, customer_name: input.customerName ?? null, customer_email: input.customerEmail ?? null, currency: input.currency ?? "BRL", notes: input.notes ?? null, subtotal, discount_total: discountTotal, shipping_total: shippingTotal, discount_code: input.discountCode ?? null, total, status: "open", financial_status: "pending", fulfillment_status: "unfulfilled" }).select().single();
     if (orderErr) throw orderErr;
     const items = input.items.map((i) => ({ order_id: order.id, product_id: asUuid(i.productId), name: i.name, sku: i.sku ?? null, quantity: i.quantity, unit_price: i.unitPrice, total: i.quantity * i.unitPrice, image_url: i.imageUrl ?? null }));
-    await db.from("shop_order_items").insert(items);
+    await db.from(T.orderItems).insert(items);
     return this.getOrder(order.id);
   }
   async updateOrder(id, input) {
@@ -894,7 +951,7 @@ var SupabaseShopProvider = class {
     if (input.financialStatus !== void 0) updates.financial_status = input.financialStatus;
     if (input.fulfillmentStatus !== void 0) updates.fulfillment_status = input.fulfillmentStatus;
     if (input.notes !== void 0) updates.notes = input.notes;
-    const { error } = await getDb().from("shop_orders").update(updates).eq("id", id);
+    const { error } = await getDb().from(T.orders).update(updates).eq("id", id);
     if (error) throw error;
     return this.getOrder(id);
   }
@@ -927,7 +984,7 @@ var SupabaseShopProvider = class {
   async listCustomers(options) {
     const db = getDb();
     const tenantId = getTenantId();
-    let q = db.from("shop_customers").select("*").order("first_name", { ascending: true });
+    let q = db.from(T.customers).select("*").order("first_name", { ascending: true });
     if (tenantId) q = q.eq("tenant_id", tenantId);
     if (options?.search) q = q.or(`first_name.ilike.%${options.search}%,last_name.ilike.%${options.search}%,email.ilike.%${options.search}%`);
     if (options?.limit) q = q.limit(options.limit);
@@ -936,12 +993,12 @@ var SupabaseShopProvider = class {
     return (data ?? []).map(rowToCustomer);
   }
   async getCustomer(id) {
-    const { data, error } = await getDb().from("shop_customers").select("*").eq("id", id).maybeSingle();
+    const { data, error } = await getDb().from(T.customers).select("*").eq("id", id).maybeSingle();
     if (error) throw error;
     return data ? rowToCustomer(data) : null;
   }
   async createCustomer(input) {
-    const { data, error } = await getDb().from("shop_customers").insert({ tenant_id: getTenantId(), first_name: input.firstName, last_name: input.lastName ?? "", email: input.email ?? null, phone: input.phone ?? null, notes: input.notes ?? null }).select().single();
+    const { data, error } = await getDb().from(T.customers).insert({ tenant_id: getTenantId(), first_name: input.firstName, last_name: input.lastName ?? "", email: input.email ?? null, phone: input.phone ?? null, notes: input.notes ?? null }).select().single();
     if (error) throw error;
     return rowToCustomer(data);
   }
@@ -952,12 +1009,12 @@ var SupabaseShopProvider = class {
     if (input.email !== void 0) updates.email = input.email;
     if (input.phone !== void 0) updates.phone = input.phone;
     if (input.notes !== void 0) updates.notes = input.notes;
-    const { data, error } = await getDb().from("shop_customers").update(updates).eq("id", id).select().single();
+    const { data, error } = await getDb().from(T.customers).update(updates).eq("id", id).select().single();
     if (error) throw error;
     return rowToCustomer(data);
   }
   async deleteCustomer(id) {
-    const { error } = await getDb().from("shop_customers").delete().eq("id", id);
+    const { error } = await getDb().from(T.customers).delete().eq("id", id);
     if (error) throw error;
   }
   // Find-or-create + link to auth.uid server-side (SECURITY DEFINER RPC), so the
@@ -982,7 +1039,7 @@ var SupabaseShopProvider = class {
   async listDiscounts(options) {
     const db = getDb();
     const tenantId = getTenantId();
-    let q = db.from("shop_discounts").select("*").order("created_at", { ascending: false });
+    let q = db.from(T.discounts).select("*").order("created_at", { ascending: false });
     if (tenantId) q = q.eq("tenant_id", tenantId);
     if (options?.status) q = q.eq("status", options.status);
     if (options?.type) q = q.eq("type", options.type);
@@ -993,12 +1050,12 @@ var SupabaseShopProvider = class {
     return (data ?? []).map(rowToDiscount);
   }
   async getDiscount(id) {
-    const { data, error } = await getDb().from("shop_discounts").select("*").eq("id", id).maybeSingle();
+    const { data, error } = await getDb().from(T.discounts).select("*").eq("id", id).maybeSingle();
     if (error) throw error;
     return data ? rowToDiscount(data) : null;
   }
   async createDiscount(input) {
-    const { data, error } = await getDb().from("shop_discounts").insert({ tenant_id: getTenantId(), title: input.title, code: input.code ?? null, type: input.type, method: input.method ?? "code", value: input.value, usage_limit: input.usageLimit ?? null, once_per_customer: input.oncePerCustomer ?? false, starts_at: input.startsAt ?? (/* @__PURE__ */ new Date()).toISOString(), ends_at: input.endsAt ?? null, status: input.status ?? "active", times_used: 0 }).select().single();
+    const { data, error } = await getDb().from(T.discounts).insert({ tenant_id: getTenantId(), title: input.title, code: input.code ?? null, type: input.type, method: input.method ?? "code", value: input.value, usage_limit: input.usageLimit ?? null, once_per_customer: input.oncePerCustomer ?? false, starts_at: input.startsAt ?? (/* @__PURE__ */ new Date()).toISOString(), ends_at: input.endsAt ?? null, status: input.status ?? "active", times_used: 0 }).select().single();
     if (error) throw error;
     return rowToDiscount(data);
   }
@@ -1011,12 +1068,12 @@ var SupabaseShopProvider = class {
     if (input.usageLimit !== void 0) updates.usage_limit = input.usageLimit;
     if (input.status !== void 0) updates.status = input.status;
     if (input.endsAt !== void 0) updates.ends_at = input.endsAt;
-    const { data, error } = await getDb().from("shop_discounts").update(updates).eq("id", id).select().single();
+    const { data, error } = await getDb().from(T.discounts).update(updates).eq("id", id).select().single();
     if (error) throw error;
     return rowToDiscount(data);
   }
   async deleteDiscount(id) {
-    const { error } = await getDb().from("shop_discounts").delete().eq("id", id);
+    const { error } = await getDb().from(T.discounts).delete().eq("id", id);
     if (error) throw error;
   }
 };