@smplkit/sdk 3.0.86 → 3.0.88

package/dist/index.d.cts

@@ -727,6 +727,46 @@ interface components$1 {
              */
             readonly updated_at?: string | null;
         };
+        /**
+         * LogGroupCreateRequest
+         * @description JSON:API request envelope for creating a log group.
+         *
+         *     Distinct from :class:`LogGroupRequest` because create requires
+         *     caller-supplied ``data.id`` while update does not.
+         */
+        LogGroupCreateRequest: {
+            data: components$1["schemas"]["LogGroupCreateResource"];
+        };
+        /**
+         * LogGroupCreateResource
+         * @description JSON:API resource envelope for creating a log group (id required).
+         * @example {
+         *       "attributes": {
+         *         "environments": {
+         *           "prod": {
+         *             "level": "ERROR"
+         *           }
+         *         },
+         *         "level": "WARN",
+         *         "name": "Payment pipeline"
+         *       },
+         *       "id": "payment-pipeline",
+         *       "type": "log_group"
+         *     }
+         */
+        LogGroupCreateResource: {
+            /**
+             * Id
+             * @description Client-supplied resource id.
+             */
+            id: string;
+            /**
+             * Type
+             * @constant
+             */
+            type: "log_group";
+            attributes: components$1["schemas"]["LogGroup"];
+        };
         /**
          * LogGroupListResponse
          * @description JSON:API collection response for log groups.
@@ -738,7 +778,7 @@ interface components$1 {
         };
         /**
          * LogGroupRequest
-         * @description JSON:API request envelope for creating or updating a log group.
+         * @description JSON:API request envelope for updating a log group.
          */
         LogGroupRequest: {
             data: components$1["schemas"]["LogGroupResource"];
@@ -1450,6 +1490,43 @@ interface components {
              */
             registered: number;
         };
+        /**
+         * FlagCreateRequest
+         * @description JSON:API request envelope for creating a flag.
+         *
+         *     Distinct from :class:`FlagRequest` because create requires
+         *     caller-supplied ``data.id`` while update does not.
+         */
+        FlagCreateRequest: {
+            data: components["schemas"]["FlagCreateResource"];
+        };
+        /**
+         * FlagCreateResource
+         * @description JSON:API resource envelope for creating a flag (id required).
+         * @example {
+         *       "attributes": {
+         *         "default": false,
+         *         "description": "Enable the redesigned checkout flow.",
+         *         "name": "Checkout V2",
+         *         "type": "BOOLEAN"
+         *       },
+         *       "id": "checkout-v2",
+         *       "type": "flag"
+         *     }
+         */
+        FlagCreateResource: {
+            /**
+             * Id
+             * @description Client-supplied resource id.
+             */
+            id: string;
+            /**
+             * Type
+             * @constant
+             */
+            type: "flag";
+            attributes: components["schemas"]["Flag"];
+        };
         /**
          * FlagEnvironment
          * @description Per-environment evaluation configuration for a flag.
@@ -1483,7 +1560,7 @@ interface components {
         };
         /**
          * FlagRequest
-         * @description JSON:API request envelope for creating or updating a flag.
+         * @description JSON:API request envelope for updating a flag.
          */
         FlagRequest: {
             data: components["schemas"]["FlagResource"];
@@ -3262,6 +3339,11 @@ declare class ForwardersClient implements ForwarderModelClient {
      * Construct an unsaved {@link Forwarder}. Call {@link Forwarder.save}
      * to persist.
      *
+     * @param key                    Caller-supplied stable identifier for the
+     *                               forwarder. Becomes the resource's `id`
+     *                               and is the unique key used by the audit
+     *                               service to address it on subsequent
+     *                               GET / PUT / DELETE calls.
      * @param fields.name            Display name. Free-form.
      * @param fields.forwarderType   Destination type — see {@link ForwarderType}.
      * @param fields.configuration   Destination HTTP request configuration.
@@ -3284,7 +3366,7 @@ declare class ForwardersClient implements ForwarderModelClient {
      *                               expression. Must be supplied together
      *                               with `transformType` (both or neither).
      */
-    new(fields: {
+    new(key: string, fields: {
         name: string;
         forwarderType: ForwarderType;
         configuration: HttpConfiguration;
@@ -3314,6 +3396,10 @@ declare class ForwardersClient implements ForwarderModelClient {
     delete(forwarderId: string): Promise<void>;
     /**
      * @internal Called by `Forwarder.save()` on unsaved instances.
+     *
+     * The audit service requires a caller-supplied `data.id` on create —
+     * the forwarder's stable key, propagated from
+     * `mgmt.audit.forwarders.new(key, ...)`.
      */
     _createForwarder(forwarder: Forwarder): Promise<Forwarder>;
     /**

package/dist/index.d.ts

@@ -727,6 +727,46 @@ interface components$1 {
              */
             readonly updated_at?: string | null;
         };
+        /**
+         * LogGroupCreateRequest
+         * @description JSON:API request envelope for creating a log group.
+         *
+         *     Distinct from :class:`LogGroupRequest` because create requires
+         *     caller-supplied ``data.id`` while update does not.
+         */
+        LogGroupCreateRequest: {
+            data: components$1["schemas"]["LogGroupCreateResource"];
+        };
+        /**
+         * LogGroupCreateResource
+         * @description JSON:API resource envelope for creating a log group (id required).
+         * @example {
+         *       "attributes": {
+         *         "environments": {
+         *           "prod": {
+         *             "level": "ERROR"
+         *           }
+         *         },
+         *         "level": "WARN",
+         *         "name": "Payment pipeline"
+         *       },
+         *       "id": "payment-pipeline",
+         *       "type": "log_group"
+         *     }
+         */
+        LogGroupCreateResource: {
+            /**
+             * Id
+             * @description Client-supplied resource id.
+             */
+            id: string;
+            /**
+             * Type
+             * @constant
+             */
+            type: "log_group";
+            attributes: components$1["schemas"]["LogGroup"];
+        };
         /**
          * LogGroupListResponse
          * @description JSON:API collection response for log groups.
@@ -738,7 +778,7 @@ interface components$1 {
         };
         /**
          * LogGroupRequest
-         * @description JSON:API request envelope for creating or updating a log group.
+         * @description JSON:API request envelope for updating a log group.
          */
         LogGroupRequest: {
             data: components$1["schemas"]["LogGroupResource"];
@@ -1450,6 +1490,43 @@ interface components {
              */
             registered: number;
         };
+        /**
+         * FlagCreateRequest
+         * @description JSON:API request envelope for creating a flag.
+         *
+         *     Distinct from :class:`FlagRequest` because create requires
+         *     caller-supplied ``data.id`` while update does not.
+         */
+        FlagCreateRequest: {
+            data: components["schemas"]["FlagCreateResource"];
+        };
+        /**
+         * FlagCreateResource
+         * @description JSON:API resource envelope for creating a flag (id required).
+         * @example {
+         *       "attributes": {
+         *         "default": false,
+         *         "description": "Enable the redesigned checkout flow.",
+         *         "name": "Checkout V2",
+         *         "type": "BOOLEAN"
+         *       },
+         *       "id": "checkout-v2",
+         *       "type": "flag"
+         *     }
+         */
+        FlagCreateResource: {
+            /**
+             * Id
+             * @description Client-supplied resource id.
+             */
+            id: string;
+            /**
+             * Type
+             * @constant
+             */
+            type: "flag";
+            attributes: components["schemas"]["Flag"];
+        };
         /**
          * FlagEnvironment
          * @description Per-environment evaluation configuration for a flag.
@@ -1483,7 +1560,7 @@ interface components {
         };
         /**
          * FlagRequest
-         * @description JSON:API request envelope for creating or updating a flag.
+         * @description JSON:API request envelope for updating a flag.
          */
         FlagRequest: {
             data: components["schemas"]["FlagResource"];
@@ -3262,6 +3339,11 @@ declare class ForwardersClient implements ForwarderModelClient {
      * Construct an unsaved {@link Forwarder}. Call {@link Forwarder.save}
      * to persist.
      *
+     * @param key                    Caller-supplied stable identifier for the
+     *                               forwarder. Becomes the resource's `id`
+     *                               and is the unique key used by the audit
+     *                               service to address it on subsequent
+     *                               GET / PUT / DELETE calls.
      * @param fields.name            Display name. Free-form.
      * @param fields.forwarderType   Destination type — see {@link ForwarderType}.
      * @param fields.configuration   Destination HTTP request configuration.
@@ -3284,7 +3366,7 @@ declare class ForwardersClient implements ForwarderModelClient {
      *                               expression. Must be supplied together
      *                               with `transformType` (both or neither).
      */
-    new(fields: {
+    new(key: string, fields: {
         name: string;
         forwarderType: ForwarderType;
         configuration: HttpConfiguration;
@@ -3314,6 +3396,10 @@ declare class ForwardersClient implements ForwarderModelClient {
     delete(forwarderId: string): Promise<void>;
     /**
      * @internal Called by `Forwarder.save()` on unsaved instances.
+     *
+     * The audit service requires a caller-supplied `data.id` on create —
+     * the forwarder's stable key, propagated from
+     * `mgmt.audit.forwarders.new(key, ...)`.
      */
     _createForwarder(forwarder: Forwarder): Promise<Forwarder>;
     /**

package/dist/index.js

@@ -18899,17 +18899,32 @@ async function checkError(response, error) {
   }
   throwForStatus(response.status, body);
 }
-function buildBody(config) {
+function buildAttrs(config) {
   const attrs = { name: config.name };
   if (config.description !== null) attrs.description = config.description;
   if (config.parent !== null) attrs.parent = config.parent;
   attrs.items = config._itemsRawDirect;
   attrs.environments = environmentsToWire(config._environmentsDirect);
+  return attrs;
+}
+function buildCreateBody(config) {
+  if (config.id === null) {
+    throw new SmplValidationError("Cannot create a Config without an id");
+  }
+  return {
+    data: {
+      id: config.id,
+      type: "config",
+      attributes: buildAttrs(config)
+    }
+  };
+}
+function buildUpdateBody(config) {
   return {
     data: {
       id: config.id ?? null,
       type: "config",
-      attributes: attrs
+      attributes: buildAttrs(config)
     }
   };
 }
@@ -19099,7 +19114,7 @@ var ManagementConfigClient = class {
   }
   /** @internal — called by `Config.save()` for new resources. */
   async _createConfig(config) {
-    const body = buildBody(config);
+    const body = buildCreateBody(config);
     let data;
     try {
       const result = await this._http.POST("/api/v1/configs", { body });
@@ -19114,7 +19129,7 @@ var ManagementConfigClient = class {
   /** @internal — called by `Config.save()` for existing resources. */
   async _updateConfig(config) {
     if (config.id === null) throw new Error("Cannot update a Config with no id");
-    const body = buildBody(config);
+    const body = buildUpdateBody(config);
     let data;
     try {
       const result = await this._http.PUT("/api/v1/configs/{id}", {
@@ -19193,19 +19208,34 @@ function environmentsToWire2(envs) {
   }
   return out;
 }
-function flagToBody(flag) {
+function flagAttrs(flag) {
+  return {
+    name: flag.name,
+    description: flag.description ?? "",
+    type: flag.type,
+    default: flag.default,
+    values: flag.values?.map((v) => ({ name: v.name, value: v.value })),
+    ...Object.keys(flag.environments).length > 0 ? { environments: environmentsToWire2(flag._envsRaw()) } : {}
+  };
+}
+function flagToCreateBody(flag) {
+  if (flag.id === null) {
+    throw new SmplValidationError("Cannot create a Flag without an id");
+  }
   return {
     data: {
       id: flag.id,
       type: "flag",
-      attributes: {
-        name: flag.name,
-        description: flag.description ?? "",
-        type: flag.type,
-        default: flag.default,
-        values: flag.values?.map((v) => ({ name: v.name, value: v.value })),
-        ...Object.keys(flag.environments).length > 0 ? { environments: environmentsToWire2(flag._envsRaw()) } : {}
-      }
+      attributes: flagAttrs(flag)
+    }
+  };
+}
+function flagToUpdateBody(flag) {
+  return {
+    data: {
+      id: flag.id ?? null,
+      type: "flag",
+      attributes: flagAttrs(flag)
     }
   };
 }
@@ -19430,7 +19460,7 @@ var ManagementFlagsClient = class {
   }
   /** @internal — called by `Flag.save()` for new resources. */
   async _createFlag(flag) {
-    const body = flagToBody(flag);
+    const body = flagToCreateBody(flag);
     let data;
     try {
       const result = await this._http.POST("/api/v1/flags", { body });
@@ -19445,7 +19475,7 @@ var ManagementFlagsClient = class {
   /** @internal — called by `Flag.save()` for existing resources. */
   async _updateFlag(flag) {
     if (flag.id === null) throw new Error("Cannot update a Flag with no id");
-    const body = flagToBody(flag);
+    const body = flagToUpdateBody(flag);
     let data;
     try {
       const result = await this._http.PUT("/api/v1/flags/{id}", {
@@ -19837,7 +19867,7 @@ function loggerToBody(logger) {
     data: { id: logger.id, type: "logger", attributes: attrs }
   };
 }
-function groupToBody(group) {
+function groupAttrs(group) {
   const attrs = {
     name: group.name
   };
@@ -19847,8 +19877,19 @@ function groupToBody(group) {
   if (Object.keys(wire).length > 0) {
     attrs.environments = wire;
   }
+  return attrs;
+}
+function groupToCreateBody(group) {
+  if (group.id === null) {
+    throw new SmplValidationError("Cannot create a LogGroup without an id");
+  }
+  return {
+    data: { id: group.id, type: "log_group", attributes: groupAttrs(group) }
+  };
+}
+function groupToUpdateBody(group) {
   return {
-    data: { id: group.id, type: "log_group", attributes: attrs }
+    data: { id: group.id ?? null, type: "log_group", attributes: groupAttrs(group) }
   };
 }
 var LoggerRegistrationBuffer = class {
@@ -20082,7 +20123,7 @@ var LogGroupsClient = class {
    * so create and update have to dispatch to different endpoints.
    */
   async _createGroup(group) {
-    const body = groupToBody(group);
+    const body = groupToCreateBody(group);
     let data;
     try {
       const result = await this._http.POST("/api/v1/log_groups", { body });
@@ -20097,7 +20138,7 @@ var LogGroupsClient = class {
   /** @internal — called by `LogGroup.save()` for existing groups. */
   async _updateGroup(group) {
     if (group.id === null) throw new Error("Cannot update a LogGroup with no id");
-    const body = groupToBody(group);
+    const body = groupToUpdateBody(group);
     let data;
     try {
       const result = await this._http.PUT("/api/v1/log_groups/{id}", {
@@ -20364,6 +20405,11 @@ var ForwardersClient = class {
    * Construct an unsaved {@link Forwarder}. Call {@link Forwarder.save}
    * to persist.
    *
+   * @param key                    Caller-supplied stable identifier for the
+   *                               forwarder. Becomes the resource's `id`
+   *                               and is the unique key used by the audit
+   *                               service to address it on subsequent
+   *                               GET / PUT / DELETE calls.
    * @param fields.name            Display name. Free-form.
    * @param fields.forwarderType   Destination type — see {@link ForwarderType}.
    * @param fields.configuration   Destination HTTP request configuration.
@@ -20386,8 +20432,9 @@ var ForwardersClient = class {
    *                               expression. Must be supplied together
    *                               with `transformType` (both or neither).
    */
-  new(fields) {
+  new(key, fields) {
     return new Forwarder(this, {
+      id: key,
       name: fields.name,
       forwarderType: fields.forwarderType,
       configuration: fields.configuration,
@@ -20461,10 +20508,21 @@ var ForwardersClient = class {
   }
   /**
    * @internal Called by `Forwarder.save()` on unsaved instances.
+   *
+   * The audit service requires a caller-supplied `data.id` on create —
+   * the forwarder's stable key, propagated from
+   * `mgmt.audit.forwarders.new(key, ...)`.
    */
   async _createForwarder(forwarder) {
+    if (forwarder.id === null) {
+      throw new Error("cannot create a Forwarder without an id (pass key to forwarders.new)");
+    }
     const body = {
-      data: { id: "", type: "forwarder", attributes: _forwarderAttrs(forwarder) }
+      data: {
+        id: forwarder.id,
+        type: "forwarder",
+        attributes: _forwarderAttrs(forwarder)
+      }
     };
     let data;
     try {
@@ -20807,6 +20865,9 @@ var EnvironmentsClient = class {
   }
   /** @internal */
   async _create(env) {
+    if (env.id === null) {
+      throw new SmplValidationError("Cannot create an Environment without an id");
+    }
     const body = {
       data: {
         id: env.id,