nombaone 0.1.0

data/lib/nombaone.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative "nombaone/version"
+require_relative "nombaone/errors"
+require_relative "nombaone/internal/util"
+require_relative "nombaone/object"
+require_relative "nombaone/pagination"
+require_relative "nombaone/internal/http_client"
+require_relative "nombaone/resources/base_resource"
+require_relative "nombaone/resources/customers"
+require_relative "nombaone/resources/plans"
+require_relative "nombaone/resources/prices"
+require_relative "nombaone/resources/subscriptions"
+require_relative "nombaone/resources/invoices"
+require_relative "nombaone/resources/coupons"
+require_relative "nombaone/resources/payment_methods"
+require_relative "nombaone/resources/mandates"
+require_relative "nombaone/resources/settlements"
+require_relative "nombaone/resources/webhook_endpoints"
+require_relative "nombaone/resources/events"
+require_relative "nombaone/resources/organization"
+require_relative "nombaone/resources/metrics"
+require_relative "nombaone/resources/sandbox"
+require_relative "nombaone/webhook_event"
+require_relative "nombaone/webhooks"
+require_relative "nombaone/client"
+
+# NombaOne — recurring billing for Nigeria over card, direct debit, bank
+# transfer, and more, with dunning that recovers and a ledger that never loses
+# a kobo. This module is the SDK's namespace and entrypoint.
+#
+# @example Construct a client
+#   nombaone = Nombaone.new(ENV["NOMBAONE_API_KEY"])
+#   customer = nombaone.customers.create(email: "ada@example.com", name: "Ada")
+#
+# @example Verify a webhook without a client (only the signing secret is needed)
+#   event = Nombaone.webhooks.construct_event(raw_body, signature_header, secret)
+module Nombaone
+  # Construct a new API client.
+  #
+  # @param api_key [String, nil] your secret key (`nbo_sandbox_…` / `nbo_live_…`).
+  #   Defaults to `ENV["NOMBAONE_API_KEY"]`.
+  # @param options [Hash] see {Client#initialize} (`base_url:`, `timeout:`,
+  #   `max_retries:`, `http:`, `default_headers:`).
+  # @return [Nombaone::Client]
+  def self.new(api_key = nil, **options)
+    Client.new(api_key, **options)
+  end
+
+  # A shared, keyless {Webhooks} helper for verifying inbound deliveries.
+  # Webhook verification needs only the endpoint's signing secret, never an API
+  # key — so this is usable in a receiver that never constructs a client.
+  #
+  # @return [Nombaone::Webhooks]
+  def self.webhooks
+    @webhooks ||= Webhooks.new
+  end
+end

data/sig/nombaone/client.rbs

@@ -0,0 +1,36 @@
+module Nombaone
+  class Client
+    BASE_URLS: Hash[String, String]
+    DEFAULT_TIMEOUT: Integer
+    DEFAULT_MAX_RETRIES: Integer
+
+    attr_reader mode: String
+    attr_reader base_url: String
+
+    def initialize: (?String? api_key, ?base_url: String?, ?timeout: Numeric,
+                     ?max_retries: Integer, ?http: untyped, ?default_headers: Hash[String, String]?,
+                     ?sleeper: (^(Numeric) -> void)?) -> void
+
+    def customers: () -> Nombaone::Resources::Customers
+    def plans: () -> Nombaone::Resources::Plans
+    def prices: () -> Nombaone::Resources::Prices
+    def subscriptions: () -> Nombaone::Resources::Subscriptions
+    def invoices: () -> Nombaone::Resources::Invoices
+    def coupons: () -> Nombaone::Resources::Coupons
+    def payment_methods: () -> Nombaone::Resources::PaymentMethods
+    def mandates: () -> Nombaone::Resources::Mandates
+    def settlements: () -> Nombaone::Resources::Settlements
+    def webhook_endpoints: () -> Nombaone::Resources::WebhookEndpoints
+    def events: () -> Nombaone::Resources::Events
+    def organization: () -> Nombaone::Resources::Organization
+    def metrics: () -> Nombaone::Resources::Metrics
+    def sandbox: () -> Nombaone::Resources::Sandbox
+    def webhooks: () -> Nombaone::Webhooks
+
+    def request: (method: Symbol, path: String, ?query: Hash[Symbol, untyped]?,
+                  ?body: Hash[Symbol, untyped]?, ?options: Hash[Symbol, untyped]?)
+                  -> Nombaone::NombaObject
+    def request_page: (method: Symbol, path: String, ?query: Hash[Symbol, untyped]?,
+                       ?options: Hash[Symbol, untyped]?) -> Nombaone::Page
+  end
+end

data/sig/nombaone/errors.rbs

@@ -0,0 +1,68 @@
+module Nombaone
+  module ErrorCode
+    ALL: Array[String]
+  end
+
+  class Error < StandardError
+  end
+
+  class APIError < Error
+    attr_reader status_code: Integer
+    attr_reader code: String
+    attr_reader hint: String
+    attr_reader doc_url: String
+    attr_reader fields: Hash[String, Array[String]]?
+    attr_reader request_id: String?
+
+    def initialize: (String message, status_code: Integer, code: String, ?hint: String,
+                     ?doc_url: String, ?fields: Hash[String, Array[String]]?,
+                     ?request_id: String?) -> void
+
+    def self.from_response: (Integer status, untyped body, untyped headers) -> APIError
+    def self.default_code_for_status: (Integer status) -> String
+    def self.parse_error_body: (untyped body) -> Hash[Symbol, untyped]
+    def self.numeric: (untyped value) -> (Integer | Float)?
+
+    CLASS_FOR_STATUS: Hash[Integer, singleton(APIError)]
+    DEFAULT_CODE_FOR_STATUS: Hash[Integer, String]
+  end
+
+  class BadRequestError < APIError
+  end
+
+  class AuthenticationError < APIError
+  end
+
+  class PermissionDeniedError < APIError
+  end
+
+  class NotFoundError < APIError
+  end
+
+  class ConflictError < APIError
+  end
+
+  class ValidationError < APIError
+  end
+
+  class ServerError < APIError
+  end
+
+  class RateLimitError < APIError
+    attr_reader retry_after: (Integer | Float)?
+    attr_reader limit: (Integer | Float)?
+    attr_reader remaining: (Integer | Float)?
+
+    def initialize: (String message, ?retry_after: (Integer | Float)?, ?limit: (Integer | Float)?,
+                     ?remaining: (Integer | Float)?, **untyped details) -> void
+  end
+
+  class ConnectionError < Error
+  end
+
+  class TimeoutError < ConnectionError
+  end
+
+  class WebhookVerificationError < Error
+  end
+end

data/sig/nombaone/internal.rbs

@@ -0,0 +1,51 @@
+module Nombaone
+  module Internal
+    OMIT: Object
+
+    module Util
+      PRESERVE_VALUE_KEYS: Array[String]
+
+      def self?.camelize: (String | Symbol key) -> String
+      def self?.deep_camelize_keys: (untyped value) -> untyped
+      def self?.serialize_body: (Hash[untyped, untyped] hash) -> Hash[String, untyped]
+      def self?.serialize_query: (Hash[untyped, untyped] hash) -> Hash[String, String]
+      def self?.encode_path_segment: (untyped value) -> String
+      def self?.generate_idempotency_key: () -> String
+      def self?.backoff_seconds: (Integer attempt) -> Float
+      def self?.retry_after_seconds: (String? raw) -> Float?
+      def self?.merge_headers: (*Hash[untyped, untyped]? layers) -> Hash[String, String]
+    end
+
+    class Response < Struct[untyped]
+      attr_accessor status: Integer
+      attr_accessor headers: Hash[String, String]
+      attr_accessor body: String?
+    end
+
+    class Result < Struct[untyped]
+      attr_accessor data: untyped
+      attr_accessor pagination: Hash[Symbol, untyped]?
+      attr_accessor request_id: String?
+      attr_accessor response: Nombaone::Internal::Response
+    end
+
+    class NetHTTPConnection
+      METHOD_CLASSES: Hash[Symbol, untyped]
+
+      def execute: (method: Symbol, url: String, headers: Hash[String, String], body: String?,
+                    timeout: Numeric) -> Nombaone::Internal::Response
+    end
+
+    class HTTPClient
+      API_PREFIX: String
+      RETRYABLE_STATUSES: Array[Integer]
+
+      def initialize: (api_key: String, base_url: String, timeout: Numeric, max_retries: Integer,
+                       connection: untyped, ?default_headers: Hash[String, String]?,
+                       ?sleeper: (^(Numeric) -> void)?) -> void
+      def request: (method: Symbol, path: String, ?query: Hash[String, String]?,
+                    ?body: Hash[String, untyped]?, ?options: Hash[Symbol, untyped]?)
+                    -> Nombaone::Internal::Result
+    end
+  end
+end

data/sig/nombaone/object.rbs

@@ -0,0 +1,22 @@
+module Nombaone
+  class NombaObject
+    attr_reader request_id: String?
+    attr_reader last_response: untyped
+
+    def initialize: (untyped values, ?request_id: String?, ?response: untyped) -> void
+    def []: (String | Symbol key) -> untyped
+    def dig: (*(String | Symbol | Integer) keys) -> untyped
+    def key?: (String | Symbol key) -> bool
+    alias has_key? key?
+    alias member? key?
+    def keys: () -> Array[String]
+    def to_h: () -> Hash[String, untyped]
+    alias to_hash to_h
+    def ==: (untyped other) -> bool
+    alias eql? ==
+    def hash: () -> Integer
+    def inspect: () -> String
+    def respond_to_missing?: (Symbol name, ?bool include_private) -> bool
+    def method_missing: (Symbol name, *untyped args) -> untyped
+  end
+end

data/sig/nombaone/pagination.rbs

@@ -0,0 +1,23 @@
+module Nombaone
+  class Page
+    include Enumerable[Nombaone::NombaObject]
+
+    attr_reader data: Array[Nombaone::NombaObject]
+    attr_reader request_id: String?
+
+    def initialize: (fetcher: ^(Hash[Symbol, untyped]) -> untyped, query: Hash[Symbol, untyped],
+                     result: untyped) -> void
+    def limit: () -> Integer
+    def has_more?: () -> bool
+    def next_cursor: () -> String?
+    def next_page?: () -> bool
+    alias has_next_page? next_page?
+    def pagination: () -> Nombaone::NombaObject
+    def next_page: () -> Nombaone::Page
+    def each: () { (Nombaone::NombaObject) -> void } -> self
+            | () -> Enumerator[Nombaone::NombaObject, self]
+    alias auto_paging_each each
+    def each_page: () { (Nombaone::Page) -> void } -> self
+                 | () -> Enumerator[Nombaone::Page, self]
+  end
+end

data/sig/nombaone/resources.rbs

@@ -0,0 +1,243 @@
+module Nombaone
+  module Resources
+    OMIT: Object
+
+    class BaseResource
+      def initialize: (Nombaone::Client client) -> void
+
+      private
+
+      def request: (Symbol method, String path, ?body: Hash[Symbol, untyped]?,
+                    ?query: Hash[Symbol, untyped]?, ?options: Hash[Symbol, untyped])
+                    -> Nombaone::NombaObject
+      def request_page: (String path, ?query: Hash[Symbol, untyped]?,
+                         ?options: Hash[Symbol, untyped]) -> Nombaone::Page
+      def encode: (untyped value) -> String
+    end
+
+    class Customers < BaseResource
+      def create: (email: String, name: String, ?phone: String?, ?metadata: Nombaone::metadata,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def update: (String id, ?name: String, ?phone: String?, ?metadata: Nombaone::metadata,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?email: String, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def apply_discount: (String id, coupon: String,
+                           ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def remove_discount: (String id,
+                            ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def grant_credit: (String id, amount_in_kobo: Integer, ?source: String,
+                         ?source_reference: String, ?metadata: Nombaone::metadata,
+                         ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def retrieve_credit_balance: (String id, ?request_options: Nombaone::request_options)
+                                    -> Nombaone::NombaObject
+      def void_credit: (String id, String grant_id, ?request_options: Nombaone::request_options)
+                        -> Nombaone::NombaObject
+    end
+
+    class PlanPrices < BaseResource
+      def create: (String plan_id, unit_amount_in_kobo: Integer, interval: String,
+                   ?interval_count: Integer, ?usage_type: String, ?billing_scheme: String,
+                   ?trial_period_days: Integer, ?metadata: Nombaone::metadata,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (String plan_id, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+    end
+
+    class Plans < BaseResource
+      def prices: () -> Nombaone::Resources::PlanPrices
+      def create: (name: String, ?description: String, ?metadata: Nombaone::metadata,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def update: (String id, ?name: String, ?description: String?, ?metadata: Nombaone::metadata,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?status: String, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def archive: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+    end
+
+    class Prices < BaseResource
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?plan_ref: String, ?active: bool, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def deactivate: (String id, ?request_options: Nombaone::request_options)
+                       -> Nombaone::NombaObject
+    end
+
+    class SubscriptionSchedules < BaseResource
+      def create: (String subscription_id, price_id: String, ?quantity: Integer,
+                   ?effective_at: String, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+      def retrieve: (String subscription_id, ?request_options: Nombaone::request_options)
+                    -> Nombaone::NombaObject
+      def release: (String subscription_id, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+    end
+
+    class SubscriptionDunning < BaseResource
+      def retrieve: (String subscription_id, ?request_options: Nombaone::request_options)
+                    -> Nombaone::NombaObject
+      def list_attempts: (String subscription_id, ?limit: Integer, ?cursor: String,
+                          ?request_options: Nombaone::request_options) -> Nombaone::Page
+    end
+
+    class Subscriptions < BaseResource
+      def schedule: () -> Nombaone::Resources::SubscriptionSchedules
+      def dunning: () -> Nombaone::Resources::SubscriptionDunning
+      def create: (customer_id: String, price_id: String, ?payment_method_id: String,
+                   ?collection_method: String, ?trial_days: Integer, ?quantity: Integer,
+                   ?metadata: Nombaone::metadata, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def update: (String id, ?default_payment_method_id: String, ?metadata: Nombaone::metadata,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?customer_id: String, ?status: String, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def list_events: (String id, ?limit: Integer, ?cursor: String,
+                        ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def pause: (String id, ?max_days: Integer, ?request_options: Nombaone::request_options)
+                 -> Nombaone::NombaObject
+      def resume: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def cancel: (String id, ?mode: String, ?comment: String,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def resubscribe: (String id, ?price_id: String, ?payment_method_id: String,
+                        ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def change: (String id, ?price_id: String, ?quantity: Integer, ?interval_switch: bool,
+                   ?proration_behavior: String, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+      def update_payment_method: (String id, ?payment_method_reference: String,
+                                  ?checkout_token: String,
+                                  ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def retrieve_upcoming_invoice: (String id, ?request_options: Nombaone::request_options)
+                                      -> Nombaone::NombaObject
+      def apply_discount: (String id, coupon: String,
+                           ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def remove_discount: (String id, ?request_options: Nombaone::request_options)
+                           -> Nombaone::NombaObject
+    end
+
+    class Invoices < BaseResource
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?customer_id: String, ?subscription_id: String, ?status: String, ?limit: Integer,
+                 ?cursor: String, ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def void: (String id, ?comment: String, ?request_options: Nombaone::request_options)
+                -> Nombaone::NombaObject
+    end
+
+    class Coupons < BaseResource
+      def create: (code: String, duration: String, ?amount_off_in_kobo: Integer,
+                   ?percent_off: Integer, ?duration_in_cycles: Integer, ?redeem_by: String,
+                   ?max_redemptions: Integer, ?metadata: Nombaone::metadata,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def update: (String id, ?redeem_by: String, ?max_redemptions: Integer,
+                   ?metadata: Nombaone::metadata, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+      def list: (?limit: Integer, ?cursor: String, ?request_options: Nombaone::request_options)
+                -> Nombaone::Page
+    end
+
+    class PaymentMethods < BaseResource
+      def setup: (customer_ref: String, amount_in_kobo: Integer, callback_url: String,
+                  ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def create_virtual_account: (customer_ref: String, ?expected_amount: Integer,
+                                   ?expiry_date: String,
+                                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?customer_ref: String, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def set_default: (String id, ?request_options: Nombaone::request_options)
+                       -> Nombaone::NombaObject
+      def remove: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+    end
+
+    class Mandates < BaseResource
+      def create: (customer_ref: String, customer_account_number: String, bank_code: String,
+                   customer_name: String, customer_account_name: String,
+                   customer_phone_number: String, customer_address: String, narration: String,
+                   max_amount_in_kobo: Integer, ?frequency: String, ?start_date: String,
+                   ?end_date: String, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+    end
+
+    class Settlements < BaseResource
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?status: String, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def retrieve_escrow: (?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def refund: (String id, ?amount_in_kobo: Integer,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def create_payout: (amount_in_kobo: Integer, bank_code: String, account_number: String,
+                          ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+    end
+
+    class WebhookEndpointDeliveries < BaseResource
+      def list: (String endpoint_id, ?status: String, ?event_type: String, ?endpoint: String,
+                 ?limit: Integer, ?cursor: String, ?request_options: Nombaone::request_options)
+                 -> Nombaone::Page
+      def retrieve: (String endpoint_id, String delivery_id,
+                     ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def replay: (String endpoint_id, String delivery_id,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+    end
+
+    class WebhookEndpoints < BaseResource
+      def deliveries: () -> Nombaone::Resources::WebhookEndpointDeliveries
+      def create: (url: String, ?enabled_events: Array[String],
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def update: (String id, ?url: String, ?enabled_events: Array[String], ?disabled: bool,
+                   ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def list: (?request_options: Nombaone::request_options) -> Nombaone::Page
+      def delete: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def rotate_secret: (String id, ?request_options: Nombaone::request_options)
+                         -> Nombaone::NombaObject
+    end
+
+    class Events < BaseResource
+      def list: (?type: String, ?limit: Integer, ?cursor: String,
+                 ?request_options: Nombaone::request_options) -> Nombaone::Page
+      def retrieve: (String id, ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def catalog: (?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+    end
+
+    class OrganizationBilling < BaseResource
+      def retrieve: (?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def update: (?partial_collection_enabled: bool, ?proration_credit_policy: String,
+                   ?dunning_max_attempts: Integer, ?dunning_intervals_hours: Array[Integer],
+                   ?dunning_max_window_hours: Integer, ?grace_period_hours: Integer,
+                   ?payday_days: Array[Integer], ?payday_pull_forward_days: Integer,
+                   ?payday_bias_enabled: bool, ?default_collection_method: String,
+                   ?comms_enabled: bool, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+    end
+
+    class Organization < BaseResource
+      def billing: () -> Nombaone::Resources::OrganizationBilling
+      def retrieve: (?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def update: (?monthly_request_quota: Integer, ?settlement_mode: String,
+                   ?branding: Hash[Symbol, untyped], ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+    end
+
+    class Metrics < BaseResource
+      def billing: (?from: String, ?to: String, ?request_options: Nombaone::request_options)
+                   -> Nombaone::NombaObject
+    end
+
+    class Sandbox < BaseResource
+      def create_payment_method: (customer_id: String, ?behavior: String, ?kind: String,
+                                  ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+      def advance_cycle: (String subscription_id, ?request_options: Nombaone::request_options)
+                         -> Nombaone::NombaObject
+      def simulate_webhook: (type: String, ?payload: Hash[Symbol | String, untyped],
+                             ?request_options: Nombaone::request_options) -> Nombaone::NombaObject
+
+      private
+
+      def assert_sandbox!: () -> void
+    end
+  end
+end

data/sig/nombaone/webhooks.rbs

@@ -0,0 +1,18 @@
+module Nombaone
+  module WebhookEventType
+    ALL: Array[String]
+  end
+
+  class WebhookEvent < Nombaone::NombaObject
+  end
+
+  class Webhooks
+    DEFAULT_TOLERANCE_SECONDS: Integer
+
+    def construct_event: (String payload, String? signature_header, String? secret,
+                          ?tolerance: Numeric) -> Nombaone::WebhookEvent
+    def verify_signature: (String payload, String? signature_header, String? secret,
+                           ?tolerance: Numeric) -> bool
+    def generate_test_header: (payload: String, secret: String, ?timestamp: Integer?) -> String
+  end
+end

data/sig/nombaone.rbs

@@ -0,0 +1,24 @@
+# Type signatures for the NombaOne Ruby SDK.
+
+module Nombaone
+  VERSION: String
+
+  # Free-form annotations attached to most resources. Keys are stored verbatim.
+  type metadata = Hash[Symbol | String, untyped]
+
+  # Per-call overrides accepted by every SDK method as `request_options:`.
+  # Recognized keys: :idempotency_key, :headers, :timeout, :max_retries, :cancel_when.
+  type request_options = Hash[Symbol, untyped]
+
+  # A single-object request result.
+  type record = Nombaone::NombaObject
+
+  # A list request result.
+  type page = Nombaone::Page
+
+  def self.new: (?String? api_key, ?base_url: String?, ?timeout: Numeric,
+                 ?max_retries: Integer, ?http: untyped, ?default_headers: Hash[String, String]?,
+                 ?sleeper: (^(Numeric) -> void)?) -> Nombaone::Client
+
+  def self.webhooks: () -> Nombaone::Webhooks
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: nombaone
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nomba One
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-07 00:00:00.000000000 Z
+dependencies: []
+description: Recurring billing for Nigeria over card, direct debit, bank transfer,
+  and more — with dunning that recovers, idempotency that can never double-charge,
+  and a ledger that never loses a kobo. Zero runtime dependencies.
+email:
+- developers@nombaone.xyz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/nombaone.rb
+- lib/nombaone/client.rb
+- lib/nombaone/errors.rb
+- lib/nombaone/internal/http_client.rb
+- lib/nombaone/internal/util.rb
+- lib/nombaone/object.rb
+- lib/nombaone/pagination.rb
+- lib/nombaone/resources/base_resource.rb
+- lib/nombaone/resources/coupons.rb
+- lib/nombaone/resources/customers.rb
+- lib/nombaone/resources/events.rb
+- lib/nombaone/resources/invoices.rb
+- lib/nombaone/resources/mandates.rb
+- lib/nombaone/resources/metrics.rb
+- lib/nombaone/resources/organization.rb
+- lib/nombaone/resources/payment_methods.rb
+- lib/nombaone/resources/plans.rb
+- lib/nombaone/resources/prices.rb
+- lib/nombaone/resources/sandbox.rb
+- lib/nombaone/resources/settlements.rb
+- lib/nombaone/resources/subscriptions.rb
+- lib/nombaone/resources/webhook_endpoints.rb
+- lib/nombaone/version.rb
+- lib/nombaone/webhook_event.rb
+- lib/nombaone/webhooks.rb
+- sig/nombaone.rbs
+- sig/nombaone/client.rbs
+- sig/nombaone/errors.rbs
+- sig/nombaone/internal.rbs
+- sig/nombaone/object.rbs
+- sig/nombaone/pagination.rbs
+- sig/nombaone/resources.rbs
+- sig/nombaone/webhooks.rbs
+homepage: https://nombaone.xyz
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://nombaone.xyz
+  source_code_uri: https://github.com/nombaone/nombaone-ruby
+  changelog_uri: https://github.com/nombaone/nombaone-ruby/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/nombaone/nombaone-ruby/issues
+  documentation_uri: https://docs.nombaone.xyz
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: The official Ruby SDK for the NombaOne subscription-billing API.
+test_files: []