inttegro 1.0.0

data/lib/inttegro/models.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+# typed: strict
+
+require "sorbet-runtime"
+
+require_relative "generated/models"
+require_relative "types"
+
+module Inttegro
+  module Models
+    extend T::Sig
+
+    # Backward-compatible acronym spellings. New code should use the OpenAPI
+    # names, which preserve acronyms exactly.
+    InitiateOtpResponse = InitiateOTPResponse
+    LookupOtpResponse = LookupOTPResponse
+    VerifyOtpResponse = VerifyOTPResponse
+    OtpTransaction = OTPTransaction
+    OtpTransmission = OTPTransmission
+    OtpVerificationAttempt = OTPVerificationAttempt
+
+    # Backward-compatible response names whose schemas now have a single,
+    # endpoint-specific OpenAPI name.
+    BalancesResponse = BalanceSnapshotResponse
+    BalanceTransactionsResponse = BalanceTransactionPageResponse
+    CustomerPageResponse = PageCustomersResponse
+    OrderPageResponse = PageOrdersResponse
+    ProductPageResponse = PageProductsResponse
+    ScheduleChimeResponse = ScheduleResponse
+    CountrySpecificationsResponse = ListCountrySpecsResponse
+    FinancialAccountResponse = LookupFinancialAccountResponse
+    PaymentMethodResponse = LookupPaymentMethodResponse
+    PaymentMethodSettingsResponse = GetPaymentMethodSettingsResponse
+    PayoutSettingsResponse = GetPayoutSettingsResponse
+    PayoutPageResponse = PagePayoutsResponse
+
+    class PaymentMethodVerificationResponse < T::Struct
+      const :verification, T.nilable(PaymentMethodObjectVerification), default: nil
+    end
+
+    class PaymentMethodDeleteResponse < T::Struct
+      const :deleted, T::Boolean
+      const :payment_method_id, String
+    end
+
+    class SetDefaultUnitPriceRequest < T::Struct
+      const :product_id, String
+      const :price_id, String
+    end
+
+    # /otp/cancel predates the public OpenAPI surface. Keep its SDK model typed
+    # for compatibility without representing it as a documented operation.
+    class OTPCanceledTransaction < T::Struct
+      const :id, T.nilable(String), default: nil
+      const :status, T.nilable(Inttegro::Enums::OTPStatus), default: nil
+      const :full_message, T.nilable(String), default: nil
+      const :recipient, T.nilable(String), default: nil
+      const :sender, T.nilable(String), default: nil
+      const :mechanism, T.nilable(String), default: nil
+      const :gateway, T.nilable(String), default: nil
+      const :preferred_gateway, T.nilable(String), default: nil
+      const :created_at, T.nilable(String), default: nil
+      const :delivered_at, T.nilable(String), default: nil
+      const :verifiable_until, T.nilable(String), default: nil
+      const :canceled_at, T.nilable(String), default: nil
+      const :cancel_reason, T.nilable(String), default: nil
+    end
+
+    class CancelOTPResponse < T::Struct
+      const :transaction, T.nilable(OTPCanceledTransaction), default: nil
+      const :error, T.nilable(Error), default: nil
+    end
+
+    OtpCanceledTransaction = OTPCanceledTransaction
+    CancelOtpResponse = CancelOTPResponse
+
+    class BalanceTransaction
+      extend T::Sig
+
+      sig { returns(T.nilable(String)) }
+      def source_id
+        payment = payment_id
+        refund = refund_id
+        if type == Inttegro::Enums::BalanceTransactionType::PAYMENT && payment && !payment.empty? && refund.nil?
+          return payment
+        end
+        if type == Inttegro::Enums::BalanceTransactionType::REFUND && refund && !refund.empty? && payment.nil?
+          return refund
+        end
+
+        nil
+      end
+
+      sig { returns(T::Boolean) }
+      def valid_source?
+        !source_id.nil?
+      end
+
+      sig { returns(T::Boolean) }
+      def valid?
+        !id.empty? && !order_id.empty? && !created_at.empty? && valid_source?
+      end
+    end
+
+    sig { params(value: Object, klass: T::Class[T::Struct]).returns(T::Struct) }
+    def self.deserialize(value, klass)
+      data = stringify_json_keys(value)
+      raise TypeError, "expected an object for #{klass}, got #{data.class}" unless data.is_a?(Hash)
+
+      T.cast(klass, T.class_of(T::Struct)).from_hash(data)
+    end
+
+    sig { params(value: Object).returns(Object) }
+    def self.stringify_json_keys(value)
+      case value
+      when T::Struct
+        stringify_json_keys(value.serialize)
+      when T::Enum
+        value.serialize
+      when Hash
+        value.each_with_object({}) do |(key, item), output|
+          output[key.to_s] = stringify_json_keys(item)
+        end
+      when Array
+        value.map { |item| stringify_json_keys(item) }
+      else
+        value
+      end
+    end
+    private_class_method :stringify_json_keys
+  end
+end

data/lib/inttegro/resources/apps.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class Apps
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def create(payload)
+        @http.post_model("/apps/create", Inttegro::Models::CreateApplicationResponse, payload)
+      end
+
+      def lookup
+        @http.post_model("/apps/lookup", Inttegro::Models::LookupApplicationResponse, {})
+      end
+
+      def update(payload)
+        @http.post_model("/apps/update", Inttegro::Models::UpdateApplicationResponse, payload)
+      end
+    end
+  end
+end

data/lib/inttegro/resources/balance_transactions.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class BalanceTransactions
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def lookup(transaction_id:)
+        @http.post_model(
+          "/balance_transactions/lookup",
+          Inttegro::Models::BalanceTransactionResponse,
+          { transaction_id: transaction_id }
+        )
+      end
+
+      def page(payload = {})
+        @http.post_model(
+          "/balance_transactions/page",
+          Inttegro::Models::BalanceTransactionPageResponse,
+          payload || {}
+        )
+      end
+    end
+  end
+end

data/lib/inttegro/resources/balances.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class Balances
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def get
+        @http.post_model("/balances", Inttegro::Models::BalanceSnapshotResponse, {})
+      end
+    end
+  end
+end

data/lib/inttegro/resources/broadcasts.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class Broadcasts
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def lookup(broadcast_id:)
+        @http.post_model(
+          "/broadcasts/lookup",
+          Inttegro::Models::LookupBroadcastResponse,
+          { broadcast_id: broadcast_id }
+        )
+      end
+
+      def cancel(broadcast_id:)
+        @http.post_model(
+          "/broadcasts/cancel",
+          Inttegro::Models::BroadcastCancelResponse,
+          { broadcast_id: broadcast_id }
+        )
+      end
+    end
+  end
+end

data/lib/inttegro/resources/chimes.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class Chimes
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def send(payload)
+        @http.post_model("/chimes/send", Inttegro::Models::ChimeResponse, payload)
+      end
+
+      def lookup(chime_id:)
+        @http.post_model("/chimes/lookup", Inttegro::Models::ChimeResponse, { chime_id: chime_id })
+      end
+
+      def page(payload = {})
+        @http.post_model("/chimes/page", Inttegro::Models::PageChimesResponse, payload || {})
+      end
+
+      def schedule(payload)
+        @http.post_model("/chimes/schedule", Inttegro::Models::ScheduleResponse, payload)
+      end
+
+      def broadcast(payload)
+        @http.post_model("/chimes/broadcast", Inttegro::Models::BroadcastResponse, payload)
+      end
+    end
+  end
+end

data/lib/inttegro/resources/customers.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class Customers
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def create(payload)
+        @http.post_model("/customers/create", Inttegro::Models::CustomerResponse, payload)
+      end
+
+      def update(payload)
+        @http.post_model("/customers/update", Inttegro::Models::CustomerResponse, payload)
+      end
+
+      def lookup(customer_id:)
+        @http.post_model("/customers/lookup", Inttegro::Models::CustomerResponse, { customer_id: customer_id })
+      end
+
+      def page(payload = {})
+        @http.post_model("/customers/page", Inttegro::Models::PageCustomersResponse, payload || {})
+      end
+    end
+  end
+end

data/lib/inttegro/resources/file_links.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class FileLinks
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def create(payload, idempotency_key: nil)
+        @http.post_model(
+          "/file_links/create",
+          Inttegro::Models::CreateFileLinkResponse,
+          payload,
+          headers: headers(idempotency_key)
+        )
+      end
+
+      def lookup(id:)
+        @http.post_model("/file_links/lookup", Inttegro::Models::FileLinkResponse, { id: id })
+      end
+
+      def page(payload = {})
+        @http.post_model("/file_links/page", Inttegro::Models::FileLinkPageResponse, payload || {})
+      end
+
+      def revoke(payload, idempotency_key: nil)
+        @http.post_model(
+          "/file_links/revoke",
+          Inttegro::Models::FileLinkResponse,
+          payload,
+          headers: headers(idempotency_key)
+        )
+      end
+
+      def open(url, save_to: nil)
+        download = @http.get_binary_public(url)
+        download.save_to(save_to) if save_to
+        download
+      end
+
+      private
+
+      def headers(idempotency_key)
+        idempotency_key ? { "Idempotency-Key" => idempotency_key } : {}
+      end
+    end
+  end
+end

data/lib/inttegro/resources/file_references.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class FileReferences
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def reconcile(payload)
+        @http.post_model(
+          "/file_references/reconcile",
+          Inttegro::Models::FileReferenceReconcileResponse,
+          payload
+        )
+      end
+    end
+  end
+end

data/lib/inttegro/resources/files.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class Files
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def create(file:, purpose:, title: nil, custom_data: nil, idempotency_key: nil)
+        headers = idempotency_key ? { "Idempotency-Key" => idempotency_key } : {}
+        @http.post_multipart_model(
+          "/files/create",
+          Inttegro::Models::FileResponse,
+          fields: { purpose: purpose, title: title, custom_data: custom_data },
+          files: { file: file },
+          headers: headers
+        )
+      end
+
+      def lookup(file_id:)
+        @http.post_model("/files/lookup", Inttegro::Models::FileResponse, { file_id: file_id })
+      end
+
+      def page(payload = {})
+        @http.post_model("/files/page", Inttegro::Models::FilePageResponse, payload || {})
+      end
+
+      def contents(file_id:, disposition: "attachment")
+        @http.post_binary_json("/files/contents", { file_id: file_id, disposition: disposition })
+      end
+
+      def delete(file_id:)
+        @http.post_model("/files/delete", Inttegro::Models::FileResponse, { file_id: file_id })
+      end
+    end
+  end
+end

data/lib/inttegro/resources/financial_accounts.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class FinancialAccounts
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def create(payload)
+        @http.post_model(
+          "/financial_accounts/create",
+          Inttegro::Models::CreateFinancialAccountResponse,
+          payload
+        )
+      end
+
+      def lookup(account_id:)
+        @http.post_model(
+          "/financial_accounts/lookup",
+          Inttegro::Models::LookupFinancialAccountResponse,
+          { account_id: account_id }
+        )
+      end
+
+      def connect(payload)
+        @http.post_model(
+          "/financial_accounts/connect",
+          Inttegro::Models::ConnectFinancialAccountResponse,
+          payload
+        )
+      end
+
+      def page(payload = {})
+        @http.post_model(
+          "/financial_accounts/page",
+          Inttegro::Models::PageFinancialAccountsResponseInline,
+          payload || {}
+        )
+      end
+
+      def update(payload)
+        @http.post_model(
+          "/financial_accounts/update",
+          Inttegro::Models::UpdateFinancialAccountResponse,
+          payload
+        )
+      end
+
+      def enable_push(account_id:)
+        @http.post_model(
+          "/financial_accounts/enable_push",
+          Inttegro::Models::EnableFinancialAccountPushResponse,
+          { account_id: account_id }
+        )
+      end
+
+      def disable_push(account_id:, unset_as_payout_destination: nil)
+        payload = { account_id: account_id }
+        payload[:unset_as_payout_destination] = unset_as_payout_destination unless unset_as_payout_destination.nil?
+        @http.post_model(
+          "/financial_accounts/disable_push",
+          Inttegro::Models::DisableFinancialAccountPushResponse,
+          payload
+        )
+      end
+
+      def enable_pull(account_id:)
+        @http.post_model(
+          "/financial_accounts/enable_pull",
+          Inttegro::Models::EnableFinancialAccountPullResponse,
+          { account_id: account_id }
+        )
+      end
+
+      def disable_pull(account_id:)
+        @http.post_model(
+          "/financial_accounts/disable_pull",
+          Inttegro::Models::DisableFinancialAccountPullResponse,
+          { account_id: account_id }
+        )
+      end
+
+      def disconnect(account_id:, unset_as_payout_destination: nil)
+        payload = { account_id: account_id }
+        payload[:unset_as_payout_destination] = unset_as_payout_destination unless unset_as_payout_destination.nil?
+        @http.post_model(
+          "/financial_accounts/disconnect",
+          Inttegro::Models::DisconnectFinancialAccountResponse,
+          payload
+        )
+      end
+
+      def reconnect(account_id:)
+        @http.post_model(
+          "/financial_accounts/reconnect",
+          Inttegro::Models::ReconnectFinancialAccountResponse,
+          { account_id: account_id }
+        )
+      end
+    end
+  end
+end

data/lib/inttegro/resources/keys.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class Keys
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def generate(payload = {})
+        @http.post_model("/keys/generate", Inttegro::Models::GenerateSecretKeyResponse, payload || {})
+      end
+
+      def page(payload = {})
+        @http.post_model("/keys/page", Inttegro::Models::PageSecretKeysResponse, payload || {})
+      end
+
+      def lookup(secret_key_id: nil, key_id: nil, id: nil)
+        @http.post_model(
+          "/keys/lookup",
+          Inttegro::Models::LookupSecretKeyResponse,
+          identifier_payload(secret_key_id, key_id, id)
+        )
+      end
+
+      def update(payload)
+        @http.post_model("/keys/update", Inttegro::Models::UpdateSecretKeyResponse, payload)
+      end
+
+      def destroy(secret_key_id: nil, key_id: nil, id: nil)
+        @http.post_model(
+          "/keys/destroy",
+          Inttegro::Models::DestroySecretKeyResponse,
+          identifier_payload(secret_key_id, key_id, id)
+        )
+      end
+
+      def usage(secret_key_id: nil, key_id: nil, id: nil, **options)
+        @http.post_model(
+          "/keys/usage",
+          Inttegro::Models::SecretKeyUsageResponse,
+          identifier_payload(secret_key_id, key_id, id).merge(options)
+        )
+      end
+
+      private
+
+      def identifier_payload(secret_key_id, key_id, id)
+        if secret_key_id
+          { secret_key_id: secret_key_id }
+        elsif key_id
+          { key_id: key_id }
+        else
+          { id: id }
+        end
+      end
+    end
+  end
+end

data/lib/inttegro/resources/message_templates.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+# typed: strict
+
+module Inttegro
+  module Resources
+    class MessageTemplates
+      def initialize(http)
+        @http = T.let(http, Inttegro::HTTPClient)
+      end
+
+      def create(payload, idempotency_key: nil)
+        @http.post_model(
+          "/message_templates/create",
+          Inttegro::Models::MessageTemplateEnvelope,
+          payload,
+          headers: idempotency_headers(idempotency_key)
+        )
+      end
+
+      def update(payload, idempotency_key: nil)
+        @http.post_model(
+          "/message_templates/update",
+          Inttegro::Models::MessageTemplateEnvelope,
+          payload,
+          headers: idempotency_headers(idempotency_key)
+        )
+      end
+
+      def publish(template_id:, idempotency_key: nil)
+        @http.post_model(
+          "/message_templates/publish",
+          Inttegro::Models::MessageTemplateEnvelope,
+          { id: template_id },
+          headers: idempotency_headers(idempotency_key)
+        )
+      end
+
+      def archive(template_id:, idempotency_key: nil)
+        @http.post_model(
+          "/message_templates/archive",
+          Inttegro::Models::MessageTemplateEnvelope,
+          { id: template_id },
+          headers: idempotency_headers(idempotency_key)
+        )
+      end
+
+      def lookup(template_id:)
+        @http.post_model(
+          "/message_templates/lookup",
+          Inttegro::Models::MessageTemplateEnvelope,
+          { id: template_id }
+        )
+      end
+
+      def page(payload = {})
+        @http.post_model(
+          "/message_templates/page",
+          Inttegro::Models::MessageTemplatesPageEnvelope,
+          payload || {}
+        )
+      end
+
+      def render_preview(payload)
+        @http.post_model(
+          "/message_templates/render_preview",
+          Inttegro::Models::RenderMessageTemplatePreviewResponse,
+          payload
+        )
+      end
+
+      private
+
+      def idempotency_headers(idempotency_key)
+        idempotency_key.to_s.strip.empty? ? {} : { "Idempotency-Key" => idempotency_key }
+      end
+    end
+  end
+end