@zintrust/trace 0.4.81 → 0.4.83

package/README.md

@@ -29,6 +29,7 @@ You can still import the package migrations manually if you prefer to keep them
 ```env
 TRACE_ENABLED=true
 TRACE_DB_CONNECTION=d1        # optional — omit to inherit DB_CONNECTION
+TRACE_QUERY_CONNECTION=main   # optional — app DB to observe for SQL traces
 TRACE_PRUNE_HOURS=24          # how long entries are kept (default: 24)
 TRACE_SLOW_QUERY_MS=100       # slow-query threshold in ms (default: 100)
 TRACE_LOG_LEVEL=info          # minimum log level captured (default: info)
@@ -77,6 +78,7 @@ import type { TraceConfigOverrides } from '@zintrust/trace';
 export default {
   enabled: Env.getBool('TRACE_ENABLED', false),
   connection: Env.get('TRACE_DB_CONNECTION', '') || undefined,
+  observeConnection: Env.get('TRACE_QUERY_CONNECTION', '') || undefined,
   pruneAfterHours: Env.getInt('TRACE_PRUNE_HOURS', 24),
   slowQueryThreshold: Env.getInt('TRACE_SLOW_QUERY_MS', 100),
   logMinLevel: Env.get('TRACE_LOG_LEVEL', 'info') as TraceConfigOverrides['logMinLevel'],
@@ -102,6 +104,10 @@ export default {
 
 All include/exclude matching is contains-based, so a term like `report` matches `/reports/daily`, `monthly-report`, or any other trace content containing that fragment.
 
+When trace storage lives on a different connection than your application data, keep `TRACE_DB_CONNECTION` pointed at the trace tables and set `TRACE_QUERY_CONNECTION` to the app connection you want SQL traces to observe. If you omit `TRACE_QUERY_CONNECTION`, trace automatically falls back to the main `DB_CONNECTION` whenever the storage connection is different.
+
+When ZinTrust proxy runtimes also have trace enabled, proxy-executed SQL and SMTP operations are traced at the proxy boundary too. That means MySQL, PostgreSQL, SQL Server, and D1 proxy requests can still record the final SQL plus bound values, and the SMTP proxy can persist rendered mail text and HTML, even when the consumer application is talking to the proxy rather than executing the transport locally.
+
 ### 3. Mount the dashboard
 
 Register the dashboard explicitly in your route file when you want the UI. Restrict access with middleware — the trace does **not** apply auth automatically.

package/dist/build-manifest.json

@@ -1,14 +1,14 @@
 {
   "name": "@zintrust/trace",
-  "version": "0.4.77",
-  "buildDate": "2026-04-08T09:26:55.306Z",
+  "version": "0.4.83",
+  "buildDate": "2026-04-08T17:13:19.081Z",
   "buildEnvironment": {
     "node": "v22.22.1",
     "platform": "darwin",
     "arch": "arm64"
   },
   "git": {
-    "commit": "f37a0c05",
+    "commit": "3c792064",
     "branch": "release"
   },
   "package": {
@@ -22,8 +22,8 @@
   },
   "files": {
     "build-manifest.json": {
-      "size": 14438,
-      "sha256": "967934d372f36722143e02cd66b98dae1904122d34754fa8267bf3133725e1b2"
+      "size": 14439,
+      "sha256": "dab00c1ade5c0b5fe2b10b5eeeae31dfd9a017f198794e18e7c2b69cfb5560d8"
     },
     "cli-register.d.ts": {
       "size": 255,
@@ -38,8 +38,8 @@
       "sha256": "b034cbef0c71fb868071363624ef7a9f8d7acc20f8be8c895dd5db5a75e81f37"
     },
     "config.js": {
-      "size": 5862,
-      "sha256": "2692029ea79d7454f920fcdd6466cd6ee443a7029f36597a213585ed869f9af7"
+      "size": 5961,
+      "sha256": "1402cf8ad7c850da99e429c8c937385b7b5cf401fa3714d972d4e6bd94f1663e"
     },
     "context.d.ts": {
       "size": 596,
@@ -70,16 +70,16 @@
       "sha256": "4862b41e0477f01afa0dbb446d4553b65c22ed774cd1e2db3489059ced392f94"
     },
     "dashboard/ui.js": {
-      "size": 64493,
-      "sha256": "061c304bad22631db4ad795457c0eb5064f060f534d5050e2e14c6a1c01a2c1b"
+      "size": 70368,
+      "sha256": "b9f67e7977a36b459ac8d37312547b2638fcab7fc9b6c3d0c072d02510fca62f"
     },
     "index.d.ts": {
-      "size": 2370,
-      "sha256": "4cfee97f40d9dd12f5ea37996bee548a5964ee2cbe45c4e844bf5a119d9470d3"
+      "size": 2470,
+      "sha256": "99c28d43f79dbb2b372bf6a8b611841c131f59f5066702b499915b874e9fa2b8"
     },
     "index.js": {
-      "size": 3237,
-      "sha256": "d610de7775e31196a8acca02425c407e64bfdb69977290443664d36eaa022426"
+      "size": 3255,
+      "sha256": "a293d38a9e56a2ab802f99143eb1eaebb18f854e610f29bc95878746ffe26326"
     },
     "migrations/20260331000001_create_zin_trace_entries_table.d.ts": {
       "size": 304,
@@ -134,8 +134,8 @@
       "sha256": "71d366165dd36f1675aa253a76262b226fb6c62e5ab632746b8aea61c0c625fc"
     },
     "register.js": {
-      "size": 10601,
-      "sha256": "4e25cf1a5206578c0c1ad77febc258215d97d0468facc51d01a9259c0634757d"
+      "size": 12522,
+      "sha256": "66bccec7fac4d669702fa18e439788325d36ce17f228639005ffcde2cd968d70"
     },
     "storage/DebuggerStorage.d.ts": {
       "size": 517,
@@ -186,8 +186,8 @@
       "sha256": "d916e8e3abb1b1087f6b184851b0e6265e53380d7857b008e745d566aad15d44"
     },
     "types.d.ts": {
-      "size": 7687,
-      "sha256": "c1c5f5140d157d66355c65c774f055af2dccc470c9ee9fe403bbb96fbf4447d0"
+      "size": 8448,
+      "sha256": "de994120c04696e08afb428cff27a99fb2918f5c4277b8190b8fb3d36d139f0d"
     },
     "types.js": {
       "size": 696,
@@ -266,12 +266,12 @@
       "sha256": "879a739de9ce2c3c5b57bdad73eae2ce3de94ccdc7e666ca52a50b45b0bc9bfd"
     },
     "watchers/CacheWatcher.d.ts": {
-      "size": 265,
-      "sha256": "cd30b7e8cd9ccd90a125073198dd2ad098706ab6e545f6152f94ccaeb616fa52"
+      "size": 314,
+      "sha256": "19b5f6fe4f0fc8f3df6762f4f46d36f198c7c7d7da8d3d23e5c8f124462e8cf7"
     },
     "watchers/CacheWatcher.js": {
-      "size": 1518,
-      "sha256": "1dae7cddf7940d7e6d478429d846390c9a862e30bd72bc68182b85f92b425dd0"
+      "size": 1956,
+      "sha256": "e1e1b79e85e7553d856ff0209d912e27d7b4fe665579de856c60e04bb7519aa1"
     },
     "watchers/CommandWatcher.d.ts": {
       "size": 267,
@@ -298,12 +298,12 @@
       "sha256": "ff32b44b48b6e313d15ba4370a845faf74ff8b03504a6336c19f183ff91a90dc"
     },
     "watchers/ExceptionWatcher.d.ts": {
-      "size": 144,
-      "sha256": "d1b5f5668a2fa3069b5b9f9c8852b66e1ef6489e5d1f47381bde582d6e406960"
+      "size": 311,
+      "sha256": "0f58c50fd77704151399ca6cb6ec7890a9aef86afe28235951971f8cc9c1d600"
     },
     "watchers/ExceptionWatcher.js": {
-      "size": 3451,
-      "sha256": "e4fe3d1df1c7d547b740bdf993503f43b80b6cc55aa151fe0cdc0f59b4442491"
+      "size": 3691,
+      "sha256": "d2ddd55f14730b0404cea53c17a6cfd4bd65ff3c17c8b068cc284de109da36d1"
     },
     "watchers/GateWatcher.d.ts": {
       "size": 262,
@@ -314,20 +314,20 @@
       "sha256": "f318cdeec954ce0bba97be1dc11a6dff935b081e6b6a417c614be1934fa47f04"
     },
     "watchers/HttpClientWatcher.d.ts": {
-      "size": 283,
-      "sha256": "1b48661bff79b2f72464c978ad7e6dcf011197ca4a3014e64e99b70437b3e5a1"
+      "size": 333,
+      "sha256": "08ab7e213c489ecc4fdd3166d7a121b9a5220ff9cbae9841d4787d9a804e11ce"
     },
     "watchers/HttpClientWatcher.js": {
-      "size": 1627,
-      "sha256": "65e910145f4d24f06643a847a1d75bc60034a629a5da61097ba9324d1d1c7ddd"
+      "size": 2414,
+      "sha256": "817c74e7a89bcd0c53c0344d713b422e0c9e51ec65e7b6c97f0c486116dda7a5"
     },
     "watchers/HttpWatcher.d.ts": {
       "size": 96,
       "sha256": "ce9a95a670f755193fd74ce721dbfa4b30f20c879a6566ebb35229b3b2435429"
     },
     "watchers/HttpWatcher.js": {
-      "size": 5557,
-      "sha256": "9f86966178485e2aab46ce03785c7c512feb641dbf5d0dda22d51f3f259d374e"
+      "size": 5916,
+      "sha256": "9b3fed08fd11f8a2bfe1f667293af437b00f11dcc66bfb545b2f77925394e611"
     },
     "watchers/JobWatcher.d.ts": {
       "size": 441,
@@ -342,16 +342,16 @@
       "sha256": "f3ddc5f8b58c6c86ac6b464dd48e5a55e79ab2bf2e735feacffc7480e4ccc0c4"
     },
     "watchers/LogWatcher.js": {
-      "size": 1768,
-      "sha256": "a7e769d504d5528068e9349f28d703606d21404d3976f7cdb131cee417420ff6"
+      "size": 2026,
+      "sha256": "c5d2227cd76ce10162993ac31f474b2460cd41264c36f01b5130152f14a0ad21"
     },
     "watchers/MailWatcher.d.ts": {
-      "size": 214,
-      "sha256": "aa4a677b61f231cc29c314d3091dfecf45cac30f164f6ac5e99f0f3d1e714154"
+      "size": 244,
+      "sha256": "5031b96ef8e64a6d376576e8cddf1c2560f22432a78f1d2be55f7cea6bff4547"
     },
     "watchers/MailWatcher.js": {
-      "size": 1214,
-      "sha256": "2bc8cb264822107cfc29d0341559f517186190492e594cb7ab1942b6ae28ea56"
+      "size": 1655,
+      "sha256": "0eb4f43c27a0c76cf290bb6507e71dc595bff3f8ab66c25249d9ac6027b351c5"
     },
     "watchers/MiddlewareWatcher.d.ts": {
       "size": 259,
@@ -370,20 +370,20 @@
       "sha256": "de3d1e379c7b1289167fe0b1dbf2aa5a54137b841df17c8d397ee656d9ce37fd"
     },
     "watchers/NotificationWatcher.d.ts": {
-      "size": 237,
-      "sha256": "02fdf20e32ab8c93c10ce5c93a88b2349e73a30e9eb391413b8a401899d1053e"
+      "size": 274,
+      "sha256": "a1d918122c5db9a7f27fdf78c0c14a61f6e1213748ee6f9b06f976f33589dc33"
     },
     "watchers/NotificationWatcher.js": {
-      "size": 1242,
-      "sha256": "e72cc2fcc622f44b907560ca664a3f88a388ac444c7a0c290c00e95899b123a3"
+      "size": 1697,
+      "sha256": "b0ecc1df6a49dc8c5ffeb8dff0f1e3594ba016c4de3424dc8b5d7832e2f4cd11"
     },
     "watchers/QueryWatcher.d.ts": {
-      "size": 97,
-      "sha256": "6832a282b1658398264ede770d41c6aa86cb13625a3a87dac27fbaf7d2f7be6a"
+      "size": 240,
+      "sha256": "5d5046c65e5b683369c7709f1acd09b60aec3e7f44748fd1baeb35498836465b"
     },
     "watchers/QueryWatcher.js": {
-      "size": 2642,
-      "sha256": "76a7fdd42a340141810f541ed89845c303f5498db7bdcfa29d8d576cf36c8efb"
+      "size": 2935,
+      "sha256": "577c6fec0282d2290db5c4b6c606b9b6ecdd64209af2b09f3205a15bf656bbef"
     },
     "watchers/RedisWatcher.d.ts": {
       "size": 294,

package/dist/config.js

@@ -76,9 +76,12 @@ const mergeWatchers = (base, override) => {
 const DEFAULTS = Object.freeze({
     enabled: false,
     connection: undefined,
+    observeConnection: undefined,
     pruneAfterHours: 24,
     ignoreRoutes: ['/trace', '/health', '/ping'],
     slowQueryThreshold: 100,
+    captureCachePayloads: false,
+    captureQueryBindings: true,
     logMinLevel: 'info',
     watchers: {},
     redaction: {

package/dist/dashboard/ui.js

@@ -41,7 +41,7 @@ const encodeSvgDataUri = (svg) => {
     const compactSvg = svg.replaceAll(/>\s+</g, '><').trim();
     return `data:image/svg+xml;charset=UTF-8,${encodeURIComponent(compactSvg)}`;
 };
-const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
+const DASHBOARD_DOCUMENT = String.raw `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
@@ -74,7 +74,7 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
     .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 code{font-family:inherit}.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}
+    .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 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}.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}}
   </style>
 </head>
@@ -196,6 +196,8 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
       .replace(/"/g, '&quot;')
       .replace(/'/g, '&#39;');
 
+    const looksLikeHtml = (value) => new RegExp('</?(?:html|body|div|table)\\b|<!doctype\\b', 'i').test(String(value || ''));
+
     const api = async (path, opts) => {
       const response = await fetch(API + path, opts);
       if (!response.ok) {
@@ -335,6 +337,28 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
       ].join('');
     };
 
+    const renderTextCard = (label, value) => {
+      const source = String(value ?? '');
+      return renderCodeCard(label, source, escapeHtml(source), 'language-text');
+    };
+
+    const renderHtmlPreview = (label, html) => {
+      const source = String(html ?? '');
+      const copyId = registerCopyPayload(source);
+      return [
+        '<section class="code-card">',
+        '<div class="code-toolbar">',
+        '<span class="code-label">' + escapeHtml(label) + '</span>',
+        '<button type="button" class="copy-button" data-action="copy-code" data-copy-id="' + escapeHtml(copyId) + '" title="Copy ' + escapeHtml(label) + '">',
+        COPY_ICON,
+        '</button>',
+        '</div>',
+        '<pre class="code-block language-html"><code>' + escapeHtml(source) + '</code></pre>',
+        '<div class="html-preview-wrap"><iframe class="html-preview" sandbox="allow-same-origin" srcdoc="' + escapeHtml(source) + '"></iframe></div>',
+        '</section>'
+      ].join('');
+    };
+
     const highlightJson = (value, label = 'JSON') => {
       const source = prettyJson(value);
       let output = '';
@@ -386,6 +410,14 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
 
     const detailJson = (value, label = 'JSON') => highlightJson(value ?? {}, label);
 
+    const renderPayload = (label, value) => {
+      if (value === undefined) return '<p class="trace-note">No ' + escapeHtml(label.toLowerCase()) + ' was captured.</p>';
+      if (typeof value === 'string') {
+        return looksLikeHtml(value) ? renderHtmlPreview(label, value) : renderTextCard(label, value);
+      }
+      return detailJson(value, label);
+    };
+
     const entrySummaryText = (entry) => {
       const content = entry && entry.content ? entry.content : {};
       if (entry.type === 'request') return [content.responseStatus || '', content.method || '', content.uri || ''].filter(Boolean).join(' ');
@@ -393,20 +425,20 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
       if (entry.type === 'exception') return [content.class || '', content.message || ''].filter(Boolean).join(': ');
       if (entry.type === 'log') return '[' + String(content.level || 'log') + '] ' + String(content.message || '').slice(0, 160);
       if (entry.type === 'job') return [content.name || '', content.status || 'queued'].filter(Boolean).join(' · ');
-      if (entry.type === 'cache') return [content.operation || '', content.key || ''].filter(Boolean).join(' ');
+      if (entry.type === 'cache') return [content.operation || '', content.key || '', content.payloadLogged ? '' : '(payload off)'].filter(Boolean).join(' ');
       if (entry.type === 'schedule') return [content.name || '', content.status || 'ran'].filter(Boolean).join(' · ');
       if (entry.type === 'mail') return ['To ' + (content.to || 'unknown'), content.subject || 'No subject'].join(' · ');
       if (entry.type === 'auth') return [content.event || 'auth', content.userId ? '#' + content.userId : ''].filter(Boolean).join(' ');
       if (entry.type === 'event') return String(content.name || 'event');
       if (entry.type === 'model') return [content.action || '', content.model || ''].filter(Boolean).join(' ');
-      if (entry.type === 'notification') return [content.notification || '', (content.channels || []).join(', ')].filter(Boolean).join(' -> ');
+      if (entry.type === 'notification') return [content.notification || '', content.message || (content.channels || []).join(', ')].filter(Boolean).join(' -> ');
       if (entry.type === 'redis') return String(content.command || 'redis');
       if (entry.type === 'gate') return [content.ability || '', content.result || ''].filter(Boolean).join(' · ');
       if (entry.type === 'middleware') return [content.name || '', content.event || ''].filter(Boolean).join(' · ');
       if (entry.type === 'command') return [content.name || '', content.exitCode !== undefined ? 'exit=' + content.exitCode : ''].filter(Boolean).join(' ');
       if (entry.type === 'batch') return [content.name || '', 'processed ' + (content.processed || 0) + '/' + (content.total || 0)].join(' · ');
       if (entry.type === 'view') return String(content.template || 'view');
-      if (entry.type === 'client_request') return [content.method || '', content.url || ''].filter(Boolean).join(' ');
+      if (entry.type === 'client_request') return [content.method || '', content.url || '', content.responseStatus ? '[' + content.responseStatus + ']' : content.error ? '[failed]' : ''].filter(Boolean).join(' ');
       return JSON.stringify(content).slice(0, 160);
     };
 
@@ -442,6 +474,7 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
             { label: 'Connection', value: escapeHtml(content.connection || 'default') },
             { label: 'Duration', value: escapeHtml(formatDuration(getEntryDuration(entry))) },
             { label: 'Slow', value: escapeHtml(content.slow ? 'Yes' : 'No') },
+            { label: 'Bindings', value: escapeHtml(content.bindingsIncluded === false ? 'Hidden' : 'Included') },
             { label: 'Hash', value: '<span class="mono">' + escapeHtml(content.hash || '') + '</span>' }
           ]),
           renderMetricBox('Runtime', [
@@ -449,7 +482,8 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
             { label: 'Batch', value: '<span class="mono">' + escapeHtml(entry.batchId || '-') + '</span>' }
           ]),
           '</div>',
-          highlightSql(content.sql || '')
+          highlightSql(content.sql || ''),
+          content.bindingsIncluded === false ? '<p class="trace-note">SQL bindings were hidden for this entry.</p>' : (Array.isArray(content.bindings) ? detailJson(content.bindings, 'Bindings Json') : '')
         ].join('');
       }
 
@@ -493,7 +527,34 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
           renderMetricBox('Request', [
             { label: 'Method', value: escapeHtml(content.method || '') },
             { label: 'URL', value: '<span class="mono">' + escapeHtml(content.url || '') + '</span>' },
-            { label: 'Status', value: escapeHtml(content.responseStatus || '') },
+            { label: 'Status', value: escapeHtml(content.responseStatus || (content.error ? 'Failed' : 'Pending')) },
+            { label: 'Duration', value: escapeHtml(formatDuration(getEntryDuration(entry))) }
+          ]),
+          renderMetricBox('Runtime', [
+            { label: 'Hostname', value: escapeHtml(content.hostname || '') },
+            { label: 'Batch', value: '<span class="mono">' + escapeHtml(entry.batchId || '-') + '</span>' },
+            { label: 'Error', value: escapeHtml(content.error || '-') }
+          ]),
+          '</div>',
+          '<div class="detail-stack">',
+          detailJson(content.requestHeaders || {}, 'Request Header Json'),
+          renderPayload('Request Body', content.requestBody),
+          detailJson(content.responseHeaders || {}, 'Response Header Json'),
+          renderPayload('Response Body', content.responseBody),
+          '</div>'
+        ].join('');
+      }
+
+      if (entry.type === 'cache') {
+        return [
+          '<div class="detail-grid">',
+          renderMetricBox('Cache', [
+            { label: 'Operation', value: escapeHtml(content.operation || '') },
+            { label: 'Key', value: '<span class="mono">' + escapeHtml(content.key || '') + '</span>' },
+            { label: 'Store', value: escapeHtml(content.store || 'default') },
+            { label: 'Hit', value: escapeHtml(content.hit === undefined ? '-' : (content.hit ? 'Yes' : 'No')) },
+            { label: 'Payload', value: escapeHtml(content.payloadLogged ? 'Captured' : 'Disabled') },
+            { label: 'TTL', value: escapeHtml(content.ttl === undefined ? '-' : String(content.ttl)) },
             { label: 'Duration', value: escapeHtml(formatDuration(getEntryDuration(entry))) }
           ]),
           renderMetricBox('Runtime', [
@@ -501,7 +562,41 @@ const DASHBOARD_DOCUMENT = `<!DOCTYPE html>
             { label: 'Batch', value: '<span class="mono">' + escapeHtml(entry.batchId || '-') + '</span>' }
           ]),
           '</div>',
-          detailJson(content.requestHeaders || {})
+          content.payloadLogged ? renderPayload('Cache Payload', content.payload) : '<p class="trace-note">Cache payload logging is disabled. Set TRACE_CACHE_PAYLOADS=true to include values.</p>'
+        ].join('');
+      }
+
+      if (entry.type === 'mail') {
+        return [
+          '<div class="detail-grid">',
+          renderMetricBox('Mail', [
+            { label: 'To', value: escapeHtml(content.to || '') },
+            { label: 'Subject', value: escapeHtml(content.subject || '') },
+            { label: 'Template', value: escapeHtml(content.template || '-') },
+            { label: 'Hostname', value: escapeHtml(content.hostname || '') }
+          ]),
+          '</div>',
+          '<div class="detail-stack">',
+          renderPayload('Mail Text', content.text),
+          renderPayload('Mail Html', content.html),
+          '</div>'
+        ].join('');
+      }
+
+      if (entry.type === 'notification') {
+        return [
+          '<div class="detail-grid">',
+          renderMetricBox('Notification', [
+            { label: 'Notification', value: escapeHtml(content.notification || '') },
+            { label: 'Channels', value: escapeHtml((content.channels || []).join(', ') || '-') },
+            { label: 'Recipient', value: escapeHtml(content.notifiable || '-') },
+            { label: 'Hostname', value: escapeHtml(content.hostname || '') }
+          ]),
+          '</div>',
+          '<div class="detail-stack">',
+          renderPayload('Message', content.message),
+          content.payload === undefined ? '<p class="trace-note">No additional notification payload was captured.</p>' : detailJson(content.payload, 'Notification Payload Json'),
+          '</div>'
         ].join('');
       }
 

package/dist/register.js

@@ -64,6 +64,17 @@ const resolveTraceConnectionName = (env, configuredConnection) => {
     }
     return resolveDefaultConnection();
 };
+const resolveObservedConnectionName = (env, configuredObservedConnection, storageConnectionName) => {
+    if (typeof configuredObservedConnection === 'string' &&
+        configuredObservedConnection.trim() !== '') {
+        return resolveTraceConnectionName(env, configuredObservedConnection);
+    }
+    const defaultConnectionName = resolveTraceConnectionName(env, undefined);
+    if (storageConnectionName !== defaultConnectionName) {
+        return defaultConnectionName;
+    }
+    return storageConnectionName;
+};
 const isObjectValue = (value) => {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 };
@@ -90,6 +101,16 @@ const parseEnvList = (rawValue) => {
         .map((entry) => entry.trim())
         .filter((entry) => entry !== '');
 };
+const parseEnvBool = (rawValue) => {
+    const value = rawValue.trim().toLowerCase();
+    if (value === '')
+        return undefined;
+    if (['1', 'true', 'yes', 'on'].includes(value))
+        return true;
+    if (['0', 'false', 'no', 'off'].includes(value))
+        return false;
+    return undefined;
+};
 const resolveTraceStartupOverrides = (core) => {
     const traceConfigFile = core.StartupConfigFile?.Trace;
     if (typeof traceConfigFile !== 'string' || traceConfigFile.trim() === '')
@@ -136,14 +157,18 @@ if (!traceAlreadyInitialized && Env) {
     const enabled = startupOverrides?.enabled === true || Env.getBool('TRACE_ENABLED', false);
     if (enabled) {
         const connectionRaw = Env.get('TRACE_DB_CONNECTION', '').trim();
+        const observeConnectionRaw = Env.get('TRACE_QUERY_CONNECTION', '').trim();
         const pruneAfterHoursRaw = Env.get('TRACE_PRUNE_HOURS', '').trim();
         const slowQueryThresholdRaw = Env.get('TRACE_SLOW_QUERY_MS', '').trim();
         const logMinLevelRaw = Env.get('TRACE_LOG_LEVEL', '').trim();
+        const captureCachePayloadsRaw = Env.get('TRACE_CACHE_PAYLOADS', '').trim();
+        const captureQueryBindingsRaw = Env.get('TRACE_QUERY_BINDINGS', '').trim();
         const redactionKeys = parseEnvList(Env.get('TRACE_REDACT_KEYS', ''));
         const redactionHeaders = parseEnvList(Env.get('TRACE_REDACT_HEADERS', ''));
         const redactionBody = parseEnvList(Env.get('TRACE_REDACT_BODY', ''));
         const redactionQuery = parseEnvList(Env.get('TRACE_REDACT_QUERY', ''));
         const connection = connectionRaw === '' ? startupOverrides?.connection : connectionRaw;
+        const observeConnection = observeConnectionRaw === '' ? startupOverrides?.observeConnection : observeConnectionRaw;
         const pruneAfterHours = pruneAfterHoursRaw === ''
             ? startupOverrides?.pruneAfterHours
             : Number.parseInt(pruneAfterHoursRaw, 10);
@@ -151,6 +176,8 @@ if (!traceAlreadyInitialized && Env) {
             ? startupOverrides?.slowQueryThreshold
             : Number.parseInt(slowQueryThresholdRaw, 10);
         const logMinLevel = (logMinLevelRaw === '' ? startupOverrides?.logMinLevel : logMinLevelRaw);
+        const captureCachePayloads = parseEnvBool(captureCachePayloadsRaw) ?? startupOverrides?.captureCachePayloads;
+        const captureQueryBindings = parseEnvBool(captureQueryBindingsRaw) ?? startupOverrides?.captureQueryBindings;
         const redaction = buildTraceRedactionOverrides({
             startupOverrides,
             redactionBody,
@@ -162,19 +189,24 @@ if (!traceAlreadyInitialized && Env) {
             ...startupOverrides,
             enabled,
             connection,
+            observeConnection,
             ...(typeof pruneAfterHours === 'number' && Number.isFinite(pruneAfterHours)
                 ? { pruneAfterHours }
                 : {}),
             ...(typeof slowQueryThreshold === 'number' && Number.isFinite(slowQueryThreshold)
                 ? { slowQueryThreshold }
                 : {}),
+            ...(typeof captureCachePayloads === 'boolean' ? { captureCachePayloads } : {}),
+            ...(typeof captureQueryBindings === 'boolean' ? { captureQueryBindings } : {}),
             logMinLevel,
             ...(redaction === undefined ? {} : { redaction }),
         });
         const resolvedConnectionName = resolveTraceConnectionName(Env, config.connection);
-        const db = core.useDatabase?.(undefined, resolvedConnectionName);
-        if (db) {
-            const storage = TraceWriteDiagnostics.wrapStorage(TraceContentRedaction.wrapStorage(TraceEntryFiltering.wrapStorage(TraceStorage.resolveStorage(db), config), config.redaction), {
+        const resolvedObservedConnectionName = resolveObservedConnectionName(Env, config.observeConnection, resolvedConnectionName);
+        const storageDb = core.useDatabase?.(undefined, resolvedConnectionName);
+        const observedDb = core.useDatabase?.(undefined, resolvedObservedConnectionName);
+        if (storageDb && observedDb) {
+            const storage = TraceWriteDiagnostics.wrapStorage(TraceContentRedaction.wrapStorage(TraceEntryFiltering.wrapStorage(TraceStorage.resolveStorage(storageDb), config), config.redaction), {
                 connectionName: resolvedConnectionName,
                 logger: core.Logger,
             });
@@ -203,7 +235,7 @@ if (!traceAlreadyInitialized && Env) {
                 import('./watchers/ViewWatcher.js'),
                 import('./watchers/HttpClientWatcher.js'),
             ]);
-            const watcherArgs = { storage, config, db };
+            const watcherArgs = { storage, config, db: observedDb };
             HttpWatcher.register({ ...watcherArgs, registerMiddleware: resolveRegisterMiddleware() });
             QueryWatcher.register(watcherArgs);
             LogWatcher.register(watcherArgs);

package/dist/types.d.ts

@@ -43,6 +43,9 @@ export interface RequestContent {
 export interface QueryContent {
     connection: string;
     sql: string;
+    statement?: string;
+    bindings?: unknown[];
+    bindingsIncluded?: boolean;
     time: number;
     duration: number;
     slow: boolean;
@@ -91,6 +94,10 @@ export interface CacheContent {
     operation: 'get' | 'set' | 'delete' | 'clear' | 'has';
     key: string;
     hit?: boolean;
+    store?: string;
+    payload?: unknown;
+    payloadLogged?: boolean;
+    ttl?: number;
     duration: number;
     hostname: string;
 }
@@ -106,6 +113,8 @@ export interface MailContent {
     to: string;
     subject: string;
     template?: string;
+    text?: string;
+    html?: string;
     hostname: string;
 }
 export interface AuthContent {
@@ -130,6 +139,8 @@ export interface NotificationContent {
     channels: string[];
     notifiable?: string;
     notification: string;
+    message?: string;
+    payload?: unknown;
     hostname: string;
 }
 export interface RedisContent {
@@ -181,10 +192,25 @@ export interface ClientRequestContent {
     method: string;
     url: string;
     requestHeaders: Record<string, string>;
-    responseStatus: number;
+    requestBody?: unknown;
+    responseStatus?: number;
+    responseHeaders?: Record<string, string>;
+    responseBody?: unknown;
+    error?: string;
     duration: number;
     hostname: string;
 }
+export interface ClientRequestTraceInput {
+    method: string;
+    url: string;
+    requestHeaders: Record<string, string>;
+    responseStatus?: number;
+    duration: number;
+    requestBody?: unknown;
+    responseHeaders?: Record<string, string>;
+    responseBody?: unknown;
+    error?: string;
+}
 export interface ITraceEntry<T = unknown> {
     uuid: string;
     batchId: string;
@@ -277,9 +303,12 @@ export type WatcherToggles = {
 export interface ITraceConfig {
     enabled: boolean;
     connection?: string;
+    observeConnection?: string;
     pruneAfterHours: number;
     ignoreRoutes: string[];
     slowQueryThreshold: number;
+    captureCachePayloads: boolean;
+    captureQueryBindings: boolean;
     logMinLevel: 'debug' | 'info' | 'warn' | 'error' | 'fatal';
     watchers: WatcherToggles;
     redaction: RedactionConfig;

package/dist/watchers/CacheWatcher.d.ts

@@ -1,5 +1,5 @@
 import type { CacheContent, ITraceWatcher } from '../types';
-declare const emit: (operation: CacheContent["operation"], key: string, duration: number, hit?: boolean) => void;
+declare const emit: (operation: CacheContent["operation"], key: string, duration: number, hit?: boolean, payload?: unknown, store?: string, ttl?: number) => void;
 export declare const CacheWatcher: ITraceWatcher & {
     emit: typeof emit;
 };