client-api-builder 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a417fa853b68dc6e9e96eff4cf99d6a0e026d459e38ae57cbec7341e4735e291
-  data.tar.gz: b2cb35125eb9cdea344051788aee903daea7762c1f0bbbfc13526e1a8815692b
+  metadata.gz: 6ee8b61c4583f46d39c0d502192fb713f502ece28b7ea98092b73572efc9ffd4
+  data.tar.gz: bc80ea2afb78cdacc5067ebb45005a4bbcc997d13e79e9c6a9cf6b7edc8d5696
 SHA512:
-  metadata.gz: 7fbc5052d79571ea1b901067bbaa3feb9a5e0e3c29ccebe1279905b917c121ecda94284f583c52badc5f00ef2c8c55fcba062563e1e8446730ea496659ac5ba3
-  data.tar.gz: f2521e526d45195ff795ad3663c7f6bf8140bb8316a8c3b04f170fe215c0b185745536b152ea0879a896d60ea82cc33a7e7e2e0a9086892c1ee1c5c6a82125eb
+  metadata.gz: 4fd43d2172214d83d6b235096bd17f6289a07243dae96f3911b66c783d11caf1695ee541c2a0d2b547acf305616819c749bb32168ca62b5fa98880b042050925
+  data.tar.gz: e2d29d72f3c076be3b24d0941f317745ce367342cc96157f7c8d2a8592bc2dea0a733da1f4d9d5d40f46e1bf2859a01023ebb57c9ca31be4efca07e18267751e

data/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## [0.7.0](https://github.com/dougyouch/client-api-builder/compare/v0.6.1...v0.7.0) (2026-10-03)
+
+
+### Build System
+
+* **release:** release 0.7.0 ([fff1354](https://github.com/dougyouch/client-api-builder/commit/fff13543d5d8189e2bb7a84eda7e8ca3181f3469))
+
+## Changelog

data/README.md

@@ -1,8 +1,8 @@
 # Client API Builder
 
 [![Gem Version](https://badge.fury.io/rb/client-api-builder.svg)](https://badge.fury.io/rb/client-api-builder)
-[![CI](https://github.com/dougyouch/client-api-builder/actions/workflows/ci.yml/badge.svg)](https://github.com/dougyouch/client-api-builder/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/dougyouch/client-api-builder/branch/master/graph/badge.svg)](https://codecov.io/gh/dougyouch/client-api-builder)
+[![CI](https://github.com/dougyouch/client-api-builder/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/dougyouch/client-api-builder/actions/workflows/ci.yml)
+[![Coverage](https://raw.githubusercontent.com/dougyouch/client-api-builder/badges/coverage.svg)](https://github.com/dougyouch/client-api-builder/actions/workflows/ci.yml)
 
 A Ruby gem for building robust, secure API clients through declarative configuration. Define your API endpoints and their behavior with minimal boilerplate while benefiting from built-in security features, automatic retries, and comprehensive error handling.
 
@@ -544,7 +544,7 @@ end
 
 ## Requirements
 
-- Ruby 3.0+
+- Ruby 3.2+
 - `inheritance-helper` gem (>= 0.2.5)
 
 ## Contributing
@@ -556,7 +556,7 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/dougyo
 3. Write tests for your changes
 4. Ensure all tests pass (`bundle exec rspec`)
 5. Ensure code style compliance (`bundle exec rubocop`)
-6. Commit your changes (`git commit -am 'Add my feature'`)
+6. Commit your changes using [conventional commits](https://www.conventionalcommits.org/) (`git commit -am 'feat(router): add my feature'`); release notes and version bumps are generated from them
 7. Push to the branch (`git push origin feature/my-feature`)
 8. Create a Pull Request
 

data/lib/client-api-builder.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative 'client_api_builder/version'
+
 module ClientApiBuilder
   class Error < StandardError; end
 

data/lib/client_api_builder/net_http_request.rb

@@ -51,7 +51,8 @@ module ClientApiBuilder
       end
 
       def stream(method:, uri:, body:, headers:, connection_options:)
-        request(method: method, uri: uri, body: body, headers: headers, connection_options: connection_options) do |response|
+        request(method: method, uri: uri, body: body, headers: headers,
+                connection_options: connection_options) do |response|
           response.read_body do |chunk|
             yield response, chunk
           end
@@ -59,7 +60,8 @@ module ClientApiBuilder
       end
 
       def stream_to_io(method:, uri:, body:, headers:, connection_options:, io:)
-        stream(method: method, uri: uri, body: body, headers: headers, connection_options: connection_options) do |_, chunk|
+        stream(method: method, uri: uri, body: body, headers: headers,
+               connection_options: connection_options) do |_, chunk|
           io.write chunk
         end
       end
@@ -75,12 +77,15 @@ module ClientApiBuilder
                elsif ALLOWED_FILE_MODES.include?(mode.to_s)
                  mode.to_s
                else
-                 raise ArgumentError, "Invalid file mode: #{mode.inspect}. Allowed modes: #{ALLOWED_FILE_MODES.join(', ')}"
+                 raise ArgumentError,
+                       "Invalid file mode: #{mode.inspect}. Allowed modes: #{ALLOWED_FILE_MODES.join(', ')}"
                end
 
         # Validate file path - expand to absolute path and check for path traversal
         expanded_path = File.expand_path(file)
-        raise ArgumentError, 'Invalid file path: potential path traversal detected' if file.to_s.include?('..') || expanded_path.include?("\0")
+        if file.to_s.include?('..') || expanded_path.include?("\0")
+          raise ArgumentError, 'Invalid file path: potential path traversal detected'
+        end
 
         File.open(expanded_path, mode) do |io|
           stream_to_io(method: method, uri: uri, body: body, headers: headers, connection_options: opts, io: io)

data/lib/client_api_builder/router.rb

@@ -75,13 +75,14 @@ module ClientApiBuilder
         uri = URI.parse(url.to_s)
         return if ALLOWED_URL_SCHEMES.include?(uri.scheme&.downcase)
 
-        raise ArgumentError, "Invalid base_url scheme: #{uri.scheme.inspect}. Allowed: #{ALLOWED_URL_SCHEMES.join(', ')}"
+        allowed = ALLOWED_URL_SCHEMES.join(', ')
+        raise ArgumentError, "Invalid base_url scheme: #{uri.scheme.inspect}. Allowed: #{allowed}"
       rescue URI::InvalidURIError => e
         raise ArgumentError, "Invalid base_url: #{e.message}"
       end
 
-      # set the builder to :to_json, :to_query, :query_params or specify a proc to handle building the request body payload
-      # or get the body builder
+      # set the builder to :to_json, :to_query, :query_params or specify a proc
+      # to handle building the request body payload, or get the body builder
       def body_builder(builder = nil, &block)
         return default_options[:body_builder] if builder.nil? && block.nil?
 
@@ -332,7 +333,7 @@ module ClientApiBuilder
       end
 
       def extract_expected_response_codes(options)
-        codes = options[:expected_response_codes] || (options[:expected_response_code] ? [options[:expected_response_code]] : [])
+        codes = options[:expected_response_codes] || Array(options[:expected_response_code])
         codes.map(&:to_s)
       end
 
@@ -374,7 +375,9 @@ module ClientApiBuilder
 
       def generate_route_code(method_name, path, options = {})
         # Validate method_name to prevent code injection
-        raise ArgumentError, "Invalid method name: #{method_name.inspect}" unless method_name.to_s.match?(/\A[a-z_][a-z0-9_]*\z/i)
+        unless method_name.to_s.match?(/\A[a-z_][a-z0-9_]*\z/i)
+          raise ArgumentError, "Invalid method name: #{method_name.inspect}"
+        end
 
         http_method = options[:method] || auto_detect_http_method(method_name)
         path, path_arguments = process_route_path(path)
@@ -410,7 +413,7 @@ module ClientApiBuilder
         code += "  @request_options = {method: #{ctx[:http_method].inspect}, uri: __uri__, body: __body__, " \
                 "headers: __headers__, connection_options: __connection_options__}\n"
         code += generate_request_call_code(ctx[:options], ctx[:stream_param])
-        code + "end\n\n"
+        "#{code}end\n\n"
       end
 
       def generate_wrapper_method(ctx)
@@ -424,7 +427,7 @@ module ClientApiBuilder
         code += "    expected_response_code!(@response, __expected_response_codes__, __options__)\n"
         code += generate_response_handling_code(ctx[:options])
         code += "  end\n"
-        code + "end\n"
+        "#{code}end\n"
       end
 
       def route(method_name, path, options = {}, &block)
@@ -577,7 +580,7 @@ module ClientApiBuilder
       end
     end
 
-    def get_retry_request_sleep_time(_e, options)
+    def get_retry_request_sleep_time(_exception, options)
       options[:sleep] || self.class.default_options[:sleep] || 0.05
     end
 

data/lib/client_api_builder/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module ClientApiBuilder
+  # Gem version, bumped by release-please
+  VERSION = '0.7.0'
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: client-api-builder
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Doug Youch
 bindir: bin
 cert_chain: []
-date: 2026-02-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inheritance-helper
@@ -23,33 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.2.5
-description: |
-  A Ruby gem for building API clients through declarative configuration. Features include
-  automatic HTTP method detection, nested routing, streaming support, configurable retries,
-  and security features like SSL verification, SSRF protection, and path traversal prevention.
-  Define your API endpoints with a clean DSL and get comprehensive error handling, debugging
-  capabilities, and optional ActiveSupport integration for logging and instrumentation.
+description: Client API Builder generates HTTP client methods from a declarative route
+  DSL. It infers HTTP methods from route names, builds query strings and request bodies,
+  and supports nested routers, configurable retries, and streaming responses to files
+  or IO. SSL verification, base URL scheme checks, and path traversal protection are
+  on by default. Optional ActiveSupport integration adds instrumentation and request
+  logging.
 email: dougyouch@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".cursor.json"
-- ".github/workflows/ci.yml"
-- ".gitignore"
-- ".rubocop.yml"
-- ".ruby-gemset"
-- ".ruby-version"
-- ARCHITECTURE.md
-- CLAUDE.md
-- Gemfile
-- Gemfile.lock
+- CHANGELOG.md
 - LICENSE
 - README.md
-- client-api-builder.gemspec
-- examples/basic_auth_example_client.rb
-- examples/imdb_datasets_client.rb
-- examples/lorem_ipsum_client.rb
 - lib/client-api-builder.rb
 - lib/client_api_builder/active_support_log_subscriber.rb
 - lib/client_api_builder/active_support_notifications.rb
@@ -58,13 +45,12 @@ files:
 - lib/client_api_builder/query_params.rb
 - lib/client_api_builder/router.rb
 - lib/client_api_builder/section.rb
-- script/console
+- lib/client_api_builder/version.rb
 homepage: https://github.com/dougyouch/client-api-builder
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-  homepage_uri: https://github.com/dougyouch/client-api-builder
   source_code_uri: https://github.com/dougyouch/client-api-builder
   changelog_uri: https://github.com/dougyouch/client-api-builder/blob/master/CHANGELOG.md
   bug_tracker_uri: https://github.com/dougyouch/client-api-builder/issues
@@ -75,14 +61,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.20
 specification_version: 4
-summary: Build robust, secure API clients through declarative configuration
+summary: Build Ruby HTTP API clients from declarative route definitions
 test_files: []

data/.cursor.json

@@ -1,29 +0,0 @@
-{
-  "rules": [
-    {
-      "name": "Ruby spec file",
-      "pattern": "^lib/(.+)\\.rb$",
-      "target": "spec/${1}_spec.rb"
-    },
-    {
-      "name": "Ruby implementation file",
-      "pattern": "^spec/(.+)_spec\\.rb$", 
-      "target": "lib/${1}.rb"
-    },
-    {
-      "name": "Related client_api_builder files",
-      "pattern": "^(?:lib|spec)/client_api_builder/(.+)\\.rb$",
-      "related": [
-        "lib/client_api_builder/${1}.rb",
-        "spec/client_api_builder/${1}_spec.rb"
-      ]
-    },
-    {
-      "name": "Main library file",
-      "pattern": "^(?:lib|spec)/client_api_builder/.+\\.rb$",
-      "related": [
-        "lib/client-api-builder.rb"
-      ]
-    }
-  ]
-} 

data/.github/workflows/ci.yml

@@ -1,53 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [master]
-  pull_request:
-    branches: [master]
-
-jobs:
-  lint:
-    name: RuboCop
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.4'
-          bundler-cache: true
-
-      - name: Run RuboCop
-        run: bundle exec rubocop --format github
-
-  test:
-    name: Tests (Ruby ${{ matrix.ruby }})
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        ruby: ['3.2', '3.3', '3.4']
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Ruby ${{ matrix.ruby }}
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby }}
-          bundler-cache: true
-
-      - name: Run tests
-        run: bundle exec rspec
-
-      - name: Upload coverage to Codecov
-        if: matrix.ruby == '3.4'
-        uses: codecov/codecov-action@v4
-        with:
-          files: coverage/coverage.xml
-          fail_ci_if_error: false
-          verbose: true
-        env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

data/.gitignore

@@ -1,51 +0,0 @@
-# rcov generated
-coverage
-coverage.data
-
-# rdoc generated
-rdoc
-
-# yard generated
-doc
-.yardoc
-
-# bundler
-.bundle
-
-# jeweler generated
-pkg
-
-# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
-#
-# * Create a file at ~/.gitignore
-# * Include files you want ignored
-# * Run: git config --global core.excludesfile ~/.gitignore
-#
-# After doing this, these files will be ignored in all your git projects,
-# saving you from having to 'pollute' every project you touch with them
-#
-# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
-#
-# For MacOS:
-#
-.DS_Store
-
-# For TextMate
-#*.tmproj
-#tmtags
-
-# For emacs:
-*~
-\#*
-.\#*
-
-# For vim:
-*.swp
-
-# For redcar:
-#.redcar
-
-# For rubinius:
-#*.rbc
-
-*.gem

data/.rubocop.yml

@@ -1,79 +0,0 @@
-AllCops:
-  TargetRubyVersion: 3.2
-  NewCops: enable
-  SuggestExtensions: false
-  Exclude:
-    - 'bin/**/*'
-    - 'vendor/**/*'
-    - 'coverage/**/*'
-
-# Relaxed metrics for existing codebase
-Metrics/MethodLength:
-  Max: 100
-
-Metrics/AbcSize:
-  Max: 80
-
-Metrics/ClassLength:
-  Max: 200
-
-Metrics/ModuleLength:
-  Max: 340
-
-Metrics/CyclomaticComplexity:
-  Max: 30
-
-Metrics/PerceivedComplexity:
-  Max: 30
-
-Metrics/BlockLength:
-  Exclude:
-    - 'spec/**/*'
-    - '*.gemspec'
-
-Metrics/ParameterLists:
-  Max: 7
-
-# Style preferences
-Style/Documentation:
-  Enabled: false
-
-Style/FrozenStringLiteralComment:
-  EnforcedStyle: always
-
-Layout/LineLength:
-  Max: 170
-  Exclude:
-    - 'spec/**/*'
-
-# File naming - allow hyphenated gem name
-Naming/FileName:
-  Exclude:
-    - 'lib/client-api-builder.rb'
-
-# Allow short parameter names for unused exception variables
-Naming/MethodParameterName:
-  AllowedNames:
-    - e
-    - _e
-    - io
-
-# Gemspec settings
-Gemspec/RequiredRubyVersion:
-  Enabled: false
-
-# Style relaxations for existing code patterns
-Style/OptionalBooleanParameter:
-  Enabled: false
-
-Style/StringConcatenation:
-  Enabled: false
-
-Style/FormatStringToken:
-  Enabled: false
-
-# Note: Previously had exclusions for Style/ClassVars, Style/PerlBackrefs, and
-# Lint/RescueException in router.rb - these have been fixed:
-# - ClassVars: Changed to thread-local storage
-# - PerlBackrefs: Changed to Regexp.last_match
-# - RescueException: Changed to StandardError

data/.ruby-gemset

@@ -1 +0,0 @@
-client-api-builder

data/.ruby-version

@@ -1 +0,0 @@
-3.4.2

data/ARCHITECTURE.md

@@ -1,223 +0,0 @@
-# Client API Builder Architecture
-
-This document describes the internal architecture and design of the Client API Builder gem.
-
-## Overview
-
-Client API Builder is a Ruby gem that provides a declarative way to create API clients. It uses a modular architecture with several key components working together to provide a flexible and extensible API client framework.
-
-## File Structure
-
-```
-lib/
-├── client-api-builder.rb              # Main entry point, autoloads, error classes
-└── client_api_builder/
-    ├── router.rb                      # Core Router module with route DSL
-    ├── nested_router.rb               # NestedRouter class for hierarchical APIs
-    ├── section.rb                     # Section module for creating nested routers
-    ├── net_http_request.rb            # Net::HTTP request execution and streaming
-    ├── query_params.rb                # Custom query parameter builder
-    ├── active_support_notifications.rb # ActiveSupport instrumentation
-    └── active_support_log_subscriber.rb # ActiveSupport logging
-```
-
-## Core Components
-
-### 1. Router Module (`ClientApiBuilder::Router`)
-
-The `Router` module is the core component that provides the main functionality for defining and executing API requests.
-
-**Class Methods** (defined in `ClassMethods`):
-- `base_url`: Sets the base URL for all requests
-- `header`: Adds headers to requests (supports values, symbols, or procs)
-- `route`: Defines API endpoints with dynamic method generation
-- `body_builder`: Configures request body formatting (`:to_json`, `:to_query`, `:query_params`, or custom)
-- `query_builder`: Configures query parameter formatting
-- `query_param`: Adds query parameters to all requests
-- `connection_option`: Sets Net::HTTP connection options
-- `configure_retries`: Sets retry behavior (max_retries, sleep time)
-- `namespace`: Groups routes under a common path prefix
-
-**Instance Methods**:
-- `build_headers`: Constructs request headers, evaluating procs/symbols
-- `build_connection_options`: Merges default and request-specific options
-- `build_query`: Formats query parameters using configured builder
-- `build_body`: Formats request body using configured builder
-- `build_uri`: Constructs full URI with base_url, path, and query
-- `handle_response`: Processes API responses, parses JSON by default
-- `request_wrapper`: Manages request execution with retry and instrumentation
-- `root_router`: Returns self (overridden in NestedRouter)
-
-**Instance Attributes** (via `attr_reader`):
-- `response`: The last Net::HTTP response object
-- `request_options`: Hash of method, uri, body, headers, connection_options
-- `total_request_time`: Duration of last request in seconds
-- `request_attempts`: Number of attempts for last request
-
-### 2. Route Code Generation
-
-The `route` class method dynamically generates two methods per endpoint using `generate_route_code`:
-
-```ruby
-route :get_user, '/users/:id', expected_response_code: 200
-```
-
-Generates:
-- `get_user_raw_response(id:, **options, &block)` - Makes HTTP request, sets `@response` and `@request_options`
-- `get_user(id:, **options, &block)` - Wraps raw_response with retry logic, response code validation, and response handling
-
-**Path Parameters**: Extracted from `:param` or `{param}` syntax in path
-**Body/Query Parameters**: Extracted from `body:` and `query:` options using symbol values
-
-### 3. HTTP Method Auto-Detection
-
-When `method:` is not specified in route options, `auto_detect_http_method` infers it from the method name:
-
-| Prefix Pattern | HTTP Method |
-|---------------|-------------|
-| `post`, `create`, `add`, `insert` | POST |
-| `put`, `update`, `modify`, `change` | PUT |
-| `patch` | PATCH |
-| `delete`, `remove` | DELETE |
-| (default) | GET |
-
-### 4. Nested Router (`ClientApiBuilder::NestedRouter`)
-
-Enables hierarchical API client organization:
-
-```ruby
-section :users do
-  route :list, '/'
-  route :get, '/:id'
-end
-# Usage: client.users.get(id: 123)
-```
-
-Key behaviors:
-- Includes `ClientApiBuilder::Router` module
-- Stores `root_router` reference to access shared state
-- Stores `nested_router_options` passed from section definition
-- Overrides `base_url` to fall back to root_router's base_url
-- Delegates `handle_response` to root_router
-- Overrides `get_instance_method` to access root_router's instance variables in paths
-
-### 5. Section Module (`ClientApiBuilder::Section`)
-
-Creates nested routers dynamically using `InheritanceHelper::ClassBuilder::Utils.create_class`:
-
-```ruby
-def section(name, nested_router_options={}, &block)
-  # Creates: MyClient::UsersNestedRouter < ClientApiBuilder::NestedRouter
-  # Defines: MyClient.users_router (class method)
-  # Defines: MyClient#users (instance method, memoized)
-end
-```
-
-### 6. NetHTTP::Request Module
-
-Provides HTTP request execution using Net::HTTP:
-
-**Methods**:
-- `request(method:, uri:, body:, headers:, connection_options:)` - Standard request with optional block
-- `stream(...)` - Streams response body in chunks via `read_body`
-- `stream_to_io(..., io:)` - Writes streamed chunks to an IO object
-- `stream_to_file(..., file:)` - Opens file and streams to it
-
-**Supported HTTP Methods** (via `METHOD_TO_NET_HTTP_CLASS`):
-`copy`, `delete`, `get`, `head`, `lock`, `mkcol`, `move`, `options`, `patch`, `post`, `propfind`, `proppatch`, `put`, `trace`, `unlock`
-
-### 7. QueryParams Class
-
-Standalone query parameter builder (used when ActiveSupport unavailable):
-
-- Handles nested hashes with bracket notation: `user[name]=John`
-- Handles arrays: `ids[]=1&ids[]=2`
-- Configurable separators: `name_value_separator` (default `=`), `param_separator` (default `&`)
-- Supports custom escape proc
-
-### 8. ActiveSupport Integration
-
-**ActiveSupportNotifications** (conditionally included when ActiveSupport defined):
-- Overrides `instrument_request` to use `ActiveSupport::Notifications.instrument`
-- Event name: `client_api_builder.request`
-- Payload includes `client: self`
-
-**ActiveSupportLogSubscriber**:
-- Subscribes to `client_api_builder.request` events for logging
-
-## Design Patterns
-
-### Module Inclusion Pattern
-
-```ruby
-module ClientApiBuilder
-  module Router
-    def self.included(base)
-      base.extend InheritanceHelper::Methods
-      base.extend ClassMethods
-      base.include ::ClientApiBuilder::Section
-      base.include ::ClientApiBuilder::NetHTTP::Request
-      base.include(::ClientApiBuilder::ActiveSupportNotifications) if defined?(ActiveSupport)
-      base.send(:attr_reader, :response, :request_options, :total_request_time, :request_attempts)
-    end
-  end
-end
-```
-
-### Builder Pattern
-
-Request components built separately then combined:
-```ruby
-__uri__ = build_uri(__path__, __query__, __options__)
-__body__ = build_body(__body__, __options__)
-__headers__ = build_headers(__options__)
-__connection_options__ = build_connection_options(__options__)
-```
-
-### Configuration Inheritance
-
-Uses `inheritance-helper` gem's `add_value_to_class_method` for configuration that properly inherits to subclasses:
-```ruby
-def base_url(url = nil)
-  return default_options[:base_url] unless url
-  add_value_to_class_method(:default_options, base_url: url)
-end
-```
-
-## Configuration Hierarchy
-
-1. **Default Options**: `Router.default_options` returns frozen hash with defaults
-2. **Class-level Configuration**: Set through DSL methods, stored via `add_value_to_class_method`
-3. **Instance-level**: Access class config, can override in method calls
-4. **Request-level**: `**__options__` parameter on generated methods
-
-## Error Handling
-
-- `ClientApiBuilder::Error`: Base error class
-- `ClientApiBuilder::UnexpectedResponse`: Raised when response code doesn't match expected codes
-  - Stores `response` for inspection
-- Response procs: Per-route custom response handling stored in `default_options[:response_procs]`
-- Retry on exception: `retry_request?` method (always returns true by default, override to customize)
-
-## Streaming Support
-
-Routes can specify streaming behavior:
-
-```ruby
-route :download, '/file', stream: :file    # stream_to_file, requires file: argument
-route :stream, '/events', stream: :io      # stream_to_io, requires io: argument
-route :process, '/data', stream: :block    # stream with block for each chunk
-route :download, '/file', stream: true     # alias for :file
-```
-
-## Dependencies
-
-- `inheritance-helper`: Class inheritance and configuration management
-- `json`: JSON parsing and serialization (stdlib)
-- `net/http`: HTTP request handling (stdlib)
-- `cgi`: URL encoding in QueryParams (stdlib)
-- `active_support` (optional): Enhanced query building and instrumentation
-
-## Thread Safety
-
-The library is not thread-safe. Each client instance maintains state (`@response`, `@request_options`, etc.) that would cause race conditions if shared across threads. Create separate client instances per thread.

data/CLAUDE.md

@@ -1,92 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-Client API Builder is a Ruby gem for creating API clients through declarative configuration. It uses Ruby's module inclusion pattern with `ClientApiBuilder::Router` as the core component.
-
-## Common Commands
-
-```bash
-# Install dependencies
-bundle install
-
-# Run all tests
-bundle exec rspec
-
-# Run a single test file
-bundle exec rspec spec/client_api_builder/router_spec.rb
-
-# Run a specific test by line number
-bundle exec rspec spec/client_api_builder/router_spec.rb:42
-
-# Run linter
-bundle exec rubocop
-
-# Build the gem
-gem build client-api-builder.gemspec
-```
-
-## Architecture
-
-### Core Components
-
-- **Router** (`lib/client_api_builder/router.rb`): Main module providing `route`, `base_url`, `header`, `body_builder`, `query_builder`, and `configure_retries` class methods. Uses `InheritanceHelper::Methods` for configuration inheritance.
-
-- **NestedRouter** (`lib/client_api_builder/nested_router.rb`): Enables hierarchical API organization. Maintains reference to `root_router` and shares configuration with parent.
-
-- **Section** (`lib/client_api_builder/section.rb`): Provides `section` class method for creating nested route groups via dynamically generated classes.
-
-- **NetHTTP::Request** (`lib/client_api_builder/net_http_request.rb`): HTTP request execution using `Net::HTTP`. Handles standard requests and streaming (`:file`, `:io`, `:block` modes).
-
-- **QueryParams** (`lib/client_api_builder/query_params.rb`): Custom query parameter builder used when ActiveSupport's `to_query` is unavailable.
-
-- **ActiveSupportNotifications/LogSubscriber**: Optional integration for logging and instrumentation when ActiveSupport is present.
-
-### Route Code Generation
-
-The `route` class method in Router uses `generate_route_code` to dynamically create two methods per route:
-1. `method_name_raw_response` - Makes the HTTP request
-2. `method_name` - Wraps the request with retry logic and response handling
-
-### HTTP Method Auto-Detection
-
-Methods are auto-detected from route names: `post/create/add/insert` → POST, `put/update/modify/change` → PUT, `patch` → PATCH, `delete/remove` → DELETE, others → GET.
-
-### Configuration Hierarchy
-
-1. `default_options` class method (base defaults)
-2. Class-level configuration via DSL methods
-3. Instance-level overrides
-4. Request-level options (`**__options__`)
-
-## Key Patterns
-
-- Module inclusion with `self.included(base)` extending ClassMethods and including InstanceMethods
-- `add_value_to_class_method` from `inheritance-helper` for configuration inheritance
-- Response procs stored per method name for custom response handling
-- `root_router` method for accessing the top-level router from nested routers
-
-## Dependencies
-
-- `inheritance-helper` (runtime): Class inheritance and method management
-- `webmock` (test): HTTP request stubbing
-- `activesupport` (optional): Enhanced query param building and instrumentation
-
-## Code Commits
-
-Format using angular formatting:
-```
-<type>(<scope>): <short summary>
-```
-- **type**: build|ci|docs|feat|fix|perf|refactor|test
-- **scope**: The feature or component of the service we're working on
-- **summary**: Summary in present tense. Not capitalized. No period at the end.
-
-## Documentation Maintenance
-
-When modifying the codebase, keep documentation in sync:
-- **ARCHITECTURE.md** - Update when adding/removing classes, changing component relationships, or altering data flow patterns
-- **README.md** - Update when adding new features, changing public APIs, or modifying usage examples
-- **Code comments** - Update inline documentation when changing method signatures or behavior

data/Gemfile

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-source 'http://rubygems.org'
-
-gem 'inheritance-helper'
-
-group :development do
-  gem 'activesupport'
-  gem 'rake'
-  gem 'rspec'
-  gem 'rubocop'
-  gem 'simplecov'
-  gem 'simplecov-cobertura'
-  gem 'webmock'
-end

data/Gemfile.lock

@@ -1,115 +0,0 @@
-GEM
-  remote: http://rubygems.org/
-  specs:
-    activesupport (8.1.2)
-      base64
-      bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.3.1)
-      connection_pool (>= 2.2.5)
-      drb
-      i18n (>= 1.6, < 2)
-      json
-      logger (>= 1.4.2)
-      minitest (>= 5.1)
-      securerandom (>= 0.3)
-      tzinfo (~> 2.0, >= 2.0.5)
-      uri (>= 0.13.1)
-    addressable (2.8.8)
-      public_suffix (>= 2.0.2, < 8.0)
-    ast (2.4.3)
-    base64 (0.3.0)
-    bigdecimal (4.0.1)
-    concurrent-ruby (1.3.6)
-    connection_pool (3.0.2)
-    crack (1.0.1)
-      bigdecimal
-      rexml
-    diff-lcs (1.6.2)
-    docile (1.4.1)
-    drb (2.2.3)
-    hashdiff (1.2.1)
-    i18n (1.14.8)
-      concurrent-ruby (~> 1.0)
-    inheritance-helper (0.2.5)
-    json (2.18.0)
-    language_server-protocol (3.17.0.5)
-    lint_roller (1.1.0)
-    logger (1.7.0)
-    minitest (6.0.1)
-      prism (~> 1.5)
-    parallel (1.27.0)
-    parser (3.3.10.1)
-      ast (~> 2.4.1)
-      racc
-    prism (1.9.0)
-    public_suffix (7.0.2)
-    racc (1.8.1)
-    rainbow (3.1.1)
-    rake (13.3.1)
-    regexp_parser (2.11.3)
-    rexml (3.4.4)
-    rspec (3.13.2)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.6)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.5)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.7)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.7)
-    rubocop (1.84.0)
-      json (~> 2.3)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.1.0)
-      parallel (~> 1.10)
-      parser (>= 3.3.0.2)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.49.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.49.0)
-      parser (>= 3.3.7.2)
-      prism (~> 1.7)
-    ruby-progressbar (1.13.0)
-    securerandom (0.4.1)
-    simplecov (0.22.0)
-      docile (~> 1.1)
-      simplecov-html (~> 0.11)
-      simplecov_json_formatter (~> 0.1)
-    simplecov-cobertura (3.1.0)
-      rexml
-      simplecov (~> 0.19)
-    simplecov-html (0.13.2)
-    simplecov_json_formatter (0.1.4)
-    tzinfo (2.0.6)
-      concurrent-ruby (~> 1.0)
-    unicode-display_width (3.2.0)
-      unicode-emoji (~> 4.1)
-    unicode-emoji (4.2.0)
-    uri (1.1.1)
-    webmock (3.26.1)
-      addressable (>= 2.8.0)
-      crack (>= 0.3.2)
-      hashdiff (>= 0.4.0, < 2.0.0)
-
-PLATFORMS
-  arm64-darwin-24
-  ruby
-
-DEPENDENCIES
-  activesupport
-  inheritance-helper
-  rake
-  rspec
-  rubocop
-  simplecov
-  simplecov-cobertura
-  webmock
-
-BUNDLED WITH
-   2.6.2

data/client-api-builder.gemspec

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-Gem::Specification.new do |s|
-  s.name        = 'client-api-builder'
-  s.version     = '0.6.1'
-  s.licenses    = ['MIT']
-  s.summary     = 'Build robust, secure API clients through declarative configuration'
-  s.description = <<~DESC
-    A Ruby gem for building API clients through declarative configuration. Features include
-    automatic HTTP method detection, nested routing, streaming support, configurable retries,
-    and security features like SSL verification, SSRF protection, and path traversal prevention.
-    Define your API endpoints with a clean DSL and get comprehensive error handling, debugging
-    capabilities, and optional ActiveSupport integration for logging and instrumentation.
-  DESC
-  s.authors     = ['Doug Youch']
-  s.email       = 'dougyouch@gmail.com'
-  s.homepage    = 'https://github.com/dougyouch/client-api-builder'
-  s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-
-  s.required_ruby_version = '>= 3.0'
-
-  s.add_dependency 'inheritance-helper', '>= 0.2.5'
-
-  s.metadata = {
-    'rubygems_mfa_required' => 'true',
-    'homepage_uri' => s.homepage,
-    'source_code_uri' => 'https://github.com/dougyouch/client-api-builder',
-    'changelog_uri' => 'https://github.com/dougyouch/client-api-builder/blob/master/CHANGELOG.md',
-    'bug_tracker_uri' => 'https://github.com/dougyouch/client-api-builder/issues'
-  }
-end

data/examples/basic_auth_example_client.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-require 'base64'
-require 'securerandom'
-
-BasicAuthExampleClient = Struct.new(
-  :username,
-  :password
-) do
-  include ClientApiBuilder::Router
-  include ClientApiBuilder::Section
-
-  base_url 'https://www.example.com'
-
-  configure_retries(2)
-
-  header 'Authorization', :basic_authorization
-  query_param('cache_buster') { (Time.now.to_f * 1000).to_i }
-
-  route :get_apps, '/apps'
-  route :get_app, '/apps/:app_id'
-
-  section :users do
-    header 'Authorization', :bearer_authorization
-
-    route :create_user, '/users?z={cache_buster}'
-  end
-
-  def cache_buster
-    (Time.now.to_f * 1000).to_i
-  end
-
-  private
-
-  def auth_token
-    @auth_token ||= SecureRandom.uuid
-  end
-
-  def basic_authorization
-    'basic ' + Base64.strict_encode64(username + ':' + password)
-  end
-
-  def bearer_authorization
-    'bearer ' + auth_token
-  end
-end

data/examples/imdb_datasets_client.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-class IMDBDatesetsClient
-  include ClientApiBuilder::Router
-
-  base_url 'https://datasets.imdbws.com'
-
-  route :get_name_basics, '/name.basics.tsv.gz', stream: :file
-  route :get_title_akas, '/title.akas.tsv.gz', stream: :io
-  route :get_title_basics, '/title.basics.tsv.gz', stream: :block
-
-  def self.stream_to_file
-    new.get_name_basics(file: 'name.basics.tsv.gz')
-  end
-
-  def self.stream_to_io
-    File.open('title.akas.tsv.gz', 'wb') do |io|
-      new.get_title_akas(io: io)
-    end
-  end
-
-  def self.stream_with_block
-    File.open('title.basics.tsv.gz', 'wb') do |io|
-      total_read = 0.0
-      new.get_title_basics do |response, chunk|
-        total_read += chunk.bytesize
-        percentage_complete = ((total_read / response.content_length) * 100).to_i
-        puts "downloading title.basics.tsv.gz completed: #{percentage_complete}%"
-        io.write chunk
-      end
-    end
-  end
-end

data/examples/lorem_ipsum_client.rb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-class LoremIpsumClient
-  include ClientApiBuilder::Router
-
-  # by default it converts the body data to JSON
-  # to convert the body to query params (x=1&y=2) use the following
-  # if using active support change this to :to_query
-  body_builder :query_params
-
-  base_url 'https://www.lipsum.com'
-
-  header 'Content-Type', 'application/x-www-form-urlencoded'
-  header 'Accept', 'application/json'
-
-  # this creates a method called create_lorem_ipsum with 2 named arguments amont and what
-  route :create_lorem_ipsum, '/feed/json', body: { amount: :amount, what: :what, start: 'yes', generate: 'Generate Lorem Ipsum' }
-end

data/script/console

@@ -1,15 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-$LOAD_PATH << File.expand_path('../lib', __dir__)
-$LOAD_PATH << File.expand_path('../examples', __dir__)
-require 'client-api-builder'
-autoload :BasicAuthExampleClient, 'basic_auth_example_client'
-autoload :IMDBDatesetsClient, 'imdb_datasets_client'
-autoload :LoremIpsumClient, 'lorem_ipsum_client'
-require 'logger'
-LOG = Logger.new($stdout)
-ClientApiBuilder.logger = LOG
-ClientApiBuilder::ActiveSupportLogSubscriber.new(LOG).subscribe!
-require 'irb'
-IRB.start(__FILE__)