@smplkit/sdk 3.0.21 → 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

@@ -16730,19 +16730,20 @@ var AuditEventBuffer = class {
 
 // src/audit/client.ts
 var JSONAPI_CONTENT_TYPE = "application/vnd.api+json";
-function _attributesFromInput(input) {
+function _eventBodyFromInput(input) {
   const attrs = {
     action: input.action,
     resource_type: input.resourceType,
-    resource_id: input.resourceId
+    resource_id: input.resourceId,
+    do_not_forward: input.doNotForward ?? false
   };
   if (input.occurredAt !== void 0) {
-    const ts = input.occurredAt instanceof Date ? input.occurredAt.toISOString() : input.occurredAt;
-    attrs.occurred_at = ts;
+    attrs.occurred_at = input.occurredAt instanceof Date ? input.occurredAt.toISOString() : input.occurredAt;
   }
-  if (input.data !== void 0) attrs.data = input.data;
-  if (input.doNotForward) attrs.do_not_forward = true;
-  return attrs;
+  if (input.data !== void 0) {
+    attrs.data = input.data;
+  }
+  return { data: { id: "", type: "event", attributes: attrs } };
 }
 function _eventFromResource(resource) {
   const attrs = resource.attributes;
@@ -16791,9 +16792,13 @@ function _forwarderAttributes(input) {
     enabled: input.enabled ?? true,
     http: _httpToWire(input.http)
   };
-  if (input.filter !== void 0) attrs.filter = input.filter;
+  if (input.filter !== void 0) {
+    attrs.filter = input.filter;
+  }
   if (input.transform !== void 0) attrs.transform = input.transform;
-  if (input.data !== void 0) attrs.data = input.data;
+  if (input.data !== void 0) {
+    attrs.data = input.data;
+  }
   return attrs;
 }
 function _forwarderFromResource(resource) {
@@ -16857,9 +16862,6 @@ var EventsClient = class {
           const headerInit = {};
           if (item.idempotencyKey !== null) headerInit["Idempotency-Key"] = item.idempotencyKey;
           const result = await this._http.POST("/api/v1/events", {
-            // Casting through unknown because the generated body type is
-            // EventResponse with id required, while the wrapper builds an
-            // unsaved-resource body without an id (server assigns).
             body: item.body,
             headers: headerInit
           });
@@ -16879,10 +16881,7 @@ var EventsClient = class {
    * failures, so a misuse will silently disappear from the queue).
    */
   record(input) {
-    const body = {
-      data: { id: "", type: "event", attributes: _attributesFromInput(input) }
-    };
-    this._buffer.enqueue(body, input.idempotencyKey ?? null);
+    this._buffer.enqueue(_eventBodyFromInput(input), input.idempotencyKey ?? null);
   }
   async list(params = {}) {
     const query = {};
@@ -17012,10 +17011,10 @@ var ForwardersClient = class {
   deliveries;
   actions;
   async create(input) {
-    const body = { data: { id: "", type: "forwarder", attributes: _forwarderAttributes(input) } };
-    const result = await this._http.POST("/api/v1/forwarders", {
-      body
-    });
+    const body = {
+      data: { id: "", type: "forwarder", attributes: _forwarderAttributes(input) }
+    };
+    const result = await this._http.POST("/api/v1/forwarders", { body });
     if (!result.response.ok || result.data === void 0) {
       throw new Error(
         `audit create forwarder failed: ${result.response.status} ${result.response.statusText}`
@@ -19134,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 = [];
@@ -19275,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 {
     }
   }
@@ -20827,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 = [];
@@ -20855,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)
@@ -20932,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;
   }
@@ -20958,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;
   }
@@ -20984,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;
   }
@@ -21010,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;
   }
@@ -21045,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();
+      }
     }
   }
   /**
@@ -21067,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;
@@ -21079,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);
@@ -21097,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. */
@@ -21225,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();
+      }
     }
   }
   // ------------------------------------------------------------------
@@ -21396,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