@smplkit/sdk 1.3.22 → 1.3.23

package/dist/index.cjs

@@ -16808,8 +16808,7 @@ var Config = class {
   items;
   /**
    * Per-environment overrides.
-   * Stored as `{ env_name: { values: { key: value } } }` — values are
-   * unwrapped from the server's `{ value: raw }` wrapper.
+   * Structured as `{ env_name: { values: { key: value } } }`.
    */
   environments;
   /** When the config was created, or null if unavailable. */
@@ -16834,7 +16833,7 @@ var Config = class {
   /**
    * Persist this config to the server.
    *
-   * POST if `id` is null (new config), PUT if `id` is set (update).
+   * Creates if new, updates if existing.
    * Updates this instance in-place with the server response.
    */
   async save() {
@@ -17212,8 +17211,8 @@ var ConfigClient = class {
   /**
    * Resolve a config's values for the current environment.
    *
-   * Returns a flat dict of resolved key-value pairs, walking the
-   * parent chain and applying environment overrides.
+   * Returns a flat dict of resolved key-value pairs with inherited
+   * values and environment overrides applied.
    *
    * Optionally pass a model class to map the resolved values.
    */
@@ -17276,7 +17275,7 @@ var ConfigClient = class {
   // Runtime: refresh
   // ------------------------------------------------------------------
   /**
-   * Re-fetch all configs, re-resolve values, and update the cache.
+   * Re-fetch all configs and re-resolve values.
    * Fires change listeners for any values that differ.
    */
   async refresh() {
@@ -17442,7 +17441,7 @@ var Flag = class {
   /**
    * Persist this flag to the server.
    *
-   * POST if `id` is null (new flag), PUT if `id` is set (update).
+   * Creates if new, updates if existing.
    * Updates this instance in-place with the server response.
    */
   async save() {
@@ -17505,7 +17504,7 @@ var Flag = class {
     }
   }
   /**
-   * Evaluate the flag locally (sync, no HTTP).
+   * Evaluate the flag locally.
    *
    * Requires `initialize()` to have been called.
    */
@@ -18121,10 +18120,10 @@ var FlagsClient = class {
   // Runtime: context registration
   // ------------------------------------------------------------------
   /**
-   * Explicitly register context(s) for background batch registration.
+   * Register context(s) with the server.
    *
-   * Accepts a single Context or an array. Fire-and-forget — never
-   * blocks. Works before `initialize()` is called.
+   * Accepts a single Context or an array. Registration is asynchronous
+   * and never blocks. Works before `initialize()` is called.
    */
   register(context) {
     if (Array.isArray(context)) {
@@ -18141,7 +18140,9 @@ var FlagsClient = class {
   // Runtime: Tier 1 evaluate
   // ------------------------------------------------------------------
   /**
-   * Tier 1 explicit evaluation — stateless, no provider or cache.
+   * Evaluate a flag with an explicit environment and context.
+   *
+   * Stateless — does not use the context provider or cached results.
    */
   async evaluate(key, options) {
     const evalDict = contextsToEvalDict(options.context);
@@ -18384,7 +18385,7 @@ var Logger = class {
   /**
    * Persist this logger to the server.
    *
-   * POST if `id` is null (new), PUT if `id` is set (update).
+   * Creates if new, updates if existing.
    */
   async save() {
     const saved = await this._client._saveLogger(this);
@@ -18469,7 +18470,7 @@ var LogGroup = class {
   /**
    * Persist this log group to the server.
    *
-   * POST if `id` is null (new), PUT if `id` is set (update).
+   * Creates if new, updates if existing.
    */
   async save() {
     const saved = await this._client._saveLogGroup(this);
@@ -18813,14 +18814,9 @@ var LoggingClient = class {
   /**
    * Start the logging runtime.
    *
-   * Performs the full runtime pipeline:
-   *   1. Auto-load adapters (if none registered explicitly)
-   *   2. Discover existing loggers from each adapter
-   *   3. Install hooks on each adapter for new logger creation
-   *   4. Bulk-register discovered loggers with the server
-   *   5. Fetch all loggers and groups from the server
-   *   6. Resolve levels and apply to adapters
-   *   7. Wire WebSocket for live updates
+   * Discovers loggers from registered adapters, syncs them with the
+   * server, applies server-side log levels, and subscribes to live
+   * level updates.
    *
    * Idempotent — safe to call multiple times.
    * Management methods work without start().