@peaje/proxy 0.2.0 → 0.2.1

package/README.md

@@ -102,6 +102,10 @@ The forwarded request keeps method, body, query and `authorization` (the MPP cre
 
 Upgrading from 0.1.x: if your priced routes live outside `/api/` and `/v1/`, add their prefix to `apiPrefixes` before you deploy 0.2.0.
 
+## Bot visits (since 0.2.1)
+
+When a known AI bot (GPTBot, ClaudeBot, OAI-SearchBot, PerplexityBot, Googlebot) reads a page your app serves itself, such as your home page or a blog post, the proxy tells the gateway in the background, so the read shows up in your agent visits. The gateway never sees those requests otherwise. It sends only the path, without the query string, and the bot's user agent: no IP, no cookies, and visits from people are never reported. The Vercel adapter runs it in `waitUntil`, Hono on Workers in `executionCtx.waitUntil`, and `peajeFetch(request, waitUntil)` takes one; elsewhere it runs alongside the response with a 3 s timeout. Turn it off with `{ slug, reportBotVisits: false }`.
+
 ## Options
 
 | Option | Default |
@@ -110,6 +114,7 @@ Upgrading from 0.1.x: if your priced routes live outside `/api/` and `/v1/`, add
 | `secret` | `process.env.PEAJE_ORIGIN_SECRET` |
 | `gateway` | `process.env.PEAJE_GATEWAY_URL` or `https://api.usepeaje.com` |
 | `apiPrefixes` | `['/api/', '/v1/']`: where your priced API routes live; the root and reserved paths are never accepted |
+| `reportBotVisits` | `true`: tell the gateway when an AI bot reads a page of your app, for your agent visits |
 
 ## License
 

package/dist/{chunk-QHUY5N5S.js → chunk-SWB3HJVY.js}

@@ -55,6 +55,24 @@ var PATHS_RESERVADOS = [
 var PEAJE_FETCH_HEADER = "x-peaje-fetch";
 var PEAJE_HOST_HEADER = "x-peaje-forwarded-host";
 
+// ../shared/src/kit/bots.ts
+var BOTS_DE_VISITA = [
+  { patron: /OAI-SearchBot/i, tipo: "openai-searchbot" },
+  { patron: /PerplexityBot/i, tipo: "perplexitybot" },
+  { patron: /Googlebot/i, tipo: "googlebot" },
+  { patron: /ClaudeBot|anthropic-ai/i, tipo: "claudebot" },
+  { patron: /GPTBot/i, tipo: "gptbot" }
+];
+function tipoDeBot(ua) {
+  if (!ua) return null;
+  for (const b of BOTS_DE_VISITA) if (b.patron.test(ua)) return b.tipo;
+  return null;
+}
+var PEAJE_VERIFICADOR_HEADER = "x-peaje-verificador";
+var NO_ES_PAGINA = /\.(png|jpe?g|gif|webp|avif|svg|ico|css|m?js|map|woff2?|ttf|otf|eot|mp4|webm|mp3|wav)$/i;
+var MAX_PATH_LECTURA = 500;
+var MAX_UA_LECTURA = 300;
+
 // ../shared/src/kit/proxy-runtime.ts
 var PEAJE_ORIGIN_HEADER = "x-peaje-origin";
 function iguales(a, b) {
@@ -131,6 +149,17 @@ function patronReenviable(patron) {
   if (segs.length === 0) return false;
   return !(segs.length === 1 && (segs[0] === "*" || segs[0].startsWith(":")));
 }
+function lecturaDeBot(input) {
+  const method = input.method.toUpperCase();
+  if (method !== "GET" && method !== "HEAD") return null;
+  const h = input.headers;
+  if (h.has(PEAJE_ORIGIN_HEADER) || h.has(PEAJE_FETCH_HEADER) || h.has(PEAJE_VERIFICADOR_HEADER)) return null;
+  const ua = h.get("user-agent");
+  if (!ua || !tipoDeBot(ua)) return null;
+  const path = input.pathname;
+  if (!path.startsWith("/") || path.startsWith("/_next/") || path.startsWith("/_vercel/") || NO_ES_PAGINA.test(path)) return null;
+  return { path: path.slice(0, MAX_PATH_LECTURA), method, userAgent: ua.slice(0, MAX_UA_LECTURA) };
+}
 function crearProxyRuntime(opciones) {
   const base = opciones.base.replace(/\/+$/, "");
   const ttl = opciones.ttlMs ?? 6e4;
@@ -175,6 +204,22 @@ function crearProxyRuntime(opciones) {
     },
     /** Fuerza la carga del manifiesto (útil al arrancar o en tests). */
     cargar: () => refrescando ??= refrescar(),
+    /**
+     * Si la request es un bot leyendo una página del sitio, le avisa al
+     * gateway y devuelve la promesa del aviso (para `waitUntil`); si no, null.
+     * El aviso nunca lanza ni demora la página: 3 s de tope y se descarta la
+     * respuesta.
+     */
+    reportarLectura(input) {
+      const lectura = lecturaDeBot(input);
+      if (!lectura) return null;
+      return fetchImpl(`${base}/kit/visita`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(lectura),
+        signal: AbortSignal.timeout(3e3)
+      }).then((res) => res.body?.cancel()).catch(() => void 0);
+    },
     /**
      * Decide si la request va al gateway. `method` y `pathname` de la request,
      * `search` con el `?` incluido, y los headers para cortar bucles.
@@ -366,6 +411,7 @@ function crearPeaje(opciones) {
   const secreto = opciones.secret ?? env("PEAJE_ORIGIN_SECRET") ?? null;
   const fetchImpl = opciones.fetch ?? ((...a) => fetch(...a));
   const runtime = crearProxyRuntime({ base, secreto, fetchImpl, prefijosApi: opciones.apiPrefixes ?? PREFIJOS_API_POR_DEFECTO });
+  const reportar = opciones.reportBotVisits !== false;
   return {
     base,
     async decidir({ method, url, headers }) {
@@ -393,16 +439,26 @@ function crearPeaje(opciones) {
       vuelta.delete("transfer-encoding");
       vuelta.delete("connection");
       return new Response(method === "HEAD" ? null : res.body, { status: res.status, statusText: res.statusText, headers: vuelta });
+    },
+    reportarLectura({ method, url, headers }) {
+      return reportar ? runtime.reportarLectura({ method, pathname: url.pathname, headers }) : null;
     }
   };
 }
 function peajeFetch(opciones) {
   const peaje = crearPeaje(opciones);
-  return async (request) => {
+  return async (request, waitUntil) => {
     const url = new URL(request.url);
     const entrada = { method: request.method.toUpperCase(), url, headers: request.headers };
     const destino = await peaje.decidir(entrada);
-    if (!destino) return null;
+    if (!destino) {
+      const lectura = peaje.reportarLectura(entrada);
+      if (lectura) {
+        if (waitUntil) waitUntil(lectura);
+        else void lectura;
+      }
+      return null;
+    }
     const body = entrada.method === "GET" || entrada.method === "HEAD" ? null : await request.arrayBuffer();
     return peaje.reenviar(destino, { ...entrada, body });
   };

package/dist/express.cjs

@@ -83,6 +83,24 @@ var PATHS_RESERVADOS = [
 var PEAJE_FETCH_HEADER = "x-peaje-fetch";
 var PEAJE_HOST_HEADER = "x-peaje-forwarded-host";
 
+// ../shared/src/kit/bots.ts
+var BOTS_DE_VISITA = [
+  { patron: /OAI-SearchBot/i, tipo: "openai-searchbot" },
+  { patron: /PerplexityBot/i, tipo: "perplexitybot" },
+  { patron: /Googlebot/i, tipo: "googlebot" },
+  { patron: /ClaudeBot|anthropic-ai/i, tipo: "claudebot" },
+  { patron: /GPTBot/i, tipo: "gptbot" }
+];
+function tipoDeBot(ua) {
+  if (!ua) return null;
+  for (const b of BOTS_DE_VISITA) if (b.patron.test(ua)) return b.tipo;
+  return null;
+}
+var PEAJE_VERIFICADOR_HEADER = "x-peaje-verificador";
+var NO_ES_PAGINA = /\.(png|jpe?g|gif|webp|avif|svg|ico|css|m?js|map|woff2?|ttf|otf|eot|mp4|webm|mp3|wav)$/i;
+var MAX_PATH_LECTURA = 500;
+var MAX_UA_LECTURA = 300;
+
 // ../shared/src/kit/proxy-runtime.ts
 var PEAJE_ORIGIN_HEADER = "x-peaje-origin";
 function iguales(a, b) {
@@ -159,6 +177,17 @@ function patronReenviable(patron) {
   if (segs.length === 0) return false;
   return !(segs.length === 1 && (segs[0] === "*" || segs[0].startsWith(":")));
 }
+function lecturaDeBot(input) {
+  const method = input.method.toUpperCase();
+  if (method !== "GET" && method !== "HEAD") return null;
+  const h = input.headers;
+  if (h.has(PEAJE_ORIGIN_HEADER) || h.has(PEAJE_FETCH_HEADER) || h.has(PEAJE_VERIFICADOR_HEADER)) return null;
+  const ua = h.get("user-agent");
+  if (!ua || !tipoDeBot(ua)) return null;
+  const path = input.pathname;
+  if (!path.startsWith("/") || path.startsWith("/_next/") || path.startsWith("/_vercel/") || NO_ES_PAGINA.test(path)) return null;
+  return { path: path.slice(0, MAX_PATH_LECTURA), method, userAgent: ua.slice(0, MAX_UA_LECTURA) };
+}
 function crearProxyRuntime(opciones) {
   const base = opciones.base.replace(/\/+$/, "");
   const ttl = opciones.ttlMs ?? 6e4;
@@ -203,6 +232,22 @@ function crearProxyRuntime(opciones) {
     },
     /** Fuerza la carga del manifiesto (útil al arrancar o en tests). */
     cargar: () => refrescando ??= refrescar(),
+    /**
+     * Si la request es un bot leyendo una página del sitio, le avisa al
+     * gateway y devuelve la promesa del aviso (para `waitUntil`); si no, null.
+     * El aviso nunca lanza ni demora la página: 3 s de tope y se descarta la
+     * respuesta.
+     */
+    reportarLectura(input) {
+      const lectura = lecturaDeBot(input);
+      if (!lectura) return null;
+      return fetchImpl(`${base}/kit/visita`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(lectura),
+        signal: AbortSignal.timeout(3e3)
+      }).then((res) => res.body?.cancel()).catch(() => void 0);
+    },
     /**
      * Decide si la request va al gateway. `method` y `pathname` de la request,
      * `search` con el `?` incluido, y los headers para cortar bucles.
@@ -391,6 +436,7 @@ function crearPeaje(opciones) {
   const secreto = opciones.secret ?? env("PEAJE_ORIGIN_SECRET") ?? null;
   const fetchImpl = opciones.fetch ?? ((...a) => fetch(...a));
   const runtime = crearProxyRuntime({ base, secreto, fetchImpl, prefijosApi: opciones.apiPrefixes ?? PREFIJOS_API_POR_DEFECTO });
+  const reportar = opciones.reportBotVisits !== false;
   return {
     base,
     async decidir({ method, url, headers }) {
@@ -418,6 +464,9 @@ function crearPeaje(opciones) {
       vuelta.delete("transfer-encoding");
       vuelta.delete("connection");
       return new Response(method === "HEAD" ? null : res.body, { status: res.status, statusText: res.statusText, headers: vuelta });
+    },
+    reportarLectura({ method, url, headers }) {
+      return reportar ? runtime.reportarLectura({ method, pathname: url.pathname, headers }) : null;
     }
   };
 }
@@ -477,7 +526,10 @@ function peajeExpress(opciones) {
     const r = req;
     const entrada = { method: (r.method ?? "GET").toUpperCase(), url: urlDe(r), headers: headersDe(r) };
     peaje.decidir(entrada).then(async (destino) => {
-      if (!destino) return next();
+      if (!destino) {
+        void peaje.reportarLectura(entrada);
+        return next();
+      }
       const body = entrada.method === "GET" || entrada.method === "HEAD" ? null : await bodyDe(r);
       await enviar(res, await peaje.reenviar(destino, { ...entrada, body }));
     }).catch((e) => {

package/dist/express.js

@@ -1,6 +1,6 @@
 import {
   crearPeaje
-} from "./chunk-QHUY5N5S.js";
+} from "./chunk-SWB3HJVY.js";
 
 // src/express.ts
 import { Readable } from "stream";
@@ -58,7 +58,10 @@ function peajeExpress(opciones) {
     const r = req;
     const entrada = { method: (r.method ?? "GET").toUpperCase(), url: urlDe(r), headers: headersDe(r) };
     peaje.decidir(entrada).then(async (destino) => {
-      if (!destino) return next();
+      if (!destino) {
+        void peaje.reportarLectura(entrada);
+        return next();
+      }
       const body = entrada.method === "GET" || entrada.method === "HEAD" ? null : await bodyDe(r);
       await enviar(res, await peaje.reenviar(destino, { ...entrada, body }));
     }).catch((e) => {

package/dist/hono.cjs

@@ -82,6 +82,24 @@ var PATHS_RESERVADOS = [
 var PEAJE_FETCH_HEADER = "x-peaje-fetch";
 var PEAJE_HOST_HEADER = "x-peaje-forwarded-host";
 
+// ../shared/src/kit/bots.ts
+var BOTS_DE_VISITA = [
+  { patron: /OAI-SearchBot/i, tipo: "openai-searchbot" },
+  { patron: /PerplexityBot/i, tipo: "perplexitybot" },
+  { patron: /Googlebot/i, tipo: "googlebot" },
+  { patron: /ClaudeBot|anthropic-ai/i, tipo: "claudebot" },
+  { patron: /GPTBot/i, tipo: "gptbot" }
+];
+function tipoDeBot(ua) {
+  if (!ua) return null;
+  for (const b of BOTS_DE_VISITA) if (b.patron.test(ua)) return b.tipo;
+  return null;
+}
+var PEAJE_VERIFICADOR_HEADER = "x-peaje-verificador";
+var NO_ES_PAGINA = /\.(png|jpe?g|gif|webp|avif|svg|ico|css|m?js|map|woff2?|ttf|otf|eot|mp4|webm|mp3|wav)$/i;
+var MAX_PATH_LECTURA = 500;
+var MAX_UA_LECTURA = 300;
+
 // ../shared/src/kit/proxy-runtime.ts
 var PEAJE_ORIGIN_HEADER = "x-peaje-origin";
 function iguales(a, b) {
@@ -158,6 +176,17 @@ function patronReenviable(patron) {
   if (segs.length === 0) return false;
   return !(segs.length === 1 && (segs[0] === "*" || segs[0].startsWith(":")));
 }
+function lecturaDeBot(input) {
+  const method = input.method.toUpperCase();
+  if (method !== "GET" && method !== "HEAD") return null;
+  const h = input.headers;
+  if (h.has(PEAJE_ORIGIN_HEADER) || h.has(PEAJE_FETCH_HEADER) || h.has(PEAJE_VERIFICADOR_HEADER)) return null;
+  const ua = h.get("user-agent");
+  if (!ua || !tipoDeBot(ua)) return null;
+  const path = input.pathname;
+  if (!path.startsWith("/") || path.startsWith("/_next/") || path.startsWith("/_vercel/") || NO_ES_PAGINA.test(path)) return null;
+  return { path: path.slice(0, MAX_PATH_LECTURA), method, userAgent: ua.slice(0, MAX_UA_LECTURA) };
+}
 function crearProxyRuntime(opciones) {
   const base = opciones.base.replace(/\/+$/, "");
   const ttl = opciones.ttlMs ?? 6e4;
@@ -202,6 +231,22 @@ function crearProxyRuntime(opciones) {
     },
     /** Fuerza la carga del manifiesto (útil al arrancar o en tests). */
     cargar: () => refrescando ??= refrescar(),
+    /**
+     * Si la request es un bot leyendo una página del sitio, le avisa al
+     * gateway y devuelve la promesa del aviso (para `waitUntil`); si no, null.
+     * El aviso nunca lanza ni demora la página: 3 s de tope y se descarta la
+     * respuesta.
+     */
+    reportarLectura(input) {
+      const lectura = lecturaDeBot(input);
+      if (!lectura) return null;
+      return fetchImpl(`${base}/kit/visita`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(lectura),
+        signal: AbortSignal.timeout(3e3)
+      }).then((res) => res.body?.cancel()).catch(() => void 0);
+    },
     /**
      * Decide si la request va al gateway. `method` y `pathname` de la request,
      * `search` con el `?` incluido, y los headers para cortar bucles.
@@ -390,6 +435,7 @@ function crearPeaje(opciones) {
   const secreto = opciones.secret ?? env("PEAJE_ORIGIN_SECRET") ?? null;
   const fetchImpl = opciones.fetch ?? ((...a) => fetch(...a));
   const runtime = crearProxyRuntime({ base, secreto, fetchImpl, prefijosApi: opciones.apiPrefixes ?? PREFIJOS_API_POR_DEFECTO });
+  const reportar = opciones.reportBotVisits !== false;
   return {
     base,
     async decidir({ method, url, headers }) {
@@ -417,16 +463,26 @@ function crearPeaje(opciones) {
       vuelta.delete("transfer-encoding");
       vuelta.delete("connection");
       return new Response(method === "HEAD" ? null : res.body, { status: res.status, statusText: res.statusText, headers: vuelta });
+    },
+    reportarLectura({ method, url, headers }) {
+      return reportar ? runtime.reportarLectura({ method, pathname: url.pathname, headers }) : null;
     }
   };
 }
 function peajeFetch(opciones) {
   const peaje = crearPeaje(opciones);
-  return async (request) => {
+  return async (request, waitUntil) => {
     const url = new URL(request.url);
     const entrada = { method: request.method.toUpperCase(), url, headers: request.headers };
     const destino = await peaje.decidir(entrada);
-    if (!destino) return null;
+    if (!destino) {
+      const lectura = peaje.reportarLectura(entrada);
+      if (lectura) {
+        if (waitUntil) waitUntil(lectura);
+        else void lectura;
+      }
+      return null;
+    }
     const body = entrada.method === "GET" || entrada.method === "HEAD" ? null : await request.arrayBuffer();
     return peaje.reenviar(destino, { ...entrada, body });
   };
@@ -440,11 +496,19 @@ function peajeHono(opciones) {
       ...opciones,
       secret: opciones.secret ?? c.env?.PEAJE_ORIGIN_SECRET
     });
-    const res = await peaje(c.req.raw);
+    const res = await peaje(c.req.raw, esperaDe(c));
     if (res) return res;
     await next();
   };
 }
+function esperaDe(c) {
+  try {
+    const ctx = c.executionCtx;
+    return ctx ? (promesa) => ctx.waitUntil(promesa) : void 0;
+  } catch {
+    return void 0;
+  }
+}
 var hono_default = peajeHono;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/hono.d.cts

@@ -17,6 +17,9 @@ type ContextoMinimo = {
         raw: Request;
     };
     env?: unknown;
+    executionCtx?: {
+        waitUntil(promesa: Promise<unknown>): void;
+    };
 };
 type MiddlewareHono = (c: ContextoMinimo, next: () => Promise<void>) => Promise<Response | void>;
 declare function peajeHono(opciones: OpcionesPeaje): MiddlewareHono;

package/dist/hono.d.ts

@@ -17,6 +17,9 @@ type ContextoMinimo = {
         raw: Request;
     };
     env?: unknown;
+    executionCtx?: {
+        waitUntil(promesa: Promise<unknown>): void;
+    };
 };
 type MiddlewareHono = (c: ContextoMinimo, next: () => Promise<void>) => Promise<Response | void>;
 declare function peajeHono(opciones: OpcionesPeaje): MiddlewareHono;

package/dist/hono.js

@@ -1,6 +1,6 @@
 import {
   peajeFetch
-} from "./chunk-QHUY5N5S.js";
+} from "./chunk-SWB3HJVY.js";
 
 // src/hono.ts
 function peajeHono(opciones) {
@@ -10,11 +10,19 @@ function peajeHono(opciones) {
       ...opciones,
       secret: opciones.secret ?? c.env?.PEAJE_ORIGIN_SECRET
     });
-    const res = await peaje(c.req.raw);
+    const res = await peaje(c.req.raw, esperaDe(c));
     if (res) return res;
     await next();
   };
 }
+function esperaDe(c) {
+  try {
+    const ctx = c.executionCtx;
+    return ctx ? (promesa) => ctx.waitUntil(promesa) : void 0;
+  } catch {
+    return void 0;
+  }
+}
 var hono_default = peajeHono;
 export {
   hono_default as default,

package/dist/index.cjs

@@ -86,6 +86,24 @@ var PATHS_RESERVADOS = [
 var PEAJE_FETCH_HEADER = "x-peaje-fetch";
 var PEAJE_HOST_HEADER = "x-peaje-forwarded-host";
 
+// ../shared/src/kit/bots.ts
+var BOTS_DE_VISITA = [
+  { patron: /OAI-SearchBot/i, tipo: "openai-searchbot" },
+  { patron: /PerplexityBot/i, tipo: "perplexitybot" },
+  { patron: /Googlebot/i, tipo: "googlebot" },
+  { patron: /ClaudeBot|anthropic-ai/i, tipo: "claudebot" },
+  { patron: /GPTBot/i, tipo: "gptbot" }
+];
+function tipoDeBot(ua) {
+  if (!ua) return null;
+  for (const b of BOTS_DE_VISITA) if (b.patron.test(ua)) return b.tipo;
+  return null;
+}
+var PEAJE_VERIFICADOR_HEADER = "x-peaje-verificador";
+var NO_ES_PAGINA = /\.(png|jpe?g|gif|webp|avif|svg|ico|css|m?js|map|woff2?|ttf|otf|eot|mp4|webm|mp3|wav)$/i;
+var MAX_PATH_LECTURA = 500;
+var MAX_UA_LECTURA = 300;
+
 // ../shared/src/kit/proxy-runtime.ts
 var PEAJE_ORIGIN_HEADER = "x-peaje-origin";
 function iguales(a, b) {
@@ -162,6 +180,17 @@ function patronReenviable(patron) {
   if (segs.length === 0) return false;
   return !(segs.length === 1 && (segs[0] === "*" || segs[0].startsWith(":")));
 }
+function lecturaDeBot(input) {
+  const method = input.method.toUpperCase();
+  if (method !== "GET" && method !== "HEAD") return null;
+  const h = input.headers;
+  if (h.has(PEAJE_ORIGIN_HEADER) || h.has(PEAJE_FETCH_HEADER) || h.has(PEAJE_VERIFICADOR_HEADER)) return null;
+  const ua = h.get("user-agent");
+  if (!ua || !tipoDeBot(ua)) return null;
+  const path = input.pathname;
+  if (!path.startsWith("/") || path.startsWith("/_next/") || path.startsWith("/_vercel/") || NO_ES_PAGINA.test(path)) return null;
+  return { path: path.slice(0, MAX_PATH_LECTURA), method, userAgent: ua.slice(0, MAX_UA_LECTURA) };
+}
 function crearProxyRuntime(opciones) {
   const base = opciones.base.replace(/\/+$/, "");
   const ttl = opciones.ttlMs ?? 6e4;
@@ -206,6 +235,22 @@ function crearProxyRuntime(opciones) {
     },
     /** Fuerza la carga del manifiesto (útil al arrancar o en tests). */
     cargar: () => refrescando ??= refrescar(),
+    /**
+     * Si la request es un bot leyendo una página del sitio, le avisa al
+     * gateway y devuelve la promesa del aviso (para `waitUntil`); si no, null.
+     * El aviso nunca lanza ni demora la página: 3 s de tope y se descarta la
+     * respuesta.
+     */
+    reportarLectura(input) {
+      const lectura = lecturaDeBot(input);
+      if (!lectura) return null;
+      return fetchImpl(`${base}/kit/visita`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(lectura),
+        signal: AbortSignal.timeout(3e3)
+      }).then((res) => res.body?.cancel()).catch(() => void 0);
+    },
     /**
      * Decide si la request va al gateway. `method` y `pathname` de la request,
      * `search` con el `?` incluido, y los headers para cortar bucles.
@@ -397,6 +442,7 @@ function crearPeaje(opciones) {
   const secreto = opciones.secret ?? env("PEAJE_ORIGIN_SECRET") ?? null;
   const fetchImpl = opciones.fetch ?? ((...a) => fetch(...a));
   const runtime = crearProxyRuntime({ base, secreto, fetchImpl, prefijosApi: opciones.apiPrefixes ?? PREFIJOS_API_POR_DEFECTO });
+  const reportar = opciones.reportBotVisits !== false;
   return {
     base,
     async decidir({ method, url, headers }) {
@@ -424,16 +470,26 @@ function crearPeaje(opciones) {
       vuelta.delete("transfer-encoding");
       vuelta.delete("connection");
       return new Response(method === "HEAD" ? null : res.body, { status: res.status, statusText: res.statusText, headers: vuelta });
+    },
+    reportarLectura({ method, url, headers }) {
+      return reportar ? runtime.reportarLectura({ method, pathname: url.pathname, headers }) : null;
     }
   };
 }
 function peajeFetch(opciones) {
   const peaje = crearPeaje(opciones);
-  return async (request) => {
+  return async (request, waitUntil) => {
     const url = new URL(request.url);
     const entrada = { method: request.method.toUpperCase(), url, headers: request.headers };
     const destino = await peaje.decidir(entrada);
-    if (!destino) return null;
+    if (!destino) {
+      const lectura = peaje.reportarLectura(entrada);
+      if (lectura) {
+        if (waitUntil) waitUntil(lectura);
+        else void lectura;
+      }
+      return null;
+    }
     const body = entrada.method === "GET" || entrada.method === "HEAD" ? null : await request.arrayBuffer();
     return peaje.reenviar(destino, { ...entrada, body });
   };

package/dist/index.d.cts

@@ -17,6 +17,12 @@ type OpcionesPeaje = {
      * (`/login`, `/auth`, `/api/auth`, `/_next`...) nunca se aceptan.
      */
     apiPrefixes?: string[];
+    /**
+     * Avisarle al gateway cuando un bot de IA lee una página de la app, para el
+     * registro de visitas. Solo viajan la ruta (sin query) y el user-agent del
+     * bot. Por defecto `true`.
+     */
+    reportBotVisits?: boolean;
     /** Para tests o runtimes sin fetch global. */
     fetch?: typeof fetch;
 };
@@ -39,15 +45,23 @@ type Peaje = {
     reenviar(destino: string, entrada: EntradaDecision & {
         body: BodyInit | null;
     }): Promise<Response>;
+    /**
+     * Para una request que no fue al gateway: si es un bot de IA leyendo una
+     * página, se lo avisa al gateway y devuelve la promesa del aviso (para
+     * `waitUntil`). Null si no hay nada que avisar. Nunca lanza.
+     */
+    reportarLectura(entrada: EntradaDecision): Promise<void> | null;
 };
 declare function baseDe({ slug, gateway }: Pick<OpcionesPeaje, 'slug' | 'gateway'>): string;
 /** Solo para tests: vuelve a permitir el aviso de secreto faltante. */
 declare function _reiniciarAviso(): void;
 declare function crearPeaje(opciones: OpcionesPeaje): Peaje;
-type PeajeFetch = (request: Request) => Promise<Response | null>;
+type PeajeFetch = (request: Request, waitUntil?: (promesa: Promise<unknown>) => void) => Promise<Response | null>;
 /**
  * `(request) => Response | null`. Null: la request no es de Peaje y la
- * atiende la app. El body se lee (en memoria) solo si va al gateway.
+ * atiende la app. El body se lee (en memoria) solo si va al gateway. Con
+ * `waitUntil` (Workers, Vercel), el aviso de lectura de un bot corre ahí;
+ * sin él, al costado.
  */
 declare function peajeFetch(opciones: OpcionesPeaje): PeajeFetch;
 

package/dist/index.d.ts

@@ -17,6 +17,12 @@ type OpcionesPeaje = {
      * (`/login`, `/auth`, `/api/auth`, `/_next`...) nunca se aceptan.
      */
     apiPrefixes?: string[];
+    /**
+     * Avisarle al gateway cuando un bot de IA lee una página de la app, para el
+     * registro de visitas. Solo viajan la ruta (sin query) y el user-agent del
+     * bot. Por defecto `true`.
+     */
+    reportBotVisits?: boolean;
     /** Para tests o runtimes sin fetch global. */
     fetch?: typeof fetch;
 };
@@ -39,15 +45,23 @@ type Peaje = {
     reenviar(destino: string, entrada: EntradaDecision & {
         body: BodyInit | null;
     }): Promise<Response>;
+    /**
+     * Para una request que no fue al gateway: si es un bot de IA leyendo una
+     * página, se lo avisa al gateway y devuelve la promesa del aviso (para
+     * `waitUntil`). Null si no hay nada que avisar. Nunca lanza.
+     */
+    reportarLectura(entrada: EntradaDecision): Promise<void> | null;
 };
 declare function baseDe({ slug, gateway }: Pick<OpcionesPeaje, 'slug' | 'gateway'>): string;
 /** Solo para tests: vuelve a permitir el aviso de secreto faltante. */
 declare function _reiniciarAviso(): void;
 declare function crearPeaje(opciones: OpcionesPeaje): Peaje;
-type PeajeFetch = (request: Request) => Promise<Response | null>;
+type PeajeFetch = (request: Request, waitUntil?: (promesa: Promise<unknown>) => void) => Promise<Response | null>;
 /**
  * `(request) => Response | null`. Null: la request no es de Peaje y la
- * atiende la app. El body se lee (en memoria) solo si va al gateway.
+ * atiende la app. El body se lee (en memoria) solo si va al gateway. Con
+ * `waitUntil` (Workers, Vercel), el aviso de lectura de un bot corre ahí;
+ * sin él, al costado.
  */
 declare function peajeFetch(opciones: OpcionesPeaje): PeajeFetch;
 

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   crearPeaje,
   peajeFetch,
   src_default
-} from "./chunk-QHUY5N5S.js";
+} from "./chunk-SWB3HJVY.js";
 export {
   GATEWAY_POR_DEFECTO,
   _reiniciarAviso,

package/dist/vercel.cjs

@@ -82,6 +82,24 @@ var PATHS_RESERVADOS = [
 var PEAJE_FETCH_HEADER = "x-peaje-fetch";
 var PEAJE_HOST_HEADER = "x-peaje-forwarded-host";
 
+// ../shared/src/kit/bots.ts
+var BOTS_DE_VISITA = [
+  { patron: /OAI-SearchBot/i, tipo: "openai-searchbot" },
+  { patron: /PerplexityBot/i, tipo: "perplexitybot" },
+  { patron: /Googlebot/i, tipo: "googlebot" },
+  { patron: /ClaudeBot|anthropic-ai/i, tipo: "claudebot" },
+  { patron: /GPTBot/i, tipo: "gptbot" }
+];
+function tipoDeBot(ua) {
+  if (!ua) return null;
+  for (const b of BOTS_DE_VISITA) if (b.patron.test(ua)) return b.tipo;
+  return null;
+}
+var PEAJE_VERIFICADOR_HEADER = "x-peaje-verificador";
+var NO_ES_PAGINA = /\.(png|jpe?g|gif|webp|avif|svg|ico|css|m?js|map|woff2?|ttf|otf|eot|mp4|webm|mp3|wav)$/i;
+var MAX_PATH_LECTURA = 500;
+var MAX_UA_LECTURA = 300;
+
 // ../shared/src/kit/proxy-runtime.ts
 var PEAJE_ORIGIN_HEADER = "x-peaje-origin";
 function iguales(a, b) {
@@ -158,6 +176,17 @@ function patronReenviable(patron) {
   if (segs.length === 0) return false;
   return !(segs.length === 1 && (segs[0] === "*" || segs[0].startsWith(":")));
 }
+function lecturaDeBot(input) {
+  const method = input.method.toUpperCase();
+  if (method !== "GET" && method !== "HEAD") return null;
+  const h = input.headers;
+  if (h.has(PEAJE_ORIGIN_HEADER) || h.has(PEAJE_FETCH_HEADER) || h.has(PEAJE_VERIFICADOR_HEADER)) return null;
+  const ua = h.get("user-agent");
+  if (!ua || !tipoDeBot(ua)) return null;
+  const path = input.pathname;
+  if (!path.startsWith("/") || path.startsWith("/_next/") || path.startsWith("/_vercel/") || NO_ES_PAGINA.test(path)) return null;
+  return { path: path.slice(0, MAX_PATH_LECTURA), method, userAgent: ua.slice(0, MAX_UA_LECTURA) };
+}
 function crearProxyRuntime(opciones) {
   const base = opciones.base.replace(/\/+$/, "");
   const ttl = opciones.ttlMs ?? 6e4;
@@ -202,6 +231,22 @@ function crearProxyRuntime(opciones) {
     },
     /** Fuerza la carga del manifiesto (útil al arrancar o en tests). */
     cargar: () => refrescando ??= refrescar(),
+    /**
+     * Si la request es un bot leyendo una página del sitio, le avisa al
+     * gateway y devuelve la promesa del aviso (para `waitUntil`); si no, null.
+     * El aviso nunca lanza ni demora la página: 3 s de tope y se descarta la
+     * respuesta.
+     */
+    reportarLectura(input) {
+      const lectura = lecturaDeBot(input);
+      if (!lectura) return null;
+      return fetchImpl(`${base}/kit/visita`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(lectura),
+        signal: AbortSignal.timeout(3e3)
+      }).then((res) => res.body?.cancel()).catch(() => void 0);
+    },
     /**
      * Decide si la request va al gateway. `method` y `pathname` de la request,
      * `search` con el `?` incluido, y los headers para cortar bucles.
@@ -390,6 +435,7 @@ function crearPeaje(opciones) {
   const secreto = opciones.secret ?? env("PEAJE_ORIGIN_SECRET") ?? null;
   const fetchImpl = opciones.fetch ?? ((...a) => fetch(...a));
   const runtime = crearProxyRuntime({ base, secreto, fetchImpl, prefijosApi: opciones.apiPrefixes ?? PREFIJOS_API_POR_DEFECTO });
+  const reportar = opciones.reportBotVisits !== false;
   return {
     base,
     async decidir({ method, url, headers }) {
@@ -417,6 +463,9 @@ function crearPeaje(opciones) {
       vuelta.delete("transfer-encoding");
       vuelta.delete("connection");
       return new Response(method === "HEAD" ? null : res.body, { status: res.status, statusText: res.statusText, headers: vuelta });
+    },
+    reportarLectura({ method, url, headers }) {
+      return reportar ? runtime.reportarLectura({ method, pathname: url.pathname, headers }) : null;
     }
   };
 }
@@ -448,6 +497,11 @@ function peajeVercel(opciones, siguiente) {
       headers.set("x-forwarded-proto", url.protocol.replace(":", ""));
       return respuestaMiddleware({ "x-middleware-rewrite": destino }, headers);
     }
+    const lectura = peaje.reportarLectura(entrada);
+    if (lectura) {
+      if (context?.waitUntil) context.waitUntil(lectura);
+      else void lectura;
+    }
     const propia = siguiente ? await siguiente(request, context) : void 0;
     return propia ?? respuestaMiddleware({ "x-middleware-next": "1" });
   };

package/dist/vercel.js

@@ -2,7 +2,7 @@ import {
   HEADERS_NO_REENVIADOS,
   PEAJE_HOST_HEADER,
   crearPeaje
-} from "./chunk-QHUY5N5S.js";
+} from "./chunk-SWB3HJVY.js";
 
 // src/vercel.ts
 function respuestaMiddleware(control, requestHeaders) {
@@ -31,6 +31,11 @@ function peajeVercel(opciones, siguiente) {
       headers.set("x-forwarded-proto", url.protocol.replace(":", ""));
       return respuestaMiddleware({ "x-middleware-rewrite": destino }, headers);
     }
+    const lectura = peaje.reportarLectura(entrada);
+    if (lectura) {
+      if (context?.waitUntil) context.waitUntil(lectura);
+      else void lectura;
+    }
     const propia = siguiente ? await siguiente(request, context) : void 0;
     return propia ?? respuestaMiddleware({ "x-middleware-next": "1" });
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peaje/proxy",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Peaje for any server: answer HTTP 402 (MPP, x402) for your priced API routes on your own domain. Fetch handler plus Express, Hono and Vercel Routing Middleware adapters.",
   "license": "MIT",
   "repository": {