# nodejs/release-cloudflare-worker architecture

> Architecture diagram of the GitHub repository nodejs/release-cloudflare-worker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nodejs/release-cloudflare-worker
- Repository: https://github.com/nodejs/release-cloudflare-worker

## Overview

This Cloudflare Worker serves Node.js release downloads, documentation, API files, metrics, and related assets from object storage. The main workflow is an HTTP request entering the Worker, being routed through method-specific middleware, mapped to a storage path, and answered with file metadata or content; directory requests can return listings. Supporting branches handle aliases, origin behavior, caching, and error responses. The excerpts show the main routing and R2 paths; some subsystem links rely on the SOURCE INDEX rather than inspected implementations.

Main entry points: [`src/middleware/r2Middleware.ts`](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/middleware/r2Middleware.ts) (Content handling), [`src/routes/index.ts`](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/index.ts) (Route registration), [`src/providers/r2Provider.ts`](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/providers/r2Provider.ts) (R2 provider), [`src/routes/router.ts`](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/router.ts) (Request router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request routing"]
  node_worker["Worker entry<br/>[worker.ts]"]
  node_route_reg["Route registration<br/>[index.ts]"]
  node_router["Request router<br/>[router.ts]"]
  node_request["Request context<br/>[request.ts]"]
end

subgraph group_http["HTTP behavior"]
  node_r2_middleware["Content handling<br/>[r2Middleware.ts]"]
  node_substitution["Version aliases"]
  node_origin["Origin handling"]
  node_http_policies["Cache and headers<br/>[cache.ts]"]
  node_request_utils["HTTP conditions<br/>[request.ts]"]
  node_directory_listing["Directory listings"]
end

subgraph group_storage["Content storage"]
  node_r2_provider["R2 provider<br/>[r2Provider.ts]"]
  node_kv_provider["KV listings<br/>[kvProvider.ts]"]
  node_s3_provider["S3 listings<br/>[s3Provider.ts]"]
  node_directory_reader["R2 directory reader"]
end

subgraph group_support["Response support"]
  node_responses["HTTP responses<br/>[index.ts]"]
end

node_client(("HTTP client"))
node_r2_bucket[("Cloudflare R2")]
node_kv_store[("Cloudflare KV")]
node_sentry["Sentry reporting"]

node_client -->|"sends request"| node_worker
node_worker -->|"registers routes"| node_route_reg
node_worker -->|"dispatches request"| node_router
node_route_reg -->|"registers handlers"| node_router
node_router -->|"routes request"| node_request
node_route_reg -->|"registers content routes"| node_r2_middleware
node_route_reg -->|"registers aliases"| node_substitution
node_route_reg -->|"registers origin handling"| node_origin
node_router -->|"reports exceptions"| node_sentry
node_r2_middleware -->|"reads file or directory"| node_r2_provider
node_r2_middleware -->|"parses conditions"| node_request_utils
node_r2_middleware -->|"renders listing"| node_directory_listing
node_r2_middleware -->|"sets cache policy"| node_http_policies
node_r2_middleware -->|"returns not-found errors"| node_responses
node_r2_provider -->|"reads objects"| node_r2_bucket
node_r2_provider -->|"delegates listings"| node_kv_provider
node_r2_provider -->|"delegates listings"| node_s3_provider
node_kv_provider -.->|"reads listings"| node_kv_store
node_s3_provider -->|"reads directories"| node_directory_reader

click node_worker "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/worker.ts"
click node_route_reg "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/index.ts"
click node_router "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/router.ts"
click node_request "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/request.ts"
click node_r2_middleware "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/middleware/r2Middleware.ts"
click node_substitution "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/middleware/subtituteMiddleware.ts"
click node_origin "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/middleware/originMiddleware.ts"
click node_http_policies "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/utils/cache.ts"
click node_request_utils "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/utils/request.ts"
click node_directory_listing "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/utils/directoryListing.ts"
click node_r2_provider "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/providers/r2Provider.ts"
click node_kv_provider "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/providers/kvProvider.ts"
click node_s3_provider "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/providers/s3Provider.ts"
click node_directory_reader "https://github.com/nodejs/release-cloudflare-worker/blob/main/lib/listR2Directory.mjs"
click node_responses "https://github.com/nodejs/release-cloudflare-worker/blob/main/src/responses/index.ts"

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_worker,node_route_reg,node_router,node_request,node_client toneBlue
class node_r2_middleware,node_substitution,node_origin,node_http_policies,node_request_utils,node_directory_listing,node_r2_bucket,node_kv_store toneAmber
class node_r2_provider,node_kv_provider,node_s3_provider,node_directory_reader toneMint
class node_responses toneRose
class node_sentry toneIndigo
```

## Components

### Request routing

- [Worker entry](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/worker.ts): `src/worker.ts`
- [Route registration](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/index.ts): `src/routes/index.ts`
- [Request router](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/router.ts): `src/routes/router.ts`
- [Request context](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/routes/request.ts): `src/routes/request.ts`

### HTTP behavior

- [Content handling](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/middleware/r2Middleware.ts): `src/middleware/r2Middleware.ts`
- [Version aliases](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/middleware/subtituteMiddleware.ts): `src/middleware/subtituteMiddleware.ts`
- [Origin handling](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/middleware/originMiddleware.ts): `src/middleware/originMiddleware.ts`
- [Cache and headers](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/utils/cache.ts): `src/utils/cache.ts`
- [HTTP conditions](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/utils/request.ts): `src/utils/request.ts`
- [Directory listings](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/utils/directoryListing.ts): `src/utils/directoryListing.ts`

### Content storage

- [R2 provider](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/providers/r2Provider.ts): `src/providers/r2Provider.ts`
- [KV listings](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/providers/kvProvider.ts): `src/providers/kvProvider.ts`
- [S3 listings](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/providers/s3Provider.ts): `src/providers/s3Provider.ts`
- [R2 directory reader](https://github.com/nodejs/release-cloudflare-worker/blob/main/lib/listR2Directory.mjs): `lib/listR2Directory.mjs`

### Response support

- [HTTP responses](https://github.com/nodejs/release-cloudflare-worker/blob/main/src/responses/index.ts): `src/responses/index.ts`

### Other components

- **HTTP client**
- **Cloudflare R2**
- **Cloudflare KV**
- **Sentry reporting**

## Connections

- HTTP client → Worker entry: sends request
- Worker entry → Route registration: registers routes (evidence: `src/worker.ts`)
- Worker entry → Request router: dispatches request (evidence: `src/worker.ts`)
- Route registration → Request router: registers handlers (evidence: `src/routes/index.ts`)
- Request router → Request context: routes request (evidence: `src/routes/router.ts`)
- Route registration → Content handling: registers content routes (evidence: `src/routes/index.ts`)
- Route registration → Version aliases: registers aliases (evidence: `src/routes/index.ts`)
- Route registration → Origin handling: registers origin handling (evidence: `src/routes/index.ts`)
- Request router → Sentry reporting: reports exceptions (evidence: `src/routes/router.ts`)
- Content handling → R2 provider: reads file or directory (evidence: `src/middleware/r2Middleware.ts`)
- Content handling → HTTP conditions: parses conditions (evidence: `src/middleware/r2Middleware.ts`)
- Content handling → Directory listings: renders listing (evidence: `src/middleware/r2Middleware.ts`)
- Content handling → Cache and headers: sets cache policy (evidence: `src/middleware/r2Middleware.ts`)
- Content handling → HTTP responses: returns not-found errors (evidence: `src/middleware/r2Middleware.ts`)
- R2 provider → Cloudflare R2: reads objects (evidence: `src/providers/r2Provider.ts`)
- R2 provider → KV listings: delegates listings (evidence: `src/providers/r2Provider.ts`)
- R2 provider → S3 listings: delegates listings (evidence: `src/providers/r2Provider.ts`)
- KV listings → Cloudflare KV: reads listings
- S3 listings → R2 directory reader: reads directories (evidence: `src/providers/s3Provider.ts`)
