@nextscope/next 0.1.0

package/dist/inspector-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector-assets.js","sourceRoot":"","sources":["../src/inspector-assets.ts"],"names":[],"mappings":";;;AAAA,mEAAmE;AACtD,QAAA,YAAY,GAAG,02hBAA02hB,CAAA;AACz3hB,QAAA,WAAW,GAAG,yk0OAAyk0O,CAAA"}

package/dist/next-types.d.ts

@@ -0,0 +1,26 @@
+export type NextConfig = object & {
+    rewrites?: () => Promise<Rewrites> | Rewrites;
+};
+export type Rewrites = Rewrite[] | RewriteGroups;
+export interface Rewrite {
+    source: string;
+    destination: string;
+    basePath?: false;
+    locale?: false;
+    has?: RouteHas[];
+    missing?: RouteHas[];
+}
+export type RouteHas = {
+    type: 'header' | 'cookie' | 'query';
+    key: string;
+    value?: string;
+} | {
+    type: 'host';
+    key?: undefined;
+    value: string;
+};
+export interface RewriteGroups {
+    beforeFiles?: Rewrite[];
+    afterFiles?: Rewrite[];
+    fallback?: Rewrite[];
+}

package/dist/next-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=next-types.js.map

package/dist/next-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-types.js","sourceRoot":"","sources":["../src/next-types.ts"],"names":[],"mappings":""}

package/dist/otel.d.ts

@@ -0,0 +1,102 @@
+export interface OtlpJsonBatch {
+    resourceSpans?: OtlpResourceSpan[];
+}
+export interface OtlpResourceSpan {
+    resource?: {
+        attributes?: OtlpAttribute[];
+    };
+    scopeSpans?: OtlpScopeSpan[];
+    instrumentationLibrarySpans?: OtlpScopeSpan[];
+}
+export interface OtlpScopeSpan {
+    scope?: {
+        name?: string;
+        version?: string;
+        attributes?: OtlpAttribute[];
+    };
+    instrumentationLibrary?: {
+        name?: string;
+        version?: string;
+        attributes?: OtlpAttribute[];
+    };
+    spans?: OtlpSpan[];
+}
+export interface OtlpSpan {
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    name?: string;
+    kind?: string | number;
+    startTimeUnixNano?: string | number;
+    endTimeUnixNano?: string | number;
+    attributes?: OtlpAttribute[];
+    events?: OtlpSpanEvent[];
+    links?: OtlpSpanLink[];
+    status?: {
+        code?: string | number;
+        message?: string;
+    };
+}
+export interface OtlpSpanEvent {
+    timeUnixNano?: string | number;
+    name?: string;
+    attributes?: OtlpAttribute[];
+}
+export interface OtlpSpanLink {
+    traceId?: string;
+    spanId?: string;
+    traceState?: string;
+    attributes?: OtlpAttribute[];
+}
+export interface OtlpAttribute {
+    key?: string;
+    value?: {
+        stringValue?: string;
+        intValue?: string | number;
+        doubleValue?: string | number;
+        boolValue?: boolean;
+        arrayValue?: {
+            values?: OtlpAttribute['value'][];
+        };
+        kvlistValue?: {
+            values?: OtlpAttribute[];
+        };
+    };
+}
+export interface NormalizedSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind?: string | number;
+    startTimeUnixNano: bigint;
+    endTimeUnixNano: bigint;
+    durationMs: number;
+    attributes: Record<string, unknown>;
+    resourceAttributes: Record<string, unknown>;
+    events: NormalizedSpanEvent[];
+    links: NormalizedSpanLink[];
+    status?: {
+        code?: string | number;
+        message?: string;
+    };
+}
+export interface NormalizedSpanEvent {
+    timeUnixNano: bigint;
+    name: string;
+    attributes: Record<string, unknown>;
+}
+export interface NormalizedSpanLink {
+    traceId?: string;
+    spanId?: string;
+    traceState?: string;
+    attributes: Record<string, unknown>;
+}
+export declare class OtlpParseError extends Error {
+    constructor(message: string);
+}
+export declare function normalizeOtlpJsonBatch(batch: OtlpJsonBatch): NormalizedSpan[];
+export declare function attributesToRecord(attributes: OtlpAttribute[]): Record<string, unknown>;
+export declare function decodeValue(value: OtlpAttribute['value']): unknown;
+export declare function toBigInt(value: string | number | undefined): bigint;
+export declare function toTimestampNano(value: string | number | undefined, fieldName?: string): bigint;

package/dist/otel.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtlpParseError = void 0;
+exports.normalizeOtlpJsonBatch = normalizeOtlpJsonBatch;
+exports.attributesToRecord = attributesToRecord;
+exports.decodeValue = decodeValue;
+exports.toBigInt = toBigInt;
+exports.toTimestampNano = toTimestampNano;
+class OtlpParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OtlpParseError';
+    }
+}
+exports.OtlpParseError = OtlpParseError;
+function normalizeOtlpJsonBatch(batch) {
+    const spans = [];
+    for (const resourceSpan of batch.resourceSpans ?? []) {
+        const resourceAttributes = attributesToRecord(resourceSpan.resource?.attributes ?? []);
+        const scopeSpans = resourceSpan.scopeSpans ?? resourceSpan.instrumentationLibrarySpans ?? [];
+        for (const scopeSpan of scopeSpans) {
+            for (const span of scopeSpan.spans ?? []) {
+                if (!span.traceId || !span.spanId) {
+                    continue;
+                }
+                const startTimeUnixNano = toTimestampNano(span.startTimeUnixNano, 'span.startTimeUnixNano');
+                const endTimeUnixNano = toTimestampNano(span.endTimeUnixNano, 'span.endTimeUnixNano');
+                if (endTimeUnixNano < startTimeUnixNano) {
+                    throw new OtlpParseError('span.endTimeUnixNano must be greater than or equal to span.startTimeUnixNano');
+                }
+                spans.push({
+                    traceId: span.traceId,
+                    spanId: span.spanId,
+                    parentSpanId: span.parentSpanId || undefined,
+                    name: span.name ?? '(unnamed span)',
+                    kind: span.kind,
+                    startTimeUnixNano,
+                    endTimeUnixNano,
+                    durationMs: nanosToMillis(endTimeUnixNano - startTimeUnixNano),
+                    attributes: attributesToRecord(span.attributes ?? []),
+                    resourceAttributes,
+                    events: normalizeEvents(span.events ?? []),
+                    links: normalizeLinks(span.links ?? []),
+                    status: span.status,
+                });
+            }
+        }
+    }
+    return spans;
+}
+function normalizeEvents(events) {
+    return events.map((event) => ({
+        timeUnixNano: toTimestampNano(event.timeUnixNano, 'span.events[].timeUnixNano'),
+        name: event.name ?? '(unnamed event)',
+        attributes: attributesToRecord(event.attributes ?? []),
+    }));
+}
+function normalizeLinks(links) {
+    return links.map((link) => ({
+        traceId: link.traceId,
+        spanId: link.spanId,
+        traceState: link.traceState,
+        attributes: attributesToRecord(link.attributes ?? []),
+    }));
+}
+function attributesToRecord(attributes) {
+    const record = {};
+    for (const attribute of attributes) {
+        if (!attribute.key) {
+            continue;
+        }
+        record[attribute.key] = decodeValue(attribute.value);
+    }
+    return record;
+}
+function decodeValue(value) {
+    if (!value) {
+        return undefined;
+    }
+    if ('stringValue' in value) {
+        return value.stringValue;
+    }
+    if ('intValue' in value) {
+        return decodeIntegerValue(value.intValue);
+    }
+    if ('doubleValue' in value) {
+        return Number(value.doubleValue);
+    }
+    if ('boolValue' in value) {
+        return value.boolValue;
+    }
+    if ('arrayValue' in value) {
+        return (value.arrayValue?.values ?? []).map(decodeValue);
+    }
+    if ('kvlistValue' in value) {
+        return attributesToRecord(value.kvlistValue?.values ?? []);
+    }
+    return undefined;
+}
+function toBigInt(value) {
+    if (value === undefined) {
+        return 0n;
+    }
+    return BigInt(value);
+}
+function toTimestampNano(value, fieldName = 'timestamp') {
+    if (value === undefined) {
+        return 0n;
+    }
+    if (typeof value === 'number') {
+        if (!Number.isSafeInteger(value) || value < 0) {
+            throw new OtlpParseError(`${fieldName} must be a non-negative safe integer`);
+        }
+        return BigInt(value);
+    }
+    if (!/^\d+$/.test(value)) {
+        throw new OtlpParseError(`${fieldName} must be a non-negative integer string`);
+    }
+    return BigInt(value);
+}
+function decodeIntegerValue(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === 'number') {
+        return Number.isSafeInteger(value) ? value : String(value);
+    }
+    if (!/^-?\d+$/.test(value)) {
+        return Number(value);
+    }
+    const parsed = Number(value);
+    return Number.isSafeInteger(parsed) ? parsed : value;
+}
+function nanosToMillis(value) {
+    return Number(value) / 1_000_000;
+}
+//# sourceMappingURL=otel.js.map

package/dist/otel.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+import { TraceStore } from './store';
+export interface NextScopeServerOptions {
+    route: string;
+    maxTraces: number;
+}
+export interface NextScopeServer {
+    route: string;
+    url: string;
+    store: TraceStore;
+    close(): Promise<void>;
+}
+export declare function startNextScopeServer(options: NextScopeServerOptions): Promise<NextScopeServer>;

package/dist/server.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startNextScopeServer = startNextScopeServer;
+const node_http_1 = require("node:http");
+const forwarder_1 = require("./forwarder");
+const otel_1 = require("./otel");
+const suppression_1 = require("./suppression");
+const store_1 = require("./store");
+const ui_1 = require("./ui");
+const OTLP_BODY_LIMIT_BYTES = 5 * 1024 * 1024;
+async function startNextScopeServer(options) {
+    const store = new store_1.TraceStore(options.maxTraces);
+    const forwarder = new forwarder_1.TraceForwarder();
+    const sidecarStatus = new SidecarStatus(options.route);
+    let sidecarUrl = '';
+    const server = (0, node_http_1.createServer)(async (request, response) => {
+        try {
+            await handleRequest(request, response, store, forwarder, sidecarStatus, options.route, sidecarUrl);
+        }
+        catch (error) {
+            if (error instanceof HttpError) {
+                if (error.status === 400) {
+                    sidecarStatus.recordParseError(error.message);
+                }
+                sendJson(response, error.status, { error: error.message });
+                return;
+            }
+            sendJson(response, 500, { error: formatError(error) });
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            server.off('error', reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    const url = `http://127.0.0.1:${address.port}`;
+    sidecarUrl = url;
+    return {
+        route: options.route,
+        url,
+        store,
+        close: () => new Promise((resolve, reject) => {
+            server.close((error) => (error ? reject(error) : resolve()));
+        }),
+    };
+}
+async function handleRequest(request, response, store, forwarder, sidecarStatus, route, sidecarUrl) {
+    const url = new URL(request.url ?? '/', 'http://127.0.0.1');
+    if (request.method === 'POST' && url.pathname === '/v1/traces') {
+        const body = await readBody(request, OTLP_BODY_LIMIT_BYTES);
+        const batch = parseOtlpJson(body);
+        const normalized = normalizeOtlpBatch(batch);
+        const filtered = (0, suppression_1.filterIgnoredTraces)(batch, normalized, route, sidecarUrl);
+        store.ingest(filtered.spans);
+        sidecarStatus.recordIngest(filtered.ignoredTraceIds.size);
+        if (filtered.batch.resourceSpans?.length) {
+            void forwarder.forward(JSON.stringify(filtered.batch));
+        }
+        sendJson(response, 200, {});
+        return;
+    }
+    if (request.method === 'GET' && url.pathname === '/api/traces') {
+        sendJson(response, 200, store.listTraceSummaries({ lean: true }));
+        return;
+    }
+    if (request.method === 'GET' && url.pathname === '/api/status') {
+        sendJson(response, 200, sidecarStatus.snapshot(store, forwarder));
+        return;
+    }
+    if (request.method === 'GET' && url.pathname.startsWith('/api/traces/')) {
+        const traceId = decodeURIComponent(url.pathname.slice('/api/traces/'.length));
+        const trace = store.getTrace(traceId);
+        if (!trace) {
+            sendJson(response, 404, { error: 'Trace not found' });
+            return;
+        }
+        sendJson(response, 200, trace);
+        return;
+    }
+    if (request.method === 'GET' && (url.pathname === '/' || url.pathname === '/index.html')) {
+        sendText(response, 200, 'text/html; charset=utf-8', (0, ui_1.renderInspectorHtml)(route));
+        return;
+    }
+    if (request.method === 'GET' && url.pathname === '/style.css') {
+        sendText(response, 200, 'text/css; charset=utf-8', ui_1.inspectorCss);
+        return;
+    }
+    if (request.method === 'GET' && url.pathname === '/app.js') {
+        sendText(response, 200, 'application/javascript; charset=utf-8', ui_1.inspectorJs);
+        return;
+    }
+    sendText(response, 404, 'text/plain; charset=utf-8', 'Not found');
+}
+function sendJson(response, status, value) {
+    sendText(response, status, 'application/json; charset=utf-8', JSON.stringify(value));
+}
+function sendText(response, status, contentType, body) {
+    response.writeHead(status, {
+        'content-type': contentType,
+        'cache-control': 'no-store',
+    });
+    response.end(body);
+}
+async function readBody(request, limitBytes) {
+    const chunks = [];
+    let totalBytes = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        totalBytes += buffer.byteLength;
+        if (totalBytes > limitBytes) {
+            throw new HttpError(413, `OTLP request body exceeds ${limitBytes} bytes`);
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+function parseOtlpJson(body) {
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new HttpError(400, 'Malformed OTLP JSON');
+    }
+}
+function normalizeOtlpBatch(batch) {
+    try {
+        return (0, otel_1.normalizeOtlpJsonBatch)(batch);
+    }
+    catch (error) {
+        if (error instanceof otel_1.OtlpParseError) {
+            throw new HttpError(400, error.message);
+        }
+        throw error;
+    }
+}
+function formatError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+class HttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'HttpError';
+    }
+}
+class SidecarStatus {
+    route;
+    suppressedCount = 0;
+    lastParseError;
+    constructor(route) {
+        this.route = route;
+    }
+    recordIngest(suppressedCount) {
+        this.suppressedCount += suppressedCount;
+        this.lastParseError = undefined;
+    }
+    recordParseError(message) {
+        this.lastParseError = message;
+    }
+    snapshot(store, forwarder) {
+        const storeStats = store.getStats();
+        const forwarding = forwarder.getStatus();
+        return {
+            route: this.route,
+            traceCount: storeStats.traceCount,
+            lastIngestAt: storeStats.lastIngestAt,
+            suppressedCount: this.suppressedCount,
+            forwarding,
+            lastParseError: this.lastParseError,
+            lastForwardError: forwarding.lastError,
+            lastError: this.lastParseError ?? forwarding.lastError,
+        };
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,164 @@
+import type { NormalizedSpan } from './otel';
+export interface TraceSummary {
+    traceId: string;
+    requestSegmentId: string;
+    revision: number;
+    updatedAt: string;
+    spanCount: number;
+    traceSpanCount: number;
+    segmentCount: number;
+    rootSpan: RequestSpanSummary;
+    startTimeUnixNano: string;
+    timestamp: string;
+    durationMs: number;
+    statusBucket: StatusBucket;
+    requestKind: string;
+    hasRsc: boolean;
+    hasPrefetch: boolean;
+    routeLabel: string;
+    errorSpanCount: number;
+    serviceNames: string[];
+    durationRangeMs: {
+        start: number;
+        end: number;
+    };
+    requestSegments: RequestSegmentSummary[];
+    topSlowSpans: DiagnosticSpanSummary[];
+    firstError?: ErrorSummary;
+    exceptionSummary?: ExceptionSummary;
+    criticalPath: CriticalPathSummary;
+}
+export interface TraceDetail extends TraceSummary {
+    spans: TraceSpanNode[];
+}
+export interface RequestSegmentSummary {
+    requestSegmentId: string;
+    rootSpan: RequestSpanSummary;
+    routeLabel: string;
+    statusBucket: StatusBucket;
+    requestKind: string;
+    startOffsetMs: number;
+    endOffsetMs: number;
+    durationMs: number;
+    spanCount: number;
+    errorSpanCount: number;
+    topSlowSpans: DiagnosticSpanSummary[];
+    firstError?: ErrorSummary;
+    exceptionSummary?: ExceptionSummary;
+    criticalPath: CriticalPathSummary;
+}
+export interface DiagnosticSpanSummary {
+    spanId: string;
+    name: string;
+    durationMs: number;
+    offsetMs: number;
+    serviceName?: string;
+    hasError: boolean;
+}
+export interface ErrorSummary {
+    spanId: string;
+    name: string;
+    offsetMs: number;
+    statusCode?: number;
+    statusMessage?: string;
+    exceptionType?: string;
+    exceptionMessage?: string;
+}
+export interface ExceptionSummary {
+    count: number;
+    firstMessage?: string;
+    firstType?: string;
+}
+export interface CriticalPathSummary {
+    durationMs: number;
+    spanIds: string[];
+    names: string[];
+}
+export interface RequestSpanSummary {
+    spanId: string;
+    name: string;
+    route?: string;
+    target?: string;
+    method?: string;
+    statusCode?: number;
+    spanType?: string;
+    startTimeUnixNano: string;
+    durationMs: number;
+    attributes?: Record<string, unknown>;
+}
+export interface TraceSpanNode {
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind?: string | number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    durationMs: number;
+    offsetMs: number;
+    endOffsetMs: number;
+    serviceName?: string;
+    statusCode?: number;
+    hasError: boolean;
+    attributes: Record<string, unknown>;
+    resourceAttributes: Record<string, unknown>;
+    spanType?: string;
+    status?: NormalizedSpan['status'];
+    events: TraceSpanEvent[];
+    links: TraceSpanLink[];
+    childCount: number;
+    errorChildCount: number;
+    children: TraceSpanNode[];
+}
+export interface TraceSpanEvent {
+    timeUnixNano: string;
+    offsetMs: number;
+    name: string;
+    attributes: Record<string, unknown>;
+}
+export interface TraceSpanLink {
+    traceId?: string;
+    spanId?: string;
+    traceState?: string;
+    attributes: Record<string, unknown>;
+}
+export type StatusBucket = 'ok' | 'redirect' | 'client-error' | 'server-error' | 'unknown';
+interface TraceRecord {
+    traceId: string;
+    spans: Map<string, NormalizedSpan>;
+    revision: number;
+    updatedAt: number;
+    summaryCache?: {
+        revision: number;
+        summaries: TraceSummary[];
+        leanSummaries: TraceSummary[];
+    };
+    detailCache?: {
+        revision: number;
+        detail: TraceDetail;
+    };
+}
+export declare class TraceStore {
+    private readonly maxTraces;
+    private readonly traces;
+    private revision;
+    private lastIngestAt;
+    constructor(maxTraces?: number);
+    ingest(spans: NormalizedSpan[]): void;
+    listTraces(): TraceSummary[];
+    listTraceSummaries(options?: {
+        lean?: boolean;
+    }): TraceSummary[];
+    getTrace(traceId: string): TraceDetail | undefined;
+    clear(): void;
+    getStats(): {
+        traceCount: number;
+        lastIngestAt: string | undefined;
+    };
+    private enforceRetention;
+}
+export declare function summarizeTrace(trace: TraceRecord): TraceSummary[];
+export declare function pickRequestRoot(spans: NormalizedSpan[]): NormalizedSpan;
+export declare function isNoiseOnlyTrace(spans: NormalizedSpan[]): boolean;
+export declare function statusBucket(statusCode?: number): StatusBucket;
+export declare function routeLabel(summary: RequestSpanSummary): string;
+export {};