@fayz-ai/shop 0.8.3 → 0.8.4

package/src/mock-provider.ts

@@ -7,6 +7,7 @@ import type {
   CreateOrderInput, UpdateOrderInput, ListOrdersOptions, PlaceOrderInput,
   CreateCustomerInput, UpdateCustomerInput, ListCustomersOptions, ResolveCustomerInput,
   CreateDiscountInput, UpdateDiscountInput, ListDiscountsOptions,
+  SalesChannel, CreateSalesChannelInput, UpdateSalesChannelInput,
 } from './types'
 import { MOCK_PRODUCTS, MOCK_CATEGORIES, MOCK_DISCOUNTS } from './mock-catalog'
 
@@ -19,6 +20,11 @@ function now() { return new Date().toISOString() }
 const ORDERS_KEY = 'fayz.shop.mock.orders.v1'
 const CUSTOMERS_KEY = 'fayz.shop.mock.customers.v1'
 const ENQUIRIES_KEY = 'fayz.shop.mock.enquiries.v1'
+const CHANNELS_KEY = 'fayz.shop.mock.channels.v1'
+
+const DEFAULT_CHANNELS: SalesChannel[] = [
+  { id: 'online-store', tenantId: 'mock', kind: 'online_store', label: 'Loja Online', url: null, enabled: true, position: 0, createdAt: now(), updatedAt: now() },
+]
 
 function loadStored<T>(key: string): T[] {
   try {
@@ -52,6 +58,10 @@ export class MockShopProvider implements ShopProvider {
   private orders: Order[] = loadStored<Order>(ORDERS_KEY)
   private customers: ShopCustomer[] = loadStored<ShopCustomer>(CUSTOMERS_KEY)
   private enquiries: ProductEnquiry[] = loadStored<ProductEnquiry>(ENQUIRIES_KEY)
+  private channels: SalesChannel[] = (() => {
+    const stored = loadStored<SalesChannel>(CHANNELS_KEY)
+    return stored.length ? stored : DEFAULT_CHANNELS.map(c => ({ ...c }))
+  })()
 
   constructor(seed?: MockShopSeed) {
     this.products = (seed?.products ?? MOCK_PRODUCTS).map(p => ({ ...p }))
@@ -64,9 +74,14 @@ export class MockShopProvider implements ShopProvider {
   private syncOrders() { this.orders = loadStored<Order>(ORDERS_KEY) }
   private syncCustomers() { this.customers = loadStored<ShopCustomer>(CUSTOMERS_KEY) }
   private syncEnquiries() { this.enquiries = loadStored<ProductEnquiry>(ENQUIRIES_KEY) }
+  private syncChannels() {
+    const stored = loadStored<SalesChannel>(CHANNELS_KEY)
+    if (stored.length) this.channels = stored
+  }
   private persistOrders() { store(ORDERS_KEY, this.orders) }
   private persistCustomers() { store(CUSTOMERS_KEY, this.customers) }
   private persistEnquiries() { store(ENQUIRIES_KEY, this.enquiries) }
+  private persistChannels() { store(CHANNELS_KEY, this.channels) }
 
   // ---------------------------------------------------------------------------
   // Products
@@ -285,13 +300,17 @@ export class MockShopProvider implements ShopProvider {
 
     // Re-read price + guard stock from the catalog (never trust the client).
     const items: CreateOrderInput['items'] = []
+    // Per-line facts for coupon scoping (productId, categoryId, line total).
+    const lineDetails: Array<{ productId: string; categoryId: string | null; lineTotal: number }> = []
     let subtotal = 0
     for (const line of input.items) {
       const product = this.products.find(p => p.id === line.productId)
       if (!product || product.status !== 'active') throw new Error(`Product unavailable: ${line.productId}`)
       if (product.inventoryCount < line.quantity) throw new Error(`Insufficient stock for ${product.name}`)
       const name = line.optionsLabel ? `${product.name} (${line.optionsLabel})` : product.name
-      subtotal += product.price * line.quantity
+      const lineTotal = product.price * line.quantity
+      subtotal += lineTotal
+      lineDetails.push({ productId: product.id, categoryId: product.categoryId, lineTotal })
       items.push({ productId: product.id, name, sku: product.sku ?? undefined, quantity: line.quantity, unitPrice: product.price, imageUrl: product.images[0]?.url })
     }
     subtotal = Math.round(subtotal * 100) / 100
@@ -304,11 +323,21 @@ export class MockShopProvider implements ShopProvider {
       const code = input.discountCode.trim().toLowerCase()
       const d = this.discounts.find(x => (x.code ?? '').toLowerCase() === code)
       const ts = now()
-      const valid = !!d && d.status === 'active' && d.startsAt <= ts && (!d.endsAt || d.endsAt >= ts) && (d.usageLimit == null || d.timesUsed < d.usageLimit)
+      const meetsMin = !d?.minSubtotal || subtotal >= d.minSubtotal
+      const valid = !!d && d.status === 'active' && d.startsAt <= ts && (!d.endsAt || d.endsAt >= ts) && (d.usageLimit == null || d.timesUsed < d.usageLimit) && meetsMin
       if (valid && d) {
         appliedCode = d.code
-        if (d.type === 'percentage') discountTotal = Math.round(subtotal * d.value) / 100
-        else if (d.type === 'fixed_amount') discountTotal = Math.min(d.value, subtotal)
+        // Eligible subtotal = the part of the cart the coupon is scoped to.
+        // applies_to='all' → whole subtotal (unchanged for legacy coupons).
+        let eligible = subtotal
+        if (d.appliesTo === 'products') {
+          eligible = lineDetails.filter(l => d.productIds.includes(l.productId)).reduce((s, l) => s + l.lineTotal, 0)
+        } else if (d.appliesTo === 'categories') {
+          eligible = lineDetails.filter(l => l.categoryId && d.categoryIds.includes(l.categoryId)).reduce((s, l) => s + l.lineTotal, 0)
+        }
+        eligible = Math.round(eligible * 100) / 100
+        if (d.type === 'percentage') discountTotal = Math.round(eligible * d.value) / 100
+        else if (d.type === 'fixed_amount') discountTotal = Math.min(d.value, eligible)
         else if (d.type === 'free_shipping') shippingTotal = 0
         // buy_x_get_y unsupported in v1: code recorded, no monetary effect
         d.timesUsed += 1
@@ -403,7 +432,7 @@ export class MockShopProvider implements ShopProvider {
   async getDiscount(id: string) { return this.discounts.find(d => d.id === id) ?? null }
 
   async createDiscount(input: CreateDiscountInput): Promise<Discount> {
-    const d: Discount = { id: uid(), tenantId: 'mock', title: input.title, code: input.code ?? null, type: input.type, method: input.method ?? 'code', value: input.value, usageLimit: input.usageLimit ?? null, oncePerCustomer: input.oncePerCustomer ?? false, startsAt: input.startsAt ?? now(), endsAt: input.endsAt ?? null, status: input.status ?? 'active', timesUsed: 0, createdAt: now(), updatedAt: now() }
+    const d: Discount = { id: uid(), tenantId: 'mock', title: input.title, code: input.code ?? null, type: input.type, method: input.method ?? 'code', value: input.value, usageLimit: input.usageLimit ?? null, oncePerCustomer: input.oncePerCustomer ?? false, minSubtotal: input.minSubtotal ?? null, appliesTo: input.appliesTo ?? 'all', productIds: input.productIds ?? [], categoryIds: input.categoryIds ?? [], startsAt: input.startsAt ?? now(), endsAt: input.endsAt ?? null, status: input.status ?? 'active', timesUsed: 0, createdAt: now(), updatedAt: now() }
     this.discounts.push(d); return d
   }
 
@@ -415,6 +444,35 @@ export class MockShopProvider implements ShopProvider {
   }
 
   async deleteDiscount(id: string) { this.discounts = this.discounts.filter(d => d.id !== id) }
+
+  // ---------------------------------------------------------------------------
+  // Sales channels
+  // ---------------------------------------------------------------------------
+
+  async listSalesChannels(): Promise<SalesChannel[]> {
+    this.syncChannels()
+    return [...this.channels].sort((a, b) => a.position - b.position)
+  }
+
+  async createSalesChannel(input: CreateSalesChannelInput): Promise<SalesChannel> {
+    this.syncChannels()
+    const c: SalesChannel = { id: uid(), tenantId: 'mock', kind: input.kind, label: input.label, url: input.url ?? null, enabled: input.enabled ?? true, position: input.position ?? this.channels.length, createdAt: now(), updatedAt: now() }
+    this.channels.push(c); this.persistChannels(); return c
+  }
+
+  async updateSalesChannel(id: string, input: UpdateSalesChannelInput): Promise<SalesChannel> {
+    this.syncChannels()
+    const i = this.channels.findIndex(c => c.id === id)
+    if (i < 0) throw new Error('Sales channel not found')
+    this.channels[i] = { ...this.channels[i], ...input, updatedAt: now() }
+    this.persistChannels(); return this.channels[i]
+  }
+
+  async deleteSalesChannel(id: string): Promise<void> {
+    this.syncChannels()
+    this.channels = this.channels.filter(c => c.id !== id)
+    this.persistChannels()
+  }
 }
 
 export function createMockShopProvider(seed?: MockShopSeed): ShopProvider {

package/src/provider.ts

@@ -9,6 +9,7 @@ import type {
   CustomerAddress, ShippingQuoteOption,
   ShippingZone, CreateShippingZoneInput, UpdateShippingZoneInput,
   CreateDiscountInput, UpdateDiscountInput, ListDiscountsOptions,
+  SalesChannel, CreateSalesChannelInput, UpdateSalesChannelInput,
 } from './types'
 
 export interface ShopProvider {
@@ -106,4 +107,11 @@ export interface ShopProvider {
   createDiscount(input: CreateDiscountInput): Promise<Discount>
   updateDiscount(id: string, input: UpdateDiscountInput): Promise<Discount>
   deleteDiscount(id: string): Promise<void>
+
+  // Sales channels — the store's points of sale (Loja Online, WhatsApp, …).
+  // Optional: a provider without them yields no "Canais de venda" section.
+  listSalesChannels?(): Promise<SalesChannel[]>
+  createSalesChannel?(input: CreateSalesChannelInput): Promise<SalesChannel>
+  updateSalesChannel?(id: string, input: UpdateSalesChannelInput): Promise<SalesChannel>
+  deleteSalesChannel?(id: string): Promise<void>
 }

package/src/supabase-provider.ts

@@ -10,6 +10,7 @@ import type {
   CreateOrderInput, UpdateOrderInput, ListOrdersOptions, PlaceOrderInput,
   CreateCustomerInput, UpdateCustomerInput, ListCustomersOptions, ResolveCustomerInput,
   CreateDiscountInput, UpdateDiscountInput, ListDiscountsOptions, OrderItem,
+  SalesChannel, CreateSalesChannelInput, UpdateSalesChannelInput,
   ShippingZone, CreateShippingZoneInput, UpdateShippingZoneInput } from './types'
 
 function getDb(): any {
@@ -195,6 +196,10 @@ function rowToDiscount(row: any): Discount {
     value: row.value ?? 0,
     usageLimit: row.usage_limit,
     oncePerCustomer: row.once_per_customer ?? false,
+    minSubtotal: row.min_subtotal ?? null,
+    appliesTo: row.applies_to ?? 'all',
+    productIds: row.product_ids ?? [],
+    categoryIds: row.category_ids ?? [],
     startsAt: row.starts_at,
     endsAt: row.ends_at,
     status: row.status ?? 'active',
@@ -204,6 +209,20 @@ function rowToDiscount(row: any): Discount {
   }
 }
 
+function rowToSalesChannel(row: any): SalesChannel {
+  return {
+    id: row.id,
+    tenantId: row.tenant_id,
+    kind: row.kind,
+    label: row.label,
+    url: row.url,
+    enabled: row.enabled ?? true,
+    position: row.position ?? 0,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+  }
+}
+
 export class SupabaseShopProvider implements ShopProvider {
   // ---------------------------------------------------------------------------
   // Products
@@ -660,7 +679,7 @@ export class SupabaseShopProvider implements ShopProvider {
   async createDiscount(input: CreateDiscountInput): Promise<Discount> {
     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 ?? new Date().toISOString(), ends_at: input.endsAt ?? null, status: input.status ?? 'active', times_used: 0 })
+      .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, min_subtotal: input.minSubtotal ?? null, applies_to: input.appliesTo ?? 'all', product_ids: input.productIds ?? [], category_ids: input.categoryIds ?? [], starts_at: input.startsAt ?? new Date().toISOString(), ends_at: input.endsAt ?? null, status: input.status ?? 'active', times_used: 0 })
       .select().single()
     if (error) throw error
     return rowToDiscount(data)
@@ -673,6 +692,10 @@ export class SupabaseShopProvider implements ShopProvider {
     if (input.type !== undefined) updates.type = input.type
     if (input.value !== undefined) updates.value = input.value
     if (input.usageLimit !== undefined) updates.usage_limit = input.usageLimit
+    if (input.minSubtotal !== undefined) updates.min_subtotal = input.minSubtotal
+    if (input.appliesTo !== undefined) updates.applies_to = input.appliesTo
+    if (input.productIds !== undefined) updates.product_ids = input.productIds
+    if (input.categoryIds !== undefined) updates.category_ids = input.categoryIds
     if (input.status !== undefined) updates.status = input.status
     if (input.endsAt !== undefined) updates.ends_at = input.endsAt
     const { data, error } = await getDb().from(T.discounts).update(updates).eq('id', id).select().single()
@@ -684,6 +707,46 @@ export class SupabaseShopProvider implements ShopProvider {
     const { error } = await getDb().from(T.discounts).delete().eq('id', id)
     if (error) throw error
   }
+
+  // ---------------------------------------------------------------------------
+  // Sales channels
+  // ---------------------------------------------------------------------------
+
+  async listSalesChannels(): Promise<SalesChannel[]> {
+    const db = getDb()
+    const tenantId = getTenantId()
+    let q = db.from(T.salesChannels).select('*').order('position', { ascending: true })
+    if (tenantId) q = q.eq('tenant_id', tenantId)
+    const { data, error } = await q
+    if (error) throw error
+    return (data ?? []).map(rowToSalesChannel)
+  }
+
+  async createSalesChannel(input: CreateSalesChannelInput): Promise<SalesChannel> {
+    const { data, error } = await getDb()
+      .from(T.salesChannels)
+      .insert({ tenant_id: getTenantId(), kind: input.kind, label: input.label, url: input.url ?? null, enabled: input.enabled ?? true, position: input.position ?? 0 })
+      .select().single()
+    if (error) throw error
+    return rowToSalesChannel(data)
+  }
+
+  async updateSalesChannel(id: string, input: UpdateSalesChannelInput): Promise<SalesChannel> {
+    const updates: Record<string, unknown> = {}
+    if (input.kind !== undefined) updates.kind = input.kind
+    if (input.label !== undefined) updates.label = input.label
+    if (input.url !== undefined) updates.url = input.url
+    if (input.enabled !== undefined) updates.enabled = input.enabled
+    if (input.position !== undefined) updates.position = input.position
+    const { data, error } = await getDb().from(T.salesChannels).update(updates).eq('id', id).select().single()
+    if (error) throw error
+    return rowToSalesChannel(data)
+  }
+
+  async deleteSalesChannel(id: string): Promise<void> {
+    const { error } = await getDb().from(T.salesChannels).delete().eq('id', id)
+    if (error) throw error
+  }
 }
 
 export function createSupabaseShopProvider(): ShopProvider {

package/src/tables.ts

@@ -9,6 +9,7 @@ export const T = {
   orderItems: 'plg_shop_order_items',
   customers: 'plg_shop_customers',
   discounts: 'plg_shop_discounts',
+  salesChannels: 'plg_shop_channels',
   // Core, not plg_shop_*: a delivery zone is a fact about the business, and
   // fulfilment and financial read it too. Same reasoning as addresses and
   // orders — see migration 0021.

package/src/types.ts

@@ -453,6 +453,9 @@ export type DiscountType = 'percentage' | 'fixed_amount' | 'free_shipping' | 'bu
 export type DiscountMethod = 'code' | 'automatic'
 export type DiscountStatus = 'active' | 'expired' | 'scheduled' | 'draft'
 
+/** What subset of the cart a discount applies to. 'all' = order-wide (default). */
+export type DiscountScope = 'all' | 'products' | 'categories'
+
 export interface Discount {
   id: string
   tenantId: string
@@ -463,6 +466,15 @@ export interface Discount {
   value: number
   usageLimit: number | null
   oncePerCustomer: boolean
+  /** Minimum order subtotal for the coupon to apply (pedido mínimo). Null = none. */
+  minSubtotal: number | null
+  /** Scope of the discount. 'products'/'categories' restrict it to the eligible
+   *  line items; the %/valor then applies to that eligible subtotal only. */
+  appliesTo: DiscountScope
+  /** When appliesTo='products', the eligible product ids. */
+  productIds: string[]
+  /** When appliesTo='categories', the eligible category ids. */
+  categoryIds: string[]
   startsAt: string
   endsAt: string | null
   status: DiscountStatus
@@ -479,6 +491,10 @@ export interface CreateDiscountInput {
   value: number
   usageLimit?: number
   oncePerCustomer?: boolean
+  minSubtotal?: number | null
+  appliesTo?: DiscountScope
+  productIds?: string[]
+  categoryIds?: string[]
   startsAt?: string
   endsAt?: string
   status?: DiscountStatus
@@ -492,6 +508,10 @@ export interface UpdateDiscountInput {
   value?: number
   usageLimit?: number | null
   oncePerCustomer?: boolean
+  minSubtotal?: number | null
+  appliesTo?: DiscountScope
+  productIds?: string[]
+  categoryIds?: string[]
   startsAt?: string
   endsAt?: string | null
   status?: DiscountStatus
@@ -505,6 +525,53 @@ export interface ListDiscountsOptions {
   offset?: number
 }
 
+// ---------------------------------------------------------------------------
+// Sales channels — the store's points of sale (Loja Online, WhatsApp, TikTok…).
+// A channel is per-tenant (the store IS the tenant). The 'online_store' channel
+// points at the merchant's fayz storefront; the rest are external links the
+// merchant maintains. Surfaced as a "Canais de venda" group in the admin nav.
+// ---------------------------------------------------------------------------
+
+export type SalesChannelKind =
+  | 'online_store'
+  | 'whatsapp'
+  | 'instagram'
+  | 'tiktok_shop'
+  | 'marketplace'
+  | 'physical'
+  | 'custom'
+
+export interface SalesChannel {
+  id: string
+  tenantId: string
+  kind: SalesChannelKind
+  label: string
+  /** External URL opened from the sidebar / channels page. Null while unconfigured
+   *  (e.g. the Loja Online channel before the storefront address is set). */
+  url: string | null
+  enabled: boolean
+  /** Sidebar/list ordering (lower first). */
+  position: number
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateSalesChannelInput {
+  kind: SalesChannelKind
+  label: string
+  url?: string | null
+  enabled?: boolean
+  position?: number
+}
+
+export interface UpdateSalesChannelInput {
+  kind?: SalesChannelKind
+  label?: string
+  url?: string | null
+  enabled?: boolean
+  position?: number
+}
+
 // ---------------------------------------------------------------------------
 // Commerce primitives (FAY-1193) — provider-agnostic helpers for custom workflows
 // ---------------------------------------------------------------------------