Artefactos estáticos de NimoApps
Los despliegues se aceptan como operaciones duraderas en /app-operations. El worker revalida la membresía y usa el proveedor guardado en el entorno. Workers for Platforms despliega assets estáticos con manifiesto y hashes, carga solo los buckets solicitados y verifica la URL antes del cambio de ruta. Pages mantiene la reserva de capacidad para los entornos legados que todavía lo usan.
El backend compila cada release DSL autorizado a un bundle reproducible que puede montarse fuera del panel Angular. El bundle incluye runtime, estilos, configuración pública (vacía hasta aprobar su esquema), documento inicial, chunks diferidos y manifiesto de hashes/versiones.
Operaciones
| Método | Ruta | Acceso | Resultado |
|---|---|---|---|
| POST | /app-projects/:projectId/releases/:releaseId/artifact | Usuario de plataforma con rol OWNER/ADMIN vigente | Compila una vez y devuelve el manifiesto y URL del artefacto inmutable |
| GET | /app-projects/:projectId/releases/:releaseId/artifact | Usuario de plataforma con rol OWNER/ADMIN vigente | Devuelve el artefacto generado para ese release |
| POST | /app-operations | OWNER/ADMIN vigente + Idempotency-Key | deployment, hosting-migration o hosting-rollback; operación durable por tenant/entorno |
| POST | /app-environments/:id/rollbacks | Usuario de plataforma OWNER/ADMIN o Nimo interno con scope autorizado | Encola la restauración de una asignación histórica y su configuración; no revierte datos ni pagos |
| POST | /internal/workers-for-platforms/resolve | Protocolo de routing del dispatcher WfP | Solo mapping activo y no ambiguo; devuelve el Worker ID opaco; excluido del SDK público |
| GET | /app-deployments/:id | UUID de deployment; usuario OWNER/ADMIN | Estado del deployment del tenant activo, URL si está disponible y errores sanitizados |
| GET | /runtime-apps/:artifactHash/:ruta | Público | Devuelve la shell; las rutas de aplicación admiten recarga profunda |
| GET | /runtime-data/:artifactHash/assets/*path | Público | JS/CSS estático listado en el manifiesto; asset ausente da 404 |
| GET | /runtime-data/:artifactHash/document/eager | Sesión runtime limitada | Documento eager del release autorizado |
| GET | /runtime-data/:artifactHash/versions/:version/chunks/:kind/:name | Sesión runtime limitada | Chunk diferido del release autorizado |
La huella fuente (sourceHash) y la huella del bundle (artifactHash) son valores separados. El manifiesto SHA-256 vincula entrada, ficheros y versiones exactas de Node, esbuild, runtime, core, componentes y SDK. La misma entrada y toolchain reproducen los mismos bytes. Campos secretos impiden el build y no se aceptan versiones flotantes ni dependencias CDN.
La construcción y el control-plane requieren membresía tenant OWNER/ADMIN vigente. El HTML y JS/CSS no contienen datos de usuario ni credenciales; el documento y los chunks exigen una sesión runtime y no se almacenan en cachés públicas. La recarga profunda sirve la shell solo en rutas de aplicación; recursos y APIs inexistentes mantienen su 404/error original.
Las operaciones administrativas permanecen en la plataforma y Nimo interno. No se agregan al SDK público, MCP externo ni chat embebible.
Rollback verificable
El rollback recibe el ID exacto de una asignación histórica y las revisiones de entorno/configuración que revisó la persona. Reutiliza el artefacto guardado y comprueba sus hashes; no compila de nuevo. Un schema de entidades distinto o conexiones externas cambiadas bloquean la operación con un motivo. Si el despliegue termina correctamente, el backend copia la configuración histórica a una revisión nueva y activa release/configuración con comparación de revisiones. Los datos del entorno, pagos y efectos externos anteriores permanecen como están. Cada solicitud exige una clave de idempotencia y vuelve a comprobar el tenant y el rol OWNER/ADMIN vigente.
Hosting y migración a Workers for Platforms
Los entornos nuevos usan Workers for Platforms en el namespace compartido de su entorno de plataforma; el backend deriva el identificador del User Worker y persiste el provider ID y hostname en el entorno y el release tenant-scoped. No se aceptan scripts de clientes. Los entornos Pages existentes se migran individualmente solo mediante hosting-migration, que verifica el mismo release, el hash del artefacto y la URL WfP antes de cambiar la ruta. hosting-rollback restablece la ruta Pages guardada para ese mismo release. Ambos caminos preservan la revisión de configuración, el namespace de datos y el release; una migración fallida no cambia la ruta activa ni elimina Pages.
El código local del dispatcher valida el sufijo exacto, resuelve el host contra el release activo por ese endpoint, compara el Worker ID y solo entonces usa el namespace de su entorno; los hosts desconocidos/ambiguos devuelven 404 y los fallos del resolver 503, sin fallback a Pages o a otro entorno. La fuente no aprovisiona la ruta wildcard, DNS/TLS, bindings ni el origen API, por lo que guardar un hostname no demuestra que sea públicamente alcanzable.
Nimo interno consulta y ejecuta ese control-plane con app-projects.environments.hosting.get, .migrate y .rollback. La lectura devuelve la ruta y el Worker/deployment reales, la ruta previa retenida y un único motivo por comando (READY, ALREADY_ON_TARGET, NO_CURRENT_RELEASE, NO_ACTIVE_ROUTE para migrar; READY, NOT_ON_TARGET, NO_PREVIOUS_MAPPING, RELEASE_MISMATCH para revertir), sin llamar al proveedor ni exponer el namespace de datos. La migración solo se ofrece sobre una ruta Pages activa del release vigente y la reversión solo mientras la ruta previa siga apuntando a ese mismo release. Ambas escrituras aceptan únicamente proyecto, entorno, release y la generación revisada: ni el proveedor, ni la ruta, ni el Worker, ni la clave de idempotencia se aceptan desde el modelo. No están disponibles en widgets públicos, SDK público ni MCP externo y exigen su propio scope interno (nimo:application-projects:environments:hosting:read|migrate|rollback).
Custom hostnames de Cloudflare for SaaS
Un hostname propio de un cliente puede conectar su aplicación conservando su proveedor DNS. Es una capa distinta de un dominio Pages: comparte la reserva del hostname (un mismo nombre no puede pertenecer a ambos proveedores), pero no se activa, consulta ni retira por el flujo Pages y no hay fallback entre proveedores. La administración vive solo en la plataforma y en Nimo interno: no hay ruta de tenant, no está en el SDK público, en MCP externo ni en chat embebible.
El hostname solo queda activo cuando se cumplen las cuatro pruebas a la vez:
- la propiedad está verificada con el desafío HTTP token o TXT (un CNAME que resuelve no prueba nada);
- el DNS resuelve por un único CNAME al fallback origin y no hay registros
A/AAAAen el mismo nombre; - el estado del proveedor es exactamente
active(active_redeploying,test_active,pending,blockedy el resto de estados documentados no activan); ssl.statuses exactamenteactive(initializing,pending_validation,pending_issuanceypending_deploymentesperan;validation_timed_out,expiredydeletedexigen corregir la configuración).
Un estado desconocido falla cerrado. El resultado siempre informa un único paso siguiente (PROVE_OWNERSHIP, FIX_DNS_RECORDS, WAIT_PROVIDER_STATUS, WAIT_TLS_ISSUANCE, FIX_TLS_CONFIGURATION o ACTIVE), y el valor del desafío se borra cuando la propiedad queda probada.
Un apex se rechaza por defecto: exige una aprobación explícita del par proveedor DNS y método (apex-alias o cname-flattening). No se asume ningún registro A/ALIAS universal; un subdominio externo solo necesita un CNAME.
La retirada es ordenada: primero se desactiva el routing, después se borra el custom hostname en el proveedor y solo cuando el proveedor confirma el borrado se libera la reserva del hostname. Si falla a mitad, el hostname sigue reservado y repetir la operación reanuda desde el último paso confirmado, de modo que un tercero no puede apropiarse de un hostname a medio retirar. Los registros DNS del cliente nunca se borran.
Una migración exige un plan revisado, un identificador de confirmación y aprobación explícita cuando la cuenta de destino cambia o no puede comprobarse con la credencial actual. El origen y su routing se conservan hasta verificar el destino, y ninguna operación mueve la cuenta en silencio.
Estas operaciones se exponen únicamente como capacidad interna de Nimo (app-custom-hostnames.register|list|get|activation.refresh|routing.resolve|migrate|withdraw) con los scopes nimo:application-custom-hostnames:read|write|withdraw. La credencial es de zona, se guarda solo en el entorno del backend y la capacidad permanece deshabilitada mientras falten la zona, el fallback origin, el sufijo o la credencial.
La plataforma administra las mismas siete operaciones por rutas internas (/v1/app-custom-hostnames), marcadas (internal) y excluidas del OpenAPI y del SDK públicos. Cada petición exige una sesión de usuario de plataforma y una membresía OWNER/ADMIN vigente que el servicio vuelve a consultar; los cuerpos son cerrados y el tenant sale siempre del contexto, nunca de un parámetro.
| Método | Ruta | Entrada | Resultado |
|---|---|---|---|
| POST | /app-custom-hostnames | Hostname, entorno, forma y método de propiedad | 201: hostname y desafío TXT; 409: reservado o apex sin aprobación |
| GET | /app-custom-hostnames | — | 200: activos de la empresa con su único paso siguiente |
| GET | /app-custom-hostnames/:id | UUID | 200: proyección persistida; ajeno o inexistente: 404 |
| POST | /app-custom-hostnames/:id/activation/refresh | Sin body | 200: reconcilia evidencia; solo activa con las cuatro pruebas |
| POST | /app-custom-hostnames/routing/resolve | { hostname } | 200: destino del mapping activo; desconocido o ambiguo: sin resolver |
| POST | /app-custom-hostnames/:id/migrate | Plan revisado con confirmación y destino autorizado | 200: migración confirmada; 400: plan no revisado; 409: destino no autorizado |
| DELETE | /app-custom-hostnames/:id | UUID | 204: retirada confirmada; 503: el proveedor no confirmó y sigue reservado |
Las siete operaciones están materializadas como skills del catálogo de plataforma (platform.app_custom_hostname_*) con su clase de riesgo revisada y un esquema de parámetros cerrado: el modelo declara el hostname, el entorno y la forma del pedido, nunca un proveedor, una zona, una cuenta ni un token. La retirada es la única destructiva y conserva su propio scope, así que un token con permiso de escritura no puede liberar un hostname. El contrato de plataforma vive en frontend/src/app/core/services/app-custom-hostnames/: expone propiedad, DNS, TLS, routing y retirada como uniones cerradas, entrega el requisito de activación como valor tipado ({ step, condition, requiresOwnerAction }) y normaliza cada rechazo —los tres motivos de apex y los cinco códigos de fallo de retirada— para que una pantalla traduzca un código estable en lugar de comparar el texto del servidor.