infrawrench-sdk 1.16.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed2bbb041647f781da0b26a0d376c2cedcf6a4904aa085405ee8c7bd5d477de9
-  data.tar.gz: fc6adc2c9b7edd3188848c118b52f322ce2e54bd1d613fc927cc718401759df8
+  metadata.gz: 359ea68464e3400d21793fcb623a2f4d3652d4438d0943d15d3a89ed08ba2d40
+  data.tar.gz: d85bcd64441a864f5cc4fa8433242a907fe169f89663e66dd8d81595d42fbe52
 SHA512:
-  metadata.gz: cfa7d9ba7d12d044aca5221751c60b316d4ac51133f6c17967417deaea411f688dafbce45af8c18836fd421cf9f1469b1972eb068c5fb085501efb3f7d14ff62
-  data.tar.gz: 1eb649eb2e24e58172ec86e6b84a4d90c2c8739bb7d01804defc426845bc566261a69f241f9b6af1cc7db1ea4ee888274ff2415a645c50efcc441d068962cc9d
+  metadata.gz: e2ce4ad9fff0121b54795ee4185628084ae0d7832d9970633a3a0f82ca1f98787c098f17a326ca62b62f88452a4836555fe91abd77302be4ccf00ba45953e002
+  data.tar.gz: 8b216cbe55353f50c523ca02ed4e5c86db7a396f63313b629eed0a5747af7d8ec11640a018fab31a4a975537e38bdd5f6935ba3ad41b58aedf0342f62092ca77

data/README.md

@@ -1,6 +1,6 @@
 # infrawrench-sdk
 
-Generated Ruby client for the Infrawrench API (API version `1.16.0`).
+Generated Ruby client for the Infrawrench API (API version `1.17.0`).
 
 **Do not edit this gem by hand** — it is regenerated from `openapi.json` and is
 not checked into the repository. Run
@@ -41,7 +41,7 @@ Every method takes an optional trailing `request_options:` hash (`:headers`,
 Responses are the plain `Hash`/`Array` that `JSON.parse` returns, with String
 keys spelled exactly as the wire spells them. There are no model classes — see
 [`sig/infrawrench/sdk.rbs`](./sig/infrawrench/sdk.rbs) for the shape of every one of the
-596 schemas, as RBS type aliases that steep and TypeProf can read.
+601 schemas, as RBS type aliases that steep and TypeProf can read.
 
 Non-2xx responses raise `Infrawrench::ApiError`, which carries `#status`,
 the parsed `#body`, and the machine-readable `#code` when the API sends one —

data/infrawrench-sdk.gemspec

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.16.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.16.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -17,8 +17,8 @@ require_relative "lib/infrawrench/version"
 Gem::Specification.new do |spec|
   spec.name = "infrawrench-sdk"
   spec.version = Infrawrench::VERSION
-  spec.summary = "Generated Ruby client for the Infrawrench API (v1.16.0)."
-  spec.description = "Generated Ruby client for the Infrawrench API (v1.16.0). Covers the published API surface only — operations marked x-internal in the spec are not generated. No runtime dependencies."
+  spec.summary = "Generated Ruby client for the Infrawrench API (v1.17.0)."
+  spec.description = "Generated Ruby client for the Infrawrench API (v1.17.0). Covers the published API surface only — operations marked x-internal in the spec are not generated. No runtime dependencies."
   spec.authors = ["Infrawrench LLC", "Astrid Gealer"]
   spec.email = ["astrid@infrawrench.com"]
   spec.homepage = "https://infrawrench.com/docs/team-and-billing/client-sdks"

data/lib/infrawrench/client.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.16.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.16.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -2571,16 +2571,165 @@ module Infrawrench
     end
   end
 
+  # `client.changes.revert`
+  class ChangesRevertNamespace
+    # @api private
+    # @param transport [Transport]
+    def initialize(transport)
+      @transport = transport
+    end
+
+    # Revert one change event
+    #
+    # Applies the inverse patch through the plugin's ordinary `updateResource`
+    # path — the same call the Edit form makes — and only for the fields the dry
+    # run marked `revertible`.
+    #
+    # The plan is rebuilt against a fresh live read immediately before the
+    # write, so a field that moved between the preview and the apply becomes a
+    # conflict and drops out of the patch.
+    #
+    # **This is a last-moment re-read, not an atomic compare-and-swap.** The gap
+    # between reading a field and writing it is one provider round-trip wide,
+    # and a third party writing inside that gap will be overwritten without
+    # warning. It cannot be closed generically: the plugin update contract
+    # carries no expected value, ETag or version token, so no conditional write
+    # can be expressed for a provider that supports one. Treat the conflict
+    # detection as a strong guard against stale plans, not as a mutual-exclusion
+    # guarantee against other writers.
+    #
+    # Reverts of the *same event* are mutually exclusive: the event is claimed
+    # with a conditional update under a five-minute lease, so two concurrent
+    # reverts cannot both reach the provider and the loser gets `409`. A
+    # provider failure releases the claim immediately; a process that dies
+    # mid-write leaves a claim that expires, so an interrupted revert is
+    # retryable rather than permanently stuck. `revertedAt` is only set once the
+    # provider accepted the write.
+    #
+    # The claim carries an owner token, and every write that ends a revert is
+    # fenced on it. An attempt whose provider call outlives the lease can
+    # therefore neither release nor complete the claim that replaced it — it
+    # gets `409` with `appliedFields` naming what it did write, so the caller
+    # can reconcile rather than assume. Two attempts can overlap in that case,
+    # but they cannot disagree: both invert the same recorded event to the same
+    # values, so the second one's patch is a subset of the first's.
+    #
+    # If a write reaches the provider but recording it fails, the response is
+    # `500` with `appliedFields` — the resource moved and the timeline has not
+    # caught up. The claim is deliberately held in that case, and the next
+    # attempt after the lease expires finds every field already back and records
+    # the revert without touching the provider again, answering `200` with
+    # `reconciled: true` and an empty `appliedFields`. A resource put back by
+    # hand is not mistaken for this: reconciliation only happens on an event
+    # whose claim was still outstanding, which is the only state in which an
+    # unrecorded write is possible.
+    #
+    # Blocked with `423` while an org change freeze is in effect. Every attempt
+    # whose write reached the provider is audit-logged as
+    # `resource.change_revert`, including one that lost its claim or could not
+    # record — the entry's `outcome` is `recorded`, `superseded`, `unrecorded`
+    # or `reconciled`, so a contested outcome reads as one mutation rather than
+    # as several reverts. An attempt that neither wrote nor recorded anything
+    # logs nothing. Attribution is best-effort: no transaction spans a
+    # third-party cloud API and Infrawrench's database, so if the audit insert
+    # itself fails the response carries `auditRecorded: false` and the details
+    # go to the server log rather than being silently dropped.
+    #
+    # The stored resource snapshot is deliberately left untouched, so the next
+    # poll observes the reverted state and records it as an ordinary change
+    # event.
+    #
+    # POST /api/org/{orgId}/changes/{changeId}/revert
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 404: Not found
+    #
+    # Raises on 409: Already reverted, another revert holds the event, nothing
+    # in the plan is writable, or this attempt was superseded mid-write (its
+    # lease lapsed). The body carries `code: change_revert_conflict` for all but
+    # the writability case, and `appliedFields` when the provider write had
+    # already landed.
+    #
+    # Raises on 423: Blocked by an active change freeze. Retry with the
+    # `x-change-freeze-override: true` header if you hold `freezes:override`;
+    # both blocks and overrides are audit-logged.
+    #
+    # Raises on 500: The provider accepted the write but it could not be
+    # recorded against the event. The resource *has* been put back;
+    # `appliedFields` names what changed. A later retry reconciles the timeline.
+    #
+    # Raises on 502: The provider couldn't be read. Nothing was written.
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param change_id [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `RevertApplyResponse` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def create(change_id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/changes/{changeId}/revert",
+        path_params: { "orgId" => org_id, "changeId" => change_id },
+        request_options: request_options
+      )
+    end
+
+    # Dry-run a revert of one change event
+    #
+    # Inverts the recorded diff and reconciles it against the resource's
+    # *current* live fields, which is the whole point: the poller may have
+    # recorded this hours ago and the world may have moved on. Read-only — it
+    # reads from the provider and writes nothing.
+    #
+    # Only `updated` events with a field diff can be reverted. `outputs.*`
+    # entries are provider-derived and are never written back, and whether a
+    # field is writable at all is the plugin's own edit-form rule (`editable`,
+    # minus `secret` and `association` kinds), so a revert can never issue a
+    # provider call an edit could not.
+    #
+    # Gated on `resources:write` rather than `resources:read`: the plan names
+    # the write it is offering to make.
+    #
+    # GET /api/org/{orgId}/changes/{changeId}/revert
+    #
+    # Raises on 404: Not found
+    #
+    # Raises on 502: The provider couldn't be read, so no plan can be made
+    # safely. Nothing was written.
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param change_id [String]
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `RevertPreviewResponse` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def get(change_id:, org_id: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/changes/{changeId}/revert",
+        path_params: { "orgId" => org_id, "changeId" => change_id },
+        request_options: request_options
+      )
+    end
+  end
+
   # `client.changes`
   class ChangesNamespace
     # @return [ChangesAlertSettingsNamespace] `client.changes.alert_settings`
     attr_reader :alert_settings
+    # @return [ChangesRevertNamespace] `client.changes.revert`
+    attr_reader :revert
 
     # @api private
     # @param transport [Transport]
     def initialize(transport)
       @transport = transport
       @alert_settings = ChangesAlertSettingsNamespace.new(@transport)
+      @revert = ChangesRevertNamespace.new(@transport)
     end
 
     # Org-wide change timeline (paginated, filterable)

data/lib/infrawrench/sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.16.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.16.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/lib/infrawrench/transport.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.16.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.16.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/lib/infrawrench/version.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.16.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.16.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -15,5 +15,5 @@
 # Kept in its own file so the gemspec can read the version without loading the
 # client — a gemspec that pulls in net/http is a gemspec that can fail to parse.
 module Infrawrench
-  VERSION = "1.16.0"
+  VERSION = "1.17.0"
 end

data/lib/infrawrench-sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.16.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.16.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk

data/sig/infrawrench/sdk.rbs

@@ -1,7 +1,7 @@
-# infrawrench-sdk v1.16.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.16.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -4602,7 +4602,8 @@ module Infrawrench
     "changeKind" => resource_change_kind,
     "diff" => Array[resource_field_change],
     ?"origin" => "schedule" | nil,
-    "createdAt" => String
+    "createdAt" => String,
+    ?"revertedAt" => String | nil
   }
 
   # Spec schema: `ResourceChangeFeedEntry`.
@@ -5166,6 +5167,58 @@ module Infrawrench
     ?"schedulable" => bool
   }
 
+  # Spec schema: `RevertApplyResponse`.
+  type revert_apply_response = {
+    "changeId" => String,
+    "resourceId" => resource_id,
+    "appliedFields" => Array[String],
+    "plan" => revert_plan,
+    "revertedAt" => String,
+    ?"reconciled" => bool,
+    ?"auditRecorded" => bool
+  }
+
+  # Spec schema: `RevertFieldPlan`.
+  type revert_field_plan = {
+    "field" => String,
+    ?"revertTo" => untyped,
+    ?"changedTo" => untyped,
+    ?"current" => untyped,
+    "status" => revert_field_status,
+    "reason" => String
+  }
+
+  # What a revert would do to one field. `revertible` — the field still holds
+  # the value the change set, and the plugin's edit form can write the old one
+  # back. `already-reverted` — it is already at the old value; nothing to do.
+  # `conflict` — it changed again since, so reverting would discard the newer
+  # value. `not-writable` — outside the plugin's editable surface, or the old
+  # value is not something the edit form can submit. `provider-derived` — an
+  # `outputs.*` entry, which the provider computes rather than accepts.
+  #
+  # Spec schema: `RevertFieldStatus`.
+  type revert_field_status = "revertible" | "already-reverted" | "conflict" | "not-writable" | "provider-derived"
+
+  # Spec schema: `RevertPlan`.
+  type revert_plan = {
+    "fields" => Array[revert_field_plan],
+    "revertibleFields" => Array[String],
+    "revertible" => bool,
+    "blockedReason" => String | nil
+  }
+
+  # Spec schema: `RevertPreviewResponse`.
+  type revert_preview_response = {
+    "changeId" => String,
+    "resourceId" => resource_id,
+    "displayName" => String,
+    "pluginId" => String,
+    "resourceTypeId" => String,
+    "accountId" => String,
+    "plan" => revert_plan,
+    "revertedAt" => String | nil
+  }
+
   # Spec schema: `RightsizingListResponse`.
   type rightsizing_list_response = {
     "accounts" => Array[oversized_account_group],
@@ -6363,8 +6416,15 @@ module Infrawrench
     def update: (?org_id: String?, ?body: drift_alert_settings_update?, ?request_options: Hash[Symbol, untyped]?) -> drift_alert_settings
   end
 
+  class ChangesRevertNamespace
+    def initialize: (Transport) -> void
+    def create: (change_id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> revert_apply_response
+    def get: (change_id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> revert_preview_response
+  end
+
   class ChangesNamespace
     attr_reader alert_settings: ChangesAlertSettingsNamespace
+    attr_reader revert: ChangesRevertNamespace
     def initialize: (Transport) -> void
     def get: (?org_id: String?, ?page: Integer?, ?page_size: Integer?, ?account_id: String?, ?resource_id: String?, ?kind: resource_change_kind?, ?from: String?, ?to: String?, ?request_options: Hash[Symbol, untyped]?) -> resource_change_feed_response
     def resource: (resource_id: String, ?org_id: String?, ?limit: Integer?, ?request_options: Hash[Symbol, untyped]?) -> resource_change_list_response

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: infrawrench-sdk
 version: !ruby/object:Gem::Version
-  version: 1.16.0
+  version: 1.17.0
 platform: ruby
 authors:
 - Infrawrench LLC
@@ -11,7 +11,7 @@ bindir: bin
 cert_chain: []
 date: 2026-08-12 00:00:00.000000000 Z
 dependencies: []
-description: Generated Ruby client for the Infrawrench API (v1.16.0). Covers the published
+description: Generated Ruby client for the Infrawrench API (v1.17.0). Covers the published
   API surface only — operations marked x-internal in the spec are not generated. No
   runtime dependencies.
 email:
@@ -58,5 +58,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Generated Ruby client for the Infrawrench API (v1.16.0).
+summary: Generated Ruby client for the Infrawrench API (v1.17.0).
 test_files: []