@zintrust/trace 0.7.0 → 0.7.2

package/dist/build-manifest.json

@@ -1,14 +1,14 @@
 {
   "name": "@zintrust/trace",
-  "version": "0.7.0",
-  "buildDate": "2026-04-17T14:20:06.644Z",
+  "version": "0.7.2",
+  "buildDate": "2026-04-18T19:23:29.310Z",
   "buildEnvironment": {
     "node": "v22.22.1",
     "platform": "darwin",
     "arch": "arm64"
   },
   "git": {
-    "commit": "5b1c8641",
+    "commit": "126e1196",
     "branch": "release"
   },
   "package": {
@@ -22,8 +22,8 @@
   },
   "files": {
     "build-manifest.json": {
-      "size": 14743,
-      "sha256": "28f88d02b98b9c6fcfb60b9344de6eebd8307e3186da15e82d1e4332691ac87d"
+      "size": 14744,
+      "sha256": "6cd46c9c15b2d55e83b4563969b4180be3c278cda5438003d8ba98b543133a49"
     },
     "cli-register.d.ts": {
       "size": 255,
@@ -79,7 +79,7 @@
     },
     "index.js": {
       "size": 3324,
-      "sha256": "0ff435971e5fb1664cc95787db83a609997ecfee3b389275467e6a8944cf8c0c"
+      "sha256": "fea850dbd404cad2e9cf9e29c718dd0596216a4ec766bb8701b399a10c7adeb9"
     },
     "migrations/20260331000001_create_zin_trace_entries_table.d.ts": {
       "size": 304,
@@ -182,8 +182,8 @@
       "sha256": "5f49df97a830ad895653fa4a18b3a1b31ca4a5066d6f8150ee02dca013e16397"
     },
     "storage/TraceWriteDiagnostics.js": {
-      "size": 6714,
-      "sha256": "398b2cb74e2e7278c6a3b5d29537e7a95581e0a1cb9fb5831f7ff13ac70805e4"
+      "size": 7041,
+      "sha256": "6fc34e6e52a9b463db0967dba4aec4c8c706b6978c496f568637ffc15327279a"
     },
     "storage/index.d.ts": {
       "size": 100,
@@ -350,8 +350,8 @@
       "sha256": "f3ddc5f8b58c6c86ac6b464dd48e5a55e79ab2bf2e735feacffc7480e4ccc0c4"
     },
     "watchers/LogWatcher.js": {
-      "size": 3146,
-      "sha256": "aa8a8e7d324a217911640d4616fc9c41f07cb1c3f4ad130a8a05b6c213516fba"
+      "size": 3290,
+      "sha256": "0297479465b25f93ab0b11bfd6c2083afe9023fdddaa1b7841d12d68b294fa3e"
     },
     "watchers/MailWatcher.d.ts": {
       "size": 244,

package/dist/storage/TraceWriteDiagnostics.js

@@ -69,6 +69,14 @@ const withOptionalDetail = (context, errorDetails) => {
         return context;
     return { ...context, errorDetails };
 };
+const TRACE_SKIP_LOG_CONTEXT_KEY = '__zintrustSkipTraceLog';
+const withTraceSkipContext = (logger, context) => {
+    const loggerWithTraceSkip = logger;
+    return (loggerWithTraceSkip.withTraceSkipContext?.(context) ?? {
+        ...context,
+        [TRACE_SKIP_LOG_CONTEXT_KEY]: true,
+    });
+};
 const getErrorMessage = (error) => {
     let baseMessage = '';
     if (error instanceof Error && error.message.trim() !== '') {
@@ -123,14 +131,14 @@ const reportFailure = (logger, context) => {
     if (typeof lastLoggedAt === 'number' && now - lastLoggedAt < LOG_WINDOW_MS)
         return;
     diagnosticsState.lastLoggedAtByFingerprint.set(fingerprint, now);
-    logger.warn('[trace] Trace storage write degraded', withOptionalDetail({
+    logger.warn('[trace] Trace storage write degraded', withTraceSkipContext(logger, withOptionalDetail({
         connectionName: context.connectionName,
         error: errorMessage,
         lastFailureAt: now,
         operation: context.operation,
         totalFailures: diagnosticsState.totalFailures,
         watcherType: context.watcherType ?? null,
-    }, errorDetails));
+    }, errorDetails)));
 };
 const wrapStorageMethod = (method, describeFailure, connectionName, logger) => {
     return async (...args) => {

package/dist/watchers/LogWatcher.js

@@ -46,6 +46,10 @@ const isTraceStorageQueryLog = (message, context) => {
     return typeof sql === 'string' && isTraceStorageQuery(sql);
 };
 const shouldSkipTraceInfrastructureLog = (message, context) => {
+    const loggerWithTraceSkip = Logger;
+    if (loggerWithTraceSkip.shouldSkipTraceLogContext?.(context) === true) {
+        return true;
+    }
     return (TRACE_INFRASTRUCTURE_LOG_MESSAGES.has(message.trim()) ||
         isTraceStorageQueryLog(message, context));
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/trace",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "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.7.0"
+    "@zintrust/core": "^0.7.2"
   },
   "publishConfig": {
     "access": "public"

package/src/storage/TraceWriteDiagnostics.ts

@@ -101,6 +101,24 @@ const withOptionalDetail = (
   return { ...context, errorDetails };
 };
 
+const TRACE_SKIP_LOG_CONTEXT_KEY = '__zintrustSkipTraceLog';
+
+const withTraceSkipContext = (
+  logger: TraceLogger | undefined,
+  context: Record<string, unknown>
+): Record<string, unknown> => {
+  const loggerWithTraceSkip = logger as TraceLogger & {
+    withTraceSkipContext?: (ctx?: Record<string, unknown>) => Record<string, unknown>;
+  };
+
+  return (
+    loggerWithTraceSkip.withTraceSkipContext?.(context) ?? {
+      ...context,
+      [TRACE_SKIP_LOG_CONTEXT_KEY]: true,
+    }
+  );
+};
+
 const getErrorMessage = (error: unknown): string => {
   let baseMessage = '';
   if (error instanceof Error && error.message.trim() !== '') {
@@ -163,16 +181,19 @@ const reportFailure = (
   diagnosticsState.lastLoggedAtByFingerprint.set(fingerprint, now);
   logger.warn(
     '[trace] Trace storage write degraded',
-    withOptionalDetail(
-      {
-        connectionName: context.connectionName,
-        error: errorMessage,
-        lastFailureAt: now,
-        operation: context.operation,
-        totalFailures: diagnosticsState.totalFailures,
-        watcherType: context.watcherType ?? null,
-      },
-      errorDetails
+    withTraceSkipContext(
+      logger,
+      withOptionalDetail(
+        {
+          connectionName: context.connectionName,
+          error: errorMessage,
+          lastFailureAt: now,
+          operation: context.operation,
+          totalFailures: diagnosticsState.totalFailures,
+          watcherType: context.watcherType ?? null,
+        },
+        errorDetails
+      )
     )
   );
 };

package/src/watchers/LogWatcher.ts

@@ -61,6 +61,14 @@ const shouldSkipTraceInfrastructureLog = (
   message: string,
   context?: Record<string, unknown>
 ): boolean => {
+  const loggerWithTraceSkip = Logger as typeof Logger & {
+    shouldSkipTraceLogContext?: (ctx?: Record<string, unknown>) => boolean;
+  };
+
+  if (loggerWithTraceSkip.shouldSkipTraceLogContext?.(context) === true) {
+    return true;
+  }
+
   return (
     TRACE_INFRASTRUCTURE_LOG_MESSAGES.has(message.trim()) ||
     isTraceStorageQueryLog(message, context)