@smplkit/sdk 1.0.0 → 1.1.0

package/README.md

@@ -5,13 +5,13 @@ Official TypeScript SDK for the [smplkit](https://docs.smplkit.com) platform.
 ## Installation
 
 ```bash
-npm install smplkit
+npm install @smplkit/sdk
 ```
 
 ## Quick Start
 
 ```typescript
-import { SmplkitClient } from "smplkit";
+import { SmplkitClient } from "@smplkit/sdk";
 
 const client = new SmplkitClient({ apiKey: "sk_api_..." });
 
@@ -39,7 +39,6 @@ await client.config.delete(newConfig.id);
 ```typescript
 const client = new SmplkitClient({
   apiKey: "sk_api_...",                        // Required
-  baseUrl: "https://config.smplkit.com",       // Optional (default shown)
   timeout: 30000,                               // Optional, in milliseconds (default: 30000)
 });
 ```
@@ -56,7 +55,7 @@ import {
   SmplValidationError,
   SmplConnectionError,
   SmplTimeoutError,
-} from "smplkit";
+} from "@smplkit/sdk";
 
 try {
   const config = await client.config.get({ key: "nonexistent" });

package/dist/chunk-PZD5PSQY.js

@@ -0,0 +1,317 @@
+// src/config/runtime.ts
+import WebSocket from "ws";
+
+// src/config/resolve.ts
+function deepMerge(base, override) {
+  const result = { ...base };
+  for (const [key, value] of Object.entries(override)) {
+    if (key in result && typeof result[key] === "object" && result[key] !== null && !Array.isArray(result[key]) && typeof value === "object" && value !== null && !Array.isArray(value)) {
+      result[key] = deepMerge(
+        result[key],
+        value
+      );
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function resolveChain(chain, environment) {
+  let accumulated = {};
+  for (let i = chain.length - 1; i >= 0; i--) {
+    const config = chain[i];
+    const baseValues = config.values ?? {};
+    const envEntry = (config.environments ?? {})[environment];
+    const envValues = envEntry !== null && envEntry !== void 0 && typeof envEntry === "object" && !Array.isArray(envEntry) ? envEntry.values ?? {} : {};
+    const configResolved = deepMerge(baseValues, envValues);
+    accumulated = deepMerge(accumulated, configResolved);
+  }
+  return accumulated;
+}
+
+// src/config/runtime.ts
+var BACKOFF_MS = [1e3, 2e3, 4e3, 8e3, 16e3, 32e3, 6e4];
+var ConfigRuntime = class {
+  _cache;
+  _chain;
+  _fetchCount;
+  _lastFetchAt;
+  _closed = false;
+  _wsStatus = "disconnected";
+  _ws = null;
+  _reconnectTimer = null;
+  _backoffIndex = 0;
+  _listeners = [];
+  _configId;
+  _environment;
+  _apiKey;
+  _baseUrl;
+  _fetchChain;
+  /** @internal */
+  constructor(options) {
+    this._configId = options.configId;
+    this._environment = options.environment;
+    this._apiKey = options.apiKey;
+    this._baseUrl = options.baseUrl;
+    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();
+    this._connectWebSocket();
+  }
+  // ---- 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.
+   */
+  getNumber(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() {
+    return this._wsStatus;
+  }
+  // ---- 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.
+   *
+   * Shuts down the WebSocket and cancels any pending reconnect timer.
+   * Safe to call multiple times.
+   */
+  async close() {
+    this._closed = true;
+    this._wsStatus = "disconnected";
+    if (this._reconnectTimer !== null) {
+      clearTimeout(this._reconnectTimer);
+      this._reconnectTimer = null;
+    }
+    if (this._ws !== null) {
+      this._ws.close();
+      this._ws = null;
+    }
+  }
+  /**
+   * Async dispose support for `await using` (TypeScript 5.2+).
+   */
+  async [Symbol.asyncDispose]() {
+    await this.close();
+  }
+  // ---- WebSocket internals ----
+  _buildWsUrl() {
+    let url = this._baseUrl;
+    if (url.startsWith("https://")) {
+      url = "wss://" + url.slice("https://".length);
+    } else if (url.startsWith("http://")) {
+      url = "ws://" + url.slice("http://".length);
+    } else {
+      url = "wss://" + url;
+    }
+    url = url.replace(/\/$/, "");
+    return `${url}/api/ws/v1/configs?api_key=${this._apiKey}`;
+  }
+  _connectWebSocket() {
+    if (this._closed) return;
+    this._wsStatus = "connecting";
+    const wsUrl = this._buildWsUrl();
+    try {
+      const ws = new WebSocket(wsUrl);
+      this._ws = ws;
+      ws.on("open", () => {
+        if (this._closed) {
+          ws.close();
+          return;
+        }
+        this._backoffIndex = 0;
+        this._wsStatus = "connected";
+        ws.send(
+          JSON.stringify({
+            type: "subscribe",
+            config_id: this._configId,
+            environment: this._environment
+          })
+        );
+      });
+      ws.on("message", (data) => {
+        try {
+          const msg = JSON.parse(String(data));
+          this._handleMessage(msg);
+        } catch {
+        }
+      });
+      ws.on("close", () => {
+        if (!this._closed) {
+          this._wsStatus = "disconnected";
+          this._scheduleReconnect();
+        }
+      });
+      ws.on("error", () => {
+      });
+    } catch {
+      if (!this._closed) {
+        this._scheduleReconnect();
+      }
+    }
+  }
+  _scheduleReconnect() {
+    if (this._closed) return;
+    const delay = BACKOFF_MS[Math.min(this._backoffIndex, BACKOFF_MS.length - 1)];
+    this._backoffIndex++;
+    this._wsStatus = "connecting";
+    this._reconnectTimer = setTimeout(() => {
+      this._reconnectTimer = null;
+      if (this._fetchChain) {
+        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, "manual");
+        }).catch(() => {
+        }).finally(() => {
+          this._connectWebSocket();
+        });
+      } else {
+        this._connectWebSocket();
+      }
+    }, delay);
+  }
+  _handleMessage(msg) {
+    if (msg.type === "config_changed") {
+      this._applyChanges(msg.config_id, msg.changes);
+    } else if (msg.type === "config_deleted") {
+      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.values[key];
+        if (envValues) delete envValues[key];
+      } else if (envValues && key in envValues) {
+        envValues[key] = new_value;
+      } else if (key in chainEntry.values) {
+        chainEntry.values[key] = new_value;
+      } else {
+        chainEntry.values[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 {
+        }
+      }
+    }
+  }
+};
+
+export {
+  ConfigRuntime
+};
+//# sourceMappingURL=chunk-PZD5PSQY.js.map

package/dist/chunk-PZD5PSQY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/runtime.ts","../src/config/resolve.ts"],"sourcesContent":["/**\n * ConfigRuntime — runtime-plane value resolution with WebSocket updates.\n *\n * Holds a fully resolved local cache of config values for a specific\n * environment.  All value-access methods are synchronous (local reads);\n * only {@link refresh} and {@link close} are async.\n *\n * A background WebSocket connection is maintained for real-time updates.\n * If the WebSocket fails, the runtime operates in cache-only mode and\n * reconnects automatically with exponential backoff.\n */\n\nimport WebSocket from \"ws\";\nimport { resolveChain } from \"./resolve.js\";\nimport type { ChainConfig } from \"./resolve.js\";\nimport type { ConfigChangeEvent, ConfigStats, ConnectionStatus } from \"./runtime-types.js\";\n\n/** @internal */\ninterface ChangeListener {\n  callback: (event: ConfigChangeEvent) => void;\n  key: string | null;\n}\n\n/** @internal */\ninterface WsConfigChangedMessage {\n  type: \"config_changed\";\n  config_id: string;\n  changes: Array<{\n    key: string;\n    old_value: unknown;\n    new_value: unknown;\n  }>;\n}\n\n/** @internal */\ninterface WsConfigDeletedMessage {\n  type: \"config_deleted\";\n  config_id: string;\n}\n\ntype WsMessage =\n  | { type: \"subscribed\"; config_id: string; environment: string }\n  | { type: \"error\"; message: string }\n  | WsConfigChangedMessage\n  | WsConfigDeletedMessage;\n\n/** @internal */\nconst BACKOFF_MS = [1000, 2000, 4000, 8000, 16000, 32000, 60000];\n\n/** @internal Options for constructing a ConfigRuntime. */\nexport interface ConfigRuntimeOptions {\n  configKey: string;\n  configId: string;\n  environment: string;\n  chain: ChainConfig[];\n  apiKey: string;\n  baseUrl: string;\n  fetchChain: (() => Promise<ChainConfig[]>) | null;\n}\n\n/**\n * Runtime configuration handle for a specific environment.\n *\n * Obtained by calling {@link Config.connect}.  All value-access methods\n * are synchronous and served entirely from a local in-process cache.\n * The cache is populated eagerly on construction and kept current via\n * a background WebSocket connection.\n */\nexport class ConfigRuntime {\n  private _cache: Record<string, unknown>;\n  private _chain: ChainConfig[];\n  private _fetchCount: number;\n  private _lastFetchAt: string | null;\n  private _closed = false;\n  private _wsStatus: ConnectionStatus = \"disconnected\";\n  private _ws: InstanceType<typeof WebSocket> | null = null;\n  private _reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private _backoffIndex = 0;\n  private _listeners: ChangeListener[] = [];\n\n  private readonly _configId: string;\n  private readonly _environment: string;\n  private readonly _apiKey: string;\n  private readonly _baseUrl: string;\n  private readonly _fetchChain: (() => Promise<ChainConfig[]>) | null;\n\n  /** @internal */\n  constructor(options: ConfigRuntimeOptions) {\n    this._configId = options.configId;\n    this._environment = options.environment;\n    this._apiKey = options.apiKey;\n    this._baseUrl = options.baseUrl;\n    this._fetchChain = options.fetchChain;\n    this._chain = options.chain;\n    this._cache = resolveChain(options.chain, options.environment);\n    this._fetchCount = options.chain.length;\n    this._lastFetchAt = new Date().toISOString();\n\n    // Start WebSocket in background — non-blocking\n    this._connectWebSocket();\n  }\n\n  // ---- Value access (synchronous, local cache) ----\n\n  /**\n   * Return the resolved value for `key`, or `defaultValue` if absent.\n   *\n   * @param key - The config key to look up.\n   * @param defaultValue - Returned when the key is not present (default: null).\n   */\n  get(key: string, defaultValue: unknown = null): unknown {\n    return key in this._cache ? this._cache[key] : defaultValue;\n  }\n\n  /**\n   * Return the value as a string, or `defaultValue` if absent or not a string.\n   */\n  getString(key: string, defaultValue: string | null = null): string | null {\n    const value = this._cache[key];\n    return typeof value === \"string\" ? value : defaultValue;\n  }\n\n  /**\n   * Return the value as a number, or `defaultValue` if absent or not a number.\n   */\n  getNumber(key: string, defaultValue: number | null = null): number | null {\n    const value = this._cache[key];\n    return typeof value === \"number\" ? value : defaultValue;\n  }\n\n  /**\n   * Return the value as a boolean, or `defaultValue` if absent or not a boolean.\n   */\n  getBool(key: string, defaultValue: boolean | null = null): boolean | null {\n    const value = this._cache[key];\n    return typeof value === \"boolean\" ? value : defaultValue;\n  }\n\n  /**\n   * Return whether `key` is present in the resolved configuration.\n   */\n  exists(key: string): boolean {\n    return key in this._cache;\n  }\n\n  /**\n   * Return a shallow copy of the full resolved configuration.\n   */\n  getAll(): Record<string, unknown> {\n    return { ...this._cache };\n  }\n\n  // ---- Change listeners ----\n\n  /**\n   * Register a listener that fires when a config value changes.\n   *\n   * @param callback - Called with a {@link ConfigChangeEvent} on each change.\n   * @param options.key - If provided, the listener fires only for this key.\n   *   If omitted, the listener fires for all changes.\n   */\n  onChange(callback: (event: ConfigChangeEvent) => void, options?: { key?: string }): void {\n    this._listeners.push({\n      callback,\n      key: options?.key ?? null,\n    });\n  }\n\n  // ---- Diagnostics ----\n\n  /**\n   * Return diagnostic statistics for this runtime.\n   */\n  stats(): ConfigStats {\n    return {\n      fetchCount: this._fetchCount,\n      lastFetchAt: this._lastFetchAt,\n    };\n  }\n\n  /**\n   * Return the current WebSocket connection status.\n   */\n  connectionStatus(): ConnectionStatus {\n    return this._wsStatus;\n  }\n\n  // ---- Lifecycle ----\n\n  /**\n   * Force a manual refresh of the cached configuration.\n   *\n   * Re-fetches the full config chain via HTTP, re-resolves values, updates\n   * the local cache, and fires listeners for any detected changes.\n   *\n   * @throws {Error} If no `fetchChain` function was provided on construction.\n   */\n  async refresh(): Promise<void> {\n    if (!this._fetchChain) {\n      throw new Error(\"No fetchChain function provided; cannot refresh.\");\n    }\n\n    const newChain = await this._fetchChain();\n    const oldCache = this._cache;\n\n    this._chain = newChain;\n    this._cache = resolveChain(newChain, this._environment);\n    this._fetchCount += newChain.length;\n    this._lastFetchAt = new Date().toISOString();\n\n    this._diffAndFire(oldCache, this._cache, \"manual\");\n  }\n\n  /**\n   * Close the runtime connection.\n   *\n   * Shuts down the WebSocket and cancels any pending reconnect timer.\n   * Safe to call multiple times.\n   */\n  async close(): Promise<void> {\n    this._closed = true;\n    this._wsStatus = \"disconnected\";\n\n    if (this._reconnectTimer !== null) {\n      clearTimeout(this._reconnectTimer);\n      this._reconnectTimer = null;\n    }\n\n    if (this._ws !== null) {\n      this._ws.close();\n      this._ws = null;\n    }\n  }\n\n  /**\n   * Async dispose support for `await using` (TypeScript 5.2+).\n   */\n  async [Symbol.asyncDispose](): Promise<void> {\n    await this.close();\n  }\n\n  // ---- WebSocket internals ----\n\n  private _buildWsUrl(): string {\n    let url = this._baseUrl;\n    if (url.startsWith(\"https://\")) {\n      url = \"wss://\" + url.slice(\"https://\".length);\n    } else if (url.startsWith(\"http://\")) {\n      url = \"ws://\" + url.slice(\"http://\".length);\n    } else {\n      url = \"wss://\" + url;\n    }\n    url = url.replace(/\\/$/, \"\");\n    return `${url}/api/ws/v1/configs?api_key=${this._apiKey}`;\n  }\n\n  private _connectWebSocket(): void {\n    if (this._closed) return;\n\n    this._wsStatus = \"connecting\";\n    const wsUrl = this._buildWsUrl();\n\n    try {\n      const ws = new WebSocket(wsUrl);\n      this._ws = ws;\n\n      ws.on(\"open\", () => {\n        if (this._closed) {\n          ws.close();\n          return;\n        }\n        this._backoffIndex = 0;\n        this._wsStatus = \"connected\";\n        ws.send(\n          JSON.stringify({\n            type: \"subscribe\",\n            config_id: this._configId,\n            environment: this._environment,\n          }),\n        );\n      });\n\n      ws.on(\"message\", (data: WebSocket.RawData) => {\n        try {\n          const msg = JSON.parse(String(data)) as WsMessage;\n          this._handleMessage(msg);\n        } catch {\n          // ignore unparseable messages\n        }\n      });\n\n      ws.on(\"close\", () => {\n        if (!this._closed) {\n          this._wsStatus = \"disconnected\";\n          this._scheduleReconnect();\n        }\n      });\n\n      ws.on(\"error\", () => {\n        // 'close' will fire after 'error'; reconnect is handled there\n      });\n    } catch {\n      if (!this._closed) {\n        this._scheduleReconnect();\n      }\n    }\n  }\n\n  private _scheduleReconnect(): void {\n    if (this._closed) return;\n\n    const delay = BACKOFF_MS[Math.min(this._backoffIndex, BACKOFF_MS.length - 1)];\n    this._backoffIndex++;\n    this._wsStatus = \"connecting\";\n\n    this._reconnectTimer = setTimeout(() => {\n      this._reconnectTimer = null;\n      // On reconnect, resync the cache to pick up changes missed while offline\n      if (this._fetchChain) {\n        this._fetchChain()\n          .then((newChain) => {\n            const oldCache = this._cache;\n            this._chain = newChain;\n            this._cache = resolveChain(newChain, this._environment);\n            this._fetchCount += newChain.length;\n            this._lastFetchAt = new Date().toISOString();\n            this._diffAndFire(oldCache, this._cache, \"manual\");\n          })\n          .catch(() => {\n            // ignore fetch errors during reconnect\n          })\n          .finally(() => {\n            this._connectWebSocket();\n          });\n      } else {\n        this._connectWebSocket();\n      }\n    }, delay);\n  }\n\n  private _handleMessage(msg: WsMessage): void {\n    if (msg.type === \"config_changed\") {\n      this._applyChanges(msg.config_id, msg.changes);\n    } else if (msg.type === \"config_deleted\") {\n      this._closed = true;\n      void this.close();\n    }\n  }\n\n  private _applyChanges(\n    configId: string,\n    changes: Array<{ key: string; old_value: unknown; new_value: unknown }>,\n  ): void {\n    const chainEntry = this._chain.find((c) => c.id === configId);\n    if (!chainEntry) return;\n\n    for (const change of changes) {\n      const { key, new_value } = change;\n\n      // Get or create the environment entry\n      const envEntry =\n        chainEntry.environments[this._environment] !== undefined &&\n        chainEntry.environments[this._environment] !== null\n          ? (chainEntry.environments[this._environment] as Record<string, unknown>)\n          : null;\n      const envValues =\n        envEntry !== null && typeof envEntry === \"object\"\n          ? ((envEntry.values ?? {}) as Record<string, unknown>)\n          : null;\n\n      if (new_value === null || new_value === undefined) {\n        // Deletion: remove from base values and env values\n        delete chainEntry.values[key];\n        if (envValues) delete envValues[key];\n      } else if (envValues && key in envValues) {\n        // Update existing env-specific override\n        envValues[key] = new_value;\n      } else if (key in chainEntry.values) {\n        // Update existing base value\n        chainEntry.values[key] = new_value;\n      } else {\n        // New key — put in base values\n        chainEntry.values[key] = new_value;\n      }\n    }\n\n    const oldCache = this._cache;\n    this._cache = resolveChain(this._chain, this._environment);\n    this._diffAndFire(oldCache, this._cache, \"websocket\");\n  }\n\n  private _diffAndFire(\n    oldCache: Record<string, unknown>,\n    newCache: Record<string, unknown>,\n    source: \"websocket\" | \"poll\" | \"manual\",\n  ): void {\n    const allKeys = new Set([...Object.keys(oldCache), ...Object.keys(newCache)]);\n\n    for (const key of allKeys) {\n      const oldVal = key in oldCache ? oldCache[key] : null;\n      const newVal = key in newCache ? newCache[key] : null;\n\n      if (JSON.stringify(oldVal) !== JSON.stringify(newVal)) {\n        const event: ConfigChangeEvent = { key, oldValue: oldVal, newValue: newVal, source };\n        this._fireListeners(event);\n      }\n    }\n  }\n\n  private _fireListeners(event: ConfigChangeEvent): void {\n    for (const listener of this._listeners) {\n      if (listener.key === null || listener.key === event.key) {\n        try {\n          listener.callback(event);\n        } catch {\n          // ignore listener errors to prevent one bad listener from stopping others\n        }\n      }\n    }\n  }\n}\n","/**\n * Deep-merge resolution algorithm for config inheritance chains.\n *\n * Mirrors the Python SDK's `_resolver.py` (ADR-024 §2.5–2.6).\n */\n\n/** A single entry in a config inheritance chain (child-to-root ordering). */\nexport interface ChainConfig {\n  /** Config UUID. */\n  id: string;\n  /** Base key-value pairs. */\n  values: Record<string, unknown>;\n  /**\n   * Per-environment overrides.\n   * Each entry is `{ values: { key: value, ... } }` — the server wraps\n   * environment-specific values in a nested `values` key.\n   */\n  environments: Record<string, unknown>;\n}\n\n/**\n * Recursively merge two dicts, with `override` taking precedence.\n *\n * Nested dicts are merged recursively. Non-dict values (strings, numbers,\n * booleans, arrays, null) are replaced wholesale.\n */\nexport function deepMerge(\n  base: Record<string, unknown>,\n  override: Record<string, unknown>,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = { ...base };\n  for (const [key, value] of Object.entries(override)) {\n    if (\n      key in result &&\n      typeof result[key] === \"object\" &&\n      result[key] !== null &&\n      !Array.isArray(result[key]) &&\n      typeof value === \"object\" &&\n      value !== null &&\n      !Array.isArray(value)\n    ) {\n      result[key] = deepMerge(\n        result[key] as Record<string, unknown>,\n        value as Record<string, unknown>,\n      );\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\n/**\n * Resolve the full configuration for an environment given a config chain.\n *\n * Walks from root (last element) to child (first element), accumulating\n * values via deep merge so that child configs override parent configs.\n *\n * For each config in the chain, base `values` are merged with\n * environment-specific values (env wins), then that result is merged\n * on top of the accumulated parent result (child wins over parent).\n *\n * @param chain - Ordered list of config data from child (index 0) to root ancestor (last).\n * @param environment - The environment key to resolve for.\n */\nexport function resolveChain(chain: ChainConfig[], environment: string): Record<string, unknown> {\n  let accumulated: Record<string, unknown> = {};\n\n  // Walk from root to child (reverse order — chain is child-to-root)\n  for (let i = chain.length - 1; i >= 0; i--) {\n    const config = chain[i];\n    const baseValues: Record<string, unknown> = config.values ?? {};\n\n    // Environments are stored as { env_name: { values: { key: val } } }\n    const envEntry = (config.environments ?? {})[environment];\n    const envValues: Record<string, unknown> =\n      envEntry !== null &&\n      envEntry !== undefined &&\n      typeof envEntry === \"object\" &&\n      !Array.isArray(envEntry)\n        ? (((envEntry as Record<string, unknown>).values ?? {}) as Record<string, unknown>)\n        : {};\n\n    // Merge environment overrides on top of base values (env wins)\n    const configResolved = deepMerge(baseValues, envValues);\n\n    // Merge this config's resolved values on top of accumulated parent values (child wins)\n    accumulated = deepMerge(accumulated, configResolved);\n  }\n\n  return accumulated;\n}\n"],"mappings":"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","names":[]}