@pcreative/commerce-contract 1.3.5 → 1.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pcreative/commerce-contract",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "Commerce data contract: the types a theme consumes and the adapters that resolve them. No dependencies and no backend SDK.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",

package/src/adapters/api.js

@@ -532,6 +532,18 @@ export function createCommerce({
       const { orders = [] } = await api("/tienda/cuenta/pedidos", { token })
       return orders
     },
+    async licenses(token) {
+      const { licencias = [] } = await api("/tienda/cuenta/licencias", { token })
+      return licencias
+    },
+    async releaseSite(token, licenseKey, instance) {
+      const r = await api("/tienda/cuenta/licencias/soltar", {
+        method: "POST",
+        token,
+        body: { clave: licenseKey, instancia: instance },
+      })
+      return { released: Boolean(r.soltado), site: r.sitio ?? "" }
+    },
     async confirmEmail(sessionToken, token) {
       try {
         const r = await api("/tienda/cuenta/confirmar", { method: "POST", token: sessionToken, body: { token } })

package/src/index.d.ts

@@ -121,6 +121,33 @@ export interface License {
   supportedUntil: string | null
 }
 
+/** Un sitio donde una licencia esta puesta ahora mismo. */
+export interface LicenseSite {
+  /** Lo que identifica esa instalacion: es lo que se manda para desactivarla. */
+  instance: string
+  /** El dominio, ya normalizado (sin esquema, sin www, sin puerto). */
+  site: string
+  /** Nombre que le puso la instalacion, si lo mando. */
+  label: string | null
+  activatedAt: string | null
+  /** Ultima vez que esa instalacion comprobo la licencia. */
+  lastSeenAt: string | null
+}
+
+/**
+ * Una licencia vista desde la cuenta de quien la compro: lo mismo que
+ * `License` mas los sitios, porque desde aqui se desactivan.
+ */
+export interface OwnedLicense {
+  key: string
+  status: "activa" | "caducada" | "anulada"
+  title: string | null
+  orderId: string
+  limit: number
+  supportedUntil: string | null
+  sites: LicenseSite[]
+}
+
 export interface ProductCode {
   id: string
   lineId: string
@@ -787,6 +814,17 @@ export interface CommerceClient {
     me(token: string): Promise<Customer | null>
     orders(token: string): Promise<Order[]>
     confirmEmail?(sessionToken: string, token: string): Promise<{ adopted: number } | null>
+    /**
+     * Opcional: las licencias que ha comprado, con los sitios donde están
+     * puestas ahora mismo. Vacio si el adaptador no vende licencias.
+     */
+    licenses?(token: string): Promise<OwnedLicense[]>
+    /**
+     * Opcional: desactiva uno de SUS sitios, que es lo que hace quien se muda
+     * de dominio. Rechaza con `status` 400 si ese sitio ya no esta activo o la
+     * licencia no es suya, y 429 si se ha pasado del tope.
+     */
+    releaseSite?(token: string, licenseKey: string, instance: string): Promise<{ released: boolean; site: string }>
   }
 
   /** Opcional: nombre y datos legales de la tienda, tal y como los tiene el panel. */