@autter/runtime-next 1.4.0 → 1.6.0

package/dist/instrumentation.d.cts

@@ -0,0 +1,39 @@
+import { A as AutterOnRequestErrorOptions, N as NextOnRequestError } from './request-error-DzJdPaVe.cjs';
+export { a as NextRequestErrorContext, b as NextRequestErrorRequest } from './request-error-DzJdPaVe.cjs';
+import '@autter/runtime-edge';
+
+/**
+ * `@autter/runtime-next/instrumentation` — Next.js `onRequestError` (Next 15+).
+ * Errors Next catches in server components, server actions, route handlers
+ * and middleware are reported with their stack and Next's context, instead
+ * of arriving as stackless 500s:
+ *
+ *   // instrumentation.ts
+ *   export { onRequestError } from "@autter/runtime-next/instrumentation";
+ *
+ * Safe for both runtimes Next compiles `instrumentation.ts` for:
+ *
+ * - Node: records the error on the request's span through the tracker that
+ *   `registerAutter` started (`captureRequestError`). @autter/runtime-node is
+ *   imported lazily, inside a `process.env.NEXT_RUNTIME` branch Next removes
+ *   from edge bundles.
+ * - Edge: the package's `edge-light`/`worker` export condition resolves to an
+ *   edge-only build that never references Node code; errors go to `/v1/logs`
+ *   with the `edge` options (see `autterOnRequestError`).
+ */
+
+/**
+ * Build an `onRequestError` with options:
+ *
+ *   export const onRequestError = autterOnRequestError({
+ *     edge: { apiKey: process.env.AUTTER_RUNTIME_KEY, service: "web-app" },
+ *   });
+ *
+ * Never throws into Next.
+ */
+declare function autterOnRequestError(options?: AutterOnRequestErrorOptions): NextOnRequestError;
+/** Ready-made `onRequestError`: Node errors go to the `registerAutter`
+ * tracker; on the edge it needs `autterOnRequestError({ edge })`. */
+declare const onRequestError: NextOnRequestError;
+
+export { AutterOnRequestErrorOptions, NextOnRequestError, autterOnRequestError, onRequestError };

package/dist/instrumentation.d.ts

@@ -0,0 +1,39 @@
+import { A as AutterOnRequestErrorOptions, N as NextOnRequestError } from './request-error-DzJdPaVe.js';
+export { a as NextRequestErrorContext, b as NextRequestErrorRequest } from './request-error-DzJdPaVe.js';
+import '@autter/runtime-edge';
+
+/**
+ * `@autter/runtime-next/instrumentation` — Next.js `onRequestError` (Next 15+).
+ * Errors Next catches in server components, server actions, route handlers
+ * and middleware are reported with their stack and Next's context, instead
+ * of arriving as stackless 500s:
+ *
+ *   // instrumentation.ts
+ *   export { onRequestError } from "@autter/runtime-next/instrumentation";
+ *
+ * Safe for both runtimes Next compiles `instrumentation.ts` for:
+ *
+ * - Node: records the error on the request's span through the tracker that
+ *   `registerAutter` started (`captureRequestError`). @autter/runtime-node is
+ *   imported lazily, inside a `process.env.NEXT_RUNTIME` branch Next removes
+ *   from edge bundles.
+ * - Edge: the package's `edge-light`/`worker` export condition resolves to an
+ *   edge-only build that never references Node code; errors go to `/v1/logs`
+ *   with the `edge` options (see `autterOnRequestError`).
+ */
+
+/**
+ * Build an `onRequestError` with options:
+ *
+ *   export const onRequestError = autterOnRequestError({
+ *     edge: { apiKey: process.env.AUTTER_RUNTIME_KEY, service: "web-app" },
+ *   });
+ *
+ * Never throws into Next.
+ */
+declare function autterOnRequestError(options?: AutterOnRequestErrorOptions): NextOnRequestError;
+/** Ready-made `onRequestError`: Node errors go to the `registerAutter`
+ * tracker; on the edge it needs `autterOnRequestError({ edge })`. */
+declare const onRequestError: NextOnRequestError;
+
+export { AutterOnRequestErrorOptions, NextOnRequestError, autterOnRequestError, onRequestError };

package/dist/instrumentation.js

@@ -0,0 +1,31 @@
+import {
+  reportOnEdge,
+  requestErrorAttributes,
+  shouldReport
+} from "./chunk-CL2ENM4A.js";
+
+// src/instrumentation.ts
+function autterOnRequestError(options = {}) {
+  return async function onRequestError2(error, request, context) {
+    try {
+      if (!shouldReport(error, options.capture)) return;
+      const attributes = requestErrorAttributes(error, request, context);
+      if (typeof process === "undefined") {
+        await reportOnEdge(options.edge, error, attributes);
+        return;
+      }
+      if (process.env.NEXT_RUNTIME === "edge") {
+        await reportOnEdge(options.edge, error, attributes);
+      } else {
+        const node = await import("@autter/runtime-node");
+        (node.captureRequestError ?? node.captureException)(error, attributes);
+      }
+    } catch {
+    }
+  };
+}
+var onRequestError = autterOnRequestError();
+export {
+  autterOnRequestError,
+  onRequestError
+};

package/dist/request-error-DzJdPaVe.d.cts

@@ -0,0 +1,55 @@
+import { AutterEdgeOptions } from '@autter/runtime-edge';
+
+/**
+ * Shared, runtime-neutral half of Next.js `onRequestError` support. Imports
+ * only @autter/runtime-edge (no Node modules), so it is safe in the edge
+ * bundle; the Node half lives behind a dynamic import in instrumentation.ts.
+ */
+
+/** Next.js `onRequestError` request argument (typed structurally; no `next` dependency). */
+interface NextRequestErrorRequest {
+    /** Resource path, e.g. `/blog?name=foo` — recorded without the query string. */
+    path?: string;
+    method?: string;
+    /** Never read: cookies and auth headers stay out of telemetry. */
+    headers?: unknown;
+}
+/** Next.js `onRequestError` context argument. */
+interface NextRequestErrorContext {
+    /** `"App Router"` or `"Pages Router"` (also what Next passes for middleware and edge route handlers). */
+    routerKind?: string;
+    /**
+     * The route template, e.g. `/blog/[slug]` or `/api/orders`. Middleware:
+     * `/middleware` (Next 15) or `/proxy` (Next 16). An edge route handler
+     * reported by `next start`: the page, e.g. `/api/orders/route`.
+     */
+    routePath?: string;
+    /** `"render"`, `"route"`, `"action"`, `"middleware"` (Next 15) or `"proxy"` (Next 16). */
+    routeType?: string;
+    /** `"react-server-components"`, `"react-server-components-payload"` or `"server-rendering"`. */
+    renderSource?: string;
+    /** `"on-demand"`, `"stale"` or undefined (a normal request). */
+    revalidateReason?: string;
+    /** `"dynamic"` or `"dynamic-resume"` (PPR). */
+    renderType?: string;
+}
+/** The function Next.js calls from `instrumentation.ts`. */
+type NextOnRequestError = (error: unknown, request: NextRequestErrorRequest, context: NextRequestErrorContext) => Promise<void>;
+interface AutterOnRequestErrorOptions {
+    /**
+     * Which errors to report. Default: every error except Next's control-flow
+     * signals (`redirect()`, `notFound()`, `forbidden()`, `unauthorized()`,
+     * dynamic-rendering bailouts). `true` reports everything; a predicate
+     * decides per error.
+     */
+    capture?: boolean | ((error: unknown) => boolean);
+    /**
+     * Edge runtime only (middleware, `export const runtime = "edge"`): the
+     * Node tracker does not run there, so errors are sent straight to the
+     * ingester's `/v1/logs` with these options — a SERVER key. A function is
+     * called per error. Without it, edge errors are skipped (one warning).
+     */
+    edge?: AutterEdgeOptions | (() => AutterEdgeOptions | undefined);
+}
+
+export type { AutterOnRequestErrorOptions as A, NextOnRequestError as N, NextRequestErrorContext as a, NextRequestErrorRequest as b };

package/dist/request-error-DzJdPaVe.d.ts

@@ -0,0 +1,55 @@
+import { AutterEdgeOptions } from '@autter/runtime-edge';
+
+/**
+ * Shared, runtime-neutral half of Next.js `onRequestError` support. Imports
+ * only @autter/runtime-edge (no Node modules), so it is safe in the edge
+ * bundle; the Node half lives behind a dynamic import in instrumentation.ts.
+ */
+
+/** Next.js `onRequestError` request argument (typed structurally; no `next` dependency). */
+interface NextRequestErrorRequest {
+    /** Resource path, e.g. `/blog?name=foo` — recorded without the query string. */
+    path?: string;
+    method?: string;
+    /** Never read: cookies and auth headers stay out of telemetry. */
+    headers?: unknown;
+}
+/** Next.js `onRequestError` context argument. */
+interface NextRequestErrorContext {
+    /** `"App Router"` or `"Pages Router"` (also what Next passes for middleware and edge route handlers). */
+    routerKind?: string;
+    /**
+     * The route template, e.g. `/blog/[slug]` or `/api/orders`. Middleware:
+     * `/middleware` (Next 15) or `/proxy` (Next 16). An edge route handler
+     * reported by `next start`: the page, e.g. `/api/orders/route`.
+     */
+    routePath?: string;
+    /** `"render"`, `"route"`, `"action"`, `"middleware"` (Next 15) or `"proxy"` (Next 16). */
+    routeType?: string;
+    /** `"react-server-components"`, `"react-server-components-payload"` or `"server-rendering"`. */
+    renderSource?: string;
+    /** `"on-demand"`, `"stale"` or undefined (a normal request). */
+    revalidateReason?: string;
+    /** `"dynamic"` or `"dynamic-resume"` (PPR). */
+    renderType?: string;
+}
+/** The function Next.js calls from `instrumentation.ts`. */
+type NextOnRequestError = (error: unknown, request: NextRequestErrorRequest, context: NextRequestErrorContext) => Promise<void>;
+interface AutterOnRequestErrorOptions {
+    /**
+     * Which errors to report. Default: every error except Next's control-flow
+     * signals (`redirect()`, `notFound()`, `forbidden()`, `unauthorized()`,
+     * dynamic-rendering bailouts). `true` reports everything; a predicate
+     * decides per error.
+     */
+    capture?: boolean | ((error: unknown) => boolean);
+    /**
+     * Edge runtime only (middleware, `export const runtime = "edge"`): the
+     * Node tracker does not run there, so errors are sent straight to the
+     * ingester's `/v1/logs` with these options — a SERVER key. A function is
+     * called per error. Without it, edge errors are skipped (one warning).
+     */
+    edge?: AutterEdgeOptions | (() => AutterEdgeOptions | undefined);
+}
+
+export type { AutterOnRequestErrorOptions as A, NextOnRequestError as N, NextRequestErrorContext as a, NextRequestErrorRequest as b };

package/dist/server.cjs

@@ -20,52 +20,229 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/server.ts
 var server_exports = {};
 __export(server_exports, {
+  CODE_PATTERN: () => import_runtime_node2.CODE_PATTERN,
+  RuntimeError: () => import_runtime_node2.RuntimeError,
+  addBreadcrumb: () => import_runtime_node2.addBreadcrumb,
+  autterErrorHandler: () => import_runtime_node2.autterErrorHandler,
+  autterErrorResponse: () => import_runtime_node2.autterErrorResponse,
+  autterFastify: () => import_runtime_node2.autterFastify,
+  autterFastifyErrors: () => import_runtime_node2.autterFastifyErrors,
+  autterKoa: () => import_runtime_node2.autterKoa,
+  autterRequests: () => import_runtime_node2.autterRequests,
+  captureRequestError: () => import_runtime_node2.captureRequestError,
   captureServerException: () => import_runtime_node2.captureException,
   captureServerMessage: () => import_runtime_node2.captureMessage,
+  consoleSink: () => import_runtime_node2.consoleSink,
   createAutterRelayRoute: () => createAutterRelayRoute,
   createRuntimeLogger: () => import_runtime_node2.createRuntimeLogger,
+  defineRuntimeErrors: () => import_runtime_node2.defineRuntimeErrors,
   emitLlmSelftestTrace: () => import_runtime_node2.emitLlmSelftestTrace,
+  enrichDeployment: () => import_runtime_node2.enrichDeployment,
+  enrichEdgeGeo: () => import_runtime_node2.enrichEdgeGeo,
+  enrichRequestSize: () => import_runtime_node2.enrichRequestSize,
+  enrichUserAgent: () => import_runtime_node2.enrichUserAgent,
+  errorAttributes: () => import_runtime_node2.errorAttributes,
+  fileSink: () => import_runtime_node2.fileSink,
   flushRuntimeLogs: () => import_runtime_node2.flushRuntimeLogs,
+  initAutterLogging: () => import_runtime_node2.initAutterLogging,
   installAutterAutoFlush: () => import_runtime_node2.installAutterAutoFlush,
   instrumentLlmClient: () => import_runtime_node2.instrumentLlmClient,
+  isRuntimeErrorLike: () => import_runtime_node2.isRuntimeErrorLike,
   makeSafeCapture: () => import_runtime_node2.makeSafeCapture,
+  otlpSink: () => import_runtime_node2.otlpSink,
   redactAttributes: () => import_runtime_node2.redactAttributes,
+  redactText: () => import_runtime_node2.redactText,
   registerAutter: () => registerAutter,
   reportServerOutcome: () => import_runtime_node2.reportOutcome,
+  runInBackground: () => import_runtime_node2.runInBackground,
+  runtimeContext: () => import_runtime_node2.runtimeContext,
   runtimeLogStats: () => import_runtime_node2.runtimeLogStats,
   runtimeLogger: () => import_runtime_node2.runtimeLogger,
+  toClientError: () => import_runtime_node2.toClientError,
   trackLlmCall: () => import_runtime_node2.trackLlmCall,
   withLlmCall: () => import_runtime_node2.withLlmCall,
   withProcessSpan: () => import_runtime_node2.withProcessSpan,
-  withRuntimeOperation: () => import_runtime_node2.withRuntimeOperation
+  withRuntimeOperation: () => import_runtime_node2.withRuntimeOperation,
+  withRuntimeRequest: () => withRuntimeRequest
 });
 module.exports = __toCommonJS(server_exports);
 var import_runtime_node = require("@autter/runtime-node");
+
+// package.json
+var package_default = {
+  name: "@autter/runtime-next",
+  version: "1.6.0",
+  description: "One-command Autter Runtime for Next.js: server OTel, request wide events, coded errors, browser tracker, relay route, edge middleware and React error boundary",
+  license: "MIT",
+  type: "module",
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    },
+    "./server": {
+      types: "./dist/server.d.ts",
+      import: "./dist/server.js",
+      require: "./dist/server.cjs"
+    },
+    "./client": {
+      types: "./dist/client.d.ts",
+      import: "./dist/client.js",
+      require: "./dist/client.cjs"
+    },
+    "./edge": {
+      types: "./dist/edge.d.ts",
+      import: "./dist/edge.js",
+      require: "./dist/edge.cjs"
+    },
+    "./instrumentation": {
+      types: "./dist/instrumentation.d.ts",
+      "edge-light": {
+        import: "./dist/instrumentation-edge.js",
+        require: "./dist/instrumentation-edge.cjs"
+      },
+      worker: {
+        import: "./dist/instrumentation-edge.js",
+        require: "./dist/instrumentation-edge.cjs"
+      },
+      import: "./dist/instrumentation.js",
+      require: "./dist/instrumentation.cjs"
+    }
+  },
+  files: [
+    "dist"
+  ],
+  repository: {
+    type: "git",
+    url: "https://github.com/Autter-dev/autter-runtime.git",
+    directory: "packages/runtime-next"
+  },
+  scripts: {
+    build: `node ../../scripts/ensure-built.mjs runtime-node runtime-edge runtime-browser && node -e "require('node:fs').rmSync('dist',{recursive:true,force:true})" && tsup`,
+    test: "npm run build -w @autter/runtime-core && npm run build -w @autter/runtime-node && npm run build -w @autter/runtime-edge && npm run build -w @autter/runtime-browser && npm run build && node --test test/*.test.mjs"
+  },
+  dependencies: {
+    "@autter/runtime-browser": "^1.6.0",
+    "@autter/runtime-edge": "^1.1.0",
+    "@autter/runtime-node": "^1.6.0"
+  },
+  peerDependencies: {
+    react: ">=18"
+  },
+  devDependencies: {
+    "@types/react": "^18.3.0",
+    tsup: "^8.3.5",
+    typescript: "^5.7.0"
+  },
+  engines: {
+    node: ">=20"
+  },
+  publishConfig: {
+    access: "public",
+    provenance: true
+  },
+  homepage: "https://github.com/Autter-dev/autter-runtime#readme",
+  bugs: "https://github.com/Autter-dev/autter-runtime/issues",
+  keywords: [
+    "nextjs",
+    "error-tracking",
+    "telemetry",
+    "opentelemetry",
+    "react",
+    "error-boundary"
+  ]
+};
+
+// src/server.ts
 var import_runtime_node2 = require("@autter/runtime-node");
 function registerAutter(options) {
-  return (0, import_runtime_node.initAutterServer)(options);
+  return (0, import_runtime_node.initAutterServer)({
+    distro: { name: "@autter/runtime-next", version: package_default.version },
+    ...options
+  });
 }
 function createAutterRelayRoute(options) {
   return { POST: (0, import_runtime_node.createBrowserRelayFetchHandler)(options) };
 }
+var after;
+var afterReady = (async () => {
+  try {
+    const specifier = "next/server";
+    const mod = await import(
+      /* webpackIgnore: true */
+      specifier
+    );
+    after = mod.after ?? mod.unstable_after ?? null;
+  } catch {
+    after = null;
+  }
+  return after;
+})();
+function scheduleAfter(promise) {
+  const run = (fn) => {
+    if (!fn) return;
+    try {
+      fn(promise);
+    } catch {
+    }
+  };
+  if (after !== void 0) run(after);
+  else void afterReady.then(run);
+}
+function withRuntimeRequest(handler, options = {}) {
+  return (0, import_runtime_node.withRuntimeRequest)(handler, {
+    ...options,
+    waitUntil: options.waitUntil ?? scheduleAfter
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CODE_PATTERN,
+  RuntimeError,
+  addBreadcrumb,
+  autterErrorHandler,
+  autterErrorResponse,
+  autterFastify,
+  autterFastifyErrors,
+  autterKoa,
+  autterRequests,
+  captureRequestError,
   captureServerException,
   captureServerMessage,
+  consoleSink,
   createAutterRelayRoute,
   createRuntimeLogger,
+  defineRuntimeErrors,
   emitLlmSelftestTrace,
+  enrichDeployment,
+  enrichEdgeGeo,
+  enrichRequestSize,
+  enrichUserAgent,
+  errorAttributes,
+  fileSink,
   flushRuntimeLogs,
+  initAutterLogging,
   installAutterAutoFlush,
   instrumentLlmClient,
+  isRuntimeErrorLike,
   makeSafeCapture,
+  otlpSink,
   redactAttributes,
+  redactText,
   registerAutter,
   reportServerOutcome,
+  runInBackground,
+  runtimeContext,
   runtimeLogStats,
   runtimeLogger,
+  toClientError,
   trackLlmCall,
   withLlmCall,
   withProcessSpan,
-  withRuntimeOperation
+  withRuntimeOperation,
+  withRuntimeRequest
 });

package/dist/server.d.cts

@@ -1,5 +1,5 @@
-import { RelayOptions, AutterServerOptions, AutterServer } from '@autter/runtime-node';
-export { AutoFlushHandle, AutoFlushOptions, AutterServer, AutterServerOptions, FlushTarget, InstrumentLlmOptions, LlmCallHandle, LlmCallInfo, LlmUsage, RedactOptions, RelayOptions, RuntimeLogContext, RuntimeLogContextValue, RuntimeLogLevel, RuntimeLoggingOptions, RuntimeOperation, RuntimeOutcome, SafeCapture, TrackedLlmCall, captureException as captureServerException, captureMessage as captureServerMessage, createRuntimeLogger, emitLlmSelftestTrace, flushRuntimeLogs, installAutterAutoFlush, instrumentLlmClient, makeSafeCapture, redactAttributes, reportOutcome as reportServerOutcome, runtimeLogStats, runtimeLogger, trackLlmCall, withLlmCall, withProcessSpan, withRuntimeOperation } from '@autter/runtime-node';
+import { RelayOptions, AutterServerOptions, AutterServer, RuntimeRequestOptions } from '@autter/runtime-node';
+export { AutoFlushHandle, AutoFlushOptions, AutterErrorHandlerOptions, AutterErrorResponseOptions, AutterLogging, AutterLoggingOptions, AutterRequestsOptions, AutterServer, AutterServerOptions, Breadcrumb, BreadcrumbInput, CODE_PATTERN, ClientErrorBody, ConsoleSinkOptions, FileSinkOptions, FlushTarget, InstrumentLlmOptions, LlmCallHandle, LlmCallInfo, LlmUsage, OtlpSinkOptions, RedactOptions, RelayOptions, RuntimeCarrier, RuntimeContextHandle, RuntimeEnrichContext, RuntimeEnrichEvent, RuntimeEnricher, RuntimeError, RuntimeErrorCatalog, RuntimeErrorDefinition, RuntimeErrorExtras, RuntimeErrorFactory, RuntimeErrorLike, RuntimeErrorOptions, RuntimeEvent, RuntimeLogContext, RuntimeLogContextValue, RuntimeLogLevel, RuntimeLoggingOptions, RuntimeOperation, RuntimeOperationKind, RuntimeOperationOptions, RuntimeOutcome, RuntimeRequestOptions, RuntimeSink, RuntimeSinkContext, SafeCapture, TrackedLlmCall, addBreadcrumb, autterErrorHandler, autterErrorResponse, autterFastify, autterFastifyErrors, autterKoa, autterRequests, captureRequestError, captureException as captureServerException, captureMessage as captureServerMessage, consoleSink, createRuntimeLogger, defineRuntimeErrors, emitLlmSelftestTrace, enrichDeployment, enrichEdgeGeo, enrichRequestSize, enrichUserAgent, errorAttributes, fileSink, flushRuntimeLogs, initAutterLogging, installAutterAutoFlush, instrumentLlmClient, isRuntimeErrorLike, makeSafeCapture, otlpSink, redactAttributes, redactText, reportOutcome as reportServerOutcome, runInBackground, runtimeContext, runtimeLogStats, runtimeLogger, toClientError, trackLlmCall, withLlmCall, withProcessSpan, withRuntimeOperation } from '@autter/runtime-node';
 
 /**
  * Server half of @autter/runtime-next. Safe to import anywhere Node runs:
@@ -25,7 +25,18 @@ export { AutoFlushHandle, AutoFlushOptions, AutterServer, AutterServerOptions, F
  *        apiKey: process.env.AUTTER_RUNTIME_KEY!,
  *      });
  *
- * Browser tracker + error boundary live in `@autter/runtime-next/client`.
+ * 3. Route handlers as request wide events (1.5.0):
+ *
+ *      import { withRuntimeRequest, runtimeContext } from "@autter/runtime-next";
+ *      export const POST = withRuntimeRequest(async (request) => {
+ *        runtimeContext.set({ cart: { items: 3 } });
+ *        return Response.json({ ok: true });
+ *      }, { name: "checkout" });
+ *
+ *    The log flush is handed to Next's `after()` automatically.
+ *
+ * Browser tracker + error boundary live in `@autter/runtime-next/client`;
+ * `middleware.ts` (edge runtime) uses `@autter/runtime-next/edge`.
  */
 
 /** Server OTel init for Next.js `instrumentation.ts`. */
@@ -34,5 +45,11 @@ declare function registerAutter(options: AutterServerOptions): AutterServer;
 declare function createAutterRelayRoute(options: RelayOptions): {
     POST: (request: Request) => Promise<Response>;
 };
+/**
+ * Next.js-aware `withRuntimeRequest`: identical to the runtime-node wrapper,
+ * but the log flush is handed to `after()` from `next/server` (Next 15+;
+ * `unstable_after` on 14.2) unless you pass your own `waitUntil`.
+ */
+declare function withRuntimeRequest<A extends unknown[]>(handler: (request: Request, ...rest: A) => Response | Promise<Response>, options?: RuntimeRequestOptions): (request: Request, ...rest: A) => Promise<Response>;
 
-export { createAutterRelayRoute, registerAutter };
+export { createAutterRelayRoute, registerAutter, withRuntimeRequest };

package/dist/server.d.ts

@@ -1,5 +1,5 @@
-import { RelayOptions, AutterServerOptions, AutterServer } from '@autter/runtime-node';
-export { AutoFlushHandle, AutoFlushOptions, AutterServer, AutterServerOptions, FlushTarget, InstrumentLlmOptions, LlmCallHandle, LlmCallInfo, LlmUsage, RedactOptions, RelayOptions, RuntimeLogContext, RuntimeLogContextValue, RuntimeLogLevel, RuntimeLoggingOptions, RuntimeOperation, RuntimeOutcome, SafeCapture, TrackedLlmCall, captureException as captureServerException, captureMessage as captureServerMessage, createRuntimeLogger, emitLlmSelftestTrace, flushRuntimeLogs, installAutterAutoFlush, instrumentLlmClient, makeSafeCapture, redactAttributes, reportOutcome as reportServerOutcome, runtimeLogStats, runtimeLogger, trackLlmCall, withLlmCall, withProcessSpan, withRuntimeOperation } from '@autter/runtime-node';
+import { RelayOptions, AutterServerOptions, AutterServer, RuntimeRequestOptions } from '@autter/runtime-node';
+export { AutoFlushHandle, AutoFlushOptions, AutterErrorHandlerOptions, AutterErrorResponseOptions, AutterLogging, AutterLoggingOptions, AutterRequestsOptions, AutterServer, AutterServerOptions, Breadcrumb, BreadcrumbInput, CODE_PATTERN, ClientErrorBody, ConsoleSinkOptions, FileSinkOptions, FlushTarget, InstrumentLlmOptions, LlmCallHandle, LlmCallInfo, LlmUsage, OtlpSinkOptions, RedactOptions, RelayOptions, RuntimeCarrier, RuntimeContextHandle, RuntimeEnrichContext, RuntimeEnrichEvent, RuntimeEnricher, RuntimeError, RuntimeErrorCatalog, RuntimeErrorDefinition, RuntimeErrorExtras, RuntimeErrorFactory, RuntimeErrorLike, RuntimeErrorOptions, RuntimeEvent, RuntimeLogContext, RuntimeLogContextValue, RuntimeLogLevel, RuntimeLoggingOptions, RuntimeOperation, RuntimeOperationKind, RuntimeOperationOptions, RuntimeOutcome, RuntimeRequestOptions, RuntimeSink, RuntimeSinkContext, SafeCapture, TrackedLlmCall, addBreadcrumb, autterErrorHandler, autterErrorResponse, autterFastify, autterFastifyErrors, autterKoa, autterRequests, captureRequestError, captureException as captureServerException, captureMessage as captureServerMessage, consoleSink, createRuntimeLogger, defineRuntimeErrors, emitLlmSelftestTrace, enrichDeployment, enrichEdgeGeo, enrichRequestSize, enrichUserAgent, errorAttributes, fileSink, flushRuntimeLogs, initAutterLogging, installAutterAutoFlush, instrumentLlmClient, isRuntimeErrorLike, makeSafeCapture, otlpSink, redactAttributes, redactText, reportOutcome as reportServerOutcome, runInBackground, runtimeContext, runtimeLogStats, runtimeLogger, toClientError, trackLlmCall, withLlmCall, withProcessSpan, withRuntimeOperation } from '@autter/runtime-node';
 
 /**
  * Server half of @autter/runtime-next. Safe to import anywhere Node runs:
@@ -25,7 +25,18 @@ export { AutoFlushHandle, AutoFlushOptions, AutterServer, AutterServerOptions, F
  *        apiKey: process.env.AUTTER_RUNTIME_KEY!,
  *      });
  *
- * Browser tracker + error boundary live in `@autter/runtime-next/client`.
+ * 3. Route handlers as request wide events (1.5.0):
+ *
+ *      import { withRuntimeRequest, runtimeContext } from "@autter/runtime-next";
+ *      export const POST = withRuntimeRequest(async (request) => {
+ *        runtimeContext.set({ cart: { items: 3 } });
+ *        return Response.json({ ok: true });
+ *      }, { name: "checkout" });
+ *
+ *    The log flush is handed to Next's `after()` automatically.
+ *
+ * Browser tracker + error boundary live in `@autter/runtime-next/client`;
+ * `middleware.ts` (edge runtime) uses `@autter/runtime-next/edge`.
  */
 
 /** Server OTel init for Next.js `instrumentation.ts`. */
@@ -34,5 +45,11 @@ declare function registerAutter(options: AutterServerOptions): AutterServer;
 declare function createAutterRelayRoute(options: RelayOptions): {
     POST: (request: Request) => Promise<Response>;
 };
+/**
+ * Next.js-aware `withRuntimeRequest`: identical to the runtime-node wrapper,
+ * but the log flush is handed to `after()` from `next/server` (Next 15+;
+ * `unstable_after` on 14.2) unless you pass your own `waitUntil`.
+ */
+declare function withRuntimeRequest<A extends unknown[]>(handler: (request: Request, ...rest: A) => Response | Promise<Response>, options?: RuntimeRequestOptions): (request: Request, ...rest: A) => Promise<Response>;
 
-export { createAutterRelayRoute, registerAutter };
+export { createAutterRelayRoute, registerAutter, withRuntimeRequest };

package/dist/server.js

@@ -1,40 +1,92 @@
 import {
+  CODE_PATTERN,
+  RuntimeError,
+  addBreadcrumb,
+  autterErrorHandler,
+  autterErrorResponse,
+  autterFastify,
+  autterFastifyErrors,
+  autterKoa,
+  autterRequests,
   captureException,
   captureMessage,
+  captureRequestError,
+  consoleSink,
   createAutterRelayRoute,
   createRuntimeLogger,
+  defineRuntimeErrors,
   emitLlmSelftestTrace,
+  enrichDeployment,
+  enrichEdgeGeo,
+  enrichRequestSize,
+  enrichUserAgent,
+  errorAttributes,
+  fileSink,
   flushRuntimeLogs,
+  initAutterLogging,
   installAutterAutoFlush,
   instrumentLlmClient,
+  isRuntimeErrorLike,
   makeSafeCapture,
+  otlpSink,
   redactAttributes,
+  redactText,
   registerAutter,
   reportOutcome,
+  runInBackground,
+  runtimeContext,
   runtimeLogStats,
   runtimeLogger,
+  toClientError,
   trackLlmCall,
   withLlmCall,
   withProcessSpan,
-  withRuntimeOperation
-} from "./chunk-NZPBSB6B.js";
+  withRuntimeOperation,
+  withRuntimeRequest
+} from "./chunk-QFEFRAVO.js";
 export {
+  CODE_PATTERN,
+  RuntimeError,
+  addBreadcrumb,
+  autterErrorHandler,
+  autterErrorResponse,
+  autterFastify,
+  autterFastifyErrors,
+  autterKoa,
+  autterRequests,
+  captureRequestError,
   captureException as captureServerException,
   captureMessage as captureServerMessage,
+  consoleSink,
   createAutterRelayRoute,
   createRuntimeLogger,
+  defineRuntimeErrors,
   emitLlmSelftestTrace,
+  enrichDeployment,
+  enrichEdgeGeo,
+  enrichRequestSize,
+  enrichUserAgent,
+  errorAttributes,
+  fileSink,
   flushRuntimeLogs,
+  initAutterLogging,
   installAutterAutoFlush,
   instrumentLlmClient,
+  isRuntimeErrorLike,
   makeSafeCapture,
+  otlpSink,
   redactAttributes,
+  redactText,
   registerAutter,
   reportOutcome as reportServerOutcome,
+  runInBackground,
+  runtimeContext,
   runtimeLogStats,
   runtimeLogger,
+  toClientError,
   trackLlmCall,
   withLlmCall,
   withProcessSpan,
-  withRuntimeOperation
+  withRuntimeOperation,
+  withRuntimeRequest
 };