Skip to content

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étodoRutaAccesoResultado
POST/app-projects/:projectId/releases/:releaseId/artifactUsuario de plataforma con rol OWNER/ADMIN vigenteCompila una vez y devuelve el manifiesto y URL del artefacto inmutable
GET/app-projects/:projectId/releases/:releaseId/artifactUsuario de plataforma con rol OWNER/ADMIN vigenteDevuelve el artefacto generado para ese release
POST/app-operationsOWNER/ADMIN vigente + Idempotency-Keydeployment, hosting-migration o hosting-rollback; operación durable por tenant/entorno
POST/app-environments/:id/rollbacksUsuario de plataforma OWNER/ADMIN o Nimo interno con scope autorizadoEncola la restauración de una asignación histórica y su configuración; no revierte datos ni pagos
POST/internal/workers-for-platforms/resolveProtocolo de routing del dispatcher WfPSolo mapping activo y no ambiguo; devuelve el Worker ID opaco; excluido del SDK público
GET/app-deployments/:idUUID de deployment; usuario OWNER/ADMINEstado del deployment del tenant activo, URL si está disponible y errores sanitizados
GET/runtime-apps/:artifactHash/:rutaPúblicoDevuelve la shell; las rutas de aplicación admiten recarga profunda
GET/runtime-data/:artifactHash/assets/*pathPúblicoJS/CSS estático listado en el manifiesto; asset ausente da 404
GET/runtime-data/:artifactHash/document/eagerSesión runtime limitadaDocumento eager del release autorizado
GET/runtime-data/:artifactHash/versions/:version/chunks/:kind/:nameSesión runtime limitadaChunk 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/AAAA en el mismo nombre;
  • el estado del proveedor es exactamente active (active_redeploying, test_active, pending, blocked y el resto de estados documentados no activan);
  • ssl.status es exactamente active (initializing, pending_validation, pending_issuance y pending_deployment esperan; validation_timed_out, expired y deleted exigen 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étodoRutaEntradaResultado
POST/app-custom-hostnamesHostname, entorno, forma y método de propiedad201: 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/:idUUID200: proyección persistida; ajeno o inexistente: 404
POST/app-custom-hostnames/:id/activation/refreshSin body200: 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/migratePlan revisado con confirmación y destino autorizado200: migración confirmada; 400: plan no revisado; 409: destino no autorizado
DELETE/app-custom-hostnames/:idUUID204: 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.