@smplkit/sdk 1.0.0 → 1.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/resolve.ts","../src/config/runtime.ts","../src/index.ts","../src/config/client.ts","../src/errors.ts","../src/config/types.ts","../src/client.ts"],"sourcesContent":["/**\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","/**\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 * smplkit — Official TypeScript SDK for the smplkit platform.\n *\n * @packageDocumentation\n */\n\n// Main client\nexport { SmplkitClient } from \"./client.js\";\nexport type { SmplkitClientOptions } from \"./client.js\";\n\n// Config — management plane\nexport { ConfigClient } from \"./config/client.js\";\nexport type { CreateConfigOptions, GetConfigOptions } from \"./config/types.js\";\nexport { Config } from \"./config/types.js\";\n\n// Config — runtime plane\nexport { ConfigRuntime } from \"./config/runtime.js\";\nexport type {\n  ConfigChangeEvent,\n  ConfigStats,\n  ConnectionStatus,\n  ConnectOptions,\n} from \"./config/runtime-types.js\";\n\n// Error hierarchy\nexport {\n  SmplError,\n  SmplConnectionError,\n  SmplTimeoutError,\n  SmplNotFoundError,\n  SmplConflictError,\n  SmplValidationError,\n} from \"./errors.js\";\n","/**\n * ConfigClient — management-plane operations for configs.\n *\n * Uses the generated OpenAPI types (`src/generated/config.d.ts`) via\n * `openapi-fetch` for all HTTP calls, keeping the client layer fully\n * type-safe without hand-coded request/response shapes.\n */\n\nimport createClient from \"openapi-fetch\";\nimport type { components, operations } from \"../generated/config.d.ts\";\nimport {\n  SmplConflictError,\n  SmplNotFoundError,\n  SmplValidationError,\n  SmplError,\n  SmplConnectionError,\n  SmplTimeoutError,\n} from \"../errors.js\";\nimport { Config } from \"./types.js\";\nimport type { ConfigUpdatePayload, CreateConfigOptions, GetConfigOptions } from \"./types.js\";\n\nconst BASE_URL = \"https://config.smplkit.com\";\n\ntype ApiConfig = components[\"schemas\"][\"Config\"];\ntype ConfigResource = components[\"schemas\"][\"ConfigResource\"];\n\n/** @internal */\nfunction resourceToConfig(resource: ConfigResource, client: ConfigClient): Config {\n  const attrs: ApiConfig = resource.attributes;\n  return new Config(client, {\n    id: resource.id ?? \"\",\n    key: attrs.key ?? \"\",\n    name: attrs.name,\n    description: attrs.description ?? null,\n    parent: attrs.parent ?? null,\n    values: (attrs.values ?? {}) as Record<string, unknown>,\n    environments: (attrs.environments ?? {}) as Record<string, unknown>,\n    createdAt: attrs.created_at ? new Date(attrs.created_at) : null,\n    updatedAt: attrs.updated_at ? new Date(attrs.updated_at) : null,\n  });\n}\n\n/**\n * Map fetch or HTTP errors to typed SDK exceptions.\n * @internal\n */\nasync function checkError(response: Response, context: string): Promise<never> {\n  const body = await response.text().catch(() => \"\");\n  switch (response.status) {\n    case 404:\n      throw new SmplNotFoundError(body || context, 404, body);\n    case 409:\n      throw new SmplConflictError(body || context, 409, body);\n    case 422:\n      throw new SmplValidationError(body || context, 422, body);\n    default:\n      throw new SmplError(`HTTP ${response.status}: ${body}`, response.status, body);\n  }\n}\n\n/**\n * Re-raise fetch-level errors (network, timeout) as typed SDK exceptions.\n * @internal\n */\nfunction wrapFetchError(err: unknown): never {\n  if (\n    err instanceof SmplNotFoundError ||\n    err instanceof SmplConflictError ||\n    err instanceof SmplValidationError ||\n    err instanceof SmplError\n  ) {\n    throw err;\n  }\n  if (err instanceof TypeError) {\n    throw new SmplConnectionError(`Network error: ${err.message}`);\n  }\n  throw new SmplConnectionError(\n    `Request failed: ${err instanceof Error ? err.message : String(err)}`,\n  );\n}\n\n/**\n * Build a JSON:API request body for create/update operations.\n * @internal\n */\nfunction buildRequestBody(options: {\n  id?: string | null;\n  name: string;\n  key?: string | null;\n  description?: string | null;\n  parent?: string | null;\n  values?: Record<string, unknown> | null;\n  environments?: Record<string, unknown> | null;\n}): operations[\"create_config\"][\"requestBody\"][\"content\"][\"application/json\"] {\n  const attrs: ApiConfig = {\n    name: options.name,\n  };\n  if (options.key !== undefined) attrs.key = options.key;\n  if (options.description !== undefined) attrs.description = options.description;\n  if (options.parent !== undefined) attrs.parent = options.parent;\n  if (options.values !== undefined)\n    attrs.values = options.values as { [key: string]: unknown } | null;\n  if (options.environments !== undefined)\n    attrs.environments = options.environments as { [key: string]: unknown } | null;\n\n  return {\n    data: {\n      id: options.id ?? null,\n      type: \"config\",\n      attributes: attrs,\n    },\n  };\n}\n\n/**\n * Client for the smplkit Config API (management plane).\n *\n * All methods are async and return `Promise<T>`. Network and server\n * errors are mapped to typed SDK exceptions.\n *\n * Obtained via `SmplkitClient.config`.\n */\nexport class ConfigClient {\n  /** @internal — used by Config instances for reconnecting and WebSocket auth. */\n  readonly _apiKey: string;\n\n  /** @internal */\n  readonly _baseUrl: string = BASE_URL;\n\n  /** @internal */\n  private readonly _http: ReturnType<typeof createClient<import(\"../generated/config.d.ts\").paths>>;\n\n  /** @internal */\n  constructor(apiKey: string, timeout?: number) {\n    this._apiKey = apiKey;\n    const ms = timeout ?? 30_000;\n    this._http = createClient<import(\"../generated/config.d.ts\").paths>({\n      baseUrl: BASE_URL,\n      headers: {\n        Authorization: `Bearer ${apiKey}`,\n        Accept: \"application/json\",\n      },\n      // openapi-fetch custom fetch receives a pre-built Request object\n      fetch: async (request: Request): Promise<Response> => {\n        const controller = new AbortController();\n        const timer = setTimeout(() => controller.abort(), ms);\n        try {\n          return await fetch(new Request(request, { signal: controller.signal }));\n        } catch (err) {\n          if (err instanceof DOMException && err.name === \"AbortError\") {\n            throw new SmplTimeoutError(`Request timed out after ${ms}ms`);\n          }\n          throw err;\n        } finally {\n          clearTimeout(timer);\n        }\n      },\n    });\n  }\n\n  /**\n   * Fetch a single config by key or UUID.\n   *\n   * Exactly one of `key` or `id` must be provided.\n   *\n   * @throws {SmplNotFoundError} If no matching config exists.\n   */\n  async get(options: GetConfigOptions): Promise<Config> {\n    const { key, id } = options;\n    if ((key === undefined) === (id === undefined)) {\n      throw new Error(\"Exactly one of 'key' or 'id' must be provided.\");\n    }\n    return id !== undefined ? this._getById(id) : this._getByKey(key!);\n  }\n\n  /**\n   * List all configs for the account.\n   */\n  async list(): Promise<Config[]> {\n    let data: components[\"schemas\"][\"ConfigListResponse\"] | undefined;\n    try {\n      const result = await this._http.GET(\"/api/v1/configs\", {});\n      if (result.error !== undefined) await checkError(result.response, \"Failed to list configs\");\n      data = result.data;\n    } catch (err) {\n      wrapFetchError(err);\n    }\n    if (!data) return [];\n    return data.data.map((r) => resourceToConfig(r, this));\n  }\n\n  /**\n   * Create a new config.\n   *\n   * @throws {SmplValidationError} If the server rejects the request.\n   */\n  async create(options: CreateConfigOptions): Promise<Config> {\n    const body = buildRequestBody({\n      name: options.name,\n      key: options.key,\n      description: options.description,\n      parent: options.parent,\n      values: options.values,\n    });\n\n    let data: components[\"schemas\"][\"ConfigResponse\"] | undefined;\n    try {\n      const result = await this._http.POST(\"/api/v1/configs\", { body });\n      if (result.error !== undefined) await checkError(result.response, \"Failed to create config\");\n      data = result.data;\n    } catch (err) {\n      wrapFetchError(err);\n    }\n    if (!data || !data.data) throw new SmplValidationError(\"Failed to create config\");\n    return resourceToConfig(data.data, this);\n  }\n\n  /**\n   * Delete a config by UUID.\n   *\n   * @throws {SmplNotFoundError} If the config does not exist.\n   * @throws {SmplConflictError} If the config has child configs.\n   */\n  async delete(configId: string): Promise<void> {\n    try {\n      const result = await this._http.DELETE(\"/api/v1/configs/{id}\", {\n        params: { path: { id: configId } },\n      });\n      if (result.error !== undefined && result.response.status !== 204)\n        await checkError(result.response, `Failed to delete config ${configId}`);\n    } catch (err) {\n      wrapFetchError(err);\n    }\n  }\n\n  /**\n   * Internal: PUT a full config update and return the updated model.\n   *\n   * Called by {@link Config} instance methods.\n   * @internal\n   */\n  async _updateConfig(payload: ConfigUpdatePayload): Promise<Config> {\n    const body = buildRequestBody({\n      id: payload.configId,\n      name: payload.name,\n      key: payload.key,\n      description: payload.description,\n      parent: payload.parent,\n      values: payload.values,\n      environments: payload.environments,\n    });\n\n    let data: components[\"schemas\"][\"ConfigResponse\"] | undefined;\n    try {\n      const result = await this._http.PUT(\"/api/v1/configs/{id}\", {\n        params: { path: { id: payload.configId } },\n        body,\n      });\n      if (result.error !== undefined)\n        await checkError(result.response, `Failed to update config ${payload.configId}`);\n      data = result.data;\n    } catch (err) {\n      wrapFetchError(err);\n    }\n    if (!data || !data.data)\n      throw new SmplValidationError(`Failed to update config ${payload.configId}`);\n    return resourceToConfig(data.data, this);\n  }\n\n  // ---- Private helpers ----\n\n  private async _getById(configId: string): Promise<Config> {\n    let data: components[\"schemas\"][\"ConfigResponse\"] | undefined;\n    try {\n      const result = await this._http.GET(\"/api/v1/configs/{id}\", {\n        params: { path: { id: configId } },\n      });\n      if (result.error !== undefined)\n        await checkError(result.response, `Config ${configId} not found`);\n      data = result.data;\n    } catch (err) {\n      wrapFetchError(err);\n    }\n    if (!data || !data.data) throw new SmplNotFoundError(`Config ${configId} not found`);\n    return resourceToConfig(data.data, this);\n  }\n\n  private async _getByKey(key: string): Promise<Config> {\n    let data: components[\"schemas\"][\"ConfigListResponse\"] | undefined;\n    try {\n      const result = await this._http.GET(\"/api/v1/configs\", {\n        params: { query: { \"filter[key]\": key } },\n      });\n      if (result.error !== undefined)\n        await checkError(result.response, `Config with key '${key}' not found`);\n      data = result.data;\n    } catch (err) {\n      wrapFetchError(err);\n    }\n    if (!data || !data.data || data.data.length === 0) {\n      throw new SmplNotFoundError(`Config with key '${key}' not found`);\n    }\n    return resourceToConfig(data.data[0], this);\n  }\n}\n","/**\n * Structured SDK error types.\n *\n * All smplkit errors extend {@link SmplError}, allowing callers to catch\n * the base class for generic handling or specific subclasses for\n * fine-grained control.\n */\n\n/** Base exception for all smplkit SDK errors. */\nexport class SmplError extends Error {\n  /** The HTTP status code, if the error originated from an HTTP response. */\n  public readonly statusCode?: number;\n\n  /** The raw response body, if available. */\n  public readonly responseBody?: string;\n\n  constructor(message: string, statusCode?: number, responseBody?: string) {\n    super(message);\n    this.name = \"SmplError\";\n    this.statusCode = statusCode;\n    this.responseBody = responseBody;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Raised when a network request fails (e.g., DNS resolution, connection refused). */\nexport class SmplConnectionError extends SmplError {\n  constructor(message: string, statusCode?: number, responseBody?: string) {\n    super(message, statusCode, responseBody);\n    this.name = \"SmplConnectionError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Raised when an operation exceeds its timeout. */\nexport class SmplTimeoutError extends SmplError {\n  constructor(message: string, statusCode?: number, responseBody?: string) {\n    super(message, statusCode, responseBody);\n    this.name = \"SmplTimeoutError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Raised when a requested resource does not exist (HTTP 404). */\nexport class SmplNotFoundError extends SmplError {\n  constructor(message: string, statusCode?: number, responseBody?: string) {\n    super(message, statusCode ?? 404, responseBody);\n    this.name = \"SmplNotFoundError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Raised when an operation conflicts with current state (HTTP 409). */\nexport class SmplConflictError extends SmplError {\n  constructor(message: string, statusCode?: number, responseBody?: string) {\n    super(message, statusCode ?? 409, responseBody);\n    this.name = \"SmplConflictError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Raised when the server rejects a request due to validation errors (HTTP 422). */\nexport class SmplValidationError extends SmplError {\n  constructor(message: string, statusCode?: number, responseBody?: string) {\n    super(message, statusCode ?? 422, responseBody);\n    this.name = \"SmplValidationError\";\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","/**\n * Config resource — management-plane model with runtime connect support.\n *\n * Instances are returned by {@link ConfigClient} methods and provide\n * management-plane operations (`update`, `setValues`, `setValue`) as well\n * as the {@link connect} entry point for runtime value resolution.\n */\n\nimport type { ConfigRuntime } from \"./runtime.js\";\nimport type { ConnectOptions } from \"./runtime-types.js\";\n\n/**\n * Internal type used by {@link ConfigClient}.  Not part of the public API.\n * @internal\n */\nexport interface ConfigUpdatePayload {\n  configId: string;\n  name: string;\n  key: string | null;\n  description: string | null;\n  parent: string | null;\n  values: Record<string, unknown>;\n  environments: Record<string, unknown>;\n}\n\n/**\n * A configuration resource fetched from the smplkit Config service.\n *\n * Instances are returned by {@link ConfigClient} methods and provide\n * management-plane operations as well as the {@link connect} entry point\n * for runtime value resolution.\n */\nexport class Config {\n  /** UUID of the config. */\n  id: string;\n\n  /** Human-readable key (e.g. `\"user_service\"`). */\n  key: string;\n\n  /** Display name. */\n  name: string;\n\n  /** Optional description. */\n  description: string | null;\n\n  /** Parent config UUID, or null if this is a root config. */\n  parent: string | null;\n\n  /** Base key-value pairs. */\n  values: Record<string, unknown>;\n\n  /**\n   * Per-environment overrides.\n   * Stored as `{ env_name: { values: { key: value } } }` to match the\n   * server's format.\n   */\n  environments: Record<string, unknown>;\n\n  /** When the config was created, or null if unavailable. */\n  createdAt: Date | null;\n\n  /** When the config was last updated, or null if unavailable. */\n  updatedAt: Date | null;\n\n  /**\n   * Internal reference to the parent client.\n   * @internal\n   */\n  private readonly _client: {\n    _updateConfig(payload: ConfigUpdatePayload): Promise<Config>;\n    get(options: { id: string }): Promise<Config>;\n    readonly _apiKey: string;\n    readonly _baseUrl: string;\n  };\n\n  /** @internal */\n  constructor(\n    client: {\n      _updateConfig(payload: ConfigUpdatePayload): Promise<Config>;\n      get(options: { id: string }): Promise<Config>;\n      readonly _apiKey: string;\n      readonly _baseUrl: string;\n    },\n    fields: {\n      id: string;\n      key: string;\n      name: string;\n      description: string | null;\n      parent: string | null;\n      values: Record<string, unknown>;\n      environments: Record<string, unknown>;\n      createdAt: Date | null;\n      updatedAt: Date | null;\n    },\n  ) {\n    this._client = client;\n    this.id = fields.id;\n    this.key = fields.key;\n    this.name = fields.name;\n    this.description = fields.description;\n    this.parent = fields.parent;\n    this.values = fields.values;\n    this.environments = fields.environments;\n    this.createdAt = fields.createdAt;\n    this.updatedAt = fields.updatedAt;\n  }\n\n  /**\n   * Update this config's attributes on the server.\n   *\n   * Builds the request from current attribute values, overriding with any\n   * provided options. Updates local attributes in place on success.\n   *\n   * @param options.name - New display name.\n   * @param options.description - New description (pass empty string to clear).\n   * @param options.values - New base values (replaces entirely).\n   * @param options.environments - New environments dict (replaces entirely).\n   */\n  async update(options: {\n    name?: string;\n    description?: string;\n    values?: Record<string, unknown>;\n    environments?: Record<string, unknown>;\n  }): Promise<void> {\n    const updated = await this._client._updateConfig({\n      configId: this.id,\n      name: options.name ?? this.name,\n      key: this.key,\n      description: options.description !== undefined ? options.description : this.description,\n      parent: this.parent,\n      values: options.values ?? this.values,\n      environments: options.environments ?? this.environments,\n    });\n    this.name = updated.name;\n    this.description = updated.description;\n    this.values = updated.values;\n    this.environments = updated.environments;\n    this.updatedAt = updated.updatedAt;\n  }\n\n  /**\n   * Replace base or environment-specific values.\n   *\n   * When `environment` is provided, replaces that environment's `values`\n   * sub-dict (other environments are preserved). When omitted, replaces\n   * the base `values`.\n   *\n   * @param values - The complete set of values to set.\n   * @param environment - Target environment, or omit for base values.\n   */\n  async setValues(values: Record<string, unknown>, environment?: string): Promise<void> {\n    let newValues: Record<string, unknown>;\n    let newEnvs: Record<string, unknown>;\n\n    if (environment === undefined) {\n      newValues = values;\n      newEnvs = this.environments;\n    } else {\n      newValues = this.values;\n      // Preserve any extra metadata on the environment entry (like other sub-keys),\n      // but replace the `values` sub-dict entirely.\n      const existingEntry =\n        typeof this.environments[environment] === \"object\" &&\n        this.environments[environment] !== null\n          ? { ...(this.environments[environment] as Record<string, unknown>) }\n          : {};\n      existingEntry.values = values;\n      newEnvs = { ...this.environments, [environment]: existingEntry };\n    }\n\n    const updated = await this._client._updateConfig({\n      configId: this.id,\n      name: this.name,\n      key: this.key,\n      description: this.description,\n      parent: this.parent,\n      values: newValues,\n      environments: newEnvs,\n    });\n    this.values = updated.values;\n    this.environments = updated.environments;\n    this.updatedAt = updated.updatedAt;\n  }\n\n  /**\n   * Set a single key within base or environment-specific values.\n   *\n   * Merges the key into existing values rather than replacing all values.\n   *\n   * @param key - The config key to set.\n   * @param value - The value to assign.\n   * @param environment - Target environment, or omit for base values.\n   */\n  async setValue(key: string, value: unknown, environment?: string): Promise<void> {\n    if (environment === undefined) {\n      const merged = { ...this.values, [key]: value };\n      await this.setValues(merged);\n    } else {\n      const envEntry =\n        typeof this.environments[environment] === \"object\" &&\n        this.environments[environment] !== null\n          ? (this.environments[environment] as Record<string, unknown>)\n          : {};\n      const existing = {\n        ...(typeof envEntry.values === \"object\" && envEntry.values !== null\n          ? (envEntry.values as Record<string, unknown>)\n          : {}),\n      };\n      existing[key] = value;\n      await this.setValues(existing, environment);\n    }\n  }\n\n  /**\n   * Connect to this config for runtime value resolution.\n   *\n   * Eagerly fetches this config and its full parent chain, resolves values\n   * for the given environment via deep merge, and returns a\n   * {@link ConfigRuntime} with a fully populated local cache.\n   *\n   * A background WebSocket connection is started for real-time updates.\n   * If the WebSocket fails to connect, the runtime operates in cache-only\n   * mode and reconnects automatically.\n   *\n   * Supports both `await` and `await using` (TypeScript 5.2+)::\n   *\n   * ```typescript\n   * // Simple await\n   * const runtime = await config.connect(\"production\");\n   * try { ... } finally { await runtime.close(); }\n   *\n   * // await using (auto-close)\n   * await using runtime = await config.connect(\"production\");\n   * ```\n   *\n   * @param environment - The environment to resolve for (e.g. `\"production\"`).\n   * @param options.timeout - Milliseconds to wait for the initial fetch.\n   */\n  async connect(environment: string, options?: ConnectOptions): Promise<ConfigRuntime> {\n    // Lazy import to avoid loading ws at module-init time\n    const { ConfigRuntime } = await import(\"./runtime.js\");\n\n    const timeout = options?.timeout ?? 30_000;\n    const chain = await this._buildChain(timeout);\n\n    return new ConfigRuntime({\n      configKey: this.key,\n      configId: this.id,\n      environment,\n      chain,\n      apiKey: this._client._apiKey,\n      baseUrl: this._client._baseUrl,\n      fetchChain: () => this._buildChain(timeout),\n    });\n  }\n\n  /**\n   * Walk the parent chain and return config data objects, child-to-root.\n   * @internal\n   */\n  private async _buildChain(\n    _timeout: number,\n  ): Promise<\n    Array<{ id: string; values: Record<string, unknown>; environments: Record<string, unknown> }>\n  > {\n    const chain: Array<{\n      id: string;\n      values: Record<string, unknown>;\n      environments: Record<string, unknown>;\n    }> = [{ id: this.id, values: this.values, environments: this.environments }];\n\n    let parentId = this.parent;\n    while (parentId !== null) {\n      const parentConfig = await this._client.get({ id: parentId });\n      chain.push({\n        id: parentConfig.id,\n        values: parentConfig.values,\n        environments: parentConfig.environments,\n      });\n      parentId = parentConfig.parent;\n    }\n\n    return chain;\n  }\n\n  toString(): string {\n    return `Config(id=${this.id}, key=${this.key}, name=${this.name})`;\n  }\n}\n\n/** Options for creating a new config. */\nexport interface CreateConfigOptions {\n  /** Display name for the config. */\n  name: string;\n  /** Human-readable key. Auto-generated by the server if omitted. */\n  key?: string;\n  /** Optional description. */\n  description?: string;\n  /** Parent config UUID. Defaults to the account's `common` config if omitted. */\n  parent?: string;\n  /** Initial base values. */\n  values?: Record<string, unknown>;\n}\n\n/** Options for fetching a single config. Exactly one of `key` or `id` must be provided. */\nexport interface GetConfigOptions {\n  /** Fetch by human-readable key. */\n  key?: string;\n  /** Fetch by UUID. */\n  id?: string;\n}\n","/**\n * Top-level SDK client — SmplkitClient.\n *\n * The main entry point for the smplkit TypeScript SDK. Provides access\n * to sub-clients for each API domain (config, flags, logging, etc.).\n */\n\nimport { ConfigClient } from \"./config/client.js\";\n\n/** Configuration options for the {@link SmplkitClient}. */\nexport interface SmplkitClientOptions {\n  /** API key for authenticating with the smplkit platform. */\n  apiKey: string;\n\n  /**\n   * Request timeout in milliseconds.\n   * @default 30000\n   */\n  timeout?: number;\n}\n\n/**\n * Entry point for the smplkit TypeScript SDK.\n *\n * @example\n * ```typescript\n * import { SmplkitClient } from \"@smplkit/sdk\";\n *\n * const client = new SmplkitClient({ apiKey: \"sk_api_...\" });\n * const cfg = await client.config.get({ key: \"common\" });\n * ```\n */\nexport class SmplkitClient {\n  /** Client for config management-plane operations. */\n  readonly config: ConfigClient;\n\n  constructor(options: SmplkitClientOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"apiKey is required\");\n    }\n\n    this.config = new ConfigClient(options.apiKey, options.timeout);\n  }\n}\n"],"mappings":"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","names":["WebSocket","ConfigRuntime","createClient"]}

package/dist/index.d.cts

@@ -0,0 +1,476 @@
+/**
+ * Deep-merge resolution algorithm for config inheritance chains.
+ *
+ * Mirrors the Python SDK's `_resolver.py` (ADR-024 §2.5–2.6).
+ */
+/** A single entry in a config inheritance chain (child-to-root ordering). */
+interface ChainConfig {
+    /** Config UUID. */
+    id: string;
+    /** Base key-value pairs. */
+    values: Record<string, unknown>;
+    /**
+     * Per-environment overrides.
+     * Each entry is `{ values: { key: value, ... } }` — the server wraps
+     * environment-specific values in a nested `values` key.
+     */
+    environments: Record<string, unknown>;
+}
+
+/**
+ * Types for the config runtime plane.
+ */
+/** Describes a single value change pushed by the server or detected on refresh. */
+interface ConfigChangeEvent {
+    /** The config key that changed. */
+    key: string;
+    /** The previous value (null if the key was absent). */
+    oldValue: unknown;
+    /** The updated value (null if the key was removed). */
+    newValue: unknown;
+    /** How the change was delivered. */
+    source: "websocket" | "poll" | "manual";
+}
+/** Diagnostic statistics for a {@link ConfigRuntime} instance. */
+interface ConfigStats {
+    /**
+     * Total number of HTTP fetches performed, including the initial connect
+     * and any reconnection re-syncs or manual refreshes. Incremented by the
+     * chain length (number of configs fetched) on each fetch.
+     */
+    fetchCount: number;
+    /** ISO-8601 timestamp of the most recent fetch, or null if none yet. */
+    lastFetchAt: string | null;
+}
+/** WebSocket connection status. */
+type ConnectionStatus = "connected" | "connecting" | "disconnected";
+/** Options for {@link Config.connect}. */
+interface ConnectOptions {
+    /**
+     * Maximum milliseconds to wait for the initial fetch.
+     * @default 30000
+     */
+    timeout?: number;
+}
+
+/**
+ * ConfigRuntime — runtime-plane value resolution with WebSocket updates.
+ *
+ * Holds a fully resolved local cache of config values for a specific
+ * environment.  All value-access methods are synchronous (local reads);
+ * only {@link refresh} and {@link close} are async.
+ *
+ * A background WebSocket connection is maintained for real-time updates.
+ * If the WebSocket fails, the runtime operates in cache-only mode and
+ * reconnects automatically with exponential backoff.
+ */
+
+/** @internal Options for constructing a ConfigRuntime. */
+interface ConfigRuntimeOptions {
+    configKey: string;
+    configId: string;
+    environment: string;
+    chain: ChainConfig[];
+    apiKey: string;
+    baseUrl: string;
+    fetchChain: (() => Promise<ChainConfig[]>) | null;
+}
+/**
+ * Runtime configuration handle for a specific environment.
+ *
+ * Obtained by calling {@link Config.connect}.  All value-access methods
+ * are synchronous and served entirely from a local in-process cache.
+ * The cache is populated eagerly on construction and kept current via
+ * a background WebSocket connection.
+ */
+declare class ConfigRuntime {
+    private _cache;
+    private _chain;
+    private _fetchCount;
+    private _lastFetchAt;
+    private _closed;
+    private _wsStatus;
+    private _ws;
+    private _reconnectTimer;
+    private _backoffIndex;
+    private _listeners;
+    private readonly _configId;
+    private readonly _environment;
+    private readonly _apiKey;
+    private readonly _baseUrl;
+    private readonly _fetchChain;
+    /** @internal */
+    constructor(options: ConfigRuntimeOptions);
+    /**
+     * 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: string, defaultValue?: unknown): unknown;
+    /**
+     * Return the value as a string, or `defaultValue` if absent or not a string.
+     */
+    getString(key: string, defaultValue?: string | null): string | null;
+    /**
+     * Return the value as a number, or `defaultValue` if absent or not a number.
+     */
+    getNumber(key: string, defaultValue?: number | null): number | null;
+    /**
+     * Return the value as a boolean, or `defaultValue` if absent or not a boolean.
+     */
+    getBool(key: string, defaultValue?: boolean | null): boolean | null;
+    /**
+     * Return whether `key` is present in the resolved configuration.
+     */
+    exists(key: string): boolean;
+    /**
+     * Return a shallow copy of the full resolved configuration.
+     */
+    getAll(): Record<string, unknown>;
+    /**
+     * 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: (event: ConfigChangeEvent) => void, options?: {
+        key?: string;
+    }): void;
+    /**
+     * Return diagnostic statistics for this runtime.
+     */
+    stats(): ConfigStats;
+    /**
+     * Return the current WebSocket connection status.
+     */
+    connectionStatus(): ConnectionStatus;
+    /**
+     * 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.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Close the runtime connection.
+     *
+     * Shuts down the WebSocket and cancels any pending reconnect timer.
+     * Safe to call multiple times.
+     */
+    close(): Promise<void>;
+    /**
+     * Async dispose support for `await using` (TypeScript 5.2+).
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    private _buildWsUrl;
+    private _connectWebSocket;
+    private _scheduleReconnect;
+    private _handleMessage;
+    private _applyChanges;
+    private _diffAndFire;
+    private _fireListeners;
+}
+
+/**
+ * Config resource — management-plane model with runtime connect support.
+ *
+ * Instances are returned by {@link ConfigClient} methods and provide
+ * management-plane operations (`update`, `setValues`, `setValue`) as well
+ * as the {@link connect} entry point for runtime value resolution.
+ */
+
+/**
+ * Internal type used by {@link ConfigClient}.  Not part of the public API.
+ * @internal
+ */
+interface ConfigUpdatePayload {
+    configId: string;
+    name: string;
+    key: string | null;
+    description: string | null;
+    parent: string | null;
+    values: Record<string, unknown>;
+    environments: Record<string, unknown>;
+}
+/**
+ * A configuration resource fetched from the smplkit Config service.
+ *
+ * Instances are returned by {@link ConfigClient} methods and provide
+ * management-plane operations as well as the {@link connect} entry point
+ * for runtime value resolution.
+ */
+declare class Config {
+    /** UUID of the config. */
+    id: string;
+    /** Human-readable key (e.g. `"user_service"`). */
+    key: string;
+    /** Display name. */
+    name: string;
+    /** Optional description. */
+    description: string | null;
+    /** Parent config UUID, or null if this is a root config. */
+    parent: string | null;
+    /** Base key-value pairs. */
+    values: Record<string, unknown>;
+    /**
+     * Per-environment overrides.
+     * Stored as `{ env_name: { values: { key: value } } }` to match the
+     * server's format.
+     */
+    environments: Record<string, unknown>;
+    /** When the config was created, or null if unavailable. */
+    createdAt: Date | null;
+    /** When the config was last updated, or null if unavailable. */
+    updatedAt: Date | null;
+    /**
+     * Internal reference to the parent client.
+     * @internal
+     */
+    private readonly _client;
+    /** @internal */
+    constructor(client: {
+        _updateConfig(payload: ConfigUpdatePayload): Promise<Config>;
+        get(options: {
+            id: string;
+        }): Promise<Config>;
+        readonly _apiKey: string;
+        readonly _baseUrl: string;
+    }, fields: {
+        id: string;
+        key: string;
+        name: string;
+        description: string | null;
+        parent: string | null;
+        values: Record<string, unknown>;
+        environments: Record<string, unknown>;
+        createdAt: Date | null;
+        updatedAt: Date | null;
+    });
+    /**
+     * Update this config's attributes on the server.
+     *
+     * Builds the request from current attribute values, overriding with any
+     * provided options. Updates local attributes in place on success.
+     *
+     * @param options.name - New display name.
+     * @param options.description - New description (pass empty string to clear).
+     * @param options.values - New base values (replaces entirely).
+     * @param options.environments - New environments dict (replaces entirely).
+     */
+    update(options: {
+        name?: string;
+        description?: string;
+        values?: Record<string, unknown>;
+        environments?: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Replace base or environment-specific values.
+     *
+     * When `environment` is provided, replaces that environment's `values`
+     * sub-dict (other environments are preserved). When omitted, replaces
+     * the base `values`.
+     *
+     * @param values - The complete set of values to set.
+     * @param environment - Target environment, or omit for base values.
+     */
+    setValues(values: Record<string, unknown>, environment?: string): Promise<void>;
+    /**
+     * Set a single key within base or environment-specific values.
+     *
+     * Merges the key into existing values rather than replacing all values.
+     *
+     * @param key - The config key to set.
+     * @param value - The value to assign.
+     * @param environment - Target environment, or omit for base values.
+     */
+    setValue(key: string, value: unknown, environment?: string): Promise<void>;
+    /**
+     * Connect to this config for runtime value resolution.
+     *
+     * Eagerly fetches this config and its full parent chain, resolves values
+     * for the given environment via deep merge, and returns a
+     * {@link ConfigRuntime} with a fully populated local cache.
+     *
+     * A background WebSocket connection is started for real-time updates.
+     * If the WebSocket fails to connect, the runtime operates in cache-only
+     * mode and reconnects automatically.
+     *
+     * Supports both `await` and `await using` (TypeScript 5.2+)::
+     *
+     * ```typescript
+     * // Simple await
+     * const runtime = await config.connect("production");
+     * try { ... } finally { await runtime.close(); }
+     *
+     * // await using (auto-close)
+     * await using runtime = await config.connect("production");
+     * ```
+     *
+     * @param environment - The environment to resolve for (e.g. `"production"`).
+     * @param options.timeout - Milliseconds to wait for the initial fetch.
+     */
+    connect(environment: string, options?: ConnectOptions): Promise<ConfigRuntime>;
+    /**
+     * Walk the parent chain and return config data objects, child-to-root.
+     * @internal
+     */
+    private _buildChain;
+    toString(): string;
+}
+/** Options for creating a new config. */
+interface CreateConfigOptions {
+    /** Display name for the config. */
+    name: string;
+    /** Human-readable key. Auto-generated by the server if omitted. */
+    key?: string;
+    /** Optional description. */
+    description?: string;
+    /** Parent config UUID. Defaults to the account's `common` config if omitted. */
+    parent?: string;
+    /** Initial base values. */
+    values?: Record<string, unknown>;
+}
+/** Options for fetching a single config. Exactly one of `key` or `id` must be provided. */
+interface GetConfigOptions {
+    /** Fetch by human-readable key. */
+    key?: string;
+    /** Fetch by UUID. */
+    id?: string;
+}
+
+/**
+ * ConfigClient — management-plane operations for configs.
+ *
+ * Uses the generated OpenAPI types (`src/generated/config.d.ts`) via
+ * `openapi-fetch` for all HTTP calls, keeping the client layer fully
+ * type-safe without hand-coded request/response shapes.
+ */
+
+/**
+ * Client for the smplkit Config API (management plane).
+ *
+ * All methods are async and return `Promise<T>`. Network and server
+ * errors are mapped to typed SDK exceptions.
+ *
+ * Obtained via `SmplkitClient.config`.
+ */
+declare class ConfigClient {
+    /** @internal — used by Config instances for reconnecting and WebSocket auth. */
+    readonly _apiKey: string;
+    /** @internal */
+    readonly _baseUrl: string;
+    /** @internal */
+    private readonly _http;
+    /** @internal */
+    constructor(apiKey: string, timeout?: number);
+    /**
+     * Fetch a single config by key or UUID.
+     *
+     * Exactly one of `key` or `id` must be provided.
+     *
+     * @throws {SmplNotFoundError} If no matching config exists.
+     */
+    get(options: GetConfigOptions): Promise<Config>;
+    /**
+     * List all configs for the account.
+     */
+    list(): Promise<Config[]>;
+    /**
+     * Create a new config.
+     *
+     * @throws {SmplValidationError} If the server rejects the request.
+     */
+    create(options: CreateConfigOptions): Promise<Config>;
+    /**
+     * Delete a config by UUID.
+     *
+     * @throws {SmplNotFoundError} If the config does not exist.
+     * @throws {SmplConflictError} If the config has child configs.
+     */
+    delete(configId: string): Promise<void>;
+    /**
+     * Internal: PUT a full config update and return the updated model.
+     *
+     * Called by {@link Config} instance methods.
+     * @internal
+     */
+    _updateConfig(payload: ConfigUpdatePayload): Promise<Config>;
+    private _getById;
+    private _getByKey;
+}
+
+/**
+ * Top-level SDK client — SmplkitClient.
+ *
+ * The main entry point for the smplkit TypeScript SDK. Provides access
+ * to sub-clients for each API domain (config, flags, logging, etc.).
+ */
+
+/** Configuration options for the {@link SmplkitClient}. */
+interface SmplkitClientOptions {
+    /** API key for authenticating with the smplkit platform. */
+    apiKey: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+}
+/**
+ * Entry point for the smplkit TypeScript SDK.
+ *
+ * @example
+ * ```typescript
+ * import { SmplkitClient } from "@smplkit/sdk";
+ *
+ * const client = new SmplkitClient({ apiKey: "sk_api_..." });
+ * const cfg = await client.config.get({ key: "common" });
+ * ```
+ */
+declare class SmplkitClient {
+    /** Client for config management-plane operations. */
+    readonly config: ConfigClient;
+    constructor(options: SmplkitClientOptions);
+}
+
+/**
+ * Structured SDK error types.
+ *
+ * All smplkit errors extend {@link SmplError}, allowing callers to catch
+ * the base class for generic handling or specific subclasses for
+ * fine-grained control.
+ */
+/** Base exception for all smplkit SDK errors. */
+declare class SmplError extends Error {
+    /** The HTTP status code, if the error originated from an HTTP response. */
+    readonly statusCode?: number;
+    /** The raw response body, if available. */
+    readonly responseBody?: string;
+    constructor(message: string, statusCode?: number, responseBody?: string);
+}
+/** Raised when a network request fails (e.g., DNS resolution, connection refused). */
+declare class SmplConnectionError extends SmplError {
+    constructor(message: string, statusCode?: number, responseBody?: string);
+}
+/** Raised when an operation exceeds its timeout. */
+declare class SmplTimeoutError extends SmplError {
+    constructor(message: string, statusCode?: number, responseBody?: string);
+}
+/** Raised when a requested resource does not exist (HTTP 404). */
+declare class SmplNotFoundError extends SmplError {
+    constructor(message: string, statusCode?: number, responseBody?: string);
+}
+/** Raised when an operation conflicts with current state (HTTP 409). */
+declare class SmplConflictError extends SmplError {
+    constructor(message: string, statusCode?: number, responseBody?: string);
+}
+/** Raised when the server rejects a request due to validation errors (HTTP 422). */
+declare class SmplValidationError extends SmplError {
+    constructor(message: string, statusCode?: number, responseBody?: string);
+}
+
+export { Config, type ConfigChangeEvent, ConfigClient, ConfigRuntime, type ConfigStats, type ConnectOptions, type ConnectionStatus, type CreateConfigOptions, type GetConfigOptions, SmplConflictError, SmplConnectionError, SmplError, SmplNotFoundError, SmplTimeoutError, SmplValidationError, SmplkitClient, type SmplkitClientOptions };