Actualizar, volver atrás o retirar
Conserva pins e identidad. Un cambio de nombre o de interfaz remota no actualiza por sí solo el código instalado.
En esta página
Empieza por un inventario pequeño
- Anota paquete, versión, archivo privado y hash recibido. Separa versión SDK, ABI host, mensajes iframe y versión del asset remoto.
- Identifica dónde se instala el SDK, quién mantiene la política local y dónde ocurre logout/cambio de organización.
- Comprueba collector/transporte, orígenes exactos y qué endpoints están habilitados para el scope.
- No tomes un nombre de versión reportado por un cliente como prueba del artefacto realmente servido.
Una actualización revisada
- Recibe y verifica el nuevo archivo/receipt por el canal autorizado; conserva el anterior sin sobrescribir sus bytes.
- Prueba exports, tipos y comportamiento en un consumidor sintético. Usa la CLI --help instalada, no un comando interno del monorepo.
- Detén la captura anterior y destruye su montaje antes de instalar otra identidad o adaptador. Evita dos registros sobre la misma página.
- Revisa el nuevo contrato y permisos. Una capacidad instalada enumera posibilidades; no activa políticas o grants.
- El responsable coordina la adopción y corrobora el artefacto servido y el scope. No deduzcas éxito por build, /ready o una respuesta de proveedor.
Compatibilidad de nombres y límites
| Cambio | Qué conservar |
|---|---|
| Paquetes / CLI | Nombres actuales @reks/* y bin reks; los comandos signals:* mantienen semántica de dominio. |
| Global del IIFE | ReksBugs en 0.4.0. Cambiar el nombre en un HTML antiguo no transforma su archivo instalado. |
| Registro de SDK | Las generaciones compatibles comparten un registro interno; stop explícito antes de reinstalar. El instalador 0.2 antiguo no revoca otra identidad por sí solo. |
| Datos privados en DOM | Mantén data-client-signal-private mientras haya clientes antiguos; los nuevos reconocen también data-reks-private, incluidos ancestros y valores vacíos/false. |
| Variables de entorno | REKS_* preferido; aliases anteriores exactos, valores duales distintos fallan. No conviertas secretos a NEXT_PUBLIC_*. |
| Wire y assets | No renombres campos host:*/widget:* o perfiles por branding. No sobrescribas una URL/version de assets histórica. |
El bridge recomendado 0.2.1 corrige el límite de identidad. La fábrica no debe conservar un montaje cuando cambian token/boundary/elegibilidad. Usa la notificación real síncrona; una actualización remota no corrige un adaptador viejo que nunca notifica ese cambio.
Rollback y retirada no son sólo cambiar un número
Un rollback necesita confirmar que el código anterior entiende el contrato y las políticas vigentes. No apuntes a un asset antiguo si su ABI/transporte o techo instalado ya no es compatible. Mantén los archivos inmutables y la comprobación de integridad.
Para retirar: stop del SDK frontend, dispose/destroy del bridge/widget, shutdown con deadline en Node, retirada de imports/scripts/dependencias en un release revisado y revocación/rotación de credenciales por su responsable. Desinstalar un paquete no demuestra borrado o retención cumplida en servidor.
No existe un endpoint público de backfill o una orden CLI genérica de purga/rollback en este contrato. Las migraciones y el mantenimiento interno mantienen su propio procedimiento y autorización.