Function withObserve

withObserve<TContext = unknown>(
handler: NextRouteHandler<TContext>,
options?: NextObserveOptions,
): NextRouteHandler<TContext>

Wrap a Next.js App Router handler with automatic trace flushing

Type Parameters

TContext = unknown

Parameters

handler: NextRouteHandler<TContext>
Your route handler function
Optionaloptions: NextObserveOptions
Optional: pass after (Next.js 15+) or waitUntil (Vercel)

Returns NextRouteHandler<TContext>

Wrapped handler that auto-flushes traces

Example

// Basic usage (blocking flush)
export const POST = withObserve(async (req) => {
  return Response.json({ ok: true });
});

Example

// Next.js 15+ with after() - non-blocking (recommended)
import { after } from 'next/server';

export const POST = withObserve(
  async (req) => Response.json({ ok: true }),
  { after }
);

Example

// Vercel with waitUntil() - non-blocking
import { waitUntil } from '@vercel/functions';

export const POST = withObserve(
  async (req) => Response.json({ ok: true }),
  { waitUntil }
);

Function withObserve

Type Parameters

Parameters

Returns NextRouteHandler<TContext>

Example

Example

Example

Settings