Ejercicio: El servidor del bot

⏱ 55 minutos
📶 Nivel: intermedio

Objetivo

Levantar el Worker del minimarket en tu computadora, comprobar cada ruta con curl, y escribir cinco funciones puras que reproducen las decisiones del servidor: enrutar, elegir el estado HTTP, nombrar claves de KV con su vida útil y no procesar dos veces el mismo mensaje.

Cómo se trabaja

La parte A es práctica real: necesitas la carpeta codigo/ del curso con npm install hecho. No usas cuenta de Cloudflare ni de Meta. La parte B son funciones de JavaScript puro que se comprueban en esta página; son versiones simplificadas de lo que hace worker.js, y escribirlas te obliga a entender cada decisión.

💡 Reto extra

Añade a mensajesNuevos un tope: si la lista trae más de 20 mensajes, procesa solo los 20 primeros. Piensa por qué un servidor público querría ese límite y qué debería hacer con los demás.

▶ Prueba tu código aquí (opcional)

Código (edítalo y pulsa Ejecutar)

<script>
// Escribe aquí tus funciones y pruébalas con console.log
</script>

Página (resultado)

Consola

Pasos

Marca cada paso a medida que lo completes. Tu avance se guarda en este navegador.

Parte A. En codigo/, ejecuta cp .dev.vars.example .dev.vars y edita VERIFY_TOKEN=minimarket-123 y APP_SECRET=secreto. Comprueba con git status que .dev.vars NO aparece (está en .gitignore).
Parte A. Arranca npx wrangler dev --port 8799 y espera la línea Ready on http://127.0.0.1:8799. Si el puerto está ocupado, cambia el número.
Parte A. En otra terminal prueba GET /, GET /salud, la verificación con el token correcto y con uno malo, una ruta inexistente y un POST sin firma. Anota en notas.md los seis códigos HTTP que obtuviste.
Parte A. Firma test/payloads/texto.json con openssl dgst -sha256 -hmac secreto -hex y envíalo con curl --data-binary @archivo. Verifica que recibes 200 y observa en la terminal de wrangler dev el error de token de WhatsApp (es esperado: el token es de relleno). Anota por qué el estado sigue siendo 200.
Parte A. Corre node --test test/worker.test.js y cuenta cuántas pruebas pasan.
Parte B. Escribe enrutar(metodo, ruta, params): devuelve "verificar" si es GET y params tiene la clave "hub.mode"; "inicio" para GET /; "salud" para GET /salud; "recibir" para POST / o POST /webhook; "verificar" también para GET /webhook; y "no-encontrado" para todo lo demás. params puede ser undefined.
Parte B. Escribe estadoDelPost(firmaValida, jsonValido): 401 si la firma no es válida (aunque el JSON tampoco lo sea), 400 si la firma es válida pero el JSON no, y 200 si ambos son válidos.
Parte B. Escribe claveKV(tipo, id) (devuelve "sesion:51999000111", "pedido:LE-1", "visto:wamid.X"; lanza un Error si el tipo no es uno de esos tres) y ttlSegundos(tipo) (sesion: 2 días, pedido: 30 días, visto: 1 día, en segundos).
Parte B. Escribe mensajesNuevos(eventos, vistos): recibe la lista de eventos de parsearWebhook y un Set de ids ya vistos. Devuelve el arreglo de eventos de tipo "mensaje" cuyo id no estaba en vistos, y agrega esos ids a vistos. Si el mismo id aparece dos veces en la lista, solo cuenta la primera. Los eventos de tipo "estado" se ignoran.

💡 Pista 1: Enrutar con orden

Evalúa las condiciones en este orden: primero «GET con hub.mode», luego GET / y /salud, luego POST a / o /webhook, luego GET /webhook sin hub.mode, y al final "no-encontrado". Usa params && "hub.mode" in params para no fallar si params es undefined.

💡 Pista 2: Por qué primero la firma

En recibirWebhook la firma se comprueba antes de intentar leer el JSON. Eso fija el orden de tu función: if (!firmaValida) return 401; va primero.

💡 Pista 3: Claves y vida útil

Un objeto { sesion: 2 * 86400, pedido: 30 * 86400, visto: 86400 } sirve para las dos funciones. Valida con tipo in objeto (o con Object.keys) antes de armar la clave.

💡 Pista 4: Idempotencia con Set

Recorre los eventos: si e.tipo !== "mensaje", sigue; si vistos.has(e.id), sigue; si no, vistos.add(e.id) y agrégalo al resultado. Como el add ocurre dentro del bucle, un duplicado dentro de la misma lista también se descarta.

🔎 Comprueba tu trabajo

Pega tu código y pulsa Comprobar. La revisión ocurre en tu navegador; nada se envía a ningún sitio. Cada punto en rojo incluye una pista. Pega solo el JavaScript, sin las etiquetas <script>.

Tu código de JavaScript

✅ Ver una solución posible

Intenta resolverlo antes de mirar. Tu versión puede ser distinta y también correcta.

funciones.js

function enrutar(metodo, ruta, params) {
  var tieneHub = !!params && Object.prototype.hasOwnProperty.call(params, "hub.mode");
  if (metodo === "GET" && tieneHub) return "verificar";
  if (metodo === "GET" && ruta === "/") return "inicio";
  if (metodo === "GET" && ruta === "/salud") return "salud";
  if (metodo === "POST" && (ruta === "/" || ruta === "/webhook")) return "recibir";
  if (metodo === "GET" && ruta === "/webhook") return "verificar";
  return "no-encontrado";
}

function estadoDelPost(firmaValida, jsonValido) {
  if (!firmaValida) return 401;
  if (!jsonValido) return 400;
  return 200;
}

var DIA = 24 * 60 * 60;
var TTL = { sesion: 2 * DIA, pedido: 30 * DIA, visto: DIA };

function claveKV(tipo, id) {
  if (!Object.prototype.hasOwnProperty.call(TTL, tipo)) throw new Error("Tipo de clave desconocido: " + tipo);
  return tipo + ":" + id;
}

function ttlSegundos(tipo) {
  return TTL[tipo];
}

function mensajesNuevos(eventos, vistos) {
  var nuevos = [];
  eventos.forEach(function (e) {
    if (e.tipo !== "mensaje") return;
    if (vistos.has(e.id)) return;
    vistos.add(e.id);
    nuevos.push(e);
  });
  return nuevos;
}