genius_referrals 0.1.0

data/test/client_test.rb

@@ -0,0 +1,130 @@
+require_relative 'test_helper'
+
+class ClientTest < Minitest::Test
+  def test_sends_x_auth_token_header_and_json_body
+    transport = FakeTransport.new([response(200, '{"code":200,"data":{"ok":true}}')])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'secret-token',
+      transport: transport,
+      base_url: 'https://api.example.test'
+    )
+
+    result = client.authentications.test
+
+    assert_equal({ 'ok' => true }, result.data)
+    request = transport.requests.first
+    assert_equal('GET', request[:method])
+    assert_equal('secret-token', request[:headers]['X-Auth-Token'])
+    assert_equal('https://api.example.test/test-authentication', request[:url])
+  end
+
+  def test_redacts_token_from_api_error_request_snapshot
+    transport = FakeTransport.new([response(401, '{"code":401,"message":"bad token"}')])
+    client = GeniusReferrals::Client.new(auth_token: 'secret-token', transport: transport)
+
+    error = assert_raises(GeniusReferrals::AuthenticationError) do
+      client.authentications.test
+    end
+
+    assert_equal('[REDACTED]', error.request[:headers]['X-Auth-Token'])
+    refute_includes(error.message, 'secret-token')
+  end
+
+  def test_redacts_token_from_api_error_message_body_and_response
+    token = 'synthetic-secret-token'
+    body = JSON.generate(
+      'code' => 401,
+      'message' => "server echoed #{token}",
+      'data' => {
+        'auth_token' => token,
+        'nested' => {
+          'note' => "also echoed #{token}",
+          'api_key' => token
+        }
+      }
+    )
+    transport = FakeTransport.new([response(401, body)])
+    client = GeniusReferrals::Client.new(auth_token: token, transport: transport)
+
+    error = assert_raises(GeniusReferrals::AuthenticationError) do
+      client.authentications.test
+    end
+
+    refute_includes(error.message, token)
+    refute_includes(error.body, token)
+    refute_includes(error.response.inspect, token)
+    assert_includes(error.message, '[REDACTED]')
+    assert_equal('[REDACTED]', error.response['data']['auth_token'])
+    assert_equal('[REDACTED]', error.response['data']['nested']['api_key'])
+    assert_equal('also echoed [REDACTED]', error.response['data']['nested']['note'])
+    assert_equal('[REDACTED]', error.request[:headers]['X-Auth-Token'])
+  end
+
+  def test_retries_transient_status_before_success
+    transport = FakeTransport.new([
+      response(500, '{"message":"temporary"}'),
+      response(200, '{"code":200,"data":{"ok":true}}')
+    ])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'token',
+      transport: transport,
+      max_retries: 1,
+      backoff_factor: 0
+    )
+
+    result = client.authentications.test
+
+    assert_equal(true, result.data['ok'])
+    assert_equal(2, transport.requests.length)
+  end
+
+  def test_raises_after_retry_budget
+    transport = FakeTransport.new([
+      response(429, '{"message":"slow down"}'),
+      response(429, '{"message":"still slow"}')
+    ])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'token',
+      transport: transport,
+      max_retries: 1,
+      backoff_factor: 0
+    )
+
+    assert_raises(GeniusReferrals::RateLimitError) do
+      client.authentications.test
+    end
+  end
+
+  def test_backoff_uses_exponential_delay
+    transport = FakeTransport.new([
+      response(503, '{"message":"temporary"}'),
+      response(503, '{"message":"temporary"}'),
+      response(200, '{"code":200,"data":{}}')
+    ])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'token',
+      transport: transport,
+      max_retries: 2,
+      backoff_factor: 0.5
+    )
+    sleeps = []
+    client.define_singleton_method(:sleep) { |delay| sleeps << delay }
+
+    client.authentications.test
+
+    assert_equal([0.5, 1.0], sleeps)
+  end
+
+  def test_legacy_client_class_accepts_old_token_keyword
+    transport = FakeTransport.new([response(200, '{"code":200,"data":{"ok":true}}')])
+    client = GeniusReferrals::GeniusReferralsClient.new(
+      x_auth_token: 'token',
+      transport: transport,
+      base_url: 'https://api.example.test'
+    )
+
+    client.authentications.test
+
+    assert_equal('token', transport.requests.first[:headers]['X-Auth-Token'])
+  end
+end

data/test/integration/authentication_test.rb

@@ -0,0 +1,13 @@
+require_relative '../test_helper'
+
+class AuthenticationIntegrationTest < Minitest::Test
+  def test_live_authentication_when_enabled
+    skip 'Set GR_SDK_RUN_INTEGRATION=1 and GR_API_TOKEN to run live authentication smoke test' unless ENV['GR_SDK_RUN_INTEGRATION'] == '1'
+
+    client = GeniusReferrals::Client.new(auth_token: ENV.fetch('GR_API_TOKEN'))
+    result = client.authentications.test
+
+    assert_kind_of(Hash, result.raw)
+    assert(result.raw.key?('code'))
+  end
+end

data/test/resources_test.rb

@@ -0,0 +1,101 @@
+require_relative 'test_helper'
+
+class ResourcesTest < Minitest::Test
+  def test_advocate_create_uses_wrapper
+    transport = FakeTransport.new([response(201, '{"code":201,"data":{"token":"a1"}}')])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'token',
+      transport: transport,
+      base_url: 'https://api.example.test'
+    )
+
+    client.advocates.create('acct', { email: 'a@example.com' })
+
+    request = transport.requests.first
+    assert_equal('POST', request[:method])
+    assert_equal('https://api.example.test/accounts/acct/advocates', request[:url])
+    assert_equal({ 'advocate' => { 'email' => 'a@example.com' } }, JSON.parse(request[:body]))
+  end
+
+  def test_advocate_delete_all_sends_collection_delete_with_optional_tokens
+    transport = FakeTransport.new([response(204)])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'token',
+      transport: transport,
+      base_url: 'https://api.example.test'
+    )
+
+    result = client.advocates.delete_all('acct', advocates: %w[a1 a2])
+
+    request = transport.requests.first
+    assert_nil(result.data)
+    assert_equal('DELETE', request[:method])
+    assert_equal('https://api.example.test/accounts/acct/advocates?advocates=a1%2Ca2', request[:url])
+    assert_equal('token', request[:headers]['X-Auth-Token'])
+    assert_nil(request[:body])
+  end
+
+  def test_bonus_patch_is_unwrapped
+    transport = FakeTransport.new([response(204)])
+    client = GeniusReferrals::Client.new(auth_token: 'token', transport: transport)
+
+    result = client.bonuses.patch('acct', 123, status: 'approved')
+
+    assert_nil(result.data)
+    assert_equal('PATCH', transport.requests.first[:method])
+    assert_equal({ 'status' => 'approved' }, JSON.parse(transport.requests.first[:body]))
+  end
+
+  def test_list_query_preserves_page_and_limit
+    transport = FakeTransport.new([
+      response(200, '{"code":200,"data":{"page":2,"limit":25,"total":0,"results":[]}}')
+    ])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'token',
+      transport: transport,
+      base_url: 'https://api.example.test'
+    )
+
+    page = client.accounts.list(page: 2, limit: 25, filter: 'status=active')
+
+    assert_equal(2, page.page)
+    assert_includes(transport.requests.first[:url], 'page=2')
+    assert_includes(transport.requests.first[:url], 'limit=25')
+    assert_includes(transport.requests.first[:url], 'filter=status%3Dactive')
+  end
+
+  def test_report_accepts_live_and_sdk_parameter_names
+    transport = FakeTransport.new([response(200, '{"code":200,"data":[]}')])
+    client = GeniusReferrals::Client.new(
+      auth_token: 'token',
+      transport: transport,
+      base_url: 'https://api.example.test'
+    )
+
+    client.reports.revenue(
+      client_account_slug: 'acct',
+      start_date: '2026-01-01',
+      end_date: '2026-01-31'
+    )
+
+    assert_includes(transport.requests.first[:url], 'client_account_slug=acct')
+  end
+
+  def test_product_variant_price_patch_uses_unwrapped_amount
+    transport = FakeTransport.new([response(204)])
+    client = GeniusReferrals::Client.new(auth_token: 'token', transport: transport)
+
+    client.products.patch_variant_price('acct', 'sku', 123, 'USD', amount: 19.95)
+
+    assert_equal({ 'amount' => 19.95 }, JSON.parse(transport.requests.first[:body]))
+  end
+
+  def test_bonus_tag_uses_nested_bonus_tag_shape
+    transport = FakeTransport.new([response(201, '{"code":201,"data":{}}')])
+    client = GeniusReferrals::Client.new(auth_token: 'token', transport: transport)
+
+    client.bonuses.add_tag('acct', 123, 'vip')
+
+    assert_equal({ 'bonus' => { 'tag' => { 'slug' => 'vip' } } }, JSON.parse(transport.requests.first[:body]))
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,32 @@
+$LOAD_PATH.unshift File.expand_path('../lib', __dir__)
+
+require 'json'
+require 'minitest/autorun'
+require 'genius_referrals'
+
+class FakeTransport
+  attr_reader :requests
+
+  def initialize(responses)
+    @responses = responses.dup
+    @requests = []
+  end
+
+  def request(method, url, headers:, body:, timeout:)
+    @requests << {
+      method: method,
+      url: url,
+      headers: headers,
+      body: body,
+      timeout: timeout
+    }
+    response = @responses.shift
+    raise response if response.is_a?(StandardError)
+
+    response
+  end
+end
+
+def response(status_code, body = '')
+  GeniusReferrals::TransportResponse.new(status_code: status_code, headers: {}, body: body)
+end

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: genius_referrals
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Genius Referrals
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.20'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.1'
+description: A modern Ruby SDK for the Genius Referrals public API.
+email: support@geniusreferrals.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/genius_referrals.rb
+- lib/genius_referrals/client.rb
+- lib/genius_referrals/errors.rb
+- lib/genius_referrals/resource.rb
+- lib/genius_referrals/resources.rb
+- lib/genius_referrals/resources/accounts.rb
+- lib/genius_referrals/resources/advocates.rb
+- lib/genius_referrals/resources/authentications.rb
+- lib/genius_referrals/resources/bonuses.rb
+- lib/genius_referrals/resources/campaigns.rb
+- lib/genius_referrals/resources/products.rb
+- lib/genius_referrals/resources/redemption_requests.rb
+- lib/genius_referrals/resources/referrals.rb
+- lib/genius_referrals/resources/reports.rb
+- lib/genius_referrals/resources/root.rb
+- lib/genius_referrals/resources/tags.rb
+- lib/genius_referrals/resources/utilities.rb
+- lib/genius_referrals/resources/vouchers.rb
+- lib/genius_referrals/resources/widgets_packages.rb
+- lib/genius_referrals/response.rb
+- lib/genius_referrals/transport.rb
+- lib/genius_referrals/version.rb
+- test/client_test.rb
+- test/integration/authentication_test.rb
+- test/resources_test.rb
+- test/test_helper.rb
+homepage: https://www.geniusreferrals.com
+licenses:
+- MIT
+metadata: {}
+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.22
+signing_key:
+specification_version: 4
+summary: Official Ruby SDK for the Genius Referrals public API
+test_files: []