voraq-next

SDK de observabilidad de Voraq para aplicaciones Next.js. onRequestError captura excepciones y withVoraq captura respuestas 5xx de route handlers.

Desde 0.4.0, el SDK también puede observar HTTP 413 devueltos al navegador antes de que la plataforma invoque Next. El Kit de Voraq instala esta integración automáticamente en Next.js 15.3+; si integras el SDK manualmente, usa las siguientes superficies:

// app/api/voraq/platform-413/route.js
import { createPlatform413RelayHandler } from "voraq-next/platform-413";
export const POST = createPlatform413RelayHandler();

// app/api/voraq/platform-413/worker/route.js
import { createPlatform413WorkerHandler } from "voraq-next/platform-413";
export const GET = createPlatform413WorkerHandler();

// public/voraq-platform-413-sw.js
importScripts("/api/voraq/platform-413/worker");

// instrumentation-client.js
import { registerPlatform413Capture } from "voraq-next/platform-413/client";
registerPlatform413Capture();

Si usas basePath, pasa { basePath: "/tu-base" } a las tres funciones exportadas e incluye ese prefijo en la URL de importScripts.

Configura VORAQ_INGEST_KEY sólo en el servidor. En Vercel, el entorno y la release se obtienen de VERCEL_ENV y VERCEL_GIT_COMMIT_SHA; fuera de Vercel usa VORAQ_ENVIRONMENT y VORAQ_RELEASE.

El evento es observado por el navegador, no un log verificado del proveedor. La respuesta original no cambia. No cubre peticiones anteriores a la activación del Service Worker, navegadores sin soporte ni tráfico iniciado sólo en servidor.

Capturar menús y popovers en feedback

Con el widget de feedback habilitado y la sesión iniciada, abre el menú o popover de la aplicación y presiona Ctrl + . para congelar la vista antes de abrir el editor: arrastra sobre la imagen congelada, escribe el comentario y revisa la captura. El botón de navegación descarta la vista congelada y vuelve a la página en vivo. Si desplazas o cambias el tamaño de la página antes de marcar el área, repite el atajo. Los menús nativos del navegador o del sistema pueden no recibir el atajo de la página.