@smplkit/sdk 1.3.26 → 1.3.28

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,11 +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: id });
     }
     if (model) {
       return new model(values);
@@ -17193,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)
@@ -17207,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
       });
     }
@@ -17250,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;
@@ -17270,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;
@@ -17286,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;
@@ -17316,15 +17311,19 @@ var ConfigClient = class {
         const oldVal = iKey in oldItems ? oldItems[iKey] : null;
         const newVal = iKey in newItems ? newItems[iKey] : null;
         if (JSON.stringify(oldVal) !== JSON.stringify(newVal)) {
+          const metrics = this._parent?._metrics;
+          if (metrics) {
+            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);
@@ -17335,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
@@ -17362,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. */
@@ -17388,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;
@@ -17405,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 {
@@ -17469,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;
@@ -17485,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;
     }
@@ -17499,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;
     }
@@ -17508,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;
     }
@@ -17517,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;
     }
@@ -17600,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;
   }
 };
@@ -17745,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: [
@@ -17763,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,
@@ -17778,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,
@@ -17793,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,
@@ -17810,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() {
@@ -17841,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);
     }
@@ -17861,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,
@@ -17890,7 +17860,6 @@ var FlagsClient = class {
       data: {
         type: "flag",
         attributes: {
-          key: flag.key,
           name: flag.name,
           type: flag.type,
           default: flag.default,
@@ -17919,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: [],
@@ -17932,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: [],
@@ -17949,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: [],
@@ -17966,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: [],
@@ -17983,7 +17948,7 @@ var FlagsClient = class {
       createdAt: null,
       updatedAt: null
     });
-    this._handles[key] = handle;
+    this._handles[id] = handle;
     return handle;
   }
   // ------------------------------------------------------------------
@@ -18060,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);
     }
   }
   // ------------------------------------------------------------------
@@ -18101,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;
         }
@@ -18151,8 +18116,18 @@ var FlagsClient = class {
     const cacheKey = `${key}:${ctxHash}`;
     const [hit, cachedValue] = this._cache.get(cacheKey);
     if (hit) {
+      const metrics2 = this._parent?._metrics;
+      if (metrics2) {
+        metrics2.record("flags.cache_hits", 1, "hits");
+        metrics2.record("flags.evaluations", 1, "evaluations", { flag_id: 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 });
+    }
     const flagDef = this._flagStore[key];
     if (flagDef === void 0) {
       this._cache.put(cacheKey, defaultValue);
@@ -18182,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");
     });
   };
   // ------------------------------------------------------------------
@@ -18202,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;
   }
@@ -18221,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 {
@@ -18242,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);
     }
   }
   // ------------------------------------------------------------------
@@ -18273,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,
@@ -18287,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,
@@ -18303,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;
@@ -18329,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;
@@ -18379,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;
@@ -18390,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;
@@ -18416,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;
@@ -18464,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;
@@ -18473,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})`;
   }
 };
 
@@ -18557,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,
@@ -18574,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() {
@@ -18605,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);
     }
@@ -18622,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: {},
@@ -18637,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;
   }
@@ -18660,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);
     }
@@ -18680,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,
@@ -18691,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 });
@@ -18725,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,
@@ -18735,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 });
@@ -18796,6 +18759,12 @@ var LoggingClient = class {
       } catch {
       }
     }
+    if (discovered.length > 0) {
+      const metrics = this._parent?._metrics;
+      if (metrics) {
+        metrics.record("logging.loggers_discovered", discovered.length, "loggers");
+      }
+    }
     for (const { name, level } of discovered) {
       try {
         const logger = this.new(name, { managed: true });
@@ -18820,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);
     }
   }
   // ------------------------------------------------------------------
@@ -18890,9 +18859,13 @@ var LoggingClient = class {
           effectiveLevel = envOverride.level;
         }
       }
+      const metrics = this._parent?._metrics;
+      if (metrics) {
+        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 {
         }
       }
@@ -18909,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"
       };
@@ -18923,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 {
@@ -18941,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,
@@ -18956,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,
@@ -18973,15 +18944,17 @@ var BACKOFF_MS = [1e3, 2e3, 4e3, 8e3, 16e3, 32e3, 6e4];
 var SharedWebSocket = class {
   _appBaseUrl;
   _apiKey;
+  _metrics;
   _listeners = /* @__PURE__ */ new Map();
   _connectionStatus = "disconnected";
   _closed = false;
   _ws = null;
   _reconnectTimer = null;
   _backoffIndex = 0;
-  constructor(appBaseUrl, apiKey) {
+  constructor(appBaseUrl, apiKey, metrics) {
     this._appBaseUrl = appBaseUrl;
     this._apiKey = apiKey;
+    this._metrics = metrics ?? null;
   }
   // ------------------------------------------------------------------
   // Listener registration
@@ -19080,6 +19053,9 @@ var SharedWebSocket = class {
           if (msg.type === "connected") {
             this._backoffIndex = 0;
             this._connectionStatus = "connected";
+            if (this._metrics) {
+              this._metrics.recordGauge("platform.websocket_connections", 1, "connections");
+            }
             return;
           }
           if (msg.type === "error") {
@@ -19093,6 +19069,9 @@ var SharedWebSocket = class {
         }
       });
       ws.on("close", () => {
+        if (this._metrics) {
+          this._metrics.recordGauge("platform.websocket_connections", 0, "connections");
+        }
         if (!this._closed) {
           this._connectionStatus = "disconnected";
           this._scheduleReconnect();
@@ -19173,8 +19152,145 @@ function resolveApiKey(explicit, environment) {
   throw new SmplError(noApiKeyMessage(environment));
 }
 
-// src/client.ts
+// src/_metrics.ts
 var APP_BASE_URL2 = "https://app.smplkit.com";
+function makeCounter(unit) {
+  return { value: 0, unit, windowStart: (/* @__PURE__ */ new Date()).toISOString() };
+}
+function makeMapKey(name, dimensions) {
+  const sorted = Object.keys(dimensions).sort().map((k) => `${k}=${dimensions[k]}`).join("&");
+  return `${name}|${sorted}`;
+}
+var MetricsReporter = class {
+  _apiKey;
+  _environment;
+  _service;
+  _flushInterval;
+  _counters = /* @__PURE__ */ new Map();
+  _gauges = /* @__PURE__ */ new Map();
+  _timer = null;
+  _closed = false;
+  constructor(options) {
+    this._apiKey = options.apiKey;
+    this._environment = options.environment;
+    this._service = options.service;
+    this._flushInterval = options.flushInterval ?? 60;
+  }
+  // ------------------------------------------------------------------
+  // Public recording API
+  // ------------------------------------------------------------------
+  record(name, value = 1, unit = null, dimensions) {
+    const merged = this._mergeDimensions(dimensions);
+    const key = makeMapKey(name, merged);
+    let entry = this._counters.get(key);
+    if (!entry) {
+      entry = { name, dimensions: merged, counter: makeCounter(unit) };
+      this._counters.set(key, entry);
+    }
+    entry.counter.value += value;
+    if (entry.counter.unit === null && unit !== null) {
+      entry.counter.unit = unit;
+    }
+    this._maybeStartTimer();
+  }
+  recordGauge(name, value, unit = null, dimensions) {
+    const merged = this._mergeDimensions(dimensions);
+    const key = makeMapKey(name, merged);
+    let entry = this._gauges.get(key);
+    if (!entry) {
+      entry = { name, dimensions: merged, counter: makeCounter(unit) };
+      this._gauges.set(key, entry);
+    }
+    entry.counter.value = value;
+    if (entry.counter.unit === null && unit !== null) {
+      entry.counter.unit = unit;
+    }
+    this._maybeStartTimer();
+  }
+  // ------------------------------------------------------------------
+  // Flush / close
+  // ------------------------------------------------------------------
+  flush() {
+    this._flush();
+  }
+  close() {
+    if (this._closed) return;
+    this._closed = true;
+    if (this._timer !== null) {
+      clearInterval(this._timer);
+      this._timer = null;
+    }
+    this._flush();
+  }
+  // ------------------------------------------------------------------
+  // Internal
+  // ------------------------------------------------------------------
+  _mergeDimensions(dimensions) {
+    const merged = {
+      environment: this._environment,
+      service: this._service
+    };
+    if (dimensions) {
+      Object.assign(merged, dimensions);
+    }
+    return merged;
+  }
+  _maybeStartTimer() {
+    if (this._timer === null && !this._closed) {
+      this._timer = setInterval(() => this._flush(), this._flushInterval * 1e3);
+      if (typeof this._timer === "object" && "unref" in this._timer) {
+        this._timer.unref();
+      }
+    }
+  }
+  _flush() {
+    const counters = this._counters;
+    const gauges = this._gauges;
+    this._counters = /* @__PURE__ */ new Map();
+    this._gauges = /* @__PURE__ */ new Map();
+    if (counters.size === 0 && gauges.size === 0) return;
+    const payload = this._buildPayload(counters, gauges);
+    try {
+      fetch(`${APP_BASE_URL2}/api/v1/metrics/bulk`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this._apiKey}`,
+          "Content-Type": "application/vnd.api+json",
+          Accept: "application/json"
+        },
+        body: JSON.stringify(payload)
+      }).catch(() => {
+      });
+    } catch {
+    }
+  }
+  _buildPayload(counters, gauges) {
+    const data = [];
+    for (const [, entry] of counters) {
+      data.push(this._entry(entry.name, entry.counter, entry.dimensions));
+    }
+    for (const [, entry] of gauges) {
+      data.push(this._entry(entry.name, entry.counter, entry.dimensions));
+    }
+    return { data };
+  }
+  _entry(name, counter, dimensions) {
+    return {
+      type: "metric",
+      attributes: {
+        name,
+        value: counter.value,
+        unit: counter.unit,
+        period_seconds: this._flushInterval,
+        dimensions,
+        recorded_at: counter.windowStart
+      }
+    };
+  }
+};
+
+// src/client.ts
+var APP_BASE_URL3 = "https://app.smplkit.com";
 var NO_ENVIRONMENT_MESSAGE = "No environment provided. Set one of:\n  1. Pass environment to the constructor\n  2. Set the SMPLKIT_ENVIRONMENT environment variable";
 var NO_SERVICE_MESSAGE = "No service provided. Set one of:\n  1. Pass service in options\n  2. Set the SMPLKIT_SERVICE environment variable";
 var SmplClient = class {
@@ -19190,6 +19306,8 @@ var SmplClient = class {
   _environment;
   /** @internal */
   _service;
+  /** @internal */
+  _metrics = null;
   _timeout;
   _appHttp;
   constructor(options = {}) {
@@ -19207,12 +19325,19 @@ var SmplClient = class {
     this._apiKey = apiKey;
     this._timeout = options.timeout ?? 3e4;
     this._appHttp = createClient4({
-      baseUrl: APP_BASE_URL2,
+      baseUrl: APP_BASE_URL3,
       headers: {
         Authorization: `Bearer ${apiKey}`,
         Accept: "application/json"
       }
     });
+    if (!options.disableTelemetry) {
+      this._metrics = new MetricsReporter({
+        apiKey,
+        environment: this._environment,
+        service: this._service
+      });
+    }
     this.config = new ConfigClient(apiKey, this._timeout);
     this.flags = new FlagsClient(apiKey, () => this._ensureWs(), this._timeout);
     this.logging = new LoggingClient(apiKey, () => this._ensureWs(), this._timeout);
@@ -19242,13 +19367,16 @@ var SmplClient = class {
   /** Lazily create and start the shared WebSocket. @internal */
   _ensureWs() {
     if (this._wsManager === null) {
-      this._wsManager = new SharedWebSocket(APP_BASE_URL2, this._apiKey);
+      this._wsManager = new SharedWebSocket(APP_BASE_URL3, this._apiKey, this._metrics);
       this._wsManager.start();
     }
     return this._wsManager;
   }
   /** Close the shared WebSocket and release resources. */
   close() {
+    if (this._metrics !== null) {
+      this._metrics.close();
+    }
     this.logging._close();
     if (this._wsManager !== null) {
       this._wsManager.stop();