@forinda/kickjs-devtools 5.2.0 → 5.2.2

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-devtools v5.2.0
+ * @forinda/kickjs-devtools v5.2.2
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,985 +8,13 @@
  *
  * @license MIT
  */
-import "reflect-metadata";
-import { Router, static as static$1 } from "express";
-import { dirname, join } from "node:path";
-import { tmpdir } from "node:os";
-import { fileURLToPath } from "node:url";
-import { createReadStream, existsSync, readFileSync, statSync, unlink } from "node:fs";
-import { randomBytes } from "node:crypto";
-import { writeHeapSnapshot } from "node:v8";
-import { METADATA, computed, createLogger, defineAdapter, getClassMeta, getMethodMeta, reactive, ref, watch } from "@forinda/kickjs";
-import { MemoryAnalyzer, PROTOCOL_VERSION, RuntimeSampler } from "@forinda/kickjs-devtools-kit";
-import { DEVTOOLS_BUS, createBusCore } from "@forinda/kickjs-devtools-kit/bus";
-import { WebSocketServer } from "ws";
-//#region src/topology.ts
-const DEFAULT_INTROSPECT_TIMEOUT_MS = 100;
-/**
-* Collect a {@link TopologySnapshot} for the given application.
-*
-* Async because plugin/adapter `introspect()` may be async; the work
-* is parallelised across all primitives so wall-clock time scales
-* with the slowest introspector, not their sum.
-*/
-async function collectTopologySnapshot(opts) {
-	const { app, container, introspectTimeoutMs = DEFAULT_INTROSPECT_TIMEOUT_MS } = opts;
-	const errors = [];
-	const plugins = await Promise.all(app.getPlugins().map((p) => snapshotFor(p, "plugin", introspectTimeoutMs, errors)));
-	const adapters = await Promise.all(app.getAdapters().map((a) => snapshotFor(a, "adapter", introspectTimeoutMs, errors)));
-	return {
-		protocolVersion: PROTOCOL_VERSION,
-		timestamp: Date.now(),
-		plugins,
-		adapters,
-		contributors: collectContributors(app),
-		diTokens: collectTokens(container),
-		errors
-	};
-}
-/**
-* Coerce one primitive into an {@link IntrospectionSnapshot}. Tries
-* the primitive's own `introspect()` first; falls back to a stub on
-* any of: missing implementation, throw, timeout, or non-object return.
-*/
-async function snapshotFor(primitive, kind, timeoutMs, errors) {
-	const name = primitive.name ?? "(unnamed)";
-	const stub = {
-		protocolVersion: PROTOCOL_VERSION,
-		name,
-		kind
-	};
-	if (typeof primitive.introspect !== "function") return stub;
-	try {
-		const result = await Promise.race([Promise.resolve(primitive.introspect()), new Promise((_, reject) => setTimeout(() => reject(/* @__PURE__ */ new Error(`introspect() timed out after ${timeoutMs}ms`)), timeoutMs))]);
-		if (result && typeof result === "object") {
-			const snap = result;
-			return {
-				protocolVersion: PROTOCOL_VERSION,
-				name: snap.name ?? name,
-				kind: snap.kind ?? kind,
-				version: snap.version,
-				state: snap.state,
-				tokens: snap.tokens,
-				metrics: snap.metrics,
-				memoryBytes: snap.memoryBytes
-			};
-		}
-		return stub;
-	} catch (err) {
-		errors.push({
-			name,
-			kind,
-			message: err instanceof Error ? err.message : String(err)
-		});
-		return stub;
-	}
-}
-/** Read DI registrations into the topology shape — drops noisy HMR tokens. */
-function collectTokens(container) {
-	return container.getRegistrations().filter((r) => !r.token.startsWith("__hmr__")).map((r) => ({
-		token: r.token,
-		scope: r.scope,
-		kind: r.kind,
-		instantiated: r.instantiated
-	}));
-}
-/**
-* Contributor enumeration. Prefers `app.getContributors()` (the
-* Application-level walk that preserves adapter / plugin / global
-* source labels) when present; falls back to walking
-* `adapter.contributors()` + `plugin.contributors()` directly for
-* older Application implementations that don't expose the helper.
-*
-* Module-level contributors are still not surfaced here — module
-* instances aren't retained post-bootstrap. Per-route enumeration
-* lands in a later iteration alongside the route detail panel.
-*/
-function collectContributors(app) {
-	const seen = /* @__PURE__ */ new Map();
-	if (typeof app.getContributors === "function") {
-		for (const c of app.getContributors()) {
-			if (seen.has(c.key)) continue;
-			const mapped = c.source === "module" ? "module" : "adapter";
-			seen.set(c.key, {
-				key: c.key,
-				source: mapped,
-				dependsOn: c.dependsOn
-			});
-		}
-		return [...seen.values()];
-	}
-	const ingest = (list, source) => {
-		if (!list) return;
-		for (const reg of list) {
-			const r = reg;
-			const key = typeof r.key === "string" ? r.key : null;
-			if (!key || seen.has(key)) continue;
-			seen.set(key, {
-				key,
-				source,
-				dependsOn: Array.isArray(r.dependsOn) ? r.dependsOn : []
-			});
-		}
-	};
-	for (const plugin of app.getPlugins()) ingest(plugin.contributors?.(), "adapter");
-	for (const adapter of app.getAdapters()) ingest(adapter.contributors?.(), "adapter");
-	return [...seen.values()];
-}
-//#endregion
-//#region src/devtools-tabs.ts
-const VALID_VIEW_TYPES = new Set([
-	"iframe",
-	"launch",
-	"html"
-]);
-/**
-* Walk every plugin + adapter, call `devtoolsTabs?()`, validate each
-* entry, and dedupe by `id`. Last-source-wins on collision is too
-* surprising — first-source-wins + a warning entry instead.
-*/
-function collectDevtoolsTabs(app) {
-	const tabs = [];
-	const seen = /* @__PURE__ */ new Map();
-	const errors = [];
-	const ingest = (sourceName, raw) => {
-		if (!Array.isArray(raw)) {
-			errors.push({
-				source: sourceName,
-				reason: "devtoolsTabs() did not return an array"
-			});
-			return;
-		}
-		for (const entry of raw) {
-			const validation = validateTab(entry);
-			if (!validation.ok) {
-				errors.push({
-					source: sourceName,
-					reason: validation.reason
-				});
-				continue;
-			}
-			const tab = validation.tab;
-			const owner = seen.get(tab.id);
-			if (owner) {
-				errors.push({
-					source: sourceName,
-					reason: `tab id '${tab.id}' already registered by ${owner} — first-source wins`
-				});
-				continue;
-			}
-			seen.set(tab.id, sourceName);
-			tabs.push(tab);
-		}
-	};
-	for (const plugin of app.getPlugins()) {
-		if (typeof plugin.devtoolsTabs !== "function") continue;
-		try {
-			ingest(plugin.name ?? "(unnamed plugin)", plugin.devtoolsTabs());
-		} catch (err) {
-			errors.push({
-				source: plugin.name ?? "(unnamed plugin)",
-				reason: err instanceof Error ? err.message : String(err)
-			});
-		}
-	}
-	for (const adapter of app.getAdapters()) {
-		if (typeof adapter.devtoolsTabs !== "function") continue;
-		try {
-			ingest(adapter.name ?? "(unnamed adapter)", adapter.devtoolsTabs());
-		} catch (err) {
-			errors.push({
-				source: adapter.name ?? "(unnamed adapter)",
-				reason: err instanceof Error ? err.message : String(err)
-			});
-		}
-	}
-	return {
-		tabs,
-		errors
-	};
-}
-/**
-* Coerce + validate a tab descriptor. Returns the typed object on
-* success; a structured reason on failure. Uses a permissive checker
-* so a partially-correct entry from a third-party adapter doesn't
-* break the whole panel.
-*/
-function validateTab(raw) {
-	if (!raw || typeof raw !== "object") return {
-		ok: false,
-		reason: "tab entry is not an object"
-	};
-	const obj = raw;
-	if (typeof obj.id !== "string" || obj.id.length === 0) return {
-		ok: false,
-		reason: "tab.id must be a non-empty string"
-	};
-	if (typeof obj.title !== "string" || obj.title.length === 0) return {
-		ok: false,
-		reason: `tab '${obj.id}': title must be a non-empty string`
-	};
-	const view = obj.view;
-	if (!view || typeof view !== "object") return {
-		ok: false,
-		reason: `tab '${obj.id}': view object is required`
-	};
-	if (typeof view.type !== "string" || !VALID_VIEW_TYPES.has(view.type)) return {
-		ok: false,
-		reason: `tab '${obj.id}': view.type must be one of iframe / launch / html`
-	};
-	switch (view.type) {
-		case "iframe":
-			if (typeof view.src !== "string" || view.src.length === 0) return {
-				ok: false,
-				reason: `tab '${obj.id}': iframe view requires a non-empty src`
-			};
-			break;
-		case "html":
-			if (typeof view.html !== "string") return {
-				ok: false,
-				reason: `tab '${obj.id}': html view requires html string`
-			};
-			break;
-		case "launch":
-			if (!Array.isArray(view.actions)) return {
-				ok: false,
-				reason: `tab '${obj.id}': launch view requires actions array`
-			};
-			break;
-	}
-	return {
-		ok: true,
-		tab: obj
-	};
-}
-//#endregion
-//#region src/bus/server.ts
-function createServerBus(opts = {}) {
-	const wsPath = opts.wsPath ?? "/_debug/_bus";
-	const secret = opts.secret ?? false;
-	const core = createBusCore();
-	const wss = new WebSocketServer({ noServer: true });
-	const clients = /* @__PURE__ */ new Set();
-	let attachedServer = null;
-	let upgradeHandler = null;
-	wss.on("connection", (ws) => {
-		clients.add(ws);
-		ws.on("message", (data) => {
-			try {
-				const text = typeof data === "string" ? data : data.toString("utf-8");
-				const parsed = JSON.parse(text);
-				if (!parsed || typeof parsed.type !== "string" || typeof parsed.ts !== "number") return;
-				core.dispatch({
-					...parsed,
-					__kick_origin: "ws"
-				});
-			} catch {}
-		});
-		ws.on("close", () => {
-			clients.delete(ws);
-		});
-		ws.on("error", () => {
-			clients.delete(ws);
-		});
-	});
-	const fanOut = (envelope) => {
-		if (clients.size === 0) return;
-		const text = JSON.stringify(envelope);
-		for (const client of clients) if (client.readyState === client.OPEN) try {
-			client.send(text);
-		} catch {}
-	};
-	const checkAuth = (req) => {
-		if (secret === false) return true;
-		const header = req.headers["x-devtools-token"];
-		if (typeof header === "string" && header === secret) return true;
-		const url = req.url ?? "";
-		const queryIdx = url.indexOf("?");
-		if (queryIdx === -1) return false;
-		return new URLSearchParams(url.slice(queryIdx + 1)).get("token") === secret;
-	};
-	const attachUpgrade = (httpServer) => {
-		if (attachedServer) return;
-		attachedServer = httpServer;
-		upgradeHandler = (req, socket, head) => {
-			if ((req.url ?? "").split("?")[0] !== wsPath) return;
-			if (!checkAuth(req)) {
-				socket.write("HTTP/1.1 401 Unauthorized\r\n\r\n");
-				socket.destroy();
-				return;
-			}
-			wss.handleUpgrade(req, socket, head, (ws) => {
-				wss.emit("connection", ws, req);
-			});
-		};
-		httpServer.on("upgrade", upgradeHandler);
-	};
-	const close = () => {
-		if (attachedServer && upgradeHandler) attachedServer.off("upgrade", upgradeHandler);
-		attachedServer = null;
-		upgradeHandler = null;
-		for (const client of clients) try {
-			client.close();
-		} catch {}
-		clients.clear();
-		wss.close();
-	};
-	return {
-		on(type, handler) {
-			return core.on(type, handler);
-		},
-		onAny(handler) {
-			return core.onAny(handler);
-		},
-		emit(type, payload) {
-			const envelope = {
-				type,
-				payload,
-				ts: Date.now(),
-				__kick_origin: "local"
-			};
-			core.dispatch(envelope);
-			fanOut(envelope);
-		},
-		attachUpgrade,
-		close,
-		clientCount: () => clients.size
-	};
-}
-//#endregion
-//#region src/adapter.ts
-const log = createLogger("DevTools");
-const MAX_SAMPLES = 1e3;
-/** Compute a percentile from a sorted array of numbers */
-function percentile(sorted, p) {
-	if (sorted.length === 0) return 0;
-	const idx = Math.ceil(p * sorted.length) - 1;
-	return sorted[Math.max(0, idx)];
-}
-/** Compute p50, p95, p99 from a RouteStats samples buffer */
-function computePercentiles(stats) {
-	const sorted = [...stats.samples].toSorted((a, b) => a - b);
-	return {
-		p50: percentile(sorted, .5),
-		p95: percentile(sorted, .95),
-		p99: percentile(sorted, .99)
-	};
-}
-/**
-* Open an SSE response — sets the headers, flushes them, and disables
-* any compression middleware that may have been registered upstream
-* (compression buffers SSE chunks indefinitely; we need flush-on-write).
-*/
-function openSseStream(req, res) {
-	res.writeHead(200, {
-		"Content-Type": "text/event-stream",
-		"Cache-Control": "no-cache, no-transform",
-		Connection: "keep-alive",
-		"X-Accel-Buffering": "no"
-	});
-	res.flushHeaders?.();
-}
-/** Write a single SSE `data:` event with a JSON payload + double newline. */
-function writeSseEvent(res, payload) {
-	res.write(`data: ${JSON.stringify(payload)}\n\n`);
-}
-/**
-* Module-scoped guard for `POST /_debug/memory/snapshot`. `writeHeapSnapshot()`
-* blocks the event loop for the duration of the capture (multi-second
-* for large heaps); two concurrent captures would compound the pause.
-* The endpoint returns 503 + a hint message when this flag is set so
-* the SPA can surface a "snapshot already running" warning rather than
-* silently queueing.
-*
-* Module-scoped (not per-adapter-instance) because writeHeapSnapshot
-* acts on the V8 process — multiple DevToolsAdapter instances would
-* still race at the v8 layer.
-*/
-let snapshotInProgress = false;
-/**
-* DevToolsAdapter — Vue-style reactive introspection for KickJS applications.
-*
-* Exposes debug endpoints powered by reactive state (ref, computed, watch):
-* - `GET /_debug/routes`    — all registered routes with middleware
-* - `GET /_debug/container` — DI registry with scopes and instantiation status
-* - `GET /_debug/metrics`   — live request/error counts, error rate, uptime
-* - `GET /_debug/health`    — deep health check with adapter status
-* - `GET /_debug/config`    — sanitized environment variables (opt-in)
-* - `GET /_debug/state`     — full reactive state snapshot
-*
-* @example
-* ```ts
-* import { DevToolsAdapter } from '@forinda/kickjs-devtools'
-*
-* bootstrap({
-*   modules: [UserModule],
-*   adapters: [
-*     DevToolsAdapter({
-*       enabled: process.env.NODE_ENV !== 'production',
-*       exposeConfig: true,
-*       configPrefixes: ['APP_', 'DATABASE_'],
-*     }),
-*   ],
-* })
-* ```
-*/
-const DevToolsAdapter = defineAdapter({
-	name: "DevToolsAdapter",
-	defaults: {
-		basePath: "/_debug",
-		errorRateThreshold: .5,
-		exposeConfig: false,
-		configPrefixes: ["APP_", "NODE_ENV"]
-	},
-	build: (options) => {
-		const basePath = options.basePath;
-		const enabled = options.enabled ?? process.env.NODE_ENV !== "production";
-		const exposeConfig = options.exposeConfig;
-		const configPrefixes = options.configPrefixes;
-		const errorRateThreshold = options.errorRateThreshold;
-		const peerAdapters = options.adapters ?? [];
-		let secret;
-		if (options.secret === false) secret = false;
-		else if (options.secret) secret = options.secret;
-		else secret = randomBytes(16).toString("hex");
-		const runtimeEnabled = options.runtime?.enabled ?? true;
-		const runtimeSampler = runtimeEnabled ? new RuntimeSampler({
-			intervalMs: options.runtime?.intervalMs ?? 1e3,
-			bufferSize: options.runtime?.bufferSize ?? 60
-		}) : null;
-		const memoryAnalyzer = runtimeEnabled ? new MemoryAnalyzer() : null;
-		let bus = null;
-		const ensureBus = (container) => {
-			if (container.has(DEVTOOLS_BUS)) {
-				bus = container.resolve(DEVTOOLS_BUS);
-				return bus;
-			}
-			bus = enabled ? createServerBus({
-				wsPath: `${basePath}/_bus`,
-				secret: secret === false ? false : secret
-			}) : {
-				on: () => () => {},
-				onAny: () => () => {},
-				emit: () => {},
-				attachUpgrade: () => {},
-				close: () => {},
-				clientCount: () => 0
-			};
-			container.registerInstance(DEVTOOLS_BUS, bus);
-			return bus;
-		};
-		const requestCount = ref(0);
-		const errorCount = ref(0);
-		const clientErrorCount = ref(0);
-		const startedAt = ref(Date.now());
-		const routeLatency = reactive({});
-		const errorRate = computed(() => requestCount.value > 0 ? errorCount.value / requestCount.value : 0);
-		const uptimeSeconds = computed(() => Math.floor((Date.now() - startedAt.value) / 1e3));
-		let routes = [];
-		let container = null;
-		let appRef = null;
-		const adapterStatuses = {};
-		let stopErrorWatch = null;
-		if (options.onErrorRateExceeded) {
-			const callback = options.onErrorRateExceeded;
-			stopErrorWatch = watch(errorRate, (rate) => {
-				if (rate > errorRateThreshold) callback(rate);
-			});
-		} else stopErrorWatch = watch(errorRate, (rate) => {
-			if (rate > errorRateThreshold) log.warn(`Error rate elevated: ${(rate * 100).toFixed(1)}%`);
-		});
-		/**
-		* Find the dashboard's public directory. Prefers the new Solid SPA
-		* (public/spa/, shipped from PR 4 of §23); falls back to the legacy
-		* Vue+Tailwind dashboard (public/devtools/) for environments that
-		* haven't run `pnpm --filter @forinda/kickjs-devtools build:spa`.
-		*/
-		const resolvePublicDir = () => {
-			const thisDir = dirname(fileURLToPath(import.meta.url));
-			const candidates = [
-				join(thisDir, "..", "public", "spa"),
-				join(thisDir, "..", "..", "public", "spa"),
-				join(thisDir, "..", "public", "devtools"),
-				join(thisDir, "..", "..", "public", "devtools")
-			];
-			for (const dir of candidates) if (existsSync(join(dir, "index.html"))) return dir;
-			return null;
-		};
-		/**
-		* Resolve peer adapters at request time. Prefers live adapters from the
-		* Application registry (survives HMR rebuild) and falls back to the
-		* constructor-provided refs.
-		*/
-		const getPeerAdapters = () => {
-			const kickApp = appRef?.__kickApp;
-			if (kickApp && typeof kickApp.getAdapters === "function") return kickApp.getAdapters();
-			return peerAdapters;
-		};
-		return {
-			requestCount,
-			errorCount,
-			clientErrorCount,
-			startedAt,
-			errorRate,
-			uptimeSeconds,
-			routeLatency,
-			runtimeSampler,
-			memoryAnalyzer,
-			introspect() {
-				return {
-					protocolVersion: PROTOCOL_VERSION,
-					name: "DevToolsAdapter",
-					kind: "adapter",
-					state: {
-						basePath,
-						enabled,
-						runtimeEnabled,
-						secret: secret === false ? false : "present"
-					},
-					metrics: {
-						requestCount: requestCount.value,
-						serverErrors: errorCount.value,
-						clientErrors: clientErrorCount.value,
-						uptimeSeconds: uptimeSeconds.value,
-						routesTracked: routes.length
-					}
-				};
-			},
-			beforeMount({ app, container: containerArg }) {
-				if (!enabled) return;
-				appRef = app;
-				container = containerArg;
-				ensureBus(containerArg);
-				startedAt.value = Date.now();
-				routes = [];
-				adapterStatuses["DevToolsAdapter"] = "running";
-				runtimeSampler?.start();
-				memoryAnalyzer?.start();
-				const router = Router();
-				if (secret !== false) {
-					const token = secret;
-					router.use((req, res, next) => {
-						if ((req.headers["x-devtools-token"] ?? req.query?.token) === token) return next();
-						if (req.path === "/" && req.method === "GET" && !req.query?.token) return next();
-						if (req.path.endsWith(".js") || req.path.endsWith(".css")) return next();
-						res.status(403).json({ error: "Forbidden — invalid or missing devtools token" });
-					});
-				}
-				router.get("/routes", (_req, res) => {
-					res.json({ routes });
-				});
-				router.get("/container", (_req, res) => {
-					const registrations = container?.getRegistrations() ?? [];
-					res.json({
-						registrations,
-						count: registrations.length
-					});
-				});
-				router.get("/metrics", (_req, res) => {
-					const latency = {};
-					for (const [key, stats] of Object.entries(routeLatency)) {
-						const { samples: _, ...rest } = stats;
-						latency[key] = {
-							...rest,
-							...computePercentiles(stats)
-						};
-					}
-					res.json({
-						requests: requestCount.value,
-						serverErrors: errorCount.value,
-						clientErrors: clientErrorCount.value,
-						errorRate: errorRate.value,
-						uptimeSeconds: uptimeSeconds.value,
-						startedAt: new Date(startedAt.value).toISOString(),
-						routeLatency: latency
-					});
-				});
-				router.get("/health", (_req, res) => {
-					const healthy = errorRate.value < errorRateThreshold;
-					const status = healthy ? "healthy" : "degraded";
-					res.status(healthy ? 200 : 503).json({
-						status,
-						errorRate: errorRate.value,
-						uptime: uptimeSeconds.value,
-						adapters: adapterStatuses
-					});
-				});
-				router.get("/state", (_req, res) => {
-					const wsAdapter = getPeerAdapters().find((a) => a.name === "WsAdapter" && typeof a.getStats === "function");
-					res.json({
-						reactive: {
-							requestCount: requestCount.value,
-							errorCount: errorCount.value,
-							clientErrorCount: clientErrorCount.value,
-							errorRate: errorRate.value,
-							uptimeSeconds: uptimeSeconds.value,
-							startedAt: new Date(startedAt.value).toISOString()
-						},
-						routes: routes.length,
-						container: container?.getRegistrations().length ?? 0,
-						routeLatency,
-						...wsAdapter ? { ws: wsAdapter.getStats() } : {}
-					});
-				});
-				router.get("/runtime", (_req, res) => {
-					if (!runtimeSampler || !memoryAnalyzer) {
-						res.status(404).json({ error: "runtime sampler disabled — set runtime.enabled = true" });
-						return;
-					}
-					const latest = runtimeSampler.latest();
-					const history = runtimeSampler.history();
-					const health = memoryAnalyzer.health(history);
-					res.json({
-						protocolVersion: PROTOCOL_VERSION,
-						latest,
-						history,
-						health
-					});
-				});
-				router.get("/runtime/stream", (req, res) => {
-					if (!runtimeSampler) {
-						res.status(404).json({ error: "runtime sampler disabled" });
-						return;
-					}
-					openSseStream(req, res);
-					const intervalMs = options.runtime?.intervalMs ?? 1e3;
-					const tick = () => {
-						const snap = runtimeSampler.latest();
-						if (snap) writeSseEvent(res, snap);
-					};
-					tick();
-					const interval = setInterval(tick, intervalMs);
-					const heartbeat = setInterval(() => res.write(": heartbeat\n\n"), 3e4);
-					req.on("close", () => {
-						clearInterval(interval);
-						clearInterval(heartbeat);
-					});
-				});
-				router.get("/memory/stream", (req, res) => {
-					if (!runtimeSampler || !memoryAnalyzer) {
-						res.status(404).json({ error: "runtime sampler disabled" });
-						return;
-					}
-					openSseStream(req, res);
-					const intervalMs = options.runtime?.intervalMs ?? 1e3;
-					const tick = () => {
-						const snap = runtimeSampler.latest();
-						if (!snap) return;
-						writeSseEvent(res, {
-							snapshot: snap,
-							health: memoryAnalyzer.health(runtimeSampler.history())
-						});
-					};
-					tick();
-					const interval = setInterval(tick, intervalMs);
-					const heartbeat = setInterval(() => res.write(": heartbeat\n\n"), 3e4);
-					req.on("close", () => {
-						clearInterval(interval);
-						clearInterval(heartbeat);
-					});
-				});
-				router.post("/memory/snapshot", (_req, res) => {
-					if (snapshotInProgress) {
-						res.status(503).json({ error: "heap snapshot already in progress — wait for it to complete" });
-						return;
-					}
-					snapshotInProgress = true;
-					const startedAt = Date.now();
-					const filename = `kickjs-heap-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.heapsnapshot`;
-					const targetPath = join(tmpdir(), filename);
-					let written;
-					try {
-						written = writeHeapSnapshot(targetPath);
-					} catch (err) {
-						snapshotInProgress = false;
-						log.error({ err }, "heap snapshot capture failed");
-						res.status(500).json({
-							error: "snapshot capture failed",
-							message: err.message
-						});
-						return;
-					}
-					let size = 0;
-					try {
-						size = statSync(written).size;
-					} catch {}
-					const elapsedMs = Date.now() - startedAt;
-					log.info(`Heap snapshot captured: ${written} (${(size / 1024 / 1024).toFixed(1)} MiB in ${elapsedMs}ms)`);
-					res.setHeader("Content-Type", "application/json");
-					res.setHeader("Content-Disposition", `attachment; filename="${filename}"`);
-					if (size > 0) res.setHeader("Content-Length", String(size));
-					res.setHeader("X-Snapshot-Capture-Ms", String(elapsedMs));
-					const cleanup = () => {
-						unlink(written, (err) => {
-							if (err) log.warn(`Failed to delete heap snapshot ${written}: ${err.message}`);
-							snapshotInProgress = false;
-						});
-					};
-					const stream = createReadStream(written);
-					stream.on("end", cleanup);
-					stream.on("error", (err) => {
-						log.error({ err }, "heap snapshot stream failed");
-						if (!res.headersSent) res.status(500).end();
-						cleanup();
-					});
-					res.on("close", () => {
-						stream.destroy();
-					});
-					stream.pipe(res);
-				});
-				router.post("/memory/gc", (_req, res) => {
-					const gc = globalThis.gc;
-					if (typeof gc !== "function") {
-						res.status(412).json({ error: "global.gc unavailable — start Node with --expose-gc to enable this endpoint" });
-						return;
-					}
-					const before = process.memoryUsage().heapUsed;
-					const startedAt = Date.now();
-					try {
-						gc();
-					} catch (err) {
-						res.status(500).json({
-							error: "forced GC failed",
-							message: err instanceof Error ? err.message : String(err)
-						});
-						return;
-					}
-					const after = process.memoryUsage().heapUsed;
-					const reclaimedBytes = Math.max(0, before - after);
-					const elapsedMs = Date.now() - startedAt;
-					log.info(`Forced GC reclaimed ${(reclaimedBytes / 1024 / 1024).toFixed(2)} MiB in ${elapsedMs}ms`);
-					res.json({
-						before,
-						after,
-						reclaimedBytes,
-						elapsedMs
-					});
-				});
-				router.get("/tabs", (_req, res) => {
-					const kickApp = appRef?.__kickApp;
-					if (!kickApp) {
-						res.status(503).json({ error: "tabs unavailable — application surface not exposed" });
-						return;
-					}
-					res.json(collectDevtoolsTabs(kickApp));
-				});
-				router.get("/topology", async (_req, res) => {
-					if (!container) {
-						res.status(503).json({ error: "topology unavailable — container not bound yet" });
-						return;
-					}
-					const kickApp = appRef?.__kickApp;
-					if (!kickApp) {
-						res.status(503).json({ error: "topology unavailable — application surface not exposed" });
-						return;
-					}
-					try {
-						const snapshot = await collectTopologySnapshot({
-							app: kickApp,
-							container
-						});
-						res.json(snapshot);
-					} catch (err) {
-						const message = err instanceof Error ? err.message : String(err);
-						res.status(500).json({
-							error: "topology collection failed",
-							message
-						});
-					}
-				});
-				router.get("/ws", (_req, res) => {
-					const wsAdapter = getPeerAdapters().find((a) => a.name === "WsAdapter" && typeof a.getStats === "function");
-					if (!wsAdapter) {
-						res.json({
-							enabled: false,
-							message: "WsAdapter not found"
-						});
-						return;
-					}
-					res.json({
-						enabled: true,
-						...wsAdapter.getStats()
-					});
-				});
-				router.get("/queues", async (_req, res) => {
-					const queueAdapter = getPeerAdapters().find((a) => a.name === "QueueAdapter" && typeof a.getQueueNames === "function");
-					if (!queueAdapter) {
-						res.json({
-							enabled: false,
-							message: "QueueAdapter not found"
-						});
-						return;
-					}
-					try {
-						const names = queueAdapter.getQueueNames?.() ?? [];
-						const queues = [];
-						for (const name of names) {
-							const stats = await queueAdapter.getQueueStats?.(name);
-							queues.push({
-								name,
-								...stats
-							});
-						}
-						res.json({
-							enabled: true,
-							queues
-						});
-					} catch {
-						res.json({
-							enabled: true,
-							queues: [],
-							error: "Failed to fetch queue stats"
-						});
-					}
-				});
-				router.get("/graph", (_req, res) => {
-					const registrations = container?.getRegistrations() ?? [];
-					const nodes = registrations.filter((r) => !r.token.startsWith("__hmr__")).map((r) => ({
-						id: r.token,
-						kind: r.kind,
-						scope: r.scope,
-						resolveCount: r.resolveCount
-					}));
-					const nodeIds = new Set(nodes.map((n) => n.id));
-					const edges = [];
-					for (const r of registrations) {
-						if (r.token.startsWith("__hmr__")) continue;
-						for (const dep of r.dependencies) if (nodeIds.has(dep)) edges.push({
-							from: r.token,
-							to: dep
-						});
-					}
-					res.json({
-						nodes,
-						edges
-					});
-				});
-				router.get("/stream", (req, res) => {
-					res.writeHead(200, {
-						"Content-Type": "text/event-stream",
-						"Cache-Control": "no-cache",
-						Connection: "keep-alive"
-					});
-					const sendMetrics = () => {
-						const data = {
-							type: "metrics",
-							requestCount: requestCount.value,
-							errorCount: errorCount.value,
-							clientErrorCount: clientErrorCount.value,
-							errorRate: errorRate.value,
-							uptimeSeconds: uptimeSeconds.value
-						};
-						res.write(`data: ${JSON.stringify(data)}\n\n`);
-					};
-					sendMetrics();
-					const unsubContainer = container?.onChange?.((changes) => {
-						res.write(`data: ${JSON.stringify({
-							type: "container",
-							changes,
-							timestamp: Date.now()
-						})}\n\n`);
-						sendMetrics();
-					});
-					const stopRequestWatch = watch(requestCount, () => sendMetrics());
-					const stopErrWatch = watch(errorCount, () => sendMetrics());
-					const heartbeat = setInterval(() => {
-						res.write(`: heartbeat\n\n`);
-					}, 3e4);
-					req.on("close", () => {
-						unsubContainer?.();
-						stopRequestWatch();
-						stopErrWatch();
-						clearInterval(heartbeat);
-					});
-				});
-				if (exposeConfig) router.get("/config", (_req, res) => {
-					const config = {};
-					for (const [key, value] of Object.entries(process.env)) {
-						if (value === void 0) continue;
-						config[key] = configPrefixes.some((prefix) => key.startsWith(prefix)) ? value : "[REDACTED]";
-					}
-					res.json({ config });
-				});
-				const publicDir = resolvePublicDir();
-				if (publicDir) {
-					router.use(static$1(publicDir));
-					const indexHtml = readFileSync(join(publicDir, "index.html"), "utf-8");
-					router.get("/", (_req, res) => {
-						const html = indexHtml.replace("<body", `<body data-base="${basePath}"`);
-						res.type("html").send(html);
-					});
-				} else router.get("/", (_req, res) => {
-					res.type("html").send("<h1>DevTools: public directory not found</h1>");
-				});
-				app.use(basePath, router);
-				if (secret) {
-					log.info(`DevTools mounted at ${basePath} [token: ${secret}]`);
-					log.info(`Access: ${basePath}?token=${secret}`);
-				} else log.info(`DevTools mounted at ${basePath} [no guard]`);
-			},
-			middleware() {
-				if (!enabled) return [];
-				return [{
-					handler: (req, res, next) => {
-						const start = Date.now();
-						requestCount.value++;
-						res.on("finish", () => {
-							if (res.statusCode >= 500) errorCount.value++;
-							else if (res.statusCode >= 400) clientErrorCount.value++;
-							const routeKey = `${req.method} ${req.route?.path ?? req.path}`;
-							const elapsed = Date.now() - start;
-							if (!routeLatency[routeKey]) routeLatency[routeKey] = {
-								count: 0,
-								totalMs: 0,
-								minMs: Infinity,
-								maxMs: 0,
-								samples: []
-							};
-							const stats = routeLatency[routeKey];
-							stats.count++;
-							stats.totalMs += elapsed;
-							stats.minMs = Math.min(stats.minMs, elapsed);
-							stats.maxMs = Math.max(stats.maxMs, elapsed);
-							stats.samples.push(elapsed);
-							if (stats.samples.length > MAX_SAMPLES) stats.samples.shift();
-						});
-						next();
-					},
-					phase: "beforeGlobal"
-				}];
-			},
-			onRouteMount(controllerClass, mountPath) {
-				if (!enabled) return;
-				const collectedRoutes = getClassMeta(METADATA.ROUTES, controllerClass, []);
-				const classMiddleware = getClassMeta(METADATA.CLASS_MIDDLEWARES, controllerClass, []);
-				for (const route of collectedRoutes) {
-					const methodMiddleware = getMethodMeta(METADATA.METHOD_MIDDLEWARES, controllerClass.prototype, route.handlerName, []);
-					routes.push({
-						method: route.method.toUpperCase(),
-						path: `${mountPath}${route.path === "/" ? "" : route.path}`,
-						controller: controllerClass.name,
-						handler: route.handlerName,
-						middleware: [...classMiddleware.map((m) => m.name || "anonymous"), ...methodMiddleware.map((m) => m.name || "anonymous")]
-					});
-				}
-			},
-			afterStart({ server }) {
-				if (!enabled) return;
-				if (server) bus?.attachUpgrade(server);
-				log.info(`DevTools ready — ${routes.length} routes tracked, ${container?.getRegistrations().length ?? 0} DI bindings, event bus on ${basePath}/_bus`);
-			},
-			shutdown() {
-				stopErrorWatch?.();
-				runtimeSampler?.stop();
-				memoryAnalyzer?.stop();
-				bus?.close();
-				adapterStatuses["DevToolsAdapter"] = "stopped";
-			}
-		};
-	}
-});
-//#endregion
-export { DevToolsAdapter };
+import"reflect-metadata";import{Router,static as static$1}from"express";import{dirname,join}from"node:path";import{tmpdir}from"node:os";import{fileURLToPath}from"node:url";import{createReadStream,existsSync,readFileSync,statSync,unlink}from"node:fs";import{randomBytes}from"node:crypto";import{writeHeapSnapshot}from"node:v8";import{METADATA,computed,createLogger,defineAdapter,getClassMeta,getMethodMeta,reactive,ref,watch}from"@forinda/kickjs";import{MemoryAnalyzer,PROTOCOL_VERSION,RuntimeSampler}from"@forinda/kickjs-devtools-kit";import{DEVTOOLS_BUS}from"@forinda/kickjs-devtools-kit/bus/token";import{createBusCore}from"@forinda/kickjs-devtools-kit/bus";import{WebSocketServer}from"ws";async function collectTopologySnapshot(opts){let{app,container,introspectTimeoutMs=100}=opts,errors=[],plugins=await Promise.all(app.getPlugins().map(p=>snapshotFor(p,`plugin`,introspectTimeoutMs,errors))),adapters=await Promise.all(app.getAdapters().map(a=>snapshotFor(a,`adapter`,introspectTimeoutMs,errors)));return{protocolVersion:PROTOCOL_VERSION,timestamp:Date.now(),plugins,adapters,contributors:collectContributors(app),diTokens:collectTokens(container),errors}}async function snapshotFor(primitive,kind,timeoutMs,errors){let name=primitive.name??`(unnamed)`,stub={protocolVersion:PROTOCOL_VERSION,name,kind};if(typeof primitive.introspect!=`function`)return stub;try{let result=await Promise.race([Promise.resolve(primitive.introspect()),new Promise((_,reject)=>setTimeout(()=>reject(Error(`introspect() timed out after ${timeoutMs}ms`)),timeoutMs))]);if(result&&typeof result==`object`){let snap=result;return{protocolVersion:PROTOCOL_VERSION,name:snap.name??name,kind:snap.kind??kind,version:snap.version,state:snap.state,tokens:snap.tokens,metrics:snap.metrics,memoryBytes:snap.memoryBytes}}return stub}catch(err){return errors.push({name,kind,message:err instanceof Error?err.message:String(err)}),stub}}function collectTokens(container){return container.getRegistrations().filter(r=>!r.token.startsWith(`__hmr__`)).map(r=>({token:r.token,scope:r.scope,kind:r.kind,instantiated:r.instantiated}))}function collectContributors(app){let seen=new Map;if(typeof app.getContributors==`function`){for(let c of app.getContributors()){if(seen.has(c.key))continue;let mapped=c.source===`module`?`module`:`adapter`;seen.set(c.key,{key:c.key,source:mapped,dependsOn:c.dependsOn})}return[...seen.values()]}let ingest=(list,source)=>{if(list)for(let reg of list){let r=reg,key=typeof r.key==`string`?r.key:null;!key||seen.has(key)||seen.set(key,{key,source,dependsOn:Array.isArray(r.dependsOn)?r.dependsOn:[]})}};for(let plugin of app.getPlugins())ingest(plugin.contributors?.(),`adapter`);for(let adapter of app.getAdapters())ingest(adapter.contributors?.(),`adapter`);return[...seen.values()]}const VALID_VIEW_TYPES=new Set([`iframe`,`launch`,`html`]);function collectDevtoolsTabs(app){let tabs=[],seen=new Map,errors=[],ingest=(sourceName,raw)=>{if(!Array.isArray(raw)){errors.push({source:sourceName,reason:`devtoolsTabs() did not return an array`});return}for(let entry of raw){let validation=validateTab(entry);if(!validation.ok){errors.push({source:sourceName,reason:validation.reason});continue}let tab=validation.tab,owner=seen.get(tab.id);if(owner){errors.push({source:sourceName,reason:`tab id '${tab.id}' already registered by ${owner} — first-source wins`});continue}seen.set(tab.id,sourceName),tabs.push(tab)}};for(let plugin of app.getPlugins())if(typeof plugin.devtoolsTabs==`function`)try{ingest(plugin.name??`(unnamed plugin)`,plugin.devtoolsTabs())}catch(err){errors.push({source:plugin.name??`(unnamed plugin)`,reason:err instanceof Error?err.message:String(err)})}for(let adapter of app.getAdapters())if(typeof adapter.devtoolsTabs==`function`)try{ingest(adapter.name??`(unnamed adapter)`,adapter.devtoolsTabs())}catch(err){errors.push({source:adapter.name??`(unnamed adapter)`,reason:err instanceof Error?err.message:String(err)})}return{tabs,errors}}function validateTab(raw){if(!raw||typeof raw!=`object`)return{ok:!1,reason:`tab entry is not an object`};let obj=raw;if(typeof obj.id!=`string`||obj.id.length===0)return{ok:!1,reason:`tab.id must be a non-empty string`};if(typeof obj.title!=`string`||obj.title.length===0)return{ok:!1,reason:`tab '${obj.id}': title must be a non-empty string`};let view=obj.view;if(!view||typeof view!=`object`)return{ok:!1,reason:`tab '${obj.id}': view object is required`};if(typeof view.type!=`string`||!VALID_VIEW_TYPES.has(view.type))return{ok:!1,reason:`tab '${obj.id}': view.type must be one of iframe / launch / html`};switch(view.type){case`iframe`:if(typeof view.src!=`string`||view.src.length===0)return{ok:!1,reason:`tab '${obj.id}': iframe view requires a non-empty src`};break;case`html`:if(typeof view.html!=`string`)return{ok:!1,reason:`tab '${obj.id}': html view requires html string`};break;case`launch`:if(!Array.isArray(view.actions))return{ok:!1,reason:`tab '${obj.id}': launch view requires actions array`};break}return{ok:!0,tab:obj}}function createServerBus(opts={}){let wsPath=opts.wsPath??`/_debug/_bus`,secret=opts.secret??!1,core=createBusCore(),wss=new WebSocketServer({noServer:!0}),clients=new Set,attachedServer=null,upgradeHandler=null;wss.on(`connection`,ws=>{clients.add(ws),ws.on(`message`,data=>{try{let text=typeof data==`string`?data:data.toString(`utf-8`),parsed=JSON.parse(text);if(!parsed||typeof parsed.type!=`string`||typeof parsed.ts!=`number`)return;core.dispatch({...parsed,__kick_origin:`ws`})}catch{}}),ws.on(`close`,()=>{clients.delete(ws)}),ws.on(`error`,()=>{clients.delete(ws)})});let fanOut=envelope=>{if(clients.size===0)return;let text=JSON.stringify(envelope);for(let client of clients)if(client.readyState===client.OPEN)try{client.send(text)}catch{}},checkAuth=req=>{if(secret===!1)return!0;let header=req.headers[`x-devtools-token`];if(typeof header==`string`&&header===secret)return!0;let url=req.url??``,queryIdx=url.indexOf(`?`);return queryIdx===-1?!1:new URLSearchParams(url.slice(queryIdx+1)).get(`token`)===secret};return{on(type,handler){return core.on(type,handler)},onAny(handler){return core.onAny(handler)},emit(type,payload){let envelope={type,payload,ts:Date.now(),__kick_origin:`local`};core.dispatch(envelope),fanOut(envelope)},attachUpgrade:httpServer=>{attachedServer||(attachedServer=httpServer,upgradeHandler=(req,socket,head)=>{if((req.url??``).split(`?`)[0]===wsPath){if(!checkAuth(req)){socket.write(`HTTP/1.1 401 Unauthorized\r
+\r
+`),socket.destroy();return}wss.handleUpgrade(req,socket,head,ws=>{wss.emit(`connection`,ws,req)})}},httpServer.on(`upgrade`,upgradeHandler))},close:()=>{attachedServer&&upgradeHandler&&attachedServer.off(`upgrade`,upgradeHandler),attachedServer=null,upgradeHandler=null;for(let client of clients)try{client.close()}catch{}clients.clear(),wss.close()},clientCount:()=>clients.size}}const log=createLogger(`DevTools`);function percentile(sorted,p){if(sorted.length===0)return 0;let idx=Math.ceil(p*sorted.length)-1;return sorted[Math.max(0,idx)]}function computePercentiles(stats){let sorted=[...stats.samples].toSorted((a,b)=>a-b);return{p50:percentile(sorted,.5),p95:percentile(sorted,.95),p99:percentile(sorted,.99)}}function openSseStream(req,res){res.writeHead(200,{"Content-Type":`text/event-stream`,"Cache-Control":`no-cache, no-transform`,Connection:`keep-alive`,"X-Accel-Buffering":`no`}),res.flushHeaders?.()}function writeSseEvent(res,payload){res.write(`data: ${JSON.stringify(payload)}\n\n`)}let snapshotInProgress=!1;const DevToolsAdapter=defineAdapter({name:`DevToolsAdapter`,defaults:{basePath:`/_debug`,errorRateThreshold:.5,exposeConfig:!1,configPrefixes:[`APP_`,`NODE_ENV`]},build:options=>{let basePath=options.basePath,enabled=options.enabled??process.env.NODE_ENV!==`production`,exposeConfig=options.exposeConfig,configPrefixes=options.configPrefixes,errorRateThreshold=options.errorRateThreshold,peerAdapters=options.adapters??[],secret;secret=options.secret===!1?!1:options.secret?options.secret:randomBytes(16).toString(`hex`);let runtimeEnabled=options.runtime?.enabled??!0,runtimeSampler=runtimeEnabled?new RuntimeSampler({intervalMs:options.runtime?.intervalMs??1e3,bufferSize:options.runtime?.bufferSize??60}):null,memoryAnalyzer=runtimeEnabled?new MemoryAnalyzer:null,bus=null,ensureBus=container=>container.has(DEVTOOLS_BUS)?(bus=container.resolve(DEVTOOLS_BUS),bus):(bus=enabled?createServerBus({wsPath:`${basePath}/_bus`,secret:secret===!1?!1:secret}):{on:()=>()=>{},onAny:()=>()=>{},emit:()=>{},attachUpgrade:()=>{},close:()=>{},clientCount:()=>0},container.registerInstance(DEVTOOLS_BUS,bus),bus),requestCount=ref(0),errorCount=ref(0),clientErrorCount=ref(0),startedAt=ref(Date.now()),routeLatency=reactive({}),errorRate=computed(()=>requestCount.value>0?errorCount.value/requestCount.value:0),uptimeSeconds=computed(()=>Math.floor((Date.now()-startedAt.value)/1e3)),routes=[],container=null,appRef=null,adapterStatuses={},stopErrorWatch=null;if(options.onErrorRateExceeded){let callback=options.onErrorRateExceeded;stopErrorWatch=watch(errorRate,rate=>{rate>errorRateThreshold&&callback(rate)})}else stopErrorWatch=watch(errorRate,rate=>{rate>errorRateThreshold&&log.warn(`Error rate elevated: ${(rate*100).toFixed(1)}%`)});let resolvePublicDir=()=>{let thisDir=dirname(fileURLToPath(import.meta.url)),candidates=[join(thisDir,`..`,`public`,`spa`),join(thisDir,`..`,`..`,`public`,`spa`),join(thisDir,`..`,`public`,`devtools`),join(thisDir,`..`,`..`,`public`,`devtools`)];for(let dir of candidates)if(existsSync(join(dir,`index.html`)))return dir;return null},getPeerAdapters=()=>{let kickApp=appRef?.__kickApp;return kickApp&&typeof kickApp.getAdapters==`function`?kickApp.getAdapters():peerAdapters};return{requestCount,errorCount,clientErrorCount,startedAt,errorRate,uptimeSeconds,routeLatency,runtimeSampler,memoryAnalyzer,introspect(){return{protocolVersion:PROTOCOL_VERSION,name:`DevToolsAdapter`,kind:`adapter`,state:{basePath,enabled,runtimeEnabled,secret:secret===!1?!1:`present`},metrics:{requestCount:requestCount.value,serverErrors:errorCount.value,clientErrors:clientErrorCount.value,uptimeSeconds:uptimeSeconds.value,routesTracked:routes.length}}},beforeMount({app,container:containerArg}){if(!enabled)return;appRef=app,container=containerArg,ensureBus(containerArg),startedAt.value=Date.now(),routes=[],adapterStatuses.DevToolsAdapter=`running`,runtimeSampler?.start(),memoryAnalyzer?.start();let router=Router();if(secret!==!1){let token=secret;router.use((req,res,next)=>{if((req.headers[`x-devtools-token`]??req.query?.token)===token||req.path===`/`&&req.method===`GET`&&!req.query?.token||req.path.endsWith(`.js`)||req.path.endsWith(`.css`))return next();res.status(403).json({error:`Forbidden — invalid or missing devtools token`})})}router.get(`/routes`,(_req,res)=>{res.json({routes})}),router.get(`/container`,(_req,res)=>{let registrations=container?.getRegistrations()??[];res.json({registrations,count:registrations.length})}),router.get(`/metrics`,(_req,res)=>{let latency={};for(let[key,stats]of Object.entries(routeLatency)){let{samples:_,...rest}=stats;latency[key]={...rest,...computePercentiles(stats)}}res.json({requests:requestCount.value,serverErrors:errorCount.value,clientErrors:clientErrorCount.value,errorRate:errorRate.value,uptimeSeconds:uptimeSeconds.value,startedAt:new Date(startedAt.value).toISOString(),routeLatency:latency})}),router.get(`/health`,(_req,res)=>{let healthy=errorRate.value<errorRateThreshold,status=healthy?`healthy`:`degraded`;res.status(healthy?200:503).json({status,errorRate:errorRate.value,uptime:uptimeSeconds.value,adapters:adapterStatuses})}),router.get(`/state`,(_req,res)=>{let wsAdapter=getPeerAdapters().find(a=>a.name===`WsAdapter`&&typeof a.getStats==`function`);res.json({reactive:{requestCount:requestCount.value,errorCount:errorCount.value,clientErrorCount:clientErrorCount.value,errorRate:errorRate.value,uptimeSeconds:uptimeSeconds.value,startedAt:new Date(startedAt.value).toISOString()},routes:routes.length,container:container?.getRegistrations().length??0,routeLatency,...wsAdapter?{ws:wsAdapter.getStats()}:{}})}),router.get(`/runtime`,(_req,res)=>{if(!runtimeSampler||!memoryAnalyzer){res.status(404).json({error:`runtime sampler disabled — set runtime.enabled = true`});return}let latest=runtimeSampler.latest(),history=runtimeSampler.history(),health=memoryAnalyzer.health(history);res.json({protocolVersion:PROTOCOL_VERSION,latest,history,health})}),router.get(`/runtime/stream`,(req,res)=>{if(!runtimeSampler){res.status(404).json({error:`runtime sampler disabled`});return}openSseStream(req,res);let intervalMs=options.runtime?.intervalMs??1e3,tick=()=>{let snap=runtimeSampler.latest();snap&&writeSseEvent(res,snap)};tick();let interval=setInterval(tick,intervalMs),heartbeat=setInterval(()=>res.write(`: heartbeat
+
+`),3e4);req.on(`close`,()=>{clearInterval(interval),clearInterval(heartbeat)})}),router.get(`/memory/stream`,(req,res)=>{if(!runtimeSampler||!memoryAnalyzer){res.status(404).json({error:`runtime sampler disabled`});return}openSseStream(req,res);let intervalMs=options.runtime?.intervalMs??1e3,tick=()=>{let snap=runtimeSampler.latest();snap&&writeSseEvent(res,{snapshot:snap,health:memoryAnalyzer.health(runtimeSampler.history())})};tick();let interval=setInterval(tick,intervalMs),heartbeat=setInterval(()=>res.write(`: heartbeat
+
+`),3e4);req.on(`close`,()=>{clearInterval(interval),clearInterval(heartbeat)})}),router.post(`/memory/snapshot`,(_req,res)=>{if(snapshotInProgress){res.status(503).json({error:`heap snapshot already in progress — wait for it to complete`});return}snapshotInProgress=!0;let startedAt=Date.now(),filename=`kickjs-heap-${new Date().toISOString().replace(/[:.]/g,`-`)}.heapsnapshot`,targetPath=join(tmpdir(),filename),written;try{written=writeHeapSnapshot(targetPath)}catch(err){snapshotInProgress=!1,log.error({err},`heap snapshot capture failed`),res.status(500).json({error:`snapshot capture failed`,message:err.message});return}let size=0;try{size=statSync(written).size}catch{}let elapsedMs=Date.now()-startedAt;log.info(`Heap snapshot captured: ${written} (${(size/1024/1024).toFixed(1)} MiB in ${elapsedMs}ms)`),res.setHeader(`Content-Type`,`application/json`),res.setHeader(`Content-Disposition`,`attachment; filename="${filename}"`),size>0&&res.setHeader(`Content-Length`,String(size)),res.setHeader(`X-Snapshot-Capture-Ms`,String(elapsedMs));let cleanup=()=>{unlink(written,err=>{err&&log.warn(`Failed to delete heap snapshot ${written}: ${err.message}`),snapshotInProgress=!1})},stream=createReadStream(written);stream.on(`end`,cleanup),stream.on(`error`,err=>{log.error({err},`heap snapshot stream failed`),res.headersSent||res.status(500).end(),cleanup()}),res.on(`close`,()=>{stream.destroy()}),stream.pipe(res)}),router.post(`/memory/gc`,(_req,res)=>{let gc=globalThis.gc;if(typeof gc!=`function`){res.status(412).json({error:`global.gc unavailable — start Node with --expose-gc to enable this endpoint`});return}let before=process.memoryUsage().heapUsed,startedAt=Date.now();try{gc()}catch(err){res.status(500).json({error:`forced GC failed`,message:err instanceof Error?err.message:String(err)});return}let after=process.memoryUsage().heapUsed,reclaimedBytes=Math.max(0,before-after),elapsedMs=Date.now()-startedAt;log.info(`Forced GC reclaimed ${(reclaimedBytes/1024/1024).toFixed(2)} MiB in ${elapsedMs}ms`),res.json({before,after,reclaimedBytes,elapsedMs})}),router.get(`/tabs`,(_req,res)=>{let kickApp=appRef?.__kickApp;if(!kickApp){res.status(503).json({error:`tabs unavailable — application surface not exposed`});return}res.json(collectDevtoolsTabs(kickApp))}),router.get(`/topology`,async(_req,res)=>{if(!container){res.status(503).json({error:`topology unavailable — container not bound yet`});return}let kickApp=appRef?.__kickApp;if(!kickApp){res.status(503).json({error:`topology unavailable — application surface not exposed`});return}try{let snapshot=await collectTopologySnapshot({app:kickApp,container});res.json(snapshot)}catch(err){let message=err instanceof Error?err.message:String(err);res.status(500).json({error:`topology collection failed`,message})}}),router.get(`/ws`,(_req,res)=>{let wsAdapter=getPeerAdapters().find(a=>a.name===`WsAdapter`&&typeof a.getStats==`function`);if(!wsAdapter){res.json({enabled:!1,message:`WsAdapter not found`});return}res.json({enabled:!0,...wsAdapter.getStats()})}),router.get(`/queues`,async(_req,res)=>{let queueAdapter=getPeerAdapters().find(a=>a.name===`QueueAdapter`&&typeof a.getQueueNames==`function`);if(!queueAdapter){res.json({enabled:!1,message:`QueueAdapter not found`});return}try{let names=queueAdapter.getQueueNames?.()??[],queues=[];for(let name of names){let stats=await queueAdapter.getQueueStats?.(name);queues.push({name,...stats})}res.json({enabled:!0,queues})}catch{res.json({enabled:!0,queues:[],error:`Failed to fetch queue stats`})}}),router.get(`/graph`,(_req,res)=>{let registrations=container?.getRegistrations()??[],nodes=registrations.filter(r=>!r.token.startsWith(`__hmr__`)).map(r=>({id:r.token,kind:r.kind,scope:r.scope,resolveCount:r.resolveCount})),nodeIds=new Set(nodes.map(n=>n.id)),edges=[];for(let r of registrations)if(!r.token.startsWith(`__hmr__`))for(let dep of r.dependencies)nodeIds.has(dep)&&edges.push({from:r.token,to:dep});res.json({nodes,edges})}),router.get(`/stream`,(req,res)=>{res.writeHead(200,{"Content-Type":`text/event-stream`,"Cache-Control":`no-cache`,Connection:`keep-alive`});let sendMetrics=()=>{let data={type:`metrics`,requestCount:requestCount.value,errorCount:errorCount.value,clientErrorCount:clientErrorCount.value,errorRate:errorRate.value,uptimeSeconds:uptimeSeconds.value};res.write(`data: ${JSON.stringify(data)}\n\n`)};sendMetrics();let unsubContainer=container?.onChange?.(changes=>{res.write(`data: ${JSON.stringify({type:`container`,changes,timestamp:Date.now()})}\n\n`),sendMetrics()}),stopRequestWatch=watch(requestCount,()=>sendMetrics()),stopErrWatch=watch(errorCount,()=>sendMetrics()),heartbeat=setInterval(()=>{res.write(`: heartbeat
 
+`)},3e4);req.on(`close`,()=>{unsubContainer?.(),stopRequestWatch(),stopErrWatch(),clearInterval(heartbeat)})}),exposeConfig&&router.get(`/config`,(_req,res)=>{let config={};for(let[key,value]of Object.entries(process.env))value!==void 0&&(config[key]=configPrefixes.some(prefix=>key.startsWith(prefix))?value:`[REDACTED]`);res.json({config})});let publicDir=resolvePublicDir();if(publicDir){router.use(static$1(publicDir));let indexHtml=readFileSync(join(publicDir,`index.html`),`utf-8`);router.get(`/`,(_req,res)=>{let html=indexHtml.replace(`<body`,`<body data-base="${basePath}"`);res.type(`html`).send(html)})}else router.get(`/`,(_req,res)=>{res.type(`html`).send(`<h1>DevTools: public directory not found</h1>`)});app.use(basePath,router),secret?(log.info(`DevTools mounted at ${basePath} [token: ${secret}]`),log.info(`Access: ${basePath}?token=${secret}`)):log.info(`DevTools mounted at ${basePath} [no guard]`)},middleware(){return enabled?[{handler:(req,res,next)=>{let start=Date.now();requestCount.value++,res.on(`finish`,()=>{res.statusCode>=500?errorCount.value++:res.statusCode>=400&&clientErrorCount.value++;let routeKey=`${req.method} ${req.route?.path??req.path}`,elapsed=Date.now()-start;routeLatency[routeKey]||(routeLatency[routeKey]={count:0,totalMs:0,minMs:1/0,maxMs:0,samples:[]});let stats=routeLatency[routeKey];stats.count++,stats.totalMs+=elapsed,stats.minMs=Math.min(stats.minMs,elapsed),stats.maxMs=Math.max(stats.maxMs,elapsed),stats.samples.push(elapsed),stats.samples.length>1e3&&stats.samples.shift()}),next()},phase:`beforeGlobal`}]:[]},onRouteMount(controllerClass,mountPath){if(!enabled)return;let collectedRoutes=getClassMeta(METADATA.ROUTES,controllerClass,[]),classMiddleware=getClassMeta(METADATA.CLASS_MIDDLEWARES,controllerClass,[]);for(let route of collectedRoutes){let methodMiddleware=getMethodMeta(METADATA.METHOD_MIDDLEWARES,controllerClass.prototype,route.handlerName,[]);routes.push({method:route.method.toUpperCase(),path:`${mountPath}${route.path===`/`?``:route.path}`,controller:controllerClass.name,handler:route.handlerName,middleware:[...classMiddleware.map(m=>m.name||`anonymous`),...methodMiddleware.map(m=>m.name||`anonymous`)]})}},afterStart({server}){enabled&&(server&&bus?.attachUpgrade(server),log.info(`DevTools ready — ${routes.length} routes tracked, ${container?.getRegistrations().length??0} DI bindings, event bus on ${basePath}/_bus`))},shutdown(){stopErrorWatch?.(),runtimeSampler?.stop(),memoryAnalyzer?.stop(),bus?.close(),adapterStatuses.DevToolsAdapter=`stopped`}}}});export{DevToolsAdapter};
 //# sourceMappingURL=index.mjs.map