@smplkit/sdk 3.0.22 → 3.0.23

package/dist/index.d.cts

@@ -1772,6 +1772,9 @@ declare class FlagsClient {
     private _flagBuffer;
     private _flagFlushTimer;
     private _handles;
+    private _initBackoffMs;
+    private _initRetryTimer;
+    private _wsSubscribed;
     private _globalListeners;
     private _keyListeners;
     private _wsManager;
@@ -2090,6 +2093,11 @@ declare class FlagRegistrationBuffer {
     private _seen;
     private _pending;
     add(decl: FlagDeclaration): void;
+    /** Non-destructive snapshot — items remain in the buffer until committed. */
+    peek(): Array<components["schemas"]["FlagBulkItem"]>;
+    /** Remove successfully-sent items by id. Called after a successful POST. */
+    commit(ids: Set<string>): void;
+    /** Destructively clear the buffer. For teardown / test use only. */
     drain(): Array<components["schemas"]["FlagBulkItem"]>;
     get pendingCount(): number;
 }

package/dist/index.d.ts

@@ -1772,6 +1772,9 @@ declare class FlagsClient {
     private _flagBuffer;
     private _flagFlushTimer;
     private _handles;
+    private _initBackoffMs;
+    private _initRetryTimer;
+    private _wsSubscribed;
     private _globalListeners;
     private _keyListeners;
     private _wsManager;
@@ -2090,6 +2093,11 @@ declare class FlagRegistrationBuffer {
     private _seen;
     private _pending;
     add(decl: FlagDeclaration): void;
+    /** Non-destructive snapshot — items remain in the buffer until committed. */
+    peek(): Array<components["schemas"]["FlagBulkItem"]>;
+    /** Remove successfully-sent items by id. Called after a successful POST. */
+    commit(ids: Set<string>): void;
+    /** Destructively clear the buffer. For teardown / test use only. */
     drain(): Array<components["schemas"]["FlagBulkItem"]>;
     get pendingCount(): number;
 }

package/dist/index.js

@@ -19133,6 +19133,15 @@ var FlagRegistrationBuffer = class {
       environment: decl.environment ?? void 0
     });
   }
+  /** Non-destructive snapshot — items remain in the buffer until committed. */
+  peek() {
+    return [...this._pending];
+  }
+  /** Remove successfully-sent items by id. Called after a successful POST. */
+  commit(ids) {
+    this._pending = this._pending.filter((item) => !ids.has(item.id));
+  }
+  /** Destructively clear the buffer. For teardown / test use only. */
   drain() {
     const batch = this._pending;
     this._pending = [];
@@ -19274,10 +19283,13 @@ var ManagementFlagsClient = class {
   }
   /** Send any pending flag declarations to the server. */
   async flush() {
-    const batch = this._buffer.drain();
+    const batch = this._buffer.peek();
     if (batch.length === 0) return;
     try {
-      await this._http.POST("/api/v1/flags/bulk", { body: { flags: batch } });
+      const result = await this._http.POST("/api/v1/flags/bulk", { body: { flags: batch } });
+      if (result.response.ok) {
+        this._buffer.commit(new Set(batch.map((b) => b.id)));
+      }
     } catch {
     }
   }
@@ -20826,6 +20838,15 @@ var FlagRegistrationBuffer2 = class {
       });
     }
   }
+  /** Non-destructive snapshot — items remain in the buffer until committed. */
+  peek() {
+    return [...this._pending];
+  }
+  /** Remove successfully-sent items by id. Called after a successful POST. */
+  commit(ids) {
+    this._pending = this._pending.filter((item) => !ids.has(item.id));
+  }
+  /** Destructively clear the buffer. For teardown / test use only. */
   drain() {
     const batch = this._pending;
     this._pending = [];
@@ -20854,6 +20875,10 @@ var FlagsClient = class {
   _flagBuffer = new FlagRegistrationBuffer2();
   _flagFlushTimer = null;
   _handles = {};
+  // Backoff-retry state for initialize() / _connectInternal()
+  _initBackoffMs = 1e3;
+  _initRetryTimer = null;
+  _wsSubscribed = false;
   _globalListeners = [];
   _keyListeners = /* @__PURE__ */ new Map();
   // Shared WebSocket (set during initialize)
@@ -20931,7 +20956,14 @@ var FlagsClient = class {
       this._parent?._environment ?? null
     );
     if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE2) {
-      void this._flushFlags();
+      void this._flushFlags().catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`[smplkit] Failed to bulk-register flags: ${msg}`);
+        debug(
+          "registration",
+          `flag bulk-register error: ${err instanceof Error ? err.stack ?? msg : msg}`
+        );
+      });
     }
     return handle;
   }
@@ -20957,7 +20989,14 @@ var FlagsClient = class {
       this._parent?._environment ?? null
     );
     if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE2) {
-      void this._flushFlags();
+      void this._flushFlags().catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`[smplkit] Failed to bulk-register flags: ${msg}`);
+        debug(
+          "registration",
+          `flag bulk-register error: ${err instanceof Error ? err.stack ?? msg : msg}`
+        );
+      });
     }
     return handle;
   }
@@ -20983,7 +21022,14 @@ var FlagsClient = class {
       this._parent?._environment ?? null
     );
     if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE2) {
-      void this._flushFlags();
+      void this._flushFlags().catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`[smplkit] Failed to bulk-register flags: ${msg}`);
+        debug(
+          "registration",
+          `flag bulk-register error: ${err instanceof Error ? err.stack ?? msg : msg}`
+        );
+      });
     }
     return handle;
   }
@@ -21009,7 +21055,14 @@ var FlagsClient = class {
       this._parent?._environment ?? null
     );
     if (this._flagBuffer.pendingCount >= FLAG_REGISTRATION_FLUSH_SIZE2) {
-      void this._flushFlags();
+      void this._flushFlags().catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`[smplkit] Failed to bulk-register flags: ${msg}`);
+        debug(
+          "registration",
+          `flag bulk-register error: ${err instanceof Error ? err.stack ?? msg : msg}`
+        );
+      });
     }
     return handle;
   }
@@ -21044,19 +21097,51 @@ var FlagsClient = class {
     if (this._initialized) return;
     debug("lifecycle", "FlagsClient.initialize() called");
     this._environment = this._parent?._environment ?? null;
-    await this._flushFlags();
-    await this._fetchAllFlags();
+    try {
+      await this._flushFlags();
+      await this._fetchAllFlags();
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.warn(`[smplkit] FlagsClient initialization failed (will retry): ${msg}`);
+      if (this._initRetryTimer !== null) {
+        clearTimeout(this._initRetryTimer);
+        this._initRetryTimer = null;
+      }
+      const delay = this._initBackoffMs;
+      this._initBackoffMs = Math.min(this._initBackoffMs * 2, 6e4);
+      this._initRetryTimer = setTimeout(() => {
+        this._initRetryTimer = null;
+        void this.initialize();
+      }, delay);
+      if (typeof this._initRetryTimer === "object" && "unref" in this._initRetryTimer) {
+        this._initRetryTimer.unref();
+      }
+      return;
+    }
+    this._initBackoffMs = 1e3;
     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._wsManager.on("flags_changed", this._handleFlagsChanged);
-    this._flagFlushTimer = setInterval(() => {
-      void this._flushFlags();
-    }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
-    if (typeof this._flagFlushTimer === "object" && "unref" in this._flagFlushTimer) {
-      this._flagFlushTimer.unref();
+    if (!this._wsSubscribed) {
+      this._wsManager = this._ensureWs();
+      this._wsManager.on("flag_changed", this._handleFlagChanged);
+      this._wsManager.on("flag_deleted", this._handleFlagDeleted);
+      this._wsManager.on("flags_changed", this._handleFlagsChanged);
+      this._wsSubscribed = true;
+    }
+    if (this._flagFlushTimer === null) {
+      this._flagFlushTimer = setInterval(() => {
+        void this._flushFlags().catch((err) => {
+          const msg = err instanceof Error ? err.message : String(err);
+          console.warn(`[smplkit] Failed to bulk-register flags: ${msg}`);
+          debug(
+            "registration",
+            `flag bulk-register error: ${err instanceof Error ? err.stack ?? msg : msg}`
+          );
+        });
+      }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
+      if (typeof this._flagFlushTimer === "object" && "unref" in this._flagFlushTimer) {
+        this._flagFlushTimer.unref();
+      }
     }
   }
   /**
@@ -21066,6 +21151,10 @@ var FlagsClient = class {
    * @internal
    */
   _close() {
+    if (this._initRetryTimer !== null) {
+      clearTimeout(this._initRetryTimer);
+      this._initRetryTimer = null;
+    }
     if (this._flagFlushTimer !== null) {
       clearInterval(this._flagFlushTimer);
       this._flagFlushTimer = null;
@@ -21078,10 +21167,16 @@ var FlagsClient = class {
     }
     this._cache.clear();
     this._initialized = false;
+    this._wsSubscribed = false;
+    this._initBackoffMs = 1e3;
     this._environment = null;
   }
   /** Disconnect the flags runtime and release resources. */
   async disconnect() {
+    if (this._initRetryTimer !== null) {
+      clearTimeout(this._initRetryTimer);
+      this._initRetryTimer = null;
+    }
     if (this._wsManager !== null) {
       this._wsManager.off("flag_changed", this._handleFlagChanged);
       this._wsManager.off("flag_deleted", this._handleFlagDeleted);
@@ -21096,6 +21191,8 @@ var FlagsClient = class {
     this._flagStore = {};
     this._cache.clear();
     this._initialized = false;
+    this._wsSubscribed = false;
+    this._initBackoffMs = 1e3;
     this._environment = null;
   }
   /** Refresh all flag definitions from the server. */
@@ -21224,19 +21321,51 @@ var FlagsClient = class {
   /** @internal — called by SmplClient constructor / lazy init. */
   async _connectInternal(environment) {
     this._environment = environment;
-    await this._flushFlags();
-    await this._fetchAllFlags();
+    try {
+      await this._flushFlags();
+      await this._fetchAllFlags();
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.warn(`[smplkit] FlagsClient initialization failed (will retry): ${msg}`);
+      if (this._initRetryTimer !== null) {
+        clearTimeout(this._initRetryTimer);
+        this._initRetryTimer = null;
+      }
+      const delay = this._initBackoffMs;
+      this._initBackoffMs = Math.min(this._initBackoffMs * 2, 6e4);
+      this._initRetryTimer = setTimeout(() => {
+        this._initRetryTimer = null;
+        void this._connectInternal(environment);
+      }, delay);
+      if (typeof this._initRetryTimer === "object" && "unref" in this._initRetryTimer) {
+        this._initRetryTimer.unref();
+      }
+      return;
+    }
+    this._initBackoffMs = 1e3;
     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._wsManager.on("flags_changed", this._handleFlagsChanged);
-    this._flagFlushTimer = setInterval(() => {
-      void this._flushFlags();
-    }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
-    if (typeof this._flagFlushTimer === "object" && "unref" in this._flagFlushTimer) {
-      this._flagFlushTimer.unref();
+    if (!this._wsSubscribed) {
+      this._wsManager = this._ensureWs();
+      this._wsManager.on("flag_changed", this._handleFlagChanged);
+      this._wsManager.on("flag_deleted", this._handleFlagDeleted);
+      this._wsManager.on("flags_changed", this._handleFlagsChanged);
+      this._wsSubscribed = true;
+    }
+    if (this._flagFlushTimer === null) {
+      this._flagFlushTimer = setInterval(() => {
+        void this._flushFlags().catch((err) => {
+          const msg = err instanceof Error ? err.message : String(err);
+          console.warn(`[smplkit] Failed to bulk-register flags: ${msg}`);
+          debug(
+            "registration",
+            `flag bulk-register error: ${err instanceof Error ? err.stack ?? msg : msg}`
+          );
+        });
+      }, FLAG_REGISTRATION_FLUSH_INTERVAL_MS);
+      if (typeof this._flagFlushTimer === "object" && "unref" in this._flagFlushTimer) {
+        this._flagFlushTimer.unref();
+      }
     }
   }
   // ------------------------------------------------------------------
@@ -21395,21 +21524,16 @@ var FlagsClient = class {
   // Internal: flag registration flush
   // ------------------------------------------------------------------
   async _flushFlags() {
-    const batch = this._flagBuffer.drain();
+    const batch = this._flagBuffer.peek();
     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) {
-      const msg = err instanceof Error ? err.message : String(err);
-      console.warn(`[smplkit] Failed to bulk-register flags: ${msg}`);
-      debug(
-        "registration",
-        `flag bulk-register error: ${err instanceof Error ? err.stack ?? msg : msg}`
-      );
+    const result = await this._http.POST("/api/v1/flags/bulk", {
+      body: { flags: batch }
+    });
+    if (!result.response.ok) {
+      throw new Error(`HTTP ${result.response.status}`);
     }
+    this._flagBuffer.commit(new Set(batch.map((b) => b.id)));
   }
   // ------------------------------------------------------------------
   // Internal: context flush