ArctonArcton
Arquitectura

Architecture Overview

Las capas de Arcton, qué es dueño de cada una, y las decisiones que le dan forma al resto del framework.

Arcton está construido a partir de cuatro piezas con responsabilidades acotadas:

CapaEs dueña deNo sabe nada de
Adapterarrancar un servidor, request nativo ↔ Requestrouting, middleware
Routermapear un método y un path a un handlerqué hace un handler
Pipelinecorrer middleware, providers y validationcómo matcheó un path
Response mappingconvertir un valor retornado en un Responseel resto del request

Las páginas de esta sección explican por qué cada una está construida como está. Si buscas cómo usarlas, empieza por Fundamentos en su lugar.

Una decisión le da forma a la mayoría del resto

Arcton resuelve todo lo que puede cuando las rutas se registran, no cuando llegan los requests.

  • Una ruta guarda su propia cadena de middleware ya terminada, capturada al registrarse.
  • Montar un módulo fusiona su árbol de rutas en el del padre, una sola vez.
  • Los scopes de path se resuelven en cadenas por ruta, así que el router nunca se entera de que los scopes existen.
  • Los conflictos entre rutas se detectan al registrarse y tiran un error de inmediato.

En tiempo de request, lo que queda es: matchear un path, correr una cadena ya preparada, mapear un valor. Nada tiene que recalcularse, y nada de la forma de la aplicación puede cambiar entre requests.

Esto también mantiene honesto al sistema de tipos. ctx se tipa a partir de los providers registrados antes de un handler, y ese es exactamente el conjunto que corre — porque los tipos y el runtime leen la misma lista, en el mismo orden. Ver Pipeline.

Dónde están los límites

   @arcton/adapter-bun            @arcton/adapter-node
              └───────────┬───────────────┘
                          │  implementa RuntimeAdapter
                  @arcton/contracts          ← el vocabulario compartido
                          │  solo tipos, sin código de runtime
                    @arcton/core             ← routing, pipeline, mapeo
                          │
                     tu aplicación

@arcton/contracts no tiene ninguna lógica. Existe para que el core y los adapters puedan depender de una descripción compartida de un runtime sin depender entre sí, y para que tu propio código pueda nombrar esos tipos. Ver Runtime abstraction.

Orden de lectura

En esta página