straddle_pay 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cea0fc12d897f53acbe7d6d8d16f3b9be978e688603d3d6ba47228fc51ac5364
-  data.tar.gz: 8ddb9535d91df18cfef8bc5ded89dc1fe73d0f12f762e9e95b0b14e9c95b754b
+  metadata.gz: 35b268470e5133d654d67346a63b4f4894e8c0e2eef3dba5a9d96fed73597ed1
+  data.tar.gz: 9283c984a2a944ad673a3a3aa2d851d1ed9b62b76268472e38858be35317616a
 SHA512:
-  metadata.gz: 797ba62b6cbe4024e39c930411ed8a0298c1f691b7b2d0156429c98dddc15a930886d55bed9377535838dfcddb69fa7e6e62348256d80b59ee33320e96684051
-  data.tar.gz: 8f4a5ae928ff8213d04367eaaed803b34cd4ce4cc20fead2fd2605741b5cbe9f118824fef28ba947156c4979302b33b9f8b747e94b4565229f564130e2280a8b
+  metadata.gz: f69d2db69c73cf79d3a88cc1c9be12f0a2bcd7490e30dd8bda952a1f7564c11bfe502268330345ca4ef34ca0c8a10a2d7ec5d776f4676bc2dd26a2f9e185b568
+  data.tar.gz: f38ef5de026721e84cad8e04cfe3843355d465e6df7af0168bd393a6f9422df6eef40396ada24a209c1f9830448a3c5d10811b479325aab03da436771ae14330

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.3.0] - 2026-02-20
+
+### Changed
+- Replace `base_url` with `environment: :sandbox/:production` as primary config
+- `STRADDLE_ENVIRONMENT` env var replaces `STRADDLE_BASE_URL` for environment selection
+- `base_url` remains as escape hatch for custom URLs
+- `ENVIRONMENTS` hash replaces `SANDBOX_URL`/`PRODUCTION_URL` constants
+- Client accepts `environment:` param for per-instance override
+
+## [0.2.0] - 2026-02-20
+
+### Added
+- Webhook signature verification following Svix protocol
+
 ## [0.1.5] - 2026-02-20
 
 ### Fixed

data/README.md

@@ -19,36 +19,36 @@ Configure once:
 
 ```ruby
 StraddlePay.configure do |config|
-  config.api_key  = ENV.fetch("STRADDLE_API_KEY")
-  config.base_url = StraddlePay::Config::PRODUCTION_URL  # default: sandbox
+  config.api_key     = ENV.fetch("STRADDLE_API_KEY")
+  config.environment = :production  # default: :sandbox
 end
 ```
 
+Or via environment variables:
+
+```sh
+STRADDLE_API_KEY=sk_live_...
+STRADDLE_ENVIRONMENT=production
+```
+
 Per-instance overrides:
 
 ```ruby
 client = StraddlePay::Client.new(
   api_key: "sk_different_key",
-  base_url: "https://production.straddle.com"
+  environment: :production
 )
 ```
 
-### Environments
-
-| Environment | URL |
-|-------------|-----|
-| Sandbox (default) | `https://sandbox.straddle.com` |
-| Production | `https://production.straddle.com` |
-
 ### Rails
 
 Create `config/initializers/straddle_pay.rb`:
 
 ```ruby
 StraddlePay.configure do |config|
-  config.api_key  = Rails.application.credentials.straddle_api_key
-  config.base_url = StraddlePay::Config::PRODUCTION_URL
-  config.logger   = Rails.logger
+  config.api_key     = Rails.application.credentials.straddle_api_key
+  config.environment = :production
+  config.logger      = Rails.logger
 end
 ```
 

data/lib/straddle_pay/client.rb

@@ -16,15 +16,16 @@ module StraddlePay
     attr_reader :base_url
 
     # @param api_key [String, nil] override global API key
-    # @param base_url [String, nil] override global base URL
+    # @param environment [Symbol, nil] :sandbox or :production (overrides global environment)
+    # @param base_url [String, nil] custom base URL (takes precedence over environment)
     # @param logger [Logger, nil] override global logger
     # @param open_timeout [Integer, nil] connection open timeout in seconds
     # @param read_timeout [Integer, nil] response read timeout in seconds
     # @raise [ArgumentError] if no API key is configured
-    def initialize(api_key: nil, base_url: nil, logger: nil, open_timeout: nil, read_timeout: nil)
+    def initialize(api_key: nil, environment: nil, base_url: nil, logger: nil, open_timeout: nil, read_timeout: nil)
       configuration = StraddlePay.config
-      @api_key      = api_key      || configuration.api_key
-      @base_url     = base_url     || configuration.base_url
+      @api_key      = api_key || configuration.api_key
+      @base_url     = base_url || resolve_base_url(environment, configuration)
       @logger       = logger       || configuration.logger
       @open_timeout = open_timeout || configuration.open_timeout
       @read_timeout = read_timeout || configuration.read_timeout
@@ -97,6 +98,16 @@ module StraddlePay
 
     private
 
+    def resolve_base_url(environment, configuration)
+      if environment
+        Config::ENVIRONMENTS.fetch(environment.to_sym) do
+          raise ArgumentError, "Unknown environment: #{environment}"
+        end
+      else
+        configuration.base_url
+      end
+    end
+
     def request(method, path, body: nil, params: nil, headers: {})
       response = connection.public_send(method, path) do |req|
         apply_headers(req, headers)

data/lib/straddle_pay/config.rb

@@ -7,32 +7,49 @@ module StraddlePay
   #
   # @example
   #   StraddlePay.configure do |config|
-  #     config.api_key  = "sk_test_..."
-  #     config.base_url = StraddlePay::Config::PRODUCTION_URL
-  #     config.logger   = Rails.logger
+  #     config.api_key     = "sk_test_..."
+  #     config.environment = :production
+  #     config.logger      = Rails.logger
   #   end
   class Config
-    # @return [String] Sandbox API base URL
-    SANDBOX_URL = "https://sandbox.straddle.com"
-    # @return [String] Production API base URL
-    PRODUCTION_URL = "https://production.straddle.com"
+    ENVIRONMENTS = {
+      sandbox: "https://sandbox.straddle.com",
+      production: "https://production.straddle.com"
+    }.freeze
 
     # @return [String, nil] API key for authentication
     attr_accessor :api_key
-    # @return [String] Base URL for API requests (default: sandbox)
-    attr_accessor :base_url
     # @return [Integer] Connection open timeout in seconds (default: 5)
     attr_accessor :open_timeout
     # @return [Integer] Response read timeout in seconds (default: 30)
     attr_accessor :read_timeout
     # @return [Logger] Logger instance
     attr_writer :logger
+    # @return [String, nil] Custom base URL override (takes precedence over environment)
+    attr_writer :base_url
+
+    # @return [Symbol] API environment (:sandbox or :production)
+    attr_reader :environment
 
     def initialize
       @api_key = ENV.fetch("STRADDLE_API_KEY", nil)
-      @base_url = ENV.fetch("STRADDLE_BASE_URL", SANDBOX_URL)
+      @environment = ENV.fetch("STRADDLE_ENVIRONMENT", "sandbox").to_sym
+      @base_url = ENV.fetch("STRADDLE_BASE_URL", nil)
       @open_timeout = integer_or_default("STRADDLE_OPEN_TIMEOUT", 5)
       @read_timeout = integer_or_default("STRADDLE_READ_TIMEOUT", 30)
+      validate_environment!
+    end
+
+    # @param value [Symbol, String] :sandbox or :production
+    # @raise [ArgumentError] if value is not a known environment
+    def environment=(value)
+      @environment = value.to_sym
+      validate_environment!
+    end
+
+    # @return [String] resolved base URL (custom override or environment-derived)
+    def base_url
+      @base_url || ENVIRONMENTS.fetch(@environment)
     end
 
     # @return [Logger] configured logger, falls back to Rails.logger or $stderr
@@ -42,6 +59,13 @@ module StraddlePay
 
     private
 
+    def validate_environment!
+      return if ENVIRONMENTS.key?(@environment)
+
+      raise ArgumentError,
+            "Unknown environment: #{@environment}. Must be one of: #{ENVIRONMENTS.keys.join(", ")}"
+    end
+
     def integer_or_default(key, default)
       Integer(ENV.fetch(key, default))
     rescue StandardError

data/lib/straddle_pay/version.rb

@@ -2,5 +2,5 @@
 
 module StraddlePay
   # @return [String] current gem version
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/straddle_pay.rb

@@ -6,8 +6,8 @@ require_relative "straddle_pay/version"
 #
 # @example Global configuration
 #   StraddlePay.configure do |config|
-#     config.api_key  = ENV.fetch("STRADDLE_API_KEY")
-#     config.base_url = StraddlePay::Config::PRODUCTION_URL
+#     config.api_key     = ENV.fetch("STRADDLE_API_KEY")
+#     config.environment = :production
 #   end
 #
 # @example Per-instance client

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: straddle_pay
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - dpaluy