@smplkit/sdk 1.5.6 → 1.5.8

package/dist/index.d.cts

@@ -906,6 +906,8 @@ declare class FlagsClient {
     private _cache;
     private _contextProvider;
     private _contextBuffer;
+    private _flagBuffer;
+    private _flagFlushTimer;
     private _handles;
     private _globalListeners;
     private _keyListeners;
@@ -1032,6 +1034,7 @@ declare class FlagsClient {
     private _fetchFlagsList;
     private _fireChangeListeners;
     private _fireChangeListenersAll;
+    private _flushFlags;
     private _flushContexts;
     /** @internal */
     _resourceToModel(resource: FlagResource): Flag;
@@ -1267,6 +1270,8 @@ declare class LoggingClient {
     private _keyListeners;
     private _adapters;
     private _explicitAdapters;
+    private _loggerBuffer;
+    private _loggerFlushTimer;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
     /**
@@ -1325,6 +1330,8 @@ declare class LoggingClient {
     private _applyLevels;
     /** Called by adapter hooks when a new logger is created in the framework. */
     private _onAdapterNewLogger;
+    /** Flush buffered loggers to the bulk-register endpoint. */
+    private _flushLoggerBuffer;
     private _handleLoggerChanged;
     private _handleGroupChanged;
     private _loggerToModel;

package/dist/index.d.ts

@@ -906,6 +906,8 @@ declare class FlagsClient {
     private _cache;
     private _contextProvider;
     private _contextBuffer;
+    private _flagBuffer;
+    private _flagFlushTimer;
     private _handles;
     private _globalListeners;
     private _keyListeners;
@@ -1032,6 +1034,7 @@ declare class FlagsClient {
     private _fetchFlagsList;
     private _fireChangeListeners;
     private _fireChangeListenersAll;
+    private _flushFlags;
     private _flushContexts;
     /** @internal */
     _resourceToModel(resource: FlagResource): Flag;
@@ -1267,6 +1270,8 @@ declare class LoggingClient {
     private _keyListeners;
     private _adapters;
     private _explicitAdapters;
+    private _loggerBuffer;
+    private _loggerFlushTimer;
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
     /**
@@ -1325,6 +1330,8 @@ declare class LoggingClient {
     private _applyLevels;
     /** Called by adapter hooks when a new logger is created in the framework. */
     private _onAdapterNewLogger;
+    /** Flush buffered loggers to the bulk-register endpoint. */
+    private _flushLoggerBuffer;
     private _handleLoggerChanged;
     private _handleGroupChanged;
     private _loggerToModel;

package/dist/index.js

@@ -17538,6 +17538,8 @@ var APP_BASE_URL = "https://app.smplkit.com";
 var CACHE_MAX_SIZE = 1e4;
 var CONTEXT_REGISTRATION_LRU_SIZE = 1e4;
 var CONTEXT_BATCH_FLUSH_SIZE = 100;
+var FLAG_REGISTRATION_FLUSH_SIZE = 50;
+var FLAG_REGISTRATION_FLUSH_INTERVAL_MS = 3e4;
 async function checkError2(response, _context) {
   const body = await response.text().catch(() => "");
   throwForStatus(response.status, body);
@@ -17687,6 +17689,30 @@ var ContextRegistrationBuffer = class {
     return this._pending.length;
   }
 };
+var FlagRegistrationBuffer = class {
+  _seen = /* @__PURE__ */ new Set();
+  _pending = [];
+  add(id, type, defaultValue, service, environment) {
+    if (!this._seen.has(id)) {
+      this._seen.add(id);
+      this._pending.push({
+        id,
+        type,
+        default: defaultValue,
+        service: service ?? void 0,
+        environment: environment ?? void 0
+      });
+    }
+  }
+  drain() {
+    const batch = this._pending;
+    this._pending = [];
+    return batch;
+  }
+  get pendingCount() {
+    return this._pending.length;
+  }
+};
 var FlagsManagement = class {
   constructor(_client) {
     this._client = _client;
@@ -17736,6 +17762,8 @@ var FlagsClient = class {
   _cache = new ResolutionCache();
   _contextProvider = null;
   _contextBuffer = new ContextRegistrationBuffer();
+  _flagBuffer = new FlagRegistrationBuffer();
+  _flagFlushTimer = null;
   _handles = {};
   _globalListeners = [];
   _keyListeners = /* @__PURE__ */ new Map();
@@ -17963,6 +17991,16 @@ var FlagsClient = class {
       updatedAt: null
     });
     this._handles[id] = handle;
+    this._flagBuffer.add(
+      id,
+      "BOOLEAN",
+      defaultValue,
+      this._parent?._service ?? null,
+      this._parent?._environment ?? null
+    );
+    if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE) {
+      void this._flushFlags();
+    }
     return handle;
   }
   /** Declare a string flag handle for runtime evaluation. */
@@ -17979,6 +18017,16 @@ var FlagsClient = class {
       updatedAt: null
     });
     this._handles[id] = handle;
+    this._flagBuffer.add(
+      id,
+      "STRING",
+      defaultValue,
+      this._parent?._service ?? null,
+      this._parent?._environment ?? null
+    );
+    if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE) {
+      void this._flushFlags();
+    }
     return handle;
   }
   /** Declare a numeric flag handle for runtime evaluation. */
@@ -17995,6 +18043,16 @@ var FlagsClient = class {
       updatedAt: null
     });
     this._handles[id] = handle;
+    this._flagBuffer.add(
+      id,
+      "NUMERIC",
+      defaultValue,
+      this._parent?._service ?? null,
+      this._parent?._environment ?? null
+    );
+    if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE) {
+      void this._flushFlags();
+    }
     return handle;
   }
   /** Declare a JSON flag handle for runtime evaluation. */
@@ -18011,6 +18069,16 @@ var FlagsClient = class {
       updatedAt: null
     });
     this._handles[id] = handle;
+    this._flagBuffer.add(
+      id,
+      "JSON",
+      defaultValue,
+      this._parent?._service ?? null,
+      this._parent?._environment ?? null
+    );
+    if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE) {
+      void this._flushFlags();
+    }
     return handle;
   }
   // ------------------------------------------------------------------
@@ -18044,12 +18112,16 @@ var FlagsClient = class {
     if (this._initialized) return;
     debug("lifecycle", "FlagsClient.initialize() called");
     this._environment = this._parent?._environment ?? null;
+    await this._flushFlags();
     await this._fetchAllFlags();
     this._initialized = true;
     this._cache.clear();
     this._wsManager = this._ensureWs();
     this._wsManager.on("flag_changed", this._handleFlagChanged);
     this._wsManager.on("flag_deleted", this._handleFlagDeleted);
+    this._flagFlushTimer = setInterval(() => {
+      void this._flushFlags();
+    }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
   }
   /** Disconnect the flags runtime and release resources. */
   async disconnect() {
@@ -18058,6 +18130,10 @@ var FlagsClient = class {
       this._wsManager.off("flag_deleted", this._handleFlagDeleted);
       this._wsManager = null;
     }
+    if (this._flagFlushTimer !== null) {
+      clearInterval(this._flagFlushTimer);
+      this._flagFlushTimer = null;
+    }
     await this._flushContexts();
     this._flagStore = {};
     this._cache.clear();
@@ -18209,12 +18285,16 @@ var FlagsClient = class {
   /** @internal — called by SmplClient constructor / lazy init. */
   async _connectInternal(environment) {
     this._environment = environment;
+    await this._flushFlags();
     await this._fetchAllFlags();
     this._initialized = true;
     this._cache.clear();
     this._wsManager = this._ensureWs();
     this._wsManager.on("flag_changed", this._handleFlagChanged);
     this._wsManager.on("flag_deleted", this._handleFlagDeleted);
+    this._flagFlushTimer = setInterval(() => {
+      void this._flushFlags();
+    }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
   }
   // ------------------------------------------------------------------
   // Internal: event handlers (called by SharedWebSocket)
@@ -18290,6 +18370,23 @@ var FlagsClient = class {
     }
   }
   // ------------------------------------------------------------------
+  // Internal: flag registration flush
+  // ------------------------------------------------------------------
+  async _flushFlags() {
+    const batch = this._flagBuffer.drain();
+    if (batch.length === 0) return;
+    debug("registration", `flushing ${batch.length} flag(s) to bulk-register endpoint`);
+    try {
+      await this._http.POST("/api/v1/flags/bulk", {
+        body: { flags: batch }
+      });
+    } catch (err) {
+      console.warn(
+        `[smplkit] Failed to bulk-register flags: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  // ------------------------------------------------------------------
   // Internal: context flush
   // ------------------------------------------------------------------
   async _flushContexts() {
@@ -18513,6 +18610,26 @@ var LogGroup = class {
 
 // src/logging/client.ts
 var LOGGING_BASE_URL = "https://logging.smplkit.com";
+var LoggerRegistrationBuffer = class {
+  _seen = /* @__PURE__ */ new Set();
+  _pending = [];
+  add(id, level, resolvedLevel, service, environment) {
+    if (this._seen.has(id)) return;
+    this._seen.add(id);
+    const item = { id, level, resolved_level: resolvedLevel };
+    if (service) item.service = service;
+    if (environment) item.environment = environment;
+    this._pending.push(item);
+  }
+  drain() {
+    const batch = this._pending;
+    this._pending = [];
+    return batch;
+  }
+  get pendingCount() {
+    return this._pending.length;
+  }
+};
 async function checkError3(response, _context) {
   const body = await response.text().catch(() => "");
   throwForStatus(response.status, body);
@@ -18583,6 +18700,8 @@ var LoggingClient = class {
   _keyListeners = /* @__PURE__ */ new Map();
   _adapters = [];
   _explicitAdapters = false;
+  _loggerBuffer = new LoggerRegistrationBuffer();
+  _loggerFlushTimer = null;
   /** @internal */
   constructor(apiKey, ensureWs, timeout) {
     this._apiKey = apiKey;
@@ -18828,15 +18947,20 @@ var LoggingClient = class {
     if (!this._explicitAdapters) {
       this._adapters = this._autoLoadAdapters();
     }
-    const discovered = [];
+    const service = this._parent?._service ?? null;
+    const environment = this._parent?._environment ?? null;
+    let discoveredCount = 0;
     for (const adapter of this._adapters) {
       try {
         const loggers = adapter.discover();
-        discovered.push(...loggers);
+        for (const { name, level } of loggers) {
+          this._loggerBuffer.add(name, level, level, service, environment);
+          discoveredCount++;
+        }
       } catch {
       }
     }
-    debug("discovery", `discovered ${discovered.length} logger(s) from adapters`);
+    debug("discovery", `discovered ${discoveredCount} logger(s) from adapters`);
     for (const adapter of this._adapters) {
       try {
         adapter.installHook((name, level) => {
@@ -18846,39 +18970,13 @@ var LoggingClient = class {
       } catch {
       }
     }
-    if (discovered.length > 0) {
+    if (discoveredCount > 0) {
       const metrics = this._parent?._metrics;
       if (metrics) {
-        metrics.record("logging.loggers_discovered", discovered.length, "loggers");
-      }
-    }
-    if (discovered.length > 0) {
-      const service = this._parent?._service ?? null;
-      const environment = this._parent?._environment ?? null;
-      const loggers = discovered.map(
-        ({ name, level }) => ({
-          id: name,
-          // For Winston/Pino there is no inherited-null distinction — both fields carry the same value.
-          level,
-          resolved_level: level,
-          service: service ?? void 0,
-          environment: environment ?? void 0
-        })
-      );
-      debug("registration", `flushing ${loggers.length} logger(s) to bulk-register endpoint`);
-      try {
-        const result = await this._http.POST("/api/v1/loggers/bulk", {
-          body: { loggers }
-        });
-        if (result.error !== void 0)
-          await checkError3(result.response, "Failed to bulk-register loggers");
-        debug("registration", `bulk-register complete (${loggers.length} logger(s))`);
-      } catch (err) {
-        console.warn(
-          `[smplkit] Failed to bulk-register loggers: ${err instanceof Error ? err.message : String(err)}`
-        );
+        metrics.record("logging.loggers_discovered", discoveredCount, "loggers");
       }
     }
+    await this._flushLoggerBuffer();
     debug("resolution", `starting resolution pass (trigger: start())`);
     try {
       const [serverLoggers, serverGroups] = await Promise.all([
@@ -18897,6 +18995,9 @@ var LoggingClient = class {
     this._wsManager.on("logger_deleted", this._handleLoggerChanged);
     this._wsManager.on("group_changed", this._handleGroupChanged);
     this._wsManager.on("group_deleted", this._handleGroupChanged);
+    this._loggerFlushTimer = setInterval(() => {
+      void this._flushLoggerBuffer();
+    }, 3e4);
     this._started = true;
   }
   // ------------------------------------------------------------------
@@ -18928,6 +19029,10 @@ var LoggingClient = class {
   /** @internal */
   _close() {
     debug("lifecycle", "LoggingClient._close() called");
+    if (this._loggerFlushTimer !== null) {
+      clearInterval(this._loggerFlushTimer);
+      this._loggerFlushTimer = null;
+    }
     for (const adapter of this._adapters) {
       try {
         adapter.uninstallHook();
@@ -18996,12 +19101,34 @@ var LoggingClient = class {
     }
   }
   /** Called by adapter hooks when a new logger is created in the framework. */
-  _onAdapterNewLogger(_name, _level) {
-    debug("discovery", `new logger intercepted at runtime: ${_name}`);
-    const logger = this.management.new(_name, { managed: true });
-    logger.setLevel(_level);
-    logger.save().catch(() => {
-    });
+  _onAdapterNewLogger(name, level) {
+    debug("discovery", `new logger intercepted at runtime: ${name}`);
+    const service = this._parent?._service ?? null;
+    const environment = this._parent?._environment ?? null;
+    this._loggerBuffer.add(name, level, level, service, environment);
+    if (this._loggerBuffer.pendingCount >= 50) {
+      void this._flushLoggerBuffer();
+    }
+  }
+  /** Flush buffered loggers to the bulk-register endpoint. */
+  async _flushLoggerBuffer() {
+    const batch = this._loggerBuffer.drain();
+    if (batch.length === 0) return;
+    debug("registration", `flushing ${batch.length} logger(s) to bulk-register endpoint`);
+    try {
+      const result = await this._http.POST("/api/v1/loggers/bulk", {
+        body: { loggers: batch }
+      });
+      if (result.error !== void 0) {
+        console.warn("[smplkit] Logger bulk registration failed");
+      } else {
+        debug("registration", `bulk-register complete (${batch.length} logger(s))`);
+      }
+    } catch (err) {
+      console.warn(
+        `[smplkit] Logger bulk registration failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
   }
   // ------------------------------------------------------------------
   // Internal: WebSocket handler