@fayz-ai/plugin-shop 0.9.0 → 0.9.1

package/src/views/discountEntity.tsx

@@ -1,144 +0,0 @@
-import React from 'react'
-import type { EntityDef, FieldDef } from '@fayz-ai/core'
-import type { Discount } from '@fayz-ai/shop'
-
-// ---------------------------------------------------------------------------
-// Discount — declarative CRUD, same contract as products and customers.
-//
-// `timesUsed` is read-only: shop_place_order increments it inside the same
-// transaction that validates the coupon, so the admin must never write it.
-//
-// `buy_x_get_y` is deliberately absent from the type options: the enum value
-// exists in the database but shop_place_order records the code and applies no
-// monetary effect (0003:116), so offering it would create coupons that silently
-// do nothing.
-// ---------------------------------------------------------------------------
-
-const STATUS_TONE: Record<string, string> = {
-  active: 'bg-emerald-100 text-emerald-800',
-  draft: 'bg-gray-100 text-gray-700',
-  expired: 'bg-orange-100 text-orange-700',
-  disabled: 'bg-red-100 text-red-700',
-}
-
-export function buildShopDiscountEntity(): EntityDef<Discount> {
-  const fields: FieldDef[] = [
-    // — Cupom —
-    {
-      key: 'title', label: 'Nome interno', type: 'text', required: true,
-      group: 'coupon', placeholder: 'Bem-vindo 10%',
-      hint: 'Só o admin vê. Serve para você identificar a campanha.',
-      searchable: true, showInTable: true, sortable: true,
-      renderCell: (_v, row: any) => (
-        <div className="min-w-0">
-          <p className="truncate font-medium">{row.title}</p>
-          {row.code && <p className="font-mono text-xs text-muted-foreground">{row.code}</p>}
-        </div>
-      ),
-    },
-    {
-      key: 'code', label: 'Código', type: 'text', group: 'coupon',
-      placeholder: 'ARTORIUS10',
-      hint: 'O que o cliente digita no carrinho. Maiúsculas e minúsculas não importam.',
-      searchable: true, showInTable: false,
-    },
-
-    // — Regra —
-    {
-      key: 'type', label: 'Tipo', type: 'segmented', required: true, group: 'rule', span: 2,
-      options: [
-        { label: 'Percentual', value: 'percentage', description: 'Desconta uma % do subtotal.' },
-        { label: 'Valor fixo', value: 'fixed_amount', description: 'Desconta um valor em reais.' },
-        { label: 'Frete grátis', value: 'free_shipping', description: 'Zera o frete do pedido.' },
-      ],
-      showInTable: true, sortable: false,
-      renderCell: (v) => {
-        const labels: Record<string, string> = {
-          percentage: 'Percentual', fixed_amount: 'Valor fixo', free_shipping: 'Frete grátis', buy_x_get_y: 'Leve X pague Y',
-        }
-        return <span className="text-muted-foreground">{labels[String(v)] ?? String(v)}</span>
-      },
-    },
-    {
-      key: 'value', label: 'Valor', type: 'number', group: 'rule', min: 0,
-      placeholder: '10',
-      hint: 'Percentual: 10 = 10%. Valor fixo: 10 = R$ 10,00. Frete grátis ignora este campo.',
-      showInTable: true, sortable: true,
-      renderCell: (_v, row: any) => (
-        <span className="block text-right font-medium">
-          {row.type === 'percentage'
-            ? `${row.value}%`
-            : row.type === 'free_shipping'
-              ? '—'
-              : new Intl.NumberFormat('pt-BR', { style: 'currency', currency: 'BRL' }).format(Number(row.value) || 0)}
-        </span>
-      ),
-    },
-
-    // — Limites —
-    {
-      key: 'minSubtotal', label: 'Pedido mínimo', type: 'currency', group: 'limits', min: 0,
-      currency: 'BRL', currencySymbol: 'R$', currencyLocale: 'pt-BR',
-      placeholder: 'sem mínimo',
-      hint: 'Valor mínimo do pedido para o cupom valer. Deixe vazio para não exigir mínimo.',
-      showInTable: false,
-    },
-    {
-      key: 'usageLimit', label: 'Limite de usos', type: 'number', group: 'limits', min: 0,
-      placeholder: 'sem limite', hint: 'Deixe vazio para uso ilimitado.', showInTable: false,
-    },
-    {
-      key: 'oncePerCustomer', label: 'Uma vez por cliente', type: 'boolean', group: 'limits',
-      hint: 'Só vale para quem se identifica no checkout — compra como visitante não é rastreada.',
-      showInTable: false,
-    },
-    {
-      key: 'timesUsed', label: 'Usos', type: 'number',
-      showInForm: false, showInTable: true, sortable: true,
-      renderCell: (_v, row: any) => (
-        <span className="block text-right text-muted-foreground">
-          {row.timesUsed}{row.usageLimit ? ` / ${row.usageLimit}` : ''}
-        </span>
-      ),
-    },
-
-    // — Vigência —
-    { key: 'startsAt', label: 'Início', type: 'date', group: 'schedule', showInTable: false },
-    {
-      key: 'endsAt', label: 'Fim', type: 'date', group: 'schedule',
-      hint: 'Vazio = sem data de expiração.', showInTable: false,
-    },
-    {
-      key: 'status', label: 'Status', type: 'segmented', required: true, group: 'schedule', span: 2,
-      options: [
-        { label: 'Rascunho', value: 'draft', description: 'Não aceito no carrinho.' },
-        { label: 'Ativo', value: 'active', description: 'Valendo agora.' },
-        { label: 'Desativado', value: 'disabled', description: 'Suspenso sem apagar o histórico.' },
-      ],
-      showInTable: true, sortable: false,
-      renderCell: (v) => {
-        const s = String(v ?? 'draft')
-        return (
-          <span className={`inline-flex items-center rounded-full px-2 py-0.5 text-[10px] font-medium ${STATUS_TONE[s] ?? STATUS_TONE.draft}`}>
-            {s}
-          </span>
-        )
-      },
-    },
-  ]
-
-  return {
-    name: 'Desconto',
-    namePlural: 'Descontos',
-    icon: 'Tag',
-    displayField: 'title',
-    fields,
-    fieldGroups: [
-      { id: 'coupon', label: 'Cupom', columns: 2 },
-      { id: 'rule', label: 'Regra', description: 'O desconto é recalculado no servidor a cada pedido.', columns: 2 },
-      { id: 'limits', label: 'Limites de uso', columns: 2 },
-      { id: 'schedule', label: 'Vigência', columns: 2 },
-    ],
-    facets: [{ field: 'status', allLabel: 'Todos' }],
-  } as EntityDef<Discount>
-}

package/src/views/productEntity.tsx

@@ -1,229 +0,0 @@
-import React from 'react'
-import type { EntityDef, EntityImageConfig, FieldDef } from '@fayz-ai/core'
-import type { Product, ShopProvider } from '@fayz-ai/shop'
-import { ProductImagesTab } from './ProductImagesTab'
-
-// ---------------------------------------------------------------------------
-// Storefront Product — the single source of truth for the shop product CRUD.
-// Drives the list columns AND the form sections via the generic CRUD scaffolding
-// (createCrudPage → CrudListView + CrudFormPage), same pattern plugin-inventory
-// uses for its ERP product.
-//
-// This is deliberately the STOREFRONT shape (what a shopper sees: name, price,
-// compare-at, images, publication status), not the ERP shape plugin-inventory
-// models (cost, margin, min/max levels). They are different products in
-// different tables — see the shop/inventory bridge note in the roadmap.
-//
-// Not modelled here because the schema has nowhere to put them yet:
-//   • variants (options/SKU/stock per variant) — needs plg_shop_variants
-//   • SEO title/description — needs columns on plg_shop_products
-//   • multi-category — the column is a single category_id
-// ---------------------------------------------------------------------------
-
-const STATUS_TONE: Record<string, string> = {
-  active: 'bg-emerald-100 text-emerald-800',
-  draft: 'bg-gray-100 text-gray-700',
-  archived: 'bg-orange-100 text-orange-700',
-}
-
-const STATUS_LABEL: Record<string, string> = {
-  active: 'Ativo',
-  draft: 'Rascunho',
-  archived: 'Arquivado',
-}
-
-function money(value: unknown, currency = 'BRL') {
-  const n = Number(value)
-  if (!Number.isFinite(n)) return '—'
-  return new Intl.NumberFormat('pt-BR', { style: 'currency', currency }).format(n)
-}
-
-/** `name` → `name-do-produto`, so the storefront URL is filled in for you. */
-export function slugify(value: string): string {
-  return value
-    .normalize('NFD')
-    .replace(/[\u0300-\u036f]/g, '')
-    .toLowerCase()
-    .trim()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-}
-
-/**
- * Wires the form's image slot to the product's own images. `uploadProductImage`
- * has existed on the provider all along with nothing calling it — the slot was a
- * decorative square, so a product with a photo still showed an empty placeholder.
- */
-function productImage(getProvider: () => ShopProvider): EntityImageConfig {
-  return {
-    get: (row) => {
-      const images = (row as Partial<Product>).images
-      return images?.find((i) => i.isPrimary)?.url ?? images?.[0]?.url
-    },
-    upload: async (file, row) => {
-      if (!row.id) throw new Error('Salve o produto antes de enviar a imagem.')
-      const image = await getProvider().uploadProductImage(row.id, file)
-      return image.url
-    },
-    accept: 'image/*',
-  }
-}
-
-export function buildShopProductEntity(
-  currencyCode = 'BRL',
-  getProvider?: () => ShopProvider,
-): EntityDef<Product> {
-  const fields: FieldDef[] = [
-    // — Geral —
-    {
-      key: 'name', label: 'Nome do produto', type: 'text', required: true,
-      group: 'general', placeholder: 'Costela Bovina Defumada 400g',
-      searchable: true, showInTable: true, sortable: true,
-      renderCell: (_v, row: any) => (
-        <div className="flex items-center gap-3">
-          {row.images?.[0]?.url && (
-            <img
-              src={row.images[0].url}
-              alt=""
-              className="h-9 w-9 rounded object-cover"
-              loading="lazy"
-            />
-          )}
-          <div className="min-w-0">
-            <p className="truncate font-medium">{row.name}</p>
-            {row.sku && <p className="text-xs text-muted-foreground">{row.sku}</p>}
-          </div>
-        </div>
-      ),
-    },
-    {
-      key: 'slug', label: 'URL', type: 'text', group: 'general',
-      placeholder: 'gerado a partir do nome',
-      hint: 'Endereço do produto na loja. Deixe em branco para gerar automaticamente.',
-      showInTable: false,
-    },
-    {
-      key: 'description', label: 'Descrição', type: 'textarea', group: 'general', span: 2,
-      placeholder: 'Como é feito, como preparar, o que acompanha…',
-      showInTable: false,
-    },
-
-    // — Preço —
-    {
-      key: 'price', label: 'Preço de venda', type: 'currency', required: true,
-      group: 'pricing', currency: currencyCode, currencySymbol: 'R$', currencyLocale: 'pt-BR',
-      showInTable: true, sortable: true,
-      renderCell: (v, row: any) => (
-        <div className="text-right">
-          <span className="font-medium">{money(v, row.currency)}</span>
-          {row.compareAtPrice > row.price && (
-            <span className="ml-2 text-xs text-muted-foreground line-through">
-              {money(row.compareAtPrice, row.currency)}
-            </span>
-          )}
-        </div>
-      ),
-    },
-    {
-      key: 'compareAtPrice', label: 'Preço comparativo', type: 'currency', group: 'pricing',
-      currency: currencyCode, currencySymbol: 'R$', currencyLocale: 'pt-BR',
-      hint: 'Preço "de" riscado. Deixe vazio se não estiver em promoção.',
-      showInTable: false,
-    },
-    {
-      key: 'discount', label: 'Desconto', type: 'computed', group: 'pricing', showInTable: false,
-      compute: (vals) => {
-        const price = Number(vals.price) || 0
-        const compare = Number(vals.compareAtPrice) || 0
-        if (compare <= 0 || price <= 0 || compare <= price) return null
-        const pct = ((compare - price) / compare) * 100
-        return { display: `-${pct.toFixed(0)}%`, tone: 'positive' }
-      },
-    },
-
-    // — Estoque —
-    {
-      key: 'sku', label: 'SKU', type: 'text', group: 'inventory',
-      placeholder: 'ART-001', searchable: true, showInTable: false,
-    },
-    {
-      key: 'inventoryCount', label: 'Estoque', type: 'number', group: 'inventory', min: 0,
-      placeholder: '0', hint: 'Chega a zero e o produto aparece como esgotado na loja.',
-      showInTable: true, sortable: true,
-      renderCell: (v) => {
-        const n = Number(v) || 0
-        return (
-          <span className={`block text-right ${n === 0 ? 'font-medium text-destructive' : n <= 3 ? 'text-orange-600' : ''}`}>
-            {n}
-          </span>
-        )
-      },
-    },
-
-    // — Publicação —
-    {
-      key: 'status', label: 'Status', type: 'segmented', required: true,
-      group: 'publishing', span: 2,
-      options: [
-        { label: 'Rascunho', value: 'draft', description: 'Só você vê. Não aparece na loja.' },
-        { label: 'Ativo', value: 'active', description: 'Publicado e à venda.' },
-        { label: 'Arquivado', value: 'archived', description: 'Fora da loja, histórico preservado.' },
-      ],
-      showInTable: true, sortable: false,
-      renderCell: (v) => {
-        const s = String(v ?? 'draft')
-        return (
-          <span className={`inline-flex items-center rounded-full px-2 py-0.5 text-[10px] font-medium ${STATUS_TONE[s] ?? STATUS_TONE.draft}`}>
-            {STATUS_LABEL[s] ?? s}
-          </span>
-        )
-      },
-    },
-    {
-      key: 'sortOrder', label: 'Ordem na vitrine', type: 'number', group: 'publishing',
-      placeholder: '0', hint: 'Menor aparece primeiro.', showInTable: false,
-    },
-
-    // — Envio —
-    {
-      key: 'isPhysical', label: 'Produto físico', type: 'boolean', group: 'shipping',
-      hint: 'Desmarque para itens digitais, que não calculam frete.', showInTable: false,
-    },
-    { key: 'weight', label: 'Peso', type: 'number', group: 'shipping', min: 0, placeholder: '0.4', showInTable: false },
-    {
-      key: 'weightUnit', label: 'Unidade', type: 'select', group: 'shipping', showInTable: false,
-      options: [{ label: 'kg', value: 'kg' }, { label: 'g', value: 'g' }, { label: 'lb', value: 'lb' }],
-    },
-  ]
-
-  return {
-    name: 'Produto',
-    namePlural: 'Produtos',
-    icon: 'Package',
-    displayField: 'name',
-    fields,
-    fieldGroups: [
-      // imageSlot renders the scaffolding's image uploader alongside the group.
-      { id: 'general', label: 'Informações', columns: 2, imageSlot: true },
-      { id: 'pricing', label: 'Preço', description: 'O preço comparativo vira o "de" riscado na vitrine.', columns: 3 },
-      { id: 'inventory', label: 'Estoque', columns: 2 },
-      { id: 'publishing', label: 'Publicação', description: 'Controla se o produto aparece na loja.', columns: 2 },
-      { id: 'shipping', label: 'Envio', columns: 3 },
-    ],
-    facets: [{ field: 'status', allLabel: 'Todos' }],
-    image: getProvider ? productImage(getProvider) : undefined,
-    // The form's image slot sets the COVER; this tab manages the rest of the
-    // gallery. plg_shop_product_images has always held a collection, and until
-    // now nothing in the admin could add a second row to it — so the storefront
-    // carousel had exactly one slide for every product in the pool.
-    detailTabs: getProvider
-      ? [{
-          id: 'images',
-          label: 'Fotos',
-          icon: 'Image',
-          component: ProductImagesTab as never,
-          props: { getProvider },
-        }]
-      : undefined,
-  } as EntityDef<Product>
-}

package/src/views/shippingZoneEntity.tsx

@@ -1,123 +0,0 @@
-import React from 'react'
-import type { EntityDef, FieldDef } from '@fayz-ai/core'
-import type { ShippingZone } from '@fayz-ai/shop'
-
-// ---------------------------------------------------------------------------
-// Delivery zone — declarative CRUD, same contract as products and discounts.
-//
-// A zone is a range of postal codes with its own price and estimate. Ranges may
-// overlap on purpose: the cheapest match wins, which is how a merchant layers a
-// promotion over a broader zone without deleting the broader one.
-//
-// The two things worth being loud about in the UI:
-//   · a store with NO zones keeps charging its flat rate — zones are opt-in;
-//   · once the first zone exists, an address outside every zone can no longer
-//     order (shop_place_order refuses it), so the first save changes who can buy.
-// ---------------------------------------------------------------------------
-
-const cep = (value: string | undefined): string => {
-  const digits = String(value ?? '').replace(/\D/g, '').padStart(8, '0')
-  return `${digits.slice(0, 5)}-${digits.slice(5)}`
-}
-
-export function buildShopShippingZoneEntity(currency = 'BRL'): EntityDef<ShippingZone> {
-  const money = (value: number | null | undefined) =>
-    value == null
-      ? '—'
-      : new Intl.NumberFormat('pt-BR', { style: 'currency', currency }).format(Number(value))
-
-  const fields: FieldDef[] = [
-    {
-      key: 'name', label: 'Nome da zona', type: 'text', required: true, group: 'zone',
-      placeholder: 'Rio de Janeiro — capital',
-      hint: 'Aparece para o cliente na hora de escolher a entrega.',
-      searchable: true, showInTable: true, sortable: true,
-    },
-    {
-      key: 'carrier', label: 'Transportadora', type: 'text', group: 'zone',
-      placeholder: 'Correios, motoboy próprio…',
-      hint: 'Opcional. Mostrado antes do nome da zona quando preenchido.',
-      showInTable: true,
-    },
-    {
-      key: 'postalFrom', label: 'CEP inicial', type: 'text', required: true, group: 'zone',
-      placeholder: '20000-000',
-      hint: 'Início da faixa. Pode digitar com ou sem traço.',
-      showInTable: true,
-      renderCell: (_v, row: any) => (
-        <span className="whitespace-nowrap font-mono text-xs">
-          {cep(row.postalFrom)} → {cep(row.postalTo)}
-        </span>
-      ),
-    },
-    {
-      key: 'postalTo', label: 'CEP final', type: 'text', required: true, group: 'zone',
-      placeholder: '23799-999',
-      hint: 'Fim da faixa, inclusive.',
-      showInTable: false,
-    },
-    {
-      key: 'rate', label: 'Valor do frete', type: 'number', required: true, group: 'pricing',
-      hint: 'Cobrado nos pedidos entregues nessa faixa.',
-      showInTable: true, sortable: true,
-      renderCell: (value: any) => <span className="tabular-nums">{money(value)}</span>,
-    },
-    {
-      key: 'freeAbove', label: 'Frete grátis acima de', type: 'number', group: 'pricing',
-      hint: 'Deixe vazio para nunca dar frete grátis nessa zona. Vale mais que a regra geral da loja.',
-      showInTable: true,
-      renderCell: (value: any) => <span className="tabular-nums">{money(value)}</span>,
-    },
-    {
-      key: 'etaMinDays', label: 'Prazo mínimo (dias)', type: 'number', group: 'delivery',
-      hint: '0 = no mesmo dia.',
-      showInTable: false,
-    },
-    {
-      key: 'etaMaxDays', label: 'Prazo máximo (dias)', type: 'number', group: 'delivery',
-      hint: 'O cliente vê a faixa "de X a Y dias úteis" na página do produto.',
-      showInTable: true,
-      renderCell: (_v, row: any) =>
-        row.etaMinDays == null && row.etaMaxDays == null
-          ? <span className="text-muted-foreground">—</span>
-          : <span>{row.etaMinDays ?? 0}–{row.etaMaxDays ?? row.etaMinDays} dias</span>,
-    },
-    {
-      key: 'active', label: 'Ativa', type: 'boolean', group: 'delivery',
-      hint: 'Desativar para de cotar essa faixa sem apagar a configuração.',
-      showInTable: true,
-      renderCell: (value: any) => (
-        <span className={`rounded-full px-2 py-0.5 text-xs font-medium ${
-          value ? 'bg-emerald-100 text-emerald-800' : 'bg-gray-100 text-gray-700'}`}>
-          {value ? 'Ativa' : 'Inativa'}
-        </span>
-      ),
-    },
-    {
-      key: 'sortOrder', label: 'Ordem', type: 'number', group: 'delivery',
-      hint: 'Desempate quando duas zonas custam o mesmo. Menor aparece primeiro.',
-      showInTable: false,
-    },
-  ]
-
-  return {
-    name: 'Zona de entrega',
-    namePlural: 'Entrega',
-    icon: 'Truck',
-    displayField: 'name',
-    fields,
-    fieldGroups: [
-      {
-        id: 'zone', label: 'Faixa de CEP', columns: 2,
-        description:
-          'Faixas podem se sobrepor: quando duas cobrem o mesmo CEP, o cliente paga a mais barata.',
-      },
-      {
-        id: 'pricing', label: 'Preço', columns: 2,
-        description: 'O frete cobrado é recalculado no servidor a cada pedido, a partir daqui.',
-      },
-      { id: 'delivery', label: 'Prazo e status', columns: 2 },
-    ],
-    facets: [{ field: 'active', allLabel: 'Todas' }],
-  } as EntityDef<ShippingZone>
-}