@astroscope/node 1.0.0

package/dist/prepare-Be2GgRyf.js

@@ -0,0 +1,390 @@
+import { t as emit } from "./events-CgoM3Fvu.js";
+import { t as getLogStore } from "./store-BIUF4lqk.js";
+import { n as log, t as generateReqId } from "./log-CSJlKaxY.js";
+import fs from "node:fs";
+import { SpanKind, SpanStatusCode, ValueType, context, isSpanContextValid, metrics, propagation, trace } from "@opentelemetry/api";
+import pino from "pino";
+import { createMatcher } from "@entwico/dash/match";
+//#region src/lifecycle/lifecycle.ts
+async function runStartup(boot, context) {
+	await emit("beforeOnStartup", context);
+	await boot.onStartup?.(context);
+	await emit("afterOnStartup", context);
+}
+async function runShutdown(boot, context) {
+	try {
+		await emit("beforeOnShutdown", context);
+		await boot.onShutdown?.(context);
+	} finally {
+		await emit("afterOnShutdown", context);
+	}
+}
+//#endregion
+//#region src/observability/telemetry/metrics.ts
+const LIB_NAME$1 = "@astroscope/node";
+let httpRequestDuration = null;
+let httpActiveRequests = null;
+let actionDuration = null;
+function getHttpRequestDuration() {
+	return httpRequestDuration ??= metrics.getMeter(LIB_NAME$1).createHistogram("http.server.request.duration", {
+		description: "Duration of HTTP server requests",
+		unit: "s",
+		valueType: ValueType.DOUBLE
+	});
+}
+function getHttpActiveRequests() {
+	return httpActiveRequests ??= metrics.getMeter(LIB_NAME$1).createUpDownCounter("http.server.active_requests", {
+		description: "Number of active HTTP server requests",
+		unit: "{request}",
+		valueType: ValueType.INT
+	});
+}
+function getActionDuration() {
+	return actionDuration ??= metrics.getMeter(LIB_NAME$1).createHistogram("astro.action.duration", {
+		description: "Duration of Astro action executions",
+		unit: "s",
+		valueType: ValueType.DOUBLE
+	});
+}
+/**
+* Record the start of an HTTP request. Returns a function to call when the
+* request ends. Route is unknown at the native-handler level, so active
+* requests carry only the method.
+*/
+function recordHttpRequestStart(method) {
+	getHttpActiveRequests().add(1, { "http.request.method": method });
+	return () => {
+		getHttpActiveRequests().add(-1, { "http.request.method": method });
+	};
+}
+function recordHttpRequestDuration(attributes, durationMs) {
+	getHttpRequestDuration().record(durationMs / 1e3, {
+		"http.request.method": attributes.method,
+		"http.route": attributes.route ?? "",
+		"http.response.status_code": attributes.status
+	});
+}
+function recordActionDuration(attributes, durationMs) {
+	getActionDuration().record(durationMs / 1e3, {
+		"astro.action.name": attributes.name,
+		"http.response.status_code": attributes.status
+	});
+}
+//#endregion
+//#region src/observability/instrument.ts
+const LIB_NAME = "@astroscope/node";
+const ACTIONS_PREFIX = "/_actions/";
+const REQUEST_ID_PATTERN = /^[\w.-]{1,64}$/;
+const roundTime = (n) => Math.round(n * 100) / 100;
+function getClientIp(req) {
+	const forwarded = req.headers["x-forwarded-for"];
+	return (Array.isArray(forwarded) ? forwarded[0] : forwarded)?.split(",")[0]?.trim() ?? req.headers["x-real-ip"] ?? req.headers["cf-connecting-ip"];
+}
+function resolveReqId(req) {
+	const incoming = req.headers["x-request-id"];
+	const value = Array.isArray(incoming) ? incoming[0] : incoming;
+	return value && REQUEST_ID_PATTERN.test(value) ? value : generateReqId();
+}
+function chunkSize(chunk) {
+	if (chunk == null) return 0;
+	if (ArrayBuffer.isView(chunk)) return chunk.byteLength;
+	if (typeof chunk === "string") return Buffer.byteLength(chunk);
+	return 0;
+}
+/**
+* Wraps the native request/response with logging and telemetry: a request
+* logger in async context (real status, response size, aborted-vs-completed
+* on `finish`/`close`), a SERVER span with propagation extraction, and
+* request metrics. Both concerns honor their own exclude patterns; when both
+* are excluded the request passes through untouched.
+*/
+function createRequestInstrumentation(config) {
+	const tracer = trace.getTracer(LIB_NAME);
+	const store = getLogStore();
+	const loggingExcluded = config.logging ? createMatcher(config.logging.exclude) : () => true;
+	const telemetryExcluded = config.telemetry ? createMatcher(config.telemetry.exclude) : () => true;
+	return (req, res, inner) => {
+		const url = req.url ?? "";
+		const queryIndex = url.indexOf("?");
+		const pathname = queryIndex === -1 ? url : url.slice(0, queryIndex);
+		const method = req.method ?? "GET";
+		const logging = config.logging && !loggingExcluded(pathname) ? config.logging : false;
+		const telemetry = config.telemetry && !telemetryExcluded(pathname) ? config.telemetry : false;
+		if (!logging && !telemetry) {
+			inner();
+			return;
+		}
+		const startTime = performance.now();
+		const isAction = pathname.startsWith(ACTIONS_PREFIX);
+		let requestLogger;
+		if (logging && store.root) {
+			const reqId = resolveReqId(req);
+			const reqData = {
+				method,
+				url: pathname
+			};
+			if (logging.extended) {
+				reqData["query"] = queryIndex === -1 ? "" : url.slice(queryIndex + 1);
+				reqData["headers"] = req.headers;
+				reqData["remoteAddress"] = getClientIp(req) ?? req.socket.remoteAddress;
+			}
+			requestLogger = store.root.child({
+				reqId,
+				req: reqData
+			});
+			res.setHeader("x-request-id", reqId);
+		}
+		const record = {
+			logger: requestLogger,
+			url,
+			route: void 0,
+			actionName: isAction ? pathname.slice(10).replace(/\/$/, "") : void 0
+		};
+		let span;
+		let endActiveRequest;
+		if (telemetry) {
+			const parentContext = propagation.extract(context.active(), req.headers);
+			const contentLength = req.headers["content-length"];
+			const clientIp = getClientIp(req);
+			const host = req.headers["host"];
+			span = tracer.startSpan(isAction ? `ACTION ${record.actionName}` : method, {
+				kind: SpanKind.SERVER,
+				attributes: {
+					"http.request.method": method,
+					"url.path": pathname,
+					"url.query": queryIndex === -1 ? "" : url.slice(queryIndex + 1),
+					"url.scheme": "http",
+					"user_agent.original": req.headers["user-agent"] ?? "",
+					...host && { "server.address": host },
+					...contentLength && { "http.request.body.size": parseInt(contentLength) },
+					...clientIp && { "client.address": clientIp }
+				}
+			}, parentContext);
+			endActiveRequest = recordHttpRequestStart(method);
+		}
+		let responseSize = 0;
+		let firstByteTime;
+		const originalWrite = res.write.bind(res);
+		const originalEnd = res.end.bind(res);
+		res.write = ((chunk, ...rest) => {
+			firstByteTime ??= performance.now();
+			responseSize += chunkSize(chunk);
+			return originalWrite(chunk, ...rest);
+		});
+		res.end = ((chunk, ...rest) => {
+			firstByteTime ??= performance.now();
+			responseSize += chunkSize(chunk);
+			return originalEnd(chunk, ...rest);
+		});
+		let finalized = false;
+		const finalize = (aborted) => {
+			if (finalized) return;
+			finalized = true;
+			const status = res.statusCode;
+			const responseTime = performance.now() - startTime;
+			if (requestLogger) requestLogger[status >= 500 ? "error" : status >= 400 ? "warn" : "info"]({
+				res: { statusCode: status },
+				responseTime: roundTime(responseTime),
+				ttfb: roundTime((firstByteTime ?? performance.now()) - startTime),
+				responseSize,
+				...record.route && { route: record.route },
+				...aborted && { aborted: true }
+			}, aborted ? "request aborted" : "request completed");
+			if (span) {
+				span.setAttribute("http.response.status_code", status);
+				span.setAttribute("http.response.body.size", responseSize);
+				if (aborted || status >= 400) span.setStatus({
+					code: SpanStatusCode.ERROR,
+					message: aborted ? "request aborted" : `HTTP ${status}`
+				});
+				else span.setStatus({ code: SpanStatusCode.OK });
+				span.end();
+			}
+			if (telemetry) {
+				endActiveRequest?.();
+				recordHttpRequestDuration({
+					method,
+					route: record.route,
+					status
+				}, responseTime);
+				if (record.actionName) recordActionDuration({
+					name: record.actionName,
+					status
+				}, responseTime);
+			}
+		};
+		res.once("finish", () => finalize(false));
+		res.once("close", () => finalize(!res.writableFinished));
+		const run = () => store.requestStorage.run(record, inner);
+		if (span) context.with(trace.setSpan(context.active(), span), run);
+		else run();
+	};
+}
+//#endregion
+//#region src/observability/log/construct.ts
+/**
+* Compose the user mixin (if any) with platform trace correlation: when a
+* span is active, every entry carries `trace_id` / `span_id` / `trace_flags`.
+*/
+function composeMixin(userMixin) {
+	return (mergeObject, level, logger) => {
+		const user = userMixin ? userMixin(mergeObject, level, logger) : {};
+		const spanContext = trace.getActiveSpan()?.spanContext();
+		if (!spanContext || !isSpanContextValid(spanContext)) return user;
+		return {
+			...user,
+			trace_id: spanContext.traceId,
+			span_id: spanContext.spanId,
+			trace_flags: `0${spanContext.traceFlags.toString(16)}`
+		};
+	};
+}
+/**
+* Construct the root logger from the app's options seam and replay any logs
+* buffered before construction (original timestamps kept as `bufferedTime`).
+* In dev this runs once per generation; the buffer only exists the first time.
+*/
+async function constructRootLogger(factory, ctx) {
+	const store = getLogStore();
+	const options = (typeof factory === "function" ? await factory(ctx) : factory) ?? {};
+	const root = pino({
+		level: "info",
+		...options,
+		mixin: composeMixin(options.mixin)
+	});
+	store.root = root;
+	for (const entry of store.buffer.splice(0)) {
+		const bindings = entry.bindings.length ? Object.assign({}, ...entry.bindings) : {};
+		root.child({
+			...bindings,
+			bufferedTime: new Date(entry.time).toISOString()
+		})[entry.level](...entry.args);
+	}
+	if (store.dropped > 0) {
+		root.warn({ dropped: store.dropped }, "early log buffer overflowed, entries dropped");
+		store.dropped = 0;
+	}
+	return root;
+}
+/**
+* Failure path for startups that die before the logger exists: dump the
+* buffered entries to the console so no phase is silent.
+*/
+function dumpEarlyLogs() {
+	const store = getLogStore();
+	if (store.root) return;
+	for (const entry of store.buffer.splice(0)) {
+		const bindings = entry.bindings.length ? Object.assign({}, ...entry.bindings) : void 0;
+		console.error(new Date(entry.time).toISOString(), entry.level.toUpperCase(), ...bindings ? [bindings] : [], ...entry.args);
+	}
+	if (store.dropped > 0) {
+		console.error(`(${store.dropped} early log entries dropped)`);
+		store.dropped = 0;
+	}
+}
+//#endregion
+//#region src/observability/telemetry/sdk.ts
+/**
+* Platform-owned telemetry bundle: NodeSDK with undici (fetch) and node
+* runtime instrumentation, host metrics, and a Prometheus reader. Trace
+* exporters are driven by standard `OTEL_*` env vars; without any of them
+* traces stay off (no failing localhost OTLP exports).
+*
+* Guarded per process (dev restarts are in-process; a re-created NodeSDK
+* would double-register instrumentations and leak the Prometheus port).
+*/
+const TELEMETRY_KEY = Symbol.for("@astroscope/node/telemetry");
+function getHandle() {
+	return globalThis[TELEMETRY_KEY];
+}
+function defaultEnv(key, value) {
+	if (!process.env[key]) process.env[key] = value;
+}
+async function startTelemetry(options) {
+	const g = globalThis;
+	if (g[TELEMETRY_KEY]) return;
+	if (process.env["OTEL_SDK_DISABLED"] === "true") {
+		log.debug("telemetry disabled via OTEL_SDK_DISABLED");
+		return;
+	}
+	if (!process.env["OTEL_EXPORTER_OTLP_ENDPOINT"] && !process.env["OTEL_EXPORTER_OTLP_TRACES_ENDPOINT"]) defaultEnv("OTEL_TRACES_EXPORTER", "none");
+	defaultEnv("OTEL_METRICS_EXPORTER", "none");
+	defaultEnv("OTEL_LOGS_EXPORTER", "none");
+	const [{ NodeSDK }, { UndiciInstrumentation }, { RuntimeNodeInstrumentation }, { PrometheusExporter }, { HostMetrics }] = await Promise.all([
+		import("@opentelemetry/sdk-node"),
+		import("@opentelemetry/instrumentation-undici"),
+		import("@opentelemetry/instrumentation-runtime-node"),
+		import("@opentelemetry/exporter-prometheus"),
+		import("@opentelemetry/host-metrics")
+	]);
+	const prometheus = options.prometheus ? {
+		host: process.env["OTEL_EXPORTER_PROMETHEUS_HOST"] ?? options.prometheus.host ?? "0.0.0.0",
+		port: process.env["OTEL_EXPORTER_PROMETHEUS_PORT"] ? Number(process.env["OTEL_EXPORTER_PROMETHEUS_PORT"]) : options.prometheus.port ?? 9464
+	} : false;
+	const sdk = new NodeSDK({
+		instrumentations: [new UndiciInstrumentation(), new RuntimeNodeInstrumentation()],
+		...prometheus && { metricReaders: [new PrometheusExporter(prometheus)] }
+	});
+	sdk.start();
+	new HostMetrics().start();
+	g[TELEMETRY_KEY] = { shutdown: () => sdk.shutdown() };
+	if (prometheus) log.debug({
+		host: prometheus.host,
+		port: prometheus.port
+	}, "prometheus metrics listening");
+}
+/**
+* Flush and shut the SDK down. Prod-only (dev keeps the SDK for the process
+* lifetime across generations).
+*/
+async function shutdownTelemetry() {
+	const handle = getHandle();
+	if (!handle) return;
+	delete globalThis[TELEMETRY_KEY];
+	await handle.shutdown();
+}
+//#endregion
+//#region src/platform/env.ts
+/**
+* Platform env loading (position −1, before the config seam):
+* `CONFIG_PATH` → `./.env` → none. Existing process env vars win
+*/
+function loadEnvFiles() {
+	const configPath = process.env["CONFIG_PATH"];
+	if (configPath) {
+		process.loadEnvFile(configPath);
+		log.debug({ path: configPath }, "loaded env file from CONFIG_PATH");
+		return;
+	}
+	if (fs.existsSync(".env")) {
+		process.loadEnvFile(".env");
+		log.debug({ path: ".env" }, "loaded env file");
+		return;
+	}
+	log.debug("no env file loaded");
+}
+//#endregion
+//#region src/platform/prepare.ts
+const INSTRUMENTATION_KEY = Symbol.for("@astroscope/node/instrumentation");
+/**
+* The platform sequence in front of the boot lifecycle:
+* env → config → instrumentation (platform SDK + `register`, once per
+* process) → logger construction (after instrumentation, so entries carry
+* trace correlation). Prod runs it once in `startServer()`; dev re-runs it
+* per generation with the once-per-process parts guarded.
+*/
+async function preparePlatform(options) {
+	loadEnvFiles();
+	await options.seams.config?.();
+	const g = globalThis;
+	if (!g[INSTRUMENTATION_KEY]) {
+		g[INSTRUMENTATION_KEY] = true;
+		if (options.telemetry) await startTelemetry(options.telemetry);
+		await (await options.seams.instrumentation?.())?.register?.({ dev: options.dev });
+	}
+	await constructRootLogger((await options.seams.log?.())?.default, { dev: options.dev });
+}
+//#endregion
+export { runShutdown as a, createRequestInstrumentation as i, shutdownTelemetry as n, runStartup as o, dumpEarlyLogs as r, preparePlatform as t };
+
+//# sourceMappingURL=prepare-Be2GgRyf.js.map

package/dist/prepare-Be2GgRyf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-Be2GgRyf.js","names":["LIB_NAME"],"sources":["../src/lifecycle/lifecycle.ts","../src/observability/telemetry/metrics.ts","../src/observability/instrument.ts","../src/observability/log/construct.ts","../src/observability/telemetry/sdk.ts","../src/platform/env.ts","../src/platform/prepare.ts"],"sourcesContent":["import { emit } from './events.js';\nimport type { BootContext } from './types.js';\n\nexport interface BootModule {\n  onStartup?: ((context: BootContext) => Promise<void> | void) | undefined;\n  onShutdown?: ((context: BootContext) => Promise<void> | void) | undefined;\n}\n\nexport async function runStartup(boot: BootModule, context: BootContext): Promise<void> {\n  await emit('beforeOnStartup', context);\n  await boot.onStartup?.(context);\n  await emit('afterOnStartup', context);\n}\n\nexport async function runShutdown(boot: BootModule, context: BootContext): Promise<void> {\n  try {\n    await emit('beforeOnShutdown', context);\n    await boot.onShutdown?.(context);\n  } finally {\n    await emit('afterOnShutdown', context);\n  }\n}\n","import { type Histogram, type UpDownCounter, ValueType, metrics } from '@opentelemetry/api';\n\nconst LIB_NAME = '@astroscope/node';\n\n// lazy initialization so instruments bind to the SDK meter provider\nlet httpRequestDuration: Histogram | null = null;\nlet httpActiveRequests: UpDownCounter | null = null;\nlet actionDuration: Histogram | null = null;\n\nfunction getHttpRequestDuration(): Histogram {\n  return (httpRequestDuration ??= metrics.getMeter(LIB_NAME).createHistogram('http.server.request.duration', {\n    description: 'Duration of HTTP server requests',\n    unit: 's',\n    valueType: ValueType.DOUBLE,\n  }));\n}\n\nfunction getHttpActiveRequests(): UpDownCounter {\n  return (httpActiveRequests ??= metrics.getMeter(LIB_NAME).createUpDownCounter('http.server.active_requests', {\n    description: 'Number of active HTTP server requests',\n    unit: '{request}',\n    valueType: ValueType.INT,\n  }));\n}\n\nfunction getActionDuration(): Histogram {\n  return (actionDuration ??= metrics.getMeter(LIB_NAME).createHistogram('astro.action.duration', {\n    description: 'Duration of Astro action executions',\n    unit: 's',\n    valueType: ValueType.DOUBLE,\n  }));\n}\n\n/**\n * Record the start of an HTTP request. Returns a function to call when the\n * request ends. Route is unknown at the native-handler level, so active\n * requests carry only the method.\n */\nexport function recordHttpRequestStart(method: string): () => void {\n  getHttpActiveRequests().add(1, { 'http.request.method': method });\n\n  return () => {\n    getHttpActiveRequests().add(-1, { 'http.request.method': method });\n  };\n}\n\nexport function recordHttpRequestDuration(\n  attributes: { method: string; route: string | undefined; status: number },\n  durationMs: number,\n): void {\n  getHttpRequestDuration().record(durationMs / 1000, {\n    'http.request.method': attributes.method,\n    'http.route': attributes.route ?? '',\n    'http.response.status_code': attributes.status,\n  });\n}\n\nexport function recordActionDuration(attributes: { name: string; status: number }, durationMs: number): void {\n  getActionDuration().record(durationMs / 1000, {\n    'astro.action.name': attributes.name,\n    'http.response.status_code': attributes.status,\n  });\n}\n","import type { IncomingMessage, ServerResponse } from 'node:http';\nimport { createMatcher } from '@entwico/dash/match';\nimport { SpanKind, SpanStatusCode, context, propagation, trace } from '@opentelemetry/api';\nimport type { Logger } from 'pino';\nimport type { ExcludePattern } from '../excludes/excludes.js';\nimport { generateReqId } from './log/index.js';\nimport { type RequestRecord, getLogStore } from './log/store.js';\nimport { recordActionDuration, recordHttpRequestDuration, recordHttpRequestStart } from './telemetry/metrics.js';\n\nconst LIB_NAME = '@astroscope/node';\nconst ACTIONS_PREFIX = '/_actions/';\nconst REQUEST_ID_PATTERN = /^[\\w.-]{1,64}$/;\n\nconst roundTime = (n: number) => Math.round(n * 100) / 100;\n\nexport interface RequestLoggingConfig {\n  exclude: ExcludePattern[];\n  extended: boolean;\n}\n\nexport interface RequestTelemetryConfig {\n  exclude: ExcludePattern[];\n}\n\nexport interface RequestInstrumentationConfig {\n  logging: RequestLoggingConfig | false;\n  telemetry: RequestTelemetryConfig | false;\n}\n\nfunction getClientIp(req: IncomingMessage): string | undefined {\n  const forwarded = req.headers['x-forwarded-for'];\n  const first = Array.isArray(forwarded) ? forwarded[0] : forwarded;\n\n  return (\n    first?.split(',')[0]?.trim() ??\n    (req.headers['x-real-ip'] as string | undefined) ??\n    (req.headers['cf-connecting-ip'] as string | undefined)\n  );\n}\n\nfunction resolveReqId(req: IncomingMessage): string {\n  const incoming = req.headers['x-request-id'];\n  const value = Array.isArray(incoming) ? incoming[0] : incoming;\n\n  return value && REQUEST_ID_PATTERN.test(value) ? value : generateReqId();\n}\n\nfunction chunkSize(chunk: unknown): number {\n  if (chunk == null) return 0;\n  if (ArrayBuffer.isView(chunk)) return chunk.byteLength;\n  if (typeof chunk === 'string') return Buffer.byteLength(chunk);\n\n  return 0;\n}\n\n/**\n * Wraps the native request/response with logging and telemetry: a request\n * logger in async context (real status, response size, aborted-vs-completed\n * on `finish`/`close`), a SERVER span with propagation extraction, and\n * request metrics. Both concerns honor their own exclude patterns; when both\n * are excluded the request passes through untouched.\n */\nexport function createRequestInstrumentation(config: RequestInstrumentationConfig) {\n  const tracer = trace.getTracer(LIB_NAME);\n  const store = getLogStore();\n  const loggingExcluded = config.logging ? createMatcher(config.logging.exclude) : () => true;\n  const telemetryExcluded = config.telemetry ? createMatcher(config.telemetry.exclude) : () => true;\n\n  return (req: IncomingMessage, res: ServerResponse, inner: () => void): void => {\n    const url = req.url ?? '';\n    const queryIndex = url.indexOf('?');\n    const pathname = queryIndex === -1 ? url : url.slice(0, queryIndex);\n    const method = req.method ?? 'GET';\n\n    const logging = config.logging && !loggingExcluded(pathname) ? config.logging : false;\n    const telemetry = config.telemetry && !telemetryExcluded(pathname) ? config.telemetry : false;\n\n    if (!logging && !telemetry) {\n      inner();\n\n      return;\n    }\n\n    const startTime = performance.now();\n    const isAction = pathname.startsWith(ACTIONS_PREFIX);\n\n    let requestLogger: Logger | undefined;\n\n    if (logging && store.root) {\n      const reqId = resolveReqId(req);\n      const reqData: Record<string, unknown> = { method, url: pathname };\n\n      // extended logging includes potentially sensitive data\n      if (logging.extended) {\n        reqData['query'] = queryIndex === -1 ? '' : url.slice(queryIndex + 1);\n        reqData['headers'] = req.headers;\n        reqData['remoteAddress'] = getClientIp(req) ?? req.socket.remoteAddress;\n      }\n\n      requestLogger = store.root.child({ reqId, req: reqData });\n\n      res.setHeader('x-request-id', reqId);\n    }\n\n    const record: RequestRecord = {\n      logger: requestLogger,\n      url,\n      route: undefined,\n      actionName: isAction ? pathname.slice(ACTIONS_PREFIX.length).replace(/\\/$/, '') : undefined,\n    };\n\n    let span: ReturnType<typeof tracer.startSpan> | undefined;\n    let endActiveRequest: (() => void) | undefined;\n\n    if (telemetry) {\n      const parentContext = propagation.extract(context.active(), req.headers);\n      const contentLength = req.headers['content-length'];\n      const clientIp = getClientIp(req);\n      const host = req.headers['host'];\n\n      span = tracer.startSpan(\n        isAction ? `ACTION ${record.actionName}` : method,\n        {\n          kind: SpanKind.SERVER,\n          attributes: {\n            'http.request.method': method,\n            'url.path': pathname,\n            'url.query': queryIndex === -1 ? '' : url.slice(queryIndex + 1),\n            'url.scheme': 'http',\n            'user_agent.original': req.headers['user-agent'] ?? '',\n            ...(host && { 'server.address': host }),\n            ...(contentLength && { 'http.request.body.size': parseInt(contentLength) }),\n            ...(clientIp && { 'client.address': clientIp }),\n          },\n        },\n        parentContext,\n      );\n\n      endActiveRequest = recordHttpRequestStart(method);\n    }\n\n    let responseSize = 0;\n    let firstByteTime: number | undefined;\n\n    const originalWrite = res.write.bind(res);\n    const originalEnd = res.end.bind(res);\n\n    res.write = ((chunk: unknown, ...rest: unknown[]) => {\n      firstByteTime ??= performance.now();\n      responseSize += chunkSize(chunk);\n\n      return (originalWrite as (...args: unknown[]) => boolean)(chunk, ...rest);\n    }) as typeof res.write;\n\n    res.end = ((chunk: unknown, ...rest: unknown[]) => {\n      firstByteTime ??= performance.now();\n      responseSize += chunkSize(chunk);\n\n      return (originalEnd as (...args: unknown[]) => ServerResponse)(chunk, ...rest);\n    }) as typeof res.end;\n\n    let finalized = false;\n\n    const finalize = (aborted: boolean): void => {\n      if (finalized) return;\n\n      finalized = true;\n\n      const status = res.statusCode;\n      const responseTime = performance.now() - startTime;\n\n      if (requestLogger) {\n        const level = status >= 500 ? 'error' : status >= 400 ? 'warn' : 'info';\n\n        requestLogger[level](\n          {\n            res: { statusCode: status },\n            responseTime: roundTime(responseTime),\n            ttfb: roundTime((firstByteTime ?? performance.now()) - startTime),\n            responseSize,\n            ...(record.route && { route: record.route }),\n            ...(aborted && { aborted: true }),\n          },\n          aborted ? 'request aborted' : 'request completed',\n        );\n      }\n\n      if (span) {\n        span.setAttribute('http.response.status_code', status);\n        span.setAttribute('http.response.body.size', responseSize);\n\n        if (aborted || status >= 400) {\n          span.setStatus({ code: SpanStatusCode.ERROR, message: aborted ? 'request aborted' : `HTTP ${status}` });\n        } else {\n          span.setStatus({ code: SpanStatusCode.OK });\n        }\n\n        span.end();\n      }\n\n      if (telemetry) {\n        endActiveRequest?.();\n        recordHttpRequestDuration({ method, route: record.route, status }, responseTime);\n\n        if (record.actionName) {\n          recordActionDuration({ name: record.actionName, status }, responseTime);\n        }\n      }\n    };\n\n    res.once('finish', () => finalize(false));\n    res.once('close', () => finalize(!res.writableFinished));\n\n    const run = (): void => store.requestStorage.run(record, inner);\n\n    if (span) {\n      context.with(trace.setSpan(context.active(), span), run);\n    } else {\n      run();\n    }\n  };\n}\n","import { isSpanContextValid, trace } from '@opentelemetry/api';\nimport pino, { type Bindings, type Logger, type LoggerOptions } from 'pino';\nimport { getLogStore } from './store.js';\n\n/**\n * Contract of the `src/log.ts` entry seam: pino logger options, or a factory\n * producing them. Never a logger instance — the platform constructs the\n * logger itself (after instrumentation, so trace correlation works).\n */\nexport type LoggerOptionsFactory = LoggerOptions | ((ctx: { dev: boolean }) => LoggerOptions | Promise<LoggerOptions>);\n\n/**\n * Compose the user mixin (if any) with platform trace correlation: when a\n * span is active, every entry carries `trace_id` / `span_id` / `trace_flags`.\n */\nfunction composeMixin(userMixin: LoggerOptions['mixin']): NonNullable<LoggerOptions['mixin']> {\n  return (mergeObject, level, logger) => {\n    const user = userMixin ? userMixin(mergeObject, level, logger) : {};\n    const spanContext = trace.getActiveSpan()?.spanContext();\n\n    if (!spanContext || !isSpanContextValid(spanContext)) return user;\n\n    return {\n      ...user,\n      trace_id: spanContext.traceId,\n      span_id: spanContext.spanId,\n      trace_flags: `0${spanContext.traceFlags.toString(16)}`,\n    };\n  };\n}\n\n/**\n * Construct the root logger from the app's options seam and replay any logs\n * buffered before construction (original timestamps kept as `bufferedTime`).\n * In dev this runs once per generation; the buffer only exists the first time.\n */\nexport async function constructRootLogger(\n  factory: LoggerOptionsFactory | undefined,\n  ctx: { dev: boolean },\n): Promise<Logger> {\n  const store = getLogStore();\n  const options = (typeof factory === 'function' ? await factory(ctx) : factory) ?? {};\n  const root = pino({ level: 'info', ...options, mixin: composeMixin(options.mixin) });\n\n  store.root = root;\n\n  for (const entry of store.buffer.splice(0)) {\n    const bindings = entry.bindings.length ? (Object.assign({}, ...entry.bindings) as Bindings) : {};\n    const target = root.child({ ...bindings, bufferedTime: new Date(entry.time).toISOString() });\n\n    (target[entry.level] as (...args: unknown[]) => void)(...entry.args);\n  }\n\n  if (store.dropped > 0) {\n    root.warn({ dropped: store.dropped }, 'early log buffer overflowed, entries dropped');\n    store.dropped = 0;\n  }\n\n  return root;\n}\n\n/**\n * Failure path for startups that die before the logger exists: dump the\n * buffered entries to the console so no phase is silent.\n */\nexport function dumpEarlyLogs(): void {\n  const store = getLogStore();\n\n  if (store.root) return;\n\n  for (const entry of store.buffer.splice(0)) {\n    const bindings = entry.bindings.length ? Object.assign({}, ...entry.bindings) : undefined;\n\n    console.error(\n      new Date(entry.time).toISOString(),\n      entry.level.toUpperCase(),\n      ...(bindings ? [bindings] : []),\n      ...entry.args,\n    );\n  }\n\n  if (store.dropped > 0) {\n    console.error(`(${store.dropped} early log entries dropped)`);\n    store.dropped = 0;\n  }\n}\n","import { log } from '../log/index.js';\n\n/**\n * Platform-owned telemetry bundle: NodeSDK with undici (fetch) and node\n * runtime instrumentation, host metrics, and a Prometheus reader. Trace\n * exporters are driven by standard `OTEL_*` env vars; without any of them\n * traces stay off (no failing localhost OTLP exports).\n *\n * Guarded per process (dev restarts are in-process; a re-created NodeSDK\n * would double-register instrumentations and leak the Prometheus port).\n */\n\nconst TELEMETRY_KEY = Symbol.for('@astroscope/node/telemetry');\n\ninterface TelemetryHandle {\n  shutdown: () => Promise<void>;\n}\n\nexport interface TelemetrySdkOptions {\n  prometheus: { host?: string | undefined; port?: number | undefined } | false;\n}\n\nfunction getHandle(): TelemetryHandle | undefined {\n  return (globalThis as Record<symbol, unknown>)[TELEMETRY_KEY] as TelemetryHandle | undefined;\n}\n\nfunction defaultEnv(key: string, value: string): void {\n  if (!process.env[key]) process.env[key] = value;\n}\n\nexport async function startTelemetry(options: TelemetrySdkOptions): Promise<void> {\n  const g = globalThis as Record<symbol, unknown>;\n\n  if (g[TELEMETRY_KEY]) return;\n\n  if (process.env['OTEL_SDK_DISABLED'] === 'true') {\n    log.debug('telemetry disabled via OTEL_SDK_DISABLED');\n\n    return;\n  }\n\n  // without an explicitly configured exporter target, exporting traces to the\n  // default localhost OTLP endpoint would fail on every flush\n  if (!process.env['OTEL_EXPORTER_OTLP_ENDPOINT'] && !process.env['OTEL_EXPORTER_OTLP_TRACES_ENDPOINT']) {\n    defaultEnv('OTEL_TRACES_EXPORTER', 'none');\n  }\n\n  defaultEnv('OTEL_METRICS_EXPORTER', 'none');\n  defaultEnv('OTEL_LOGS_EXPORTER', 'none');\n\n  const [\n    { NodeSDK },\n    { UndiciInstrumentation },\n    { RuntimeNodeInstrumentation },\n    { PrometheusExporter },\n    { HostMetrics },\n  ] = await Promise.all([\n    import('@opentelemetry/sdk-node'),\n    import('@opentelemetry/instrumentation-undici'),\n    import('@opentelemetry/instrumentation-runtime-node'),\n    import('@opentelemetry/exporter-prometheus'),\n    import('@opentelemetry/host-metrics'),\n  ]);\n\n  const prometheus = options.prometheus\n    ? {\n        host: process.env['OTEL_EXPORTER_PROMETHEUS_HOST'] ?? options.prometheus.host ?? '0.0.0.0',\n        port: process.env['OTEL_EXPORTER_PROMETHEUS_PORT']\n          ? Number(process.env['OTEL_EXPORTER_PROMETHEUS_PORT'])\n          : (options.prometheus.port ?? 9464),\n      }\n    : false;\n\n  const sdk = new NodeSDK({\n    instrumentations: [new UndiciInstrumentation(), new RuntimeNodeInstrumentation()],\n    ...(prometheus && { metricReaders: [new PrometheusExporter(prometheus)] }),\n  });\n\n  sdk.start();\n\n  const hostMetrics = new HostMetrics();\n\n  hostMetrics.start();\n\n  g[TELEMETRY_KEY] = {\n    shutdown: () => sdk.shutdown(),\n  } satisfies TelemetryHandle;\n\n  if (prometheus) {\n    log.debug({ host: prometheus.host, port: prometheus.port }, 'prometheus metrics listening');\n  }\n}\n\n/**\n * Flush and shut the SDK down. Prod-only (dev keeps the SDK for the process\n * lifetime across generations).\n */\nexport async function shutdownTelemetry(): Promise<void> {\n  const handle = getHandle();\n\n  if (!handle) return;\n\n  delete (globalThis as Record<symbol, unknown>)[TELEMETRY_KEY];\n\n  await handle.shutdown();\n}\n","import fs from 'node:fs';\nimport { log } from '../observability/log/index.js';\n\n/**\n * Platform env loading (position −1, before the config seam):\n * `CONFIG_PATH` → `./.env` → none. Existing process env vars win\n */\nexport function loadEnvFiles(): void {\n  const configPath = process.env['CONFIG_PATH'];\n\n  if (configPath) {\n    process.loadEnvFile(configPath);\n\n    log.debug({ path: configPath }, 'loaded env file from CONFIG_PATH');\n\n    return;\n  }\n\n  if (fs.existsSync('.env')) {\n    process.loadEnvFile('.env');\n    log.debug({ path: '.env' }, 'loaded env file');\n\n    return;\n  }\n\n  log.debug('no env file loaded');\n}\n","import { type LoggerOptionsFactory, constructRootLogger } from '../observability/log/construct.js';\nimport { type TelemetrySdkOptions, startTelemetry } from '../observability/telemetry/sdk.js';\nimport { loadEnvFiles } from './env.js';\n\nconst INSTRUMENTATION_KEY = Symbol.for('@astroscope/node/instrumentation');\n\nexport interface InstrumentationContext {\n  dev: boolean;\n}\n\ninterface InstrumentationSeam {\n  register?: ((ctx: InstrumentationContext) => void | Promise<void>) | undefined;\n}\n\ninterface LogSeam {\n  default?: LoggerOptionsFactory | undefined;\n}\n\nexport interface PlatformSeams {\n  /** `src/config.ts` — validation runs at import; a throw fails the startup */\n  config?: (() => Promise<unknown>) | undefined;\n  /** `src/instrumentation.ts` — extra instrumentation, once per process */\n  instrumentation?: (() => Promise<InstrumentationSeam>) | undefined;\n  /** `src/log.ts` — pino logger options (or a factory), never an instance */\n  log?: (() => Promise<LogSeam>) | undefined;\n}\n\nexport interface PreparePlatformOptions {\n  dev: boolean;\n  telemetry: TelemetrySdkOptions | false;\n  seams: PlatformSeams;\n}\n\n/**\n * The platform sequence in front of the boot lifecycle:\n * env → config → instrumentation (platform SDK + `register`, once per\n * process) → logger construction (after instrumentation, so entries carry\n * trace correlation). Prod runs it once in `startServer()`; dev re-runs it\n * per generation with the once-per-process parts guarded.\n */\nexport async function preparePlatform(options: PreparePlatformOptions): Promise<void> {\n  loadEnvFiles();\n\n  await options.seams.config?.();\n\n  const g = globalThis as Record<symbol, unknown>;\n\n  if (!g[INSTRUMENTATION_KEY]) {\n    g[INSTRUMENTATION_KEY] = true;\n\n    if (options.telemetry) {\n      await startTelemetry(options.telemetry);\n    }\n\n    const instrumentation = await options.seams.instrumentation?.();\n\n    await instrumentation?.register?.({ dev: options.dev });\n  }\n\n  const logSeam = await options.seams.log?.();\n\n  await constructRootLogger(logSeam?.default, { dev: options.dev });\n}\n"],"mappings":"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"}

package/dist/preview.d.ts

@@ -0,0 +1,12 @@
+import { CreatePreviewServer } from "astro";
+
+//#region src/server/preview.d.ts
+/**
+ * `astro preview` support: imports the built server entry with autostart
+ * disabled and starts it on the preview host/port. The full production path
+ * runs — boot lifecycle, warmup, health probes, static serving.
+ */
+declare const createPreviewServer: CreatePreviewServer;
+//#endregion
+export { createPreviewServer as default };
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","names":[],"sources":["../src/server/preview.ts"],"mappings":";;;;;AAAiD;;;cAQ3C,mBAAA,EAAqB,mBAe1B"}

package/dist/preview.js

@@ -0,0 +1,23 @@
+//#region src/server/preview.ts
+/**
+* `astro preview` support: imports the built server entry with autostart
+* disabled and starts it on the preview host/port. The full production path
+* runs — boot lifecycle, warmup, health probes, static serving.
+*/
+const createPreviewServer = async ({ serverEntrypoint, host, port }) => {
+	process.env["ASTROSCOPE_NODE_AUTOSTART"] = "disabled";
+	const handle = await (await import(serverEntrypoint.href)).startServer({
+		host,
+		port
+	});
+	return {
+		host: handle.host,
+		port: handle.port,
+		stop: () => handle.stop(),
+		closed: () => handle.closed()
+	};
+};
+//#endregion
+export { createPreviewServer as default };
+
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","names":[],"sources":["../src/server/preview.ts"],"sourcesContent":["import type { CreatePreviewServer } from 'astro';\nimport type { ServerHandle } from './server.js';\n\n/**\n * `astro preview` support: imports the built server entry with autostart\n * disabled and starts it on the preview host/port. The full production path\n * runs — boot lifecycle, warmup, health probes, static serving.\n */\nconst createPreviewServer: CreatePreviewServer = async ({ serverEntrypoint, host, port }) => {\n  process.env['ASTROSCOPE_NODE_AUTOSTART'] = 'disabled';\n\n  const entry = (await import(serverEntrypoint.href)) as {\n    startServer: (overrides?: { host?: string | undefined; port?: number | undefined }) => Promise<ServerHandle>;\n  };\n\n  const handle = await entry.startServer({ host, port });\n\n  return {\n    host: handle.host,\n    port: handle.port,\n    stop: () => handle.stop(),\n    closed: () => handle.closed(),\n  };\n};\n\nexport default createPreviewServer;\n"],"mappings":";;;;;;AAQA,MAAM,sBAA2C,OAAO,EAAE,kBAAkB,MAAM,WAAW;CAC3F,QAAQ,IAAI,+BAA+B;CAM3C,MAAM,SAAS,OAAM,MAJA,OAAO,iBAAiB,MAAA,CAIlB,YAAY;EAAE;EAAM;CAAK,CAAC;CAErD,OAAO;EACL,MAAM,OAAO;EACb,MAAM,OAAO;EACb,YAAY,OAAO,KAAK;EACxB,cAAc,OAAO,OAAO;CAC9B;AACF"}

package/dist/restart-page.html

@@ -0,0 +1,107 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>Restarting…</title>
+    <style>
+      html,
+      body {
+        height: 100%;
+        margin: 0;
+        font:
+          14px system-ui,
+          sans-serif;
+        background: #0b0d10;
+        color: #a8b1bd;
+      }
+
+      .center {
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        height: 100%;
+        flex-direction: column;
+        gap: 12px;
+        padding: 0 24px;
+        box-sizing: border-box;
+      }
+
+      .message {
+        font-size: 18px;
+      }
+
+      .error-title {
+        color: #ff6b6b;
+        font-size: 18px;
+        font-weight: 600;
+      }
+
+      .error-body {
+        max-width: 800px;
+        white-space: pre-wrap;
+        font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+        font-size: 13px;
+        background: #15181d;
+        border: 1px solid #2a2f37;
+        border-radius: 6px;
+        padding: 12px 16px;
+        overflow: auto;
+        max-height: 60vh;
+      }
+
+      .hint {
+        color: #6b7480;
+        font-size: 12px;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="root" class="center">
+      <p class="message">Reloading dev server…</p>
+    </div>
+
+    <script>
+      const root = document.getElementById('root');
+      const url = new URL(location.href);
+
+      function showError(message) {
+        document.title = 'Boot failed';
+        root.innerHTML = '';
+
+        const title = document.createElement('p');
+        title.className = 'error-title';
+        title.textContent = 'Boot failed';
+
+        const body = document.createElement('pre');
+        body.className = 'error-body';
+        body.textContent = message;
+
+        const hint = document.createElement('p');
+        hint.className = 'hint';
+        hint.textContent = 'Fix the error and save — this page will reload automatically.';
+
+        root.append(title, body, hint);
+      }
+
+      (async () => {
+        for (;;) {
+          try {
+            const r = await fetch('/__astroscope_boot_ready', { cache: 'no-store' });
+
+            if (r.ok) {
+              location.replace(url.toString());
+              return;
+            }
+
+            if (r.status === 503) {
+              const { error } = await r.json().catch(() => ({ error: 'Unknown error' }));
+              showError(error);
+            }
+          } catch {}
+
+          await new Promise((r) => setTimeout(r, 100));
+        }
+      })();
+    </script>
+  </body>
+</html>

package/dist/route-middleware-entrypoint.d.ts

@@ -0,0 +1,13 @@
+import { MiddlewareHandler } from "astro";
+
+//#region src/observability/route-middleware-entrypoint.d.ts
+/**
+ * Route enrichment: the native handler starts spans and request logging
+ * before routing, so the route pattern is the one thing only astro knows.
+ * Feeds it back into the request record (final log line, metrics) and the
+ * active server span. No-op outside instrumented requests.
+ */
+declare const onRequest: MiddlewareHandler;
+//#endregion
+export { onRequest };
+//# sourceMappingURL=route-middleware-entrypoint.d.ts.map

package/dist/route-middleware-entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-middleware-entrypoint.d.ts","names":[],"sources":["../src/observability/route-middleware-entrypoint.ts"],"mappings":";;;;;AAUA;;;;cAAa,SAAA,EAAW,iBAmBvB"}

package/dist/route-middleware-entrypoint.js

@@ -0,0 +1,24 @@
+import { n as getRequestRecord } from "./store-BIUF4lqk.js";
+import { trace } from "@opentelemetry/api";
+//#region src/observability/route-middleware-entrypoint.ts
+/**
+* Route enrichment: the native handler starts spans and request logging
+* before routing, so the route pattern is the one thing only astro knows.
+* Feeds it back into the request record (final log line, metrics) and the
+* active server span. No-op outside instrumented requests.
+*/
+const onRequest = (ctx, next) => {
+	const record = getRequestRecord();
+	const route = ctx.routePattern;
+	if (record && !record.route) record.route = route;
+	const span = trace.getActiveSpan();
+	if (span?.isRecording() && route) {
+		span.setAttribute("http.route", route);
+		if (!record?.actionName) span.updateName(`${ctx.request.method} ${route}`);
+	}
+	return next();
+};
+//#endregion
+export { onRequest };
+
+//# sourceMappingURL=route-middleware-entrypoint.js.map

package/dist/route-middleware-entrypoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-middleware-entrypoint.js","names":[],"sources":["../src/observability/route-middleware-entrypoint.ts"],"sourcesContent":["import { trace } from '@opentelemetry/api';\nimport type { MiddlewareHandler } from 'astro';\nimport { getRequestRecord } from './log/store.js';\n\n/**\n * Route enrichment: the native handler starts spans and request logging\n * before routing, so the route pattern is the one thing only astro knows.\n * Feeds it back into the request record (final log line, metrics) and the\n * active server span. No-op outside instrumented requests.\n */\nexport const onRequest: MiddlewareHandler = (ctx, next) => {\n  const record = getRequestRecord();\n  const route = ctx.routePattern;\n\n  if (record && !record.route) {\n    record.route = route;\n  }\n\n  const span = trace.getActiveSpan();\n\n  if (span?.isRecording() && route) {\n    span.setAttribute('http.route', route);\n\n    if (!record?.actionName) {\n      span.updateName(`${ctx.request.method} ${route}`);\n    }\n  }\n\n  return next();\n};\n"],"mappings":";;;;;;;;;AAUA,MAAa,aAAgC,KAAK,SAAS;CACzD,MAAM,SAAS,iBAAiB;CAChC,MAAM,QAAQ,IAAI;CAElB,IAAI,UAAU,CAAC,OAAO,OACpB,OAAO,QAAQ;CAGjB,MAAM,OAAO,MAAM,cAAc;CAEjC,IAAI,MAAM,YAAY,KAAK,OAAO;EAChC,KAAK,aAAa,cAAc,KAAK;EAErC,IAAI,CAAC,QAAQ,YACX,KAAK,WAAW,GAAG,IAAI,QAAQ,OAAO,GAAG,OAAO;CAEpD;CAEA,OAAO,KAAK;AACd"}

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+//#region src/server/server.d.ts
+interface ServerHandle {
+  host: string;
+  port: number;
+  stop(): Promise<void>;
+  closed(): Promise<void>;
+}
+declare function startServer(overrides?: {
+  host?: string | undefined;
+  port?: number | undefined;
+}): Promise<ServerHandle>;
+//#endregion
+export { ServerHandle, startServer };
+//# sourceMappingURL=server.d.ts.map