@redthreadlabs/tracelog-client 1.6.0 → 1.7.0

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;
@@ -125,6 +128,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.7.0",
   "description": "Lightweight logging client for tracelog — works in React Native and browsers",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",