Next.js logging with alerts, in 5 minutes

Logs and errors from your routes and server actions, errors that blow up in your customers' browsers, and an alert when an order never finishes. On Vercel or your own server.

1. 1

   Install

   npm i @estiaje/sdk

2. 2

   Your key

   Create your account and put the key in ESTIAJE_TOKEN. Or ask your AI “connect this repo to Estiaje” (the connector). Without the key nothing leaves over the network: you can instrument today.

3. 3

   Your logs and errors, at startup (instrumentation.ts)

   App Router · VercelCustom serverYour site (browser)● Not tested yet

   // lib/estiaje.ts
   import { estiajeFromEnv } from '@estiaje/sdk';
   export const estiaje = estiajeFromEnv({ service: 'tienda-web' });
   
   // instrumentation.ts
   export async function register() {
     if (process.env.NEXT_RUNTIME === 'nodejs') {
       const { estiaje } = await import('./lib/estiaje');
       estiaje.capturarConsola();
       estiaje.capturarErrores();
     }
   }

   // server.ts (Next.js with a custom server)
   import { estiaje } from './lib/estiaje';
   estiaje.capturarConsola();
   estiaje.capturarErrores();
   
   createServer((req, res) =>
     estiaje.middleware()(req, res, () => handle(req, res))   // each request's thread
   ).listen(3000);

   <!-- app/layout.tsx, before </head>; create the cp_live_ key in Errors -->
   <script src="https://estiaje.mx/navegador.js"
     data-llave="cp_live_…" data-servicio="tienda-web" async></script>

4. 4

   The process that must finish

   // app/api/orders/route.ts
   import { estiaje } from '@/lib/estiaje';
   
   export async function POST(req: Request) {
     // … you charge the order …
     estiaje.event('order.paid', { order_id, amount });
     await estiaje.flush();   // on Vercel, before responding: the function freezes
     return Response.json({ ok: true });
   }

5. 5

   The alert

   In the dashboard, under Processes: “every order.paid expects its order.shipped, by order_id, within 30 minutes”. If it never comes, you get a phone, email or Slack alert, with the money at risk.