@reproapp/node-sdk 0.0.9 → 0.0.12

package/dist/index.d.ts

@@ -67,9 +67,12 @@ type TraceEventRecord = {
     spanId?: string | number | null;
     parentSpanId?: string | number | null;
     args?: any;
+    argsValueCapture?: TraceValueCaptureRef;
     returnValue?: any;
+    returnValueCapture?: TraceValueCaptureRef;
     threw?: boolean;
     error?: any;
+    errorValueCapture?: TraceValueCaptureRef;
     unawaited?: boolean;
 };
 type PendingTraceEventRecord = TraceEventRecord & {
@@ -82,9 +85,14 @@ type PendingTraceEventRecord = TraceEventRecord & {
     __reproSourceFile?: string | null;
     __reproTraceValueEntries?: TraceValueBatchEntry[];
 };
+type TraceValueCaptureRef = {
+    status: 'stored' | 'truncated-for-storage' | 'skipped-non-meaningful';
+    valueId?: string;
+    projectedKind?: string;
+};
 type TraceValueBatchEntry = {
     id: string;
-    target: 'db.pk' | 'db.before' | 'db.after' | 'db.query' | 'db.resultMeta' | 'db.error' | 'request.headers' | 'request.body' | 'request.params' | 'request.query' | 'response.body';
+    target: 'db.pk' | 'db.before' | 'db.after' | 'db.query' | 'db.resultMeta' | 'db.error' | 'request.headers' | 'request.body' | 'request.params' | 'request.query' | 'response.body' | 'trace.args' | 'trace.returnValue' | 'trace.error';
     value: any;
     truncatedForStorage?: boolean;
     projectedKind?: string;
@@ -254,6 +262,8 @@ export type ReproTracingInitOptions = TracerInitOpts & {
 export declare function initReproTracing(opts?: ReproTracingInitOptions): TracerApi | null;
 /** Optional helper if users want to check it. */
 export declare function isReproTracingEnabled(): boolean;
+declare function sanitizeTraceValueForPrivacy(value: any): any;
+declare function sanitizeMaterializedTraceValue(value: any): any;
 export declare function __materializePendingTraceEventsForWorker(payload: TraceMaterializationWorkerPayload): Promise<PendingTraceEventRecord[]>;
 type NormalizedMaskRule = {
     when?: ReproMaskWhen;
@@ -283,6 +293,7 @@ type InlinePrivacyMaterializationResult = {
     };
 };
 declare function materializeInlinePrivacyValueAsync(target: RuntimePrivacySurface, value: any, cfg: ReproMiddlewareConfig, req: MaskRequestContext, trace: TraceEventForFilter | null, masking: NormalizedMaskingConfig | null, privacy: NormalizedRuntimePrivacyPolicy | null, db?: RuntimePrivacyDbContext | null): Promise<InlinePrivacyMaterializationResult>;
+declare function getEventTraceValueEntries(event: TraceEventRecord | PendingTraceEventRecord): TraceValueBatchEntry[] | undefined;
 declare function estimateTraceBatchSerializedBytes(batch: TraceEventRecord[], requestRid: string, actionId: string | null | undefined, batchIndex: number): number;
 declare function chunkTraceEventsForTransport(events: TraceEventRecord[], requestRid: string, actionId: string | null | undefined): TraceEventRecord[][];
 export type ReproMiddlewareConfig = IngestClientConfig & {
@@ -344,6 +355,12 @@ export declare function initRepro(cfg: ReproInitConfig): Promise<void>;
 /** @internal Test hooks for runtime privacy policy wiring. */
 export declare const __reproTestHooks: {
     shareRuntimePrivacyStateForTest: typeof shareRuntimePrivacyState;
+    setFullValueCaptureEnabledForTest(enabled: boolean): void;
+    scheduleSdkBackgroundWorkForTest(work: () => Promise<void> | void, options?: {
+        priority?: 'high' | 'normal';
+    }): void;
+    drainSdkBackgroundQueueForTest(): Promise<void>;
+    resetSdkBackgroundQueuesForTest(): void;
     getRuntimePrivacyPolicyForTest(cfg: ReproMiddlewareConfig): NormalizedRuntimePrivacyPolicy | null;
     setRuntimePrivacyPolicyForTest(cfg: ReproMiddlewareConfig, policy: NormalizedRuntimePrivacyPolicy | null): void;
     recordKafkaTraceEventAsyncForTest: typeof recordKafkaTraceEventAsync;
@@ -352,5 +369,8 @@ export declare const __reproTestHooks: {
     wrapKafkaEachMessageHandlerForTest: typeof wrapKafkaEachMessageHandler;
     chunkTraceEventsForTransportForTest: typeof chunkTraceEventsForTransport;
     estimateTraceBatchSerializedBytesForTest: typeof estimateTraceBatchSerializedBytes;
+    sanitizeTraceValueForPrivacyForTest: typeof sanitizeTraceValueForPrivacy;
+    sanitizeMaterializedTraceValueForTest: typeof sanitizeMaterializedTraceValue;
+    getEventTraceValueEntriesForTest: typeof getEventTraceValueEntries;
 };
 export {};

package/dist/index.js

@@ -863,6 +863,7 @@ let activeClientRequestCount = 0;
 let oldestActiveClientRequestAt = null;
 let lastClientActivityAt = 0;
 let sdkBackgroundQuietUntil = 0;
+const sdkBackgroundHighQueue = [];
 const sdkBackgroundQueue = [];
 let sdkBackgroundTimer = null;
 let sdkBackgroundDraining = false;
@@ -1155,8 +1156,13 @@ function endClientRequest() {
         scheduleSdkBackgroundDrain();
     }
 }
-function scheduleSdkBackgroundWork(work) {
-    sdkBackgroundQueue.push(work);
+function scheduleSdkBackgroundWork(work, options = {}) {
+    if (options.priority === 'high') {
+        sdkBackgroundHighQueue.push(work);
+    }
+    else {
+        sdkBackgroundQueue.push(work);
+    }
     scheduleSdkBackgroundDrain();
 }
 function scheduleSdkBackgroundDrain(delayMs = 0) {
@@ -1209,12 +1215,12 @@ async function drainSdkBackgroundQueue() {
     }
     sdkBackgroundDraining = true;
     try {
-        while (sdkBackgroundQueue.length > 0) {
+        while (sdkBackgroundHighQueue.length > 0 || sdkBackgroundQueue.length > 0) {
             if (shouldDeferSdkBackgroundWork()) {
                 scheduleSdkBackgroundDrain();
                 return;
             }
-            const work = sdkBackgroundQueue.shift();
+            const work = sdkBackgroundHighQueue.shift() ?? sdkBackgroundQueue.shift();
             if (!work)
                 continue;
             try {
@@ -1228,7 +1234,7 @@ async function drainSdkBackgroundQueue() {
     }
     finally {
         sdkBackgroundDraining = false;
-        if (sdkBackgroundQueue.length > 0) {
+        if (sdkBackgroundHighQueue.length > 0 || sdkBackgroundQueue.length > 0) {
             scheduleSdkBackgroundDrain();
         }
         else {
@@ -2032,14 +2038,26 @@ function sanitizeTraceValue(value, depth = 0, seen = new WeakMap(), options = {}
         return circularReference(existingPath);
     seen.set(value, valuePath);
     if (!options.disableTruncation && depth >= TRACE_VALUE_MAX_DEPTH) {
-        const shallow = safeJson(value);
-        if (shallow !== undefined) {
-            return shallow;
+        if (Array.isArray(value)) {
+            return {
+                __type: 'Array',
+                length: value.length,
+                __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}`,
+            };
         }
         const ctor = value?.constructor?.name;
-        return ctor && ctor !== 'Object'
-            ? { __class: ctor, __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}` }
-            : { __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}` };
+        const keys = Object.keys(value);
+        const summary = {
+            __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}`,
+            __keys: keys.slice(0, TRACE_VALUE_MAX_KEYS),
+        };
+        if (keys.length > TRACE_VALUE_MAX_KEYS) {
+            summary.__truncatedKeys = keys.length - TRACE_VALUE_MAX_KEYS;
+        }
+        if (ctor && ctor !== 'Object') {
+            summary.__class = ctor;
+        }
+        return summary;
     }
     if (Array.isArray(value)) {
         const sourceItems = options.disableTruncation ? value : value.slice(0, TRACE_VALUE_MAX_ITEMS);
@@ -2105,9 +2123,62 @@ function sanitizeTraceArgs(values) {
 function sanitizeTraceValueForPrivacy(value) {
     return sanitizeTraceValue(value, 0, new WeakMap(), { preserveLongStrings: true, disableTruncation: true });
 }
+function sanitizeInlinePrivacyValue(value) {
+    return sanitizeTraceValue(value, 0, new WeakMap(), { preserveLongStrings: true, disableTruncation: true });
+}
 function sanitizeMaterializedTraceValue(value) {
     return sanitizeTraceValue(value, 0, new WeakMap(), { preserveLongStrings: true, disableTruncation: true });
 }
+function compactMaterializedTracePreview(value, depth = 0) {
+    if (value === undefined || value === null)
+        return value;
+    if (depth >= TRACE_VALUE_MAX_DEPTH) {
+        return makeOmittedValue(`depth>${TRACE_VALUE_MAX_DEPTH}`);
+    }
+    const type = typeof value;
+    if (type === 'string') {
+        if (value.length <= TRACE_VALUE_MAX_STRING)
+            return value;
+        return value.slice(0, TRACE_VALUE_MAX_STRING);
+    }
+    if (type === 'number' || type === 'boolean')
+        return value;
+    if (type === 'bigint')
+        return value.toString();
+    if (type === 'symbol')
+        return value.toString();
+    if (type === 'function')
+        return `[Function${value.name ? ` ${value.name}` : ''}]`;
+    if (type !== 'object')
+        return String(value);
+    if (Array.isArray(value)) {
+        return value
+            .slice(0, TRACE_VALUE_MAX_ITEMS)
+            .map((item) => compactMaterializedTracePreview(item, depth + 1));
+    }
+    const out = {};
+    const keys = Object.keys(value).slice(0, TRACE_VALUE_MAX_KEYS);
+    for (const key of keys) {
+        try {
+            out[key] = compactMaterializedTracePreview(value[key], depth + 1);
+        }
+        catch (err) {
+            out[key] = `[Cannot serialize: ${err?.message || 'unknown error'}]`;
+        }
+    }
+    return out;
+}
+function limitMaterializedTraceInlineValue(value) {
+    const inlineValue = sanitizeMaterializedTraceValue(value);
+    if (!traceInlineValueExceedsLimit(inlineValue)) {
+        return inlineValue;
+    }
+    const compactPreview = compactMaterializedTracePreview(inlineValue);
+    if (!traceInlineValueExceedsLimit(compactPreview)) {
+        return compactPreview;
+    }
+    return makeOmittedValue('inline-size-limit');
+}
 function sanitizeTraceArgsForPrivacy(values) {
     if (!Array.isArray(values))
         return [sanitizeTraceValueForPrivacy(values)];
@@ -2121,6 +2192,14 @@ function normalizeRawTraceArgs(values) {
 function hasMeaningfulRawTraceError(error) {
     return error !== undefined && error !== null;
 }
+function attachTraceValueEntry(event, entry) {
+    const current = event[TRACE_FULL_VALUE_ENTRY_SYMBOL];
+    if (Array.isArray(current)) {
+        current.push(entry);
+        return;
+    }
+    event[TRACE_FULL_VALUE_ENTRY_SYMBOL] = [entry];
+}
 async function materializePendingTraceEvents(events, params) {
     for (const evt of events) {
         const pending = evt.__reproPending;
@@ -2130,14 +2209,71 @@ async function materializePendingTraceEvents(events, params) {
         const candidate = pending.candidate ?? traceEventCandidateFromRecord(evt);
         const omitJsonBuiltinValues = shouldOmitJsonBuiltinTraceValues(candidate);
         const activePrivacy = params.resolvePrivacy();
+        const captureContext = {
+            runtimeConfig: params.cfg,
+            captureHeaders: params.cfg.captureHeaders,
+            maskReq: params.maskReq,
+            trace: candidate,
+            masking: params.masking,
+            privacy: activePrivacy,
+        };
+        const traceValueMetadata = {
+            fn: evt.fn,
+            file: evt.file,
+            line: evt.line ?? null,
+            spanId: evt.spanId ?? null,
+            parentSpanId: evt.parentSpanId ?? null,
+        };
         if (!omitJsonBuiltinValues && pending.argsRaw !== undefined) {
-            evt.args = sanitizeMaterializedTraceValue(await materializeTracePrivacyValueAsync('trace.args', sanitizeTraceArgsForPrivacy(pending.argsRaw), params.cfg, params.maskReq, candidate, params.masking, activePrivacy));
+            const argsMaterialized = await materializeTracePrivacyValueAsync('trace.args', sanitizeTraceArgsForPrivacy(pending.argsRaw), params.cfg, params.maskReq, candidate, params.masking, activePrivacy);
+            evt.args = limitMaterializedTraceInlineValue(argsMaterialized);
+            const argsValueCapture = await maybeCaptureTraceValueAsync({
+                target: 'trace.args',
+                rawValue: pending.argsRaw,
+                previewValue: evt.args,
+                capture: captureContext,
+                metadata: traceValueMetadata,
+            });
+            if (argsValueCapture?.entry) {
+                attachTraceValueEntry(evt, argsValueCapture.entry);
+            }
+            if (argsValueCapture?.captureRef) {
+                evt.argsValueCapture = argsValueCapture.captureRef;
+            }
         }
         if (!omitJsonBuiltinValues && pending.returnValueRaw !== undefined) {
-            evt.returnValue = sanitizeMaterializedTraceValue(await materializeTracePrivacyValueAsync('trace.returnValue', sanitizeTraceValueForPrivacy(pending.returnValueRaw), params.cfg, params.maskReq, candidate, params.masking, activePrivacy));
+            const returnValueMaterialized = await materializeTracePrivacyValueAsync('trace.returnValue', sanitizeTraceValueForPrivacy(pending.returnValueRaw), params.cfg, params.maskReq, candidate, params.masking, activePrivacy);
+            evt.returnValue = limitMaterializedTraceInlineValue(returnValueMaterialized);
+            const returnValueCapture = await maybeCaptureTraceValueAsync({
+                target: 'trace.returnValue',
+                rawValue: pending.returnValueRaw,
+                previewValue: evt.returnValue,
+                capture: captureContext,
+                metadata: traceValueMetadata,
+            });
+            if (returnValueCapture?.entry) {
+                attachTraceValueEntry(evt, returnValueCapture.entry);
+            }
+            if (returnValueCapture?.captureRef) {
+                evt.returnValueCapture = returnValueCapture.captureRef;
+            }
         }
         if (pending.errorRaw !== undefined) {
-            evt.error = sanitizeMaterializedTraceValue(await materializeTracePrivacyValueAsync('trace.error', sanitizeTraceValueForPrivacy(pending.errorRaw), params.cfg, params.maskReq, candidate, params.masking, activePrivacy));
+            const errorMaterialized = await materializeTracePrivacyValueAsync('trace.error', sanitizeTraceValueForPrivacy(pending.errorRaw), params.cfg, params.maskReq, candidate, params.masking, activePrivacy);
+            evt.error = limitMaterializedTraceInlineValue(errorMaterialized);
+            const errorValueCapture = await maybeCaptureTraceValueAsync({
+                target: 'trace.error',
+                rawValue: pending.errorRaw,
+                previewValue: evt.error,
+                capture: captureContext,
+                metadata: traceValueMetadata,
+            });
+            if (errorValueCapture?.entry) {
+                attachTraceValueEntry(evt, errorValueCapture.entry);
+            }
+            if (errorValueCapture?.captureRef) {
+                evt.errorValueCapture = errorValueCapture.captureRef;
+            }
         }
     }
     return events;
@@ -3689,6 +3825,12 @@ async function maybeCaptureRequestValueAsync(params, sink) {
     }
     return result.captureRef;
 }
+function maybeCaptureTraceValue(params) {
+    return createCapturedValueEntry(params);
+}
+async function maybeCaptureTraceValueAsync(params) {
+    return await createCapturedValueEntryAsync(params);
+}
 function maybeCaptureDbValue(params, sink) {
     const result = createCapturedValueEntry(params);
     if (!result)
@@ -3860,7 +4002,7 @@ function reproMiddleware(cfg) {
                 }
                 catch { }
                 if (flushPayload) {
-                    const scheduleFlushPayload = () => scheduleSdkBackgroundWork(flushPayload);
+                    const scheduleFlushPayload = () => scheduleSdkBackgroundWork(flushPayload, { priority: 'high' });
                     if (sessionDrainWait) {
                         sessionDrainWait.then(scheduleFlushPayload).catch(scheduleFlushPayload);
                     }
@@ -5176,7 +5318,7 @@ function cloneKafkaTelemetryValue(value) {
     }
 }
 async function materializeKafkaRequestBody(cfg, maskReq, body) {
-    return materializeInlinePrivacyValueAsync('request.body', sanitizeTraceValueForPrivacy(body), cfg, maskReq, null, normalizeMaskingConfig(cfg.masking), getRuntimePrivacyState(cfg).policy ?? null);
+    return materializeInlinePrivacyValueAsync('request.body', sanitizeInlinePrivacyValue(body), cfg, maskReq, null, normalizeMaskingConfig(cfg.masking), getRuntimePrivacyState(cfg).policy ?? null);
 }
 function summarizeKafkaError(error) {
     const message = typeof error?.message === 'string'
@@ -5267,14 +5409,71 @@ function recordKafkaTraceEvent(raw, sink, cfg, maskReq) {
     };
     const privacy = getRuntimePrivacyState(cfg).policy ?? null;
     const masking = normalizeMaskingConfig(cfg.masking);
+    const captureContext = {
+        runtimeConfig: cfg,
+        captureHeaders: cfg.captureHeaders,
+        maskReq,
+        trace: candidate,
+        masking,
+        privacy,
+    };
+    const traceValueMetadata = {
+        fn: evt.fn,
+        file: evt.file,
+        line: evt.line ?? null,
+        spanId: evt.spanId ?? null,
+        parentSpanId: evt.parentSpanId ?? null,
+    };
     if (!omitJsonBuiltinValues && raw.args !== undefined) {
-        evt.args = sanitizeMaterializedTraceValue(materializeTracePrivacyValue('trace.args', sanitizeTraceArgsForPrivacy(raw.args), cfg, maskReq, candidate, masking, privacy));
+        const argsMaterialized = materializeTracePrivacyValue('trace.args', sanitizeTraceArgsForPrivacy(raw.args), cfg, maskReq, candidate, masking, privacy);
+        evt.args = limitMaterializedTraceInlineValue(argsMaterialized);
+        const argsValueCapture = maybeCaptureTraceValue({
+            target: 'trace.args',
+            rawValue: normalizeRawTraceArgs(raw.args),
+            previewValue: evt.args,
+            capture: captureContext,
+            metadata: traceValueMetadata,
+        });
+        if (argsValueCapture?.entry) {
+            attachTraceValueEntry(evt, argsValueCapture.entry);
+        }
+        if (argsValueCapture?.captureRef) {
+            evt.argsValueCapture = argsValueCapture.captureRef;
+        }
     }
     if (!omitJsonBuiltinValues && raw.returnValue !== undefined) {
-        evt.returnValue = sanitizeMaterializedTraceValue(materializeTracePrivacyValue('trace.returnValue', sanitizeTraceValueForPrivacy(raw.returnValue), cfg, maskReq, candidate, masking, privacy));
+        const returnValueMaterialized = materializeTracePrivacyValue('trace.returnValue', sanitizeTraceValueForPrivacy(raw.returnValue), cfg, maskReq, candidate, masking, privacy);
+        evt.returnValue = limitMaterializedTraceInlineValue(returnValueMaterialized);
+        const returnValueCapture = maybeCaptureTraceValue({
+            target: 'trace.returnValue',
+            rawValue: raw.returnValue,
+            previewValue: evt.returnValue,
+            capture: captureContext,
+            metadata: traceValueMetadata,
+        });
+        if (returnValueCapture?.entry) {
+            attachTraceValueEntry(evt, returnValueCapture.entry);
+        }
+        if (returnValueCapture?.captureRef) {
+            evt.returnValueCapture = returnValueCapture.captureRef;
+        }
     }
     if (hasMeaningfulRawTraceError(raw.error)) {
-        evt.error = sanitizeMaterializedTraceValue(materializeTracePrivacyValue('trace.error', sanitizeTraceValueForPrivacy(raw.error), cfg, maskReq, candidate, masking, privacy));
+        const errorMaterialized = materializeTracePrivacyValue('trace.error', sanitizeTraceValueForPrivacy(raw.error), cfg, maskReq, candidate, masking, privacy);
+        evt.error = limitMaterializedTraceInlineValue(errorMaterialized);
+        const errorValueCapture = maybeCaptureTraceValue({
+            target: 'trace.error',
+            rawValue: raw.error,
+            previewValue: evt.error,
+            capture: captureContext,
+            metadata: traceValueMetadata,
+        });
+        if (errorValueCapture?.entry) {
+            attachTraceValueEntry(evt, errorValueCapture.entry);
+        }
+        if (errorValueCapture?.captureRef) {
+            evt.errorValueCapture = errorValueCapture.captureRef;
+        }
     }
     if (raw.threw !== undefined)
         evt.threw = raw.threw === true;
@@ -5367,6 +5566,7 @@ function buildKafkaTraceEntries(actionId, requestRid, events) {
     return batches.map((batch, index) => ({
         actionId: actionId ?? null,
         trace: batch,
+        traceValues: collectBatchTraceValueEntries(batch, index),
         traceBatch: {
             rid: requestRid,
             index,
@@ -5404,7 +5604,7 @@ function scheduleKafkaTraceFlush(cfg, kafkaCtx, actionId, requestRid, rawTraceEv
                 post(cfg, sid, { entries });
             }
         });
-    });
+    }, { priority: 'high' });
 }
 function patchKafkaProducerInstance(producer, cfg) {
     if (!producer || producer.__repro_kafka_producer_patched)
@@ -6667,6 +6867,31 @@ exports.initRepro = initRepro;
 /** @internal Test hooks for runtime privacy policy wiring. */
 exports.__reproTestHooks = {
     shareRuntimePrivacyStateForTest: shareRuntimePrivacyState,
+    setFullValueCaptureEnabledForTest(enabled) {
+        __FULL_VALUE_CAPTURE_ENABLED = enabled === true;
+    },
+    scheduleSdkBackgroundWorkForTest(work, options) {
+        scheduleSdkBackgroundWork(work, options);
+    },
+    async drainSdkBackgroundQueueForTest() {
+        await drainSdkBackgroundQueue();
+    },
+    resetSdkBackgroundQueuesForTest() {
+        sdkBackgroundHighQueue.length = 0;
+        sdkBackgroundQueue.length = 0;
+        if (sdkBackgroundTimer) {
+            try {
+                clearTimeout(sdkBackgroundTimer);
+            }
+            catch { }
+            sdkBackgroundTimer = null;
+        }
+        sdkBackgroundDraining = false;
+        activeClientRequestCount = 0;
+        oldestActiveClientRequestAt = null;
+        lastClientActivityAt = 0;
+        sdkBackgroundQuietUntil = 0;
+    },
     getRuntimePrivacyPolicyForTest(cfg) {
         return getRuntimePrivacyState(cfg).policy;
     },
@@ -6679,4 +6904,7 @@ exports.__reproTestHooks = {
     wrapKafkaEachMessageHandlerForTest: wrapKafkaEachMessageHandler,
     chunkTraceEventsForTransportForTest: chunkTraceEventsForTransport,
     estimateTraceBatchSerializedBytesForTest: estimateTraceBatchSerializedBytes,
+    sanitizeTraceValueForPrivacyForTest: sanitizeTraceValueForPrivacy,
+    sanitizeMaterializedTraceValueForTest: sanitizeMaterializedTraceValue,
+    getEventTraceValueEntriesForTest: getEventTraceValueEntries,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reproapp/node-sdk",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "description": "Repro Nest SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,7 +12,7 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
     "prepublishOnly": "npm run build",
-    "test": "npm run build && node test/unawaited.test.js && node test/integration-unawaited.js && node test/request-flush-timing.test.js && node test/express-trace-http-args.test.js && node test/trace-batch-size.test.js && node -r ./tracer/register test/promise-map.test.js && node test/disable-subtree.test.js && node test/circular-capture.test.js && node test/wrap-plugin-arrow-args.test.js && node test/privacy-runtime-policy.test.js && node test/runtime-privacy-materialization.test.js && node test/kafka-runtime-privacy-policy.test.js"
+    "test": "npm run build && node test/unawaited.test.js && node test/integration-unawaited.js && node test/request-flush-timing.test.js && node test/express-trace-http-args.test.js && node test/trace-batch-size.test.js && node test/sdk-background-priority.test.js && node -r ./tracer/register test/promise-map.test.js && node test/disable-subtree.test.js && node test/circular-capture.test.js && node test/wrap-plugin-arrow-args.test.js && node test/privacy-runtime-policy.test.js && node test/runtime-privacy-materialization.test.js && node test/kafka-runtime-privacy-policy.test.js"
   },
   "peerDependencies": {
     "express": "^5.1.0",

package/src/index.ts

@@ -351,9 +351,12 @@ type TraceEventRecord = {
     spanId?: string | number | null;
     parentSpanId?: string | number | null;
     args?: any;
+    argsValueCapture?: TraceValueCaptureRef;
     returnValue?: any;
+    returnValueCapture?: TraceValueCaptureRef;
     threw?: boolean;
     error?: any;
+    errorValueCapture?: TraceValueCaptureRef;
     unawaited?: boolean;
 };
 
@@ -387,7 +390,10 @@ type TraceValueBatchEntry = {
         | 'request.body'
         | 'request.params'
         | 'request.query'
-        | 'response.body';
+        | 'response.body'
+        | 'trace.args'
+        | 'trace.returnValue'
+        | 'trace.error';
     value: any;
     truncatedForStorage?: boolean;
     projectedKind?: string;
@@ -1231,6 +1237,7 @@ let activeClientRequestCount = 0;
 let oldestActiveClientRequestAt: number | null = null;
 let lastClientActivityAt = 0;
 let sdkBackgroundQuietUntil = 0;
+const sdkBackgroundHighQueue: Array<() => Promise<void> | void> = [];
 const sdkBackgroundQueue: Array<() => Promise<void> | void> = [];
 let sdkBackgroundTimer: NodeJS.Timeout | null = null;
 let sdkBackgroundDraining = false;
@@ -1499,8 +1506,15 @@ function endClientRequest(): void {
     }
 }
 
-function scheduleSdkBackgroundWork(work: () => Promise<void> | void): void {
-    sdkBackgroundQueue.push(work);
+function scheduleSdkBackgroundWork(
+    work: () => Promise<void> | void,
+    options: { priority?: 'high' | 'normal' } = {},
+): void {
+    if (options.priority === 'high') {
+        sdkBackgroundHighQueue.push(work);
+    } else {
+        sdkBackgroundQueue.push(work);
+    }
     scheduleSdkBackgroundDrain();
 }
 
@@ -1549,12 +1563,12 @@ async function drainSdkBackgroundQueue(): Promise<void> {
 
     sdkBackgroundDraining = true;
     try {
-        while (sdkBackgroundQueue.length > 0) {
+        while (sdkBackgroundHighQueue.length > 0 || sdkBackgroundQueue.length > 0) {
             if (shouldDeferSdkBackgroundWork()) {
                 scheduleSdkBackgroundDrain();
                 return;
             }
-            const work = sdkBackgroundQueue.shift();
+            const work = sdkBackgroundHighQueue.shift() ?? sdkBackgroundQueue.shift();
             if (!work) continue;
             try {
                 await drainQueuedIngestBeforeBackgroundWork();
@@ -1565,7 +1579,7 @@ async function drainSdkBackgroundQueue(): Promise<void> {
         }
     } finally {
         sdkBackgroundDraining = false;
-        if (sdkBackgroundQueue.length > 0) {
+        if (sdkBackgroundHighQueue.length > 0 || sdkBackgroundQueue.length > 0) {
             scheduleSdkBackgroundDrain();
         } else {
             kickIngestQueueDrain();
@@ -2429,14 +2443,26 @@ function sanitizeTraceValue(
     seen.set(value, valuePath);
 
     if (!options.disableTruncation && depth >= TRACE_VALUE_MAX_DEPTH) {
-        const shallow = safeJson(value);
-        if (shallow !== undefined) {
-            return shallow;
+        if (Array.isArray(value)) {
+            return {
+                __type: 'Array',
+                length: value.length,
+                __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}`,
+            };
         }
         const ctor = value?.constructor?.name;
-        return ctor && ctor !== 'Object'
-            ? { __class: ctor, __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}` }
-            : { __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}` };
+        const keys = Object.keys(value);
+        const summary: Record<string, any> = {
+            __truncated: `depth>${TRACE_VALUE_MAX_DEPTH}`,
+            __keys: keys.slice(0, TRACE_VALUE_MAX_KEYS),
+        };
+        if (keys.length > TRACE_VALUE_MAX_KEYS) {
+            summary.__truncatedKeys = keys.length - TRACE_VALUE_MAX_KEYS;
+        }
+        if (ctor && ctor !== 'Object') {
+            summary.__class = ctor;
+        }
+        return summary;
     }
 
     if (Array.isArray(value)) {
@@ -2505,10 +2531,61 @@ function sanitizeTraceValueForPrivacy(value: any): any {
     return sanitizeTraceValue(value, 0, new WeakMap(), { preserveLongStrings: true, disableTruncation: true });
 }
 
+function sanitizeInlinePrivacyValue(value: any): any {
+    return sanitizeTraceValue(value, 0, new WeakMap(), { preserveLongStrings: true, disableTruncation: true });
+}
+
 function sanitizeMaterializedTraceValue(value: any): any {
     return sanitizeTraceValue(value, 0, new WeakMap(), { preserveLongStrings: true, disableTruncation: true });
 }
 
+function compactMaterializedTracePreview(value: any, depth = 0): any {
+    if (value === undefined || value === null) return value;
+    if (depth >= TRACE_VALUE_MAX_DEPTH) {
+        return makeOmittedValue(`depth>${TRACE_VALUE_MAX_DEPTH}`);
+    }
+
+    const type = typeof value;
+    if (type === 'string') {
+        if (value.length <= TRACE_VALUE_MAX_STRING) return value;
+        return value.slice(0, TRACE_VALUE_MAX_STRING);
+    }
+    if (type === 'number' || type === 'boolean') return value;
+    if (type === 'bigint') return value.toString();
+    if (type === 'symbol') return value.toString();
+    if (type === 'function') return `[Function${value.name ? ` ${value.name}` : ''}]`;
+    if (type !== 'object') return String(value);
+
+    if (Array.isArray(value)) {
+        return value
+            .slice(0, TRACE_VALUE_MAX_ITEMS)
+            .map((item) => compactMaterializedTracePreview(item, depth + 1));
+    }
+
+    const out: Record<string, any> = {};
+    const keys = Object.keys(value).slice(0, TRACE_VALUE_MAX_KEYS);
+    for (const key of keys) {
+        try {
+            out[key] = compactMaterializedTracePreview((value as Record<string, any>)[key], depth + 1);
+        } catch (err) {
+            out[key] = `[Cannot serialize: ${(err as Error)?.message || 'unknown error'}]`;
+        }
+    }
+    return out;
+}
+
+function limitMaterializedTraceInlineValue(value: any): any {
+    const inlineValue = sanitizeMaterializedTraceValue(value);
+    if (!traceInlineValueExceedsLimit(inlineValue)) {
+        return inlineValue;
+    }
+    const compactPreview = compactMaterializedTracePreview(inlineValue);
+    if (!traceInlineValueExceedsLimit(compactPreview)) {
+        return compactPreview;
+    }
+    return makeOmittedValue('inline-size-limit');
+}
+
 function sanitizeTraceArgsForPrivacy(values: any): any {
     if (!Array.isArray(values)) return [sanitizeTraceValueForPrivacy(values)];
     return values.map(v => sanitizeTraceValueForPrivacy(v));
@@ -2523,6 +2600,18 @@ function hasMeaningfulRawTraceError(error: any): boolean {
     return error !== undefined && error !== null;
 }
 
+function attachTraceValueEntry(
+    event: TraceEventRecord | PendingTraceEventRecord,
+    entry: TraceValueBatchEntry,
+): void {
+    const current = (event as any)[TRACE_FULL_VALUE_ENTRY_SYMBOL] as TraceValueBatchEntry[] | undefined;
+    if (Array.isArray(current)) {
+        current.push(entry);
+        return;
+    }
+    (event as any)[TRACE_FULL_VALUE_ENTRY_SYMBOL] = [entry];
+}
+
 async function materializePendingTraceEvents(
     events: PendingTraceEventRecord[],
     params: {
@@ -2540,9 +2629,24 @@ async function materializePendingTraceEvents(
         const candidate = pending.candidate ?? traceEventCandidateFromRecord(evt);
         const omitJsonBuiltinValues = shouldOmitJsonBuiltinTraceValues(candidate);
         const activePrivacy = params.resolvePrivacy();
+        const captureContext: FullValueCaptureContext = {
+            runtimeConfig: params.cfg,
+            captureHeaders: params.cfg.captureHeaders,
+            maskReq: params.maskReq,
+            trace: candidate,
+            masking: params.masking,
+            privacy: activePrivacy,
+        };
+        const traceValueMetadata = {
+            fn: evt.fn,
+            file: evt.file,
+            line: evt.line ?? null,
+            spanId: evt.spanId ?? null,
+            parentSpanId: evt.parentSpanId ?? null,
+        };
 
         if (!omitJsonBuiltinValues && pending.argsRaw !== undefined) {
-            evt.args = sanitizeMaterializedTraceValue(await materializeTracePrivacyValueAsync(
+            const argsMaterialized = await materializeTracePrivacyValueAsync(
                 'trace.args',
                 sanitizeTraceArgsForPrivacy(pending.argsRaw),
                 params.cfg,
@@ -2550,10 +2654,24 @@ async function materializePendingTraceEvents(
                 candidate,
                 params.masking,
                 activePrivacy,
-            ));
+            );
+            evt.args = limitMaterializedTraceInlineValue(argsMaterialized);
+            const argsValueCapture = await maybeCaptureTraceValueAsync({
+                target: 'trace.args',
+                rawValue: pending.argsRaw,
+                previewValue: evt.args,
+                capture: captureContext,
+                metadata: traceValueMetadata,
+            });
+            if (argsValueCapture?.entry) {
+                attachTraceValueEntry(evt, argsValueCapture.entry);
+            }
+            if (argsValueCapture?.captureRef) {
+                evt.argsValueCapture = argsValueCapture.captureRef;
+            }
         }
         if (!omitJsonBuiltinValues && pending.returnValueRaw !== undefined) {
-            evt.returnValue = sanitizeMaterializedTraceValue(await materializeTracePrivacyValueAsync(
+            const returnValueMaterialized = await materializeTracePrivacyValueAsync(
                 'trace.returnValue',
                 sanitizeTraceValueForPrivacy(pending.returnValueRaw),
                 params.cfg,
@@ -2561,10 +2679,24 @@ async function materializePendingTraceEvents(
                 candidate,
                 params.masking,
                 activePrivacy,
-            ));
+            );
+            evt.returnValue = limitMaterializedTraceInlineValue(returnValueMaterialized);
+            const returnValueCapture = await maybeCaptureTraceValueAsync({
+                target: 'trace.returnValue',
+                rawValue: pending.returnValueRaw,
+                previewValue: evt.returnValue,
+                capture: captureContext,
+                metadata: traceValueMetadata,
+            });
+            if (returnValueCapture?.entry) {
+                attachTraceValueEntry(evt, returnValueCapture.entry);
+            }
+            if (returnValueCapture?.captureRef) {
+                evt.returnValueCapture = returnValueCapture.captureRef;
+            }
         }
         if (pending.errorRaw !== undefined) {
-            evt.error = sanitizeMaterializedTraceValue(await materializeTracePrivacyValueAsync(
+            const errorMaterialized = await materializeTracePrivacyValueAsync(
                 'trace.error',
                 sanitizeTraceValueForPrivacy(pending.errorRaw),
                 params.cfg,
@@ -2572,7 +2704,21 @@ async function materializePendingTraceEvents(
                 candidate,
                 params.masking,
                 activePrivacy,
-            ));
+            );
+            evt.error = limitMaterializedTraceInlineValue(errorMaterialized);
+            const errorValueCapture = await maybeCaptureTraceValueAsync({
+                target: 'trace.error',
+                rawValue: pending.errorRaw,
+                previewValue: evt.error,
+                capture: captureContext,
+                metadata: traceValueMetadata,
+            });
+            if (errorValueCapture?.entry) {
+                attachTraceValueEntry(evt, errorValueCapture.entry);
+            }
+            if (errorValueCapture?.captureRef) {
+                evt.errorValueCapture = errorValueCapture.captureRef;
+            }
         }
     }
     return events;
@@ -4301,7 +4447,10 @@ function createCapturedValueEntry(
             | 'request.body'
             | 'request.params'
             | 'request.query'
-            | 'response.body';
+            | 'response.body'
+            | 'trace.args'
+            | 'trace.returnValue'
+            | 'trace.error';
         rawValue: any;
         previewValue: any;
         capture: FullValueCaptureContext;
@@ -4380,7 +4529,10 @@ async function createCapturedValueEntryAsync(
             | 'request.body'
             | 'request.params'
             | 'request.query'
-            | 'response.body';
+            | 'response.body'
+            | 'trace.args'
+            | 'trace.returnValue'
+            | 'trace.error';
         rawValue: any;
         previewValue: any;
         capture: FullValueCaptureContext;
@@ -4480,6 +4632,30 @@ async function maybeCaptureRequestValueAsync(
     return result.captureRef;
 }
 
+function maybeCaptureTraceValue(
+    params: {
+        target: 'trace.args' | 'trace.returnValue' | 'trace.error';
+        rawValue: any;
+        previewValue: any;
+        capture: FullValueCaptureContext;
+        metadata?: Partial<TraceValueBatchEntry>;
+    },
+): { captureRef: TraceValueCaptureRef; entry?: TraceValueBatchEntry } | undefined {
+    return createCapturedValueEntry(params);
+}
+
+async function maybeCaptureTraceValueAsync(
+    params: {
+        target: 'trace.args' | 'trace.returnValue' | 'trace.error';
+        rawValue: any;
+        previewValue: any;
+        capture: FullValueCaptureContext;
+        metadata?: Partial<TraceValueBatchEntry>;
+    },
+): Promise<{ captureRef: TraceValueCaptureRef; entry?: TraceValueBatchEntry } | undefined> {
+    return await createCapturedValueEntryAsync(params);
+}
+
 function maybeCaptureDbValue(
     params: {
         target: 'db.pk' | 'db.before' | 'db.after' | 'db.query' | 'db.resultMeta' | 'db.error';
@@ -4674,11 +4850,11 @@ export function reproMiddleware(cfg: ReproMiddlewareConfig) {
 	                        return;
 	                    }
 	                }
-	                flushed = true;
-	                clearTimers();
+                flushed = true;
+                clearTimers();
                 try { unsubscribe && unsubscribe(); } catch {}
                 if (flushPayload) {
-                    const scheduleFlushPayload = () => scheduleSdkBackgroundWork(flushPayload!);
+                    const scheduleFlushPayload = () => scheduleSdkBackgroundWork(flushPayload!, { priority: 'high' });
                     if (sessionDrainWait) {
                         sessionDrainWait.then(scheduleFlushPayload).catch(scheduleFlushPayload);
                     } else {
@@ -6083,7 +6259,7 @@ async function materializeKafkaRequestBody(
 ): Promise<InlinePrivacyMaterializationResult> {
     return materializeInlinePrivacyValueAsync(
         'request.body',
-        sanitizeTraceValueForPrivacy(body),
+        sanitizeInlinePrivacyValue(body),
         cfg,
         maskReq,
         null,
@@ -6198,8 +6374,23 @@ function recordKafkaTraceEvent(
 
     const privacy = getRuntimePrivacyState(cfg).policy ?? null;
     const masking = normalizeMaskingConfig(cfg.masking);
+    const captureContext: FullValueCaptureContext = {
+        runtimeConfig: cfg,
+        captureHeaders: cfg.captureHeaders,
+        maskReq,
+        trace: candidate,
+        masking,
+        privacy,
+    };
+    const traceValueMetadata = {
+        fn: evt.fn,
+        file: evt.file,
+        line: evt.line ?? null,
+        spanId: evt.spanId ?? null,
+        parentSpanId: evt.parentSpanId ?? null,
+    };
     if (!omitJsonBuiltinValues && raw.args !== undefined) {
-        evt.args = sanitizeMaterializedTraceValue(materializeTracePrivacyValue(
+        const argsMaterialized = materializeTracePrivacyValue(
             'trace.args',
             sanitizeTraceArgsForPrivacy(raw.args),
             cfg,
@@ -6207,10 +6398,24 @@ function recordKafkaTraceEvent(
             candidate,
             masking,
             privacy,
-        ));
+        );
+        evt.args = limitMaterializedTraceInlineValue(argsMaterialized);
+        const argsValueCapture = maybeCaptureTraceValue({
+            target: 'trace.args',
+            rawValue: normalizeRawTraceArgs(raw.args),
+            previewValue: evt.args,
+            capture: captureContext,
+            metadata: traceValueMetadata,
+        });
+        if (argsValueCapture?.entry) {
+            attachTraceValueEntry(evt, argsValueCapture.entry);
+        }
+        if (argsValueCapture?.captureRef) {
+            evt.argsValueCapture = argsValueCapture.captureRef;
+        }
     }
     if (!omitJsonBuiltinValues && raw.returnValue !== undefined) {
-        evt.returnValue = sanitizeMaterializedTraceValue(materializeTracePrivacyValue(
+        const returnValueMaterialized = materializeTracePrivacyValue(
             'trace.returnValue',
             sanitizeTraceValueForPrivacy(raw.returnValue),
             cfg,
@@ -6218,10 +6423,24 @@ function recordKafkaTraceEvent(
             candidate,
             masking,
             privacy,
-        ));
+        );
+        evt.returnValue = limitMaterializedTraceInlineValue(returnValueMaterialized);
+        const returnValueCapture = maybeCaptureTraceValue({
+            target: 'trace.returnValue',
+            rawValue: raw.returnValue,
+            previewValue: evt.returnValue,
+            capture: captureContext,
+            metadata: traceValueMetadata,
+        });
+        if (returnValueCapture?.entry) {
+            attachTraceValueEntry(evt, returnValueCapture.entry);
+        }
+        if (returnValueCapture?.captureRef) {
+            evt.returnValueCapture = returnValueCapture.captureRef;
+        }
     }
     if (hasMeaningfulRawTraceError(raw.error)) {
-        evt.error = sanitizeMaterializedTraceValue(materializeTracePrivacyValue(
+        const errorMaterialized = materializeTracePrivacyValue(
             'trace.error',
             sanitizeTraceValueForPrivacy(raw.error),
             cfg,
@@ -6229,7 +6448,21 @@ function recordKafkaTraceEvent(
             candidate,
             masking,
             privacy,
-        ));
+        );
+        evt.error = limitMaterializedTraceInlineValue(errorMaterialized);
+        const errorValueCapture = maybeCaptureTraceValue({
+            target: 'trace.error',
+            rawValue: raw.error,
+            previewValue: evt.error,
+            capture: captureContext,
+            metadata: traceValueMetadata,
+        });
+        if (errorValueCapture?.entry) {
+            attachTraceValueEntry(evt, errorValueCapture.entry);
+        }
+        if (errorValueCapture?.captureRef) {
+            evt.errorValueCapture = errorValueCapture.captureRef;
+        }
     }
     if (raw.threw !== undefined) evt.threw = raw.threw === true;
     if (raw.unawaited !== undefined) evt.unawaited = raw.unawaited === true;
@@ -6338,6 +6571,7 @@ function buildKafkaTraceEntries(
     return batches.map((batch, index) => ({
         actionId: actionId ?? null,
         trace: batch,
+        traceValues: collectBatchTraceValueEntries(batch, index),
         traceBatch: {
             rid: requestRid,
             index,
@@ -6381,7 +6615,7 @@ function scheduleKafkaTraceFlush(
                 post(cfg, sid, { entries });
             }
         });
-    });
+    }, { priority: 'high' });
 }
 
 function patchKafkaProducerInstance(producer: any, cfg: KafkaJsPatchConfig) {
@@ -7686,6 +7920,31 @@ export async function initRepro(cfg: ReproInitConfig): Promise<void> {
 /** @internal Test hooks for runtime privacy policy wiring. */
 export const __reproTestHooks = {
     shareRuntimePrivacyStateForTest: shareRuntimePrivacyState,
+    setFullValueCaptureEnabledForTest(enabled: boolean): void {
+        __FULL_VALUE_CAPTURE_ENABLED = enabled === true;
+    },
+    scheduleSdkBackgroundWorkForTest(
+        work: () => Promise<void> | void,
+        options?: { priority?: 'high' | 'normal' },
+    ): void {
+        scheduleSdkBackgroundWork(work, options);
+    },
+    async drainSdkBackgroundQueueForTest(): Promise<void> {
+        await drainSdkBackgroundQueue();
+    },
+    resetSdkBackgroundQueuesForTest(): void {
+        sdkBackgroundHighQueue.length = 0;
+        sdkBackgroundQueue.length = 0;
+        if (sdkBackgroundTimer) {
+            try { clearTimeout(sdkBackgroundTimer); } catch {}
+            sdkBackgroundTimer = null;
+        }
+        sdkBackgroundDraining = false;
+        activeClientRequestCount = 0;
+        oldestActiveClientRequestAt = null;
+        lastClientActivityAt = 0;
+        sdkBackgroundQuietUntil = 0;
+    },
     getRuntimePrivacyPolicyForTest(cfg: ReproMiddlewareConfig): NormalizedRuntimePrivacyPolicy | null {
         return getRuntimePrivacyState(cfg).policy;
     },
@@ -7701,4 +7960,7 @@ export const __reproTestHooks = {
     wrapKafkaEachMessageHandlerForTest: wrapKafkaEachMessageHandler,
     chunkTraceEventsForTransportForTest: chunkTraceEventsForTransport,
     estimateTraceBatchSerializedBytesForTest: estimateTraceBatchSerializedBytes,
+    sanitizeTraceValueForPrivacyForTest: sanitizeTraceValueForPrivacy,
+    sanitizeMaterializedTraceValueForTest: sanitizeMaterializedTraceValue,
+    getEventTraceValueEntriesForTest: getEventTraceValueEntries,
 };

package/test/kafka-runtime-privacy-policy.test.js

@@ -419,7 +419,19 @@ async function testKafkaProducerCapturesFullPublishedMessageValue() {
 }
 
 function assertNoLargeJsonPreviewArtifacts(value) {
-    const text = JSON.stringify(value);
+    const text = JSON.stringify(value, (key, currentValue) => {
+        if (
+            key === 'argsValueCapture' ||
+            key === 'returnValueCapture' ||
+            key === 'errorValueCapture' ||
+            key === 'argsMaterialization' ||
+            key === 'returnValueMaterialization' ||
+            key === 'errorMaterialization'
+        ) {
+            return undefined;
+        }
+        return currentValue;
+    });
     assert(!text.includes('__type":"json-string'), text);
     assert(!text.includes('__truncatedKeys'), text);
     assert(!text.includes('__truncatedItems'), text);
@@ -540,7 +552,7 @@ async function testJsonBuiltinTracePayloadsAreOmitted() {
     assertNoLargeJsonPreviewArtifacts(consumedSink[0]);
 }
 
-async function testLargeStringTraceValuesAreCapturedInlineWithoutTruncation() {
+async function testLargeStringTraceValuesStayIngestibleAndCaptureFullValueOutOfBand() {
     const hugeMarker = 'HUGE_INLINE_VALUE_MARKER';
     const hugeJson = JSON.stringify({
         eventId: 'evt-huge',
@@ -567,6 +579,7 @@ async function testLargeStringTraceValuesAreCapturedInlineWithoutTruncation() {
     };
 
     const sink = [];
+    __reproTestHooks.setFullValueCaptureEnabledForTest(true);
     await __reproTestHooks.recordKafkaTraceEventAsyncForTest(
         {
             type: 'enter',
@@ -579,18 +592,24 @@ async function testLargeStringTraceValuesAreCapturedInlineWithoutTruncation() {
         cfg,
         maskReq,
     );
+    __reproTestHooks.setFullValueCaptureEnabledForTest(false);
 
     assert.strictEqual(sink.length, 1);
     assert.strictEqual(sink[0].fn, 'parseGatewayPayload');
     assert.strictEqual(typeof sink[0].args[0], 'string');
     assert(sink[0].args[0].includes(hugeMarker), JSON.stringify(sink[0]));
-    assert(sink[0].args[0].includes('x'.repeat(140 * 1024)), JSON.stringify(sink[0]));
-    assert.strictEqual(sink[0].argsMaterialization, undefined, JSON.stringify(sink[0]));
-    assert.strictEqual(sink[0].argsValueCapture, undefined, JSON.stringify(sink[0]));
-    assertNoLargeJsonPreviewArtifacts(sink[0]);
+    assert(sink[0].args[0].length < 4096, JSON.stringify(sink[0]));
+    assert.strictEqual(sink[0].argsValueCapture?.status, 'stored', JSON.stringify(sink[0]));
+    const entries = __reproTestHooks.getEventTraceValueEntriesForTest(sink[0]);
+    assert(Array.isArray(entries) && entries.length === 1, JSON.stringify(entries));
+    assert.strictEqual(entries[0].target, 'trace.args');
+    assert.strictEqual(typeof entries[0].value?.[0], 'string');
+    assert(entries[0].value[0].includes(hugeMarker), JSON.stringify(entries[0]));
+    assert(entries[0].value[0].includes('x'.repeat(140 * 1024)), JSON.stringify(entries[0]));
+    assertNoLargeJsonPreviewArtifacts(sink[0].args);
 }
 
-async function testLargeStructuredTraceValuesAreCapturedInlineWithoutTruncation() {
+async function testLargeStructuredTraceValuesStayIngestibleAndCaptureFullValueOutOfBand() {
     const hugeMarker = 'HUGE_STRUCTURED_TRACE_VALUE_MARKER';
     const hugeEnvelope = {
         eventId: 'evt-huge-structured',
@@ -622,6 +641,7 @@ async function testLargeStructuredTraceValuesAreCapturedInlineWithoutTruncation(
     };
 
     const sink = [];
+    __reproTestHooks.setFullValueCaptureEnabledForTest(true);
     await __reproTestHooks.recordKafkaTraceEventAsyncForTest(
         {
             type: 'enter',
@@ -634,22 +654,33 @@ async function testLargeStructuredTraceValuesAreCapturedInlineWithoutTruncation(
         cfg,
         maskReq,
     );
+    __reproTestHooks.setFullValueCaptureEnabledForTest(false);
 
     assert.strictEqual(sink.length, 1);
     assert.strictEqual(sink[0].fn, 'recordConsumedEvent');
-    assert(sink[0].args, 'expected args to be stored inline');
-    assert.strictEqual(sink[0].args[0].providerResponse.rawNarrative, `${hugeMarker}:${'x'.repeat(40 * 1024)}`);
+    assert(sink[0].args, 'expected args preview to be stored inline');
+    assert(JSON.stringify(sink[0].args).length < 9000, JSON.stringify(sink[0]).slice(0, 12000));
+    assert.strictEqual(
+        sink[0].args[0]?.providerResponse?.rawNarrative?.__kind,
+        'omitted',
+        JSON.stringify(sink[0]),
+    );
     assert.strictEqual(typeof sink[0].args[2], 'string');
-    const parsedRawArg = JSON.parse(sink[0].args[2]);
+    assert(sink[0].args[2].includes('providerResponse'), JSON.stringify(sink[0]));
+    assert.strictEqual(sink[0].argsValueCapture?.status, 'stored', JSON.stringify(sink[0]));
+    const entries = __reproTestHooks.getEventTraceValueEntriesForTest(sink[0]);
+    assert(Array.isArray(entries) && entries.length === 1, JSON.stringify(entries));
+    assert.strictEqual(entries[0].target, 'trace.args');
+    assert.strictEqual(entries[0].value?.[0]?.providerResponse?.rawNarrative, `${hugeMarker}:${'x'.repeat(40 * 1024)}`);
+    assert.strictEqual(typeof entries[0].value?.[2], 'string');
+    const parsedRawArg = JSON.parse(entries[0].value[2]);
     assert.strictEqual(parsedRawArg.providerResponse.rawNarrative, `${hugeMarker}:${'x'.repeat(40 * 1024)}`);
     assert.strictEqual(parsedRawArg.providerResponse.credentials.apiKey, '[dropped]');
     assert.strictEqual(parsedRawArg.providerResponse.credentials.webhookSecret, '[dropped]');
-    assert.strictEqual(sink[0].argsMaterialization, undefined, JSON.stringify(sink[0]));
-    assert.strictEqual(sink[0].argsValueCapture, undefined, JSON.stringify(sink[0]));
-    assertNoLargeJsonPreviewArtifacts(sink[0]);
+    assertNoLargeJsonPreviewArtifacts(sink[0].args);
 }
 
-async function testLargeTraceReturnValueIsCapturedInlineWithoutTruncation() {
+async function testLargeTraceReturnValueStaysIngestibleAndCapturesFullValueOutOfBand() {
     const hugeMarker = 'HUGE_STRUCTURED_TRACE_RETURN_MARKER';
     const hugeResponse = {
         id: 'drill-1',
@@ -677,6 +708,7 @@ async function testLargeTraceReturnValueIsCapturedInlineWithoutTruncation() {
     };
 
     const sink = [];
+    __reproTestHooks.setFullValueCaptureEnabledForTest(true);
     await __reproTestHooks.recordKafkaTraceEventAsyncForTest(
         {
             type: 'exit',
@@ -689,14 +721,21 @@ async function testLargeTraceReturnValueIsCapturedInlineWithoutTruncation() {
         cfg,
         maskReq,
     );
+    __reproTestHooks.setFullValueCaptureEnabledForTest(false);
 
     assert.strictEqual(sink.length, 1);
     assert.strictEqual(sink[0].fn, 'toDrillResponse');
-    assert(sink[0].returnValue, 'expected return value to be stored inline');
-    assert.strictEqual(sink[0].returnValue.structuredSnapshot.payload, `${hugeMarker}:${'x'.repeat(40 * 1024)}`);
-    assert.strictEqual(sink[0].returnValueMaterialization, undefined, JSON.stringify(sink[0]));
-    assert.strictEqual(sink[0].returnValueCapture, undefined, JSON.stringify(sink[0]));
-    assertNoLargeJsonPreviewArtifacts(sink[0]);
+    assert(sink[0].returnValue, 'expected return value preview to be stored inline');
+    assert(JSON.stringify(sink[0].returnValue).length < 9000, JSON.stringify(sink[0]).slice(0, 12000));
+    assert.strictEqual(typeof sink[0].returnValue?.structuredSnapshot?.payload, 'string');
+    assert(sink[0].returnValue.structuredSnapshot.payload.includes(hugeMarker), JSON.stringify(sink[0]));
+    assert(sink[0].returnValue.structuredSnapshot.payload.length < 4096, JSON.stringify(sink[0]));
+    assert.strictEqual(sink[0].returnValueCapture?.status, 'stored', JSON.stringify(sink[0]));
+    const entries = __reproTestHooks.getEventTraceValueEntriesForTest(sink[0]);
+    assert(Array.isArray(entries) && entries.length === 1, JSON.stringify(entries));
+    assert.strictEqual(entries[0].target, 'trace.returnValue');
+    assert.strictEqual(entries[0].value?.structuredSnapshot?.payload, `${hugeMarker}:${'x'.repeat(40 * 1024)}`);
+    assertNoLargeJsonPreviewArtifacts(sink[0].returnValue);
 }
 
 async function main() {
@@ -706,9 +745,9 @@ async function main() {
     await testKafkaTraceFlushIsNotBlockedForeverByActiveHttpRequest();
     await testLargeHttpResponseBodyIsCapturedWithoutDroppingRequest();
     await testJsonBuiltinTracePayloadsAreOmitted();
-    await testLargeStringTraceValuesAreCapturedInlineWithoutTruncation();
-    await testLargeStructuredTraceValuesAreCapturedInlineWithoutTruncation();
-    await testLargeTraceReturnValueIsCapturedInlineWithoutTruncation();
+    await testLargeStringTraceValuesStayIngestibleAndCaptureFullValueOutOfBand();
+    await testLargeStructuredTraceValuesStayIngestibleAndCaptureFullValueOutOfBand();
+    await testLargeTraceReturnValueStaysIngestibleAndCapturesFullValueOutOfBand();
     console.log('kafka runtime privacy policy wiring OK');
 }
 

package/test/sdk-background-priority.test.js

@@ -0,0 +1,35 @@
+const assert = require('node:assert/strict');
+
+const sdk = require('../dist/index.js');
+
+async function main() {
+    const hooks = sdk.__reproTestHooks;
+    hooks.resetSdkBackgroundQueuesForTest();
+
+    const order = [];
+
+    hooks.scheduleSdkBackgroundWorkForTest(() => {
+        order.push('normal-1');
+    });
+    hooks.scheduleSdkBackgroundWorkForTest(() => {
+        order.push('normal-2');
+    });
+    hooks.scheduleSdkBackgroundWorkForTest(() => {
+        order.push('high-1');
+    }, { priority: 'high' });
+    hooks.scheduleSdkBackgroundWorkForTest(() => {
+        order.push('high-2');
+    }, { priority: 'high' });
+
+    await hooks.drainSdkBackgroundQueueForTest();
+
+    assert.deepStrictEqual(order, ['high-1', 'high-2', 'normal-1', 'normal-2']);
+
+    hooks.resetSdkBackgroundQueuesForTest();
+    console.log('sdk background priority OK');
+}
+
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});