@pcreative/commerce-contract 1.3.2 → 1.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pcreative/commerce-contract",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "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

@@ -225,6 +225,7 @@ export function createCommerce({
     if (params.q) qs.set("q", String(params.q))
     if (params.category) qs.set("categoria_handle", params.category)
     if (params.categoryId) qs.set("categoria", params.categoryId)
+    if (params.type) qs.set("tipo", params.type)
     if (params.ids?.length) qs.set("ids", params.ids.join(","))
     if (ORDEN_DEL_CONTRATO[params.sort]) qs.set("orden", ORDEN_DEL_CONTRATO[params.sort])
     const r = await api(`/tienda/productos?${qs}`)
@@ -593,6 +594,22 @@ export function createCommerce({
         throw e
       }
     },
+    async getLicenses(orderId) {
+      try {
+        const { licencias } = await api(`/tienda/pedidos/${encodeURIComponent(orderId)}/licencias`)
+        return (licencias ?? []).map((l) => ({
+          key: l.key,
+          status: l.status,
+          title: l.title ?? null,
+          sites: Number(l.sites ?? 0),
+          limit: Number(l.limit ?? 1),
+          supportedUntil: l.supportedUntil ? String(l.supportedUntil).slice(0, 10) : null,
+        }))
+      } catch (e) {
+        if (e.status === 404) return []
+        throw e
+      }
+    },
     async getCodes(orderId) {
       try {
         const { codigos } = await api(`/tienda/pedidos/${encodeURIComponent(orderId)}/codigos`)
@@ -609,6 +626,54 @@ export function createCommerce({
       )
       return codigo ?? null
     },
+    newsletter: {
+      async subscribe(email, consent = {}) {
+        await api("/tienda/boletin", {
+          method: "POST",
+          body: {
+            email,
+            texto: consent.text,
+            version: consent.version,
+            idioma: consent.locale,
+            origen: consent.source,
+            ip: consent.ip,
+            navegador: consent.userAgent,
+          },
+        })
+        return { status: "pendiente" }
+      },
+      async confirm(token) {
+        try {
+          await api("/tienda/boletin/confirmar", { method: "POST", body: { token } })
+          return true
+        } catch (e) {
+          if (e.status === 400) return false
+          throw e
+        }
+      },
+      async unsubscribe(token) {
+        await api("/tienda/boletin/baja", { method: "POST", body: { token } })
+        return true
+      },
+    },
+    async applyAsAuthor(a) {
+      const vende = [...new Set((a.sells ?? []).filter((x) => x === "tema" || x === "extension"))]
+      const r = await api("/tienda/autores/solicitudes", {
+        method: "POST",
+        body: {
+          nombre: a.name,
+          email: a.email,
+          portafolio: a.portfolio,
+          vende: vende.length === 2 ? ["los-dos"] : vende,
+          slug: a.handle,
+          pais: a.country,
+          web: a.website,
+          stacks: a.stacks,
+          experiencia: a.experience,
+        },
+      })
+      return { id: r.id }
+    },
     async getAuthor(handle) {
       try {
         const { autor } = await api(`/tienda/autores/${encodeURIComponent(handle)}`)

package/src/index.d.ts

@@ -78,6 +78,11 @@ export interface WithdrawalState {
   pais: string
   dias: number | null
   diasHabiles: boolean
+  /**
+   * El plazo cuenta desde que se recibe. Con `caduca` en null y esto en true,
+   * todavía no ha empezado: aún no ha llegado todo lo físico del pedido.
+   */
+  empiezaAlRecibir?: boolean
   caduca: string | null
   dentroDePlazo: boolean
   lineas: { id: string; titulo: string; cantidad: number; excluida: string | null }[]
@@ -98,6 +103,24 @@ export interface BundleComponent {
  * ensena `hint` (los ultimos caracteres) y `revealed` dice si ya se destapo,
  * que es lo que cuenta como entregado.
  */
+/**
+ * La licencia de una pieza del mercado comprada en un pedido. La clave es la
+ * credencial con la que el comprador activa el tema o la extensión en su sitio
+ * y con la que abre soporte con el autor: por eso se enseña entera.
+ */
+export interface License {
+  key: string
+  status: "activa" | "caducada" | "anulada"
+  /** Nombre del producto al que da derecho. */
+  title: string | null
+  /** Sitios donde está activada ahora mismo. */
+  sites: number
+  /** Cuántos sitios admite. */
+  limit: number
+  /** Hasta cuándo incluye soporte y versiones nuevas (AAAA-MM-DD). null: sin fecha. */
+  supportedUntil: string | null
+}
+
 export interface ProductCode {
   id: string
   lineId: string
@@ -119,6 +142,9 @@ export interface ProductCode {
  * Lo que anade un producto que viene del mercado de temas y extensiones:
  * version, cuando se actualizo, demo y changelog. Es lo que mira quien compra
  * software y lo que un producto normal no tiene.
+ *
+ * En los listados llega un resumen: `screenshots` y `changelog` vienen vacíos
+ * y se rellenan en `getProduct`, que es donde se enseñan.
  */
 export interface MarketInfo {
   type: "tema" | "extension"
@@ -131,6 +157,11 @@ export interface MarketInfo {
   demoUrl: string | null
   screenshots: string[]
   changelog: { version: string; date: string | null; notes: string | null }[]
+  /**
+   * Meses de soporte del autor que incluye la compra (0: sin soporte). Las
+   * versiones nuevas no tienen fecha: le llegan al comprador siempre.
+   */
+  supportMonths?: number
 }
 
 export interface Download {
@@ -479,6 +510,11 @@ export interface ListProductsParams {
   categoryId?: string
   ids?: string[]
   tags?: string[]
+  /**
+   * Solo piezas del mercado de ese tipo. Sin él salen todos los productos,
+   * sean o no del mercado. Un adaptador sin mercado lo ignora.
+   */
+  type?: "tema" | "extension"
   limit?: number
   offset?: number
   sort?: SortProductos
@@ -538,6 +574,23 @@ export interface Author {
   support: AuthorSupport | null
 }
 
+/** Lo que manda quien quiere vender en el mercado. Lo revisa una persona. */
+export interface AuthorApplication {
+  /** Nombre con el que publicará. */
+  name: string
+  email: string
+  /** Enlace a algo que haya hecho: sin eso no hay nada que revisar. */
+  portfolio: string
+  sells: ("tema" | "extension")[]
+  /** Identificador público; si falta, sale del nombre. */
+  handle?: string
+  /** Código de dos letras. */
+  country?: string
+  website?: string
+  stacks?: string[]
+  experience?: string
+}
+
 export interface SupportMessage {
   from: "buyer" | "author" | "store"
   text: string
@@ -574,6 +627,8 @@ export interface CommerceClient {
   subirFichero?(archivo: File): Promise<{ id: string; nombre: string; tipo: string; bytes: number; firma: string }>
   /** Opcional: las descargas de un pedido con contenido digital. */
   getDownloads?(orderId: string): Promise<Download[]>
+  /** Opcional: las licencias de las piezas del mercado compradas en un pedido. */
+  getLicenses?(orderId: string): Promise<License[]>
   /** Los codigos de un pedido, tapados. */
   getCodes?(orderId: string): Promise<ProductCode[]>
   /** Destapa uno y devuelve el codigo entero. Queda apuntado quien y cuando. */
@@ -582,6 +637,34 @@ export interface CommerceClient {
   getWithdrawal?(orderId: string): Promise<WithdrawalState | null>
   /** Opcional: solicita el desistimiento de un pedido (botón obligatorio en la UE). */
   requestWithdrawal?(orderId: string, datos?: { lineas?: string[]; motivo?: string }): Promise<{ solicitud: string; aceptadas: number }>
+  /**
+   * Opcional: pedir vender en el mercado. Devuelve el id de la solicitud; la
+   * cuenta se crea cuando alguien la acepta. Si el correo ya pidió, falla con
+   * `err.status` 400 y el motivo en `err.detalle`.
+   */
+  applyAsAuthor?(application: AuthorApplication): Promise<{ id: string }>
+  /**
+   * Opcional: el boletín, con doble confirmación. `subscribe` NO apunta a nadie:
+   * manda un correo con un enlace, y solo al pulsarlo (`confirm`) queda dentro.
+   * Contesta siempre lo mismo para que no sirva para averiguar quién está.
+   */
+  newsletter?: {
+    subscribe(
+      email: string,
+      consent: {
+        /** El texto EXACTO que vio la persona junto a la casilla. Es la prueba. */
+        text: string
+        /** Versión de ese texto: cambia cuando cambia el texto. */
+        version: string
+        locale?: string
+        source?: string
+        ip?: string
+        userAgent?: string
+      },
+    ): Promise<{ status: "pendiente" }>
+    confirm(token: string): Promise<boolean>
+    unsubscribe(token: string): Promise<boolean>
+  }
   /** Opcional: la ficha pública de un autor del mercado. */
   getAuthor?(handle: string): Promise<Author | null>