@smplkit/sdk 1.3.27 → 1.3.28

package/dist/index.d.ts

@@ -79,15 +79,13 @@ declare class SharedWebSocket {
  * Creates if new, updates if existing.
  */
 declare class Config {
-    /** UUID of the config, or `null` if unsaved. */
+    /** Unique identifier (slug, e.g. `"user-service"`). */
     id: string | null;
-    /** 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 config id (slug), or null if this is a root config. */
     parent: string | null;
     /** Base key-value pairs. */
     items: Record<string, unknown>;
@@ -105,7 +103,6 @@ declare class Config {
     /** @internal */
     constructor(client: ConfigClient, fields: {
         id: string | null;
-        key: string;
         name: string;
         description: string | null;
         parent: string | null;
@@ -168,8 +165,8 @@ declare class LiveConfigProxy<T = Record<string, unknown>> {
 
 /** Describes a single config value change detected on refresh. */
 interface ConfigChangeEvent {
-    /** The config key that changed. */
-    configKey: string;
+    /** The config id that changed. */
+    configId: string;
     /** The item key within the config that changed. */
     itemKey: string;
     /** The previous value (null if the key was absent). */
@@ -205,45 +202,45 @@ declare class ConfigClient {
     /** @internal */
     constructor(apiKey: string, timeout?: number);
     /** Create an unsaved config. Call `.save()` to persist. */
-    new(key: string, options?: {
+    new(id: string, options?: {
         name?: string;
         description?: string;
         parent?: string;
     }): Config;
-    /** Fetch a config by key. */
-    get(key: string): Promise<Config>;
+    /** Fetch a config by id. */
+    get(id: string): Promise<Config>;
     /** List all configs. */
     list(): Promise<Config[]>;
-    /** Delete a config by key. */
-    delete(key: string): Promise<void>;
+    /** Delete a config by id. */
+    delete(id: string): Promise<void>;
     /** @internal — POST a new config. */
     _createConfig(config: Config): Promise<Config>;
     /** @internal — PUT a config update. */
     _updateConfig(config: Config): Promise<Config>;
-    /** @internal — fetch a config by UUID. */
-    _getById(configId: string): Promise<Config>;
+    /** @internal — fetch a config by id. */
+    _getById(id: string): Promise<Config>;
     /**
      * Resolve a config's values for the current environment.
      *
      * Returns the resolved key-value pairs for the given config.
      * Optionally pass a model class to map the resolved values.
      */
-    resolve<T = Record<string, unknown>>(key: string, model?: new (data: any) => T): Promise<T>;
+    resolve<T = Record<string, unknown>>(id: string, model?: new (data: any) => T): Promise<T>;
     /**
      * Subscribe to a config's values. Returns a proxy whose properties
      * always reflect the latest resolved values.
      *
      * Optionally pass a model class to map the resolved values.
      */
-    subscribe<T = Record<string, unknown>>(key: string, model?: new (data: any) => T): Promise<LiveConfigProxy<T>>;
+    subscribe<T = Record<string, unknown>>(id: string, model?: new (data: any) => T): Promise<LiveConfigProxy<T>>;
     /**
      * Register a change listener.
      *
      * - `onChange(callback)` — fires for any config change (global).
-     * - `onChange(configKey, callback)` — fires for changes to a specific config.
-     * - `onChange(configKey, itemKey, callback)` — fires for a specific item.
+     * - `onChange(configId, callback)` — fires for changes to a specific config.
+     * - `onChange(configId, itemKey, callback)` — fires for a specific item.
      */
-    onChange(callbackOrConfigKey: string | ((event: ConfigChangeEvent) => void), callbackOrItemKey?: string | ((event: ConfigChangeEvent) => void), callback?: (event: ConfigChangeEvent) => void): void;
+    onChange(callbackOrConfigId: string | ((event: ConfigChangeEvent) => void), callbackOrItemKey?: string | ((event: ConfigChangeEvent) => void), callback?: (event: ConfigChangeEvent) => void): void;
     /**
      * Refresh all config values from the server.
      * Fires change listeners for any values that changed.
@@ -258,7 +255,6 @@ declare class ConfigClient {
     private _handleConfigChanged;
     /** @internal */
     private _diffAndFire;
-    private _getByKey;
 }
 
 interface components {
@@ -291,7 +287,6 @@ interface components {
          *           "rules": []
          *         }
          *       },
-         *       "key": "dark_mode",
          *       "name": "Dark Mode",
          *       "type": "BOOLEAN",
          *       "updated_at": "2026-03-27T10:00:00Z",
@@ -308,11 +303,8 @@ interface components {
          *     }
          */
         Flag: {
-            /**
-             * Key
-             * @description Unique key within account
-             */
-            key: string;
+            /** Id */
+            id?: string | null;
             /**
              * Name
              * @description Human-readable display name
@@ -388,7 +380,6 @@ interface components {
          *             ]
          *           }
          *         },
-         *         "key": "dark_mode",
          *         "name": "Dark Mode",
          *         "type": "BOOLEAN",
          *         "updated_at": "2026-03-27T10:00:00Z",
@@ -403,7 +394,7 @@ interface components {
          *           }
          *         ]
          *       },
-         *       "id": "550e8400-e29b-41d4-a716-446655440000",
+         *       "id": "dark_mode",
          *       "type": "flag"
          *     }
          */
@@ -542,10 +533,8 @@ declare class Rule {
  * Call `save()` to persist changes. Call `get()` to evaluate the flag.
  */
 declare class Flag {
-    /** UUID of the flag, or `null` if unsaved. */
+    /** Unique identifier (slug) within the account. */
     id: string | null;
-    /** Unique key within the account. */
-    key: string;
     /** Human-readable display name. */
     name: string;
     /** Value type: BOOLEAN, STRING, NUMERIC, or JSON. */
@@ -570,7 +559,6 @@ declare class Flag {
     /** @internal */
     constructor(client: FlagsClient, fields: {
         id: string | null;
-        key: string;
         name: string;
         type: string;
         default: unknown;
@@ -649,9 +637,9 @@ declare class JsonFlag extends Flag {
 type FlagResource = components["schemas"]["FlagResource"];
 /** Describes a flag definition change. */
 declare class FlagChangeEvent {
-    readonly key: string;
+    readonly id: string;
     readonly source: string;
-    constructor(key: string, source: string);
+    constructor(id: string, source: string);
 }
 /** Evaluation statistics for the flags runtime. */
 declare class FlagStats {
@@ -693,13 +681,13 @@ declare class FlagsClient {
     /** @internal */
     constructor(apiKey: string, ensureWs: () => SharedWebSocket, timeout?: number);
     /** Create an unsaved boolean flag. Call `.save()` to persist. */
-    newBooleanFlag(key: string, options: {
+    newBooleanFlag(id: string, options: {
         default: boolean;
         name?: string;
         description?: string;
     }): BooleanFlag;
     /** Create an unsaved string flag. Call `.save()` to persist. */
-    newStringFlag(key: string, options: {
+    newStringFlag(id: string, options: {
         default: string;
         name?: string;
         description?: string;
@@ -709,7 +697,7 @@ declare class FlagsClient {
         }>;
     }): StringFlag;
     /** Create an unsaved number flag. Call `.save()` to persist. */
-    newNumberFlag(key: string, options: {
+    newNumberFlag(id: string, options: {
         default: number;
         name?: string;
         description?: string;
@@ -719,7 +707,7 @@ declare class FlagsClient {
         }>;
     }): NumberFlag;
     /** Create an unsaved JSON flag. Call `.save()` to persist. */
-    newJsonFlag(key: string, options: {
+    newJsonFlag(id: string, options: {
         default: Record<string, any>;
         name?: string;
         description?: string;
@@ -728,24 +716,24 @@ declare class FlagsClient {
             value: unknown;
         }>;
     }): JsonFlag;
-    /** Fetch a flag by key. */
-    get(key: string): Promise<Flag>;
+    /** Fetch a flag by id. */
+    get(id: string): Promise<Flag>;
     /** List all flags. */
     list(): Promise<Flag[]>;
-    /** Delete a flag by key. */
-    delete(key: string): Promise<void>;
+    /** Delete a flag by id. */
+    delete(id: string): Promise<void>;
     /** @internal — POST a new flag. */
     _createFlag(flag: Flag): Promise<Flag>;
     /** @internal — PUT a flag update. */
     _updateFlag(flag: Flag): Promise<Flag>;
     /** Declare a boolean flag handle for runtime evaluation. */
-    booleanFlag(key: string, defaultValue: boolean): BooleanFlag;
+    booleanFlag(id: string, defaultValue: boolean): BooleanFlag;
     /** Declare a string flag handle for runtime evaluation. */
-    stringFlag(key: string, defaultValue: string): StringFlag;
+    stringFlag(id: string, defaultValue: string): StringFlag;
     /** Declare a numeric flag handle for runtime evaluation. */
-    numberFlag(key: string, defaultValue: number): NumberFlag;
+    numberFlag(id: string, defaultValue: number): NumberFlag;
     /** Declare a JSON flag handle for runtime evaluation. */
-    jsonFlag(key: string, defaultValue: Record<string, any>): JsonFlag;
+    jsonFlag(id: string, defaultValue: Record<string, any>): JsonFlag;
     /**
      * Register a context provider function.
      *
@@ -775,9 +763,9 @@ declare class FlagsClient {
      * Register a change listener.
      *
      * - `onChange(callback)` — fires for any flag change.
-     * - `onChange(key, callback)` — fires only for the specified flag key.
+     * - `onChange(id, callback)` — fires only for the specified flag id.
      */
-    onChange(callbackOrKey: string | ((event: FlagChangeEvent) => void), callback?: (event: FlagChangeEvent) => void): void;
+    onChange(callbackOrId: string | ((event: FlagChangeEvent) => void), callback?: (event: FlagChangeEvent) => void): void;
     /**
      * Register context(s) with the server.
      *
@@ -789,7 +777,7 @@ declare class FlagsClient {
     /**
      * Evaluate a flag with an explicit environment and context.
      */
-    evaluate(key: string, options: {
+    evaluate(id: string, options: {
         environment: string;
         context: Context[];
     }): Promise<any>;
@@ -824,8 +812,8 @@ declare enum LogLevel {
 }
 /** Describes a logger configuration change. */
 interface LoggerChangeEvent {
-    /** The logger key that changed. */
-    key: string;
+    /** The logger id that changed. */
+    id: string;
     /** The new effective log level, or null if removed. */
     level: LogLevel | null;
     /** How the change was delivered. */
@@ -842,15 +830,13 @@ interface LoggerChangeEvent {
  * Mutate properties or use convenience methods, then call `save()` to persist.
  */
 declare class Logger {
-    /** UUID of the logger, or `null` if unsaved. */
+    /** Unique identifier (dot-separated hierarchy, e.g. `"sqlalchemy.engine"`). */
     id: string | null;
-    /** Unique key (dot-separated hierarchy). */
-    key: string;
     /** Human-readable display name. */
     name: string;
     /** Base log level, or null if inherited. */
     level: string | null;
-    /** UUID of the parent log group, or null. */
+    /** Id of the parent log group, or null. */
     group: string | null;
     /** Whether this logger is managed by the platform. */
     managed: boolean;
@@ -867,7 +853,6 @@ declare class Logger {
     /** @internal */
     constructor(client: LoggingClient, fields: {
         id: string | null;
-        key: string;
         name: string;
         level: string | null;
         group: string | null;
@@ -903,15 +888,13 @@ declare class Logger {
  * Management: mutate properties and call `save()` to persist.
  */
 declare class LogGroup {
-    /** UUID of the log group, or `null` if unsaved. */
+    /** Unique identifier (slug), or `null` if unsaved. */
     id: string | null;
-    /** Unique key. */
-    key: string;
     /** Human-readable display name. */
     name: string;
     /** Base log level, or null if inherited. */
     level: string | null;
-    /** UUID of the parent log group, or null. */
+    /** Id of the parent log group, or null. */
     group: string | null;
     /** Per-environment level overrides. */
     environments: Record<string, any>;
@@ -924,7 +907,6 @@ declare class LogGroup {
     /** @internal */
     constructor(client: LoggingClient, fields: {
         id: string | null;
-        key: string;
         name: string;
         level: string | null;
         group: string | null;
@@ -1021,27 +1003,27 @@ declare class LoggingClient {
      */
     registerAdapter(adapter: LoggingAdapter): void;
     /** Create an unsaved logger. Call `.save()` to persist. */
-    new(key: string, options?: {
+    new(id: string, options?: {
         name?: string;
         managed?: boolean;
     }): Logger;
-    /** Fetch a logger by key. */
-    get(key: string): Promise<Logger>;
+    /** Fetch a logger by id. */
+    get(id: string): Promise<Logger>;
     /** List all loggers. */
     list(): Promise<Logger[]>;
-    /** Delete a logger by key. */
-    delete(key: string): Promise<void>;
+    /** Delete a logger by id. */
+    delete(id: string): Promise<void>;
     /** Create an unsaved log group. Call `.save()` to persist. */
-    newGroup(key: string, options?: {
+    newGroup(id: string, options?: {
         name?: string;
         group?: string;
     }): LogGroup;
-    /** Fetch a log group by key. */
-    getGroup(key: string): Promise<LogGroup>;
+    /** Fetch a log group by id. */
+    getGroup(id: string): Promise<LogGroup>;
     /** List all log groups. */
     listGroups(): Promise<LogGroup[]>;
-    /** Delete a log group by key. */
-    deleteGroup(key: string): Promise<void>;
+    /** Delete a log group by id. */
+    deleteGroup(id: string): Promise<void>;
     /** @internal — POST or PUT a logger. */
     _saveLogger(logger: Logger): Promise<Logger>;
     /** @internal — POST or PUT a log group. */
@@ -1058,9 +1040,9 @@ declare class LoggingClient {
      * Register a change listener.
      *
      * - `onChange(callback)` — fires for any logger change.
-     * - `onChange(key, callback)` — fires only for the specified logger key.
+     * - `onChange(id, callback)` — fires only for the specified logger id.
      */
-    onChange(callbackOrKey: string | ((event: LoggerChangeEvent) => void), callback?: (event: LoggerChangeEvent) => void): void;
+    onChange(callbackOrId: string | ((event: LoggerChangeEvent) => void), callback?: (event: LoggerChangeEvent) => void): void;
     /** @internal */
     _close(): void;
     /** Auto-load built-in adapters by attempting to require each framework. */