@smplkit/sdk 1.5.6 → 1.5.7

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;

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;

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() {