@thorprovider/blocks 0.1.3 → 2.0.0

package/src/lib/contracts.test.ts

@@ -1,5 +1,13 @@
 import { describe, expect, it } from 'vitest'
-import { storeCategorySchema } from './contracts'
+import { z } from 'zod'
+import {
+  categoryCardPropsSchema,
+  categoryGridPropsSchema,
+  navbarPropsSchema,
+  productCardPropsSchema,
+  productGridPropsSchema,
+  storeCategorySchema,
+} from './contracts'
 
 describe('storeCategorySchema', () => {
   it('accepts flat categories (additive backward compatibility)', () => {
@@ -29,4 +37,192 @@ describe('storeCategorySchema', () => {
     expect(storeCategorySchema.safeParse({ label: 'Solo', href: '/categorias/x', children: [{}] }).success).toBe(false)
     expect(storeCategorySchema.safeParse({}).success).toBe(false)
   })
-})
+})
+
+describe('productCardPropsSchema', () => {
+  const canonicalItem = {
+    id: 'sku-1',
+    title: 'Llave de impacto',
+    price: { amount: '129.50', currencyCode: 'EUR' },
+  }
+
+  it('accepts a single canonical Money item with the bounded presentation options', () => {
+    expect(productCardPropsSchema.safeParse({ item: canonicalItem }).success).toBe(true)
+    expect(
+      productCardPropsSchema.safeParse({
+        item: canonicalItem,
+        presentation: 'classic',
+        wishlisted: true,
+      }).success,
+    ).toBe(true)
+    expect(
+      productCardPropsSchema.safeParse({ item: canonicalItem, presentation: 'rich' }).success,
+    ).toBe(true)
+  })
+
+  it('rejects a collection in place of the single item', () => {
+    expect(productCardPropsSchema.safeParse({ items: [canonicalItem] }).success).toBe(false)
+  })
+
+  it('rejects legacy numeric-price items', () => {
+    expect(
+      productCardPropsSchema.safeParse({ item: { id: 'p1', title: 'Taladro', price: 49.99, image: '/x.svg' } })
+        .success,
+    ).toBe(false)
+  })
+
+  it('rejects unknown presentation options', () => {
+    expect(
+      productCardPropsSchema.safeParse({ item: canonicalItem, presentation: 'compact' }).success,
+    ).toBe(false)
+  })
+})
+
+describe('productGridPropsSchema', () => {
+  const canonicalItem = {
+    id: 'sku-1',
+    title: 'Llave de impacto',
+    price: { amount: '129.50', currencyCode: 'EUR' },
+  }
+
+  it('accepts a collection with the listing state options', () => {
+    expect(productGridPropsSchema.safeParse({ items: [canonicalItem] }).success).toBe(true)
+    expect(
+      productGridPropsSchema.safeParse({
+        items: [canonicalItem],
+        presentation: 'minimal',
+        heading: 'Destacados',
+        maxItems: 6,
+        wishlistedIds: ['sku-1'],
+        loading: false,
+        skeletonCount: 6,
+        emptyLabel: 'Sin productos',
+      }).success,
+    ).toBe(true)
+  })
+
+  it('declares only serializable keys — no callbacks or label strings', () => {
+    const runtimeOnlyKeys = [
+      'onAddToCart',
+      'onProductClick',
+      'onToggleWishlist',
+      'onViewSimilar',
+      'addToCartLabel',
+      'unavailablePriceLabel',
+      'addToWishlistLabel',
+      'removeFromWishlistLabel',
+      'viewSimilarLabel',
+    ]
+    const schemaOwnedLabelKeys = new Set(['emptyLabel'])
+    const schemas: Array<{ name: string; schema: z.AnyZodObject }> = [
+      { name: 'productCardPropsSchema', schema: productCardPropsSchema },
+      { name: 'productGridPropsSchema', schema: productGridPropsSchema },
+    ]
+
+    for (const { name, schema } of schemas) {
+      const declaredKeys = Object.keys(schema.shape)
+      expect(declaredKeys.length, name).toBeGreaterThan(0)
+      for (const key of declaredKeys) {
+        expect(runtimeOnlyKeys, `${name}.${key}`).not.toContain(key)
+        expect(key, `${name}.${key}`).not.toMatch(/^on[A-Z]/)
+        if (!schemaOwnedLabelKeys.has(key)) {
+          expect(key, `${name}.${key}`).not.toMatch(/Label$/)
+        }
+        expect(schema.shape[key], `${name}.${key}`).not.toBeInstanceOf(z.ZodFunction)
+      }
+    }
+  })
+
+  it('rejects non-positive maxItems and skeletonCount', () => {
+    expect(productGridPropsSchema.safeParse({ items: [], maxItems: 0 }).success).toBe(false)
+    expect(productGridPropsSchema.safeParse({ items: [], skeletonCount: 0 }).success).toBe(false)
+  })
+})
+
+describe('category cell and listing contracts', () => {
+  const category = { id: 'cat-tools', name: 'Herramientas' }
+
+  it('keeps category cell and listing props JSON-serializable and callback-free', () => {
+    const samples: Array<{ name: string; schema: z.AnyZodObject; props: unknown }> = [
+      {
+        name: 'categoryCardPropsSchema',
+        schema: categoryCardPropsSchema,
+        props: { category, presentation: 'grid', browseLabel: 'Explorar' },
+      },
+      {
+        name: 'categoryGridPropsSchema',
+        schema: categoryGridPropsSchema,
+        props: { categories: [category], presentation: 'grid', title: 'Categorías', maxItems: 4 },
+      },
+    ]
+
+    for (const { name, schema, props } of samples) {
+      const parsed = schema.parse(props)
+      expect(JSON.parse(JSON.stringify(parsed)), name).toEqual(parsed)
+      for (const key of Object.keys(schema.shape)) {
+        expect(key, `${name}.${key}`).not.toMatch(/^on[A-Z]/)
+        expect(schema.shape[key], `${name}.${key}`).not.toBeInstanceOf(z.ZodFunction)
+      }
+    }
+  })
+
+  it('keeps display labels serializable strings and rejects a collection in the cell contract', () => {
+    expect(categoryCardPropsSchema.safeParse({ category, browseLabel: () => 'Explorar' }).success).toBe(false)
+    expect(categoryGridPropsSchema.safeParse({ categories: [], emptyLabel: () => 'Vacío' }).success).toBe(false)
+    expect(categoryCardPropsSchema.safeParse({ categories: [category] }).success).toBe(false)
+  })
+})
+
+describe('navbarPropsSchema', () => {
+  const full = {
+    presentation: 'mega' as const,
+    logoText: 'ElectroCuba',
+    logoHref: '/',
+    currentPath: '/tienda',
+    links: [
+      {
+        label: 'Catálogo',
+        groups: [
+          {
+            title: 'Esenciales',
+            items: [{ label: 'Camisas', href: '/camisas', description: 'Cortes diarios', icon: 'shirt' }],
+          },
+        ],
+      },
+      { label: 'Nosotros', href: '/nosotros', emphasis: true },
+    ],
+    featured: {
+      eyebrow: 'Nueva temporada',
+      title: 'Lino',
+      description: 'Capas transpirables',
+      href: '/lino',
+      linkLabel: 'Descubrir',
+      image: '/lino.jpg',
+      imageAlt: 'Camisa de lino',
+    },
+    signIn: { label: 'Entrar', href: '/cuenta' },
+    cta: { label: 'Comprar' },
+    className: 'bg-brand-nav text-brand-nav-foreground',
+  }
+
+  it('round-trips a fully populated header', () => {
+    expect(navbarPropsSchema.parse(full)).toEqual(full)
+  })
+
+  it('requires the brand text and the links list', () => {
+    expect(navbarPropsSchema.safeParse({ ...full, logoText: undefined }).success).toBe(false)
+    expect(navbarPropsSchema.safeParse({ logoText: 'ElectroCuba' }).success).toBe(false)
+  })
+
+  it('rejects non-string hrefs and unknown presentations', () => {
+    expect(navbarPropsSchema.safeParse({ logoText: 'X', links: [{ label: 'Y', href: 42 }] }).success).toBe(false)
+    expect(navbarPropsSchema.safeParse({ ...full, presentation: 'sidebar' }).success).toBe(false)
+  })
+
+  it('cannot carry host bindings across the serializable boundary', () => {
+    const parsed = navbarPropsSchema.parse({ ...full, iconMap: { shirt: () => null }, onSignIn: () => {} })
+
+    expect(parsed).not.toHaveProperty('iconMap')
+    expect(parsed).not.toHaveProperty('onSignIn')
+  })
+})