inttegro 3.0.1 → 4.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b23466dd6f42990b59c874206d96d6fbd760cb9b41dcafe43731b20e18454e29
-  data.tar.gz: f96cef4961a136ddf64a57d8fc8187cca646261342615501e4bc7e20808354c8
+  metadata.gz: 7b60affd2f9bc5ce1556ec7aeeacc26d0d52604d964df3c0ffd72ae034800130
+  data.tar.gz: 93520c2c26b96c4292eace71528343cd5ff5f33039e563132c3161d07dce03fe
 SHA512:
-  metadata.gz: cdbaf916ca3021f661bbb23c84730ea82e94c6c4ecafe79b2fb50cb597f23540f90139f02a7067829254588b5d9087b41991d45a6f20bee326b0ef2f24ce0c62
-  data.tar.gz: f6c056b945e6d2fecd7d0680830e328319689ef0bad3d3ce66025f5c481c8e61b71c0fcddea5ae37784f2b8201a040972bd56c3d1d8b6a1b417fbc6904a382e4
+  metadata.gz: 42d25f00a4b8d6ce066f044b2572fd31f3a49aaac7fb98085817673816695b2b69cb83e93e1381c685a5da73236cc9c663e8e493ab3e3118e28698b7e22e1cf9
+  data.tar.gz: 22b17729fa018888d51fc33945536a6624298f1b8b66a6a2599b3009fce8a79575e574dc4caefc531535e5812c64b397ce87ebd5f3eff908307890a12934f830

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 ## [Unreleased]
 
+## [4.2.1] - 2026-09-04
+
+- Aligned the SDK parity test with hosted-checkout routes that are intentionally handled by the client.
+- Refreshed generated declarations from the OpenAPI commit pinned by CI and release automation.
+
+## [4.2.0] - 2026-09-04
+
+- Added vendor-neutral OpenTelemetry spans for logical SDK operations, HTTP attempts, response receipt, decoding, and safe failure categories.
+- Added W3C trace-context propagation plus global or per-client tracer-provider configuration.
+- Kept request bodies, credentials, resource identifiers, dynamic URLs, and exception details out of telemetry.
+
+## [4.1.0] - 2026-09-03
+
+- Added focused `Inttegro::Wallets` and `Inttegro::BankAccounts` modules for financial-account variants.
+- Preserved the generated root constants for compatibility.
+
+## [4.0.2] - 2026-09-03
+
+- Normalize legacy uppercase currency values when decoding typed amount responses while keeping lowercase wire values for requests.
+- Restore the product identifier on typed catalog-price responses.
+
+## [4.0.1] - 2026-09-03
+
+- Breaking: renamed order-prefixed payment models to semantic payment domain types.
+- Added focused `Inttegro::Money` access for amount types and separated request and response price shapes.
+- Kept generated transport response and envelope constants private while resource methods return domain objects directly.
+
 ## [3.0.1] - 2026-09-03
 
 - Corrected the release-verification example to reference the current package version.

data/README.md

@@ -54,7 +54,10 @@ begin
         type: Inttegro::ProductType::DIGITAL,
         name: "Monthly subscription",
         quantity: 1,
-        price: { currency: "ghs", value: 5000 }
+        price: Inttegro::PriceParams.new(
+          currency: Inttegro::Money::Currency::GHS,
+          value: 5000
+        )
       }
     }]
   )
@@ -70,6 +73,20 @@ end
 
 Amounts use integer minor units: `5000` GHS is GHS 50.00. Reuse the same idempotency key when retrying the same logical write. If you omit one, the SDK generates a UUIDv7 key for mutating calls.
 
+## Observe SDK operations
+
+The SDK emits vendor-neutral OpenTelemetry spans through your application's provider. It never configures an exporter or sends telemetry by itself. Configure OpenTelemetry before creating the client:
+
+```ruby
+require "opentelemetry/sdk"
+require "inttegro"
+
+OpenTelemetry::SDK.configure
+inttegro = Inttegro::Client.new(api_key: ENV.fetch("INTTEGRO_API_KEY"))
+```
+
+Spans are named after logical operations such as `inttegro.orders.create`. HTTP attempts, response receipt, and decoding are span events. API keys, bodies, resource IDs, dynamic URLs, and exception messages are never recorded. See [SDK observability](https://studio.inttegro.com/sdk-observability) for the complete contract and set `telemetry_enabled: false` when needed.
+
 ## Work with the API
 
 The SDK covers orders and checkout, customers, products and prices, purchase intents, payment methods, balances, payouts and refunds, notifications, files, application settings, keys, and country specifications. Resources use snake-case readers such as `purchase_intents` and `payment_methods`.
@@ -92,7 +109,7 @@ The GitHub release for each version is the canonical record. It contains the exa
 
 ```bash
 sha256sum --check SHA256SUMS
-gh attestation verify inttegro-3.0.1.gem \
+gh attestation verify inttegro-4.2.1.gem \
   --repo zebodotdev/inttegro-sdk-ruby
 ```
 

data/lib/inttegro/client.rb

@@ -109,7 +109,9 @@ module Inttegro
         base_url: T.nilable(String),
         read_timeout: T.nilable(Numeric),
         open_timeout: T.nilable(Numeric),
-        adapter: T.nilable(Types::Adapter)
+        adapter: T.nilable(Types::Adapter),
+        telemetry_enabled: T::Boolean,
+        tracer_provider: T.nilable(OpenTelemetry::Trace::TracerProvider)
       ).void
     end
     def initialize(
@@ -119,7 +121,9 @@ module Inttegro
       base_url: DEFAULT_BASE_URL,
       read_timeout: 30,
       open_timeout: 10,
-      adapter: nil
+      adapter: nil,
+      telemetry_enabled: true,
+      tracer_provider: nil
     )
       provided_token = token || token_value
       api_key ||= provided_token
@@ -128,7 +132,9 @@ module Inttegro
         base_url: base_url,
         read_timeout: read_timeout,
         open_timeout: open_timeout,
-        adapter: adapter
+        adapter: adapter,
+        telemetry_enabled: telemetry_enabled,
+        tracer_provider: tracer_provider
       ), HTTPClient)
 
       @orders = T.let(Resources::Orders.new(@http), Resources::Orders)

data/lib/inttegro/generated/enums.rb

@@ -47,6 +47,50 @@ module Inttegro
     end
   end
 
+  class CheckoutInvoiceViewStatus < T::Enum
+    enums do
+      DRAFT = new("draft")
+      REQUIRES_PAYMENT = new("requires_payment")
+      OVERDUE = new("overdue")
+      PAID = new("paid")
+      EXPIRED = new("expired")
+      CANCELED = new("canceled")
+    end
+  end
+
+  class CheckoutMobileMoneyDataNetwork < T::Enum
+    enums do
+      MTN = new("mtn")
+      VODAFONE = new("vodafone")
+      AIRTEL = new("airtel")
+      TELECEL = new("telecel")
+    end
+  end
+
+  class CheckoutOrderStatus < T::Enum
+    enums do
+      PREPARING = new("preparing")
+      REQUIRES_PAYMENT = new("requires_payment")
+      COMPLETED = new("completed")
+      PAID = new("paid")
+      CANCELED = new("canceled")
+      EXPIRED = new("expired")
+      UNKNOWN = new("unknown")
+    end
+  end
+
+  class CheckoutPayRequestPaymentMethodDataType < T::Enum
+    enums do
+      MOBILE_MONEY = new("mobile_money")
+    end
+  end
+
+  class CheckoutPaymentMethodDataType < T::Enum
+    enums do
+      MOBILE_MONEY = new("mobile_money")
+    end
+  end
+
   class ChimeEmailSchemaKind < T::Enum
     enums do
       GMAIL_VIEW_ACTION = new("gmail_view_action")
@@ -101,6 +145,16 @@ module Inttegro
     end
   end
 
+  class Currency < T::Enum
+    enums do
+      GHS = new("ghs")
+      USD = new("usd")
+      GBP = new("gbp")
+      EUR = new("eur")
+      CNY = new("cny")
+    end
+  end
+
   class DeliveryChannel < T::Enum
     enums do
       EMAIL = new("email")
@@ -323,20 +377,6 @@ module Inttegro
     end
   end
 
-  class OrderPaymentStatus < T::Enum
-    enums do
-      INITIATED = new("initiated")
-      REQUIRES_ACTION = new("requires_action")
-      OVERDUE = new("overdue")
-      EXECUTED = new("executed")
-      PAID = new("paid")
-      CANCELED = new("canceled")
-      EXPIRED = new("expired")
-      FAILED = new("failed")
-      UNKNOWN = new("unknown")
-    end
-  end
-
   class OrderProductLineItemType < T::Enum
     enums do
       PRODUCT = new("product")
@@ -422,6 +462,20 @@ module Inttegro
     end
   end
 
+  class PaymentStatus < T::Enum
+    enums do
+      INITIATED = new("initiated")
+      REQUIRES_ACTION = new("requires_action")
+      OVERDUE = new("overdue")
+      EXECUTED = new("executed")
+      PAID = new("paid")
+      CANCELED = new("canceled")
+      EXPIRED = new("expired")
+      FAILED = new("failed")
+      UNKNOWN = new("unknown")
+    end
+  end
+
   class PayoutStatus < T::Enum
     enums do
       INITIALIZED = new("initialized")