Codex Cloudflarensis · Folio I

De Primitivis
Cloudflarensibus

Tractatus Illuminatus

Veinte primitivas, veinte propiedades singulares. Cada una resuelve un solo tradeoff de compute, state y consistency. La maestría no está en saberlas todas — sino en distinguir cuál se aplica al problema que tienes enfrente.

I
Pars Prima

Las Seis Fundamentales

El núcleo del stack. Cada una con su esencia, analogía precisa que aísla su propiedad única, y qué hueco deja si la quitas.

W
— Operarius —
Worker
Compute · Effímero
Esencia Técnica
V8 isolate spawn-on-demand.

Existe sólo durante un request. Cero memoria entre requests. Cold start cinco milisegundos. Infinitos paralelos sin configuración.

Analogía · Chispa de Pedernal
Golpeas, existe, se apaga. Diez mil chispas por segundo trivial — pedernal infinito. Ninguna chispa recuerda otra. Cero costo idle: no hay chispa hasta que golpeas el pedernal.
Sin Worker, no hay compute en el edge.
K
— Bibliothecarius —
KV
State · Eventual · Read-Heavy
Esencia Técnica
Replicación global, consistencia eventual.

Reads desde edge en diez milisegundos. Writes propagan en sesenta segundos al mundo. Cap de un write por segundo por key. Reads sin límite.

Analogía · Periódico Distribuido
Cada kiosco del mundo tiene copia. Lectura local instantánea. Editar exige reimprimir y repartir — minutos. Imposible dos ediciones por segundo del mismo periódico.
Sin KV, no hay cache global de lectura masiva.
D
— Tabularium —
D1
State · Strong · Relational
Esencia Técnica
SQLite serverless con primary único.

SQL relacional, joins, transactions. Aproximadamente un gigabyte. Mil writes por segundo en primary. Read replicas distribuidas globalmente.

Analogía · Registro Civil Central
Una oficina central guarda las actas. Queries complejas posibles — todos los nacidos en marzo y casados antes de junio. Capacidad de turnos por día limitada. Si toda la ciudad hace trámite el mismo día, hay fila.
Sin D1, no hay queries SQL relacionales serverless.
O
— Custos Singularis —
Durable Object
State · Strong · Single-Writer per ID
Esencia Técnica
Single-writer global garantizado por ID.

Stateful in-memory más SQLite local. Strong consistency. Hiberna y despierta. Soporta alarms, WebSockets, RPC entre workers.

Analogía · Tablero de Una Partida
Partida #abc123 tiene un tablero único en el mundo. Sólo movimientos de esa partida tocan ese tablero. Movimientos serializados — físicamente imposible dos simultáneos. Otra partida es otro tablero, completamente independiente.
Sin DO, imposible coordinar single-writer-per-entity en edge global.
Q
— Cursus Publicus —
Queue
Async · Buffered · At-Least-Once
Esencia Técnica
Buffer asíncrono producer-consumer.

Retry con backoff exponencial. Batching. Dead letter queue para mensajes irrecuperables. At-least-once delivery — la idempotencia es responsabilidad tuya.

Analogía · Buzón de Correo
Echas la carta y sigues caminando. El cartero la recoge cuando puede. Si falla, reintento mañana. Cartas perdidas tras siete intentos van al buzón muerto.
Sin Queue, no hay decoupling async durable simple.
F
— Ordo Operum —
Workflow
Orquestación · Replayable
Esencia Técnica
Ejecución durable replayable multi-step.

Cada step persiste su resultado. Sobrevive crashes del runtime. Reanuda desde el último step exitoso. Soporta sleep de horas o días.

Analogía · Instructivo IKEA con Checkmarks
Step 1 ✓, Step 2 ✓, Step 3 — crash — reanudas en Step 3. Estado persistido entre steps: tornillos ya puestos, mesa medio armada. Puedes pausar días, retomas igual.
Sin Workflow, multi-step async durable es build-it-yourself.
II
Pars Secunda

Tabula de Propiedades

Cada primitiva ocupa un punto único en el espacio de tradeoffs. Si necesitas una combinación específica, sólo una la tiene.

PrimitivaStatefulConsistenciaThroughputScopeCuándo Sólo Ésta Sirve
WorkerNonn/a∞ horizontalGlobalisCompute en edge
KVSicEventual ~60s∞ reads · 1/s/keyGlobalisCache global lectura masiva
D1SicStrong~1K writes/sRegional + replicaeQueries SQL relacional
Durable ObjectSicStrong1 writer/ID · ∞ IDsPer-ID globalisCoordinación per-entidad
QueueBufferAt-least-onceAlto sostenidoGlobalisAsync decouple
WorkflowRun stateStrong replayLong-runningGlobalisMulti-step durable
III
Pars Tertia

Las Tres Columnas

Compute · State · Consistency. Los PaaS tradicionales mezclan estos ejes en "servidores". Cloudflare los separa deliberadamente.

I
Compute
Quis exsequitur logicam?
  • Workerstateless · ephemeral
  • Durable Objectstateful · per-ID
  • Workflowlong-running · durable
  • ContainersDocker · pesado
  • Sandboxisolated execution
II
State
Ubi data habitant?
  • KVkey-value globalis
  • D1SQL regionalis
  • DO StorageSQLite per-DO
  • R2obiectum · blobs
  • Vectorizevectores · semantic
  • Cache APIHTTP cache edge
III
Consistency
Quando mutationes apparent?
  • EventualKV · ~60s prop
  • StrongD1 · single primary
  • Strong per-IDDO · single-writer
  • At-least-onceQueue · retry
  • Replay-strongWorkflow · steps
IV
Pars Quarta

Primitivas Extendidas

Más allá del núcleo. Storage, intelligence, connectivity, media — todas con su propósito singular en el firmamento del stack.

R
— Thesaurus —
R2
Object storage S3-compatible, cero costo de egress.
Bóveda del tesoro. Guardas blobs de cualquier tamaño. Sacar = gratis (a diferencia de S3). Ideal para media, backups, archivos pesados.
A
— Oraculum —
Workers AI
Inferencia ML en edge sin gestionar API keys.
Oráculo de Delfos. Pregunta, recibe respuesta. Modelos hosted CF — Llama, Mistral, embeddings, vision. Pay per token.
V
— Mensor —
Vectorize
Vector database para semantic search y RAG.
Cartógrafo del significado. Cada texto se convierte en coordenadas en espacio multidimensional. Busca por proximidad semántica, no por keywords.
G
— Porta Sapientiae —
AI Gateway
Proxy LLM con cache, rate limit, observabilidad.
Aduana de los oráculos. Toda llamada a OpenAI, Anthropic, etc. pasa por aquí. Cachea respuestas idénticas, registra costos, controla abuso.
B
— Speculator —
Browser Render
Chrome headless en edge.
Espía con ojos. Renderiza páginas con JS, toma screenshots, genera PDFs, scrapea SPAs. Lo que fetch no puede ver.
H
— Aquaeductus —
Hyperdrive
Connection pool a Postgres/MySQL externo.
Acueducto romano. Mantiene conexiones cálidas a tu DB tradicional. Worker llega, agarra conexión lista, no espera handshake. 10× más rápido.
C
— Promptuarium —
Cache API
Cache HTTP explícito en edge (≠ KV).
Despensa del posadero. Cachea respuestas HTTP completas con su Cache-Control. Distinto de KV — éste es el CDN clásico programable.
N
— Vas —
Containers
Docker corriendo en CF, beta.
Forja medieval. Para cuando V8 isolate no basta — Python, Rust binaries, GPU work. Más pesado, más capable. Cohabita con Workers.
S
— Officina —
Sandbox SDK
Code execution remoto en sandboxes aislados.
Laboratorio del alquimista. Ejecuta código no confiable (LLM-generated, user code) en contenedor seguro. Útil para AI agents que escriben y corren código.
E
— Tabellarius —
Email Workers
Recibir y rutear email con código.
Mensajero del scriptorium. Configura dominio, los emails entrantes disparan tu Worker. Filtras, parseas, reenvías, archivas — todo programable.
P
— Folium —
Pages
Hosting estático con CI/CD desde Git.
Pergamino encuadernado. Despliegas HTML/CSS/JS estático. Builds automáticos en push. Para SPA o sitios sin lógica server. (Workers Static Assets ya lo absorbe.)
M
— Flumen —
Stream
Video hosting con transcoding y HLS automático.
Río que reparte agua. Subes video, CF lo transcodifica a múltiples bitrates, sirve HLS adaptativo. Sin gestión de FFmpeg ni CDN.
I
— Imago —
Images
CDN de imágenes con transformaciones on-the-fly.
Cámara del retratista. Subes una imagen, pides cualquier resize/format/crop por URL. WebP/AVIF automático. Variants definidos.
T
— Custos Portae —
Turnstile
CAPTCHA invisible privacy-first.
Guardián de la puerta. Reemplaza reCAPTCHA. Detecta bots sin frustrar humanos con "selecciona los semáforos". Token validado server-side.
U
— Cuniculus —
Tunnel
Expone localhost a internet sin abrir puertos.
Pasaje secreto del castillo. Tu localhost se conecta saliendo al edge CF. Internet llega via DNS — tu firewall queda intacto. Cero NAT, cero static IP.
F
— Imperium —
Workers for Platforms
Multi-tenant: tus clientes deployan Workers en TU plataforma.
Imperio de vasallos. Tú eres CF para tus clientes. Cada uno deploya su propio Worker bajo tu control. Para SaaS tipo Shopify Apps.
Z
— Limen Sacrum —
Zero Trust
Auth gateway antes de tu app.
Aduana fronteriza. Toda request a tu app pasa por verificación de identidad (Google, Okta, GitHub). Apps internas sin VPN.
L
— Annales —
Analytics Engine
Time-series database serverless.
Cronista del reino. Cada Worker escribe eventos, tú consultas con SQL como ClickHouse. Dimensiones + métricas. Para analytics, monitoring custom.
V
Pars Quinta

Graphum Cosmographicum

Mapa de relaciones entre primitivas. Worker en el centro — toda lógica orquesta desde ahí. Hover sobre cada nodo para ver su rol.

Familiae
Compute
State
Intellectus
Async
Media
Gateway
Epilogo
De Praecisione Necessaria

Confundir primitivas produce bugs estructurales. Usar KV para counter genera race conditions silenciosas. Usar D1 para session token causa fila en el primary. Usar DO para cache global convierte un solo isolate en cuello de botella global.

La verdadera maestría de Cloudflare no consiste en saber usar Workers. Consiste en leer el requirement, identificar el tradeoff dominante — latency contra consistency contra coordination — y mapearlo a la primitiva exacta. Cuando piensas en propiedades, la elección se vuelve casi mecánica.

⁘ ❦ ⁘
Codex compositus · Anno Domini MMXXVI · In nomine Cloudflarensis