Módulos
API de almacenamiento
Guarda registros versionados con compare-and-set mediante PersistenceService y usa el Redis compartido con RedisService.
PersistenceService
Los registros tienen namespace, clave, revisión y un payload binario inmutable; tu módulo define y versiona el formato del payload. La misma semántica se aplica en MongoDB, MySQL, MariaDB y SQLite.
| Regla | Valor |
|---|---|
| Namespace | 1–64 letras, dígitos, ., -, _ ASCII |
| Clave | 1–191 letras, dígitos, _ : . / - ASCII |
| Payload | Hasta 1 MiB |
| Tamaño de página | 1–1000 registros, ordenados por clave, afterKey exclusivo |
putAsync(ns, key, -1, payload)inserta con revisión 0 y devuelvefalsesi el registro existe.- Las actualizaciones y borrados exigen la revisión leída;
falseindica un conflicto, no una excepción. - Cada mutación es atómica para un registro. No hay transacciones de varios registros.
- Las lecturas van primero a Redis y rellenan la caché desde la base de datos.
RedisService
get, set, delete, incremento atómico con caducidad, publicación y suscripción, cada uno con variantes async y síncronas. set e increment exigen un TTL de 1–31536000 segundos. El prefijo de la red se añade automáticamente. Hasta 64 listeners de suscripción por servidor; el pub/sub es transitorio y no es un almacenamiento durable.