@decocms/nextjs 8.4.0 → 8.5.0

package/README.md

@@ -2,7 +2,7 @@
 
 Deco CMS for any [Next.js](https://nextjs.org) App Router app. It makes no hosting assumptions: no CDN, ISR or platform behaviour is built in. It is a set of small helpers your site calls from its own proxy, layout, pages and `next.config`.
 
-Peers: `@decocms/blocks` (same version), `next` 16, `react` 19.
+Peers: `@decocms/blocks` (same version), `next` 16, `react` 19; optionally `@opentelemetry/api` (see [Request metric](#request-metric)).
 
 | Import | What it is for |
 | --- | --- |
@@ -10,6 +10,7 @@ Peers: `@decocms/blocks` (same version), `next` 16, `react` 19.
 | `@decocms/nextjs/server` | Draft previews in Server Components: `bindDraft`, `activeDraftPointer`, `contentClient`. |
 | `@decocms/nextjs` | `DraftPreviewIndicator` (the "Preview mode" badge on a draft page), `StudioBridge` (lets Studio's site editor drive the page) and `StudioPage` (tells it which page is on screen), plus the draft names and Studio's origins (below). |
 | `@decocms/nextjs/config` | `withDeco(nextConfig)`: the draft header rules and Studio's dev origins. CommonJS, so `next.config.js` can `require()` it. |
+| `@decocms/nextjs/instrumentation` | `register`, the `instrumentation.ts` hook that records `http.server.request.duration` from Next's own request span, and `serverRequestSpanProcessor()` for a site with its own OpenTelemetry SDK. |
 | `@decocms/nextjs/image-loader` | `createDecoImageLoader(imageUrl)`: a next/image loader over an `ImageUrl` from `@decocms/blocks/image`. |
 
 `createCMS` reads `NODE_ENV` to decide dev mode, so `next dev` never swaps the hosted release in over your local content; nothing needs passing. `createCMS({ dev })` still overrides it when a site needs to.
@@ -89,6 +90,27 @@ module.exports = withDeco({ images: { loader: "custom", loaderFile: "./src/image
 
 `withDeco` puts v7's two draft header rules before your own (a `?__draft=` query, or the draft cookie: no-store, `Vary: Cookie`, noindex) and adds Studio's origins to `allowedDevOrigins`. Each can be turned off: `withDeco(config, { draftHeaders: false, studioOrigins: false })`. Next sets `Cache-Control` and `Vary` itself on dynamic pages, so only `X-Robots-Tag` is sure to arrive from these rules; the proxy's `applyDraft` sets all three on the responses it makes.
 
+## Request metric
+
+```ts
+// src/instrumentation.ts (or instrumentation.ts at the root, next to app/)
+export { register } from "@decocms/nextjs/instrumentation";
+```
+
+Next.js already measures every request it serves: one root span per request (`BaseServer.handleRequest`) that ends with the status, the method and the route's template. `register` gives Next a tracer provider whose only job is that span: when it ends, the request goes to the CMS's telemetry as `http.server.request.duration` (through `recordServerRequest` from `@decocms/blocks/metrics`) (seconds, the same buckets as the upstream clients' `http.client.request.duration`), next to everything else `createCMS` sends. No span is exported anywhere, and every other span Next asks for is a shared non-recording one. With no telemetry destination (no `token` and no `endpoint`) nothing is recorded.
+
+| Label | Value |
+| --- | --- |
+| `http.route` | Next's route template: `/[[...path]]`, `/blog`, `/_draft/[[...path]]`. An RSC request counts under its page's route. `unmatched` when Next names none (an Edge route under `next start`) |
+| `http.request.method` | `GET`, `POST`, …; any other is `_OTHER` |
+| `status_class` | `2xx` … `5xx`; a request that threw is `5xx` |
+| `cache` | `DRAFT` for a draft render (the proxy forwarded `x-deco-draft`, or the request was rewritten onto `/_draft`), otherwise `BYPASS`: Next decides its own cache (`x-nextjs-cache`) on the response, which the span never sees |
+
+- `@opentelemetry/api` is an optional peer: `register` uses the same copy Next does (yours when installed, else Next's compiled one) and does nothing if neither loads.
+- **Your own OpenTelemetry setup** (`@vercel/otel`, `NodeSDK`): only one tracer provider can be registered, so `register` leaves yours alone and logs how to combine them. Add the processor to yours instead: `registerOTel({ serviceName, spanProcessors: ["auto", serverRequestSpanProcessor()] })`.
+- **The proxy**: under `next start` Next runs the proxy through a request span of its own; that one is not counted, and the request the proxy hands on is. A response the proxy makes itself (a redirect, a 404 for a direct `/_draft` hit) never reaches a page and is not counted.
+- **Edge runtime**: `register` does nothing there. Under `next start` an Edge route is still measured by the Node.js server that serves it (`unmatched`, no template); on a host that runs Edge functions on their own, nothing measures them.
+
 ## Images
 
 ```ts

package/dist/draft.d.ts

@@ -25,6 +25,8 @@ export declare const DRAFT_COOKIE = "__deco_draft";
  * client can't send one itself.
  */
 export declare const DRAFT_HEADER = "x-deco-draft";
+/** The URL prefix a drafted request is rewritten onto (`app/%5Fdraft/[[...path]]`). */
+export declare const DRAFT_ROUTE_PREFIX = "/_draft";
 /**
  * The response headers of a page rendered from a draft: never stored by a
  * browser or a CDN (`Cache-Control: no-store, private`, `Vary: Cookie`) and

package/dist/draft.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/F"}
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/F"}

package/dist/draft.js

@@ -25,6 +25,8 @@ export const DRAFT_COOKIE = "__deco_draft";
  * client can't send one itself.
  */
 export const DRAFT_HEADER = "x-deco-draft";
+/** The URL prefix a drafted request is rewritten onto (`app/%5Fdraft/[[...path]]`). */
+export const DRAFT_ROUTE_PREFIX = "/_draft";
 /**
  * The response headers of a page rendered from a draft: never stored by a
  * browser or a CDN (`Cache-Control: no-store, private`, `Vary: Cookie`) and

package/dist/draft.js.map

@@ -1 +1 @@
-{"version":3,"file":"draft.js","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAkC;IACrE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO;QACL,eAAe,EAAE,mBAAmB;QACpC,IAAI,EAAE,QAAQ;QACd,cAAc,EAAE,mBAAmB;KACpC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,uFAAuF;AACvF,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAkC;IACrE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO;QACL,eAAe,EAAE,mBAAmB;QACpC,IAAI,EAAE,QAAQ;QACd,cAAc,EAAE,mBAAmB;KACpC,CAAC;AACJ,CAAC"}

package/dist/instrumentation/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `@decocms/nextjs/instrumentation`: `http.server.request.duration` for a
+ * Next.js site, from the request span Next.js already opens.
+ *
+ * Next.js measures every request it serves: `BaseServer.handleRequest` opens
+ * one root span per request and, when the response is done, sets its status,
+ * its method and, when Next routed it, the route's template (`/[slug]/p`,
+ * not the path). It creates spans only while a tracer provider is registered
+ * through `@opentelemetry/api` (the app's copy, or Next's compiled one when
+ * the app has none; both read the same global registration).
+ *
+ * `register()`, the site's `instrumentation.ts` hook, registers a provider
+ * whose only job is that span: when it ends, the request is recorded with
+ * `recordServerRequest` from `@decocms/blocks/metrics`, into the CMS's
+ * telemetry in the same process. No span is exported anywhere and every other
+ * span Next.js asks for is a shared non-recording one. With no
+ * `@opentelemetry/api` reachable, on the Edge runtime, or when another
+ * provider is already registered, it registers nothing and never throws.
+ *
+ * A site that registers its own OpenTelemetry SDK (`@vercel/otel`,
+ * `NodeSDK`) adds `serverRequestSpanProcessor()` to that SDK's span
+ * processors instead.
+ *
+ * Labels: `http.route` is Next's route template (`unmatched` when Next names
+ * none); RSC requests count under their page's route, as the requests they
+ * are. `cache` is `DRAFT` for a draft render (the proxy forwarded
+ * `x-deco-draft`, or the request was rewritten onto `/_draft`) and otherwise
+ * `BYPASS`: Next decides its cache (`x-nextjs-cache`) on the response, which
+ * the span never sees.
+ */
+type Attributes = Record<string, unknown>;
+/** What `serverRequestSpanProcessor()` reads from an ended span (an SDK's `ReadableSpan`). */
+interface EndedSpan {
+    readonly attributes: Attributes;
+    /** `[seconds, nanoseconds]`, as OpenTelemetry's `HrTime`. */
+    readonly duration: readonly [number, number];
+    readonly status?: {
+        readonly code: number;
+    };
+}
+/** An OpenTelemetry SDK `SpanProcessor` that records nothing but the request metric. */
+export interface ServerRequestSpanProcessor {
+    onStart(span: unknown, parentContext: unknown): void;
+    onEnd(span: EndedSpan): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * For a site with its own OpenTelemetry SDK: a span processor that records
+ * `http.server.request.duration` from Next's request span and leaves every
+ * span to the SDK's other processors and exporters.
+ *
+ * ```ts
+ * registerOTel({ serviceName: "my-store", spanProcessors: ["auto", serverRequestSpanProcessor()] });
+ * ```
+ */
+export declare function serverRequestSpanProcessor(): ServerRequestSpanProcessor;
+/**
+ * The site's `instrumentation.ts` hook:
+ *
+ * ```ts
+ * // instrumentation.ts
+ * export { register } from "@decocms/nextjs/instrumentation";
+ * ```
+ *
+ * Registers the request-metric tracer provider, once per process. Does
+ * nothing on the Edge runtime (the Node.js server's request span covers the
+ * Edge pages it serves), without `@opentelemetry/api` (the app's or Next's),
+ * without `AsyncLocalStorage`, or when another provider is registered (it
+ * then says to use `serverRequestSpanProcessor()`). Never throws.
+ */
+export declare function register(): Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/instrumentation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AA4BH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAQ1C,8FAA8F;AAC9F,UAAU,SAAS;IACjB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,wFAAwF;AACxF,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IACrD,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,IAAI,0BAA0B,CAiBvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAyB9C"}

package/dist/instrumentation/index.js

@@ -0,0 +1,294 @@
+/**
+ * `@decocms/nextjs/instrumentation`: `http.server.request.duration` for a
+ * Next.js site, from the request span Next.js already opens.
+ *
+ * Next.js measures every request it serves: `BaseServer.handleRequest` opens
+ * one root span per request and, when the response is done, sets its status,
+ * its method and, when Next routed it, the route's template (`/[slug]/p`,
+ * not the path). It creates spans only while a tracer provider is registered
+ * through `@opentelemetry/api` (the app's copy, or Next's compiled one when
+ * the app has none; both read the same global registration).
+ *
+ * `register()`, the site's `instrumentation.ts` hook, registers a provider
+ * whose only job is that span: when it ends, the request is recorded with
+ * `recordServerRequest` from `@decocms/blocks/metrics`, into the CMS's
+ * telemetry in the same process. No span is exported anywhere and every other
+ * span Next.js asks for is a shared non-recording one. With no
+ * `@opentelemetry/api` reachable, on the Edge runtime, or when another
+ * provider is already registered, it registers nothing and never throws.
+ *
+ * A site that registers its own OpenTelemetry SDK (`@vercel/otel`,
+ * `NodeSDK`) adds `serverRequestSpanProcessor()` to that SDK's span
+ * processors instead.
+ *
+ * Labels: `http.route` is Next's route template (`unmatched` when Next names
+ * none); RSC requests count under their page's route, as the requests they
+ * are. `cache` is `DRAFT` for a draft render (the proxy forwarded
+ * `x-deco-draft`, or the request was rewritten onto `/_draft`) and otherwise
+ * `BYPASS`: Next decides its cache (`x-nextjs-cache`) on the response, which
+ * the span never sees.
+ */
+import { recordServerRequest } from "@decocms/blocks/metrics";
+import { DRAFT_HEADER, DRAFT_ROUTE_PREFIX } from "../draft.js";
+/** The span type Next.js gives its one root span per request. */
+const ROOT_SPAN_TYPE = "BaseServer.handleRequest";
+const REGISTERED = Symbol.for("decocms.nextjs.instrumentation");
+/**
+ * Under `next start`, the router runs the proxy (`proxy.ts`/`middleware.ts`)
+ * through a `handleRequest` of its own, which ends by "bubbling" the proxy's
+ * result back to the router (`next.bubble`). That span is the proxy's, not a
+ * request: the request it hands on is measured by its own span.
+ */
+const BUBBLE = "next.bubble";
+/** OpenTelemetry's `SpanStatusCode.ERROR`. */
+const STATUS_ERROR = 2;
+/** Records one ended `BaseServer.handleRequest` span. Never throws. */
+function recordRequestSpan(attributes, seconds, errored, draft) {
+    const route = typeof attributes["http.route"] === "string" ? attributes["http.route"] : undefined;
+    const code = Number(attributes["http.status_code"]);
+    // Next sets the status before the span ends; a request that threw is a 5xx whatever it says.
+    const status = errored && !(code >= 500) ? 500 : code || 500;
+    // Never rejects; the span's route is already a string, so nothing to wait for.
+    void recordServerRequest({
+        route,
+        method: String(attributes["http.method"] ?? ""),
+        status,
+        cache: draft || isDraftRoute(route) ? "DRAFT" : "BYPASS",
+        seconds,
+    });
+}
+function isDraftRoute(route) {
+    if (route === undefined)
+        return false;
+    const path = route.replace(/^\/%5Fdraft(?=\/|$)/i, DRAFT_ROUTE_PREFIX);
+    return path === DRAFT_ROUTE_PREFIX || path.startsWith(`${DRAFT_ROUTE_PREFIX}/`);
+}
+/**
+ * For a site with its own OpenTelemetry SDK: a span processor that records
+ * `http.server.request.duration` from Next's request span and leaves every
+ * span to the SDK's other processors and exporters.
+ *
+ * ```ts
+ * registerOTel({ serviceName: "my-store", spanProcessors: ["auto", serverRequestSpanProcessor()] });
+ * ```
+ */
+export function serverRequestSpanProcessor() {
+    return {
+        onStart() { },
+        onEnd(span) {
+            try {
+                const attributes = span.attributes;
+                if (attributes?.["next.span_type"] !== ROOT_SPAN_TYPE || attributes[BUBBLE] === true)
+                    return;
+                const [s, ns] = span.duration;
+                recordRequestSpan(attributes, s + ns / 1e9, span.status?.code === STATUS_ERROR, false);
+            }
+            catch {
+                // A metric never breaks a request.
+            }
+        },
+        forceFlush: () => Promise.resolve(),
+        shutdown: () => Promise.resolve(),
+    };
+}
+/**
+ * The site's `instrumentation.ts` hook:
+ *
+ * ```ts
+ * // instrumentation.ts
+ * export { register } from "@decocms/nextjs/instrumentation";
+ * ```
+ *
+ * Registers the request-metric tracer provider, once per process. Does
+ * nothing on the Edge runtime (the Node.js server's request span covers the
+ * Edge pages it serves), without `@opentelemetry/api` (the app's or Next's),
+ * without `AsyncLocalStorage`, or when another provider is registered (it
+ * then says to use `serverRequestSpanProcessor()`). Never throws.
+ */
+export async function register() {
+    try {
+        const global = globalThis;
+        if (global[REGISTERED] === true || typeof global.EdgeRuntime === "string")
+            return;
+        const Storage = global.AsyncLocalStorage;
+        if (typeof Storage !== "function")
+            return;
+        const api = await loadApi();
+        if (api === undefined)
+            return;
+        global[REGISTERED] = true;
+        const draft = api.createContextKey("decocms.nextjs.draft");
+        if (!api.trace.setGlobalTracerProvider(requestTracerProvider(api, draft))) {
+            console.warn("[@decocms/nextjs] Another OpenTelemetry tracer provider is registered, so register() added nothing. " +
+                "To record http.server.request.duration, add serverRequestSpanProcessor() to that provider's span processors.");
+            return;
+        }
+        // Both may already be registered by something else; Next's spans work with either.
+        api.context.setGlobalContextManager(storageContextManager(api, new Storage()));
+        api.propagation.setGlobalPropagator(draftPropagator(draft));
+    }
+    catch {
+        // Instrumentation never stops a server from starting.
+    }
+}
+/**
+ * The `@opentelemetry/api` Next.js uses: the app's own when installed (Next's
+ * bundlers alias it to Next's compiled copy when it isn't), else Next's
+ * compiled copy.
+ */
+async function loadApi() {
+    try {
+        return await import("@opentelemetry/api");
+    }
+    catch {
+        try {
+            return (await import("next/dist/compiled/@opentelemetry/api/index.js"));
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+function requestTracerProvider(api, DRAFT) {
+    const IN_REQUEST = api.createContextKey("decocms.nextjs.inRequest");
+    const inert = api.trace.wrapSpanContext(api.INVALID_SPAN_CONTEXT);
+    const tracer = {
+        startSpan(_name, options, context) {
+            const ctx = context ?? api.context.active();
+            if (options?.attributes?.["next.span_type"] !== ROOT_SPAN_TYPE)
+                return inert;
+            // A request Next serves inside another (a nested handleRequest) is already measured.
+            if (ctx.getValue(IN_REQUEST) === true)
+                return inert;
+            return new RequestSpan(api.INVALID_SPAN_CONTEXT, options.attributes, ctx.getValue(DRAFT) === true);
+        },
+        startActiveSpan(name, ...rest) {
+            const fn = rest[rest.length - 1];
+            const options = (rest.length > 1 ? rest[0] : undefined);
+            const context = (rest.length > 2 ? rest[1] : undefined);
+            const span = tracer.startSpan(name, options, context);
+            // Only the request span changes the context; every other span costs a call.
+            if (span === inert)
+                return fn(span);
+            const ctx = api.trace
+                .setSpan(context ?? api.context.active(), span)
+                .setValue(IN_REQUEST, true);
+            return api.context.with(ctx, fn, undefined, span);
+        },
+    };
+    // Not named NoopTracerProvider: Next checks that name to decide whether tracing is on.
+    return { getTracer: () => tracer };
+}
+/** Marks the request's context when the proxy forwarded an accepted draft. */
+function draftPropagator(DRAFT) {
+    return {
+        inject() { },
+        extract(context, carrier, getter) {
+            try {
+                const value = getter.get(carrier, DRAFT_HEADER);
+                return value !== undefined && value !== "" ? context.setValue(DRAFT, true) : context;
+            }
+            catch {
+                return context;
+            }
+        },
+        fields: () => [],
+    };
+}
+/** The request span: keeps only the attributes the metric needs and records on `end()`. */
+class RequestSpan {
+    #context;
+    #attributes = {};
+    #start = performance.now();
+    #draft;
+    #errored = false;
+    #proxy = false;
+    #ended = false;
+    constructor(context, attributes, draft) {
+        this.#context = context;
+        this.#draft = draft;
+        if (attributes)
+            this.setAttributes(attributes);
+    }
+    spanContext() {
+        return this.#context;
+    }
+    setAttribute(key, value) {
+        if (key === "http.route" || key === "http.status_code" || key === "http.method") {
+            this.#attributes[key] = value;
+        }
+        else if (key === BUBBLE && value === true) {
+            this.#proxy = true;
+        }
+        return this;
+    }
+    setAttributes(attributes) {
+        for (const key in attributes)
+            this.setAttribute(key, attributes[key]);
+        return this;
+    }
+    setStatus(status) {
+        if (status?.code === STATUS_ERROR)
+            this.#errored = true;
+        return this;
+    }
+    addEvent() {
+        return this;
+    }
+    addLink() {
+        return this;
+    }
+    addLinks() {
+        return this;
+    }
+    updateName() {
+        return this;
+    }
+    recordException(exception) {
+        // The proxy's own invocation ends with an error marked `bubble`, whatever its type.
+        if (exception?.bubble === true)
+            this.#proxy = true;
+    }
+    isRecording() {
+        return !this.#ended;
+    }
+    end() {
+        if (this.#ended)
+            return;
+        this.#ended = true;
+        if (this.#proxy)
+            return;
+        try {
+            const seconds = (performance.now() - this.#start) / 1000;
+            recordRequestSpan(this.#attributes, seconds, this.#errored, this.#draft);
+        }
+        catch {
+            // A metric never breaks a request.
+        }
+    }
+}
+/** OpenTelemetry's context manager over `AsyncLocalStorage` (what `@opentelemetry/context-async-hooks` does). */
+function storageContextManager(api, storage) {
+    const manager = {
+        active: () => storage.getStore() ?? api.ROOT_CONTEXT,
+        with(context, fn, thisArg, ...args) {
+            const call = thisArg === undefined ? fn : fn.bind(thisArg);
+            return storage.run(context, call, ...args);
+        },
+        bind(context, target) {
+            if (typeof target !== "function")
+                return target;
+            const fn = target;
+            return function (...args) {
+                return manager.with(context, () => fn.apply(this, args));
+            };
+        },
+        enable: () => manager,
+        disable() {
+            storage.disable();
+            return manager;
+        },
+    };
+    return manager;
+}
+//# sourceMappingURL=index.js.map

package/dist/instrumentation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/instrumentation/index.ts"],"names":[],"mappings":"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"}

package/dist/proxy/index.d.ts

@@ -18,6 +18,10 @@
  * is rewritten onto a dynamic draft route (`/_draft/<path>`, mounted as
  * `app/%5Fdraft/...`: a literal `_draft` folder is private in Next and never
  * routes).
+ *
+ * The proxy measures no requests: it runs before Next routes and renders the
+ * page. `http.server.request.duration` comes from Next's own request span
+ * (`register` from `@decocms/nextjs/instrumentation`).
  */
 import type { CMS } from "@decocms/blocks";
 import { type NextRequest, NextResponse } from "next/server.js";
@@ -32,8 +36,7 @@ export interface DraftDecision {
     /** The `Set-Cookie` the response carries: storing a draft link's pointer, or ending a preview. */
     setCookie: string | null;
 }
-/** The URL prefix a drafted request is rewritten onto (`app/%5Fdraft/[[...path]]`). */
-export declare const DRAFT_ROUTE_PREFIX = "/_draft";
+export { DRAFT_ROUTE_PREFIX } from "../draft.ts";
 /**
  * The draft a request renders and the cookie its response sets, under
  * `policy` (the same options the pages pass to `bindDraft`). A request with

package/dist/proxy/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAML,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,mBAAmB,EACnB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC,CAAC;AAE9E,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kGAAkG;IAClG,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAI5C;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAKT;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,GACtB,YAAY,GAAG,IAAI,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,GAAG,CAAC,CAMtF;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,iBAAsB,GAC9B,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAUjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,KAAK,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAML,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,mBAAmB,EACnB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC,CAAC;AAE9E,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kGAAkG;IAClG,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,GAAG,OAAO,EAC9B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAKT;AAED,gGAAgG;AAChG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,aAAa,GACtB,YAAY,GAAG,IAAI,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,GAAG,CAAC,CAMtF;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,iBAAsB,GAC9B,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAUjD"}

package/dist/proxy/index.js

@@ -1,9 +1,8 @@
 import { NextResponse } from "next/server.js";
-import { DRAFT_HEADER, draftResponseHeaders } from "../draft.js";
+import { DRAFT_HEADER, DRAFT_ROUTE_PREFIX, draftResponseHeaders } from "../draft.js";
 import { allowedDraft, draftCookie, endsPreview, fromDraftLink, hasDraftSignal, requestLike, } from "../drafts.js";
 export { inferredPreviewHosts, previewHostDecision, requestLike, } from "../drafts.js";
-/** The URL prefix a drafted request is rewritten onto (`app/%5Fdraft/[[...path]]`). */
-export const DRAFT_ROUTE_PREFIX = "/_draft";
+export { DRAFT_ROUTE_PREFIX } from "../draft.js";
 const INERT = Object.freeze({ pointer: null, setCookie: null });
 /**
  * The draft a request renders and the cookie its response sets, under

package/dist/proxy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAoB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EAEd,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EAEpB,mBAAmB,EACnB,WAAW,GACZ,MAAM,cAAc,CAAC;AAatB,uFAAuF;AACvF,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAE5C,MAAM,KAAK,GAAkB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAc,EACd,OAA8B,EAC9B,MAAM,GAAkB,EAAE;IAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/E,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,gFAAgF;IAChF,IAAI,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;IAC3F,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO;QACL,OAAO;QACP,SAAS,EAAE,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;KAC1F,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA8B,EAC9B,QAAuB;IAEvB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,QAAQ,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;;QAC7D,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,KAAK,kBAAkB,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,kBAAkB,GAAG,CAAC,CAAC;AAC1F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAoB,EACpB,QAAuB;IAEvB,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACpC,IAAI,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,GAAG,CAAC,QAAQ,GAAG,GAAG,kBAAkB,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IACtD,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE;QAC/B,OAAO,EAAE,EAAE,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE;KAC7D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAqB,QAAW,EAAE,QAAuB;IACjF,IAAI,QAAQ,CAAC,SAAS;QAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClF,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACnF,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,GAAc,EACd,OAAO,GAAsB,EAAE;IAE/B,MAAM,EAAE,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IACpD,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnF,MAAM,QAAQ,GACZ,SAAS;YACT,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,OAAO,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/nextjs",
-  "version": "8.4.0",
+  "version": "8.5.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -38,6 +38,11 @@
       "types": "./src/config/index.d.cts",
       "default": "./src/config/index.cjs"
     },
+    "./instrumentation": {
+      "types": "./dist/instrumentation/index.d.ts",
+      "source": "./src/instrumentation/index.ts",
+      "default": "./dist/instrumentation/index.js"
+    },
     "./image-loader": {
       "types": "./dist/image-loader/index.d.ts",
       "source": "./src/image-loader/index.ts",
@@ -52,11 +57,18 @@
   },
   "peerDependencies": {
     "@decocms/blocks": "^8.4.0",
+    "@opentelemetry/api": "^1.0.0",
     "next": "^16.0.0",
     "react": "^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@decocms/blocks": "8.4.0",
+    "@decocms/blocks": "8.5.0",
+    "@opentelemetry/api": "^1.9.1",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "next": "16.3.8",

package/src/draft.ts

@@ -29,6 +29,9 @@ export const DRAFT_COOKIE = "__deco_draft";
  */
 export const DRAFT_HEADER = "x-deco-draft";
 
+/** The URL prefix a drafted request is rewritten onto (`app/%5Fdraft/[[...path]]`). */
+export const DRAFT_ROUTE_PREFIX = "/_draft";
+
 /**
  * The response headers of a page rendered from a draft: never stored by a
  * browser or a CDN (`Cache-Control: no-store, private`, `Vary: Cookie`) and

package/src/instrumentation/index.ts

@@ -0,0 +1,337 @@
+/**
+ * `@decocms/nextjs/instrumentation`: `http.server.request.duration` for a
+ * Next.js site, from the request span Next.js already opens.
+ *
+ * Next.js measures every request it serves: `BaseServer.handleRequest` opens
+ * one root span per request and, when the response is done, sets its status,
+ * its method and, when Next routed it, the route's template (`/[slug]/p`,
+ * not the path). It creates spans only while a tracer provider is registered
+ * through `@opentelemetry/api` (the app's copy, or Next's compiled one when
+ * the app has none; both read the same global registration).
+ *
+ * `register()`, the site's `instrumentation.ts` hook, registers a provider
+ * whose only job is that span: when it ends, the request is recorded with
+ * `recordServerRequest` from `@decocms/blocks/metrics`, into the CMS's
+ * telemetry in the same process. No span is exported anywhere and every other
+ * span Next.js asks for is a shared non-recording one. With no
+ * `@opentelemetry/api` reachable, on the Edge runtime, or when another
+ * provider is already registered, it registers nothing and never throws.
+ *
+ * A site that registers its own OpenTelemetry SDK (`@vercel/otel`,
+ * `NodeSDK`) adds `serverRequestSpanProcessor()` to that SDK's span
+ * processors instead.
+ *
+ * Labels: `http.route` is Next's route template (`unmatched` when Next names
+ * none); RSC requests count under their page's route, as the requests they
+ * are. `cache` is `DRAFT` for a draft render (the proxy forwarded
+ * `x-deco-draft`, or the request was rewritten onto `/_draft`) and otherwise
+ * `BYPASS`: Next decides its cache (`x-nextjs-cache`) on the response, which
+ * the span never sees.
+ */
+
+import { recordServerRequest } from "@decocms/blocks/metrics";
+import type {
+  Context,
+  ContextManager,
+  Span,
+  SpanContext,
+  SpanOptions,
+  TextMapPropagator,
+  Tracer,
+  TracerProvider,
+} from "@opentelemetry/api";
+import { DRAFT_HEADER, DRAFT_ROUTE_PREFIX } from "../draft.ts";
+
+type Api = typeof import("@opentelemetry/api");
+
+/** The span type Next.js gives its one root span per request. */
+const ROOT_SPAN_TYPE = "BaseServer.handleRequest";
+const REGISTERED = Symbol.for("decocms.nextjs.instrumentation");
+/**
+ * Under `next start`, the router runs the proxy (`proxy.ts`/`middleware.ts`)
+ * through a `handleRequest` of its own, which ends by "bubbling" the proxy's
+ * result back to the router (`next.bubble`). That span is the proxy's, not a
+ * request: the request it hands on is measured by its own span.
+ */
+const BUBBLE = "next.bubble";
+
+type Attributes = Record<string, unknown>;
+
+interface AsyncLocalStorageLike<T> {
+  getStore(): T | undefined;
+  run<R>(store: T, fn: (...args: unknown[]) => R, ...args: unknown[]): R;
+  disable(): void;
+}
+
+/** What `serverRequestSpanProcessor()` reads from an ended span (an SDK's `ReadableSpan`). */
+interface EndedSpan {
+  readonly attributes: Attributes;
+  /** `[seconds, nanoseconds]`, as OpenTelemetry's `HrTime`. */
+  readonly duration: readonly [number, number];
+  readonly status?: { readonly code: number };
+}
+
+/** An OpenTelemetry SDK `SpanProcessor` that records nothing but the request metric. */
+export interface ServerRequestSpanProcessor {
+  onStart(span: unknown, parentContext: unknown): void;
+  onEnd(span: EndedSpan): void;
+  forceFlush(): Promise<void>;
+  shutdown(): Promise<void>;
+}
+
+/** OpenTelemetry's `SpanStatusCode.ERROR`. */
+const STATUS_ERROR = 2;
+
+/** Records one ended `BaseServer.handleRequest` span. Never throws. */
+function recordRequestSpan(
+  attributes: Attributes,
+  seconds: number,
+  errored: boolean,
+  draft: boolean,
+): void {
+  const route = typeof attributes["http.route"] === "string" ? attributes["http.route"] : undefined;
+  const code = Number(attributes["http.status_code"]);
+  // Next sets the status before the span ends; a request that threw is a 5xx whatever it says.
+  const status = errored && !(code >= 500) ? 500 : code || 500;
+  // Never rejects; the span's route is already a string, so nothing to wait for.
+  void recordServerRequest({
+    route,
+    method: String(attributes["http.method"] ?? ""),
+    status,
+    cache: draft || isDraftRoute(route) ? "DRAFT" : "BYPASS",
+    seconds,
+  });
+}
+
+function isDraftRoute(route: string | undefined): boolean {
+  if (route === undefined) return false;
+  const path = route.replace(/^\/%5Fdraft(?=\/|$)/i, DRAFT_ROUTE_PREFIX);
+  return path === DRAFT_ROUTE_PREFIX || path.startsWith(`${DRAFT_ROUTE_PREFIX}/`);
+}
+
+/**
+ * For a site with its own OpenTelemetry SDK: a span processor that records
+ * `http.server.request.duration` from Next's request span and leaves every
+ * span to the SDK's other processors and exporters.
+ *
+ * ```ts
+ * registerOTel({ serviceName: "my-store", spanProcessors: ["auto", serverRequestSpanProcessor()] });
+ * ```
+ */
+export function serverRequestSpanProcessor(): ServerRequestSpanProcessor {
+  return {
+    onStart() {},
+    onEnd(span) {
+      try {
+        const attributes = span.attributes;
+        if (attributes?.["next.span_type"] !== ROOT_SPAN_TYPE || attributes[BUBBLE] === true)
+          return;
+        const [s, ns] = span.duration;
+        recordRequestSpan(attributes, s + ns / 1e9, span.status?.code === STATUS_ERROR, false);
+      } catch {
+        // A metric never breaks a request.
+      }
+    },
+    forceFlush: () => Promise.resolve(),
+    shutdown: () => Promise.resolve(),
+  };
+}
+
+/**
+ * The site's `instrumentation.ts` hook:
+ *
+ * ```ts
+ * // instrumentation.ts
+ * export { register } from "@decocms/nextjs/instrumentation";
+ * ```
+ *
+ * Registers the request-metric tracer provider, once per process. Does
+ * nothing on the Edge runtime (the Node.js server's request span covers the
+ * Edge pages it serves), without `@opentelemetry/api` (the app's or Next's),
+ * without `AsyncLocalStorage`, or when another provider is registered (it
+ * then says to use `serverRequestSpanProcessor()`). Never throws.
+ */
+export async function register(): Promise<void> {
+  try {
+    const global = globalThis as Record<PropertyKey, unknown>;
+    if (global[REGISTERED] === true || typeof global.EdgeRuntime === "string") return;
+    const Storage = global.AsyncLocalStorage as
+      | (new () => AsyncLocalStorageLike<Context>)
+      | undefined;
+    if (typeof Storage !== "function") return;
+    const api = await loadApi();
+    if (api === undefined) return;
+    global[REGISTERED] = true;
+    const draft = api.createContextKey("decocms.nextjs.draft");
+    if (!api.trace.setGlobalTracerProvider(requestTracerProvider(api, draft))) {
+      console.warn(
+        "[@decocms/nextjs] Another OpenTelemetry tracer provider is registered, so register() added nothing. " +
+          "To record http.server.request.duration, add serverRequestSpanProcessor() to that provider's span processors.",
+      );
+      return;
+    }
+    // Both may already be registered by something else; Next's spans work with either.
+    api.context.setGlobalContextManager(storageContextManager(api, new Storage()));
+    api.propagation.setGlobalPropagator(draftPropagator(draft));
+  } catch {
+    // Instrumentation never stops a server from starting.
+  }
+}
+
+/**
+ * The `@opentelemetry/api` Next.js uses: the app's own when installed (Next's
+ * bundlers alias it to Next's compiled copy when it isn't), else Next's
+ * compiled copy.
+ */
+async function loadApi(): Promise<Api | undefined> {
+  try {
+    return await import("@opentelemetry/api");
+  } catch {
+    try {
+      return (await import("next/dist/compiled/@opentelemetry/api/index.js")) as Api;
+    } catch {
+      return undefined;
+    }
+  }
+}
+
+function requestTracerProvider(api: Api, DRAFT: symbol): TracerProvider {
+  const IN_REQUEST = api.createContextKey("decocms.nextjs.inRequest");
+  const inert = api.trace.wrapSpanContext(api.INVALID_SPAN_CONTEXT);
+
+  const tracer: Tracer = {
+    startSpan(_name: string, options?: SpanOptions, context?: Context): Span {
+      const ctx = context ?? api.context.active();
+      if (options?.attributes?.["next.span_type"] !== ROOT_SPAN_TYPE) return inert;
+      // A request Next serves inside another (a nested handleRequest) is already measured.
+      if (ctx.getValue(IN_REQUEST) === true) return inert;
+      return new RequestSpan(
+        api.INVALID_SPAN_CONTEXT,
+        options.attributes,
+        ctx.getValue(DRAFT) === true,
+      );
+    },
+    startActiveSpan(name: string, ...rest: unknown[]) {
+      const fn = rest[rest.length - 1] as (span: Span) => unknown;
+      const options = (rest.length > 1 ? rest[0] : undefined) as SpanOptions | undefined;
+      const context = (rest.length > 2 ? rest[1] : undefined) as Context | undefined;
+      const span = tracer.startSpan(name, options, context);
+      // Only the request span changes the context; every other span costs a call.
+      if (span === inert) return fn(span);
+      const ctx = api.trace
+        .setSpan(context ?? api.context.active(), span)
+        .setValue(IN_REQUEST, true);
+      return api.context.with(ctx, fn, undefined, span);
+    },
+  } as Tracer;
+
+  // Not named NoopTracerProvider: Next checks that name to decide whether tracing is on.
+  return { getTracer: () => tracer };
+}
+
+/** Marks the request's context when the proxy forwarded an accepted draft. */
+function draftPropagator(DRAFT: symbol): TextMapPropagator {
+  return {
+    inject() {},
+    extract(context, carrier, getter) {
+      try {
+        const value = getter.get(carrier, DRAFT_HEADER);
+        return value !== undefined && value !== "" ? context.setValue(DRAFT, true) : context;
+      } catch {
+        return context;
+      }
+    },
+    fields: () => [],
+  };
+}
+
+/** The request span: keeps only the attributes the metric needs and records on `end()`. */
+class RequestSpan implements Span {
+  readonly #context: SpanContext;
+  readonly #attributes: Attributes = {};
+  readonly #start = performance.now();
+  readonly #draft: boolean;
+  #errored = false;
+  #proxy = false;
+  #ended = false;
+
+  constructor(context: SpanContext, attributes: Attributes | undefined, draft: boolean) {
+    this.#context = context;
+    this.#draft = draft;
+    if (attributes) this.setAttributes(attributes);
+  }
+
+  spanContext(): SpanContext {
+    return this.#context;
+  }
+  setAttribute(key: string, value: unknown): this {
+    if (key === "http.route" || key === "http.status_code" || key === "http.method") {
+      this.#attributes[key] = value;
+    } else if (key === BUBBLE && value === true) {
+      this.#proxy = true;
+    }
+    return this;
+  }
+  setAttributes(attributes: Attributes): this {
+    for (const key in attributes) this.setAttribute(key, attributes[key]);
+    return this;
+  }
+  setStatus(status: { code: number }): this {
+    if (status?.code === STATUS_ERROR) this.#errored = true;
+    return this;
+  }
+  addEvent(): this {
+    return this;
+  }
+  addLink(): this {
+    return this;
+  }
+  addLinks(): this {
+    return this;
+  }
+  updateName(): this {
+    return this;
+  }
+  recordException(exception: unknown): void {
+    // The proxy's own invocation ends with an error marked `bubble`, whatever its type.
+    if ((exception as { bubble?: unknown } | null)?.bubble === true) this.#proxy = true;
+  }
+  isRecording(): boolean {
+    return !this.#ended;
+  }
+  end(): void {
+    if (this.#ended) return;
+    this.#ended = true;
+    if (this.#proxy) return;
+    try {
+      const seconds = (performance.now() - this.#start) / 1000;
+      recordRequestSpan(this.#attributes, seconds, this.#errored, this.#draft);
+    } catch {
+      // A metric never breaks a request.
+    }
+  }
+}
+
+/** OpenTelemetry's context manager over `AsyncLocalStorage` (what `@opentelemetry/context-async-hooks` does). */
+function storageContextManager(api: Api, storage: AsyncLocalStorageLike<Context>): ContextManager {
+  const manager: ContextManager = {
+    active: () => storage.getStore() ?? api.ROOT_CONTEXT,
+    with(context, fn, thisArg, ...args) {
+      const call = thisArg === undefined ? fn : fn.bind(thisArg);
+      return storage.run(context, call as (...a: unknown[]) => ReturnType<typeof fn>, ...args);
+    },
+    bind<T>(context: Context, target: T): T {
+      if (typeof target !== "function") return target;
+      const fn = target as unknown as (...a: unknown[]) => unknown;
+      return function (this: unknown, ...args: unknown[]) {
+        return manager.with(context, () => fn.apply(this, args));
+      } as unknown as T;
+    },
+    enable: () => manager,
+    disable() {
+      storage.disable();
+      return manager;
+    },
+  };
+  return manager;
+}

package/src/proxy/index.ts

@@ -18,10 +18,14 @@
  * is rewritten onto a dynamic draft route (`/_draft/<path>`, mounted as
  * `app/%5Fdraft/...`: a literal `_draft` folder is private in Next and never
  * routes).
+ *
+ * The proxy measures no requests: it runs before Next routes and renders the
+ * page. `http.server.request.duration` comes from Next's own request span
+ * (`register` from `@decocms/nextjs/instrumentation`).
  */
 import type { CMS } from "@decocms/blocks";
 import { type NextRequest, NextResponse } from "next/server.js";
-import { DRAFT_HEADER, draftResponseHeaders } from "../draft.ts";
+import { DRAFT_HEADER, DRAFT_ROUTE_PREFIX, draftResponseHeaders } from "../draft.ts";
 import {
   allowedDraft,
   draftCookie,
@@ -50,8 +54,7 @@ export interface DraftDecision {
   setCookie: string | null;
 }
 
-/** The URL prefix a drafted request is rewritten onto (`app/%5Fdraft/[[...path]]`). */
-export const DRAFT_ROUTE_PREFIX = "/_draft";
+export { DRAFT_ROUTE_PREFIX } from "../draft.ts";
 
 const INERT: DraftDecision = Object.freeze({ pointer: null, setCookie: null });