silgi 0.1.0-beta.13 → 0.1.0-beta.14

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/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

@@ -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.