@autter/runtime-next 1.6.0 → 1.7.0

package/README.md

@@ -9,8 +9,8 @@ same-origin relay route, and a React error boundary.
 npm install @autter/runtime-next
 ```
 
-Set `AUTTER_RUNTIME_KEY` in your environment. Then one line of
-`next.config` and three small files.
+Set `AUTTER_RUNTIME_KEY` in your environment. Then three small files, and
+(recommended) one line of `next.config`.
 
 The package has two entry points — this split is what keeps the Node
 OpenTelemetry SDK out of your browser bundle:
@@ -22,8 +22,8 @@ OpenTelemetry SDK out of your browser bundle:
 - `@autter/runtime-next/instrumentation` — `onRequestError` for
   `instrumentation.ts`; safe on both the Node and edge runtimes.
 
-**`next.config`** — one copy of the Node SDK for `instrumentation.ts` and
-your routes:
+**`next.config`** (recommended) — load the Node SDK from `node_modules`
+instead of bundling it:
 
 ```js
 // next.config.mjs
@@ -33,12 +33,16 @@ export default {
 ```
 
 Next bundles server dependencies separately into `instrumentation.ts` and
-into each route. Without this line, code in routes, server components and
-server actions (`withRuntimeRequest`, `captureServerException`,
-`runtimeLogger`, `runtimeContext`, …) reaches a copy of the SDK that
-`registerAutter` never started: request summaries are printed to the
-console instead of being exported, and an error `withRuntimeRequest`
-reports is reported a second time by `onRequestError`. Next 14.2:
+into the route bundles. Since 1.6.1 every copy shares the SDK
+`registerAutter` started, so routes, server components and server actions
+(`withRuntimeRequest`, `captureServerException`, `runtimeLogger`,
+`runtimeContext`, …) export through it, and an error `withRuntimeRequest`
+reported is not reported again by `onRequestError`, with or without this
+line. The line keeps the SDK and its OpenTelemetry
+dependencies out of the route bundles: in our Next 15.5 and 16.4 test app
+the server output had 1.1 to 2.3 MB less JavaScript. (1.6.0 needed it:
+without it, request summaries went to the console and errors were reported
+twice.) Next 14.2:
 `experimental: { serverComponentsExternalPackages: ["@autter/runtime-node"] }`.
 
 **1. `instrumentation.ts`** — server tracing/errors:
@@ -75,6 +79,14 @@ only inside a `process.env.NEXT_RUNTIME` branch Next removes from edge
 bundles. Without edge errors to report, `export { onRequestError } from
 "@autter/runtime-next/instrumentation"` is enough.
 
+Request counts and latency per route come from the `http.server.duration`
+metric of every request, under Next's route template (`/blog/[slug]`,
+`/api/items/[id]`, `/_not-found` for 404s), since 1.7.0: the SDK reads the
+`next.route` Next puts on its own spans while it serves the request. 1.7.0
+also instruments Next's server from the first request; before, it was
+instrumented only once a later request happened to load `http` again (in
+our test app, the first edge-route request), and its metrics had no route.
+
 On Node the error is recorded on the request span through the
 `registerAutter` tracker — once, even when `withRuntimeRequest` already
 reported it (Next's context is then added to that report). Recorded with
@@ -141,6 +153,24 @@ export function Providers({ children }: { children: React.ReactNode }) {
 React render errors don't reach `window.onerror` — the boundary reports
 them via `captureException` and then renders your fallback.
 
+**Linking browser errors to server traces** (opt-in): call
+`enableTracePropagation` from `@autter/runtime-next/client`, next to
+`initAutterBrowser` and before the app sends requests. Same-origin `fetch`
+and XHR requests (your route handlers and server actions) then carry a W3C
+`traceparent`, which `registerAutter` continues, so a browser error links to
+the server trace of the request behind it. Cross-origin APIs get one only
+when listed in `tracePropagationTargets`, and must allow the header in CORS.
+`disableTracePropagation()` turns it off; the rules are in
+`@autter/runtime-browser`'s README ("Trace propagation").
+
+```tsx
+"use client";
+import { initAutterBrowser, enableTracePropagation } from "@autter/runtime-next/client";
+
+initAutterBrowser({ endpoint: "/api/autter-runtime", service: "web-app" });
+enableTracePropagation({ tracePropagationTargets: ["https://api.example.com/"] });
+```
+
 Also re-exported for convenience: `captureException`, `captureMessage`,
 `trackEvent`, `setUser`, `setContext`, `flush` (from
 `@autter/runtime-next/client`) and `captureServerException`,

package/dist/{chunk-QFEFRAVO.js → chunk-3YYZYC6L.js}

@@ -8,7 +8,7 @@ import {
 // package.json
 var package_default = {
   name: "@autter/runtime-next",
-  version: "1.6.0",
+  version: "1.7.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",
@@ -65,7 +65,7 @@ var package_default = {
   dependencies: {
     "@autter/runtime-browser": "^1.6.0",
     "@autter/runtime-edge": "^1.1.0",
-    "@autter/runtime-node": "^1.6.0"
+    "@autter/runtime-node": "^1.7.0"
   },
   peerDependencies: {
     react: ">=18"

package/dist/client.cjs

@@ -40,7 +40,9 @@ __export(client_exports, {
   captureMessage: () => import_runtime_browser2.captureMessage,
   captureOutcome: () => import_runtime_browser2.captureOutcome,
   clearBreadcrumbs: () => import_breadcrumbs.clearBreadcrumbs,
+  disableTracePropagation: () => import_tracing.disableTracePropagation,
   enableBreadcrumbs: () => import_breadcrumbs.enableBreadcrumbs,
+  enableTracePropagation: () => import_tracing.enableTracePropagation,
   flush: () => import_runtime_browser2.flush,
   initAutterBrowser: () => import_runtime_browser2.initAutterBrowser,
   setContext: () => import_runtime_browser2.setContext,
@@ -50,6 +52,7 @@ __export(client_exports, {
 module.exports = __toCommonJS(client_exports);
 var import_runtime_browser2 = require("@autter/runtime-browser");
 var import_breadcrumbs = require("@autter/runtime-browser/breadcrumbs");
+var import_tracing = require("@autter/runtime-browser/tracing");
 
 // src/error-boundary.ts
 var React = __toESM(require("react"), 1);
@@ -87,7 +90,9 @@ var AutterErrorBoundary = class extends React.Component {
   captureMessage,
   captureOutcome,
   clearBreadcrumbs,
+  disableTracePropagation,
   enableBreadcrumbs,
+  enableTracePropagation,
   flush,
   initAutterBrowser,
   setContext,

package/dist/client.d.cts

@@ -1,5 +1,6 @@
 export { AutterSeverity, autterErrorFromResponse, captureException, captureMessage, captureOutcome, flush, initAutterBrowser, setContext, setUser, trackEvent } from '@autter/runtime-browser';
 export { Breadcrumb, BreadcrumbInput, BreadcrumbOptions, addBreadcrumb, clearBreadcrumbs, enableBreadcrumbs } from '@autter/runtime-browser/breadcrumbs';
+export { TracePropagationOptions, disableTracePropagation, enableTracePropagation } from '@autter/runtime-browser/tracing';
 import * as React from 'react';
 
 /**

package/dist/client.d.ts

@@ -1,5 +1,6 @@
 export { AutterSeverity, autterErrorFromResponse, captureException, captureMessage, captureOutcome, flush, initAutterBrowser, setContext, setUser, trackEvent } from '@autter/runtime-browser';
 export { Breadcrumb, BreadcrumbInput, BreadcrumbOptions, addBreadcrumb, clearBreadcrumbs, enableBreadcrumbs } from '@autter/runtime-browser/breadcrumbs';
+export { TracePropagationOptions, disableTracePropagation, enableTracePropagation } from '@autter/runtime-browser/tracing';
 import * as React from 'react';
 
 /**

package/dist/client.js

@@ -20,6 +20,10 @@ import {
   addBreadcrumb,
   clearBreadcrumbs
 } from "@autter/runtime-browser/breadcrumbs";
+import {
+  enableTracePropagation,
+  disableTracePropagation
+} from "@autter/runtime-browser/tracing";
 
 // src/error-boundary.ts
 import * as React from "react";
@@ -56,7 +60,9 @@ export {
   captureMessage,
   captureOutcome,
   clearBreadcrumbs,
+  disableTracePropagation,
   enableBreadcrumbs,
+  enableTracePropagation,
   flush,
   initAutterBrowser,
   setContext,

package/dist/index.cjs

@@ -73,7 +73,7 @@ var import_runtime_node = require("@autter/runtime-node");
 // package.json
 var package_default = {
   name: "@autter/runtime-next",
-  version: "1.6.0",
+  version: "1.7.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",
@@ -130,7 +130,7 @@ var package_default = {
   dependencies: {
     "@autter/runtime-browser": "^1.6.0",
     "@autter/runtime-edge": "^1.1.0",
-    "@autter/runtime-node": "^1.6.0"
+    "@autter/runtime-node": "^1.7.0"
   },
   peerDependencies: {
     react: ">=18"

package/dist/index.js

@@ -43,7 +43,7 @@ import {
   withProcessSpan,
   withRuntimeOperation,
   withRuntimeRequest
-} from "./chunk-QFEFRAVO.js";
+} from "./chunk-3YYZYC6L.js";
 export {
   CODE_PATTERN,
   RuntimeError,

package/dist/server.cjs

@@ -71,7 +71,7 @@ var import_runtime_node = require("@autter/runtime-node");
 // package.json
 var package_default = {
   name: "@autter/runtime-next",
-  version: "1.6.0",
+  version: "1.7.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",
@@ -128,7 +128,7 @@ var package_default = {
   dependencies: {
     "@autter/runtime-browser": "^1.6.0",
     "@autter/runtime-edge": "^1.1.0",
-    "@autter/runtime-node": "^1.6.0"
+    "@autter/runtime-node": "^1.7.0"
   },
   peerDependencies: {
     react: ">=18"

package/dist/server.js

@@ -43,7 +43,7 @@ import {
   withProcessSpan,
   withRuntimeOperation,
   withRuntimeRequest
-} from "./chunk-QFEFRAVO.js";
+} from "./chunk-3YYZYC6L.js";
 export {
   CODE_PATTERN,
   RuntimeError,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@autter/runtime-next",
-	"version": "1.6.0",
+	"version": "1.7.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",
@@ -57,7 +57,7 @@
 	"dependencies": {
 		"@autter/runtime-browser": "^1.6.0",
 		"@autter/runtime-edge": "^1.1.0",
-		"@autter/runtime-node": "^1.6.0"
+		"@autter/runtime-node": "^1.7.0"
 	},
 	"peerDependencies": {
 		"react": ">=18"