@stacknext/next 0.0.0-stage → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackNext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# @stacknext/next
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Next.js App Router instrumentation and OpenTelemetry exporter for
+[StackNext](https://github.com/marrrkkk/stacknext).
+
+```bash
+npm install --save-dev @stacknext/cli @stacknext/next
+npx stacknext init
+npx stacknext dev
+```
+
+`stacknext init` creates `instrumentation.ts` (or `instrumentation.js` for a
+JavaScript project) only when none exists. Existing instrumentation is never
+overwritten; call `registerStackNext()` from your own
+`register()` hook instead. StackNext yields to an already-registered
+OpenTelemetry provider rather than replacing it.
+
+Optional helpers keep application work in the same trace:
+
+```ts
+import {
+  withStackNextSpan,
+  withStackNextSpanSync,
+  withStackNextAction,
+} from '@stacknext/next'
+
+const project = await withStackNextSpan('project.load', () => loadProject(id))
+const digest = withStackNextSpanSync('auth.hash', () => hash(input))
+const result = await withStackNextAction('action/save-project', () => save(form))
+```
+
+Helpers are no-ops without an active OpenTelemetry provider. The package is
+ESM-only, supports Next.js 15 and 16 on the Node.js runtime, and requires
+Node.js 20.9 or newer.
+
+License: MIT.

package/dist/edge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Edge-safe entry point. Next.js compiles `instrumentation.ts` for the Edge
+ * runtime even when the project has no edge routes. The generated hook returns
+ * before importing StackNext when `NEXT_RUNTIME !== 'nodejs'`, but the bundler
+ * still resolves the dynamic import. This module keeps that resolution free of
+ * Node built-ins and OpenTelemetry Node SDK code.
+ *
+ * Instrumentation and the collector transport are intentionally inert here.
+ */
+import type { StackNextErrorInput } from '@stacknext/core';
+import type { StackNextTransport } from '@stacknext/core/transport';
+import type { NextRequestErrorContext, NextRequestInfo } from './error.js';
+import type { StackNextRegisterOptions, StackNextRegistration } from './register.js';
+export { StackNextSpanExporter, readableSpanToInput, spanAttributes, type StackNextSpanExporterOptions, } from './exporter.js';
+export { withStackNextAction, withStackNextSpan, withStackNextSpanSync, type StackNextManualSpanOptions, } from './manual.js';
+export type { NextRequestErrorContext, NextRequestInfo, } from './error.js';
+export type { StackNextRegisterOptions, StackNextRegistration, } from './register.js';
+export declare function registerStackNext(options?: StackNextRegisterOptions): Promise<StackNextRegistration | null>;
+export declare const register: typeof registerStackNext;
+export declare function getStackNextRegistration(): StackNextRegistration | undefined;
+export declare function shutdownStackNext(): Promise<void>;
+export declare function onRequestError(error: unknown, request: NextRequestInfo, context: NextRequestErrorContext): void;
+type ErrorSink = Pick<StackNextTransport, 'enqueueError'>;
+export declare function createRequestErrorHandler(transport: ErrorSink): (error: unknown, request: NextRequestInfo, context: NextRequestErrorContext) => void;
+export declare function requestErrorToInput(error: unknown, request: NextRequestInfo, context: NextRequestErrorContext): StackNextErrorInput;
+//# sourceMappingURL=edge.d.ts.map

package/dist/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EAChB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,KAAK,4BAA4B,GAClC,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,uBAAuB,EACvB,eAAe,GAChB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AAEtB,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAGvC;AAED,eAAO,MAAM,QAAQ,0BAAoB,CAAA;AAEzC,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,SAAS,CAE5E;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAIN;AAED,KAAK,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAA;AAEzD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,GACnB,CACD,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,KAC7B,IAAI,CAGR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,CAKrB"}

package/dist/edge.js

@@ -0,0 +1,29 @@
+export { StackNextSpanExporter, readableSpanToInput, spanAttributes, } from './exporter.js';
+export { withStackNextAction, withStackNextSpan, withStackNextSpanSync, } from './manual.js';
+export async function registerStackNext(options = {}) {
+    void options;
+    return null;
+}
+export const register = registerStackNext;
+export function getStackNextRegistration() {
+    return undefined;
+}
+export async function shutdownStackNext() {
+    // Nothing was registered on the Edge runtime.
+}
+export function onRequestError(error, request, context) {
+    void error;
+    void request;
+    void context;
+}
+export function createRequestErrorHandler(transport) {
+    void transport;
+    return () => undefined;
+}
+export function requestErrorToInput(error, request, context) {
+    void error;
+    void request;
+    void context;
+    throw new Error('StackNext request errors are only captured on the Node.js runtime');
+}
+//# sourceMappingURL=edge.js.map

package/dist/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GAEf,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GAEtB,MAAM,aAAa,CAAA;AAUpB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAoC,EAAE;IAEtC,KAAK,OAAO,CAAA;IACZ,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAA;AAEzC,MAAM,UAAU,wBAAwB;IACtC,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,8CAA8C;AAChD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,OAAwB,EACxB,OAAgC;IAEhC,KAAK,KAAK,CAAA;IACV,KAAK,OAAO,CAAA;IACZ,KAAK,OAAO,CAAA;AACd,CAAC;AAID,MAAM,UAAU,yBAAyB,CACvC,SAAoB;IAMpB,KAAK,SAAS,CAAA;IACd,OAAO,GAAG,EAAE,CAAC,SAAS,CAAA;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,OAAwB,EACxB,OAAgC;IAEhC,KAAK,KAAK,CAAA;IACV,KAAK,OAAO,CAAA;IACZ,KAAK,OAAO,CAAA;IACZ,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;AACtF,CAAC"}

package/dist/error.d.ts

@@ -0,0 +1,36 @@
+import { type StackNextErrorInput } from '@stacknext/core';
+import { type StackNextTransport } from '@stacknext/core/transport';
+/** Structural subset of Next.js `Instrumentation.RequestInfo`. */
+export interface NextRequestInfo {
+    path: string;
+    method: string;
+    headers?: Record<string, string | string[] | undefined>;
+}
+/** Structural subset of Next.js `Instrumentation.RequestErrorContext`. */
+export interface NextRequestErrorContext {
+    routerKind?: string;
+    routePath?: string;
+    routeType?: string;
+    renderSource?: string;
+    revalidateReason?: string;
+    [key: string]: unknown;
+}
+/**
+ * Converts a Next.js request error into the StackNext wire format.
+ * Header values are never read or stored.
+ */
+export declare function requestErrorToInput(error: unknown, request: NextRequestInfo, context: NextRequestErrorContext): StackNextErrorInput;
+type ErrorSink = Pick<StackNextTransport, 'enqueueError'>;
+/**
+ * Creates a Next.js `onRequestError` handler bound to a transport. Exposed for
+ * tests and for applications that want to supply their own transport.
+ */
+export declare function createRequestErrorHandler(transport: ErrorSink): (error: unknown, request: NextRequestInfo, context: NextRequestErrorContext) => void;
+/**
+ * Next.js `onRequestError` entry point. Re-export from `instrumentation.ts`.
+ * When the active OTel span is available the error is linked to its trace;
+ * otherwise the collector correlates by route and timestamp.
+ */
+export declare function onRequestError(error: unknown, request: NextRequestInfo, context: NextRequestErrorContext): void;
+export {};
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAA;AAElC,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CACxD;AAED,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AA+ED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,CAkCrB;AAED,KAAK,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAA;AAEzD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,GACnB,CACD,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,KAC7B,IAAI,CAQR;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAWN"}

package/dist/error.js

@@ -0,0 +1,143 @@
+import { randomUUID } from 'crypto';
+import { isSpanContextValid, trace } from '@opentelemetry/api';
+import { redactErrorText, redactText, stripUrlQuery, } from '@stacknext/core';
+import { getStackNextTransport, } from '@stacknext/core/transport';
+function readErrorDetails(error) {
+    if (error instanceof Error) {
+        const digest = error.digest;
+        return {
+            message: error.message || 'Unknown error',
+            name: error.name || 'Error',
+            ...(error.stack ? { stack: error.stack } : {}),
+            ...(typeof digest === 'string' && digest.length > 0
+                ? { digest: redactText(digest, 1_000) }
+                : {}),
+        };
+    }
+    if (typeof error === 'string' && error.trim() !== '') {
+        return { message: error, name: 'Error' };
+    }
+    if (typeof error === 'object' && error !== null) {
+        const record = error;
+        const message = typeof record.message === 'string' && record.message.trim() !== ''
+            ? record.message
+            : 'Unknown error';
+        const name = typeof record.name === 'string' && record.name.trim() !== ''
+            ? record.name
+            : 'Error';
+        return {
+            message,
+            name,
+            ...(typeof record.stack === 'string' ? { stack: record.stack } : {}),
+            ...(typeof record.digest === 'string' && record.digest.length > 0
+                ? { digest: redactText(record.digest, 1_000) }
+                : {}),
+        };
+    }
+    return {
+        message: error === undefined || error === null ? 'Unknown error' : String(error),
+        name: 'Error',
+    };
+}
+function safeText(value, maxLength = 2_000) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return undefined;
+    return redactText(trimmed, maxLength);
+}
+function safePath(value) {
+    const text = safeText(value);
+    return text ? stripUrlQuery(text) : undefined;
+}
+function buildAttributes(context) {
+    const attributes = {};
+    if (typeof context.routerKind === 'string') {
+        attributes['next.router_kind'] = context.routerKind;
+    }
+    if (typeof context.routeType === 'string') {
+        attributes['next.route_type'] = context.routeType;
+    }
+    if (typeof context.renderSource === 'string') {
+        attributes['next.render_source'] = context.renderSource;
+    }
+    if (typeof context.revalidateReason === 'string') {
+        attributes['next.revalidate_reason'] = context.revalidateReason;
+    }
+    return attributes;
+}
+/**
+ * Converts a Next.js request error into the StackNext wire format.
+ * Header values are never read or stored.
+ */
+export function requestErrorToInput(error, request, context) {
+    const details = readErrorDetails(error);
+    const route = safePath(context.routePath);
+    const requestPath = safePath(request.path);
+    const method = safeText(request.method, 32)?.toUpperCase();
+    const activeSpan = trace.getActiveSpan();
+    const spanContext = activeSpan?.spanContext();
+    const validContext = spanContext && isSpanContextValid(spanContext);
+    return {
+        id: randomUUID(),
+        message: redactErrorText(details.message),
+        name: redactText(details.name, 200),
+        ...(details.stack ? { stack: redactErrorText(details.stack) } : {}),
+        ...(details.digest ? { digest: details.digest } : {}),
+        timestamp: Date.now(),
+        ...(route ? { route } : {}),
+        ...(method ? { method } : {}),
+        ...(requestPath ? { requestPath } : {}),
+        ...(context.routerKind
+            ? { routerKind: redactText(context.routerKind, 100) }
+            : {}),
+        ...(context.routeType ? { routeType: redactText(context.routeType, 100) } : {}),
+        ...(context.renderSource
+            ? { renderSource: redactText(context.renderSource, 100) }
+            : {}),
+        ...(validContext
+            ? {
+                traceId: spanContext.traceId.toLowerCase(),
+                spanId: spanContext.spanId.toLowerCase(),
+            }
+            : {}),
+        attributes: buildAttributes(context),
+    };
+}
+/**
+ * Creates a Next.js `onRequestError` handler bound to a transport. Exposed for
+ * tests and for applications that want to supply their own transport.
+ */
+export function createRequestErrorHandler(transport) {
+    return (error, request, context) => {
+        try {
+            transport.enqueueError(requestErrorToInput(error, request, context));
+        }
+        catch {
+            // Instrumentation must never throw into Next.js error handling.
+        }
+    };
+}
+/**
+ * Next.js `onRequestError` entry point. Re-export from `instrumentation.ts`.
+ * When the active OTel span is available the error is linked to its trace;
+ * otherwise the collector correlates by route and timestamp.
+ */
+export function onRequestError(error, request, context) {
+    const runtime = process.env.NEXT_RUNTIME;
+    if (runtime !== undefined && runtime !== 'nodejs')
+        return;
+    if (process.env.STACKNEXT_CAPTURE_ERRORS === '0')
+        return;
+    try {
+        const transport = getStackNextTransport();
+        if (!transport)
+            return;
+        createRequestErrorHandler(transport)(error, request, context);
+    }
+    catch {
+        // Never break the host application because telemetry failed.
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

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

package/dist/exporter.d.ts

@@ -0,0 +1,39 @@
+import { type Attributes, type Span } from '@opentelemetry/api';
+import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import { type StackNextSpanInput } from '@stacknext/core';
+import type { StackNextTransport } from '@stacknext/core/transport';
+/**
+ * Converts an OTel ReadableSpan into the StackNext wire format. Redaction happens
+ * here as well as in the collector: sensitive data never leaves the app process.
+ */
+export declare function readableSpanToInput(span: ReadableSpan, options: {
+    collectorUrl: string;
+    fallbackServiceName: string;
+}): StackNextSpanInput | null;
+export interface StackNextSpanExporterOptions {
+    transport: Pick<StackNextTransport, 'enqueueSpan' | 'forceFlush'>;
+    collectorUrl: string;
+    fallbackServiceName?: string;
+    /** Set to false to drop Next.js fetch spans. */
+    captureFetch?: boolean;
+}
+/**
+ * OpenTelemetry SpanExporter that hands normalized spans to the bounded local
+ * transport. It never performs network I/O synchronously.
+ */
+export declare class StackNextSpanExporter implements SpanExporter {
+    private readonly transport;
+    private readonly collectorUrl;
+    private readonly fallbackServiceName;
+    private readonly captureFetch;
+    constructor(options: StackNextSpanExporterOptions);
+    export(spans: ReadableSpan[], resultCallback: (result: {
+        code: number;
+        error?: Error;
+    }) => void): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}
+export declare function spanAttributes(attributes: Record<string, unknown> | undefined): Attributes;
+export type { Span };
+//# sourceMappingURL=exporter.d.ts.map

package/dist/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../src/exporter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,IAAI,EACV,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC/E,OAAO,EAML,KAAK,kBAAkB,EAGxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AA8DnE;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE;IACP,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;CAC5B,GACA,kBAAkB,GAAG,IAAI,CAsD3B;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,YAAY,CAAC,CAAA;IACjE,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,gDAAgD;IAChD,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwD;IAClF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,EAAE,4BAA4B;IAOjD,MAAM,CACJ,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,GAChE,IAAI;IAoBD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC9C,UAAU,CAoBZ;AAED,YAAY,EAAE,IAAI,EAAE,CAAA"}

package/dist/exporter.js

@@ -0,0 +1,170 @@
+import { SpanKind, SpanStatusCode, } from '@opentelemetry/api';
+import { frameworkSpanFields, redactText, sanitizeAttributes, sanitizeResource, stripUrlQueryInText, } from '@stacknext/core';
+const TRACE_ID_PATTERN = /^[0-9a-f]{32}$/i;
+const SPAN_ID_PATTERN = /^[0-9a-f]{16}$/i;
+function hrTimeToMilliseconds(time) {
+    const [seconds, nanoseconds] = time;
+    return seconds * 1_000 + nanoseconds / 1_000_000;
+}
+function kindFromOtel(kind) {
+    switch (kind) {
+        case SpanKind.SERVER:
+            return 'server';
+        case SpanKind.CLIENT:
+            return 'client';
+        case SpanKind.PRODUCER:
+            return 'producer';
+        case SpanKind.CONSUMER:
+            return 'consumer';
+        case SpanKind.INTERNAL:
+            return 'internal';
+    }
+}
+function statusFromOtel(status) {
+    if (status.code === SpanStatusCode.OK)
+        return 'ok';
+    if (status.code === SpanStatusCode.ERROR)
+        return 'error';
+    return 'unset';
+}
+function attributeString(attributes, key) {
+    const value = attributes[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function isInternalUrl(attributes, collectorUrl) {
+    const candidates = [
+        attributeString(attributes, 'http.url'),
+        attributeString(attributes, 'url.full'),
+        attributeString(attributes, 'http.target'),
+        attributeString(attributes, 'next.original_url'),
+    ].filter((value) => Boolean(value));
+    for (const candidate of candidates) {
+        if (candidate.includes('/__stacknext/'))
+            return true;
+        try {
+            if (collectorUrl && candidate.startsWith(new URL(collectorUrl).origin)) {
+                return true;
+            }
+        }
+        catch {
+            // Ignore malformed URLs in attributes.
+        }
+    }
+    return false;
+}
+/**
+ * Converts an OTel ReadableSpan into the StackNext wire format. Redaction happens
+ * here as well as in the collector: sensitive data never leaves the app process.
+ */
+export function readableSpanToInput(span, options) {
+    const context = span.spanContext();
+    if (!TRACE_ID_PATTERN.test(context.traceId) ||
+        !SPAN_ID_PATTERN.test(context.spanId)) {
+        return null;
+    }
+    const attributes = sanitizeAttributes(span.attributes);
+    const nextSpanType = attributeString(attributes, 'next.span_type');
+    if (nextSpanType?.startsWith('Instrumentation.'))
+        return null;
+    if (isInternalUrl(attributes, options.collectorUrl))
+        return null;
+    const framework = frameworkSpanFields(attributes);
+    const resource = sanitizeResource(span.resource.attributes);
+    const serviceName = typeof resource['service.name'] === 'string'
+        ? resource['service.name']
+        : options.fallbackServiceName;
+    const startTime = hrTimeToMilliseconds(span.startTime);
+    const endTime = Math.max(startTime, hrTimeToMilliseconds(span.endTime));
+    const status = statusFromOtel(span.status);
+    const parentSpanId = span.parentSpanContext?.spanId;
+    const safeName = stripUrlQueryInText(redactText(span.name, 512));
+    return {
+        traceId: context.traceId.toLowerCase(),
+        spanId: context.spanId.toLowerCase(),
+        ...(parentSpanId && SPAN_ID_PATTERN.test(parentSpanId)
+            ? { parentSpanId: parentSpanId.toLowerCase() }
+            : {}),
+        name: safeName,
+        kind: kindFromOtel(span.kind),
+        startTime,
+        endTime,
+        durationMs: endTime - startTime,
+        status,
+        ...(span.status.message
+            ? {
+                statusMessage: stripUrlQueryInText(redactText(span.status.message, 8_000)),
+            }
+            : {}),
+        serviceName: redactText(serviceName, 200),
+        ...(nextSpanType ? { nextSpanType: redactText(nextSpanType, 200) } : {}),
+        ...framework,
+        attributes,
+        events: span.events.slice(0, 100).map((event) => ({
+            name: stripUrlQueryInText(redactText(event.name, 512)),
+            time: hrTimeToMilliseconds(event.time),
+            attributes: sanitizeAttributes(event.attributes ?? {}),
+        })),
+        resource,
+    };
+}
+/**
+ * OpenTelemetry SpanExporter that hands normalized spans to the bounded local
+ * transport. It never performs network I/O synchronously.
+ */
+export class StackNextSpanExporter {
+    transport;
+    collectorUrl;
+    fallbackServiceName;
+    captureFetch;
+    constructor(options) {
+        this.transport = options.transport;
+        this.collectorUrl = options.collectorUrl;
+        this.fallbackServiceName = options.fallbackServiceName ?? 'next-app';
+        this.captureFetch = options.captureFetch ?? true;
+    }
+    export(spans, resultCallback) {
+        try {
+            for (const span of spans) {
+                const input = readableSpanToInput(span, {
+                    collectorUrl: this.collectorUrl,
+                    fallbackServiceName: this.fallbackServiceName,
+                });
+                if (!input)
+                    continue;
+                if (!this.captureFetch && input.nextSpanType === 'AppRender.fetch')
+                    continue;
+                this.transport.enqueueSpan(input);
+            }
+            resultCallback({ code: 0 });
+        }
+        catch (error) {
+            resultCallback({
+                code: 1,
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+        }
+    }
+    async shutdown() {
+        await this.transport.forceFlush();
+    }
+    async forceFlush() {
+        await this.transport.forceFlush();
+    }
+}
+export function spanAttributes(attributes) {
+    const sanitized = sanitizeAttributes(attributes);
+    const output = {};
+    for (const [key, value] of Object.entries(sanitized)) {
+        if (typeof value === 'string' ||
+            typeof value === 'number' ||
+            typeof value === 'boolean' ||
+            (Array.isArray(value) &&
+                value.every((item) => typeof item === 'string' ||
+                    typeof item === 'number' ||
+                    typeof item === 'boolean'))) {
+            output[key] = value;
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=exporter.js.map

package/dist/exporter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { StackNextSpanExporter, readableSpanToInput, spanAttributes, type StackNextSpanExporterOptions, } from './exporter.js';
+export { getStackNextRegistration, register, registerStackNext, shutdownStackNext, type StackNextRegisterOptions, type StackNextRegistration, } from './register.js';
+export { createRequestErrorHandler, onRequestError, requestErrorToInput, type NextRequestErrorContext, type NextRequestInfo, } from './error.js';
+export { withStackNextSpan, withStackNextSpanSync, withStackNextAction, type StackNextManualSpanOptions, } from './manual.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,KAAK,4BAA4B,GAClC,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,wBAAwB,EACxB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,GACrB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { StackNextSpanExporter, readableSpanToInput, spanAttributes, } from './exporter.js';
+export { getStackNextRegistration, register, registerStackNext, shutdownStackNext, } from './register.js';
+export { createRequestErrorHandler, onRequestError, requestErrorToInput, } from './error.js';
+export { withStackNextSpan, withStackNextSpanSync, withStackNextAction, } from './manual.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,GAEf,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,wBAAwB,EACxB,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,mBAAmB,GAGpB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,aAAa,CAAA"}

package/dist/manual.d.ts

@@ -0,0 +1,31 @@
+import { SpanKind, type Span } from '@opentelemetry/api';
+export interface StackNextManualSpanOptions {
+    attributes?: Record<string, unknown>;
+    kind?: SpanKind;
+    /** Record thrown exceptions on the span. Defaults to true. */
+    recordException?: boolean;
+}
+type ManualSpanFunction<T> = (span: Span) => T | Promise<T>;
+/**
+ * Runs an async operation inside a StackNext span. The span is exported along
+ * with Next.js request spans, so manual work appears in the same timeline.
+ *
+ * Both `(name, fn, options?)` and `(name, options, fn)` are supported.
+ */
+export declare function withStackNextSpan<T>(name: string, fn: ManualSpanFunction<T>, options?: StackNextManualSpanOptions): Promise<T>;
+export declare function withStackNextSpan<T>(name: string, options: StackNextManualSpanOptions, fn: ManualSpanFunction<T>): Promise<T>;
+/**
+ * Synchronous variant for database drivers and other blocking work. Supports
+ * the same argument forms as {@link withStackNextSpan}.
+ */
+export declare function withStackNextSpanSync<T>(name: string, fn: (span: Span) => T, options?: StackNextManualSpanOptions): T;
+export declare function withStackNextSpanSync<T>(name: string, options: StackNextManualSpanOptions, fn: (span: Span) => T): T;
+/**
+ * Wraps a Server Action in an explicit span. Successful Server Actions do not
+ * reach `onRequestError`, so this helper is the supported way to make them
+ * visible. Return values and thrown control flow are preserved.
+ */
+export declare function withStackNextAction<T>(name: string, fn: ManualSpanFunction<T>, options?: StackNextManualSpanOptions): Promise<T>;
+export declare function withStackNextAction<T>(name: string, options: StackNextManualSpanOptions, fn: ManualSpanFunction<T>): Promise<T>;
+export {};
+//# sourceMappingURL=manual.d.ts.map

package/dist/manual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.d.ts","sourceRoot":"","sources":["../src/manual.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAIR,KAAK,IAAI,EACV,MAAM,oBAAoB,CAAA;AAQ3B,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,KAAK,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAqF3D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,CAAC,CAAC,CAAA;AACb,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,0BAA0B,EACnC,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC,CAAA;AAmBb;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EACrB,OAAO,CAAC,EAAE,0BAA0B,GACnC,CAAC,CAAA;AACJ,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,0BAA0B,EACnC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,GACpB,CAAC,CAAA;AAmBJ;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,CAAC,CAAC,CAAA;AACb,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,0BAA0B,EACnC,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,CAAC,CAAC,CAAA"}

package/dist/manual.js

@@ -0,0 +1,115 @@
+import { SpanKind, SpanStatusCode, trace, } from '@opentelemetry/api';
+import { STACKNEXT_SDK_VERSION, redactText, stripUrlQueryInText, } from '@stacknext/core';
+import { spanAttributes } from './exporter.js';
+function tracer() {
+    return trace.getTracer('stacknext', STACKNEXT_SDK_VERSION);
+}
+function startOptions(options, marker) {
+    return {
+        kind: options.kind ?? SpanKind.INTERNAL,
+        attributes: {
+            ...spanAttributes(options.attributes),
+            // Set after user attributes so coverage and classification cannot be
+            // spoofed or accidentally dropped by a caller-provided map.
+            'stacknext.manual': true,
+            'stacknext.span.kind': marker,
+        },
+    };
+}
+function safeErrorText(value, maxLength) {
+    return stripUrlQueryInText(redactText(value, maxLength));
+}
+function safeError(error) {
+    if (error instanceof Error) {
+        return {
+            name: safeErrorText(error.name, 200),
+            message: safeErrorText(error.message, 8_000),
+            ...(error.stack ? { stack: safeErrorText(error.stack, 64_000) } : {}),
+        };
+    }
+    return { name: 'Error', message: safeErrorText(String(error), 8_000) };
+}
+function recordFailure(span, error) {
+    const safe = safeError(error);
+    span.recordException(safe);
+    span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: safe.message.slice(0, 512),
+    });
+}
+/**
+ * Redirects and not-found responses use thrown control-flow objects in the App
+ * Router. They are normal outcomes, not failures, but must still propagate.
+ */
+function isControlFlowError(error) {
+    if (typeof error !== 'object' || error === null)
+        return false;
+    const digest = error.digest;
+    return (typeof digest === 'string' &&
+        (digest === 'NEXT_NOT_FOUND' ||
+            digest.startsWith('NEXT_REDIRECT') ||
+            digest.startsWith('NEXT_HTTP_ERROR_FALLBACK')));
+}
+function resolveCall(second, third) {
+    if (typeof second === 'function') {
+        return {
+            fn: second,
+            options: third ?? {},
+        };
+    }
+    if (typeof third !== 'function') {
+        throw new TypeError('withStackNextSpan requires a callback function');
+    }
+    return { fn: third, options: second };
+}
+function finishFailure(span, error, options) {
+    if (options.recordException !== false && !isControlFlowError(error)) {
+        recordFailure(span, error);
+    }
+}
+export function withStackNextSpan(name, second, third) {
+    const { fn, options } = resolveCall(second, third);
+    return tracer().startActiveSpan(name, startOptions(options, 'custom'), async (span) => {
+        try {
+            return await fn(span);
+        }
+        catch (error) {
+            finishFailure(span, error, options);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+export function withStackNextSpanSync(name, second, third) {
+    const { fn, options } = resolveCall(second, third);
+    return tracer().startActiveSpan(name, startOptions(options, 'custom'), (span) => {
+        try {
+            return fn(span);
+        }
+        catch (error) {
+            finishFailure(span, error, options);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+export function withStackNextAction(name, second, third) {
+    const { fn, options } = resolveCall(second, third);
+    return tracer().startActiveSpan(name, startOptions(options, 'action'), async (span) => {
+        try {
+            return await fn(span);
+        }
+        catch (error) {
+            finishFailure(span, error, options);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+//# sourceMappingURL=manual.js.map

package/dist/manual.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,44 @@
+import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { type StackNextTransport, type StackNextTransportOptions } from '@stacknext/core/transport';
+import { StackNextSpanExporter } from './exporter.js';
+export interface StackNextRegisterOptions {
+    /** Overrides environment-based transport configuration. */
+    transport?: StackNextTransportOptions;
+    /** Collector URL; used to filter self-instrumentation requests. */
+    collectorUrl?: string;
+    serviceName?: string;
+    projectName?: string;
+    nextVersion?: string;
+    /** Set to false to drop Next.js fetch spans. Defaults to true. */
+    captureFetch?: boolean;
+    /** Set to false to keep StackNext loaded but inactive. */
+    enabled?: boolean;
+}
+export interface StackNextRegistration {
+    provider: NodeTracerProvider;
+    transport: StackNextTransport;
+    exporter: StackNextSpanExporter;
+    serviceName: string;
+    registeredAt: number;
+}
+/**
+ * Starts OpenTelemetry span collection for a Next.js Node.js runtime.
+ *
+ * Call this from `instrumentation.ts` `register()`. It is inert when StackNext
+ * environment variables are absent, so applications can deploy the same build
+ * without a local collector. Existing tracer providers are never replaced:
+ * StackNext yields to another APM rather than breaking its instrumentation.
+ */
+export declare function registerStackNext(options?: StackNextRegisterOptions): Promise<StackNextRegistration | null>;
+/** Returns the active registration without creating one. */
+export declare function getStackNextRegistration(): StackNextRegistration | undefined;
+/**
+ * Flushes buffered spans and shuts the provider down. Safe to call more than
+ * once. Next owns process signals; StackNext only hooks process exit.
+ */
+export declare function shutdownStackNext(): Promise<void>;
+/**
+ * Next.js `register()` entry point. Re-export this from `instrumentation.ts`.
+ */
+export declare function register(options?: StackNextRegisterOptions): Promise<StackNextRegistration | null>;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAQlE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC/B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,SAAS,CAAC,EAAE,yBAAyB,CAAA;IACrC,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,SAAS,EAAE,kBAAkB,CAAA;IAC7B,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAkFD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CA2EvC;AAED,4DAA4D;AAC5D,wBAAgB,wBAAwB,IACpC,qBAAqB,GACrB,SAAS,CAEZ;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBvD;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAEvC"}

package/dist/register.js

@@ -0,0 +1,177 @@
+import { ProxyTracerProvider, propagation, trace, } from '@opentelemetry/api';
+import { CompositePropagator, W3CBaggagePropagator, W3CTraceContextPropagator, } from '@opentelemetry/core';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
+import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION, } from '@opentelemetry/semantic-conventions';
+import { STACKNEXT_SDK_VERSION, } from '@stacknext/core';
+import { getStackNextTransport, } from '@stacknext/core/transport';
+import { StackNextSpanExporter } from './exporter.js';
+function globalState() {
+    return globalThis;
+}
+function debugLog(message) {
+    if (process.env.STACKNEXT_DEBUG === '1') {
+        console.warn(`[stacknext] ${message}`);
+    }
+}
+/**
+ * Returns the provider currently serving the OTel API, or null when only the
+ * API's no-op proxy is installed. `trace.getTracerProvider()` returns the proxy
+ * even after registration, so the delegate must be inspected.
+ */
+function registeredProvider() {
+    const provider = trace.getTracerProvider();
+    if (provider instanceof ProxyTracerProvider) {
+        const delegate = provider.getDelegate();
+        return delegate.constructor?.name === 'NoopTracerProvider' ? null : delegate;
+    }
+    if (provider.constructor?.name === 'ProxyTracerProvider') {
+        const delegate = provider.getDelegate();
+        return delegate.constructor?.name === 'NoopTracerProvider' ? null : delegate;
+    }
+    return provider;
+}
+function isNodeRuntime() {
+    const runtime = process.env.NEXT_RUNTIME;
+    return runtime === undefined || runtime === 'nodejs';
+}
+function readNextVersion(options) {
+    const value = options.nextVersion ??
+        process.env.STACKNEXT_NEXT_VERSION ??
+        process.env.npm_package_dependencies_next ??
+        undefined;
+    return value && value.trim() !== '' ? value.trim() : undefined;
+}
+function buildResource(serviceName, nextVersion) {
+    const serviceVersion = process.env.npm_package_version && process.env.npm_package_version.trim() !== ''
+        ? process.env.npm_package_version.trim()
+        : STACKNEXT_SDK_VERSION;
+    return resourceFromAttributes({
+        [ATTR_SERVICE_NAME]: serviceName,
+        [ATTR_SERVICE_VERSION]: serviceVersion,
+        'next.runtime': 'nodejs',
+        ...(nextVersion ? { 'next.version': nextVersion } : {}),
+        ...(process.env.NODE_ENV ? { 'deployment.environment': process.env.NODE_ENV } : {}),
+    });
+}
+function resolveTransport(options) {
+    if (options.transport) {
+        return getStackNextTransport({
+            ...options.transport,
+            ...(options.serviceName ? { serviceName: options.serviceName } : {}),
+            ...(options.projectName ? { projectName: options.projectName } : {}),
+            ...(readNextVersion(options) ? { nextVersion: readNextVersion(options) } : {}),
+        });
+    }
+    return getStackNextTransport();
+}
+/**
+ * Starts OpenTelemetry span collection for a Next.js Node.js runtime.
+ *
+ * Call this from `instrumentation.ts` `register()`. It is inert when StackNext
+ * environment variables are absent, so applications can deploy the same build
+ * without a local collector. Existing tracer providers are never replaced:
+ * StackNext yields to another APM rather than breaking its instrumentation.
+ */
+export async function registerStackNext(options = {}) {
+    const state = globalState();
+    if (state.__stacknextRegistration)
+        return state.__stacknextRegistration;
+    if (options.enabled === false)
+        return null;
+    if (!isNodeRuntime())
+        return null;
+    if (registeredProvider()) {
+        debugLog('an OpenTelemetry tracer provider is already registered; leaving it untouched');
+        return null;
+    }
+    const transport = resolveTransport(options);
+    if (!transport) {
+        debugLog('STACKNEXT_COLLECTOR_URL and STACKNEXT_TOKEN are not set; tracing is disabled');
+        return null;
+    }
+    const nextVersion = readNextVersion(options);
+    const serviceName = options.serviceName ??
+        transport.options.serviceName ??
+        transport.options.projectName ??
+        'next-app';
+    const collectorUrl = options.collectorUrl ?? transport.options.collectorUrl;
+    const exporter = new StackNextSpanExporter({
+        transport,
+        collectorUrl,
+        fallbackServiceName: serviceName,
+        captureFetch: options.captureFetch ?? process.env.STACKNEXT_CAPTURE_FETCH !== '0',
+    });
+    const processor = new BatchSpanProcessor(exporter, {
+        scheduledDelayMillis: 200,
+        maxQueueSize: 2_048,
+        maxExportBatchSize: 256,
+        exportTimeoutMillis: 2_000,
+    });
+    const tracerProvider = new NodeTracerProvider({
+        resource: buildResource(serviceName, nextVersion),
+        spanProcessors: [processor],
+    });
+    tracerProvider.register();
+    // Next.js extracts W3C context from the request headers through the global
+    // propagator. Installing a real propagator makes an incoming `traceparent`
+    // from a local test runner the parent of the Next.js request trace. Without
+    // it the API's no-op propagator silently drops the header.
+    propagation.setGlobalPropagator(new CompositePropagator({
+        propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()],
+    }));
+    const registration = {
+        provider: tracerProvider,
+        transport,
+        exporter,
+        serviceName,
+        registeredAt: Date.now(),
+    };
+    state.__stacknextRegistration = registration;
+    const beforeExit = () => {
+        void shutdownStackNext();
+    };
+    state.__stacknextBeforeExit = beforeExit;
+    process.once('beforeExit', beforeExit);
+    debugLog(`tracing registered for ${serviceName} (queue ${transport.instanceId.slice(0, 8)})`);
+    return registration;
+}
+/** Returns the active registration without creating one. */
+export function getStackNextRegistration() {
+    return globalState().__stacknextRegistration;
+}
+/**
+ * Flushes buffered spans and shuts the provider down. Safe to call more than
+ * once. Next owns process signals; StackNext only hooks process exit.
+ */
+export async function shutdownStackNext() {
+    const state = globalState();
+    const registration = state.__stacknextRegistration;
+    if (!registration)
+        return;
+    state.__stacknextRegistration = undefined;
+    if (state.__stacknextBeforeExit) {
+        process.removeListener('beforeExit', state.__stacknextBeforeExit);
+        state.__stacknextBeforeExit = undefined;
+    }
+    try {
+        await registration.provider.shutdown();
+    }
+    catch (error) {
+        debugLog(`provider shutdown failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        await registration.transport.shutdown(1_000);
+    }
+    catch {
+        // Transport shutdown is best effort; the process is exiting.
+    }
+}
+/**
+ * Next.js `register()` entry point. Re-export this from `instrumentation.ts`.
+ */
+export async function register(options = {}) {
+    return registerStackNext(options);
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

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

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@stacknext/next",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.1",
+  "description": "Next.js instrumentation and OpenTelemetry exporter for StackNext",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "edge": "./dist/edge.js",
+      "edge-light": "./dist/edge.js",
+      "worker": "./dist/edge.js",
+      "workerd": "./dist/edge.js",
+      "node": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@stacknext/core": "0.6.1",
+    "@opentelemetry/api": "1.9.0",
+    "@opentelemetry/context-async-hooks": "2.12.0",
+    "@opentelemetry/core": "2.12.0",
+    "@opentelemetry/resources": "2.12.0",
+    "@opentelemetry/sdk-trace-base": "2.12.0",
+    "@opentelemetry/sdk-trace-node": "2.12.0",
+    "@opentelemetry/semantic-conventions": "1.39.0"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "author": "StackNext contributors",
+  "homepage": "https://github.com/marrrkkk/stacknext#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marrrkkk/stacknext.git",
+    "directory": "packages/next"
+  },
+  "bugs": {
+    "url": "https://github.com/marrrkkk/stacknext/issues"
+  },
+  "keywords": [
+    "stacknext",
+    "nextjs",
+    "opentelemetry",
+    "instrumentation",
+    "tracing",
+    "debugging"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "next": ">=15.0.0 <17"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }