@smplkit/sdk 1.2.2 → 1.2.4

package/dist/index.cjs

@@ -33,7 +33,6 @@ __export(index_exports, {
   BoolFlagHandle: () => BoolFlagHandle,
   Config: () => Config,
   ConfigClient: () => ConfigClient,
-  ConfigRuntime: () => ConfigRuntime,
   Context: () => Context,
   ContextType: () => ContextType,
   Flag: () => Flag,
@@ -420,6 +419,7 @@ var ConfigClient = class {
   _parent = null;
   _configCache = {};
   _connected = false;
+  _listeners = [];
   /** @internal */
   constructor(apiKey, timeout) {
     this._apiKey = apiKey;
@@ -555,6 +555,102 @@ var ConfigClient = class {
     }
     return itemKey in resolved ? resolved[itemKey] : defaultValue ?? null;
   }
+  /**
+   * Return a config value as a string, or `defaultValue` if absent or not a string.
+   *
+   * @throws {SmplNotConnectedError} If connect() has not been called.
+   */
+  getString(configKey, itemKey, defaultValue = null) {
+    const value = this.getValue(configKey, itemKey);
+    return typeof value === "string" ? value : defaultValue;
+  }
+  /**
+   * Return a config value as a number, or `defaultValue` if absent or not a number.
+   *
+   * @throws {SmplNotConnectedError} If connect() has not been called.
+   */
+  getInt(configKey, itemKey, defaultValue = null) {
+    const value = this.getValue(configKey, itemKey);
+    return typeof value === "number" ? value : defaultValue;
+  }
+  /**
+   * Return a config value as a boolean, or `defaultValue` if absent or not a boolean.
+   *
+   * @throws {SmplNotConnectedError} If connect() has not been called.
+   */
+  getBool(configKey, itemKey, defaultValue = null) {
+    const value = this.getValue(configKey, itemKey);
+    return typeof value === "boolean" ? value : defaultValue;
+  }
+  /**
+   * Re-fetch all configs, re-resolve values, and update the cache.
+   *
+   * Fires change listeners for any values that differ from the previous cache.
+   *
+   * @throws {SmplNotConnectedError} If connect() has not been called.
+   */
+  async refresh() {
+    if (!this._connected) {
+      throw new SmplNotConnectedError("SmplClient is not connected. Call client.connect() first.");
+    }
+    const environment = this._parent?._environment;
+    if (!environment) {
+      throw new SmplError("No environment set.");
+    }
+    const configs = await this.list();
+    const newCache = {};
+    for (const cfg of configs) {
+      const chain = await cfg._buildChain(this._http);
+      newCache[cfg.key] = resolveChain(chain, environment);
+    }
+    const oldCache = this._configCache;
+    this._configCache = newCache;
+    this._diffAndFire(oldCache, newCache, "manual");
+  }
+  /**
+   * Register a listener that fires when a config value changes (on refresh).
+   *
+   * @param callback - Called with a {@link ConfigChangeEvent} on each change.
+   * @param options.configKey - If provided, only fire for changes to this config.
+   * @param options.itemKey - If provided, only fire for changes to this item key.
+   */
+  onChange(callback, options) {
+    this._listeners.push({
+      callback,
+      configKey: options?.configKey ?? null,
+      itemKey: options?.itemKey ?? null
+    });
+  }
+  /** @internal */
+  _diffAndFire(oldCache, newCache, source) {
+    const allConfigKeys = /* @__PURE__ */ new Set([...Object.keys(oldCache), ...Object.keys(newCache)]);
+    for (const cfgKey of allConfigKeys) {
+      const oldItems = oldCache[cfgKey] ?? {};
+      const newItems = newCache[cfgKey] ?? {};
+      const allItemKeys = /* @__PURE__ */ new Set([...Object.keys(oldItems), ...Object.keys(newItems)]);
+      for (const iKey of allItemKeys) {
+        const oldVal = iKey in oldItems ? oldItems[iKey] : null;
+        const newVal = iKey in newItems ? newItems[iKey] : null;
+        if (JSON.stringify(oldVal) !== JSON.stringify(newVal)) {
+          const event = {
+            configKey: cfgKey,
+            itemKey: iKey,
+            oldValue: oldVal,
+            newValue: newVal,
+            source
+          };
+          for (const listener of this._listeners) {
+            if (listener.configKey !== null && listener.configKey !== cfgKey) continue;
+            if (listener.itemKey !== null && listener.itemKey !== iKey) continue;
+            try {
+              listener.callback(event);
+            } catch {
+            }
+          }
+        }
+      }
+    }
+  }
   /**
    * Internal: PUT a full config update and return the updated model.
    *
@@ -1927,215 +2023,6 @@ var SmplClient = class {
   }
 };
 
-// src/config/runtime.ts
-var ConfigRuntime = class {
-  _cache;
-  _chain;
-  _fetchCount;
-  _lastFetchAt;
-  _closed = false;
-  _listeners = [];
-  _environment;
-  _fetchChain;
-  _sharedWs = null;
-  /** @internal */
-  constructor(options) {
-    this._environment = options.environment;
-    this._fetchChain = options.fetchChain;
-    this._chain = options.chain;
-    this._cache = resolveChain(options.chain, options.environment);
-    this._fetchCount = options.chain.length;
-    this._lastFetchAt = (/* @__PURE__ */ new Date()).toISOString();
-    if (options.sharedWs) {
-      this._sharedWs = options.sharedWs;
-      this._sharedWs.on("config_changed", this._handleConfigChanged);
-      this._sharedWs.on("config_deleted", this._handleConfigDeleted);
-    }
-  }
-  // ---- Value access (synchronous, local cache) ----
-  /**
-   * Return the resolved value for `key`, or `defaultValue` if absent.
-   *
-   * @param key - The config key to look up.
-   * @param defaultValue - Returned when the key is not present (default: null).
-   */
-  get(key, defaultValue = null) {
-    return key in this._cache ? this._cache[key] : defaultValue;
-  }
-  /**
-   * Return the value as a string, or `defaultValue` if absent or not a string.
-   */
-  getString(key, defaultValue = null) {
-    const value = this._cache[key];
-    return typeof value === "string" ? value : defaultValue;
-  }
-  /**
-   * Return the value as a number, or `defaultValue` if absent or not a number.
-   */
-  getInt(key, defaultValue = null) {
-    const value = this._cache[key];
-    return typeof value === "number" ? value : defaultValue;
-  }
-  /**
-   * Return the value as a boolean, or `defaultValue` if absent or not a boolean.
-   */
-  getBool(key, defaultValue = null) {
-    const value = this._cache[key];
-    return typeof value === "boolean" ? value : defaultValue;
-  }
-  /**
-   * Return whether `key` is present in the resolved configuration.
-   */
-  exists(key) {
-    return key in this._cache;
-  }
-  /**
-   * Return a shallow copy of the full resolved configuration.
-   */
-  getAll() {
-    return { ...this._cache };
-  }
-  // ---- Change listeners ----
-  /**
-   * Register a listener that fires when a config value changes.
-   *
-   * @param callback - Called with a {@link ConfigChangeEvent} on each change.
-   * @param options.key - If provided, the listener fires only for this key.
-   *   If omitted, the listener fires for all changes.
-   */
-  onChange(callback, options) {
-    this._listeners.push({
-      callback,
-      key: options?.key ?? null
-    });
-  }
-  // ---- Diagnostics ----
-  /**
-   * Return diagnostic statistics for this runtime.
-   */
-  stats() {
-    return {
-      fetchCount: this._fetchCount,
-      lastFetchAt: this._lastFetchAt
-    };
-  }
-  /**
-   * Return the current WebSocket connection status.
-   */
-  connectionStatus() {
-    if (this._sharedWs) {
-      return this._sharedWs.connectionStatus;
-    }
-    return "disconnected";
-  }
-  // ---- Lifecycle ----
-  /**
-   * Force a manual refresh of the cached configuration.
-   *
-   * Re-fetches the full config chain via HTTP, re-resolves values, updates
-   * the local cache, and fires listeners for any detected changes.
-   *
-   * @throws {Error} If no `fetchChain` function was provided on construction.
-   */
-  async refresh() {
-    if (!this._fetchChain) {
-      throw new Error("No fetchChain function provided; cannot refresh.");
-    }
-    const newChain = await this._fetchChain();
-    const oldCache = this._cache;
-    this._chain = newChain;
-    this._cache = resolveChain(newChain, this._environment);
-    this._fetchCount += newChain.length;
-    this._lastFetchAt = (/* @__PURE__ */ new Date()).toISOString();
-    this._diffAndFire(oldCache, this._cache, "manual");
-  }
-  /**
-   * Close the runtime connection.
-   *
-   * Unregisters from the shared WebSocket. Safe to call multiple times.
-   */
-  async close() {
-    this._closed = true;
-    if (this._sharedWs !== null) {
-      this._sharedWs.off("config_changed", this._handleConfigChanged);
-      this._sharedWs.off("config_deleted", this._handleConfigDeleted);
-      this._sharedWs = null;
-    }
-  }
-  /**
-   * Async dispose support for `await using` (TypeScript 5.2+).
-   */
-  async [Symbol.asyncDispose]() {
-    await this.close();
-  }
-  // ---- Shared WebSocket event handlers ----
-  _handleConfigChanged = (data) => {
-    if (this._closed) return;
-    const configId = data.config_id;
-    const changes = data.changes;
-    if (configId && changes) {
-      this._applyChanges(configId, changes);
-    } else if (this._fetchChain) {
-      void this._fetchChain().then((newChain) => {
-        const oldCache = this._cache;
-        this._chain = newChain;
-        this._cache = resolveChain(newChain, this._environment);
-        this._fetchCount += newChain.length;
-        this._lastFetchAt = (/* @__PURE__ */ new Date()).toISOString();
-        this._diffAndFire(oldCache, this._cache, "websocket");
-      }).catch(() => {
-      });
-    }
-  };
-  _handleConfigDeleted = (_data) => {
-    this._closed = true;
-    void this.close();
-  };
-  _applyChanges(configId, changes) {
-    const chainEntry = this._chain.find((c) => c.id === configId);
-    if (!chainEntry) return;
-    for (const change of changes) {
-      const { key, new_value } = change;
-      const envEntry = chainEntry.environments[this._environment] !== void 0 && chainEntry.environments[this._environment] !== null ? chainEntry.environments[this._environment] : null;
-      const envValues = envEntry !== null && typeof envEntry === "object" ? envEntry.values ?? {} : null;
-      if (new_value === null || new_value === void 0) {
-        delete chainEntry.items[key];
-        if (envValues) delete envValues[key];
-      } else if (envValues && key in envValues) {
-        envValues[key] = new_value;
-      } else if (key in chainEntry.items) {
-        chainEntry.items[key] = new_value;
-      } else {
-        chainEntry.items[key] = new_value;
-      }
-    }
-    const oldCache = this._cache;
-    this._cache = resolveChain(this._chain, this._environment);
-    this._diffAndFire(oldCache, this._cache, "websocket");
-  }
-  _diffAndFire(oldCache, newCache, source) {
-    const allKeys = /* @__PURE__ */ new Set([...Object.keys(oldCache), ...Object.keys(newCache)]);
-    for (const key of allKeys) {
-      const oldVal = key in oldCache ? oldCache[key] : null;
-      const newVal = key in newCache ? newCache[key] : null;
-      if (JSON.stringify(oldVal) !== JSON.stringify(newVal)) {
-        const event = { key, oldValue: oldVal, newValue: newVal, source };
-        this._fireListeners(event);
-      }
-    }
-  }
-  _fireListeners(event) {
-    for (const listener of this._listeners) {
-      if (listener.key === null || listener.key === event.key) {
-        try {
-          listener.callback(event);
-        } catch {
-        }
-      }
-    }
-  }
-};
-
 // src/flags/types.ts
 var Context = class {
   type;
@@ -2205,7 +2092,6 @@ var Rule = class {
   BoolFlagHandle,
   Config,
   ConfigClient,
-  ConfigRuntime,
   Context,
   ContextType,
   Flag,