@redthreadlabs/tracelog-client 1.6.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

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LogClient = void 0;
 const EventBuilder_1 = require("./EventBuilder");
 const util_1 = require("./util");
+// Level ordering for the optional getMinLevel gate. An event is dropped when
+// its level ranks below the host-supplied minimum.
+const LEVEL_RANK = { debug: 0, info: 1, warn: 2, error: 3 };
 // Defaults (all overridable via LogClientOptions)
 const DEFAULT_FLUSH_CADENCE_MS = 5000;
 const DEFAULT_MAX_BUFFER_SIZE = 100;
@@ -89,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)
@@ -125,6 +162,11 @@ class LogClient {
     _enqueueEvent(event) {
         if (this._disposed)
             return;
+        // Level gate: drop events below the host-supplied minimum before they ever
+        // buffer, persist, or ship. No callback ⇒ emit everything (back-compat).
+        const minLevel = this._opts.getMinLevel?.();
+        if (minLevel && LEVEL_RANK[event.level] < LEVEL_RANK[minLevel])
+            return;
         this._eventBuffer.push(event);
         this._schedulePersist();
         if (this._eventBuffer.length >= (this._opts.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE)) {

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { ClientInfo } from '@redthreadlabs/tracelog-schema';
+import type { ClientInfo, LogLevel } from '@redthreadlabs/tracelog-schema';
 export type { JsonValue, LogLevel, LogBatch, LogEventItem, LogPerfItem, ClientInfo, } from '@redthreadlabs/tracelog-schema';
 export interface PerfToken {
     /** 16-char hex ID for this perf */
@@ -23,6 +23,13 @@ export interface LogClientOptions {
     getSessionRef?: () => string | undefined;
     /** Returns native device identifier */
     getDeviceId?: () => string | undefined;
+    /**
+     * Returns the minimum level to emit. Events whose level ranks below this
+     * (debug < info < warn < error) are dropped before buffering — they never
+     * persist or ship. Called once per event, so keep it cheap and synchronous.
+     * Omit to emit every level (default). Perfs are unaffected.
+     */
+    getMinLevel?: () => LogLevel;
     /** Flush cadence in ms. Default: 5000 */
     flushCadenceMs?: number;
     /** Max events buffered before forced flush. Default: 100 */

package/package.json

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