# kidlatjs/kidlat architecture

> Architecture diagram of the GitHub repository kidlatjs/kidlat, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kidlatjs/kidlat
- Repository: https://github.com/kidlatjs/kidlat

## Overview

Kidlat is a dependency-free Node.js web framework backed by a native HTTP/TLS and WebSocket engine. Its main workflow accepts a connection, routes a request through hooks and a handler, then validates and serializes the response; request utilities cover bodies, forms, cookies, and proxy-aware client information. Separate capabilities include WebSockets, operational endpoints and metrics, logging, and clustering. Several implementation files are indexed but unsampled, so edges for their interactions are included only where the README or source index supports them.

Main entry points: [`lib/Kidlat.js`](https://github.com/kidlatjs/kidlat/blob/main/lib/Kidlat.js) (Framework App), [`lib/request.js`](https://github.com/kidlatjs/kidlat/blob/main/lib/request.js) (Request Access), [`lib/response.js`](https://github.com/kidlatjs/kidlat/blob/main/lib/response.js) (Response API), [`lib/native.js`](https://github.com/kidlatjs/kidlat/blob/main/lib/native.js) (Native Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Server and Routing"]
  node_native["Native Engine<br/>[native.js]"]
  node_app["Framework App<br/>[Kidlat.js]"]
  node_router["Route Matching<br/>[router.js]"]
end

subgraph group_http["HTTP Lifecycle"]
  node_request["Request Access<br/>[request.js]"]
  node_pipeline["Hooks and Handlers<br/>[pipeline.js]"]
  node_response["Response API<br/>[response.js]"]
  node_serializer["Response Serialization<br/>[serializer.js]"]
  node_httphead["HTTP Header Builder<br/>[serialize.js]"]
end

subgraph group_features["Request and Response Features"]
  node_validator["Schema Validation<br/>[validator.js]"]
  node_schema["Schema Compiler<br/>[schema.js]"]
  node_form["Form Parsing<br/>[form.js]"]
  node_cookies["Cookie Handling<br/>[cookies.js]"]
  node_proxy["Proxy Trust<br/>[trust-proxy.js]"]
  node_websocket["WebSockets<br/>[ws.js]"]
end

subgraph group_operations["Operations and Scaling"]
  node_health["Health Endpoints<br/>[health.js]"]
  node_metrics["Prometheus Metrics<br/>[metrics.js]"]
  node_cors["CORS<br/>[cors.js]"]
  node_ratelimit["Rate Limiting<br/>[rate-limit.js]"]
  node_security["Security Headers"]
  node_logger["Structured Logging<br/>[logger.js]"]
  node_cluster["Worker Clustering<br/>[cluster.js]"]
end

node_client(("HTTP Client"))

node_client -->|"sends request"| node_native
node_native -->|"dispatches requests"| node_app
node_app -->|"registers and matches"| node_router
node_app -->|"runs handlers"| node_pipeline
node_app -.->|"creates request"| node_request
node_request -->|"parses forms"| node_form
node_request -->|"reads cookies"| node_cookies
node_request -->|"resolves client info"| node_proxy
node_app -->|"compiles route schema"| node_schema
node_schema -->|"compiles validators"| node_validator
node_pipeline -->|"sends handler results"| node_response
node_response -->|"serializes by schema"| node_serializer
node_response -->|"builds HTTP headers"| node_httphead
node_response -->|"sets cookies"| node_cookies
node_app -->|"registers WebSocket routes"| node_websocket
node_websocket -->|"delegates protocol operations"| node_native
node_app -.->|"installs endpoint"| node_health
node_app -->|"installs metrics"| node_metrics
node_metrics -->|"exposes scrape endpoint"| node_client
node_app -->|"configures plugin"| node_cors
node_app -->|"configures plugin"| node_ratelimit
node_app -->|"configures plugin"| node_security
node_app -->|"creates logger"| node_logger
node_client -.->|"connects to shared port"| node_cluster

click node_native "https://github.com/kidlatjs/kidlat/blob/main/lib/native.js"
click node_app "https://github.com/kidlatjs/kidlat/blob/main/lib/Kidlat.js"
click node_router "https://github.com/kidlatjs/kidlat/blob/main/lib/router.js"
click node_request "https://github.com/kidlatjs/kidlat/blob/main/lib/request.js"
click node_pipeline "https://github.com/kidlatjs/kidlat/blob/main/lib/pipeline.js"
click node_validator "https://github.com/kidlatjs/kidlat/blob/main/lib/schema/validator.js"
click node_schema "https://github.com/kidlatjs/kidlat/blob/main/lib/schema.js"
click node_response "https://github.com/kidlatjs/kidlat/blob/main/lib/response.js"
click node_serializer "https://github.com/kidlatjs/kidlat/blob/main/lib/schema/serializer.js"
click node_httphead "https://github.com/kidlatjs/kidlat/blob/main/lib/http/serialize.js"
click node_form "https://github.com/kidlatjs/kidlat/blob/main/lib/form.js"
click node_cookies "https://github.com/kidlatjs/kidlat/blob/main/lib/cookies.js"
click node_proxy "https://github.com/kidlatjs/kidlat/blob/main/lib/trust-proxy.js"
click node_websocket "https://github.com/kidlatjs/kidlat/blob/main/lib/ws.js"
click node_health "https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/health.js"
click node_metrics "https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/metrics.js"
click node_cors "https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/cors.js"
click node_ratelimit "https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/rate-limit.js"
click node_security "https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/security-headers.js"
click node_logger "https://github.com/kidlatjs/kidlat/blob/main/lib/logger.js"
click node_cluster "https://github.com/kidlatjs/kidlat/blob/main/lib/cluster.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_native,node_app,node_router,node_client toneBlue
class node_request,node_pipeline,node_response,node_serializer,node_httphead toneAmber
class node_validator,node_schema,node_form,node_cookies,node_proxy,node_websocket toneMint
class node_health,node_metrics,node_cors,node_ratelimit,node_security,node_logger,node_cluster toneRose
```

## Components

### Server and Routing

- [Native Engine](https://github.com/kidlatjs/kidlat/blob/main/lib/native.js): `lib/native.js`
- [Framework App](https://github.com/kidlatjs/kidlat/blob/main/lib/Kidlat.js): `lib/Kidlat.js`
- [Route Matching](https://github.com/kidlatjs/kidlat/blob/main/lib/router.js): `lib/router.js`

### HTTP Lifecycle

- [Request Access](https://github.com/kidlatjs/kidlat/blob/main/lib/request.js): `lib/request.js`
- [Hooks and Handlers](https://github.com/kidlatjs/kidlat/blob/main/lib/pipeline.js): `lib/pipeline.js`
- [Response API](https://github.com/kidlatjs/kidlat/blob/main/lib/response.js): `lib/response.js`
- [Response Serialization](https://github.com/kidlatjs/kidlat/blob/main/lib/schema/serializer.js): `lib/schema/serializer.js`
- [HTTP Header Builder](https://github.com/kidlatjs/kidlat/blob/main/lib/http/serialize.js): `lib/http/serialize.js`

### Request and Response Features

- [Schema Validation](https://github.com/kidlatjs/kidlat/blob/main/lib/schema/validator.js): `lib/schema/validator.js`
- [Schema Compiler](https://github.com/kidlatjs/kidlat/blob/main/lib/schema.js): `lib/schema.js`
- [Form Parsing](https://github.com/kidlatjs/kidlat/blob/main/lib/form.js): `lib/form.js`
- [Cookie Handling](https://github.com/kidlatjs/kidlat/blob/main/lib/cookies.js): `lib/cookies.js`
- [Proxy Trust](https://github.com/kidlatjs/kidlat/blob/main/lib/trust-proxy.js): `lib/trust-proxy.js`
- [WebSockets](https://github.com/kidlatjs/kidlat/blob/main/lib/ws.js): `lib/ws.js`

### Operations and Scaling

- [Health Endpoints](https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/health.js): `lib/plugins/health.js`
- [Prometheus Metrics](https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/metrics.js): `lib/plugins/metrics.js`
- [CORS](https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/cors.js): `lib/plugins/cors.js`
- [Rate Limiting](https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/rate-limit.js): `lib/plugins/rate-limit.js`
- [Security Headers](https://github.com/kidlatjs/kidlat/blob/main/lib/plugins/security-headers.js): `lib/plugins/security-headers.js`
- [Structured Logging](https://github.com/kidlatjs/kidlat/blob/main/lib/logger.js): `lib/logger.js`
- [Worker Clustering](https://github.com/kidlatjs/kidlat/blob/main/lib/cluster.js): `lib/cluster.js`

### Other components

- **HTTP Client**

## Connections

- HTTP Client → Native Engine: sends request (evidence: `README.md`)
- Native Engine → Framework App: dispatches requests (evidence: `README.md`)
- Framework App → Route Matching: registers and matches (evidence: `lib/Kidlat.js`)
- Framework App → Hooks and Handlers: runs handlers (evidence: `lib/Kidlat.js`)
- Framework App → Request Access: creates request (evidence: `lib/Kidlat.js`)
- Request Access → Form Parsing: parses forms (evidence: `lib/request.js`)
- Request Access → Cookie Handling: reads cookies (evidence: `lib/request.js`)
- Request Access → Proxy Trust: resolves client info (evidence: `lib/request.js`)
- Framework App → Schema Compiler: compiles route schema (evidence: `lib/Kidlat.js`)
- Schema Compiler → Schema Validation: compiles validators (evidence: `lib/schema.js`)
- Hooks and Handlers → Response API: sends handler results (evidence: `lib/pipeline.js`)
- Response API → Response Serialization: serializes by schema (evidence: `lib/response.js`)
- Response API → HTTP Header Builder: builds HTTP headers (evidence: `lib/response.js`)
- Response API → Cookie Handling: sets cookies (evidence: `lib/response.js`)
- Framework App → WebSockets: registers WebSocket routes (evidence: `lib/Kidlat.js`)
- WebSockets → Native Engine: delegates protocol operations (evidence: `lib/ws.js`)
- Framework App → Health Endpoints: installs endpoint (evidence: `lib/Kidlat.js`)
- Framework App → Prometheus Metrics: installs metrics (evidence: `lib/plugins/metrics.js`)
- Prometheus Metrics → HTTP Client: exposes scrape endpoint (evidence: `lib/plugins/metrics.js`)
- Framework App → CORS: configures plugin (evidence: `lib/Kidlat.js`)
- Framework App → Rate Limiting: configures plugin (evidence: `lib/Kidlat.js`)
- Framework App → Security Headers: configures plugin (evidence: `lib/Kidlat.js`)
- Framework App → Structured Logging: creates logger (evidence: `lib/Kidlat.js`)
- HTTP Client → Worker Clustering: connects to shared port
