Documentacion Edithor
Verserama en Edithor
Verserama aporta identidad, SSO, BFF, entitlements y servicios cloud concretos a Edithor sin reemplazar el modo local-first ni la capa ConnecThor.
Rol de Verserama
Edithor forma parte del ecosistema Verserama, pero no todo Edithor depende de Verserama. La app se puede abrir sin login obligatorio y mantiene su eje local-first mediante ConnecThor. Verserama entra cuando hay identidad, sesion, SSO, permisos de producto o servicios cloud.
La lectura recomendada es separar tres responsabilidades: Edithor como editor, ConnecThor como agente local y Verserama como plataforma de identidad/backend compartida.
Que aporta
Identidad comun
Verserama Core actua como IdP/BFF. Edithor usa esa sesion para login embebido, MFA, social login, refresh, logout y recuperacion de password.
SSO multi-dominio
El backend documenta OAuth 2.0/OIDC con PKCE, cookies HTTP-only y silent authentication. Edithor lo consume con una comprobacion SSO no redirigida.
Servicios cloud
La app puede seguir local-first sin cuenta, pero las funciones cloud confirmadas pasan por endpoints BFF de Verserama y cookies de sesion.
Entitlements
Verserama resuelve el plan efectivo desde el entitlement verserama.mode y expone plan/tier en la sesion BFF; no se documentan precios aqui.
Dependencias funcionales
| Area | Funciona localmente | Depende de Verserama |
|---|---|---|
| Login y cuenta | Edithor abre sin login obligatorio. | La cuenta, MFA, social login, refresh, logout, idioma de sesion y ajustes de perfil dependen del BFF de Verserama. |
| Cloud Sync | La configuracion local se guarda mediante ConnecThor/RemoteStore. | La sincronizacion con Google Drive usa /bff/cloud-sync/* y requiere sesion mas feature.cloud-sync. |
| Sesion remota persistente | ConnecThor y CollaboraThor gestionan el host local y la conexion realtime. | La UI de disponibilidad persistente esta gated por plan de pago/SUPERADMIN y enlaza a /pricing. |
| Plugin Edithor | El plugin process expone filesystem, storage, terminal, flows y rutas por reino. | Tras login, Edithor puede emitir un device token en /bff/auth/device-tokens y registrarlo en el plugin para refrescar sesion sin pestana abierta. |
| Feedback | El modal vive en el modulo feedback de Edithor. | El envio confirmado va a POST /bff/feedback con sesion BFF y rate limit backend. |
| Catalogo de skills/MCPs | Agent consume catalogos y permite reportar repos desde la UI. | El registry vive en Verserama: /bff/registry/report-repository y endpoints admin para SUPERADMIN. |
Superficies BFF confirmadas
Edithor no debe almacenar tokens en JavaScript. Las integraciones
confirmadas usan cookies HTTP-only y peticiones fetch con
credentials: include hacia el BFF de Verserama.
| Ruta | Uso en Edithor |
|---|---|
/bff/auth/session | Estado de sesion autenticada y usuario actual. |
/bff/auth/login | Login embebido por credenciales y MFA. |
/bff/auth/sso-check | Intento de SSO silencioso sin redirigir la app. |
/bff/auth/refresh | Renovacion de access token desde cookie refresh. |
/bff/auth/device-tokens | Device tokens para el plugin y gestion desde ajustes. |
/bff/auth/feature-flags | Flags como feature.cloud-sync para habilitar capacidades. |
/bff/auth/realtime-token | Token para integracion realtime cuando hay sesion. |
/bff/cloud-sync/* | Conexion, estado, guardado y restauracion de Cloud Sync. |
/bff/feedback | Recepcion de bugs y sugerencias desde Edithor. |
/bff/registry/* | Reporte y administracion del registro de skills/MCPs. |
/bff/users/* | Locale de usuario y lookup para colaboracion. |
Planes y entitlements
Verserama Core incluye billing y entitlements. La fuente confirmada para
Edithor es que el backend resuelve el plan efectivo desde
verserama.mode y que los planes semidios y
dios habilitan feature.cloud-sync. La UI de
sesion remota persistente tambien se presenta como capacidad de plan de
pago o SUPERADMIN.
Que sigue siendo local-first
- Abrir la app y usar la mayor parte del editor no requiere login.
- Filesystem, terminal, storage local, comandos, flows locales y puente browser pertenecen a ConnecThor y sus plugins.
- La persistencia de ajustes de la app se basa en RemoteStore via plugin; Cloud Sync solo sincroniza snapshots cuando el usuario habilita esa integracion.
- La documentacion de ConnecThor sigue separada porque Verserama no sustituye al agente local.
Claims pendientes
- No documentar precios ni diferencias comerciales entre planes en doc.edithor.app; la fuente estable para eso es la pagina de pricing de Verserama.
- Revisar el binding exacto de plan/tier en Edithor: el BFF expone plan y tier, mientras algunas superficies consultadas todavia hablan de status para gating.
- Mantener como pendiente cualquier claim de colaboracion cloud mas alla de lo confirmado por Collaborathor, realtime-token y sesion remota persistente.
- No prometer stores, provisioning remoto ni publicacion de plugins desde esta pagina; eso pertenece a la documentacion de ConnecThor.
Fuentes usadas
edithor/README.mdedithor/AGENTS.mdedithor/src/app/modules/login/AGENTS.mdedithor/src/app/modules/login/services/auth-session.service.tsedithor/src/app/shared/platform/AGENTS.mdedithor/src/app/shared/platform/cloud-sync/services/cloud-sync.facade.tsedithor/src/app/modules/core/ui/components/settings-modal/remote-session-section/AGENTS.mdedithor/src/app/modules/feedback/AGENTS.mdverserama/README.mdverserama/AGENTS.mdverserama/docs/MULTI_DOMAIN_SSO.mdverserama/docs/BILLING.md