rerout 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d7253a49e955b1812e46e3d0c435999fda4c7276d5f19bad47586ac56d06247
-  data.tar.gz: aeb26215de9a5c1e3f5de9637d348342f7cac7461179a8db7b005a438d1260ef
+  metadata.gz: 016c1f73ad3a38b6256f068ecf5d2ca3ab7d5f40e342c52f4e434835e337241f
+  data.tar.gz: 8ef0ff707b6f64bb9feb72f0c59df1f9a95b8a757898dba201d8ae90081d9f80
 SHA512:
-  metadata.gz: 1a4435295c93cc7e74812509c38d5cd7c829e004a37ec71796b3cb08b3707d7959ea4ba8d28aef0925d58bb48b00b39f8df807f4503af1fd33d880de3c4ffc04
-  data.tar.gz: ae6b3a652f246e38ca8537d4eda5699733de2fd3dcc1ed2e102eaca3e6e61041c1d8344082da8c764cdc35aeaa7c202c2818d6f0ed223bc10df376fdd5f658e6
+  metadata.gz: 83f97655cb2138c867d4937715bf4ec4e3c2f8cfcc56513e1062f6c87979454588bae276b90880d02e7573cecb1f4fae3f31a9c89be5d6918f8367143fd255af
+  data.tar.gz: a0be08c8c9fb89ea350c26bf1312bc93989e860b4eceb1b63a630d0cf4f0c7c80f6cf307aaf926e2271123b98c3ba6697d92b0ce25352f2df488033458cc5012

data/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to the `rerout` gem are documented in this file. The
 format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-07-13
+
+### Added
+
+- Explicit isolated sandbox selection, automatic routing to
+  \`https://sandbox-api.rerout.co\`, and fail-closed validation that prevents
+  genuine \`rrk_test_\` credentials from being mixed with live keys.
+
 ## [0.5.0] - 2026-06-20
 
 ### Added

data/lib/rerout/client.rb

@@ -24,6 +24,7 @@ require_relative 'tags_resource'
 module Rerout
   # Default production API base URL.
   DEFAULT_BASE_URL = 'https://api.rerout.co'
+  SANDBOX_BASE_URL = 'https://sandbox-api.rerout.co'
 
   # Main entry point — construct one of these per project API key and re-use
   # it across requests. Thread-safe so long as the injected Faraday connection
@@ -52,21 +53,19 @@ module Rerout
 
     # @param api_key [String] project API key (`rrk_…`). Required.
     # @param base_url [String, nil] override base URL. Defaults to `https://api.rerout.co`.
+    # @param environment [Symbol] production or sandbox data plane.
+    # @param sandbox [Boolean] convenience alias for the sandbox environment.
     # @param connection [Faraday::Connection, nil] inject a Faraday connection
     #   (useful for the test adapter or for sharing connection pools).
     # @param timeout [Integer] per-request timeout in seconds. Default 30.
     # @param user_agent [String, nil] override the default `User-Agent` header.
-    def initialize(api_key:, base_url: nil, connection: nil, timeout: 30, user_agent: nil)
-      if api_key.nil? || !api_key.is_a?(String) || api_key.strip.empty?
-        raise Error.new(
-          code: 'missing_api_key',
-          message: 'A project API key is required to construct Rerout::Client.',
-          status: 0
-        )
-      end
+    def initialize(api_key:, base_url: nil, environment: :production, sandbox: false,
+                   connection: nil, timeout: 30, user_agent: nil)
+      validate_api_key!(api_key)
+      is_sandbox = resolve_sandbox!(api_key, environment, sandbox)
 
       @api_key = api_key
-      @base_url = (base_url || DEFAULT_BASE_URL).to_s.sub(%r{/+\z}, '')
+      @base_url = (base_url || (is_sandbox ? SANDBOX_BASE_URL : DEFAULT_BASE_URL)).to_s.sub(%r{/+\z}, '')
       @timeout = timeout
       @user_agent = user_agent || "rerout-ruby/#{Rerout::VERSION}"
       @connection = connection || default_connection
@@ -105,6 +104,37 @@ module Rerout
 
     private
 
+    def validate_api_key!(api_key)
+      return if api_key.is_a?(String) && !api_key.strip.empty?
+
+      raise Error.new(
+        code: 'missing_api_key',
+        message: 'A project API key is required to construct Rerout::Client.',
+        status: 0
+      )
+    end
+
+    def resolve_sandbox!(api_key, environment, sandbox)
+      resolved_environment = sandbox ? :sandbox : environment.to_sym
+      unless %i[production sandbox].include?(resolved_environment)
+        raise Error.new(
+          code: 'invalid_environment',
+          message: 'environment must be production or sandbox.',
+          status: 0
+        )
+      end
+
+      is_sandbox = resolved_environment == :sandbox
+      is_sandbox_key = api_key.match?(/\Arrk_test_[A-Za-z0-9]{32}\z/)
+      return is_sandbox if is_sandbox_key == is_sandbox
+
+      raise Error.new(
+        code: 'wrong_environment',
+        message: 'The API key does not match the selected Rerout environment.',
+        status: 0
+      )
+    end
+
     def perform_request(method:, path:, query:, headers:, payload:)
       full_url = "#{@base_url}#{path}"
       @connection.public_send(method) do |req|

data/lib/rerout/version.rb

@@ -2,5 +2,5 @@
 
 module Rerout
   # Library version. Follows semantic versioning.
-  VERSION = '0.5.0'
+  VERSION = '0.6.0'
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rerout
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Codecraft Solutions
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -135,6 +136,7 @@ metadata:
   bug_tracker_uri: https://github.com/ModestNerds-Co/rerout-sdks/issues
   documentation_uri: https://rerout.co/docs
   rubygems_mfa_required: 'true'
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -149,7 +151,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: Official Ruby SDK for the Rerout branded-link API.
 test_files: []