silgi 0.1.0-beta.12 → 0.1.0-beta.14

package/dist/client/adapters/fetch/index.d.mts

@@ -5,10 +5,6 @@ interface RPCLinkOptions<TClientContext extends ClientContext = ClientContext> {
   url: string | URL;
   headers?: Record<string, string> | ((options: ClientOptions<TClientContext>) => Record<string, string>);
   fetch?: typeof globalThis.fetch;
-  method?: 'GET' | 'POST';
-  maxUrlLength?: number;
-  /** Route metadata — pass extractRoutes(router) or the full router. Required when procedures use $route({ path }) */
-  routes?: unknown;
 }
 declare class RPCLink<TClientContext extends ClientContext = ClientContext> implements ClientLink<TClientContext> {
   #private;

package/dist/client/adapters/fetch/index.mjs

@@ -1,5 +1,4 @@
 import { SilgiError, fromSilgiErrorJSON, isErrorStatus, isSilgiErrorJSON } from "../../../core/error.mjs";
-import { resolveRoute, substituteParams } from "../../../core/router-utils.mjs";
 import { parseEmptyableJSON, stringifyJSON } from "../../../core/utils.mjs";
 //#region src/client/adapters/fetch/index.ts
 /**
@@ -9,46 +8,22 @@ var RPCLink = class {
 	#baseUrl;
 	#headers;
 	#fetch;
-	#method;
-	#maxUrlLength;
-	#routes;
 	constructor(options) {
 		this.#baseUrl = typeof options.url === "string" ? options.url : options.url.href;
 		if (this.#baseUrl.endsWith("/")) this.#baseUrl = this.#baseUrl.slice(0, -1);
 		this.#headers = options.headers;
 		this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
-		this.#method = options.method ?? "POST";
-		this.#maxUrlLength = options.maxUrlLength ?? 2083;
-		this.#routes = options.routes;
 	}
 	async call(path, input, options) {
-		const resolved = this.#routes ? resolveRoute(this.#routes, path) : void 0;
-		let urlPath = resolved ? resolved.path : "/" + path.map(encodeURIComponent).join("/");
-		if (resolved) {
-			const sub = substituteParams(urlPath, input);
-			urlPath = sub.url;
-			input = sub.remainingInput;
-		}
-		let url = `${this.#baseUrl}${urlPath}`;
+		const url = `${this.#baseUrl}/${path.map(encodeURIComponent).join("/")}`;
 		const headers = { ...typeof this.#headers === "function" ? this.#headers(options) : this.#headers };
-		let method = resolved?.method ?? this.#method;
 		let body;
-		const hasInput = input !== void 0 && input !== null;
-		if (method === "GET" && hasInput) {
-			const data = stringifyJSON(input);
-			const candidateUrl = `${url}?data=${encodeURIComponent(data)}`;
-			if (candidateUrl.length <= this.#maxUrlLength) url = candidateUrl;
-			else {
-				method = "POST";
-				headers["content-type"] = "application/json";
-				body = data;
-			}
-		} else if (hasInput) {
+		if (input !== void 0 && input !== null) {
 			headers["content-type"] = "application/json";
 			body = stringifyJSON(input);
 		}
 		const response = await this.#fetch(url, {
-			method,
+			method: "POST",
 			headers,
 			body,
 			signal: options.signal

package/dist/client/adapters/ofetch/index.d.mts

@@ -36,8 +36,6 @@ interface LinkOptions<TClientContext extends ClientContext = ClientContext> {
   onResponse?: FetchOptions['onResponse'];
   onRequestError?: FetchOptions['onRequestError'];
   onResponseError?: FetchOptions['onResponseError'];
-  /** Route metadata — pass extractRoutes(router), the full router, or a Promise that resolves to routes. Required when procedures use $route({ path }) */
-  routes?: unknown | Promise<unknown>;
 }
 /**
  * Create a Silgi client link powered by ofetch.

package/dist/client/adapters/ofetch/index.mjs

@@ -1,5 +1,4 @@
 import { SilgiError, fromSilgiErrorJSON, isSilgiErrorJSON } from "../../../core/error.mjs";
-import { resolveRoute, substituteParams } from "../../../core/router-utils.mjs";
 import { MSGPACK_CONTENT_TYPE, decode, encode } from "../../../codec/msgpack.mjs";
 import { FetchError, ofetch } from "ofetch";
 //#region src/client/adapters/ofetch/index.ts
@@ -28,22 +27,8 @@ function createLink(options) {
 	const defaultRetry = options.retry;
 	const defaultRetryDelay = options.retryDelay ?? 0;
 	const resolvedProtocol = options.protocol ?? (options.binary ? "messagepack" : void 0) ?? (options.devalue ? "devalue" : void 0) ?? "json";
-	let resolvedRoutes = void 0;
-	const routesOption = options.routes;
-	if (routesOption && typeof routesOption?.then === "function") routesOption.then((r) => {
-		resolvedRoutes = r;
-	});
-	else resolvedRoutes = routesOption;
 	return { async call(path, input, callOptions) {
-		if (routesOption && !resolvedRoutes && typeof routesOption?.then === "function") resolvedRoutes = await routesOption;
-		const resolved = resolvedRoutes ? resolveRoute(resolvedRoutes, path) : void 0;
-		let urlPath = resolved ? resolved.path : "/" + path.map(encodeURIComponent).join("/");
-		if (resolved) {
-			const sub = substituteParams(urlPath, input);
-			urlPath = sub.url;
-			input = sub.remainingInput;
-		}
-		const url = `${baseUrl}${urlPath}`;
+		const url = `${baseUrl}/${path.map(encodeURIComponent).join("/")}`;
 		const headers = { ...typeof options.headers === "function" ? options.headers(callOptions) : options.headers };
 		let body;
 		if (resolvedProtocol === "messagepack") {
@@ -58,7 +43,7 @@ function createLink(options) {
 		} else body = input !== void 0 && input !== null ? input : void 0;
 		try {
 			const data = await ofetch(url, {
-				method: resolved?.method ?? "POST",
+				method: "POST",
 				headers,
 				body,
 				signal: callOptions.signal,

package/dist/client/openapi.mjs

@@ -13,7 +13,7 @@ import { SilgiError } from "../core/error.mjs";
 *
 * const link = new OpenAPILink({
 *   url: "https://api.example.com",
-*   spec: await fetch("/openapi.json").then(r => r.json()),
+*   spec: await fetch("/api/openapi.json").then(r => r.json()),
 * })
 *
 * const client = createClient<ExternalAPI>(link)

package/dist/client/server.mjs

@@ -1,4 +1,3 @@
-import { resolveRoute } from "../core/router-utils.mjs";
 import { compileRouter } from "../compile.mjs";
 //#region src/client/server.ts
 /**
@@ -31,9 +30,7 @@ function createServerClient(router, options) {
 function createServerProxy(router, flatRouter, contextFactory, path) {
 	const cache = /* @__PURE__ */ new Map();
 	const callProcedure = async (input) => {
-		const resolved = resolveRoute(router, path);
-		const routePath = resolved?.path ?? "/" + path.join("/");
-		const route = flatRouter(resolved?.method ?? "POST", routePath)?.data;
+		const route = flatRouter("POST", "/" + path.join("/"))?.data;
 		if (!route) throw new Error(`Procedure not found: ${path.join("/")}`);
 		const ctx = Object.create(null);
 		const baseCtx = await contextFactory();

package/dist/core/context-bridge.mjs

@@ -0,0 +1,11 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/core/context-bridge.ts
+const ctxStorage = new AsyncLocalStorage();
+function runWithCtx(ctx, fn) {
+	return ctxStorage.run(ctx, fn);
+}
+function getCtx() {
+	return ctxStorage.getStore();
+}
+//#endregion
+export { getCtx, runWithCtx };

package/dist/core/handler.mjs

@@ -3,6 +3,7 @@ import { compileRouter, createContext, releaseContext } from "../compile.mjs";
 import { applyContext } from "./dispatch.mjs";
 import { analyticsTraceMap } from "../plugins/analytics.mjs";
 import { detectResponseFormat, encodeResponse, makeErrorResponse } from "./codec.mjs";
+import { runWithCtx } from "./context-bridge.mjs";
 import { parseInput } from "./input.mjs";
 import { iteratorToEventStream } from "./sse.mjs";
 //#region src/core/handler.ts
@@ -128,7 +129,7 @@ function createFetchHandler(routerDef, contextFactory, hooks) {
 				path: pathname,
 				input: rawInput
 			});
-			const pipelineResult = route.handler(ctx, rawInput, request.signal);
+			const pipelineResult = runWithCtx(ctx, () => route.handler(ctx, rawInput, request.signal));
 			const output = pipelineResult instanceof Promise ? await pipelineResult : pipelineResult;
 			callHook("response", {
 				path: pathname,

package/dist/core/router-utils.mjs

@@ -18,86 +18,5 @@ function assignPaths(def, prefix = []) {
 	}
 	return result;
 }
-/**
-* Extract route metadata from a router definition.
-* Returns a lightweight nested object safe for client bundles — no resolve functions,
-* no guards, no schemas, no server code.
-*
-* ```ts
-* // server/routes.ts — import this on the client
-* export const routes = extractRoutes(appRouter)
-* ```
-*/
-function extractRoutes(def, prefix = []) {
-	const result = {};
-	if (def == null || typeof def !== "object") return result;
-	for (const [key, value] of Object.entries(def)) {
-		const route = getRouteFromEntry(value);
-		if (route?.path) result[key] = {
-			path: route.path,
-			method: (route.method ?? "POST").toUpperCase()
-		};
-		else if (typeof value === "object" && value !== null && !isProcedureDef(value)) {
-			const nested = extractRoutes(value, [...prefix, key]);
-			if (Object.keys(nested).length > 0) result[key] = nested;
-		}
-	}
-	return result;
-}
-/** Extract route metadata from a ProcedureDef or ProcedureContract */
-function getRouteFromEntry(value) {
-	if (typeof value !== "object" || value === null) return void 0;
-	const obj = value;
-	if (isProcedureDef(value)) return obj.route;
-	if ("route" in obj && typeof obj.route === "object" && obj.route !== null) return obj.route;
-}
-/** Check if a value is an extracted route leaf (has path + method, not a nested object) */
-function isExtractedRoute(value) {
-	return typeof value === "object" && value !== null && "path" in value && "method" in value && !("resolve" in value);
-}
-/** Walk a route tree by path segments and return the route metadata. Works with both full routers and extracted routes. */
-function resolveRoute(routes, path) {
-	let current = routes;
-	for (const segment of path) {
-		if (current == null || typeof current !== "object") return void 0;
-		current = current[segment];
-	}
-	if (isExtractedRoute(current)) return current;
-	const route = getRouteFromEntry(current);
-	if (route?.path) return {
-		path: route.path,
-		method: (route.method ?? "POST").toUpperCase()
-	};
-}
-/**
-* Substitute :param placeholders in a route path with values from input.
-* Returns the resolved URL path and the input with used params removed.
-*/
-function substituteParams(routePath, input) {
-	if (input == null || typeof input !== "object" || Array.isArray(input)) return {
-		url: routePath,
-		remainingInput: input
-	};
-	const obj = input;
-	const used = /* @__PURE__ */ new Set();
-	const url = routePath.replace(/:([a-zA-Z_]\w*)/g, (_match, name) => {
-		const val = obj[name];
-		if (val !== void 0) {
-			used.add(name);
-			return encodeURIComponent(String(val));
-		}
-		return `:${name}`;
-	});
-	if (used.size === 0) return {
-		url,
-		remainingInput: input
-	};
-	const remaining = {};
-	for (const key of Object.keys(obj)) if (!used.has(key)) remaining[key] = obj[key];
-	return {
-		url,
-		remainingInput: Object.keys(remaining).length > 0 ? remaining : void 0
-	};
-}
 //#endregion
-export { assignPaths, extractRoutes, isProcedureDef, resolveRoute, routerCache, substituteParams };
+export { assignPaths, isProcedureDef, routerCache };

package/dist/core/serve.d.mts

@@ -22,9 +22,9 @@ interface SilgiServer {
 interface ServeOptions {
   port?: number;
   hostname?: string;
-  /** Enable Scalar API Reference UI at /reference and /openapi.json */
+  /** Enable Scalar API Reference UI at /api/reference and /api/openapi.json */
   scalar?: boolean | ScalarOptions;
-  /** Enable analytics dashboard at /analytics */
+  /** Enable analytics dashboard at /api/analytics */
   analytics?: boolean | AnalyticsOptions;
   /** Enable WebSocket RPC (requires crossws) */
   ws?: boolean | WSAdapterOptions;

package/dist/core/serve.mjs

@@ -50,8 +50,8 @@ async function createServeHandler(routerDef, contextFactory, hooks, options) {
 	console.log(`\nSilgi server running at ${url}`);
 	if (options?.http2) console.log(`  HTTP/2 enabled (with HTTP/1.1 fallback)`);
 	if (options?.ws) console.log(`  WebSocket RPC at ws://${hostname}:${resolvedPort}`);
-	if (options?.scalar) console.log(`  Scalar API Reference at ${url}/reference`);
-	if (options?.analytics) console.log(`  Analytics dashboard at ${url}/analytics`);
+	if (options?.scalar) console.log(`  Scalar API Reference at ${url}/api/reference`);
+	if (options?.analytics) console.log(`  Analytics dashboard at ${url}/api/analytics`);
 	console.log();
 	await hooks.callHook("serve:start", {
 		url,

package/dist/index.d.mts

@@ -13,6 +13,5 @@ import { CallableOptions, callable } from "./callable.mjs";
 import { LifecycleHooks, lifecycleWrap } from "./lifecycle.mjs";
 import { mapInput } from "./map-input.mjs";
 import { compileProcedure, compileRouter, createContext } from "./compile.mjs";
-import { ExtractedRoute, ExtractedRoutes, extractRoutes } from "./core/router-utils.mjs";
 import { LazyRouter, isLazy, lazy, resolveLazy } from "./lazy.mjs";
-export { type AnySchema, AsyncIteratorClass, type CallableOptions, type Driver, type ErrorDef, type ErrorDefItem, type EventMeta, type ExtractedRoute, type ExtractedRoutes, type FailFn, type GuardDef, type GuardFn, type InferClient, type InferContextFromUse, type InferGuardOutput, type InferSchemaInput, type InferSchemaOutput, type LazyRouter, type LifecycleHooks, type Meta, type MiddlewareDef, type ProcedureBuilder, type ProcedureBuilderWithOutput, type ProcedureDef, type ProcedureType, type ResolveContext, type RouterDef, type ScalarOptions, type ScheduledTaskInfo, type Schema, type ServeOptions, type SilgiConfig, SilgiError, type SilgiErrorCode, type SilgiErrorJSON, type SilgiErrorOptions, type SilgiInstance, type SilgiServer, type Storage, type StorageConfig, type StorageValue, type TaskDef, type TaskEvent, ValidationError, type WrapDef, type WrapFn, callable, collectCronTasks, compileProcedure, compileRouter, createContext, extractRoutes, generateOpenAPI, getEventMeta, getScheduledTasks, initStorage, isDefinedError, isLazy, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };
+export { type AnySchema, AsyncIteratorClass, type CallableOptions, type Driver, type ErrorDef, type ErrorDefItem, type EventMeta, type FailFn, type GuardDef, type GuardFn, type InferClient, type InferContextFromUse, type InferGuardOutput, type InferSchemaInput, type InferSchemaOutput, type LazyRouter, type LifecycleHooks, type Meta, type MiddlewareDef, type ProcedureBuilder, type ProcedureBuilderWithOutput, type ProcedureDef, type ProcedureType, type ResolveContext, type RouterDef, type ScalarOptions, type ScheduledTaskInfo, type Schema, type ServeOptions, type SilgiConfig, SilgiError, type SilgiErrorCode, type SilgiErrorJSON, type SilgiErrorOptions, type SilgiInstance, type SilgiServer, type Storage, type StorageConfig, type StorageValue, type TaskDef, type TaskEvent, ValidationError, type WrapDef, type WrapFn, callable, collectCronTasks, compileProcedure, compileRouter, createContext, generateOpenAPI, getEventMeta, getScheduledTasks, initStorage, isDefinedError, isLazy, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };

package/dist/index.mjs

@@ -1,7 +1,6 @@
 import { ValidationError, type, validateSchema } from "./core/schema.mjs";
 import { collectCronTasks, getScheduledTasks, runTask, setTaskAnalytics, startCronJobs, stopCronJobs } from "./core/task.mjs";
 import { SilgiError, isDefinedError, toSilgiError } from "./core/error.mjs";
-import { extractRoutes } from "./core/router-utils.mjs";
 import { compileProcedure, compileRouter, createContext } from "./compile.mjs";
 import { initStorage, resetStorage, useStorage } from "./core/storage.mjs";
 import { AsyncIteratorClass, mapAsyncIterator } from "./core/iterator.mjs";
@@ -12,4 +11,4 @@ import { lifecycleWrap } from "./lifecycle.mjs";
 import { mapInput } from "./map-input.mjs";
 import { isLazy, lazy, resolveLazy } from "./lazy.mjs";
 import { generateOpenAPI, scalarHTML } from "./scalar.mjs";
-export { AsyncIteratorClass, SilgiError, ValidationError, callable, collectCronTasks, compileProcedure, compileRouter, createContext, extractRoutes, generateOpenAPI, getEventMeta, getScheduledTasks, initStorage, isDefinedError, isLazy, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };
+export { AsyncIteratorClass, SilgiError, ValidationError, callable, collectCronTasks, compileProcedure, compileRouter, createContext, generateOpenAPI, getEventMeta, getScheduledTasks, initStorage, isDefinedError, isLazy, lazy, lifecycleWrap, mapAsyncIterator, mapInput, resetStorage, resolveLazy, runTask, scalarHTML, setTaskAnalytics, silgi, startCronJobs, stopCronJobs, toSilgiError, type, useStorage, validateSchema, withEventMeta };

package/dist/integrations/better-auth/index.d.mts

@@ -1,24 +1,4 @@
 //#region src/integrations/better-auth/index.d.ts
-/**
- * Silgi + Better Auth tracing integration.
- *
- * Provides a Better Auth plugin factory that auto-traces all auth operations
- * (sign-in, sign-up, OAuth, session management, etc.) into silgi analytics.
- *
- * The silgi request context is passed via `request.__silgiCtx`, set by
- * the silgi auth handler before calling `auth.handler(request)`.
- *
- * @example
- * ```ts
- * import { tracing } from 'silgi/better-auth'
- *
- * const auth = betterAuth({
- *   plugins: [
- *     tracing(),  // auto-traces all auth operations
- *   ],
- * })
- * ```
- */
 interface TracingConfig {
   /** Capture request body as span input (default: true) */
   captureInput?: boolean;

package/dist/integrations/better-auth/index.mjs

@@ -1,4 +1,4 @@
-import { AsyncLocalStorage } from "node:async_hooks";
+import { getCtx, runWithCtx } from "../../core/context-bridge.mjs";
 //#region src/integrations/better-auth/index.ts
 /**
 * Silgi + Better Auth tracing integration.
@@ -20,7 +20,6 @@ import { AsyncLocalStorage } from "node:async_hooks";
 * })
 * ```
 */
-const ctxStorage = new AsyncLocalStorage();
 function matchOperation(path) {
 	const normalized = path.replace(/^\/+/, "");
 	if (normalized.endsWith("/sign-up/email") || normalized === "sign-up/email") return {
@@ -281,11 +280,11 @@ function instrumentBetterAuth(auth) {
 * Run a function with silgi context available to instrumented Better Auth API calls.
 */
 function withCtx(ctx, fn) {
-	return ctxStorage.run(ctx, fn);
+	return runWithCtx(ctx, fn);
 }
 function wrapApiMethod(originalFn, operation, method) {
 	return async function instrumented(...args) {
-		const reqTrace = ctxStorage.getStore()?.__analyticsTrace;
+		const reqTrace = getCtx()?.__analyticsTrace;
 		if (!reqTrace) return originalFn.apply(this, args);
 		const spanName = `auth.api.${operation}`;
 		const start = performance.now();

package/dist/integrations/drizzle/index.mjs

@@ -1,4 +1,4 @@
-import { AsyncLocalStorage } from "node:async_hooks";
+import { getCtx, runWithCtx } from "../../core/context-bridge.mjs";
 //#region src/integrations/drizzle/index.ts
 /**
 * Silgi + Drizzle ORM tracing integration.
@@ -31,7 +31,6 @@ import { AsyncLocalStorage } from "node:async_hooks";
 * })
 * ```
 */
-const ctxStorage = new AsyncLocalStorage();
 const INSTRUMENTED = "__silgiDrizzleInstrumented";
 const DEFAULT_DB_SYSTEM = "postgresql";
 const DEFAULT_MAX_QUERY_LENGTH = 1e3;
@@ -59,7 +58,7 @@ function instrumentDrizzle(db, config) {
 * All Drizzle queries inside `fn` will be recorded as trace spans.
 */
 function withCtx(ctx, fn) {
-	return ctxStorage.run(ctx, fn);
+	return runWithCtx(ctx, fn);
 }
 function resolveConfig(config) {
 	return {
@@ -84,7 +83,7 @@ function patchSession(session, cfg, isTx) {
 		session.prepareQuery = function patchedPrepareQuery(...args) {
 			const prepared = originalPrepareQuery.apply(this, args);
 			if (!prepared || typeof prepared.execute !== "function") return prepared;
-			const reqTrace = ctxStorage.getStore()?.__analyticsTrace;
+			const reqTrace = getCtx()?.__analyticsTrace;
 			if (!reqTrace) return prepared;
 			const queryText = extractQueryText(args[0]) ?? prepared.rawQueryConfig?.text ?? prepared.queryConfig?.text ?? null;
 			const originalExecute = prepared.execute.bind(prepared);
@@ -98,7 +97,7 @@ function patchSession(session, cfg, isTx) {
 	if (typeof session.query === "function") {
 		const originalQuery = session.query.bind(session);
 		session.query = function patchedQuery(queryString, params) {
-			const reqTrace = ctxStorage.getStore()?.__analyticsTrace;
+			const reqTrace = getCtx()?.__analyticsTrace;
 			if (!reqTrace) return originalQuery.call(this, queryString, params);
 			return traceExecution(reqTrace, cfg, queryString ?? null, isTx, originalQuery, this, [queryString, params]);
 		};
@@ -127,7 +126,7 @@ function patchRawClient(client, cfg) {
 	if (!methodName) return false;
 	const originalMethod = client[methodName].bind(client);
 	client[methodName] = function patchedClientMethod(...args) {
-		const reqTrace = ctxStorage.getStore()?.__analyticsTrace;
+		const reqTrace = getCtx()?.__analyticsTrace;
 		if (!reqTrace) return originalMethod.apply(this, args);
 		return traceExecution(reqTrace, cfg, extractQueryText(args[0]) ?? null, false, originalMethod, this, args);
 	};
@@ -141,7 +140,7 @@ function patchSessionExecute(session, cfg) {
 	if (session[INSTRUMENTED]) return false;
 	const originalExecute = session.execute.bind(session);
 	session.execute = function patchedDeepExecute(...args) {
-		const reqTrace = ctxStorage.getStore()?.__analyticsTrace;
+		const reqTrace = getCtx()?.__analyticsTrace;
 		if (!reqTrace) return originalExecute.apply(this, args);
 		return traceExecution(reqTrace, cfg, extractQueryText(args[0]) ?? null, false, originalExecute, this, args);
 	};

package/dist/plugins/analytics.d.mts

@@ -11,7 +11,7 @@ import { FetchHandler } from "../core/handler.mjs";
  * - HTTP-level request tracking with procedure grouping (batch support)
  * - Unique request IDs via `x-request-id` response header
  *
- * Dashboard at /analytics, JSON API at /analytics/api, errors at /analytics/errors.
+ * Dashboard at /api/analytics, JSON API at /api/analytics/stats, errors at /api/analytics/errors.
  */
 interface TimeWindow {
   time: number;
@@ -66,6 +66,7 @@ interface RequestEntry {
   timestamp: number;
   durationMs: number;
   method: string;
+  url: string;
   path: string;
   ip: string;
   headers: Record<string, string>;
@@ -93,12 +94,6 @@ interface AnalyticsOptions {
   bufferSize?: number;
   /** Time-series history in seconds (default: 120) */
   historySeconds?: number;
-  /** Max error entries to keep (default: 100) */
-  maxErrors?: number;
-  /** Max recent request entries to keep (default: 200) */
-  maxRequests?: number;
-  /** Max task execution entries to keep (default: 200) */
-  maxTasks?: number;
   /**
    * Protect dashboard access.
    * - `string` — secret token checked against `Authorization: Bearer <token>` header or `?token=` query param
@@ -108,6 +103,10 @@ interface AnalyticsOptions {
   auth?: string | ((req: Request) => boolean | Promise<boolean>);
   /** Interval in ms between storage flushes (default: 5000) */
   flushInterval?: number;
+  /** Days to retain entries in storage (default: 30). Entries older than this are pruned on flush. */
+  retentionDays?: number;
+  /** Path prefixes to exclude from tracking. Can also be managed at runtime via the dashboard or API. */
+  ignorePaths?: string[];
 }
 interface ProcedureSnapshot {
   count: number;
@@ -189,6 +188,13 @@ declare function trace<T>(ctx: Record<string, unknown>, name: string, fn: () =>
 declare class AnalyticsCollector {
   #private;
   constructor(options?: AnalyticsOptions);
+  /** Check if a path is server-side ignored (from config). */
+  isIgnored(pathname: string): boolean;
+  /** Check if a path is hidden in the dashboard (from runtime API). */
+  isHidden(pathname: string): boolean;
+  addHiddenPath(path: string): void;
+  removeHiddenPath(path: string): void;
+  getHiddenPaths(): string[];
   record(path: string, durationMs: number): void;
   recordError(path: string, durationMs: number, errorMsg: string): void;
   recordDetailedError(entry: Omit<ErrorEntry, 'id'>): void;
@@ -224,7 +230,7 @@ declare function sanitizeHeaders(headers: Headers): Record<string, string>;
 /** Return auth-failure response for analytics routes. */
 declare function analyticsAuthResponse(pathname: string): Response;
 /** Serve analytics dashboard and API routes. */
-declare function serveAnalyticsRoute(pathname: string, collector: AnalyticsCollector, dashboardHtml: string | undefined): Promise<Response>;
+declare function serveAnalyticsRoute(pathname: string, request: Request, collector: AnalyticsCollector, dashboardHtml: string | undefined): Promise<Response>;
 /**
  * Wrap a fetch handler with analytics collection.
  * Intercepts analytics dashboard routes and instruments every request.