@smplkit/sdk 1.3.27 → 1.3.28

package/dist/index.cjs

@@ -16794,15 +16794,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;
@@ -16821,7 +16819,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;
@@ -16837,7 +16834,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 {
@@ -16871,7 +16868,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;
@@ -16881,7 +16877,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})`;
   }
 };
 
@@ -16974,7 +16970,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,
@@ -17034,7 +17029,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)
@@ -17093,11 +17087,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: {},
@@ -17109,9 +17102,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() {
@@ -17126,15 +17119,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);
     }
@@ -17145,8 +17137,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,
@@ -17168,7 +17160,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,
@@ -17189,20 +17180,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);
   }
   // ------------------------------------------------------------------
@@ -17214,15 +17205,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: id });
     }
     if (model) {
       return new model(values);
@@ -17235,12 +17226,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)
@@ -17249,26 +17240,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
       });
     }
@@ -17292,7 +17283,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;
@@ -17312,7 +17303,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;
@@ -17328,7 +17319,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;
@@ -17363,14 +17354,14 @@ var ConfigClient = class {
             metrics.record("config.changes", 1, "changes", { config_id: 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);
@@ -17381,26 +17372,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
@@ -17408,10 +17379,8 @@ var import_openapi_fetch2 = __toESM(require("openapi-fetch"), 1);
 
 // 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. */
@@ -17434,7 +17403,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;
@@ -17451,7 +17419,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 {
@@ -17515,12 +17483,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;
@@ -17531,12 +17498,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;
     }
@@ -17545,7 +17512,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;
     }
@@ -17554,7 +17521,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;
     }
@@ -17563,7 +17530,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;
     }
@@ -17646,10 +17613,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;
   }
 };
@@ -17791,11 +17758,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: [
@@ -17809,11 +17775,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,
@@ -17824,11 +17789,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,
@@ -17839,11 +17803,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,
@@ -17856,23 +17819,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() {
@@ -17887,15 +17850,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);
     }
@@ -17907,9 +17869,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,
@@ -17936,7 +17898,6 @@ var FlagsClient = class {
       data: {
         type: "flag",
         attributes: {
-          key: flag.key,
           name: flag.name,
           type: flag.type,
           default: flag.default,
@@ -17965,11 +17926,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: [],
@@ -17978,15 +17938,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: [],
@@ -17995,15 +17954,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: [],
@@ -18012,15 +17970,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: [],
@@ -18029,7 +17986,7 @@ var FlagsClient = class {
       createdAt: null,
       updatedAt: null
     });
-    this._handles[key] = handle;
+    this._handles[id] = handle;
     return handle;
   }
   // ------------------------------------------------------------------
@@ -18106,20 +18063,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);
     }
   }
   // ------------------------------------------------------------------
@@ -18147,18 +18104,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;
         }
@@ -18238,17 +18195,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");
     });
   };
   // ------------------------------------------------------------------
@@ -18258,7 +18215,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;
   }
@@ -18277,18 +18234,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 {
@@ -18298,8 +18255,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);
     }
   }
   // ------------------------------------------------------------------
@@ -18329,7 +18286,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,
@@ -18343,7 +18299,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,
@@ -18359,15 +18315,13 @@ var import_openapi_fetch3 = __toESM(require("openapi-fetch"), 1);
 
 // 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;
@@ -18385,7 +18339,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;
@@ -18435,7 +18388,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;
@@ -18446,19 +18398,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;
@@ -18472,7 +18422,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;
@@ -18520,7 +18469,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;
@@ -18529,7 +18477,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})`;
   }
 };
 
@@ -18613,11 +18561,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,
@@ -18630,23 +18577,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() {
@@ -18661,15 +18608,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);
     }
@@ -18678,11 +18624,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: {},
@@ -18693,12 +18638,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;
   }
@@ -18716,15 +18661,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);
     }
@@ -18736,9 +18681,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,
@@ -18747,7 +18692,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 });
@@ -18781,9 +18726,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,
@@ -18791,7 +18736,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 });
@@ -18882,20 +18827,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);
     }
   }
   // ------------------------------------------------------------------
@@ -18954,11 +18899,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_id: logger.id });
       }
       for (const adapter of this._adapters) {
         try {
-          adapter.applyLevel(logger.key, effectiveLevel);
+          adapter.applyLevel(logger.id, effectiveLevel);
         } catch {
         }
       }
@@ -18975,11 +18920,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"
       };
@@ -18989,9 +18934,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 {
@@ -19007,7 +18952,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,
@@ -19022,7 +18966,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,