dinie-sdk-sandbox 1.1.0

data/sig/dinie/generated/errors/registry.rbs

@@ -0,0 +1,40 @@
+# Server-response error catalog + dispatch table (RB14, architecture §4.1, §7). Mirrors
+# `lib/dinie/generated/errors/registry.rb`. Each marker is an empty subclass of `APIStatusError`.
+
+module Dinie
+  # 400 — `invalid-request`.
+  class BadRequestError < APIStatusError
+  end
+
+  # 401 — `authentication-failed`.
+  class AuthError < APIStatusError
+  end
+
+  # 403 — `forbidden` type URL orphan (P1 debt); dispatches by status.
+  class PermissionError < APIStatusError
+  end
+
+  # 404 — `not-found`.
+  class NotFoundError < APIStatusError
+  end
+
+  # 409 — `conflict`.
+  class ConflictError < APIStatusError
+  end
+
+  # 422 — `validation-failed`.
+  class ValidationError < APIStatusError
+  end
+
+  # 429 — `rate-limit-exceeded`.
+  class RateLimitError < APIStatusError
+  end
+
+  # 500 (also 503) and the ≥500 band fallback — `internal`.
+  class ServerError < APIStatusError
+  end
+
+  module Internal
+    ERROR_REGISTRY: Hash[Symbol, untyped]
+  end
+end

data/sig/dinie/generated/events/base.rbs

@@ -0,0 +1,17 @@
+# `Events::WebhookEventBase` — the common envelope shared by all 15 events (architecture §3.1, §8).
+# Mirrors `lib/dinie/generated/events/base.rb`. Each member inherits the seven envelope fields and
+# pins its own `type` + narrows `data` to its `*Data` model. Never instantiated directly.
+
+module Dinie
+  module Events
+    class WebhookEventBase < Internal::Model
+      attr_reader api_version: String
+      attr_reader created_at: Integer
+      attr_reader data: untyped
+      attr_reader delivery_id: String
+      attr_reader id: event_id
+      attr_reader timestamp: Integer
+      attr_reader type: String
+    end
+  end
+end

data/sig/dinie/generated/events/credit_offer.rbs

@@ -0,0 +1,33 @@
+# `credit_offer.available` + `credit_offer.expired` events — one schema, two classes (architecture
+# §3.1, §8). Mirrors `lib/dinie/generated/events/credit_offer.rb`. `data` is bespoke (NOT `CreditOffer`).
+
+module Dinie
+  module Events
+    class CreditOfferEventData < Internal::Model
+      attr_reader approved_amount: money
+      attr_reader customer_id: customer_id
+      attr_reader due_date_rule: String?
+      attr_reader external_id: String?
+      attr_reader id: credit_offer_id
+      attr_reader installments: Integer
+      attr_reader min_amount: Float
+      attr_reader monthly_interest_rate: Float
+      attr_reader status: credit_offer_status
+      attr_reader valid_until: Integer
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CreditOfferEventData
+    end
+
+    class CreditOfferAvailable < WebhookEventBase
+      attr_reader data: CreditOfferEventData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CreditOfferAvailable
+    end
+
+    class CreditOfferExpired < WebhookEventBase
+      attr_reader data: CreditOfferEventData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CreditOfferExpired
+    end
+  end
+end

data/sig/dinie/generated/events/customer_created.rbs

@@ -0,0 +1,27 @@
+# `customer.created` event (architecture §3.1, §8). Mirrors
+# `lib/dinie/generated/events/customer_created.rb`. `data` is a bespoke payload (NOT `Customer`).
+
+module Dinie
+  module Events
+    class CustomerCreatedData < Internal::Model
+      attr_reader cnpj: String?
+      attr_reader cpf: String
+      attr_reader email: String
+      attr_reader external_id: String?
+      attr_reader id: customer_id
+      attr_reader kyc: Array[Kyc::Requirement]
+      attr_reader name: String
+      attr_reader phone: String
+      attr_reader status: customer_status
+      attr_reader trading_name: String
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerCreatedData
+    end
+
+    class CustomerCreated < WebhookEventBase
+      attr_reader data: CustomerCreatedData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerCreated
+    end
+  end
+end

data/sig/dinie/generated/events/customer_denied.rbs

@@ -0,0 +1,25 @@
+# `customer.denied` event (architecture §3.1, §8). Mirrors
+# `lib/dinie/generated/events/customer_denied.rb`.
+
+module Dinie
+  module Events
+    class CustomerDeniedData < Internal::Model
+      attr_reader cnpj: String?
+      attr_reader cpf: String
+      attr_reader email: String
+      attr_reader external_id: String?
+      attr_reader id: customer_id
+      attr_reader name: String
+      attr_reader phone: String
+      attr_reader status: String
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerDeniedData
+    end
+
+    class CustomerDenied < WebhookEventBase
+      attr_reader data: CustomerDeniedData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerDenied
+    end
+  end
+end

data/sig/dinie/generated/events/customer_kyc_updated.rbs

@@ -0,0 +1,21 @@
+# `customer.kyc_updated` event (architecture §3.1, §8). Mirrors
+# `lib/dinie/generated/events/customer_kyc_updated.rb`. `data.kyc` reuses the KYC discriminated union.
+
+module Dinie
+  module Events
+    class CustomerKycUpdatedData < Internal::Model
+      attr_reader external_id: String?
+      attr_reader id: customer_id
+      attr_reader kyc: Array[Kyc::Requirement]
+      attr_reader status: customer_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerKycUpdatedData
+    end
+
+    class CustomerKycUpdated < WebhookEventBase
+      attr_reader data: CustomerKycUpdatedData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerKycUpdated
+    end
+  end
+end

data/sig/dinie/generated/events/customer_status.rbs

@@ -0,0 +1,26 @@
+# `customer.under_review` + `customer.active` events — one schema, two classes (architecture §3.1,
+# §8). Mirrors `lib/dinie/generated/events/customer_status.rb`.
+
+module Dinie
+  module Events
+    class CustomerStatusData < Internal::Model
+      attr_reader external_id: String?
+      attr_reader id: customer_id
+      attr_reader status: customer_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerStatusData
+    end
+
+    class CustomerUnderReview < WebhookEventBase
+      attr_reader data: CustomerStatusData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerUnderReview
+    end
+
+    class CustomerActive < WebhookEventBase
+      attr_reader data: CustomerStatusData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> CustomerActive
+    end
+  end
+end

data/sig/dinie/generated/events/deserializers.rbs

@@ -0,0 +1,9 @@
+# `Events::DESERIALIZERS` — the per-type webhook dispatch table (architecture §4.1, RB14). Mirrors
+# `lib/dinie/generated/events/deserializers.rb`. 15 entries from 11 schemas; consumed by
+# `runtime/webhooks.rb` via the controlled inverse import.
+
+module Dinie
+  module Events
+    DESERIALIZERS: Hash[String, ^(Hash[Symbol, untyped]) -> WebhookEventBase]
+  end
+end

data/sig/dinie/generated/events/loan_active.rbs

@@ -0,0 +1,20 @@
+# `loan.active` event (architecture §3.1, §8). Mirrors `lib/dinie/generated/events/loan_active.rb`.
+
+module Dinie
+  module Events
+    class LoanActiveData < Internal::Model
+      attr_reader id: loan_id
+      attr_reader principal_amount: money
+      attr_reader requested_amount: money
+      attr_reader status: loan_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanActiveData
+    end
+
+    class LoanActive < WebhookEventBase
+      attr_reader data: LoanActiveData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanActive
+    end
+  end
+end

data/sig/dinie/generated/events/loan_created.rbs

@@ -0,0 +1,23 @@
+# `loan.created` event (architecture §3.1, §8). Mirrors `lib/dinie/generated/events/loan_created.rb`.
+
+module Dinie
+  module Events
+    class LoanCreatedData < Internal::Model
+      attr_reader credit_offer_id: credit_offer_id
+      attr_reader customer_id: customer_id
+      attr_reader id: loan_id
+      attr_reader installment_count: Integer
+      attr_reader requested_amount: money
+      attr_reader signing_url: String?
+      attr_reader status: loan_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanCreatedData
+    end
+
+    class LoanCreated < WebhookEventBase
+      attr_reader data: LoanCreatedData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanCreated
+    end
+  end
+end

data/sig/dinie/generated/events/loan_payment_received.rbs

@@ -0,0 +1,28 @@
+# `loan.payment_received` event (architecture §3.1, §8). Mirrors
+# `lib/dinie/generated/events/loan_payment_received.rb`. Carries a nested `payment`.
+
+module Dinie
+  module Events
+    class LoanPayment < Internal::Model
+      attr_reader amount: money
+      attr_reader installment_number: Integer
+      attr_reader paid_at: Integer
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanPayment
+    end
+
+    class LoanPaymentReceivedData < Internal::Model
+      attr_reader id: loan_id
+      attr_reader payment: LoanPayment
+      attr_reader status: loan_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanPaymentReceivedData
+    end
+
+    class LoanPaymentReceived < WebhookEventBase
+      attr_reader data: LoanPaymentReceivedData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanPaymentReceived
+    end
+  end
+end

data/sig/dinie/generated/events/loan_processing.rbs

@@ -0,0 +1,23 @@
+# `loan.processing` event (architecture §3.1, §8). Mirrors
+# `lib/dinie/generated/events/loan_processing.rb`.
+
+module Dinie
+  module Events
+    class LoanProcessingData < Internal::Model
+      attr_reader ccb_number: String?
+      attr_reader credit_offer_id: credit_offer_id
+      attr_reader customer_id: customer_id
+      attr_reader disbursement_method: String?
+      attr_reader id: loan_id
+      attr_reader status: loan_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanProcessingData
+    end
+
+    class LoanProcessing < WebhookEventBase
+      attr_reader data: LoanProcessingData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanProcessing
+    end
+  end
+end

data/sig/dinie/generated/events/loan_signature_received.rbs

@@ -0,0 +1,30 @@
+# `loan.signature_received` event (architecture §3.1, §8). Mirrors
+# `lib/dinie/generated/events/loan_signature_received.rb`. Carries a nested `signer`.
+
+module Dinie
+  module Events
+    class LoanSigner < Internal::Model
+      attr_reader cpf: String
+      attr_reader name: String
+      attr_reader signed_at: Integer
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanSigner
+    end
+
+    class LoanSignatureReceivedData < Internal::Model
+      attr_reader id: loan_id
+      attr_reader signatures_received: Integer
+      attr_reader signatures_required: Integer
+      attr_reader signer: LoanSigner
+      attr_reader status: loan_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanSignatureReceivedData
+    end
+
+    class LoanSignatureReceived < WebhookEventBase
+      attr_reader data: LoanSignatureReceivedData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanSignatureReceived
+    end
+  end
+end

data/sig/dinie/generated/events/loan_status.rbs

@@ -0,0 +1,40 @@
+# `loan.finished` + `loan.cancelled` + `loan.error` events — one schema, three classes (architecture
+# §3.1, §8). Mirrors `lib/dinie/generated/events/loan_status.rb`. The nested `error` object is named
+# `LoanErrorDetails` to avoid colliding with the `LoanError` event class.
+
+module Dinie
+  module Events
+    class LoanErrorDetails < Internal::Model
+      attr_reader code: String
+      attr_reader message: String
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanErrorDetails
+    end
+
+    class LoanStatusData < Internal::Model
+      attr_reader error: LoanErrorDetails?
+      attr_reader id: loan_id
+      attr_reader status: loan_status
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanStatusData
+    end
+
+    class LoanFinished < WebhookEventBase
+      attr_reader data: LoanStatusData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanFinished
+    end
+
+    class LoanCancelled < WebhookEventBase
+      attr_reader data: LoanStatusData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanCancelled
+    end
+
+    class LoanError < WebhookEventBase
+      attr_reader data: LoanStatusData
+
+      def self.deserialize: (Hash[Symbol, untyped] raw) -> LoanError
+    end
+  end
+end

data/sig/dinie/generated/resources/banks.rbs

@@ -0,0 +1,15 @@
+# `Resources::Banks` — the `client.banks` resource: the bank directory (architecture §3.2, §11).
+# Mirrors `lib/dinie/generated/resources/banks.rb`. `list` returns a FLAT `Array<Bank>` (not paginated).
+
+module Dinie
+  module Resources
+    class Banks
+      BANKS_PATH: String
+
+      def initialize: (Dinie::Internal::HttpClient http) -> void
+
+      # List the banks available for customer bank-account submission (`GET /banks`). FLAT array.
+      def list: (?request_options: request_opts) -> Array[Dinie::Bank]
+    end
+  end
+end

data/sig/dinie/generated/resources/credentials.rbs

@@ -0,0 +1,21 @@
+# `Resources::Credentials` — the `client.credentials` resource: API-key management (architecture
+# §3.2). Mirrors `lib/dinie/generated/resources/credentials.rb`.
+
+module Dinie
+  module Resources
+    class Credentials
+      CREDENTIALS_PATH: String
+
+      def initialize: (Dinie::Internal::HttpClient http) -> void
+
+      # Create an API credential (`POST /auth/credentials`) → the only secret-bearing response.
+      def create: (?request_options: request_opts, **untyped fields) -> Dinie::CredentialWithSecret
+
+      # List API credentials (`GET /auth/credentials`), auto-paginating by `starting_after`.
+      def list: (?limit: Integer, ?starting_after: String, ?request_options: request_opts) -> Dinie::Page[Dinie::Credential]
+
+      # Revoke an API credential (`DELETE /auth/credentials/{client_id}` → 204).
+      def revoke: (String client_id, ?request_options: request_opts) -> nil
+    end
+  end
+end

data/sig/dinie/generated/resources/credit_offers.rbs

@@ -0,0 +1,19 @@
+# `Resources::CreditOffers` — the `client.credit_offers` resource (architecture §3.2). Mirrors
+# `lib/dinie/generated/resources/credit_offers.rb`. No `create` (R10) — offers are minted by the Core.
+
+module Dinie
+  module Resources
+    class CreditOffers
+      def initialize: (Dinie::Internal::HttpClient http) -> void
+
+      # List credit offers (`GET /credit-offers`), auto-paginating by `starting_after`.
+      def list: (?limit: Integer, ?starting_after: String, ?request_options: request_opts, **untyped filters) -> Dinie::Page[Dinie::CreditOffer]
+
+      # Retrieve a single credit offer (`GET /credit-offers/{id}`).
+      def retrieve: (String id, ?request_options: request_opts) -> Dinie::CreditOffer
+
+      # Price an offer (`POST /credit-offers/{id}/simulations`).
+      def create_simulation: (String credit_offer_id, ?request_options: request_opts, **untyped fields) -> Dinie::Simulation
+    end
+  end
+end

data/sig/dinie/generated/resources/customers.rbs

@@ -0,0 +1,58 @@
+# `Resources::Customers` — the largest resource (architecture §3.1, §3.2). Mirrors
+# `lib/dinie/generated/resources/customers.rb`. THE exemplar resource shape (008/010 copy it).
+
+module Dinie
+  module Resources
+    class Customers
+      def initialize: (Dinie::Internal::HttpClient http) -> void
+
+      # Register a new customer (`POST /customers`).
+      def create: (email: String, phone: String, cpf: String, cnpj: String, ?name: String, ?external_id: String, ?request_options: request_opts) -> Dinie::Customer
+
+      # List and search customers (`GET /customers`), auto-paginating by `starting_after`.
+      def list: (?limit: Integer, ?starting_after: String, ?request_options: request_opts, **untyped filters) -> Dinie::Page[Dinie::Customer]
+
+      # Retrieve the full customer object (`GET /customers/{id}`).
+      def retrieve: (String id, ?request_options: request_opts) -> Dinie::Customer
+
+      # Update mutable customer fields (`PATCH /customers/{id}`).
+      def update: (String id, ?request_options: request_opts, **untyped fields) -> Dinie::Customer
+
+      # Retrieve the customer's linked bank account (`GET /customers/{id}/bank-account`).
+      def retrieve_bank_account: (String customer_id, ?request_options: request_opts) -> Dinie::CustomerBankAccount
+
+      # Create or update the customer's disbursement bank account (`POST /customers/{id}/bank-account`).
+      def upsert_bank_account: (String customer_id, ?request_options: request_opts, **untyped fields) -> Dinie::CustomerBankAccount
+
+      # Generate a temporary biometrics-capture session (`POST /customers/{id}/biometrics`).
+      def create_biometrics_session: (String customer_id, ?request_options: request_opts) -> Dinie::BiometricsSession
+
+      # KYC review trigger (`POST /customers/{id}/kyc-review` → 202, no content).
+      def start_kyc_review: (String customer_id, ?request_options: request_opts) -> nil
+
+      # The customer credit-offers subresource (`customers.credit_offers`).
+      def credit_offers: () -> Dinie::Resources::Customers::CreditOffers
+
+      # The KYC attachments subresource (`customers.kyc_attachments`).
+      def kyc_attachments: () -> Dinie::Resources::Customers::KycAttachments
+
+      private
+
+      def paginated_query: (limit: untyped, starting_after: untyped, cursor: untyped, filters: Hash[Symbol, untyped]) -> Hash[Symbol, untyped]
+
+      # `customers.credit_offers` — list a single customer's credit offers.
+      class CreditOffers
+        def initialize: (Dinie::Internal::HttpClient http) -> void
+
+        def list: (String customer_id, ?limit: Integer, ?starting_after: String, ?request_options: request_opts, **untyped filters) -> Dinie::Page[Dinie::CreditOffer]
+      end
+
+      # `customers.kyc_attachments` — the KYC attachment-upload subresource.
+      class KycAttachments
+        def initialize: (Dinie::Internal::HttpClient http) -> void
+
+        def create: (String customer_id, ?request_options: request_opts, **untyped upload) -> Dinie::Kyc::AttachmentResponse
+      end
+    end
+  end
+end

data/sig/dinie/generated/resources/loans.rbs

@@ -0,0 +1,26 @@
+# `Resources::Loans` — the `client.loans` resource + the `loans.transactions` subresource
+# (architecture §3.2, §3.1). Mirrors `lib/dinie/generated/resources/loans.rb`.
+
+module Dinie
+  module Resources
+    class Loans
+      def initialize: (Dinie::Internal::HttpClient http) -> void
+
+      # Create a loan from an accepted credit-offer simulation (`POST /loans`).
+      def create: (credit_offer_id: String, simulation_id: String, installment_count: Integer, installment_amount: Float, first_due_date: String, ?request_options: request_opts) -> Dinie::Loan
+
+      # Retrieve a single loan (`GET /loans/{id}`).
+      def retrieve: (String id, ?request_options: request_opts) -> Dinie::Loan
+
+      # The loan transactions subresource (`loans.transactions`).
+      def transactions: () -> Dinie::Resources::Loans::Transactions
+
+      # `loans.transactions` — list a single loan's installments.
+      class Transactions
+        def initialize: (Dinie::Internal::HttpClient http) -> void
+
+        def list: (String loan_id, ?limit: Integer, ?starting_after: String, ?request_options: request_opts) -> Dinie::Page[Dinie::Transaction]
+      end
+    end
+  end
+end

data/sig/dinie/generated/resources/webhook_endpoints.rbs

@@ -0,0 +1,35 @@
+# `Resources::WebhookEndpoints` — the `client.webhook_endpoints` resource: REST management of
+# webhook endpoints (architecture §3.2). Mirrors `lib/dinie/generated/resources/webhook_endpoints.rb`.
+# Distinct from event reception (`Dinie::Webhooks.extract`).
+
+module Dinie
+  module Resources
+    class WebhookEndpoints
+      WEBHOOK_ENDPOINTS_PATH: String
+
+      def initialize: (Dinie::Internal::HttpClient http) -> void
+
+      # Create a webhook endpoint (`POST /webhooks/endpoints`) → the secret-bearing response.
+      def create: (?request_options: request_opts, **untyped fields) -> Dinie::WebhookEndpointWithSecret
+
+      # List webhook endpoints (`GET /webhooks/endpoints`), auto-paginating by `starting_after`.
+      def list: (?limit: Integer, ?starting_after: String, ?request_options: request_opts) -> Dinie::Page[Dinie::WebhookEndpoint]
+
+      # Retrieve a webhook endpoint by id (`GET /webhooks/endpoints/{id}`).
+      def retrieve: (String id, ?request_options: request_opts) -> Dinie::WebhookEndpoint
+
+      # Update a webhook endpoint (`PATCH /webhooks/endpoints/{id}`).
+      def update: (String id, ?request_options: request_opts, **untyped fields) -> Dinie::WebhookEndpoint
+
+      # Delete a webhook endpoint (`DELETE /webhooks/endpoints/{id}` → 204).
+      def delete: (String id, ?request_options: request_opts) -> nil
+
+      # Rotate the HMAC signing secret (`POST /webhooks/endpoints/{id}/rotate-secret`).
+      def rotate_secret: (String id, ?expire_current_in: Integer, ?request_options: request_opts) -> Dinie::WebhookSecretRotation
+
+      private
+
+      def endpoint_path: (String id) -> String
+    end
+  end
+end

data/sig/dinie/generated/types/bank.rbs

@@ -0,0 +1,12 @@
+# `Bank` — a bank-directory entry, read-only (architecture §3.3, §6, §11). Mirrors
+# `lib/dinie/generated/types/bank.rb`. `id` is the COMPE code string (`"001"`), not a `*_…` id.
+
+module Dinie
+  class Bank < Internal::Model
+    attr_reader display_name: String
+    attr_reader id: String
+    attr_reader name: String
+
+    def self.deserialize: (Hash[Symbol, untyped] raw) -> Bank
+  end
+end

data/sig/dinie/generated/types/biometrics_session.rbs

@@ -0,0 +1,11 @@
+# `BiometricsSession` — a temporary biometrics-capture session, read-only (architecture §3.3, §6).
+# Mirrors `lib/dinie/generated/types/biometrics_session.rb`.
+
+module Dinie
+  class BiometricsSession < Internal::Model
+    attr_reader expires_at: Integer
+    attr_reader session_url: String
+
+    def self.deserialize: (Hash[Symbol, untyped] raw) -> BiometricsSession
+  end
+end

data/sig/dinie/generated/types/credential.rbs

@@ -0,0 +1,26 @@
+# `Credential` + `CredentialWithSecret` (allOf → subclass) — API-key management (architecture
+# §3.3, §6). Mirrors `lib/dinie/generated/types/credential.rb`.
+
+module Dinie
+  class Credential < Internal::Model
+    attr_reader client_id: api_client_id
+    attr_reader created_at: Integer
+    attr_reader expires_at: Integer?
+    attr_reader id: api_client_id
+    attr_reader last_used_at: Integer?
+    attr_reader name: String
+    attr_reader status: credential_status
+    attr_reader updated_at: Integer
+
+    def self.deserialize: (Hash[Symbol, untyped] raw) -> Credential
+
+    def self.serialize_create: (name: String, ?expires_at: Integer?) -> Hash[Symbol, untyped]
+  end
+
+  # The creation-only credential — `Credential` plus `client_secret` (the contract's allOf).
+  class CredentialWithSecret < Credential
+    attr_reader client_secret: String
+
+    def self.deserialize: (Hash[Symbol, untyped] raw) -> CredentialWithSecret
+  end
+end

data/sig/dinie/generated/types/credit_offer.rbs

@@ -0,0 +1,24 @@
+# `CreditOffer` — a pre-approved credit offer (`co_…`), read-only (architecture §3.3, §6).
+# Mirrors `lib/dinie/generated/types/credit_offer.rb`. installments XOR min/max — all three
+# declared, exclusivity documented not enforced.
+
+module Dinie
+  class CreditOffer < Internal::Model
+    attr_reader approved_amount: money
+    attr_reader created_at: Integer
+    attr_reader customer_id: customer_id
+    attr_reader due_date_rule: String?
+    attr_reader external_id: String?
+    attr_reader id: credit_offer_id
+    attr_reader installments: Integer?
+    attr_reader max_installments: Integer?
+    attr_reader min_amount: Float
+    attr_reader min_installments: Integer?
+    attr_reader monthly_interest_rate: Float
+    attr_reader status: credit_offer_status
+    attr_reader updated_at: Integer
+    attr_reader valid_until: Integer
+
+    def self.deserialize: (Hash[Symbol, untyped] raw) -> CreditOffer
+  end
+end

data/sig/dinie/generated/types/customer.rbs

@@ -0,0 +1,25 @@
+# `Customer` — the full read model + its two request dumps (architecture §6, §3.3). THE exemplar
+# (de)serializer shape. Mirrors `lib/dinie/generated/types/customer.rb`.
+
+module Dinie
+  class Customer < Internal::Model
+    attr_reader cnpj: String?
+    attr_reader cpf: String
+    attr_reader created_at: Integer
+    attr_reader email: String
+    attr_reader external_id: String?
+    attr_reader id: customer_id
+    attr_reader kyc: Array[Kyc::Requirement]?
+    attr_reader name: String?
+    attr_reader phone: String
+    attr_reader status: customer_status
+    attr_reader trading_name: String?
+    attr_reader updated_at: Integer
+
+    def self.deserialize: (Hash[Symbol, untyped] raw) -> Customer
+
+    def self.serialize_create: (email: String, phone: String, cpf: String, cnpj: String, ?name: String, ?external_id: String) -> Hash[Symbol, untyped]
+
+    def self.serialize_update: (?email: String, ?phone: String) -> Hash[Symbol, untyped]
+  end
+end