@zintrust/trace 0.5.4 → 0.5.7

package/dist/watchers/MailWatcher.js

@@ -8,10 +8,11 @@ import { RequestFilter } from '../utils/requestFilter.js';
 let _storage = null;
 let _redactionFields = [];
 let _ignoreRoutes = [];
+let _ignorePath = [];
 const emit = (to, subject, template, text, html) => {
     if (!_storage)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath))
         return;
     const content = {
         to,
@@ -45,10 +46,12 @@ export const MailWatcher = Object.freeze({
         _storage = storage;
         _redactionFields = [...config.redaction.keys, ...config.redaction.body];
         _ignoreRoutes = config.ignoreRoutes;
+        _ignorePath = config.ignorePath;
         return () => {
             _storage = null;
             _redactionFields = [];
             _ignoreRoutes = [];
+            _ignorePath = [];
         };
     },
 });

package/dist/watchers/MiddlewareWatcher.js

@@ -3,10 +3,11 @@ import { EntryType } from '../types.js';
 import { RequestFilter } from '../utils/requestFilter.js';
 let _storage = null;
 let _ignoreRoutes = [];
+let _ignorePath = [];
 const emit = (name, event, duration) => {
     if (!_storage)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath))
         return;
     const content = {
         name,
@@ -33,6 +34,7 @@ export const MiddlewareWatcher = Object.freeze({
             return () => undefined;
         _storage = storage;
         _ignoreRoutes = config.ignoreRoutes;
+        _ignorePath = config.ignorePath;
         globalThis.__zintrust_trace_middleware_emit__ = emit;
         return () => {
             const globalState = globalThis;
@@ -41,6 +43,7 @@ export const MiddlewareWatcher = Object.freeze({
             }
             _storage = null;
             _ignoreRoutes = [];
+            _ignorePath = [];
         };
     },
 });

package/dist/watchers/ModelWatcher.js

@@ -3,10 +3,11 @@ import { EntryType } from '../types.js';
 import { RequestFilter } from '../utils/requestFilter.js';
 let _storage = null;
 let _ignoreRoutes = [];
+let _ignorePath = [];
 const emit = (action, model, id, changes) => {
     if (!_storage)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath))
         return;
     const content = {
         action,
@@ -34,6 +35,7 @@ export const ModelWatcher = Object.freeze({
             return () => undefined;
         _storage = storage;
         _ignoreRoutes = config.ignoreRoutes;
+        _ignorePath = config.ignorePath;
         globalThis.__zintrust_trace_model_emit__ = emit;
         return () => {
             const globalState = globalThis;
@@ -42,6 +44,7 @@ export const ModelWatcher = Object.freeze({
             }
             _storage = null;
             _ignoreRoutes = [];
+            _ignorePath = [];
         };
     },
 });

package/dist/watchers/NotificationWatcher.js

@@ -6,10 +6,11 @@ import { RequestFilter } from '../utils/requestFilter.js';
 let _storage = null;
 let _redactionFields = [];
 let _ignoreRoutes = [];
+let _ignorePath = [];
 const emit = (notification, channels, notifiable, message, payload) => {
     if (!_storage)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath))
         return;
     const content = {
         notification,
@@ -41,10 +42,12 @@ export const NotificationWatcher = Object.freeze({
         _storage = storage;
         _redactionFields = [...config.redaction.keys, ...config.redaction.body];
         _ignoreRoutes = config.ignoreRoutes;
+        _ignorePath = config.ignorePath;
         return () => {
             _storage = null;
             _redactionFields = [];
             _ignoreRoutes = [];
+            _ignorePath = [];
         };
     },
 });

package/dist/watchers/QueryWatcher.js

@@ -29,7 +29,7 @@ const isTraceStorageQuery = (sql) => {
 const emit = (query, params, duration, connection = 'default') => {
     if (_storage === null || _config === null)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_config.ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_config.ignoreRoutes, _config.ignorePath))
         return;
     if (isTraceStorageQuery(query))
         return;

package/dist/watchers/RedisWatcher.js

@@ -4,11 +4,12 @@ import { AuthTag } from '../utils/authTag.js';
 import { RequestFilter } from '../utils/requestFilter.js';
 let _storage = null;
 let _ignoreRoutes = [];
+let _ignorePath = [];
 /** Emit a redis command trace. Key/value payload is intentionally omitted for security. */
 const emit = (command, duration) => {
     if (!_storage)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath))
         return;
     const content = { command, duration, hostname: TraceContext.getHostname() };
     _storage
@@ -30,9 +31,11 @@ export const RedisWatcher = Object.freeze({
             return () => undefined;
         _storage = storage;
         _ignoreRoutes = config.ignoreRoutes;
+        _ignorePath = config.ignorePath;
         return () => {
             _storage = null;
             _ignoreRoutes = [];
+            _ignorePath = [];
         };
     },
 });

package/dist/watchers/ScheduleWatcher.js

@@ -6,10 +6,11 @@ import { EntryType } from '../types.js';
 import { RequestFilter } from '../utils/requestFilter.js';
 let _storage = null;
 let _ignoreRoutes = [];
+let _ignorePath = [];
 const emit = (name, expression, status, duration, output) => {
     if (!_storage)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath))
         return;
     const content = {
         name,
@@ -38,9 +39,11 @@ export const ScheduleWatcher = Object.freeze({
             return () => undefined;
         _storage = storage;
         _ignoreRoutes = config.ignoreRoutes;
+        _ignorePath = config.ignorePath;
         return () => {
             _storage = null;
             _ignoreRoutes = [];
+            _ignorePath = [];
         };
     },
 });

package/dist/watchers/ViewWatcher.js

@@ -3,10 +3,11 @@ import { EntryType } from '../types.js';
 import { RequestFilter } from '../utils/requestFilter.js';
 let _storage = null;
 let _ignoreRoutes = [];
+let _ignorePath = [];
 const emit = (template, duration) => {
     if (!_storage)
         return;
-    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes))
+    if (RequestFilter.shouldIgnoreCurrentRequest(_ignoreRoutes, _ignorePath))
         return;
     const content = { template, duration, hostname: TraceContext.getHostname() };
     _storage
@@ -28,9 +29,11 @@ export const ViewWatcher = Object.freeze({
             return () => undefined;
         _storage = storage;
         _ignoreRoutes = config.ignoreRoutes;
+        _ignorePath = config.ignorePath;
         return () => {
             _storage = null;
             _ignoreRoutes = [];
+            _ignorePath = [];
         };
     },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/trace",
-  "version": "0.5.4",
+  "version": "0.5.7",
   "description": "Trace assistant for ZinTrust: logs requests, queries, exceptions, jobs, and more.",
   "private": false,
   "type": "module",
@@ -40,7 +40,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zintrust/core": "^0.5.2"
+    "@zintrust/core": "^0.5.5"
   },
   "publishConfig": {
     "access": "public"

package/src/config.ts

@@ -259,6 +259,7 @@ const DEFAULTS: ITraceConfig = Object.freeze({
   observeConnection: undefined,
   pruneAfterHours: 24,
   ignoreRoutes: ['/trace', '/health', '/ping'],
+  ignorePath: [],
   slowQueryThreshold: 100,
   captureCachePayloads: false,
   captureQueryBindings: true,
@@ -350,6 +351,7 @@ export const TraceConfig = Object.freeze({
         query: mergeStringLists(DEFAULTS.redaction.query, overrides.redaction?.query),
       },
       ignoreRoutes: overrides.ignoreRoutes ?? DEFAULTS.ignoreRoutes,
+      ignorePath: overrides.ignorePath ?? DEFAULTS.ignorePath,
     });
   },
 

package/src/dashboard/ui.ts

@@ -76,13 +76,13 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
     .main{padding:28px;min-width:0}.shell{max-width:1320px;margin:0 auto;display:grid;gap:18px}
     .panel{border-radius:var(--radius);border:1px solid var(--line);background:var(--surface);box-shadow:var(--shadow);backdrop-filter:blur(16px)}.stats-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:16px;margin-bottom:18px}.stat-card{padding:20px;position:relative;overflow:hidden}.stat-card::after{content:'';position:absolute;right:-18px;bottom:-26px;width:92px;height:92px;border-radius:28px;background:linear-gradient(135deg,rgba(56,189,248,.16),rgba(34,197,94,.08));transform:rotate(18deg)}.stat-label{font-size:.74rem;letter-spacing:.12em;text-transform:uppercase;color:var(--muted);font-weight:800;margin-bottom:12px}.stat-value{font-size:2.25rem;font-weight:800;line-height:1}.stat-meta{margin-top:10px;color:var(--muted);font-size:.9rem}.content-grid{display:grid;grid-template-columns:minmax(0,1.65fr) minmax(320px,.95fr);gap:18px}.side-stack{display:grid;gap:18px}
     .section-head{display:flex;justify-content:space-between;align-items:flex-start;gap:12px;padding:22px 24px 16px}.section-head h3{margin:0;font-size:1.04rem}.section-head p{margin:6px 0 0;color:var(--muted);font-size:.92rem}.toolbar{display:flex;flex-wrap:wrap;gap:10px;padding:0 24px 18px}.control,.toolbar input,.toolbar select{height:44px;border-radius:13px;border:1px solid var(--line);background:var(--surface-strong);color:var(--text);padding:0 14px;min-width:0}.toolbar input,.toolbar select{flex:1 1 180px}.toolbar input::placeholder{color:var(--muted)}.btn{height:44px;border:none;border-radius:13px;padding:0 16px;cursor:pointer;font-weight:800}.btn-primary{background:linear-gradient(135deg,var(--accent-strong),var(--accent));color:#fff}.btn-danger{background:rgba(239,68,68,.12);color:var(--danger);border:1px solid rgba(239,68,68,.18)}.btn-ghost{background:var(--surface-soft);color:var(--text);border:1px solid var(--line)}
-    .table-wrap{overflow:auto;padding:0 12px 12px}table{width:100%;border-collapse:separate;border-spacing:0;min-width:880px}th{padding:14px;color:var(--muted);font-size:.74rem;font-weight:800;letter-spacing:.12em;text-transform:uppercase;text-align:left;border-bottom:1px solid var(--line)}td{padding:15px 14px;border-bottom:1px solid var(--line);vertical-align:top}.row-button{cursor:pointer}.row-button:hover td{background:rgba(56,189,248,.05)}.summary{font-size:.93rem;font-weight:700;line-height:1.4;color:var(--text)}.summary-sub{margin-top:6px;color:var(--muted);font-size:.82rem;line-height:1.4}.mono{font-family:var(--mono)}.empty{padding:44px 24px;color:var(--muted);line-height:1.65;text-align:center}.pagination{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:0 24px 24px;color:var(--muted);flex-wrap:wrap}.pagination-controls{display:flex;gap:8px}.pagination button{height:40px;min-width:92px;padding:0 14px;border-radius:12px;border:1px solid var(--line);background:var(--surface-strong);color:var(--text);cursor:pointer}.pagination button:disabled{opacity:.45;cursor:not-allowed}
+    .table-wrap{overflow:auto;padding:0 12px 12px}.table-wrap table{width:100%;border-collapse:separate;border-spacing:0;min-width:880px}th{padding:14px;color:var(--muted);font-size:.74rem;font-weight:800;letter-spacing:.12em;text-transform:uppercase;text-align:left;border-bottom:1px solid var(--line)}td{padding:15px 14px;border-bottom:1px solid var(--line);vertical-align:top}.row-button{cursor:pointer}.row-button:hover td{background:rgba(56,189,248,.05)}.summary{font-size:.93rem;font-weight:700;line-height:1.4;color:var(--text)}.summary-sub{margin-top:6px;color:var(--muted);font-size:.82rem;line-height:1.4}.mono{font-family:var(--mono)}.empty{padding:44px 24px;color:var(--muted);line-height:1.65;text-align:center}.pagination{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:0 24px 24px;color:var(--muted);flex-wrap:wrap}.pagination-controls{display:flex;gap:8px}.pagination button{height:40px;min-width:92px;padding:0 14px;border-radius:12px;border:1px solid var(--line);background:var(--surface-strong);color:var(--text);cursor:pointer}.pagination button:disabled{opacity:.45;cursor:not-allowed}
     .activity-list{list-style:none;margin:0;padding:0 24px 24px}.activity-item{padding:14px 0;border-top:1px solid var(--line)}.activity-item:first-child{border-top:none}.activity-head{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.activity-time{color:var(--muted);font-size:.85rem}.activity-summary{margin-top:8px;color:var(--text);line-height:1.48}.back-link{display:inline-flex;align-items:center;gap:8px;margin:0 0 14px;color:var(--accent);font-weight:800;cursor:pointer}.detail-card{padding:24px}.detail-meta{display:flex;flex-wrap:wrap;gap:10px;margin:14px 0 20px;color:var(--muted);font-size:.9rem;overflow-wrap:anywhere}.detail-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:14px}.detail-stack{display:grid;gap:16px;margin-top:18px}.detail-box{padding:16px;border-radius:16px;background:var(--surface-soft);border:1px solid var(--line)}.detail-box h4{margin:0 0 10px;font-size:.92rem}.detail-box dl{margin:0;display:grid;gap:8px}.detail-box dt{font-size:.76rem;letter-spacing:.08em;text-transform:uppercase;color:var(--muted);font-weight:800}.detail-box dd{margin:0;color:var(--text);line-height:1.45;overflow-wrap:anywhere}.trace-tabs{display:flex;gap:10px;flex-wrap:wrap;margin:20px 0 16px}.trace-tab{border:none;border-radius:12px;padding:10px 12px;background:transparent;color:var(--muted);cursor:pointer;box-shadow:inset 0 0 0 1px var(--line);font-weight:800}.trace-tab.active{background:rgba(56,189,248,.12);color:var(--text);box-shadow:inset 0 0 0 1px rgba(56,189,248,.28)}.trace-panel{display:grid;gap:14px}.trace-item{padding:18px;border-radius:16px;background:var(--surface-soft);border:1px solid var(--line)}.trace-item-head{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap}.trace-item-summary{margin-top:10px;display:grid;gap:10px}.trace-note{color:var(--muted);line-height:1.6}.trace-disclosure{padding:0;overflow:hidden}.trace-disclosure[open]{padding-bottom:18px}.trace-disclosure .trace-item-summary{margin-top:0}.trace-disclosure-body{display:grid;gap:12px;padding:0 18px}.trace-summary{list-style:none;cursor:pointer;padding:18px}.trace-summary::-webkit-details-marker{display:none}.trace-summary-main{display:grid;gap:10px;min-width:0;flex:1}.trace-summary-copy{display:grid;gap:6px;min-width:0}.trace-summary-copy .summary,.trace-summary-copy .summary-sub{display:block;overflow-wrap:anywhere}.trace-disclosure-body .summary-sub{overflow-wrap:anywhere}
     .tag{display:inline-flex;align-items:center;gap:6px;padding:4px 10px;border-radius:999px;background:rgba(56,189,248,.12);color:#bae6fd;font-size:.78rem;font-weight:800;margin:0 6px 6px 0;border:1px solid rgba(56,189,248,.18);text-decoration:none}button.tag{cursor:pointer}html[data-theme='light'] .tag{color:#075985}.tag.failed{background:rgba(239,68,68,.14);color:#fecaca;border-color:rgba(239,68,68,.2)}html[data-theme='light'] .tag.failed{color:#b91c1c}.tag.slow{background:rgba(245,158,11,.12);color:#fde68a;border-color:rgba(245,158,11,.18)}html[data-theme='light'] .tag.slow{color:#92400e}.type-pill{display:inline-flex;align-items:center;gap:6px;padding:6px 10px;border-radius:999px;font-size:.74rem;font-weight:900;text-transform:uppercase;letter-spacing:.08em;border:1px solid transparent}.pill-request{background:rgba(56,189,248,.14);color:#93c5fd}.pill-request.method-get{background:rgba(34,197,94,.16);color:#bbf7d0}.pill-request.method-post{background:rgba(59,130,246,.16);color:#bfdbfe}.pill-request.method-other{background:rgba(245,158,11,.16);color:#fde68a}.pill-query{background:rgba(34,197,94,.12);color:#86efac}.pill-exception{background:rgba(239,68,68,.14);color:#fecaca}.pill-log{background:rgba(168,85,247,.14);color:#ddd6fe}.pill-job,.pill-batch{background:rgba(245,158,11,.14);color:#fde68a}.pill-cache{background:rgba(20,184,166,.12);color:#99f6e4}.pill-schedule,.pill-command{background:rgba(14,165,233,.14);color:#bae6fd}.pill-mail,.pill-notification{background:rgba(236,72,153,.14);color:#fbcfe8}.pill-auth{background:rgba(148,163,184,.16);color:#e2e8f0}.pill-event,.pill-model{background:rgba(74,222,128,.14);color:#bbf7d0}.pill-redis{background:rgba(239,68,68,.12);color:#fecaca}.pill-gate{background:rgba(99,102,241,.14);color:#c7d2fe}.pill-middleware{background:rgba(45,212,191,.12);color:#ccfbf1}.pill-dump,.pill-view{background:rgba(148,163,184,.14);color:#e2e8f0}.pill-client-request{background:rgba(59,130,246,.14);color:#bfdbfe}html[data-theme='light'] .pill-request{color:#1d4ed8}html[data-theme='light'] .pill-request.method-get{color:#166534}html[data-theme='light'] .pill-request.method-post{color:#1d4ed8}html[data-theme='light'] .pill-request.method-other{color:#92400e}html[data-theme='light'] .pill-query{color:#166534}html[data-theme='light'] .pill-exception{color:#b91c1c}html[data-theme='light'] .pill-log{color:#6d28d9}html[data-theme='light'] .pill-job,html[data-theme='light'] .pill-batch{color:#92400e}html[data-theme='light'] .pill-cache{color:#115e59}html[data-theme='light'] .pill-schedule,html[data-theme='light'] .pill-command{color:#0c4a6e}html[data-theme='light'] .pill-mail,html[data-theme='light'] .pill-notification{color:#9d174d}html[data-theme='light'] .pill-auth,html[data-theme='light'] .pill-dump,html[data-theme='light'] .pill-view{color:#334155}html[data-theme='light'] .pill-event,html[data-theme='light'] .pill-model{color:#166534}html[data-theme='light'] .pill-redis{color:#991b1b}html[data-theme='light'] .pill-gate{color:#3730a3}html[data-theme='light'] .pill-middleware{color:#155e75}html[data-theme='light'] .pill-client-request{color:#1d4ed8}
     .monitoring-wrap{padding:0 24px 24px}.tag-list{display:flex;flex-wrap:wrap;gap:10px;margin-bottom:18px}.tag-item{display:inline-flex;align-items:center;gap:10px;padding:10px 14px;border-radius:999px;border:1px solid var(--line);background:var(--surface-strong)}.tag-remove{border:none;background:rgba(239,68,68,.14);color:var(--danger);border-radius:999px;width:24px;height:24px;cursor:pointer;font-size:1rem;line-height:1}.helper-text{color:var(--muted);line-height:1.6}
     .duration-chip{display:inline-flex;align-items:center;padding:5px 9px;border-radius:999px;border:1px solid transparent;font-size:.8rem;font-weight:700;color:var(--text);white-space:nowrap}.duration-chip.vfast{background:rgba(34,197,94,.14);border-color:rgba(34,197,94,.28);color:#bbf7d0}.duration-chip.fast{background:rgba(56,189,248,.12);border-color:rgba(56,189,248,.24);color:#bae6fd}.duration-chip.slow{background:rgba(245,158,11,.12);border-color:rgba(245,158,11,.22);color:#fde68a}.duration-chip.vslow{background:rgba(239,68,68,.14);border-color:rgba(239,68,68,.24);color:#fecaca}html[data-theme='light'] .duration-chip.vfast{color:#166534}html[data-theme='light'] .duration-chip.fast{color:#1d4ed8}html[data-theme='light'] .duration-chip.slow{color:#92400e}html[data-theme='light'] .duration-chip.vslow{color:#b91c1c}
     .code-card{border-radius:16px;border:1px solid var(--code-border);background:var(--surface-soft);overflow:hidden}.code-toolbar{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:12px 14px;border-bottom:1px solid var(--line)}.code-label{font-size:.76rem;letter-spacing:.12em;text-transform:uppercase;color:var(--muted);font-weight:800}.copy-button{display:inline-flex;align-items:center;justify-content:center;gap:8px;width:38px;height:38px;border-radius:12px;border:1px solid var(--line);background:var(--surface-strong);color:var(--text);cursor:pointer;transition:border-color .16s ease,color .16s ease}.copy-button:hover{border-color:rgba(56,189,248,.35);color:var(--accent)}.copy-button[data-copied='true']{color:var(--success);border-color:rgba(34,197,94,.28)}.copy-button svg{width:16px;height:16px;display:block}.code-block{margin:0;padding:18px 20px;background:var(--code-bg);color:#dbeafe;border:0;overflow:auto;white-space:pre;line-height:1.72;font-family:var(--mono);font-size:.92rem}.code-block.wrap{white-space:pre-wrap;overflow-wrap:anywhere;word-break:break-word}.code-block code{font-family:inherit}.html-preview-wrap{padding:14px;background:var(--surface-strong);border-top:1px solid var(--line)}.html-preview{display:block;width:100%;min-height:320px;border:1px solid var(--line);border-radius:14px;background:#fff}.inline-collapse{margin:0;border-top:1px solid var(--line);background:var(--surface-strong)}.inline-collapse summary{cursor:pointer;list-style:none;padding:14px 16px;font-size:.82rem;letter-spacing:.08em;text-transform:uppercase;color:var(--muted);font-weight:800}.inline-collapse summary::-webkit-details-marker{display:none}.inline-collapse[open] summary{border-bottom:1px solid var(--line)}.inline-collapse .code-block{border-top:none}.tok-key{color:#93c5fd}.tok-string{color:#86efac}.tok-number{color:#f9a8d4}.tok-boolean{color:#facc15}.tok-null{color:#fb7185}.tok-punctuation{color:#94a3b8}.tok-sql-keyword{color:#f472b6;font-weight:700}.tok-sql-identifier{color:#93c5fd}.tok-sql-string{color:#86efac}.tok-sql-number{color:#facc15}.tok-sql-comment{color:#64748b;font-style:italic}html[data-theme='light'] .code-block{color:#0f172a}html[data-theme='light'] .tok-key{color:#1d4ed8}html[data-theme='light'] .tok-string{color:#15803d}html[data-theme='light'] .tok-number{color:#c026d3}html[data-theme='light'] .tok-boolean{color:#b45309}html[data-theme='light'] .tok-null{color:#dc2626}html[data-theme='light'] .tok-punctuation{color:#64748b}html[data-theme='light'] .tok-sql-keyword{color:#db2777}html[data-theme='light'] .tok-sql-identifier{color:#2563eb}html[data-theme='light'] .tok-sql-string{color:#15803d}html[data-theme='light'] .tok-sql-number{color:#b45309}html[data-theme='light'] .tok-sql-comment{color:#6b7280}
-    @media (max-width:1120px){.content-grid{grid-template-columns:1fr}}@media (max-width:920px){.layout{grid-template-columns:1fr}.sidebar{position:static;height:auto;border-right:none;border-bottom:1px solid var(--line);padding:20px 16px 18px}.brand-row{padding:0 0 16px}.sidebar-status{margin:0 0 16px}.sidebar-group{padding:0}.main{padding:20px}}@media (max-width:640px){.stats-grid{grid-template-columns:1fr}.detail-card{padding:18px}.toolbar,.section-head,.pagination,.activity-list,.monitoring-wrap{padding-left:18px;padding-right:18px}.table-wrap{padding:0 8px 10px}.brand-row{align-items:stretch;gap:14px;padding:0 0 14px}.brand{width:100%;align-items:flex-start}.brand-copy{min-width:0}.brand-copy h1{font-size:1.18rem;line-height:1.12}.brand-copy p{font-size:.82rem;overflow-wrap:anywhere}.icon-button{align-self:flex-end}.sidebar-status{padding:12px}.nav-button{padding:11px 12px}.nav-title{font-size:.95rem}.nav-meta{font-size:.72rem}}@media (max-width:480px){.brand-row{flex-direction:column}.icon-button{align-self:flex-start}.nav-button{align-items:flex-start;flex-direction:column}.nav-meta{font-size:.7rem}}
+    @media (max-width:1120px){.content-grid{grid-template-columns:1fr}}@media (max-width:920px){.layout{grid-template-columns:1fr}.sidebar{position:static;height:auto;border-right:none;border-bottom:1px solid var(--line);padding:20px 16px 18px}.brand-row{padding:0 0 16px}.sidebar-status{margin:0 0 16px}.sidebar-group{padding:0}.main{padding:20px}}@media (max-width:760px){.main{padding:16px}.shell{gap:14px}.stat-value{font-size:1.9rem}.section-head{flex-direction:column;align-items:stretch}.section-head .btn{width:100%}.toolbar{display:grid;grid-template-columns:1fr;padding-left:18px;padding-right:18px}.toolbar .btn,.toolbar input,.toolbar select{width:100%;flex:none}.pagination{padding-left:18px;padding-right:18px}.pagination,.pagination-controls{width:100%}.pagination-controls{justify-content:space-between}.pagination button{flex:1 1 0}.detail-meta{display:grid;gap:8px}.trace-tabs{flex-wrap:nowrap;overflow:auto;padding-bottom:4px}.trace-tab{white-space:nowrap}.code-toolbar{flex-wrap:wrap}.copy-button{width:100%}.html-preview{min-height:220px}.table-wrap{padding:0 14px 14px;overflow:visible}.table-wrap table{min-width:0;border-spacing:0}.table-wrap thead{display:none}.table-wrap tbody{display:grid;gap:12px}.table-wrap tr{display:block;border:1px solid var(--line);border-radius:16px;background:var(--surface-soft);overflow:hidden}.table-wrap td{display:grid;grid-template-columns:minmax(84px,108px) minmax(0,1fr);gap:10px;align-items:start;padding:12px 14px;border-bottom:1px solid var(--line)}.table-wrap td::before{content:attr(data-label);font-size:.72rem;font-weight:800;letter-spacing:.08em;text-transform:uppercase;color:var(--muted)}.table-wrap td:last-child{border-bottom:none}.table-wrap td[data-label='Summary'],.table-wrap td[data-label='Tags']{grid-template-columns:1fr}.table-wrap td[data-label='Summary']::before,.table-wrap td[data-label='Tags']::before{margin-bottom:2px}.row-button:hover td{background:transparent}.row-button:hover{box-shadow:inset 0 0 0 1px rgba(56,189,248,.18)}}@media (max-width:640px){.stats-grid{grid-template-columns:1fr}.detail-card{padding:18px}.toolbar,.section-head,.activity-list,.monitoring-wrap{padding-left:18px;padding-right:18px}.brand-row{align-items:stretch;gap:14px;padding:0 0 14px}.brand{width:100%;align-items:flex-start}.brand-copy{min-width:0}.brand-copy h1{font-size:1.18rem;line-height:1.12}.brand-copy p{font-size:.82rem;overflow-wrap:anywhere}.icon-button{align-self:flex-end}.sidebar-status{padding:12px}.nav-button{padding:11px 12px}.nav-title{font-size:.95rem}.nav-meta{font-size:.72rem}}@media (max-width:480px){.brand-row{flex-direction:column}.icon-button{align-self:flex-start}.nav-button{align-items:flex-start;flex-direction:column}.nav-meta{font-size:.7rem}}
   </style>
 </head>
 <body>
@@ -845,7 +845,7 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
         const recentRows = recent.data || [];
         const recentTable = recentRows.length === 0
           ? '<div class="empty">No trace entries recorded.</div>'
-          : '<div class="table-wrap"><table><thead><tr><th>Type</th><th>Summary</th><th>Tags</th><th>Duration</th><th>Happened</th></tr></thead><tbody>' + recentRows.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('') + '</tbody></table></div>';
+          : '<div class="table-wrap"><table><thead><tr><th>Type</th><th>Summary</th><th>Tags</th><th>Duration</th><th>Happened</th></tr></thead><tbody>' + recentRows.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td data-label="Type"><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td data-label="Summary">' + entrySummaryHtml(entry) + '</td><td data-label="Tags">' + tagsHtml(entry.tags) + '</td><td data-label="Duration">' + durationHtml(entry) + '</td><td data-label="Happened" class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('') + '</tbody></table></div>';
         const activityList = recentRows.length === 0
           ? '<div class="empty">No recent activity.</div>'
           : '<ul class="activity-list">' + recentRows.slice(0, 5).map((entry) => '<li class="activity-item"><div class="activity-head"><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span>' + durationHtml(entry) + '<span class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</span></div><div class="activity-summary">' + escapeHtml(entrySummaryText(entry)) + '</div></li>').join('') + '</ul>';
@@ -892,7 +892,7 @@ const DASHBOARD_DOCUMENT = String.raw`<!DOCTYPE html>
         const total = Number(response.total || 0);
         const perPage = Number(response.perPage || 50);
         const totalPages = Math.max(1, Math.ceil(total / perPage));
-        const rows = data.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td>' + entrySummaryHtml(entry) + '</td><td>' + tagsHtml(entry.tags) + '</td><td>' + durationHtml(entry) + '</td><td class="mono">' + batchSnippet(entry.batchId) + '</td><td class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('');
+        const rows = data.map((entry) => '<tr class="row-button" data-action="show-detail" data-uuid="' + escapeHtml(entry.uuid) + '"><td data-label="Type"><span class="' + typeClass(entry) + '">' + escapeHtml(entryTypeLabel(entry)) + '</span></td><td data-label="Summary">' + entrySummaryHtml(entry) + '</td><td data-label="Tags">' + tagsHtml(entry.tags) + '</td><td data-label="Duration">' + durationHtml(entry) + '</td><td data-label="Batch" class="mono">' + batchSnippet(entry.batchId) + '</td><td data-label="Happened" class="activity-time">' + escapeHtml(timeSince(entry.createdAt)) + '</td></tr>').join('');
 
         main.innerHTML = [
           '<section class="panel">',

package/src/storage/TraceContentBudget.ts

@@ -28,87 +28,6 @@ const describeValueType = (value: unknown): string => {
   return typeof value;
 };
 
-type TracePathSegment = string | number;
-
-type TracePathCandidate = {
-  path: TracePathSegment[];
-  size: number;
-};
-
-const chooseLargerCandidate = (
-  left: TracePathCandidate | null,
-  right: TracePathCandidate | null
-): TracePathCandidate | null => {
-  if (left === null) return right;
-  if (right === null) return left;
-  return right.size > left.size ? right : left;
-};
-
-const fallbackCandidate = (value: unknown, path: TracePathSegment[]): TracePathCandidate | null => {
-  return path.length === 0 ? null : { path, size: serializedSize(value) };
-};
-
-const findLargestDroppablePathInArray = (
-  value: unknown[],
-  path: TracePathSegment[]
-): TracePathCandidate | null => {
-  let best: TracePathCandidate | null = null;
-
-  for (const [index, item] of value.entries()) {
-    best = chooseLargerCandidate(best, findLargestDroppablePath(item, [...path, index]));
-  }
-
-  return best ?? fallbackCandidate(value, path);
-};
-
-const findLargestDroppablePathInObject = (
-  value: Record<string, unknown>,
-  path: TracePathSegment[]
-): TracePathCandidate | null => {
-  let best: TracePathCandidate | null = null;
-
-  for (const [key, entryValue] of Object.entries(value)) {
-    if (key === '__traceNotice') continue;
-    best = chooseLargerCandidate(best, findLargestDroppablePath(entryValue, [...path, key]));
-  }
-
-  return best ?? fallbackCandidate(value, path);
-};
-
-const findLargestDroppablePath = (
-  value: unknown,
-  path: TracePathSegment[] = []
-): TracePathCandidate | null => {
-  if (Array.isArray(value)) return findLargestDroppablePathInArray(value, path);
-  if (typeof value === 'object' && value !== null) {
-    return findLargestDroppablePathInObject(value as Record<string, unknown>, path);
-  }
-
-  return fallbackCandidate(value, path);
-};
-
-const replaceAtPath = (value: unknown, path: TracePathSegment[], replacement: unknown): unknown => {
-  if (path.length === 0) return replacement;
-
-  const [segment, ...rest] = path;
-
-  if (Array.isArray(value) && typeof segment === 'number') {
-    const next = value.slice();
-    next[segment] = replaceAtPath(next[segment], rest, replacement);
-    return next;
-  }
-
-  if (typeof value === 'object' && value !== null && typeof segment === 'string') {
-    const current = value as Record<string, unknown>;
-    return {
-      ...current,
-      [segment]: replaceAtPath(current[segment], rest, replacement),
-    };
-  }
-
-  return value;
-};
-
 const compactValue = (value: unknown, depth: number): unknown => {
   if (depth >= DEFAULT_MAX_DEPTH) {
     return DROPPED_FIELD_MESSAGE;
@@ -152,18 +71,34 @@ const compactValue = (value: unknown, depth: number): unknown => {
 };
 
 const compactStructuredValueToBudget = (value: unknown): unknown => {
-  let compacted: unknown =
-    typeof value === 'object' && value !== null && !Array.isArray(value)
-      ? {
-          ...(value as Record<string, unknown>),
-          __traceNotice: COMPACTED_CONTENT_MESSAGE,
-        }
-      : value;
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    return value;
+  }
+
+  const compacted: Record<string, unknown> = {
+    ...(value as Record<string, unknown>),
+    __traceNotice: COMPACTED_CONTENT_MESSAGE,
+  };
+
+  const topLevelCandidates = Object.entries(compacted)
+    .filter(([key]) => key !== '__traceNotice')
+    .map(([key, entryValue]) => ({ key, size: serializedSize(entryValue) }))
+    .sort((left, right) => right.size - left.size);
+
+  let droppedCount = 0;
+
+  for (const candidate of topLevelCandidates) {
+    if (serializedSize(compacted) <= DEFAULT_MAX_ENTRY_BYTES) {
+      break;
+    }
 
-  while (serializedSize(compacted) > DEFAULT_MAX_ENTRY_BYTES) {
-    const candidate = findLargestDroppablePath(compacted);
-    if (candidate === null) break;
-    compacted = replaceAtPath(compacted, candidate.path, DROPPED_FIELD_MESSAGE);
+    compacted[candidate.key] = DROPPED_FIELD_MESSAGE;
+    droppedCount += 1;
+  }
+
+  if (droppedCount > 0) {
+    compacted['__traceNotice'] =
+      `${COMPACTED_CONTENT_MESSAGE} ${String(droppedCount)} top-level field(s) were dropped.`;
   }
 
   return compacted;
@@ -270,26 +205,28 @@ const closePort = (port: MessagePort): void => {
   }
 };
 
-const scheduleTask = (task: () => Promise<void>): void => {
-  if (typeof MessageChannel === 'function') {
-    const channel = new MessageChannel();
-
-    channel.port1.onmessage = (): void => {
-      channel.port1.onmessage = null;
-      closePort(channel.port1);
-      closePort(channel.port2);
-      void task().catch(() => undefined);
+const scheduleTask = async (task: () => Promise<void>): Promise<void> => {
+  return await new Promise<void>((resolve, reject) => {
+    const runTask = (): void => {
+      void task().then(resolve).catch(reject);
     };
 
-    channel.port2.postMessage(undefined);
-    return;
-  }
+    if (typeof MessageChannel === 'function') {
+      const channel = new MessageChannel();
+
+      channel.port1.onmessage = (): void => {
+        channel.port1.onmessage = null;
+        closePort(channel.port1);
+        closePort(channel.port2);
+        runTask();
+      };
+
+      channel.port2.postMessage(undefined);
+      return;
+    }
 
-  Promise.resolve()
-    .then(() => {
-      void task().catch(() => undefined);
-    })
-    .catch(() => undefined);
+    Promise.resolve().then(runTask).catch(reject);
+  });
 };
 
 const getReplacementContent = (content: unknown): Record<string, unknown> => {
@@ -442,7 +379,7 @@ const startInternalDispatchWorker = (
   if (startedWorkerKeys.has(key)) return;
   startedWorkerKeys.add(key);
 
-  scheduleTask(async () => {
+  void scheduleTask(async () => {
     const workersApi = runtime?.queueWorkerApi ?? (await getQueueWorkerApi());
     if (workersApi === null) {
       startedWorkerKeys.delete(key);
@@ -487,16 +424,18 @@ const startInternalDispatchWorker = (
         void runWorker();
       }, intervalMs)
     );
+  }).catch(() => {
+    startedWorkerKeys.delete(key);
   });
 };
 
-const dispatchWrite = (
+const dispatchWrite = async (
   storage: ITraceStorage,
   config: ITraceConfig,
   entry: ITraceEntry,
   runtime?: TraceContentBudgetRuntime
-): void => {
-  scheduleTask(async () => {
+): Promise<void> => {
+  await scheduleTask(async () => {
     if (hasQueueDispatch(config)) {
       const enqueued = await enqueueTraceDispatch(config, { operation: 'write', entry }, runtime);
       if (enqueued) return;
@@ -506,14 +445,14 @@ const dispatchWrite = (
   });
 };
 
-const dispatchUpdate = (
+const dispatchUpdate = async (
   storage: ITraceStorage,
   config: ITraceConfig,
   uuid: string,
   patch: Partial<Pick<ITraceEntry, 'content' | 'isLatest'>>,
   runtime?: TraceContentBudgetRuntime
-): void => {
-  scheduleTask(async () => {
+): Promise<void> => {
+  await scheduleTask(async () => {
     if (hasQueueDispatch(config)) {
       const enqueued = await enqueueTraceDispatch(
         config,
@@ -538,13 +477,13 @@ export const TraceContentBudget = Object.freeze({
     return Object.freeze({
       ...storage,
       writeEntry: async (entry: ITraceEntry): Promise<void> => {
-        dispatchWrite(storage, config, entry, runtime);
+        await dispatchWrite(storage, config, entry, runtime);
       },
       updateEntry: async (
         uuid: string,
         patch: Partial<Pick<ITraceEntry, 'content' | 'isLatest'>>
       ): Promise<void> => {
-        dispatchUpdate(storage, config, uuid, patch, runtime);
+        await dispatchUpdate(storage, config, uuid, patch, runtime);
       },
     });
   },

package/src/types.ts

@@ -406,6 +406,7 @@ export interface ITraceConfig {
   observeConnection?: string;
   pruneAfterHours: number;
   ignoreRoutes: string[];
+  ignorePath: string[];
   slowQueryThreshold: number;
   captureCachePayloads: boolean;
   captureQueryBindings: boolean;

package/src/utils/requestFilter.ts

@@ -1,5 +1,10 @@
 import { TraceContext } from '../context';
 
+type RequestIgnoreRules = {
+  ignoreRoutes?: string[];
+  ignorePath?: string[];
+};
+
 const normalizePath = (input: string): string => {
   const trimmed = input.trim();
   const [pathOnly] = trimmed.split('?');
@@ -7,24 +12,65 @@ const normalizePath = (input: string): string => {
   return pathOnly.startsWith('/') ? pathOnly : `/${pathOnly}`;
 };
 
-const matchesIgnoredPath = (path: string, ignoreRoutes: string[]): boolean => {
+const normalizeContainsPattern = (input: string): string => {
+  const trimmed = input.trim();
+  const [pathOnly] = trimmed.split('?');
+  return pathOnly ?? '';
+};
+
+const resolveRules = (
+  ignoreRoutesOrRules: string[] | RequestIgnoreRules,
+  ignorePath?: string[]
+): Required<RequestIgnoreRules> => {
+  if (Array.isArray(ignoreRoutesOrRules)) {
+    return {
+      ignoreRoutes: ignoreRoutesOrRules,
+      ignorePath: ignorePath ?? [],
+    };
+  }
+
+  return {
+    ignoreRoutes: ignoreRoutesOrRules.ignoreRoutes ?? [],
+    ignorePath: ignoreRoutesOrRules.ignorePath ?? [],
+  };
+};
+
+const matchesIgnoredPath = (
+  path: string,
+  ignoreRoutesOrRules: string[] | RequestIgnoreRules,
+  ignorePath?: string[]
+): boolean => {
   const normalizedPath = normalizePath(path);
+  const rules = resolveRules(ignoreRoutesOrRules, ignorePath);
+
+  if (
+    rules.ignoreRoutes.some((route) => {
+      const normalizedRoute = normalizePath(route);
+      return (
+        normalizedPath === normalizedRoute ||
+        normalizedPath.startsWith(
+          normalizedRoute.endsWith('/') ? normalizedRoute : `${normalizedRoute}/`
+        )
+      );
+    })
+  ) {
+    return true;
+  }
 
-  return ignoreRoutes.some((route) => {
-    const normalizedRoute = normalizePath(route);
-    return (
-      normalizedPath === normalizedRoute ||
-      normalizedPath.startsWith(
-        normalizedRoute.endsWith('/') ? normalizedRoute : `${normalizedRoute}/`
-      )
-    );
+  return rules.ignorePath.some((route) => {
+    const containsPattern = normalizeContainsPattern(route);
+    if (containsPattern === '') return false;
+    return normalizedPath.includes(containsPattern);
   });
 };
 
-const shouldIgnoreCurrentRequest = (ignoreRoutes: string[]): boolean => {
+const shouldIgnoreCurrentRequest = (
+  ignoreRoutesOrRules: string[] | RequestIgnoreRules,
+  ignorePath?: string[]
+): boolean => {
   const currentPath = TraceContext.getRequestPath();
   if (typeof currentPath !== 'string' || currentPath === '') return false;
-  return matchesIgnoredPath(currentPath, ignoreRoutes);
+  return matchesIgnoredPath(currentPath, ignoreRoutesOrRules, ignorePath);
 };
 
 export const RequestFilter = Object.freeze({