multicard 0.1.0

data/lib/multicard/token_manager.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Multicard
+  class TokenManager
+    TOKEN_TTL = 23 * 3600 # Refresh 1 hour before 24h expiry
+
+    def initialize(http_client, config)
+      @http_client = http_client
+      @config = config
+      @token = nil
+      @expires_at = nil
+      @mutex = Mutex.new
+    end
+
+    def token
+      @mutex.synchronize do
+        refresh! if expired?
+        @token
+      end
+    end
+
+    def reset!
+      @mutex.synchronize do
+        @token = nil
+        @expires_at = nil
+      end
+    end
+
+    private
+
+    def refresh!
+      response = @http_client.post(
+        '/auth',
+        body: {
+          application_id: @config.application_id,
+          secret: @config.secret
+        }
+      )
+      # Auth endpoint returns {"token": "..."} directly, not wrapped in {"success": true, "data": {...}}
+      @token = response.body[:token]
+      raise AuthenticationError, 'Auth response missing token' unless @token
+
+      @expires_at = Time.now + TOKEN_TTL
+    end
+
+    def expired?
+      @token.nil? || @expires_at.nil? || Time.now >= @expires_at
+    end
+  end
+end

data/lib/multicard/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Multicard
+  VERSION = '0.1.0'
+end

data/lib/multicard.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative 'multicard/version'
+require_relative 'multicard/configuration'
+require_relative 'multicard/errors'
+require_relative 'multicard/response'
+require_relative 'multicard/http_client'
+require_relative 'multicard/token_manager'
+require_relative 'multicard/signature'
+require_relative 'multicard/client'
+require_relative 'multicard/resources/base'
+require_relative 'multicard/resources/invoices'
+require_relative 'multicard/resources/payments'
+require_relative 'multicard/resources/cards'
+require_relative 'multicard/resources/holds'
+require_relative 'multicard/resources/payouts'
+require_relative 'multicard/resources/registry'
+
+module Multicard
+  class << self
+    attr_reader :configuration
+
+    # Configure the gem globally (optional — you can also pass config per-client).
+    #
+    #   Multicard.configure do |config|
+    #     config.application_id = ENV["MULTICARD_APPLICATION_ID"]
+    #     config.secret = ENV["MULTICARD_SECRET"]
+    #     config.store_id = 123
+    #   end
+    #
+    def configure
+      @configuration = Configuration.new
+      yield(@configuration) if block_given?
+      @configuration
+    end
+
+    # Reset global configuration (useful in tests).
+    def reset_configuration!
+      @configuration = nil
+    end
+  end
+end

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: multicard
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Honey Murena
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Ruby SDK for Multicard.uz — payment gateway supporting Uzcard, Humo,
+  and 9 wallet apps (Payme, Click, Uzum, etc.). Invoices, card payments, splits, holds,
+  payouts, card binding, and webhook verification.
+email:
+- dev@honeymurena.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/multicard.rb
+- lib/multicard/client.rb
+- lib/multicard/configuration.rb
+- lib/multicard/errors.rb
+- lib/multicard/http_client.rb
+- lib/multicard/resources/base.rb
+- lib/multicard/resources/cards.rb
+- lib/multicard/resources/holds.rb
+- lib/multicard/resources/invoices.rb
+- lib/multicard/resources/payments.rb
+- lib/multicard/resources/payouts.rb
+- lib/multicard/resources/registry.rb
+- lib/multicard/response.rb
+- lib/multicard/signature.rb
+- lib/multicard/token_manager.rb
+- lib/multicard/version.rb
+homepage: https://github.com/pashgo/multicard-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/pashgo/multicard-ruby
+  source_code_uri: https://github.com/pashgo/multicard-ruby
+  changelog_uri: https://github.com/pashgo/multicard-ruby/blob/main/CHANGELOG.md
+  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.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: Ruby client for the Multicard payment gateway (Uzbekistan)
+test_files: []