@redthreadlabs/tracelog-client 1.7.0 → 1.8.0

package/dist/LogClient.d.ts

@@ -13,6 +13,13 @@ export declare class LogClient {
     event(type?: string): EventBuilder;
     startPerf(name: string, parent?: PerfToken): PerfToken;
     endPerf(token: PerfToken, context?: Record<string, JsonValue>): void;
+    /**
+     * Record a complete perf measurement in one call — for operations timed
+     * elsewhere (a pre-measured duration with no live start/end pair). Buffers a
+     * parent-less, root perf, which the server maps to a `transaction` record.
+     * Reach for startPerf/endPerf instead when you need a live span tree.
+     */
+    recordPerf(name: string, durationMs: number, context?: Record<string, JsonValue>, outcome?: 'success' | 'failure' | 'unknown'): void;
     flush(): Promise<void>;
     dispose(): void;
     private _enqueueEvent;

package/dist/LogClient.js

@@ -92,6 +92,40 @@ class LogClient {
             this.flush();
         }
     }
+    /**
+     * Record a complete perf measurement in one call — for operations timed
+     * elsewhere (a pre-measured duration with no live start/end pair). Buffers a
+     * parent-less, root perf, which the server maps to a `transaction` record.
+     * Reach for startPerf/endPerf instead when you need a live span tree.
+     */
+    recordPerf(name, durationMs, context, outcome = 'success') {
+        if (this._disposed)
+            return;
+        if (!isFinite(durationMs) || durationMs < 0)
+            durationMs = 0;
+        const id = randomHex(16);
+        const end = now();
+        const perf = {
+            id,
+            trace_id: randomHex(32),
+            root_id: id,
+            name,
+            type: 'client-perf',
+            // No live start time, so back-compute it from the measured duration.
+            timestamp: Math.round(end - durationMs),
+            duration: Math.round(durationMs),
+            outcome,
+            tz_offset: (0, util_1.tzOffsetMinutes)(),
+        };
+        if (context && Object.keys(context).length > 0) {
+            perf.context = { tags: context };
+        }
+        this._perfBuffer.push(perf);
+        this._schedulePersist();
+        if (this._perfBuffer.length + this._eventBuffer.length >= (this._opts.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE)) {
+            this.flush();
+        }
+    }
     // ---- Transport ----
     async flush() {
         if (this._disposed || this._flushing)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redthreadlabs/tracelog-client",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Lightweight logging client for tracelog — works in React Native and browsers",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",