infrawrench-sdk 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 359ea68464e3400d21793fcb623a2f4d3652d4438d0943d15d3a89ed08ba2d40
-  data.tar.gz: d85bcd64441a864f5cc4fa8433242a907fe169f89663e66dd8d81595d42fbe52
+  metadata.gz: 88e054d8ab5e5f760e83695779f5d6fb4fd8630779b87d76c7268df6458a4368
+  data.tar.gz: 05cf568abc46f27c6488f536dba00e43f6b2905df806ac012a2bb1b8db33112c
 SHA512:
-  metadata.gz: e2ce4ad9fff0121b54795ee4185628084ae0d7832d9970633a3a0f82ca1f98787c098f17a326ca62b62f88452a4836555fe91abd77302be4ccf00ba45953e002
-  data.tar.gz: 8b216cbe55353f50c523ca02ed4e5c86db7a396f63313b629eed0a5747af7d8ec11640a018fab31a4a975537e38bdd5f6935ba3ad41b58aedf0342f62092ca77
+  metadata.gz: 3a594eda98b0d94712d89d36a7898bb521d1efd0d68edc137841ee3bf237aa787fa10a15463b01f2a80386ec275671270d33936c00eae59b23803099426a7f95
+  data.tar.gz: 90bf6a53e80839579db54dff18b4f9ea3e2c8e7ee1685ba1041d8346ba33e31e8c112f6b223fea188ffc5703b6d3de40690401bf2687a1b1d983edbabddbd819

data/README.md

@@ -1,6 +1,6 @@
 # infrawrench-sdk
 
-Generated Ruby client for the Infrawrench API (API version `1.17.0`).
+Generated Ruby client for the Infrawrench API (API version `1.18.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
-601 schemas, as RBS type aliases that steep and TypeProf can read.
+615 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.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.18.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.18.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.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.summary = "Generated Ruby client for the Infrawrench API (v1.18.0)."
+  spec.description = "Generated Ruby client for the Infrawrench API (v1.18.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.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.18.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.18.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -2732,6 +2732,44 @@ module Infrawrench
       @revert = ChangesRevertNamespace.new(@transport)
     end
 
+    # Cost impact of a page of changes
+    #
+    # For each change, compares the resource's per-day spend over the window
+    # before it against the window after, and reports the difference as a
+    # run-rate delta.
+    #
+    # A POST because it takes a list of ids, not because it writes: nothing is
+    # stored. The answer is recomputed on every call, deliberately — provider
+    # cost arrives late and is then restated, so a stored number would be a
+    # wrong number that never corrects itself.
+    #
+    # Both windows exclude the change's own day (spend on it is half old shape,
+    # half new) and today (an accruing day always reads as a dip), and are
+    # clamped symmetrically to the days cost collection actually covers.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # POST /api/org/{orgId}/changes/cost-impacts
+    #
+    # Raises on 400: Bad request
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash, nil] Request body, shaped as `ChangeCostImpactsRequest`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `ChangeCostImpactsResponse` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def cost_impacts(org_id: nil, body: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/changes/cost-impacts",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
     # Org-wide change timeline (paginated, filterable)
     #
     # Change events recorded by the resource poller: each poll cycle diffs the
@@ -3252,6 +3290,43 @@ module Infrawrench
       @transport = transport
     end
 
+    # Pin a change's or deploy's cost impact onto the cost charts
+    #
+    # Writes the finding as a cost annotation, so the step in the run rate is
+    # explained on the graph where it shows. Re-posting the same subject
+    # **rewords the existing note** rather than adding a second — which is what
+    # makes it safe to pin a finding again once the provider has finished
+    # restating. The note's date and report scope are never rewritten: they may
+    # have been edited deliberately.
+    #
+    # A subject with no measurable impact is a 400, not a note reading
+    # `$0.00/day`.
+    #
+    # _Requires permission: `costs:write`._
+    #
+    # POST /api/org/{orgId}/cost-annotations/change-impact
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param body [Hash, nil] Request body, shaped as `ChangeCostImpactAnnotationRequest`.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `ChangeCostImpactAnnotationResponse` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def change_impact(org_id: nil, body: nil, request_options: nil)
+      @transport.request(
+        http_method: "POST",
+        path: "/api/org/{orgId}/cost-annotations/change-impact",
+        path_params: { "orgId" => org_id },
+        body: body,
+        request_options: request_options
+      )
+    end
+
     # Create a cost annotation
     #
     # _Requires permission: `costs:write`._
@@ -5918,6 +5993,43 @@ module Infrawrench
       @transport = transport
     end
 
+    # Cost impact of a deployment run
+    #
+    # The same comparison as `POST /changes/cost-impacts`, run over the
+    # resources this deploy provisioned, with a per-resource breakdown that sums
+    # to the total.
+    #
+    # _Requires permission: `costs:read`._
+    #
+    # GET /api/org/{orgId}/deployments/runs/{id}/cost-impact
+    #
+    # Raises on 400: Bad request
+    #
+    # Raises on 404: Not found
+    #
+    # @param org_id [String, nil] Organization id. Defaults to the `org_id` the client was
+    #   constructed with.
+    # @param id [String]
+    # @param window_days [Integer, nil]
+    # @param cost_basis [String, nil] Which charge-type basis both windows are read on. `cash`
+    #   (the default) is what the provider charged on the day it charged it; `amortized` spreads a
+    #   commitment's up-front fee across the term it buys. It is echoed on every response because
+    #   a delta whose basis is unstated is unreadable — an amortized 'after' against a cash
+    #   'before' looks exactly like a saving.
+    # @param request_options [Hash, nil] Per-call `:headers`, `:timeout` and `:open_timeout`.
+    # @return [Hash] Parsed JSON, shaped as `DeploymentCostImpact` — see
+    #   `sig/infrawrench/sdk.rbs`.
+    # @raise [Infrawrench::ApiError] On any non-2xx response.
+    def cost_impact(id:, org_id: nil, window_days: nil, cost_basis: nil, request_options: nil)
+      @transport.request(
+        http_method: "GET",
+        path: "/api/org/{orgId}/deployments/runs/{id}/cost-impact",
+        path_params: { "orgId" => org_id, "id" => id },
+        query: { "windowDays" => window_days, "costBasis" => cost_basis },
+        request_options: request_options
+      )
+    end
+
     # Record a deployment that ran elsewhere
     #
     # The CLI builds on the operator's own machine, so the server never sees

data/lib/infrawrench/sdk.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.18.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.18.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.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.18.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.18.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.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.18.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.18.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.17.0"
+  VERSION = "1.18.0"
 end

data/lib/infrawrench-sdk.rb

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

data/sig/infrawrench/sdk.rbs

@@ -1,7 +1,7 @@
-# infrawrench-sdk v1.17.0 | MIT | Copyright (c) 2026 Infrawrench LLC
+# infrawrench-sdk v1.18.0 | MIT | Copyright (c) 2026 Infrawrench LLC
 # https://github.com/Infrawrench/Infrawrench
 #
-# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.17.0).
+# Generated from the Infrawrench API OpenAPI 3.1 spec (API version 1.18.0).
 #
 # DO NOT EDIT. Regenerate with:
 #   pnpm --filter @infrawrench/web generate:sdk
@@ -888,6 +888,96 @@ module Infrawrench
     "slots" => Array[capacity_slot]
   }
 
+  # Which charge-type basis both windows are read on. `cash` (the default) is
+  # what the provider charged on the day it charged it; `amortized` spreads a
+  # commitment's up-front fee across the term it buys. It is echoed on every
+  # response because a delta whose basis is unstated is unreadable — an
+  # amortized 'after' against a cash 'before' looks exactly like a saving.
+  #
+  # Spec schema: `ChangeCostBasis`.
+  type change_cost_basis = "cash" | "amortized"
+
+  # Spec schema: `ChangeCostImpact`.
+  type change_cost_impact = {
+    "status" => change_cost_impact_status,
+    "costBasis" => change_cost_basis,
+    "windowDays" => Integer,
+    "effectiveWindowDays" => Integer,
+    "eventDay" => String,
+    "before" => change_cost_impact_window,
+    "after" => change_cost_impact_window,
+    "series" => Array[change_cost_impact_series],
+    "confidence" => change_cost_impact_confidence,
+    "reasons" => Array[change_cost_impact_reason],
+    "overlappingChanges" => Integer
+  }
+
+  # Spec schema: `ChangeCostImpactAnnotationRequest`.
+  type change_cost_impact_annotation_request = {
+    "subjectKind" => "change" | "deployment",
+    "subjectId" => String,
+    ?"windowDays" => Integer,
+    ?"costBasis" => change_cost_basis
+  }
+
+  # Spec schema: `ChangeCostImpactAnnotationResponse`.
+  type change_cost_impact_annotation_response = { "annotationId" => String, "text" => String, "impact" => change_cost_impact }
+
+  # How much the delta is worth believing. Derived from the number of comparable
+  # days per side (7+ high, 4+ medium, otherwise low) and dropped one tier when
+  # other recorded changes touched the same resource inside the window.
+  #
+  # Spec schema: `ChangeCostImpactConfidence`.
+  type change_cost_impact_confidence = "high" | "medium" | "low" | "none"
+
+  # Spec schema: `ChangeCostImpactEntry`.
+  type change_cost_impact_entry = { "changeId" => String, "resourceId" => resource_id, "impact" => change_cost_impact }
+
+  # Why the result reads the way it does. Every non-`measured` status carries at
+  # least one, and `measured` carries whatever lowered its confidence.
+  # `period_native_provider` is the notable one: a provider that dates a whole
+  # invoice period to the period's start cannot be read by a day-window
+  # comparison at all.
+  #
+  # Spec schema: `ChangeCostImpactReason`.
+  type change_cost_impact_reason = "no_cost_identity"
+    | "period_native_provider"
+    | "no_cost_data"
+    | "no_coverage_before"
+    | "no_coverage_after"
+    | "short_window"
+    | "window_clamped"
+    | "overlapping_changes"
+
+  # Spec schema: `ChangeCostImpactSeries`.
+  type change_cost_impact_series = {
+    "currency" => String,
+    "beforePerDay" => Numeric,
+    "afterPerDay" => Numeric,
+    "deltaPerDay" => Numeric,
+    "deltaPercent" => Numeric | nil,
+    "beforeTotal" => Numeric,
+    "afterTotal" => Numeric
+  }
+
+  # `measured` — both windows had collected data and the delta is real.
+  # `insufficient_data` — the windows exist but are too short to compare.
+  # `unknown` — nothing here can answer the question. **`unknown` is never
+  # zero**: a resource with no cost data reports that we cannot say, not that
+  # the change was free.
+  #
+  # Spec schema: `ChangeCostImpactStatus`.
+  type change_cost_impact_status = "measured" | "insufficient_data" | "unknown"
+
+  # Spec schema: `ChangeCostImpactWindow`.
+  type change_cost_impact_window = { "from" => String, "to" => String } | nil
+
+  # Spec schema: `ChangeCostImpactsRequest`.
+  type change_cost_impacts_request = { "changeIds" => Array[String], ?"windowDays" => Integer, ?"costBasis" => change_cost_basis }
+
+  # Spec schema: `ChangeCostImpactsResponse`.
+  type change_cost_impacts_response = { "impacts" => Array[change_cost_impact_entry] }
+
   # Spec schema: `ChangeFreeze`.
   type change_freeze = {
     "id" => String,
@@ -2197,6 +2287,27 @@ module Infrawrench
   # Spec schema: `DeployTriggerInput`.
   type deploy_trigger_input = { "repo" => String, "branch" => String, "env" => String, ?"answers" => Hash[String, String] }
 
+  # Spec schema: `DeploymentCostImpact`.
+  type deployment_cost_impact = {
+    "runId" => String,
+    "costBasis" => change_cost_basis,
+    "windowDays" => Integer,
+    "eventDay" => String,
+    "resources" => Array[deployment_cost_impact_resource],
+    "total" => Array[{ "currency" => String, "deltaPerDay" => Numeric }],
+    "unknownResources" => Integer,
+    "confidence" => change_cost_impact_confidence & untyped
+  }
+
+  # Spec schema: `DeploymentCostImpactResource`.
+  type deployment_cost_impact_resource = {
+    "resourceId" => resource_id,
+    "displayName" => String,
+    "pluginId" => String,
+    "resourceTypeId" => String,
+    "impact" => change_cost_impact
+  }
+
   # Spec schema: `DeploymentRun`.
   type deployment_run = {
     "id" => String,
@@ -6426,6 +6537,7 @@ module Infrawrench
     attr_reader alert_settings: ChangesAlertSettingsNamespace
     attr_reader revert: ChangesRevertNamespace
     def initialize: (Transport) -> void
+    def cost_impacts: (?org_id: String?, ?body: change_cost_impacts_request?, ?request_options: Hash[Symbol, untyped]?) -> change_cost_impacts_response
     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
   end
@@ -6466,6 +6578,7 @@ module Infrawrench
 
   class CostAnnotationsNamespace
     def initialize: (Transport) -> void
+    def change_impact: (?org_id: String?, ?body: change_cost_impact_annotation_request?, ?request_options: Hash[Symbol, untyped]?) -> change_cost_impact_annotation_response
     def create: (body: cost_annotation_input, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> cost_annotation
     def delete: (id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> ok
     def get: (?org_id: String?, ?report_id: String?, ?request_options: Hash[Symbol, untyped]?) -> { "annotations" => Array[cost_annotation] }
@@ -6660,6 +6773,7 @@ module Infrawrench
 
   class DeploymentsRunsNamespace
     def initialize: (Transport) -> void
+    def cost_impact: (id: String, ?org_id: String?, ?window_days: Integer?, ?cost_basis: change_cost_basis?, ?request_options: Hash[Symbol, untyped]?) -> deployment_cost_impact
     def create: (?org_id: String?, ?body: deployment_run_input?, ?request_options: Hash[Symbol, untyped]?) -> { "id" => String }
     def get: (id: String, ?org_id: String?, ?request_options: Hash[Symbol, untyped]?) -> deployment_run
     def list: (?org_id: String?, ?env: String?, ?limit: Integer?, ?request_options: Hash[Symbol, untyped]?) -> Array[deployment_run]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: infrawrench-sdk
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.18.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.17.0). Covers the published
+description: Generated Ruby client for the Infrawrench API (v1.18.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.17.0).
+summary: Generated Ruby client for the Infrawrench API (v1.18.0).
 test_files: []