@zintrust/trace 0.5.4 → 0.5.7

package/src/watchers/AuthWatcher.ts

@@ -9,10 +9,11 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (event: AuthContent['event'], userId?: string): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: AuthContent = {
     event,
     userId,
@@ -42,9 +43,11 @@ export const AuthWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze(
     if (config.watchers.auth === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/BatchWatcher.ts

@@ -5,6 +5,7 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (
   name: string,
@@ -14,7 +15,7 @@ const emit = (
   status: BatchContent['status']
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const tags = [name];
   if (failed > 0) tags.push('failed');
   const content: BatchContent = {
@@ -44,9 +45,11 @@ export const BatchWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze
     if (config.watchers.batch === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/CacheWatcher.ts

@@ -13,6 +13,7 @@ let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _config: ITraceWatcherConfig['config'] | null = null;
 let _redactionFields: string[] = [];
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (
   operation: CacheContent['operation'],
@@ -24,7 +25,7 @@ const emit = (
   ttl?: number
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const safeKey = redactString(key, _redactionFields);
   const shouldLogPayload = _config?.captureCachePayloads === true;
   const content: CacheContent = {
@@ -60,10 +61,12 @@ export const CacheWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze
     _config = config;
     _redactionFields = config.redaction.query;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _config = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/CommandWatcher.ts

@@ -7,6 +7,7 @@ import { RequestFilter } from '../utils/requestFilter';
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _redactKeys: string[] = [];
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (
   name: string,
@@ -16,7 +17,7 @@ const emit = (
   output?: string
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const tags = [name];
   if (exitCode !== 0) tags.push('failed');
   const content: CommandContent = {
@@ -47,9 +48,11 @@ export const CommandWatcher: ITraceWatcher & { emit: typeof emit } = Object.free
     _storage = storage;
     _redactKeys = [...(config.redaction?.keys ?? []), ...(config.redaction?.body ?? [])];
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/DumpWatcher.ts

@@ -6,11 +6,12 @@ import { RequestFilter } from '../utils/requestFilter';
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _enabled = false;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 /** Explicitly opt-in (enabled only when config.watchers.dump === true, not just non-false). */
 const emit = (value: unknown, file?: string, line?: number): void => {
   if (!_storage || !_enabled) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: DumpContent = { value, file, line, hostname: TraceContext.getHostname() };
   _storage
     .writeEntry({
@@ -33,10 +34,12 @@ export const DumpWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze(
     _storage = storage;
     _enabled = true;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _enabled = false;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/EventWatcher.ts

@@ -6,10 +6,11 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (name: string, listenerCount: number, payload?: unknown): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: EventContent = {
     name,
     payload,
@@ -35,9 +36,11 @@ export const EventWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze
     if (config.watchers.event === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/ExceptionWatcher.ts

@@ -50,6 +50,7 @@ const buildContent = (err: Error, context?: ExceptionCaptureContext): ExceptionC
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _listenerRefCount = 0;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const handleUncaughtException = (error: unknown): void => {
   captureException(error);
@@ -76,8 +77,8 @@ const captureException = (err: unknown, context?: ExceptionCaptureContext): void
   if (!storage) return;
   if (!(err instanceof Error)) return;
   if (context?.path !== undefined) {
-    if (RequestFilter.matchesIgnoredPath(context.path, _ignoreRoutes)) return;
-  } else if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) {
+    if (RequestFilter.matchesIgnoredPath(context.path, _ignoreRoutes, _ignorePath)) return;
+  } else if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) {
     return;
   }
 
@@ -109,6 +110,7 @@ export const ExceptionWatcher: ITraceWatcher & {
     if (config.watchers.exception === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
 
     if (_listenerRefCount === 0) {
       registerProcessListeners();
@@ -122,6 +124,7 @@ export const ExceptionWatcher: ITraceWatcher & {
       }
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/GateWatcher.ts

@@ -5,6 +5,7 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (
   ability: string,
@@ -13,7 +14,7 @@ const emit = (
   subject?: string
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const tags: string[] = [ability, result];
   if (userId) tags.push(`Auth:${userId}`);
   const content: GateContent = {
@@ -42,9 +43,11 @@ export const GateWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze(
     if (config.watchers.gate === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/HttpClientWatcher.ts

@@ -16,6 +16,7 @@ let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _redactHeaderNames: string[] = [];
 let _redactBodyFields: string[] = [];
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 let _clientRequestWatcher: TraceClientRequestWatcherConfig | undefined;
 
 const isObjectValue = (value: unknown): value is Record<string, unknown> => {
@@ -158,7 +159,7 @@ const emit = ({
   error,
 }: ClientRequestTraceInput): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const normalizedSource = resolveSource(source);
   const sourceRule = resolveSourceRule(normalizedSource);
   if (sourceRule?.enabled === false) return;
@@ -206,11 +207,13 @@ export const HttpClientWatcher: ITraceWatcher & { emit: typeof emit } = Object.f
     _redactHeaderNames = [...(config.redaction?.keys ?? []), ...(config.redaction?.headers ?? [])];
     _redactBodyFields = [...(config.redaction?.keys ?? []), ...(config.redaction?.body ?? [])];
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _clientRequestWatcher = undefined;
       _redactBodyFields = [];
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/HttpWatcher.ts

@@ -164,7 +164,7 @@ const buildEntry = (
 };
 
 const shouldIgnore = (req: IRequest, config: ITraceConfig): boolean => {
-  return RequestFilter.matchesIgnoredPath(req.getPath(), config.ignoreRoutes);
+  return RequestFilter.matchesIgnoredPath(req.getPath(), config);
 };
 
 const isWatcherEnabled = (config: ITraceConfig): boolean => config.watchers.request !== false;

package/src/watchers/JobWatcher.ts

@@ -12,6 +12,7 @@ import { parseStackFrameLine } from '../utils/stackFrame';
 // Module-level storage ref so emit helpers can be called from outside.
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 const MAX_TRACKED_JOBS = 1000;
 
 type PendingJob = { uuid: string; content: JobContent };
@@ -43,7 +44,7 @@ const takePendingJob = (name: string): PendingJob | null => {
 
 const emitDispatch = (name: string, queue: string, connection: string, data?: unknown): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const uuid = crypto.randomUUID();
   const content: JobContent = {
     status: 'pending',
@@ -112,9 +113,11 @@ export const JobWatcher: ITraceWatcher & {
     if (config.watchers.job === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
       pendingJobs.clear();
     };
   },

package/src/watchers/LogWatcher.ts

@@ -82,7 +82,8 @@ export const LogWatcher: ITraceWatcher = Object.freeze({
     const unsubscribe = loggerWithSink.addSink(
       (level: string, message: string, context?: Record<string, unknown>) => {
         if ((LEVEL_PRIORITY[level] ?? 0) < minPriority) return;
-        if (RequestFilter.shouldIgnoreCurrentRequest(config.ignoreRoutes)) return;
+        if (RequestFilter.shouldIgnoreCurrentRequest(config.ignoreRoutes, config.ignorePath))
+          return;
         if (shouldSkipTraceInfrastructureLog(message, context)) return;
 
         const content: LogContent = {

package/src/watchers/MailWatcher.ts

@@ -10,6 +10,7 @@ import { RequestFilter } from '../utils/requestFilter';
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _redactionFields: string[] = [];
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (
   to: string,
@@ -19,7 +20,7 @@ const emit = (
   html?: string
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: MailContent = {
     to,
     subject,
@@ -53,10 +54,12 @@ export const MailWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze(
     _storage = storage;
     _redactionFields = [...config.redaction.keys, ...config.redaction.body];
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _redactionFields = [];
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/MiddlewareWatcher.ts

@@ -5,6 +5,7 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 type GlobalMiddlewareTraceState = {
   __zintrust_trace_middleware_emit__?: typeof emit;
@@ -12,7 +13,7 @@ type GlobalMiddlewareTraceState = {
 
 const emit = (name: string, event: MiddlewareContent['event'], duration?: number): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: MiddlewareContent = {
     name,
     event,
@@ -38,6 +39,7 @@ export const MiddlewareWatcher: ITraceWatcher & { emit: typeof emit } = Object.f
     if (config.watchers.middleware === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     (globalThis as unknown as GlobalMiddlewareTraceState).__zintrust_trace_middleware_emit__ = emit;
     return () => {
       const globalState = globalThis as unknown as GlobalMiddlewareTraceState;
@@ -46,6 +48,7 @@ export const MiddlewareWatcher: ITraceWatcher & { emit: typeof emit } = Object.f
       }
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/ModelWatcher.ts

@@ -5,6 +5,7 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 type GlobalModelTraceState = {
   __zintrust_trace_model_emit__?: typeof emit;
@@ -17,7 +18,7 @@ const emit = (
   changes?: Record<string, unknown>
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: ModelContent = {
     action,
     model,
@@ -44,6 +45,7 @@ export const ModelWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze
     if (config.watchers.model === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     (globalThis as unknown as GlobalModelTraceState).__zintrust_trace_model_emit__ = emit;
     return () => {
       const globalState = globalThis as unknown as GlobalModelTraceState;
@@ -52,6 +54,7 @@ export const ModelWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze
       }
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/NotificationWatcher.ts

@@ -8,6 +8,7 @@ import { RequestFilter } from '../utils/requestFilter';
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _redactionFields: string[] = [];
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (
   notification: string,
@@ -17,7 +18,7 @@ const emit = (
   payload?: unknown
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: NotificationContent = {
     notification,
     channels,
@@ -48,10 +49,12 @@ export const NotificationWatcher: ITraceWatcher & { emit: typeof emit } = Object
     _storage = storage;
     _redactionFields = [...config.redaction.keys, ...config.redaction.body];
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _redactionFields = [];
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/QueryWatcher.ts

@@ -33,7 +33,7 @@ const isTraceStorageQuery = (sql: string): boolean => {
 
 const emit = (query: string, params: unknown[], duration: number, connection = 'default'): void => {
   if (_storage === null || _config === null) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_config.ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_config.ignoreRoutes, _config.ignorePath)) return;
   if (isTraceStorageQuery(query)) return;
 
   const batchId = TraceContext.getBatchId();

package/src/watchers/RedisWatcher.ts

@@ -6,11 +6,12 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 /** Emit a redis command trace. Key/value payload is intentionally omitted for security. */
 const emit = (command: string, duration: number): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: RedisContent = { command, duration, hostname: TraceContext.getHostname() };
   _storage
     .writeEntry({
@@ -31,9 +32,11 @@ export const RedisWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze
     if (config.watchers.redis === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/ScheduleWatcher.ts

@@ -8,6 +8,7 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (
   name: string,
@@ -17,7 +18,7 @@ const emit = (
   output?: string
 ): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: ScheduleContent = {
     name,
     expression,
@@ -46,9 +47,11 @@ export const ScheduleWatcher: ITraceWatcher & { emit: typeof emit } = Object.fre
     if (config.watchers.schedule === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });

package/src/watchers/ViewWatcher.ts

@@ -5,10 +5,11 @@ import { RequestFilter } from '../utils/requestFilter';
 
 let _storage: ITraceWatcherConfig['storage'] | null = null;
 let _ignoreRoutes: string[] = [];
+let _ignorePath: string[] = [];
 
 const emit = (template: string, duration: number): void => {
   if (!_storage) return;
-  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes)) return;
+  if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath)) return;
   const content: ViewContent = { template, duration, hostname: TraceContext.getHostname() };
   _storage
     .writeEntry({
@@ -29,9 +30,11 @@ export const ViewWatcher: ITraceWatcher & { emit: typeof emit } = Object.freeze(
     if (config.watchers.view === false) return () => undefined;
     _storage = storage;
     _ignoreRoutes = config.ignoreRoutes;
+    _ignorePath = config.ignorePath;
     return () => {
       _storage = null;
       _ignoreRoutes = [];
+      _ignorePath = [];
     };
   },
 });