@controldealquiler/sdk 0.0.0-stage → 1.2.0

package/LICENSE

@@ -0,0 +1,41 @@
+**Licencia del SDK de controldealquiler.com**
+
+Copyright © 2026 Trajano Labs, S.L. (CIF B05655378). Todos los derechos reservados.
+
+**1. Qué te permitimos.** Puedes, gratis y sin exclusiva, instalar, ejecutar y copiar este paquete, sin modificarlo, e
+incluirlo sin modificar en tus programas y distribuirlo con ellos, solo para conectar esos programas con
+controldealquiler.com. Para usar la API necesitas, además, una API key y aceptar las Condiciones de la API para
+agencias, en controldealquiler.com/condiciones-api.
+
+**2. Lo que no te permitimos.** No puedes:
+- modificar el paquete, traducirlo ni hacer obras derivadas de él, salvo lo que el punto 3 dice que la ley te permite
+  siempre;
+- usar el código propio de Trajano Labs que contiene (como su lector de documentos o su cifrado) con otro servicio, o
+  fuera de una integración con controldealquiler.com. Los componentes de terceros se rigen por su propia licencia
+  (punto 4);
+- usarlo para producir lecturas que no salgan de su lector sin cambios;
+- quitar o alterar este aviso ni los de los componentes de terceros;
+- usar el nombre o la marca controldealquiler.com más allá de decir que tu programa se integra con ella.
+
+**3. Lo que la ley te permite siempre.** Nada de esta licencia limita lo que el artículo 100 del texto refundido de la
+Ley de Propiedad Intelectual permite a quien tiene derecho a usar un programa:
+- hacer la copia de seguridad necesaria para usarlo;
+- observar, estudiar o verificar su funcionamiento mientras lo carga, ejecuta o almacena, para conocer las ideas y
+  principios en que se basa;
+- y lo que permite para conseguir la interoperabilidad de un programa creado de forma independiente.
+
+**4. Componentes de terceros.** El paquete incluye componentes de terceros. Su lista, con la licencia completa de cada
+uno y, si la traen, sus avisos (NOTICE), está en el fichero THIRD_PARTY_NOTICES. Para esos componentes manda su licencia, y nada de esta te quita lo que ella te
+permite.
+
+**5. Qué datos envía.** El paquete solo se comunica con la dirección de la API que configures y con las direcciones de
+subida de ficheros que esa API le da. No nos envía datos de uso.
+
+**6. Sin garantía.** El paquete se ofrece tal cual. En la medida en que la ley lo permita, no respondemos de los daños
+que cause su uso, salvo dolo o culpa grave nuestros. Lo que hagas con la API se rige por las Condiciones de la API para
+agencias. Esta cláusula no limita lo que nos obliga el Anexo de encargo de tratamiento para agencias ni la normativa de
+protección de datos.
+
+**7. Fin.** Esta licencia termina si la incumples. Entonces tienes que dejar de usar y distribuir el paquete.
+
+**8. Ley.** Esta licencia se rige por la ley española.

package/README.md

@@ -1,3 +1,200 @@
-# Temporary Holding Version
+# @controldealquiler/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+SDK de Node.js y línea de comandos (`controldealquiler`) para la API de agencias de
+[controldealquiler.com](https://controldealquiler.com).
+
+- Documentación para desarrolladores: https://controldealquiler.com/desarrolladores
+- Especificación OpenAPI 3.1: https://controldealquiler.com/openapi/v1.json
+- Condiciones de la API para agencias: https://controldealquiler.com/condiciones-api
+
+Necesitas una API key de tu cuenta de agencia y haber aceptado las Condiciones de la API. Requiere Node.js 20 o superior.
+
+## Instalación
+
+```sh
+npm install @controldealquiler/sdk
+```
+
+El paquete es ESM (`"type": "module"`).
+
+## Uso
+
+```js
+import { crearCliente, descifradorDeFichero, sobreDeB64 } from '@controldealquiler/sdk'
+import { readFileSync } from 'node:fs'
+
+const sobre = sobreDeB64(JSON.parse(readFileSync('sobre-integracion.json', 'utf8')))
+
+const cliente = crearCliente({
+  apiKey: process.env.CDA_API_KEY,
+  descifrador: descifradorDeFichero('clave-integracion.pem', sobre),
+  // baseUrl: 'https://controldealquiler.com/api',  // por defecto
+  // Para el sandbox: baseUrl: URL_BASE_SANDBOX con una key `cda_test_`.
+})
+
+// Llamada de bajo nivel a cualquier ruta de la API
+const respuesta = await cliente.peticion({ metodo: 'GET', ruta: '/v1/eventos' })
+
+// Alta de un cliente con sus viviendas y ficheros
+const alta = await cliente.clientes.crear({ /* ver /desarrolladores */ })
+
+// Una pasada de entrega de lo pendiente
+const pasada = await cliente.mantenimiento.ejecutar()
+```
+
+### Altas en lote y errores del alta
+
+`clientes.crear` lanza siempre un `ErrorAlta` (subclase de `ErrorApiSdk`, con `cause` = el error original). Su `message` es
+`<ref>: <paso> → <status> <code>` y nunca lleva correos ni direcciones. Sus campos:
+
+| Campo | Qué dice |
+|---|---|
+| `ref`, `paso` | Qué cliente y en qué paso falló: `validar`, `foto`, `abrir`, `vivienda`, `fichero`, `leer`, `cotejar`, `listo`, `paquete`, `lote` o `enlace` |
+| `vivienda`, `caja`, `fichero` | La vivienda y el fichero en curso, si el fallo ocurrió en uno |
+| `loteId`, `indice` | El lote y la posición del cliente en él, si el fallo ocurrió después de enviarlo |
+| `clientId` | El cliente, si ya existía cuando falló |
+| `status`, `code`, `requestId` | Lo que respondió la API (`status` 0 si el fallo fue local o de red); cítanos el `requestId` si escribes a soporte |
+| `creado` | `false`: no se creó nada. `true`: el cliente existe (por ejemplo, falló el enlace). `'desconocido'`: puede que se haya creado, no se sabe |
+| `reintentable` | `true` si repetir el alta puede arreglarlo |
+| `consejo` | `'repetir'`: repite el alta, es idempotente por `ref`. `'manifiesto'`: corrige la entrada, repetir igual no sirve. `'cuenta'`: revisa la cuenta o escríbenos con el `requestId` |
+| `corta` | `true` si el fallo afectaría a todos los clientes (credenciales, key de otro entorno, cuota, clave de integración) |
+
+Un 500 al abrir el borrador (`paso: 'abrir'`) tiene un origen ambiguo: puede ser un fallo del servidor o que otro proceso esté
+creando esa misma `ref` en ese momento, y desde el SDK no se distinguen. Es `reintentable`; repite el alta pasado un rato (con
+`crearVarios` se repite sola).
+
+`clientes.crearVarios(entradas, { aLaVez, repetir })` da de alta varios clientes y **nunca lanza**: devuelve
+`{ completados, fallidos, noIntentados, cortadoPor }`.
+
+```js
+const informe = await cliente.clientes.crearVarios(entradas, { aLaVez: 1, repetir: 1 })
+for (const f of informe.fallidos) console.warn(f.ref, f.paso, f.code, f.creado, f.consejo, f.requestId)
+```
+
+- `aLaVez` (1 o 2, por defecto 1): altas simultáneas. `repetir` (0 a 2, por defecto 1): cuántas veces se repite un alta
+  `reintentable`; la espera es de 2 s, y de 30 s si el intento anterior quedó en `creado: 'desconocido'`.
+- Cada elemento de `completados` lleva `intentos`. Con `estado: 'ya_existia'` e `intentos > 1`, el cliente puede haberlo creado
+  tu propio intento anterior, que dio error pero llegó a crearlo: no implica que ya lo tuvieras de antes.
+- Una `ref` repetida en `entradas` no se envía: la segunda y siguientes van a `fallidos` con `paso: 'validar'`,
+  `code: 'ENTRADA_INVALIDA'` e `intentos: 0`.
+- La pasada se corta (`cortadoPor`, y el resto en `noIntentados`) ante un fallo que afecta a todos los clientes: 401 o 403, key
+  de pruebas o de producción cruzada, API desactivada, cuota o tope de borradores, entorno mal configurado, clave de
+  integración, o tres `RED` o tres `TIEMPO_AGOTADO` seguidos.
+
+Opción `concurrenciaFicheros` de `crearCliente` (1 a 8; si no la fijas, el SDK usa la que sugiere `GET /v1/yo`, o 4): ficheros de una vivienda que se suben y leen a la vez; la API admite 10 peticiones/s por cuenta con ráfaga de 50 y un 429 se reintenta solo.
+
+`crearCliente` devuelve estos grupos: `peticion`, `http`, `descifrador`, `borradores`, `clientes`, `viviendas`, `remitentes`,
+`creditos`, `renovacion`, `webhooks` y `mantenimiento`. Las firmas completas están en los tipos incluidos en el paquete y en la
+documentación de desarrolladores.
+
+### Datos de la vivienda y de los ficheros
+
+- `provincia`: obligatoria, dos dígitos (el código de provincia, por ejemplo `28`).
+- `municipio`: opcional; el código INE de cinco dígitos (por ejemplo `28079`); sus dos primeros dígitos son la provincia.
+- `cp`: cinco dígitos, obligatorio.
+- `caja` de cada fichero: `contract`, `tenant_id`, `other`, `acta`, `movimientos` o `foto`. Solo se admite una `foto` por vivienda.
+- Las escrituras se pueden reintentar con la misma `Idempotency-Key` durante 24 horas.
+
+## Qué viaja cifrado
+
+El SDK sella en tu sistema, con la clave pública de tu agencia, el nombre de tus clientes, la calle y el código postal de cada vivienda y los ficheros: nuestro servidor no puede abrirlos. Llegan y se guardan legibles el correo de tu cliente, la provincia y el municipio de cada vivienda, el porcentaje de propiedad, tus referencias y lo que lee el lector (importes, fechas y conceptos y, de un contrato, sus fechas, la renta y el número de inquilinos). No uses como referencia el nombre, el documento de identidad ni el correo de un cliente.
+
+Si pasamos a leer en nuestro servidor (las [Condiciones de la API](https://controldealquiler.com/condiciones-api) dicen que te avisaremos antes), la API responde `409 AGENCIA_MODO_SERVIDOR` y el SDK, por su cuenta y sin opción para evitarlo, manda además una copia del fichero sin el cifrado de extremo a extremo, protegida solo en el camino, para que la leamos en memoria sin guardarla. La copia que se guarda sigue sellada. `controldealquiler alta` hace lo mismo. Por su cuenta, el SDK no pide escaneos con inteligencia artificial.
+
+## Gestión de clientes y de la cuenta
+
+Todas las escrituras llevan `Idempotency-Key`, salvo las excepciones de Idempotencia (la pone el SDK y los reintentos la reutilizan). `desvincular` y `editar` llevan además
+`If-Match`, que es obligatorio: pasa en `{ ifMatch }` la `version` que leíste con `clientes.leer`. El SDK nunca lo rellena por ti
+(anularía el control de concurrencia). Si otra persona cambió el cliente entre tu lectura y tu escritura, la API responde 412
+(`ErrorApiSdk` con `code: 'PRECONDICION_FALLIDA'`): vuelve a leer con `clientes.leer`, revisa el cambio y reintenta con la versión nueva.
+
+```js
+// Todos los clientes, página a página, hasta la página vacía
+for await (const c of cliente.clientes.listar({ estado: 'invitado' })) console.log(c.client_id, c.version)
+
+const uno = await cliente.clientes.leer(id, { incluir: 'viviendas' })
+
+// Editar: el nombre, la calle y el código postal se sellan en el SDK con la clave pública de tu agencia, y el servidor no puede abrirlos. La provincia, el municipio y tus referencias viajan legibles.
+await cliente.clientes.editar(id, { ref: 'CRM-17', nombre: 'Ana Pérez', viviendas: [{ vivienda: viviendaId, direccion: 'Calle Mayor 1', cp: '28001', municipio: '28079' }] }, { ifMatch: uno.version })
+
+await cliente.clientes.correo(id, 'nuevo@ejemplo.es')   // corrige el correo de un invitado sin confirmar
+await cliente.clientes.revocarEnlace(id)                // revoca su enlace de activación vivo
+await cliente.clientes.desvincular(id, { ifMatch: uno.version })
+
+const viviendas = await cliente.viviendas.listar(id)
+const { saldo } = await cliente.creditos.leer()
+await cliente.remitentes.anadir('facturas@ejemplo.es')  // también .listar() y .quitar(correo)
+await cliente.renovacion.fijar({ nivel: 'agencia', renovacion: 'manual' })  // también .leer()
+```
+
+### Webhooks
+
+```js
+const w = await cliente.webhooks.crear({ url: 'https://ejemplo.es/hook', tipos: ['cliente.activado'] })
+// w.secreto (whsec_…) solo se devuelve esta vez; guárdalo. También: listar, rotarSecreto, entregas, reenviar, borrar.
+
+import { verificarWebhook, ErrorFirmaWebhook } from '@controldealquiler/sdk'
+try {
+  // cuerpo CRUDO recibido (sin re-serializar) y cabeceras; acepta uno o varios secretos (rotación)
+  const { id, timestamp } = verificarWebhook(cuerpoCrudo, req.headers, process.env.CDA_WEBHOOK_SECRETO)
+} catch (e) {
+  if (e instanceof ErrorFirmaWebhook) console.warn(e.motivo)  // CABECERAS | TIMESTAMP | FUERA_DE_VENTANA | SECRETO | FIRMA
+}
+```
+
+`verificarWebhook` rechaza una entrega cuyo `webhook-timestamp` se aparte más de 5 minutos del reloj local.
+
+## Clave de integración
+
+Crear clientes exige que tu API key tenga una clave de integración, y en el SDK también la necesitan la pasada de entrega (`mantenimiento.ejecutar`) y editar el nombre o la dirección. Se fija para cada key (cada key nueva necesita la suya), pero lo que abre es de toda tu agencia: quien tenga la clave privada de integración y el sobre puede abrir todo lo que controldealquiler.com entrega sellado a tu agencia, como dicen las [Condiciones de la API](https://controldealquiler.com/condiciones-api) (punto 8).
+
+1. Genera el par con `npx controldealquiler clave-integracion`. La privada queda en `clave-integracion.pem` (modo 0600, sin cifrar) y la pública sale por pantalla. Guárdala en un gestor de secretos, en una variable de entorno de la infraestructura en que se ejecuta tu integración o en un fichero en un servidor bajo tu control, con el acceso limitado a quien la necesita, como piden las Condiciones de la API (punto 8). Si la pasas a un gestor de secretos o a una variable de entorno, borra el fichero cuando compruebes que funciona.
+2. Pega la pública así: en el panel de tu agencia, pulsa «Remitentes autorizados» y, en el diálogo, ve al apartado «Clave de integración»: elige la API key, pega la clave pública y pulsa «Fijar la clave», con la caja fuerte desbloqueada. Tu navegador sella la clave privada de tu agencia para esa clave pública; a nuestro servidor llegan la pública y el sobre cerrado. Se fija una sola vez por API key; para cambiarla, crea otra key y, cuando funcione, revoca la anterior, que mientras siga activa puede bajar su sobre. Si crees que la privada se ha expuesto, revoca la key enseguida (condiciones de la API, punto 8).
+3. Baja el sobre con `GET /v1/integracion` y guarda el campo `sobre` de la respuesta como un fichero JSON.
+4. Configura `CDA_CLAVE_INTEGRACION` (ruta a la privada) o, si la guardas en un gestor de secretos o en una variable de entorno, `CDA_CLAVE_INTEGRACION_PEM` (el contenido del PEM; si están las dos, gana esta), y `CDA_SOBRE_INTEGRACION` (ruta al JSON del sobre), como en la tabla de abajo. En código, `descifradorDeClave({ pem, ruta })` lee la privada de la opción `pem`, de `CDA_CLAVE_INTEGRACION_PEM` o del fichero, por ese orden.
+
+Sin ella, abrir un alta (`POST /v1/borradores`) y bajar el sobre (`GET /v1/integracion`) responden `403 SIN_CLAVE_INTEGRACION`; editar un cliente, cambiar su correo o desvincularlo también lo devuelven si la agencia aún no tiene caja fuerte. Además, el SDK no puede hacer la pasada de entrega ni sellar el nombre o la dirección al editar.
+
+## Línea de comandos
+
+```sh
+npx controldealquiler clave-integracion       # genera el par de claves de la integración
+npx controldealquiler alta manifiesto.json    # da de alta uno o varios clientes (un objeto o un array)
+npx controldealquiler mantenimiento           # una pasada de entrega
+npx controldealquiler lector fichero.pdf      # lee un fichero en local y escribe el resultado estructurado
+```
+
+`alta` acepta un manifiesto que sea un objeto (un cliente) o un array (varios). Cada cliente lee sus ficheros justo antes de su alta;
+si un fichero no se puede leer, ese cliente sale como fallido (`paso: 'validar'`, con el código de sistema, por ejemplo `ENOENT`, y nunca la ruta) y
+los demás siguen. Opciones: `--a-la-vez <1|2>` (por defecto 1) y `--repetir <0-2>` (por defecto 1).
+
+- **stdout:** el informe JSON `{ completados, fallidos, noIntentados, cortadoPor }`, también con un manifiesto objeto.
+- **stderr:** una línea por fallido: `No se completó <ref>`, `<ref> creado, sin enlace` o `Puede que <ref> se haya creado`, seguido de
+  `: <paso>[ vivienda X][ fichero N (caja)] → <status> <code> · request_id <id> | lote <loteId>#<indice> · <consejo>`, donde el consejo es
+  «repite el alta, es idempotente», «corrige el manifiesto» o «revisa la cuenta o escríbenos con el request_id». Si la pasada se corta,
+  una línea más: `Pasada cortada por <status> <code>: no se intentaron <n> clientes`.
+- **Salida:** 1 si hay fallidos o la pasada se cortó; 0 si no. Un error de uso (falta una variable, una opción inválida) escribe su mensaje y sale con 2. Un manifiesto que no es JSON válido o un error de sistema no entran en este informe: salen con una sola línea `Error: <código>` y salida 1.
+
+Se configura por entorno:
+
+| Variable | Qué es |
+|---|---|
+| `CDA_API_KEY` | Tu API key |
+| `CDA_BASE_URL` | Opcional. Dirección de la API. Para el sandbox: `https://sandbox.controldealquiler.com/api` con una key `cda_test_`; el SDK rechaza en local cruzar una key de un entorno con la base del otro |
+| `CDA_CLAVE_INTEGRACION` | Ruta al fichero PEM de la clave privada de la integración (no la clave) |
+| `CDA_CLAVE_INTEGRACION_PEM` | Alternativa a la ruta: el contenido del PEM de la clave privada, con sus saltos de línea. Gana a `CDA_CLAVE_INTEGRACION` |
+| `CDA_SOBRE_INTEGRACION` | Ruta a un fichero JSON con el sobre de integración: el campo `sobre` de la respuesta de `GET /v1/integracion` |
+
+`controldealquiler` sin argumentos muestra la ayuda de cada comando.
+
+## Cambios en 1.2.0
+
+- `clientes.crear` lanza `ErrorAlta` (sigue siendo un `ErrorApiSdk`, así que `instanceof ErrorApiSdk`, `status` y `code` funcionan como antes) con el paso, la vivienda, el fichero y si se creó algo.
+- Nuevo `clientes.crearVarios`, que nunca lanza, repite lo transitorio y corta lo que afecta a todos los clientes.
+- `controldealquiler alta` acepta un array y explica cada fallido. **Cambio de salida:** con un manifiesto objeto, stdout ya no es el resultado del alta sino el informe `{ completados, fallidos, noIntentados, cortadoPor }`, y sale con 1 si hubo fallidos.
+- **Requiere un servidor que devuelva `nuevo` en `POST /v1/borradores`.** Contra un servidor que aún no lo hace, las altas fallan con un 502.
+
+## Licencia
+
+Licencia propietaria de uso libre para integrarse con controldealquiler.com: ver [LICENSE](./LICENSE). Los componentes
+de terceros incluidos y sus licencias están en [THIRD_PARTY_NOTICES](./THIRD_PARTY_NOTICES).

package/THIRD_PARTY_NOTICES

@@ -0,0 +1,217 @@
+Avisos de componentes de terceros de @controldealquiler/sdk
+
+Este paquete incluye, dentro de dist/, los componentes de terceros que siguen. Cada uno se rige por su propia licencia,
+cuyo texto completo va a continuación (ver también el punto 4 del fichero LICENSE).
+
+================================================================================
+pdfjs-dist 6.2.108
+Licencia: Apache-2.0
+https://mozilla.github.io/pdf.js/
+================================================================================
+
+--- LICENSE ---
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+================================================================================
+zod 4.6.7
+Licencia: MIT
+https://zod.dev
+================================================================================
+
+--- LICENSE ---
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.