@smplkit/sdk 3.0.83 → 3.0.84

package/dist/index.d.cts

@@ -2008,7 +2008,7 @@ declare class Environment {
      * environment. Unmanaged environments are view-only — existing values
      * render for comparison but no new values can be set. Managed
      * environments count toward the account's `platform.managed_environments`
-     * quota.
+     * quota. `production` is always managed and cannot be demoted.
      */
     managed: boolean;
     /** When the environment was created. */
@@ -4161,9 +4161,17 @@ declare class PinoAdapter implements LoggingAdapter {
 /** A single error object from a JSON:API error response. */
 interface ApiErrorDetail {
     status?: string;
+    /**
+     * Application-specific machine-readable error code (e.g.
+     * ``environment_unmanaged``). Per JSON:API §7 and ADR-014, the server
+     * sets this on every error so callers can branch without string-matching.
+     */
+    code?: string;
     title?: string;
     detail?: string;
     source?: Record<string, unknown>;
+    /** Additional structured context (e.g. ``{environment: "staging"}``). */
+    meta?: Record<string, unknown>;
 }
 /** Base exception for all smplkit SDK errors. */
 declare class SmplError extends Error {

package/dist/index.d.ts

@@ -2008,7 +2008,7 @@ declare class Environment {
      * environment. Unmanaged environments are view-only — existing values
      * render for comparison but no new values can be set. Managed
      * environments count toward the account's `platform.managed_environments`
-     * quota.
+     * quota. `production` is always managed and cannot be demoted.
      */
     managed: boolean;
     /** When the environment was created. */
@@ -4161,9 +4161,17 @@ declare class PinoAdapter implements LoggingAdapter {
 /** A single error object from a JSON:API error response. */
 interface ApiErrorDetail {
     status?: string;
+    /**
+     * Application-specific machine-readable error code (e.g.
+     * ``environment_unmanaged``). Per JSON:API §7 and ADR-014, the server
+     * sets this on every error so callers can branch without string-matching.
+     */
+    code?: string;
     title?: string;
     detail?: string;
     source?: Record<string, unknown>;
+    /** Additional structured context (e.g. ``{environment: "staging"}``). */
+    meta?: Record<string, unknown>;
 }
 /** Base exception for all smplkit SDK errors. */
 declare class SmplError extends Error {

package/dist/index.js

@@ -16697,9 +16697,11 @@ function parseJsonApiErrors(body) {
     if (parsed && Array.isArray(parsed.errors)) {
       return parsed.errors.map((e) => ({
         ...e.status !== void 0 ? { status: String(e.status) } : {},
+        ...e.code !== void 0 ? { code: String(e.code) } : {},
         ...e.title !== void 0 ? { title: String(e.title) } : {},
         ...e.detail !== void 0 ? { detail: String(e.detail) } : {},
-        ...e.source !== void 0 && typeof e.source === "object" && e.source !== null ? { source: e.source } : {}
+        ...e.source !== void 0 && typeof e.source === "object" && e.source !== null ? { source: e.source } : {},
+        ...e.meta !== void 0 && typeof e.meta === "object" && e.meta !== null ? { meta: e.meta } : {}
       }));
     }
   } catch {
@@ -18509,7 +18511,7 @@ var Environment = class {
    * environment. Unmanaged environments are view-only — existing values
    * render for comparison but no new values can be set. Managed
    * environments count toward the account's `platform.managed_environments`
-   * quota.
+   * quota. `production` is always managed and cannot be demoted.
    */
   managed;
   /** When the environment was created. */
@@ -18895,8 +18897,17 @@ function wrapFetchError(err) {
     `Request failed: ${err instanceof Error ? err.message : String(err)}`
   );
 }
-async function checkError(response) {
-  const body = await response.text().catch(() => "");
+async function checkError(response, error) {
+  let body = "";
+  if (error !== void 0 && error !== null) {
+    try {
+      body = typeof error === "string" ? error : JSON.stringify(error);
+    } catch {
+    }
+  }
+  if (!body) {
+    body = await response.text().catch(() => "");
+  }
   throwForStatus(response.status, body);
 }
 function buildBody(config) {
@@ -19051,7 +19062,7 @@ var ManagementConfigClient = class {
       const result = await this._http.GET("/api/v1/configs", {
         params: { query }
       });
-      if (!result.response.ok) await checkError(result.response);
+      if (!result.response.ok) await checkError(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError(err);
@@ -19066,7 +19077,7 @@ var ManagementConfigClient = class {
       const result = await this._http.GET("/api/v1/configs/{id}", {
         params: { path: { id } }
       });
-      if (!result.response.ok) await checkError(result.response);
+      if (!result.response.ok) await checkError(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError(err);
@@ -19087,7 +19098,7 @@ var ManagementConfigClient = class {
         params: { path: { id } }
       });
       if (!result.response.ok && result.response.status !== 204) {
-        await checkError(result.response);
+        await checkError(result.response, result.error);
       }
     } catch (err) {
       wrapFetchError(err);
@@ -19103,7 +19114,7 @@ var ManagementConfigClient = class {
     let data;
     try {
       const result = await this._http.POST("/api/v1/configs", { body });
-      if (!result.response.ok) await checkError(result.response);
+      if (!result.response.ok) await checkError(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError(err);
@@ -19121,7 +19132,7 @@ var ManagementConfigClient = class {
         params: { path: { id: config.id } },
         body
       });
-      if (!result.response.ok) await checkError(result.response);
+      if (!result.response.ok) await checkError(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError(err);
@@ -19135,8 +19146,17 @@ var ManagementConfigClient = class {
 
 // src/management/flags.ts
 var FLAG_REGISTRATION_FLUSH_SIZE = 50;
-async function checkError2(response) {
-  const body = await response.text().catch(() => "");
+async function checkError2(response, error) {
+  let body = "";
+  if (error !== void 0 && error !== null) {
+    try {
+      body = typeof error === "string" ? error : JSON.stringify(error);
+    } catch {
+    }
+  }
+  if (!body) {
+    body = await response.text().catch(() => "");
+  }
   throwForStatus(response.status, body);
 }
 function wrapFetchError2(err) {
@@ -19334,7 +19354,7 @@ var ManagementFlagsClient = class {
       const result = await this._http.GET("/api/v1/flags/{id}", {
         params: { path: { id } }
       });
-      if (!result.response.ok) await checkError2(result.response);
+      if (!result.response.ok) await checkError2(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError2(err);
@@ -19361,7 +19381,7 @@ var ManagementFlagsClient = class {
       const result = await this._http.GET("/api/v1/flags", {
         params: { query }
       });
-      if (!result.response.ok) await checkError2(result.response);
+      if (!result.response.ok) await checkError2(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError2(err);
@@ -19380,7 +19400,7 @@ var ManagementFlagsClient = class {
         params: { path: { id } }
       });
       if (!result.response.ok && result.response.status !== 204) {
-        await checkError2(result.response);
+        await checkError2(result.response, result.error);
       }
     } catch (err) {
       wrapFetchError2(err);
@@ -19425,7 +19445,7 @@ var ManagementFlagsClient = class {
     let data;
     try {
       const result = await this._http.POST("/api/v1/flags", { body });
-      if (!result.response.ok) await checkError2(result.response);
+      if (!result.response.ok) await checkError2(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError2(err);
@@ -19443,7 +19463,7 @@ var ManagementFlagsClient = class {
         params: { path: { id: flag.id } },
         body
       });
-      if (!result.response.ok) await checkError2(result.response);
+      if (!result.response.ok) await checkError2(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError2(err);
@@ -19763,8 +19783,17 @@ var LogGroup = class {
 
 // src/management/logging.ts
 var LOGGER_REGISTRATION_FLUSH_SIZE = 50;
-async function checkError3(response) {
-  const body = await response.text().catch(() => "");
+async function checkError3(response, error) {
+  let body = "";
+  if (error !== void 0 && error !== null) {
+    try {
+      body = typeof error === "string" ? error : JSON.stringify(error);
+    } catch {
+    }
+  }
+  if (!body) {
+    body = await response.text().catch(() => "");
+  }
   throwForStatus(response.status, body);
 }
 function wrapFetchError3(err) {
@@ -19899,7 +19928,7 @@ var LoggersClient = class {
       const result = await this._http.GET("/api/v1/loggers", {
         params: { query }
       });
-      if (!result.response.ok) await checkError3(result.response);
+      if (!result.response.ok) await checkError3(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
@@ -19913,7 +19942,7 @@ var LoggersClient = class {
       const result = await this._http.GET("/api/v1/loggers/{id}", {
         params: { path: { id } }
       });
-      if (!result.response.ok) await checkError3(result.response);
+      if (!result.response.ok) await checkError3(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
@@ -19933,7 +19962,7 @@ var LoggersClient = class {
         params: { path: { id } }
       });
       if (!result.response.ok && result.response.status !== 204) {
-        await checkError3(result.response);
+        await checkError3(result.response, result.error);
       }
     } catch (err) {
       wrapFetchError3(err);
@@ -19974,7 +20003,7 @@ var LoggersClient = class {
         params: { path: { id: logger.id } },
         body
       });
-      if (!result.response.ok) await checkError3(result.response);
+      if (!result.response.ok) await checkError3(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
@@ -20017,7 +20046,7 @@ var LogGroupsClient = class {
       const result = await this._http.GET("/api/v1/log_groups", {
         params: { query }
       });
-      if (!result.response.ok) await checkError3(result.response);
+      if (!result.response.ok) await checkError3(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
@@ -20031,7 +20060,7 @@ var LogGroupsClient = class {
       const result = await this._http.GET("/api/v1/log_groups/{id}", {
         params: { path: { id } }
       });
-      if (!result.response.ok) await checkError3(result.response);
+      if (!result.response.ok) await checkError3(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
@@ -20051,7 +20080,7 @@ var LogGroupsClient = class {
         params: { path: { id } }
       });
       if (!result.response.ok && result.response.status !== 204) {
-        await checkError3(result.response);
+        await checkError3(result.response, result.error);
       }
     } catch (err) {
       wrapFetchError3(err);
@@ -20068,7 +20097,7 @@ var LogGroupsClient = class {
     let data;
     try {
       const result = await this._http.POST("/api/v1/log_groups", { body });
-      if (!result.response.ok) await checkError3(result.response);
+      if (!result.response.ok) await checkError3(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
@@ -20086,7 +20115,7 @@ var LogGroupsClient = class {
         params: { path: { id: group.id } },
         body
       });
-      if (!result.response.ok) await checkError3(result.response);
+      if (!result.response.ok) await checkError3(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError3(err);
@@ -20235,8 +20264,17 @@ var Forwarder = class {
 };
 
 // src/management/audit.ts
-async function checkError4(response) {
-  const body = await response.text().catch(() => "");
+async function checkError4(response, error) {
+  let body = "";
+  if (error !== void 0 && error !== null) {
+    try {
+      body = typeof error === "string" ? error : JSON.stringify(error);
+    } catch {
+    }
+  }
+  if (!body) {
+    body = await response.text().catch(() => "");
+  }
   throwForStatus(response.status, body);
 }
 function wrapFetchError4(err) {
@@ -20392,7 +20430,7 @@ var ForwardersClient = class {
       const result = await this._http.GET("/api/v1/forwarders", {
         params: { query }
       });
-      if (!result.response.ok) await checkError4(result.response);
+      if (!result.response.ok) await checkError4(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError4(err);
@@ -20413,7 +20451,7 @@ var ForwardersClient = class {
       const result = await this._http.GET("/api/v1/forwarders/{forwarder_id}", {
         params: { path: { forwarder_id: forwarderId } }
       });
-      if (!result.response.ok) await checkError4(result.response);
+      if (!result.response.ok) await checkError4(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError4(err);
@@ -20427,7 +20465,7 @@ var ForwardersClient = class {
       const result = await this._http.DELETE("/api/v1/forwarders/{forwarder_id}", {
         params: { path: { forwarder_id: forwarderId } }
       });
-      if (result.response.status !== 204) await checkError4(result.response);
+      if (result.response.status !== 204) await checkError4(result.response, result.error);
     } catch (err) {
       wrapFetchError4(err);
     }
@@ -20442,7 +20480,7 @@ var ForwardersClient = class {
     let data;
     try {
       const result = await this._http.POST("/api/v1/forwarders", { body });
-      if (!result.response.ok) await checkError4(result.response);
+      if (!result.response.ok) await checkError4(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError4(err);
@@ -20469,7 +20507,7 @@ var ForwardersClient = class {
         params: { path: { forwarder_id: forwarder.id } },
         body
       });
-      if (!result.response.ok) await checkError4(result.response);
+      if (!result.response.ok) await checkError4(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError4(err);
@@ -20632,8 +20670,17 @@ function splitContextId(idOrType, key) {
   }
   return [idOrType, key];
 }
-async function checkError5(response) {
-  const body = await response.text().catch(() => "");
+async function checkError5(response, error) {
+  let body = "";
+  if (error !== void 0 && error !== null) {
+    try {
+      body = typeof error === "string" ? error : JSON.stringify(error);
+    } catch {
+    }
+  }
+  if (!body) {
+    body = await response.text().catch(() => "");
+  }
   throwForStatus(response.status, body);
 }
 function wrapFetchError5(err) {
@@ -20734,7 +20781,7 @@ var EnvironmentsClient = class {
       const result = await this._http.GET("/api/v1/environments", {
         params: { query }
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -20748,7 +20795,7 @@ var EnvironmentsClient = class {
       const result = await this._http.GET("/api/v1/environments/{id}", {
         params: { path: { id } }
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -20763,7 +20810,7 @@ var EnvironmentsClient = class {
         params: { path: { id } }
       });
       if (!result.response.ok && result.response.status !== 204) {
-        await checkError5(result.response);
+        await checkError5(result.response, result.error);
       }
     } catch (err) {
       wrapFetchError5(err);
@@ -20786,7 +20833,7 @@ var EnvironmentsClient = class {
     let data;
     try {
       const result = await this._http.POST("/api/v1/environments", { body });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -20815,7 +20862,7 @@ var EnvironmentsClient = class {
         params: { path: { id: env.id } },
         body
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -20860,7 +20907,7 @@ var ContextTypesClient = class {
       const result = await this._http.GET("/api/v1/context_types", {
         params: { query }
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -20874,7 +20921,7 @@ var ContextTypesClient = class {
       const result = await this._http.GET("/api/v1/context_types/{id}", {
         params: { path: { id } }
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -20889,7 +20936,7 @@ var ContextTypesClient = class {
         params: { path: { id } }
       });
       if (!result.response.ok && result.response.status !== 204) {
-        await checkError5(result.response);
+        await checkError5(result.response, result.error);
       }
     } catch (err) {
       wrapFetchError5(err);
@@ -20910,7 +20957,7 @@ var ContextTypesClient = class {
     let data;
     try {
       const result = await this._http.POST("/api/v1/context_types", { body });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -20937,7 +20984,7 @@ var ContextTypesClient = class {
         params: { path: { id: ct.id } },
         body
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -21016,7 +21063,7 @@ var ContextsClient = class {
           }))
         }
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
     } catch (err) {
       wrapFetchError5(err);
     }
@@ -21042,7 +21089,7 @@ var ContextsClient = class {
       const result = await this._http.GET("/api/v1/contexts", {
         params: { query }
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -21059,7 +21106,7 @@ var ContextsClient = class {
       const result = await this._http.GET("/api/v1/contexts/{id}", {
         params: { path: { id: composite } }
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);
@@ -21077,7 +21124,7 @@ var ContextsClient = class {
         params: { path: { id: composite } }
       });
       if (!result.response.ok && result.response.status !== 204) {
-        await checkError5(result.response);
+        await checkError5(result.response, result.error);
       }
     } catch (err) {
       wrapFetchError5(err);
@@ -21107,7 +21154,7 @@ var ContextsClient = class {
         params: { path: { id: ctx.id } },
         body
       });
-      if (!result.response.ok) await checkError5(result.response);
+      if (!result.response.ok) await checkError5(result.response, result.error);
       data = result.data;
     } catch (err) {
       wrapFetchError5(err);