@smplkit/sdk 1.3.27 → 1.3.29

package/dist/index.js

@@ -16756,15 +16756,13 @@ function resolveChain(chain, environment) {
 
 // src/config/types.ts
 var Config = class {
-  /** UUID of the config, or `null` if unsaved. */
+  /** Unique identifier (slug, e.g. `"user-service"`). */
   id;
-  /** Human-readable key (e.g. `"user-service"`). */
-  key;
   /** Display name. */
   name;
   /** Optional description. */
   description;
-  /** Parent config UUID, or null if this is a root config. */
+  /** Parent config id (slug), or null if this is a root config. */
   parent;
   /** Base key-value pairs. */
   items;
@@ -16783,7 +16781,6 @@ var Config = class {
   constructor(client, fields) {
     this._client = client;
     this.id = fields.id;
-    this.key = fields.key;
     this.name = fields.name;
     this.description = fields.description;
     this.parent = fields.parent;
@@ -16799,7 +16796,7 @@ var Config = class {
    * Updates this instance in-place with the server response.
    */
   async save() {
-    if (this.id === null) {
+    if (this.createdAt === null) {
       const created = await this._client._createConfig(this);
       this._apply(created);
     } else {
@@ -16833,7 +16830,6 @@ var Config = class {
   /** @internal — copy all fields from another Config instance. */
   _apply(other) {
     this.id = other.id;
-    this.key = other.key;
     this.name = other.name;
     this.description = other.description;
     this.parent = other.parent;
@@ -16843,7 +16839,7 @@ var Config = class {
     this.updatedAt = other.updatedAt;
   }
   toString() {
-    return `Config(id=${this.id}, key=${this.key}, name=${this.name})`;
+    return `Config(id=${this.id}, name=${this.name})`;
   }
 };
 
@@ -16936,7 +16932,6 @@ function resourceToConfig(resource, client) {
   const attrs = resource.attributes;
   return new Config(client, {
     id: resource.id ?? null,
-    key: attrs.key ?? "",
     name: attrs.name,
     description: attrs.description ?? null,
     parent: attrs.parent ?? null,
@@ -16996,7 +16991,6 @@ function buildRequestBody(options) {
   const attrs = {
     name: options.name
   };
-  if (options.key !== void 0) attrs.key = options.key;
   if (options.description !== void 0) attrs.description = options.description;
   if (options.parent !== void 0) attrs.parent = options.parent;
   if (options.items !== void 0)
@@ -17055,11 +17049,10 @@ var ConfigClient = class {
   // Management: factory method
   // ------------------------------------------------------------------
   /** Create an unsaved config. Call `.save()` to persist. */
-  new(key, options) {
+  new(id, options) {
     return new Config(this, {
-      id: null,
-      key,
-      name: options?.name ?? keyToDisplayName(key),
+      id,
+      name: options?.name ?? keyToDisplayName(id),
       description: options?.description ?? null,
       parent: options?.parent ?? null,
       items: {},
@@ -17071,9 +17064,9 @@ var ConfigClient = class {
   // ------------------------------------------------------------------
   // Management: CRUD
   // ------------------------------------------------------------------
-  /** Fetch a config by key. */
-  async get(key) {
-    return this._getByKey(key);
+  /** Fetch a config by id. */
+  async get(id) {
+    return this._getById(id);
   }
   /** List all configs. */
   async list() {
@@ -17088,15 +17081,14 @@ var ConfigClient = class {
     if (!data) return [];
     return data.data.map((r) => resourceToConfig(r, this));
   }
-  /** Delete a config by key. */
-  async delete(key) {
-    const config = await this.get(key);
+  /** Delete a config by id. */
+  async delete(id) {
     try {
       const result = await this._http.DELETE("/api/v1/configs/{id}", {
-        params: { path: { id: config.id } }
+        params: { path: { id } }
       });
       if (result.error !== void 0 && result.response.status !== 204)
-        await checkError(result.response, `Failed to delete config '${key}'`);
+        await checkError(result.response, `Failed to delete config '${id}'`);
     } catch (err) {
       wrapFetchError(err);
     }
@@ -17107,8 +17099,8 @@ var ConfigClient = class {
   /** @internal — POST a new config. */
   async _createConfig(config) {
     const body = buildRequestBody({
+      id: config.id,
       name: config.name,
-      key: config.key,
       description: config.description,
       parent: config.parent,
       items: config.items,
@@ -17130,7 +17122,6 @@ var ConfigClient = class {
     const body = buildRequestBody({
       id: config.id,
       name: config.name,
-      key: config.key,
       description: config.description,
       parent: config.parent,
       items: config.items,
@@ -17151,20 +17142,20 @@ var ConfigClient = class {
     if (!data || !data.data) throw new SmplValidationError(`Failed to update config ${config.id}`);
     return resourceToConfig(data.data, this);
   }
-  /** @internal — fetch a config by UUID. */
-  async _getById(configId) {
+  /** @internal — fetch a config by id. */
+  async _getById(id) {
     let data;
     try {
       const result = await this._http.GET("/api/v1/configs/{id}", {
-        params: { path: { id: configId } }
+        params: { path: { id } }
       });
       if (result.error !== void 0)
-        await checkError(result.response, `Config ${configId} not found`);
+        await checkError(result.response, `Config with id '${id}' not found`);
       data = result.data;
     } catch (err) {
       wrapFetchError(err);
     }
-    if (!data || !data.data) throw new SmplNotFoundError(`Config ${configId} not found`);
+    if (!data || !data.data) throw new SmplNotFoundError(`Config with id '${id}' not found`);
     return resourceToConfig(data.data, this);
   }
   // ------------------------------------------------------------------
@@ -17176,15 +17167,15 @@ var ConfigClient = class {
    * Returns the resolved key-value pairs for the given config.
    * Optionally pass a model class to map the resolved values.
    */
-  async resolve(key, model) {
+  async resolve(id, model) {
     await this._ensureInitialized();
-    const values = this._configCache[key];
+    const values = this._configCache[id];
     if (values === void 0) {
-      throw new SmplNotFoundError(`Config with key '${key}' not found in cache`);
+      throw new SmplNotFoundError(`Config with id '${id}' not found in cache`);
     }
     const metrics = this._parent?._metrics;
     if (metrics) {
-      metrics.record("config.resolutions", 1, "resolutions", { config_id: key });
+      metrics.record("config.resolutions", 1, "resolutions", { config: id });
     }
     if (model) {
       return new model(values);
@@ -17197,12 +17188,12 @@ var ConfigClient = class {
    *
    * Optionally pass a model class to map the resolved values.
    */
-  async subscribe(key, model) {
+  async subscribe(id, model) {
     await this._ensureInitialized();
-    if (!(key in this._configCache)) {
-      throw new SmplNotFoundError(`Config with key '${key}' not found in cache`);
+    if (!(id in this._configCache)) {
+      throw new SmplNotFoundError(`Config with id '${id}' not found in cache`);
     }
-    return new LiveConfigProxy(this, key, model);
+    return new LiveConfigProxy(this, id, model);
   }
   // ------------------------------------------------------------------
   // Runtime: change listeners (3-level overloads)
@@ -17211,26 +17202,26 @@ var ConfigClient = class {
    * 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, callbackOrItemKey, callback) {
-    if (typeof callbackOrConfigKey === "function") {
+  onChange(callbackOrConfigId, callbackOrItemKey, callback) {
+    if (typeof callbackOrConfigId === "function") {
       this._listeners.push({
-        callback: callbackOrConfigKey,
-        configKey: null,
+        callback: callbackOrConfigId,
+        configId: null,
         itemKey: null
       });
     } else if (typeof callbackOrItemKey === "function") {
       this._listeners.push({
         callback: callbackOrItemKey,
-        configKey: callbackOrConfigKey,
+        configId: callbackOrConfigId,
         itemKey: null
       });
     } else if (typeof callbackOrItemKey === "string" && callback) {
       this._listeners.push({
         callback,
-        configKey: callbackOrConfigKey,
+        configId: callbackOrConfigId,
         itemKey: callbackOrItemKey
       });
     }
@@ -17254,7 +17245,7 @@ var ConfigClient = class {
     const newCache = {};
     for (const cfg of configs) {
       const chain = await cfg._buildChain(configs);
-      newCache[cfg.key] = resolveChain(chain, environment);
+      newCache[cfg.id] = resolveChain(chain, environment);
     }
     const oldCache = this._configCache;
     this._configCache = newCache;
@@ -17274,7 +17265,7 @@ var ConfigClient = class {
     const cache = {};
     for (const cfg of configs) {
       const chain = await cfg._buildChain(configs);
-      cache[cfg.key] = resolveChain(chain, environment);
+      cache[cfg.id] = resolveChain(chain, environment);
     }
     this._configCache = cache;
     this._initialized = true;
@@ -17290,7 +17281,7 @@ var ConfigClient = class {
     const cache = {};
     for (const cfg of configs) {
       const chain = await cfg._buildChain(configs);
-      cache[cfg.key] = resolveChain(chain, environment);
+      cache[cfg.id] = resolveChain(chain, environment);
     }
     this._configCache = cache;
     this._initialized = true;
@@ -17322,17 +17313,17 @@ var ConfigClient = class {
         if (JSON.stringify(oldVal) !== JSON.stringify(newVal)) {
           const metrics = this._parent?._metrics;
           if (metrics) {
-            metrics.record("config.changes", 1, "changes", { config_id: cfgKey });
+            metrics.record("config.changes", 1, "changes", { config: cfgKey });
           }
           const event = {
-            configKey: cfgKey,
+            configId: cfgKey,
             itemKey: iKey,
             oldValue: oldVal,
             newValue: newVal,
             source
           };
           for (const listener of this._listeners) {
-            if (listener.configKey !== null && listener.configKey !== cfgKey) continue;
+            if (listener.configId !== null && listener.configId !== cfgKey) continue;
             if (listener.itemKey !== null && listener.itemKey !== iKey) continue;
             try {
               listener.callback(event);
@@ -17343,26 +17334,6 @@ var ConfigClient = class {
       }
     }
   }
-  // ------------------------------------------------------------------
-  // Internal: fetch by key
-  // ------------------------------------------------------------------
-  async _getByKey(key) {
-    let data;
-    try {
-      const result = await this._http.GET("/api/v1/configs", {
-        params: { query: { "filter[key]": key } }
-      });
-      if (result.error !== void 0)
-        await checkError(result.response, `Config with key '${key}' not found`);
-      data = result.data;
-    } catch (err) {
-      wrapFetchError(err);
-    }
-    if (!data || !data.data || data.data.length === 0) {
-      throw new SmplNotFoundError(`Config with key '${key}' not found`);
-    }
-    return resourceToConfig(data.data[0], this);
-  }
 };
 
 // src/flags/client.ts
@@ -17370,10 +17341,8 @@ import createClient2 from "openapi-fetch";
 
 // src/flags/models.ts
 var Flag = class {
-  /** UUID of the flag, or `null` if unsaved. */
+  /** Unique identifier (slug) within the account. */
   id;
-  /** Unique key within the account. */
-  key;
   /** Human-readable display name. */
   name;
   /** Value type: BOOLEAN, STRING, NUMERIC, or JSON. */
@@ -17396,7 +17365,6 @@ var Flag = class {
   constructor(client, fields) {
     this._client = client;
     this.id = fields.id;
-    this.key = fields.key;
     this.name = fields.name;
     this.type = fields.type;
     this.default = fields.default;
@@ -17413,7 +17381,7 @@ var Flag = class {
    * Updates this instance in-place with the server response.
    */
   async save() {
-    if (this.id === null) {
+    if (this.createdAt === null) {
       const created = await this._client._createFlag(this);
       this._apply(created);
     } else {
@@ -17477,12 +17445,11 @@ var Flag = class {
    * Requires `initialize()` to have been called on the flags client.
    */
   get(options) {
-    return this._client._evaluateHandle(this.key, this.default, options?.context ?? null);
+    return this._client._evaluateHandle(this.id, this.default, options?.context ?? null);
   }
   /** @internal — copy all fields from another Flag instance. */
   _apply(other) {
     this.id = other.id;
-    this.key = other.key;
     this.name = other.name;
     this.type = other.type;
     this.default = other.default;
@@ -17493,12 +17460,12 @@ var Flag = class {
     this.updatedAt = other.updatedAt;
   }
   toString() {
-    return `Flag(key=${this.key}, type=${this.type}, default=${this.default})`;
+    return `Flag(id=${this.id}, type=${this.type}, default=${this.default})`;
   }
 };
 var BooleanFlag = class extends Flag {
   get(options) {
-    const value = this._client._evaluateHandle(this.key, this.default, options?.context ?? null);
+    const value = this._client._evaluateHandle(this.id, this.default, options?.context ?? null);
     if (typeof value === "boolean") {
       return value;
     }
@@ -17507,7 +17474,7 @@ var BooleanFlag = class extends Flag {
 };
 var StringFlag = class extends Flag {
   get(options) {
-    const value = this._client._evaluateHandle(this.key, this.default, options?.context ?? null);
+    const value = this._client._evaluateHandle(this.id, this.default, options?.context ?? null);
     if (typeof value === "string") {
       return value;
     }
@@ -17516,7 +17483,7 @@ var StringFlag = class extends Flag {
 };
 var NumberFlag = class extends Flag {
   get(options) {
-    const value = this._client._evaluateHandle(this.key, this.default, options?.context ?? null);
+    const value = this._client._evaluateHandle(this.id, this.default, options?.context ?? null);
     if (typeof value === "number") {
       return value;
     }
@@ -17525,7 +17492,7 @@ var NumberFlag = class extends Flag {
 };
 var JsonFlag = class extends Flag {
   get(options) {
-    const value = this._client._evaluateHandle(this.key, this.default, options?.context ?? null);
+    const value = this._client._evaluateHandle(this.id, this.default, options?.context ?? null);
     if (typeof value === "object" && value !== null && !Array.isArray(value)) {
       return value;
     }
@@ -17608,10 +17575,10 @@ function evaluateFlag(flagDef, environment, evalDict) {
   return fallback;
 }
 var FlagChangeEvent = class {
-  key;
+  id;
   source;
-  constructor(key, source) {
-    this.key = key;
+  constructor(id, source) {
+    this.id = id;
     this.source = source;
   }
 };
@@ -17753,11 +17720,10 @@ var FlagsClient = class {
   // Management: factory methods (return unsaved flags)
   // ------------------------------------------------------------------
   /** Create an unsaved boolean flag. Call `.save()` to persist. */
-  newBooleanFlag(key, options) {
+  newBooleanFlag(id, options) {
     return new BooleanFlag(this, {
-      id: null,
-      key,
-      name: options.name ?? keyToDisplayName(key),
+      id,
+      name: options.name ?? keyToDisplayName(id),
       type: "BOOLEAN",
       default: options.default,
       values: [
@@ -17771,11 +17737,10 @@ var FlagsClient = class {
     });
   }
   /** Create an unsaved string flag. Call `.save()` to persist. */
-  newStringFlag(key, options) {
+  newStringFlag(id, options) {
     return new StringFlag(this, {
-      id: null,
-      key,
-      name: options.name ?? keyToDisplayName(key),
+      id,
+      name: options.name ?? keyToDisplayName(id),
       type: "STRING",
       default: options.default,
       values: options.values ?? null,
@@ -17786,11 +17751,10 @@ var FlagsClient = class {
     });
   }
   /** Create an unsaved number flag. Call `.save()` to persist. */
-  newNumberFlag(key, options) {
+  newNumberFlag(id, options) {
     return new NumberFlag(this, {
-      id: null,
-      key,
-      name: options.name ?? keyToDisplayName(key),
+      id,
+      name: options.name ?? keyToDisplayName(id),
       type: "NUMERIC",
       default: options.default,
       values: options.values ?? null,
@@ -17801,11 +17765,10 @@ var FlagsClient = class {
     });
   }
   /** Create an unsaved JSON flag. Call `.save()` to persist. */
-  newJsonFlag(key, options) {
+  newJsonFlag(id, options) {
     return new JsonFlag(this, {
-      id: null,
-      key,
-      name: options.name ?? keyToDisplayName(key),
+      id,
+      name: options.name ?? keyToDisplayName(id),
       type: "JSON",
       default: options.default,
       values: options.values ?? null,
@@ -17818,23 +17781,23 @@ var FlagsClient = class {
   // ------------------------------------------------------------------
   // Management: CRUD
   // ------------------------------------------------------------------
-  /** Fetch a flag by key. */
-  async get(key) {
+  /** Fetch a flag by id. */
+  async get(id) {
     let data;
     try {
-      const result = await this._http.GET("/api/v1/flags", {
-        params: { query: { "filter[key]": key } }
+      const result = await this._http.GET("/api/v1/flags/{id}", {
+        params: { path: { id } }
       });
       if (result.error !== void 0)
-        await checkError2(result.response, `Flag with key '${key}' not found`);
+        await checkError2(result.response, `Flag with id '${id}' not found`);
       data = result.data;
     } catch (err) {
       wrapFetchError2(err);
     }
-    if (!data || !data.data || data.data.length === 0) {
-      throw new SmplNotFoundError(`Flag with key '${key}' not found`);
+    if (!data || !data.data) {
+      throw new SmplNotFoundError(`Flag with id '${id}' not found`);
     }
-    return this._resourceToModel(data.data[0]);
+    return this._resourceToModel(data.data);
   }
   /** List all flags. */
   async list() {
@@ -17849,15 +17812,14 @@ var FlagsClient = class {
     if (!data) return [];
     return data.data.map((r) => this._resourceToModel(r));
   }
-  /** Delete a flag by key. */
-  async delete(key) {
-    const flag = await this.get(key);
+  /** Delete a flag by id. */
+  async delete(id) {
     try {
       const result = await this._http.DELETE("/api/v1/flags/{id}", {
-        params: { path: { id: flag.id } }
+        params: { path: { id } }
       });
       if (result.error !== void 0 && result.response.status !== 204)
-        await checkError2(result.response, `Failed to delete flag '${key}'`);
+        await checkError2(result.response, `Failed to delete flag '${id}'`);
     } catch (err) {
       wrapFetchError2(err);
     }
@@ -17869,9 +17831,9 @@ var FlagsClient = class {
   async _createFlag(flag) {
     const body = {
       data: {
+        id: flag.id,
         type: "flag",
         attributes: {
-          key: flag.key,
           name: flag.name,
           description: flag.description ?? "",
           type: flag.type,
@@ -17898,7 +17860,6 @@ var FlagsClient = class {
       data: {
         type: "flag",
         attributes: {
-          key: flag.key,
           name: flag.name,
           type: flag.type,
           default: flag.default,
@@ -17927,11 +17888,10 @@ var FlagsClient = class {
   // Runtime: typed flag handles
   // ------------------------------------------------------------------
   /** Declare a boolean flag handle for runtime evaluation. */
-  booleanFlag(key, defaultValue) {
+  booleanFlag(id, defaultValue) {
     const handle = new BooleanFlag(this, {
-      id: null,
-      key,
-      name: key,
+      id,
+      name: id,
       type: "BOOLEAN",
       default: defaultValue,
       values: [],
@@ -17940,15 +17900,14 @@ var FlagsClient = class {
       createdAt: null,
       updatedAt: null
     });
-    this._handles[key] = handle;
+    this._handles[id] = handle;
     return handle;
   }
   /** Declare a string flag handle for runtime evaluation. */
-  stringFlag(key, defaultValue) {
+  stringFlag(id, defaultValue) {
     const handle = new StringFlag(this, {
-      id: null,
-      key,
-      name: key,
+      id,
+      name: id,
       type: "STRING",
       default: defaultValue,
       values: [],
@@ -17957,15 +17916,14 @@ var FlagsClient = class {
       createdAt: null,
       updatedAt: null
     });
-    this._handles[key] = handle;
+    this._handles[id] = handle;
     return handle;
   }
   /** Declare a numeric flag handle for runtime evaluation. */
-  numberFlag(key, defaultValue) {
+  numberFlag(id, defaultValue) {
     const handle = new NumberFlag(this, {
-      id: null,
-      key,
-      name: key,
+      id,
+      name: id,
       type: "NUMERIC",
       default: defaultValue,
       values: [],
@@ -17974,15 +17932,14 @@ var FlagsClient = class {
       createdAt: null,
       updatedAt: null
     });
-    this._handles[key] = handle;
+    this._handles[id] = handle;
     return handle;
   }
   /** Declare a JSON flag handle for runtime evaluation. */
-  jsonFlag(key, defaultValue) {
+  jsonFlag(id, defaultValue) {
     const handle = new JsonFlag(this, {
-      id: null,
-      key,
-      name: key,
+      id,
+      name: id,
       type: "JSON",
       default: defaultValue,
       values: [],
@@ -17991,7 +17948,7 @@ var FlagsClient = class {
       createdAt: null,
       updatedAt: null
     });
-    this._handles[key] = handle;
+    this._handles[id] = handle;
     return handle;
   }
   // ------------------------------------------------------------------
@@ -18068,20 +18025,20 @@ var FlagsClient = class {
    * 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, callback) {
-    if (typeof callbackOrKey === "function") {
-      this._globalListeners.push(callbackOrKey);
+  onChange(callbackOrId, callback) {
+    if (typeof callbackOrId === "function") {
+      this._globalListeners.push(callbackOrId);
     } else {
-      const key = callbackOrKey;
+      const id = callbackOrId;
       if (!callback) {
-        throw new SmplError("onChange(key, callback) requires a callback function.");
+        throw new SmplError("onChange(id, callback) requires a callback function.");
       }
-      if (!this._keyListeners.has(key)) {
-        this._keyListeners.set(key, []);
+      if (!this._keyListeners.has(id)) {
+        this._keyListeners.set(id, []);
       }
-      this._keyListeners.get(key).push(callback);
+      this._keyListeners.get(id).push(callback);
     }
   }
   // ------------------------------------------------------------------
@@ -18109,18 +18066,18 @@ var FlagsClient = class {
   /**
    * Evaluate a flag with an explicit environment and context.
    */
-  async evaluate(key, options) {
+  async evaluate(id, options) {
     const evalDict = contextsToEvalDict(options.context);
     if (this._parent?._service && !("service" in evalDict)) {
       evalDict["service"] = { key: this._parent._service };
     }
     let flagDef = null;
-    if (this._initialized && key in this._flagStore) {
-      flagDef = this._flagStore[key];
+    if (this._initialized && id in this._flagStore) {
+      flagDef = this._flagStore[id];
     } else {
       const flags = await this._fetchFlagsList();
       for (const f of flags) {
-        if (f.key === key) {
+        if (f.id === id) {
           flagDef = f;
           break;
         }
@@ -18162,14 +18119,14 @@ var FlagsClient = class {
       const metrics2 = this._parent?._metrics;
       if (metrics2) {
         metrics2.record("flags.cache_hits", 1, "hits");
-        metrics2.record("flags.evaluations", 1, "evaluations", { flag_id: key });
+        metrics2.record("flags.evaluations", 1, "evaluations", { flag: key });
       }
       return cachedValue;
     }
     const metrics = this._parent?._metrics;
     if (metrics) {
       metrics.record("flags.cache_misses", 1, "misses");
-      metrics.record("flags.evaluations", 1, "evaluations", { flag_id: key });
+      metrics.record("flags.evaluations", 1, "evaluations", { flag: key });
     }
     const flagDef = this._flagStore[key];
     if (flagDef === void 0) {
@@ -18200,17 +18157,17 @@ var FlagsClient = class {
   // Internal: event handlers (called by SharedWebSocket)
   // ------------------------------------------------------------------
   _handleFlagChanged = (data) => {
-    const flagKey = data.key;
+    const flagId = data.id;
     void this._fetchAllFlags().then(() => {
       this._cache.clear();
-      this._fireChangeListeners(flagKey ?? null, "websocket");
+      this._fireChangeListeners(flagId ?? null, "websocket");
     });
   };
   _handleFlagDeleted = (data) => {
-    const flagKey = data.key;
+    const flagId = data.id;
     void this._fetchAllFlags().then(() => {
       this._cache.clear();
-      this._fireChangeListeners(flagKey ?? null, "websocket");
+      this._fireChangeListeners(flagId ?? null, "websocket");
     });
   };
   // ------------------------------------------------------------------
@@ -18220,7 +18177,7 @@ var FlagsClient = class {
     const flags = await this._fetchFlagsList();
     const store = {};
     for (const f of flags) {
-      store[f.key] = f;
+      store[f.id] = f;
     }
     this._flagStore = store;
   }
@@ -18239,18 +18196,18 @@ var FlagsClient = class {
   // ------------------------------------------------------------------
   // Internal: change listeners
   // ------------------------------------------------------------------
-  _fireChangeListeners(flagKey, source) {
-    if (flagKey) {
-      const event = new FlagChangeEvent(flagKey, source);
+  _fireChangeListeners(flagId, source) {
+    if (flagId) {
+      const event = new FlagChangeEvent(flagId, source);
       for (const cb of this._globalListeners) {
         try {
           cb(event);
         } catch {
         }
       }
-      const keyCallbacks = this._keyListeners.get(flagKey);
-      if (keyCallbacks) {
-        for (const cb of keyCallbacks) {
+      const idCallbacks = this._keyListeners.get(flagId);
+      if (idCallbacks) {
+        for (const cb of idCallbacks) {
           try {
             cb(event);
           } catch {
@@ -18260,8 +18217,8 @@ var FlagsClient = class {
     }
   }
   _fireChangeListenersAll(source) {
-    for (const flagKey of Object.keys(this._flagStore)) {
-      this._fireChangeListeners(flagKey, source);
+    for (const flagId of Object.keys(this._flagStore)) {
+      this._fireChangeListeners(flagId, source);
     }
   }
   // ------------------------------------------------------------------
@@ -18291,7 +18248,6 @@ var FlagsClient = class {
     const attrs = resource.attributes;
     return new Flag(this, {
       id: resource.id ?? null,
-      key: attrs.key,
       name: attrs.name,
       type: attrs.type,
       default: attrs.default,
@@ -18305,7 +18261,7 @@ var FlagsClient = class {
   _resourceToPlainDict(resource) {
     const attrs = resource.attributes;
     return {
-      key: attrs.key,
+      id: resource.id ?? null,
       name: attrs.name,
       type: attrs.type,
       default: attrs.default,
@@ -18321,15 +18277,13 @@ import createClient3 from "openapi-fetch";
 
 // src/logging/models.ts
 var Logger = class {
-  /** UUID of the logger, or `null` if unsaved. */
+  /** Unique identifier (dot-separated hierarchy, e.g. `"sqlalchemy.engine"`). */
   id;
-  /** Unique key (dot-separated hierarchy). */
-  key;
   /** Human-readable display name. */
   name;
   /** Base log level, or null if inherited. */
   level;
-  /** UUID of the parent log group, or null. */
+  /** Id of the parent log group, or null. */
   group;
   /** Whether this logger is managed by the platform. */
   managed;
@@ -18347,7 +18301,6 @@ var Logger = class {
   constructor(client, fields) {
     this._client = client;
     this.id = fields.id;
-    this.key = fields.key;
     this.name = fields.name;
     this.level = fields.level;
     this.group = fields.group;
@@ -18397,7 +18350,6 @@ var Logger = class {
   /** @internal — copy all fields from another Logger instance. */
   _apply(other) {
     this.id = other.id;
-    this.key = other.key;
     this.name = other.name;
     this.level = other.level;
     this.group = other.group;
@@ -18408,19 +18360,17 @@ var Logger = class {
     this.updatedAt = other.updatedAt;
   }
   toString() {
-    return `Logger(key=${this.key}, level=${this.level})`;
+    return `Logger(id=${this.id}, level=${this.level})`;
   }
 };
 var LogGroup = class {
-  /** UUID of the log group, or `null` if unsaved. */
+  /** Unique identifier (slug), or `null` if unsaved. */
   id;
-  /** Unique key. */
-  key;
   /** Human-readable display name. */
   name;
   /** Base log level, or null if inherited. */
   level;
-  /** UUID of the parent log group, or null. */
+  /** Id of the parent log group, or null. */
   group;
   /** Per-environment level overrides. */
   environments;
@@ -18434,7 +18384,6 @@ var LogGroup = class {
   constructor(client, fields) {
     this._client = client;
     this.id = fields.id;
-    this.key = fields.key;
     this.name = fields.name;
     this.level = fields.level;
     this.group = fields.group;
@@ -18482,7 +18431,6 @@ var LogGroup = class {
   /** @internal — copy all fields from another LogGroup instance. */
   _apply(other) {
     this.id = other.id;
-    this.key = other.key;
     this.name = other.name;
     this.level = other.level;
     this.group = other.group;
@@ -18491,7 +18439,7 @@ var LogGroup = class {
     this.updatedAt = other.updatedAt;
   }
   toString() {
-    return `LogGroup(key=${this.key}, level=${this.level})`;
+    return `LogGroup(id=${this.id}, level=${this.level})`;
   }
 };
 
@@ -18575,11 +18523,10 @@ var LoggingClient = class {
   // Management: Logger factory
   // ------------------------------------------------------------------
   /** Create an unsaved logger. Call `.save()` to persist. */
-  new(key, options) {
+  new(id, options) {
     return new Logger(this, {
-      id: null,
-      key,
-      name: options?.name ?? keyToDisplayName(key),
+      id,
+      name: options?.name ?? keyToDisplayName(id),
       level: null,
       group: null,
       managed: options?.managed ?? false,
@@ -18592,23 +18539,23 @@ var LoggingClient = class {
   // ------------------------------------------------------------------
   // Management: Logger CRUD
   // ------------------------------------------------------------------
-  /** Fetch a logger by key. */
-  async get(key) {
+  /** Fetch a logger by id. */
+  async get(id) {
     let data;
     try {
-      const result = await this._http.GET("/api/v1/loggers", {
-        params: { query: { "filter[key]": key } }
+      const result = await this._http.GET("/api/v1/loggers/{id}", {
+        params: { path: { id } }
       });
       if (result.error !== void 0)
-        await checkError3(result.response, `Logger with key '${key}' not found`);
+        await checkError3(result.response, `Logger with id '${id}' not found`);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
     }
-    if (!data || !data.data || data.data.length === 0) {
-      throw new SmplNotFoundError(`Logger with key '${key}' not found`);
+    if (!data || !data.data) {
+      throw new SmplNotFoundError(`Logger with id '${id}' not found`);
     }
-    return this._loggerToModel(data.data[0]);
+    return this._loggerToModel(data.data);
   }
   /** List all loggers. */
   async list() {
@@ -18623,15 +18570,14 @@ var LoggingClient = class {
     if (!data) return [];
     return data.data.map((r) => this._loggerToModel(r));
   }
-  /** Delete a logger by key. */
-  async delete(key) {
-    const logger = await this.get(key);
+  /** Delete a logger by id. */
+  async delete(id) {
     try {
       const result = await this._http.DELETE("/api/v1/loggers/{id}", {
-        params: { path: { id: logger.id } }
+        params: { path: { id } }
       });
       if (result.error !== void 0 && result.response.status !== 204)
-        await checkError3(result.response, `Failed to delete logger '${key}'`);
+        await checkError3(result.response, `Failed to delete logger '${id}'`);
     } catch (err) {
       wrapFetchError3(err);
     }
@@ -18640,11 +18586,10 @@ var LoggingClient = class {
   // Management: LogGroup factory
   // ------------------------------------------------------------------
   /** Create an unsaved log group. Call `.save()` to persist. */
-  newGroup(key, options) {
+  newGroup(id, options) {
     return new LogGroup(this, {
-      id: null,
-      key,
-      name: options?.name ?? keyToDisplayName(key),
+      id,
+      name: options?.name ?? keyToDisplayName(id),
       level: null,
       group: options?.group ?? null,
       environments: {},
@@ -18655,12 +18600,12 @@ var LoggingClient = class {
   // ------------------------------------------------------------------
   // Management: LogGroup CRUD
   // ------------------------------------------------------------------
-  /** Fetch a log group by key. */
-  async getGroup(key) {
+  /** Fetch a log group by id. */
+  async getGroup(id) {
     const groups = await this.listGroups();
-    const match = groups.find((g) => g.key === key);
+    const match = groups.find((g) => g.id === id);
     if (!match) {
-      throw new SmplNotFoundError(`LogGroup with key '${key}' not found`);
+      throw new SmplNotFoundError(`LogGroup with id '${id}' not found`);
     }
     return match;
   }
@@ -18678,15 +18623,15 @@ var LoggingClient = class {
     if (!data) return [];
     return data.data.map((r) => this._groupToModel(r));
   }
-  /** Delete a log group by key. */
-  async deleteGroup(key) {
-    const group = await this.getGroup(key);
+  /** Delete a log group by id. */
+  async deleteGroup(id) {
+    const group = await this.getGroup(id);
     try {
       const result = await this._http.DELETE("/api/v1/log_groups/{id}", {
         params: { path: { id: group.id } }
       });
       if (result.error !== void 0 && result.response.status !== 204)
-        await checkError3(result.response, `Failed to delete log group '${key}'`);
+        await checkError3(result.response, `Failed to delete log group '${id}'`);
     } catch (err) {
       wrapFetchError3(err);
     }
@@ -18698,9 +18643,9 @@ var LoggingClient = class {
   async _saveLogger(logger) {
     const body = {
       data: {
+        id: logger.id,
         type: "logger",
         attributes: {
-          key: logger.key,
           name: logger.name,
           level: logger.level,
           group: logger.group,
@@ -18709,7 +18654,7 @@ var LoggingClient = class {
         }
       }
     };
-    if (logger.id === null) {
+    if (logger.createdAt === null) {
       let data;
       try {
         const result = await this._http.POST("/api/v1/loggers", { body });
@@ -18743,9 +18688,9 @@ var LoggingClient = class {
   async _saveLogGroup(group) {
     const body = {
       data: {
+        id: group.id,
         type: "log_group",
         attributes: {
-          key: group.key,
           name: group.name,
           level: group.level,
           group: group.group,
@@ -18753,7 +18698,7 @@ var LoggingClient = class {
         }
       }
     };
-    if (group.id === null) {
+    if (group.createdAt === null) {
       let data;
       try {
         const result = await this._http.POST("/api/v1/log_groups", { body });
@@ -18844,20 +18789,20 @@ var LoggingClient = class {
    * 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, callback) {
-    if (typeof callbackOrKey === "function") {
-      this._globalListeners.push(callbackOrKey);
+  onChange(callbackOrId, callback) {
+    if (typeof callbackOrId === "function") {
+      this._globalListeners.push(callbackOrId);
     } else {
-      const key = callbackOrKey;
+      const id = callbackOrId;
       if (!callback) {
-        throw new SmplError("onChange(key, callback) requires a callback function.");
+        throw new SmplError("onChange(id, callback) requires a callback function.");
       }
-      if (!this._keyListeners.has(key)) {
-        this._keyListeners.set(key, []);
+      if (!this._keyListeners.has(id)) {
+        this._keyListeners.set(id, []);
       }
-      this._keyListeners.get(key).push(callback);
+      this._keyListeners.get(id).push(callback);
     }
   }
   // ------------------------------------------------------------------
@@ -18916,11 +18861,11 @@ var LoggingClient = class {
       }
       const metrics = this._parent?._metrics;
       if (metrics) {
-        metrics.record("logging.level_changes", 1, "changes", { logger_id: logger.key });
+        metrics.record("logging.level_changes", 1, "changes", { logger: logger.id });
       }
       for (const adapter of this._adapters) {
         try {
-          adapter.applyLevel(logger.key, effectiveLevel);
+          adapter.applyLevel(logger.id, effectiveLevel);
         } catch {
         }
       }
@@ -18937,11 +18882,11 @@ var LoggingClient = class {
   // Internal: WebSocket handler
   // ------------------------------------------------------------------
   _handleLoggerChanged = (data) => {
-    const key = data.key;
-    if (key) {
+    const id = data.id;
+    if (id) {
       const level = data.level ?? null;
       const event = {
-        key,
+        id,
         level,
         source: "websocket"
       };
@@ -18951,9 +18896,9 @@ var LoggingClient = class {
         } catch {
         }
       }
-      const keyCallbacks = this._keyListeners.get(key);
-      if (keyCallbacks) {
-        for (const cb of keyCallbacks) {
+      const idCallbacks = this._keyListeners.get(id);
+      if (idCallbacks) {
+        for (const cb of idCallbacks) {
           try {
             cb(event);
           } catch {
@@ -18969,7 +18914,6 @@ var LoggingClient = class {
     const attrs = resource.attributes;
     return new Logger(this, {
       id: resource.id ?? null,
-      key: attrs.key ?? "",
       name: attrs.name,
       level: attrs.level ?? null,
       group: attrs.group ?? null,
@@ -18984,7 +18928,6 @@ var LoggingClient = class {
     const attrs = resource.attributes;
     return new LogGroup(this, {
       id: resource.id ?? null,
-      key: attrs.key ?? "",
       name: attrs.name,
       level: attrs.level ?? null,
       group: attrs.group ?? null,