@pcreative/commerce-contract 1.2.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pcreative/commerce-contract",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Contrato de datos de commerce: los tipos que consume un tema y los adaptadores que los resuelven. Sin dependencias ni SDK del backend.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",

package/src/adapters/api.js

@@ -359,6 +359,11 @@ export function createCommerce({
       })
       return mapCart(c)
     },
+    async listProvinces(country) {
+      if (!country) return []
+      const { provincias = [] } = await api(`/tienda/provincias?pais=${encodeURIComponent(country)}`)
+      return provincias.map((p) => ({ code: p.codigo, name: p.nombre }))
+    },
     async listShippingOptions(cartId) {
       const { moneda = "eur", opciones = [] } = await api(rutaCarrito(cartId, "/envios"))
       return opciones.map((o) => ({
@@ -367,6 +372,8 @@ export function createCommerce({
         price: money(o.precio ?? 0, moneda, true),
         priceCalculated: Boolean(o.esCalculada),
         description: o.datos?.description ?? null,
+        deliveryTime: o.plazo ?? null,
+        pickup: Boolean(o.recogida),
       }))
     },
     async listShippingGroups(cartId) {
@@ -570,7 +577,7 @@ export function createCommerce({
     content,
     async getStore() {
       try {
-        const { tienda, legal } = await api("/tienda/tienda")
+        const { tienda, legal, precios } = await api("/tienda/tienda")
         if (!tienda) return null
         return {
           name: tienda.nombre ?? null,
@@ -580,6 +587,14 @@ export function createCommerce({
           email: tienda.correo ?? null,
           phone: tienda.telefono ?? null,
           country: tienda.pais ?? null,
+          priceDisplay: precios
+            ? {
+                show: precios.muestra === 'sin' ? 'without' : precios.muestra === 'ambos' ? 'both' : 'with',
+                storedWithTax: !!precios.guardadosConImpuesto,
+                defaultRate: Number(precios.tasaPorDefecto ?? 0),
+                country: precios.pais ?? null,
+              }
+            : null,
           legal: legal ?? null,
         }
       } catch {

package/src/index.d.ts

@@ -244,6 +244,20 @@ export interface StoreInfo {
   email: string | null
   phone: string | null
   country?: string | null
+  /**
+   * Como quiere la tienda que se vean los precios en el escaparate.
+   * `show: 'with'` es lo que exige la ley europea para consumidores;
+   * `'without'` y `'both'` son para tiendas que venden a empresas.
+   * `storedWithTax` dice si el precio que llega ya lleva el impuesto dentro,
+   * y `defaultRate` es la tasa del pais de la tienda, para poder calcular el
+   * otro importe antes de que el cliente diga donde vive.
+   */
+  priceDisplay?: {
+    show: 'with' | 'without' | 'both'
+    storedWithTax: boolean
+    defaultRate: number
+    country: string | null
+  }
   legal?: {
     digital?: {
       pais: string
@@ -282,6 +296,10 @@ export interface ShippingOption {
   /** El backend calcula el precio al elegirla (envío por peso, por ejemplo). */
   priceCalculated?: boolean
   description?: string | null
+  /** Plazo de entrega tal y como lo escribió la tienda: "24-48 h". */
+  deliveryTime?: string | null
+  /** El cliente recoge el pedido: no hay porte ni reparto. */
+  pickup?: boolean
 }
 
 export interface PaymentMethod {
@@ -468,6 +486,12 @@ export interface CommerceClient {
 
   checkout: {
     listCountries?(): Promise<string[]>
+    /**
+     * Provincias, estados o departamentos de un pais, en el nivel que pide su
+     * caja (Espana pide provincia, Alemania Land, Malta nada). Lista vacia =
+     * ese pais no usa provincia y el tema debe dejar el campo libre.
+     */
+    listProvinces?(country: string): Promise<Array<{ code: string; name: string }>>
     setVatNumber?(cartId: string, vatNumber: string | null): Promise<Cart>
     setEmail(cartId: string, email: string): Promise<Cart>
     setAddresses(cartId: string, shipping: Address, billing?: Address): Promise<Cart>