@smplkit/sdk 1.5.5 → 1.5.7

package/dist/index.d.cts

@@ -308,6 +308,7 @@ interface components {
          *           "rules": []
          *         }
          *       },
+         *       "managed": true,
          *       "name": "Dark Mode",
          *       "type": "BOOLEAN",
          *       "updated_at": "2026-03-27T10:00:00Z",
@@ -350,11 +351,92 @@ interface components {
             environments?: {
                 [key: string]: components["schemas"]["FlagEnvironment"];
             };
+            /**
+             * Managed
+             * @description True if admin-managed, false if auto-discovered
+             */
+            managed?: boolean | null;
+            /** Sources */
+            readonly sources?: {
+                [key: string]: unknown;
+            }[] | null;
             /** Created At */
             readonly created_at?: string | null;
             /** Updated At */
             readonly updated_at?: string | null;
         };
+        /**
+         * FlagBulkItem
+         * @example {
+         *       "default": false,
+         *       "environment": "production",
+         *       "id": "dark-mode",
+         *       "service": "api-gateway",
+         *       "type": "BOOLEAN"
+         *     }
+         */
+        FlagBulkItem: {
+            /**
+             * Id
+             * @description Flag key as declared in code
+             */
+            id: string;
+            /**
+             * Type
+             * @description Flag type: BOOLEAN, STRING, NUMERIC, or JSON
+             */
+            type: string;
+            /**
+             * Default
+             * @description Default value declared in code
+             */
+            default: unknown;
+            /**
+             * Service
+             * @description Service that declared this flag
+             */
+            service?: string | null;
+            /**
+             * Environment
+             * @description Environment where observed
+             */
+            environment?: string | null;
+        };
+        /**
+         * FlagBulkRequest
+         * @example {
+         *       "flags": [
+         *         {
+         *           "default": false,
+         *           "environment": "production",
+         *           "id": "dark-mode",
+         *           "service": "api-gateway",
+         *           "type": "BOOLEAN"
+         *         },
+         *         {
+         *           "default": 3,
+         *           "environment": "production",
+         *           "id": "max-retries",
+         *           "service": "api-gateway",
+         *           "type": "NUMERIC"
+         *         }
+         *       ]
+         *     }
+         */
+        FlagBulkRequest: {
+            /** Flags */
+            flags: components["schemas"]["FlagBulkItem"][];
+        };
+        /**
+         * FlagBulkResponse
+         * @example {
+         *       "registered": 5
+         *     }
+         */
+        FlagBulkResponse: {
+            /** Registered */
+            registered: number;
+        };
         /** FlagEnvironment */
         FlagEnvironment: {
             /**
@@ -396,6 +478,7 @@ interface components {
          *             ]
          *           }
          *         },
+         *         "managed": true,
          *         "name": "Dark Mode",
          *         "type": "BOOLEAN",
          *         "updated_at": "2026-03-27T10:00:00Z",
@@ -439,6 +522,73 @@ interface components {
             /** Value */
             value: unknown;
         };
+        /**
+         * FlagSource
+         * @example {
+         *       "created_at": "2026-04-17T10:00:00Z",
+         *       "data": {
+         *         "default": true,
+         *         "type": "BOOLEAN"
+         *       },
+         *       "environment": "production",
+         *       "first_observed": "2026-04-17T10:00:00Z",
+         *       "last_seen": "2026-04-17T15:30:00Z",
+         *       "service": "api-gateway",
+         *       "updated_at": "2026-04-17T15:30:00Z"
+         *     }
+         */
+        FlagSource: {
+            /** Service */
+            readonly service?: string;
+            /** Environment */
+            readonly environment?: string;
+            /** First Observed */
+            readonly first_observed?: string | null;
+            /** Last Seen */
+            readonly last_seen?: string | null;
+            /** Data */
+            readonly data?: {
+                [key: string]: unknown;
+            } | null;
+            /** Created At */
+            readonly created_at?: string | null;
+            /** Updated At */
+            readonly updated_at?: string | null;
+        };
+        /** FlagSourceListResponse */
+        FlagSourceListResponse: {
+            /** Data */
+            data: components["schemas"]["FlagSourceResource"][];
+        };
+        /**
+         * FlagSourceResource
+         * @example {
+         *       "attributes": {
+         *         "created_at": "2026-04-17T10:00:00Z",
+         *         "data": {
+         *           "default": true,
+         *           "type": "BOOLEAN"
+         *         },
+         *         "environment": "production",
+         *         "first_observed": "2026-04-17T10:00:00Z",
+         *         "last_seen": "2026-04-17T15:30:00Z",
+         *         "service": "api-gateway",
+         *         "updated_at": "2026-04-17T15:30:00Z"
+         *       },
+         *       "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+         *       "type": "flag_source"
+         *     }
+         */
+        FlagSourceResource: {
+            /** Id */
+            id?: string | null;
+            /**
+             * Type
+             * @constant
+             */
+            type: "flag_source";
+            attributes: components["schemas"]["FlagSource"];
+        };
         /** FlagValue */
         FlagValue: {
             /** Name */
@@ -756,6 +906,8 @@ declare class FlagsClient {
     private _cache;
     private _contextProvider;
     private _contextBuffer;
+    private _flagBuffer;
+    private _flagFlushTimer;
     private _handles;
     private _globalListeners;
     private _keyListeners;
@@ -882,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

@@ -308,6 +308,7 @@ interface components {
          *           "rules": []
          *         }
          *       },
+         *       "managed": true,
          *       "name": "Dark Mode",
          *       "type": "BOOLEAN",
          *       "updated_at": "2026-03-27T10:00:00Z",
@@ -350,11 +351,92 @@ interface components {
             environments?: {
                 [key: string]: components["schemas"]["FlagEnvironment"];
             };
+            /**
+             * Managed
+             * @description True if admin-managed, false if auto-discovered
+             */
+            managed?: boolean | null;
+            /** Sources */
+            readonly sources?: {
+                [key: string]: unknown;
+            }[] | null;
             /** Created At */
             readonly created_at?: string | null;
             /** Updated At */
             readonly updated_at?: string | null;
         };
+        /**
+         * FlagBulkItem
+         * @example {
+         *       "default": false,
+         *       "environment": "production",
+         *       "id": "dark-mode",
+         *       "service": "api-gateway",
+         *       "type": "BOOLEAN"
+         *     }
+         */
+        FlagBulkItem: {
+            /**
+             * Id
+             * @description Flag key as declared in code
+             */
+            id: string;
+            /**
+             * Type
+             * @description Flag type: BOOLEAN, STRING, NUMERIC, or JSON
+             */
+            type: string;
+            /**
+             * Default
+             * @description Default value declared in code
+             */
+            default: unknown;
+            /**
+             * Service
+             * @description Service that declared this flag
+             */
+            service?: string | null;
+            /**
+             * Environment
+             * @description Environment where observed
+             */
+            environment?: string | null;
+        };
+        /**
+         * FlagBulkRequest
+         * @example {
+         *       "flags": [
+         *         {
+         *           "default": false,
+         *           "environment": "production",
+         *           "id": "dark-mode",
+         *           "service": "api-gateway",
+         *           "type": "BOOLEAN"
+         *         },
+         *         {
+         *           "default": 3,
+         *           "environment": "production",
+         *           "id": "max-retries",
+         *           "service": "api-gateway",
+         *           "type": "NUMERIC"
+         *         }
+         *       ]
+         *     }
+         */
+        FlagBulkRequest: {
+            /** Flags */
+            flags: components["schemas"]["FlagBulkItem"][];
+        };
+        /**
+         * FlagBulkResponse
+         * @example {
+         *       "registered": 5
+         *     }
+         */
+        FlagBulkResponse: {
+            /** Registered */
+            registered: number;
+        };
         /** FlagEnvironment */
         FlagEnvironment: {
             /**
@@ -396,6 +478,7 @@ interface components {
          *             ]
          *           }
          *         },
+         *         "managed": true,
          *         "name": "Dark Mode",
          *         "type": "BOOLEAN",
          *         "updated_at": "2026-03-27T10:00:00Z",
@@ -439,6 +522,73 @@ interface components {
             /** Value */
             value: unknown;
         };
+        /**
+         * FlagSource
+         * @example {
+         *       "created_at": "2026-04-17T10:00:00Z",
+         *       "data": {
+         *         "default": true,
+         *         "type": "BOOLEAN"
+         *       },
+         *       "environment": "production",
+         *       "first_observed": "2026-04-17T10:00:00Z",
+         *       "last_seen": "2026-04-17T15:30:00Z",
+         *       "service": "api-gateway",
+         *       "updated_at": "2026-04-17T15:30:00Z"
+         *     }
+         */
+        FlagSource: {
+            /** Service */
+            readonly service?: string;
+            /** Environment */
+            readonly environment?: string;
+            /** First Observed */
+            readonly first_observed?: string | null;
+            /** Last Seen */
+            readonly last_seen?: string | null;
+            /** Data */
+            readonly data?: {
+                [key: string]: unknown;
+            } | null;
+            /** Created At */
+            readonly created_at?: string | null;
+            /** Updated At */
+            readonly updated_at?: string | null;
+        };
+        /** FlagSourceListResponse */
+        FlagSourceListResponse: {
+            /** Data */
+            data: components["schemas"]["FlagSourceResource"][];
+        };
+        /**
+         * FlagSourceResource
+         * @example {
+         *       "attributes": {
+         *         "created_at": "2026-04-17T10:00:00Z",
+         *         "data": {
+         *           "default": true,
+         *           "type": "BOOLEAN"
+         *         },
+         *         "environment": "production",
+         *         "first_observed": "2026-04-17T10:00:00Z",
+         *         "last_seen": "2026-04-17T15:30:00Z",
+         *         "service": "api-gateway",
+         *         "updated_at": "2026-04-17T15:30:00Z"
+         *       },
+         *       "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+         *       "type": "flag_source"
+         *     }
+         */
+        FlagSourceResource: {
+            /** Id */
+            id?: string | null;
+            /**
+             * Type
+             * @constant
+             */
+            type: "flag_source";
+            attributes: components["schemas"]["FlagSource"];
+        };
         /** FlagValue */
         FlagValue: {
             /** Name */
@@ -756,6 +906,8 @@ declare class FlagsClient {
     private _cache;
     private _contextProvider;
     private _contextBuffer;
+    private _flagBuffer;
+    private _flagFlushTimer;
     private _handles;
     private _globalListeners;
     private _keyListeners;
@@ -882,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() {