openfga 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e25bb28bc13a0c2c3ff7dae1f0122f38bf310d0d3221c474c2bdef57c0582aa
-  data.tar.gz: 8580e442c77504d629d19811f2059ee7cdb76f2edbc961bd1ce9bf1f1337f256
+  metadata.gz: e86ca5c3b828544d91af3d2ef40b045e6df1278c230a4118e4927fd55d3f04fd
+  data.tar.gz: 40844f4bce13ec832e5e029036c1c662fdb44c46a2492b4566b7e5cd775c0908
 SHA512:
-  metadata.gz: 6019181013768317662a4bce8299b70c4966404bf63b280a3db203331fc1fca14d38448a2dc0d4f73fbc51aebd41a8d48b498b15b5675ff6cd560df7558142d7
-  data.tar.gz: c1ebfdf0b2df021b497a984c206e9abb0795b12dee79443d73af55673e4e0333a8fbcb4d893bbf764512498862cfa781465c8e0f27a4abba40ffdd809c343170
+  metadata.gz: 55460e092ba8ec56bd63cc31ae198b359f97fa310de08882c7600d243aa638787dd3bc9e622442f2ce4068b26d01f9d3f030548abb5d405fcf5a9ad66e983e05
+  data.tar.gz: 07e96741790c259696adfd345d64f31a4d4efc4b5ea47cbd1fd13755e36ef0957c2cc3454163525c1ab553bea03ce1d67135500b07f7e923d6dd46cc53c79b99

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.3.1](https://github.com/carlastabile/openfga-ruby-sdk/compare/openfga/v0.3.0...openfga/v0.3.1) (2026-06-26)
+
+
+### Miscellaneous Chores
+
+* empty rake task to fix publishing ([#39](https://github.com/carlastabile/openfga-ruby-sdk/issues/39)) ([f789069](https://github.com/carlastabile/openfga-ruby-sdk/commit/f7890690cef60d4374f9d09276ae42664a65b065))
+
+## [0.3.0](https://github.com/carlastabile/openfga-ruby-sdk/compare/openfga/v0.2.0...openfga/v0.3.0) (2026-06-25)
+
+
+### Features
+
+* add execute_api_request for calling arbitrary API endpoints ([#34](https://github.com/carlastabile/openfga-ruby-sdk/issues/34)) ([c5a6f8f](https://github.com/carlastabile/openfga-ruby-sdk/commit/c5a6f8f2c9d7a3f234cc3903fadc14f16e8b8ce7))
+
+
+### Bug Fixes
+
+* custom logger initialization and usage ([#36](https://github.com/carlastabile/openfga-ruby-sdk/issues/36)) ([50b9d34](https://github.com/carlastabile/openfga-ruby-sdk/commit/50b9d34e8a9cbb0a53a1be65867ddbd437757511))
+
 ## [0.2.0](https://github.com/carlastabile/openfga-ruby-sdk/compare/openfga/v0.1.5...openfga/v0.2.0) (2026-04-17)
 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    openfga (0.2.0)
+    openfga (0.3.1)
       concurrent-ruby
       faraday (>= 1.0.1, < 3.0)
       faraday-multipart

data/Rakefile

@@ -1,5 +1,9 @@
 require 'bundler/gem_tasks'
 
+# release-please already pushes the tag and commit, so skip bundler's git push
+Rake::Task['release:source_control_push'].clear
+task 'release:source_control_push' do; end
+
 begin
   require 'rspec/core/rake_task'
 

data/example/api-executor/README.md

@@ -0,0 +1,83 @@
+# Example: API Executor
+
+This example demonstrates using `SdkClient#execute_api_request` to call arbitrary OpenFGA API endpoints. Rather than using the SDK's typed methods, you supply an HTTP method, path, and optional parameters directly - useful for endpoints not yet covered by the SDK or for advanced use cases.
+
+## 1. Prerequisites
+
+- Ruby 3.x (uses `bundler/inline` - no separate `bundle install` step needed)
+- A running OpenFGA server
+
+## 2. Start OpenFGA (Local Dev)
+
+```bash
+docker run -p 8080:8080 --name openfga openfga/openfga:latest run
+```
+
+Or from the repo root:
+
+```bash
+make start-openfga
+```
+
+## 3. Run the Example
+
+From the repo root:
+
+```bash
+ruby example/api-executor/main.rb
+```
+
+Or from this directory:
+
+```bash
+ruby main.rb
+```
+
+### With a store ID (enables the check example)
+
+```bash
+FGA_STORE_ID=<your-store-id> ruby main.rb
+```
+
+### With an API token
+
+```bash
+FGA_API_TOKEN=<your-token> FGA_STORE_ID=<your-store-id> ruby main.rb
+```
+
+## 4. Environment Variables
+
+| Variable        | Required | Description                                       | Default                  |
+|-----------------|----------|---------------------------------------------------|--------------------------|
+| `FGA_API_URL`   | No       | Base URL of the OpenFGA server                    | `http://localhost:8080`  |
+| `FGA_STORE_ID`  | No       | Store ID for path-param and check examples        | *(skips those examples)* |
+| `FGA_API_TOKEN` | No       | Bearer token for authenticated requests           | *(no auth)*              |
+
+## 5. What the Example Covers
+
+| Example | Method | Path                           | Demonstrates                        |
+|---------|--------|--------------------------------|-------------------------------------|
+| 1       | GET    | `/stores`                      | Query params, basic response access |
+| 2       | GET    | `/stores/{store_id}`           | Path param substitution             |
+| 3       | POST   | `/stores/{store_id}/check`     | Request body, custom headers        |
+| 4       | GET    | `/stores/nonexistent-store-id` | Error handling with `ApiError`      |
+
+## 6. API Reference
+
+```ruby
+response = client.execute_api_request(
+  method:       :post,                        # HTTP verb (symbol or string)
+  path:         '/stores/{store_id}/check',   # Path template
+  path_params:  { store_id: 'abc123' },       # Substituted into {placeholders}
+  query_params: { consistency: 'STRONG' },    # Appended to the URL
+  body:         { tuple_key: { ... } },       # JSON-serialized automatically
+  headers:      { 'X-Request-ID' => 'xyz' }  # Merged with SDK defaults
+)
+
+response.status   # Integer HTTP status code
+response.data     # Hash with symbolized keys (parsed JSON body)
+response.headers  # Response headers
+response.success? # true for 2xx
+```
+
+Auth headers (`Authorization: Bearer ...`) are injected automatically from the client's configured credentials.

data/example/api-executor/main.rb

@@ -0,0 +1,103 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/inline'
+
+gemfile do
+  source 'https://rubygems.org'
+  gem 'json'
+  gem 'openfga', path: File.expand_path('../../', __dir__)
+  gem 'logger'
+end
+
+# OpenFGA API Executor Example
+#
+# Demonstrates how to call arbitrary OpenFGA API endpoints using
+# SdkClient#execute_api_request. Auth headers are injected automatically,
+# and path parameters are substituted and URL-encoded.
+#
+# Usage:
+#   FGA_API_URL=http://localhost:8080 ruby example/api-executor/main.rb
+#
+# Optional env vars:
+#   FGA_STORE_ID   — run the check and get-store examples
+#   FGA_API_TOKEN  — authenticate with a bearer token
+
+logger = Logger.new($stdout)
+logger.level = Logger::INFO
+
+api_url   = ENV.fetch('FGA_API_URL', 'http://localhost:8080')
+store_id  = ENV.fetch('FGA_STORE_ID', nil)
+api_token = ENV.fetch('FGA_API_TOKEN', nil)
+
+credentials = if api_token
+  { method: :api_token, api_token: }
+else
+  { method: :none }
+end
+
+client = OpenFga::SdkClient.new(
+  api_url:,
+  store_id:,
+  credentials:,
+  logger:
+)
+
+# --- Example 1: GET /stores (no path params, with query params) ---
+logger.info '=== Example 1: List stores ==='
+
+response = client.execute_api_request(
+  method:       :get,
+  path:         '/stores',
+  query_params: { page_size: 5 }
+)
+logger.info "Status : #{response.status}"
+logger.info "Success: #{response.success?}"
+logger.info "Stores : #{response.data[:stores]&.length || 0} found"
+
+# --- Example 2: GET /stores/{store_id} (path param substitution) ---
+if store_id
+  logger.info '=== Example 2: Get store by ID ==='
+
+  response = client.execute_api_request(
+    method:      :get,
+    path:        '/stores/{store_id}',
+    path_params: { store_id: }
+  )
+  logger.info "Status    : #{response.status}"
+  logger.info "Store name: #{response.data[:name]}"
+else
+  logger.warn 'Set FGA_STORE_ID to run example 2'
+end
+
+# --- Example 3: POST using the block builder, with custom headers ---
+if store_id
+  logger.info '=== Example 3: Check authorization via block builder ==='
+
+  response = client.execute_api_request(
+    method:      :post,
+    path:        '/stores/{store_id}/check',
+    path_params: { store_id: },
+    body:        {
+      tuple_key: {
+        user:     'user:anne',
+        relation: 'reader',
+        object:   'document:2021-budget'
+      }
+    },
+    headers: { 'X-Request-ID' => 'api-executor-example-001' }
+  )
+  logger.info "Status : #{response.status}"
+  logger.info "Allowed: #{response.data[:allowed]}"
+else
+  logger.warn 'Set FGA_STORE_ID to run example 3'
+end
+
+# --- Example 4: Error handling ---
+logger.info '=== Example 4: Error handling ==='
+
+begin
+  client.execute_api_request(method: :get, path: '/stores/nonexistent-store-id')
+rescue OpenFga::ApiError => e
+  logger.info "Caught ApiError — HTTP #{e.code}"
+end

data/example/example1/main.rb

@@ -18,7 +18,7 @@ require 'ulid'
 # This example demonstrates how to use the OpenFGA Ruby SDK to interact with an OpenFGA server.
 class OpenFgaExample
   def initialize
-    @logger = Logger.new($stdout)
+    @logger = Logger.new(STDOUT)
     @logger.level = Logger::INFO
 
     # Initialize the OpenFGA client
@@ -105,7 +105,8 @@ class OpenFgaExample
       # Update client with store_id
       @client = OpenFga::SdkClient.new(
         api_url: ENV.fetch('FGA_API_URL', 'http://localhost:8080'),
-        store_id: @store_id
+        store_id: @store_id,
+        logger: @logger
       )
     end
 

data/lib/openfga/client/models/api_executor_request.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module OpenFga
+  class ApiExecutorRequest
+    attr_accessor :method, :path, :path_params, :query_params, :body, :headers
+
+    def initialize(method:, path:, path_params: {}, query_params: {}, body: nil, headers: {})
+      @method       = method
+      @path         = path
+      @path_params  = path_params  || {}
+      @query_params = query_params || {}
+      @body         = body
+      @headers      = headers || {}
+    end
+
+    def self.build
+      req = new(method: nil, path: nil)
+      yield req
+      req
+    end
+
+    def validate!
+      raise ArgumentError, 'ApiExecutorRequest#method is required' if @method.nil?
+      raise ArgumentError, 'ApiExecutorRequest#path is required'   if @path.nil? || @path.empty?
+    end
+  end
+end

data/lib/openfga/client/models/api_executor_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module OpenFga
+  class ApiExecutorResponse
+    attr_reader :data, :status, :headers
+
+    def initialize(data:, status:, headers:)
+      @data    = data
+      @status  = status
+      @headers = headers
+    end
+
+    def success?
+      !@status.nil? && @status >= 200 && @status < 300
+    end
+  end
+end

data/lib/openfga/client/openfga_client.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'cgi'
 require 'concurrent'
 require 'set'
 
@@ -17,7 +18,8 @@ module OpenFga
         method: :none
       }
 
-      @logger = config[:logger] || Logger.new($stdout)
+      @logger = new_logger(@config)
+      @logger.debug('Using custom logger instance') if @config[:logger]
 
       # Later we can support custom token managers.
       @token_manager = case @config[:credentials][:method]
@@ -47,6 +49,7 @@ module OpenFga
         c.host = @config[:api_url]
         c.scheme = URI(@config[:api_url]).scheme
         c.logger = @logger
+        c.debugging = true if @config[:logger]
       end
 
       @api_client = OpenFga::OpenFgaApi.new(ApiClient.new(api_client_config))
@@ -464,6 +467,39 @@ module OpenFga
       @api_client.write_authorization_model(store_id(opts), request_body, wrap_options(opts))
     end
 
+    # Executes a raw API request against the FGA server with automatic auth injection.
+    # @param method [String, Symbol] HTTP method (e.g. :get, :post)
+    # @param path [String] URL path template (e.g. '/stores/{store_id}/check')
+    # @param path_params [Hash] Values for {placeholder} substitution
+    # @param query_params [Hash] URL query parameters
+    # @param body [Hash, nil] Request body (JSON-serialized automatically)
+    # @param headers [Hash] Additional request headers
+    # @return [ApiExecutorResponse]
+    def execute_api_request(method:, path:, path_params: {}, query_params: {}, body: nil, headers: {})
+      request = ApiExecutorRequest.new(
+        method:,
+        path:,
+        path_params:,
+        query_params:,
+        body:,
+        headers:
+      )
+      request.validate!
+
+      resolved_path = substitute_path_params(request.path, request.path_params)
+      merged_headers = build_auth_headers.merge(request.headers)
+
+      opts = {
+        header_params: merged_headers,
+        query_params:  request.query_params,
+        body:          request.body,
+        return_type:   'Object'
+      }
+
+      data, status, response_headers = @api_client.api_client.call_api(request.method, resolved_path, opts)
+      ApiExecutorResponse.new(data:, status:, headers: response_headers)
+    end
+
     private
 
       # Executes a single batch check (used when no splitting is needed)
@@ -580,5 +616,20 @@ module OpenFga
           'Authorization' => "Bearer #{token}"
         }
       end
+
+      def substitute_path_params(path, path_params)
+        path.gsub(/\{(\w+)\}/) do
+          key = $1
+          value = path_params[key] || path_params[key.to_sym]
+          value ? CGI.escape(value.to_s) : "{#{key}}"
+        end
+      end
+
+      def new_logger(config)
+        logger = Logger.new($stdout)
+        logger.level = Logger::INFO
+
+        config[:logger] || (defined?(Rails) ? Rails.logger : logger)
+      end
   end
 end

data/lib/openfga/imports.rb

@@ -12,5 +12,9 @@ require 'openfga/configuration'
 require 'openfga/client/client_errors'
 require 'openfga/client/openfga_client'
 
+# Client models
+require 'openfga/client/models/api_executor_request'
+require 'openfga/client/models/api_executor_response'
+
 # Token management
 require 'openfga/token_manager/token_manager'

data/lib/openfga/token_manager/token_manager.rb

@@ -55,7 +55,7 @@ module OpenFga
         @config = config
         @access_token_expires_at = nil
         @access_token = nil
-        @logger = config.logger || Logger.new($stdout)
+        @logger = config.logger || Logger.new(STDOUT)
       end
 
       def access_token
@@ -63,7 +63,7 @@ module OpenFga
           return @access_token
         end
 
-        @logger.info "Refreshing access token from #{@config.token_issuer}"
+        @logger.debug "Refreshing access token from #{@config.token_issuer}"
 
         form_data = {
           'grant_type' => 'client_credentials',
@@ -92,7 +92,7 @@ module OpenFga
           @access_token = body['access_token']
           @access_token_expires_at = Time.now.utc + body['expires_in'].to_i
 
-          @logger.info "Obtained new access token, expires at #{@access_token_expires_at}"
+          @logger.debug "Obtained new access token, expires at #{@access_token_expires_at}"
 
           @access_token
         else raise TokenRefreshError.new("Failed to obtain access token: #{response.code} #{response.body}")

data/lib/openfga/version.rb

@@ -12,5 +12,5 @@ Generator version: 6.4.0
 =end
 
 module OpenFga
-  VERSION = '0.2.0'
+  VERSION = '0.3.1'
 end

data/spec/client/api_executor_spec.rb

@@ -0,0 +1,358 @@
+require 'spec_helper'
+
+describe OpenFga::ApiExecutorRequest do
+  describe '.new' do
+    it 'accepts keyword arguments' do
+      req = described_class.new(
+        method: :get,
+        path: '/stores',
+        query_params: { page_size: 10 }
+      )
+      expect(req.method).to eq(:get)
+      expect(req.path).to eq('/stores')
+      expect(req.query_params).to eq({ page_size: 10 })
+    end
+
+    it 'defaults path_params, query_params, and headers to empty hashes' do
+      req = described_class.new(method: :get, path: '/stores')
+      expect(req.path_params).to  eq({})
+      expect(req.query_params).to eq({})
+      expect(req.headers).to      eq({})
+    end
+
+    it 'defaults body to nil' do
+      req = described_class.new(method: :get, path: '/stores')
+      expect(req.body).to be_nil
+    end
+  end
+
+  describe '#validate!' do
+    it 'raises ArgumentError when method is nil' do
+      req = described_class.new(method: nil, path: '/stores')
+      expect { req.validate! }.to raise_error(ArgumentError, /method is required/)
+    end
+
+    it 'raises ArgumentError when path is empty' do
+      req = described_class.new(method: :get, path: '')
+      expect { req.validate! }.to raise_error(ArgumentError, /path is required/)
+    end
+
+    it 'does not raise when method and path are present' do
+      req = described_class.new(method: :get, path: '/stores')
+      expect { req.validate! }.not_to raise_error
+    end
+  end
+end
+
+describe OpenFga::ApiExecutorResponse do
+  it 'exposes data, status, and headers' do
+    resp = described_class.new(data: { allowed: true }, status: 200, headers: { 'x-foo' => 'bar' })
+    expect(resp.data).to    eq({ allowed: true })
+    expect(resp.status).to  eq(200)
+    expect(resp.headers).to eq({ 'x-foo' => 'bar' })
+  end
+
+  it '#success? returns true for 2xx' do
+    expect(described_class.new(data: nil, status: 200, headers: {}).success?).to be(true)
+    expect(described_class.new(data: nil, status: 201, headers: {}).success?).to be(true)
+  end
+
+  it '#success? returns false for non-2xx' do
+    expect(described_class.new(data: nil, status: 404, headers: {}).success?).to be(false)
+    expect(described_class.new(data: nil, status: 500, headers: {}).success?).to be(false)
+  end
+end
+
+describe OpenFga::SdkClient, '#execute_api_request' do
+  let(:api_url)  { 'http://localhost:8090' }
+  let(:store_id) { '01JSKYVY76JYW2DG65NG1444T4' }
+  let(:subject)  { OpenFga::SdkClient.new(api_url:, store_id:) }
+
+  let(:subject_with_token) do
+    OpenFga::SdkClient.new(
+      api_url:,
+      store_id:,
+      credentials: { method: :api_token, api_token: 'my-token' }
+    )
+  end
+
+  # --- input validation ---
+
+  it 'raises ArgumentError when method is missing' do
+    expect { subject.execute_api_request(path: '/stores') }
+      .to raise_error(ArgumentError)
+  end
+
+  it 'raises ArgumentError when path is empty' do
+    expect { subject.execute_api_request(method: :get, path: '') }
+      .to raise_error(ArgumentError, /path is required/)
+  end
+
+  # --- return value ---
+
+  it 'returns an ApiExecutorResponse with data, status, and headers' do
+    stub_request(:get, "#{api_url}/stores")
+      .to_return(
+        status: 200,
+        body: { stores: [] }.to_json,
+        headers: { 'Content-Type' => 'application/json', 'X-Request-Id' => 'abc' }
+      )
+
+    resp = subject.execute_api_request(method: :get, path: '/stores')
+
+    expect(resp).to be_a(OpenFga::ApiExecutorResponse)
+    expect(resp.status).to   eq(200)
+    expect(resp.data).to     eq({ stores: [] })
+    expect(resp.headers).to  include('X-Request-Id' => 'abc')
+    expect(resp.success?).to be(true)
+  end
+
+  it 'returns nil data for a 204 No Content response' do
+    stub_request(:delete, "#{api_url}/stores/#{store_id}")
+      .to_return(status: 204, body: '', headers: {})
+
+    resp = subject.execute_api_request(
+      method:      :delete,
+      path:        '/stores/{store_id}',
+      path_params: { store_id: }
+    )
+
+    expect(resp.status).to eq(204)
+    expect(resp.data).to   be_nil
+    expect(resp.success?).to be(true)
+  end
+
+  # --- HTTP methods ---
+
+  it 'sends a PUT request' do
+    stub = stub_request(:put, "#{api_url}/stores/#{store_id}")
+      .to_return(status: 200, body: {}.to_json, headers: { 'Content-Type' => 'application/json' })
+
+    subject.execute_api_request(
+      method:      :put,
+      path:        '/stores/{store_id}',
+      path_params: { store_id: },
+      body:        { name: 'updated' }
+    )
+
+    expect(stub).to have_been_requested
+  end
+
+  it 'sends a PATCH request' do
+    stub = stub_request(:patch, "#{api_url}/stores/#{store_id}")
+      .to_return(status: 200, body: {}.to_json, headers: { 'Content-Type' => 'application/json' })
+
+    subject.execute_api_request(
+      method:      :patch,
+      path:        '/stores/{store_id}',
+      path_params: { store_id: },
+      body:        { name: 'patched' }
+    )
+
+    expect(stub).to have_been_requested
+  end
+
+  it 'sends a DELETE request' do
+    stub = stub_request(:delete, "#{api_url}/stores/#{store_id}")
+      .to_return(status: 204, body: '', headers: {})
+
+    subject.execute_api_request(
+      method:      :delete,
+      path:        '/stores/{store_id}',
+      path_params: { store_id: }
+    )
+
+    expect(stub).to have_been_requested
+  end
+
+  it 'accepts method as a string' do
+    stub = stub_request(:get, "#{api_url}/stores")
+      .to_return(status: 200, body: { stores: [] }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+    subject.execute_api_request(method: 'GET', path: '/stores')
+
+    expect(stub).to have_been_requested
+  end
+
+  # --- path param substitution ---
+
+  context 'path params' do
+    it 'substitutes a single {placeholder} and CGI-encodes the value' do
+      stub = stub_request(:post, "#{api_url}/stores/#{store_id}/check")
+        .to_return(status: 200, body: { allowed: true }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      resp = subject.execute_api_request(
+        method:      :post,
+        path:        '/stores/{store_id}/check',
+        path_params: { store_id: },
+        body:        { tuple_key: { user: 'user:anne', relation: 'reader', object: 'doc:1' } }
+      )
+
+      expect(stub).to have_been_requested
+      expect(resp.data[:allowed]).to be(true)
+    end
+
+    it 'substitutes multiple placeholders' do
+      model_id = '01G50QVV17PECNVAHX1GG4Y5NC'
+      stub = stub_request(:get, "#{api_url}/stores/#{store_id}/authorization-models/#{model_id}")
+        .to_return(status: 200, body: { authorization_model: {} }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject.execute_api_request(
+        method:      :get,
+        path:        '/stores/{store_id}/authorization-models/{model_id}',
+        path_params: { store_id:, model_id: }
+      )
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'accepts symbol keys in path_params' do
+      stub = stub_request(:get, "#{api_url}/stores/#{store_id}")
+        .to_return(status: 200, body: { id: store_id }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject.execute_api_request(
+        method:      :get,
+        path:        '/stores/{store_id}',
+        path_params: { store_id: }
+      )
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'URL-encodes special characters in path param values' do
+      encoded = CGI.escape('store/with spaces')
+      stub = stub_request(:get, "#{api_url}/stores/#{encoded}")
+        .to_return(status: 200, body: {}.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject.execute_api_request(
+        method:      :get,
+        path:        '/stores/{store_id}',
+        path_params: { store_id: 'store/with spaces' }
+      )
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'raises URI::InvalidURIError when a placeholder has no matching path_param' do
+      expect {
+        subject.execute_api_request(method: :get, path: '/stores/{unknown_key}')
+      }.to raise_error(URI::InvalidURIError)
+    end
+  end
+
+  # --- auth header injection ---
+
+  context 'auth headers' do
+    it 'sends no Authorization header when credentials method is :none' do
+      stub = stub_request(:get, "#{api_url}/stores")
+        .to_return(status: 200, body: { stores: [] }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject.execute_api_request(method: :get, path: '/stores')
+
+      expect(stub).to have_been_requested
+      expect(stub.with(headers: { 'Authorization' => /.*/ })).not_to have_been_requested
+    end
+
+    it 'injects Authorization header when api_token credential is configured' do
+      stub = stub_request(:get, "#{api_url}/stores")
+        .with(headers: { 'Authorization' => 'Bearer my-token' })
+        .to_return(status: 200, body: { stores: [] }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject_with_token.execute_api_request(method: :get, path: '/stores')
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'caller-supplied Authorization header overrides the SDK token' do
+      stub = stub_request(:get, "#{api_url}/stores")
+        .with(headers: { 'Authorization' => 'Bearer caller-override' })
+        .to_return(status: 200, body: {}.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject_with_token.execute_api_request(
+        method:  :get,
+        path:    '/stores',
+        headers: { 'Authorization' => 'Bearer caller-override' }
+      )
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'merges caller-supplied headers with SDK auth headers' do
+      stub = stub_request(:get, "#{api_url}/stores")
+        .with(headers: { 'Authorization' => 'Bearer my-token', 'X-Custom' => 'value' })
+        .to_return(status: 200, body: {}.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject_with_token.execute_api_request(
+        method:  :get,
+        path:    '/stores',
+        headers: { 'X-Custom' => 'value' }
+      )
+
+      expect(stub).to have_been_requested
+    end
+  end
+
+  # --- query params ---
+
+  context 'query params' do
+    it 'passes a single query param to the HTTP layer' do
+      stub = stub_request(:get, "#{api_url}/stores")
+        .with(query: { 'page_size' => '25' })
+        .to_return(status: 200, body: { stores: [] }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject.execute_api_request(method: :get, path: '/stores', query_params: { page_size: 25 })
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'passes multiple query params to the HTTP layer' do
+      stub = stub_request(:get, "#{api_url}/stores")
+        .with(query: { 'page_size' => '10', 'continuation_token' => 'tok123' })
+        .to_return(status: 200, body: { stores: [] }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject.execute_api_request(
+        method:       :get,
+        path:         '/stores',
+        query_params: { page_size: 10, continuation_token: 'tok123' }
+      )
+
+      expect(stub).to have_been_requested
+    end
+  end
+
+  # --- error responses ---
+
+  context 'error responses' do
+    it 'raises ApiError for a 404 response' do
+      stub_request(:get, "#{api_url}/stores/does-not-exist")
+        .to_return(status: 404, body: { code: 'store_id_not_found' }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      expect {
+        subject.execute_api_request(method: :get, path: '/stores/does-not-exist')
+      }.to raise_error(OpenFga::ApiError)
+    end
+
+    it 'raises ApiError for a 500 response' do
+      stub_request(:post, "#{api_url}/stores/#{store_id}/check")
+        .to_return(status: 500, body: { code: 'internal_error' }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      expect {
+        subject.execute_api_request(
+          method:      :post,
+          path:        '/stores/{store_id}/check',
+          path_params: { store_id: },
+          body:        { tuple_key: {} }
+        )
+      }.to raise_error(OpenFga::ApiError)
+    end
+
+    it 'includes the HTTP status code in the raised ApiError' do
+      stub_request(:get, "#{api_url}/stores/does-not-exist")
+        .to_return(status: 404, body: { code: 'store_id_not_found' }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      expect {
+        subject.execute_api_request(method: :get, path: '/stores/does-not-exist')
+      }.to raise_error(OpenFga::ApiError) { |e| expect(e.code).to eq(404) }
+    end
+  end
+end

data/spec/client/openfga_client_spec.rb

@@ -2185,4 +2185,79 @@ describe OpenFga::SdkClient do
       end
     end
   end
+
+  describe '#execute_api_request' do
+    it 'raises ArgumentError when method is omitted' do
+      expect { subject.execute_api_request(path: '/stores') }.to raise_error(ArgumentError)
+    end
+
+    it 'raises ArgumentError when path is empty' do
+      expect { subject.execute_api_request(method: :get, path: '') }
+        .to raise_error(ArgumentError, /path is required/)
+    end
+
+    it 'returns an ApiExecutorResponse on success' do
+      stub_request(:get, stores_url)
+        .to_return(status: 200, body: { stores: [] }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      resp = subject.execute_api_request(method: :get, path: '/stores')
+
+      expect(resp).to be_a(OpenFga::ApiExecutorResponse)
+      expect(resp.status).to   eq(200)
+      expect(resp.data).to     eq({ stores: [] })
+      expect(resp.success?).to be(true)
+    end
+
+    it 'substitutes path params into the URL' do
+      stub = stub_request(:get, stores_url(store_id))
+        .to_return(status: 200, body: { id: store_id }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject.execute_api_request(
+        method:      :get,
+        path:        '/stores/{store_id}',
+        path_params: { store_id: }
+      )
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'sends the request body as JSON' do
+      stub = stub_request(:post, "#{stores_url(store_id)}/check")
+        .with(body: { tuple_key: { user: 'user:anne', relation: 'reader', object: 'doc:1' } }.to_json)
+        .to_return(status: 200, body: { allowed: true }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      resp = subject.execute_api_request(
+        method:      :post,
+        path:        '/stores/{store_id}/check',
+        path_params: { store_id: },
+        body:        { tuple_key: { user: 'user:anne', relation: 'reader', object: 'doc:1' } }
+      )
+
+      expect(stub).to have_been_requested
+      expect(resp.data[:allowed]).to be(true)
+    end
+
+    it 'injects the Authorization header when credentials are configured' do
+      stub = stub_request(:get, stores_url)
+        .with(headers: api_token_authz_header)
+        .to_return(status: 200, body: { stores: [] }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      subject_with_api_token.execute_api_request(method: :get, path: '/stores')
+
+      expect(stub).to have_been_requested
+    end
+
+    it 'raises ApiError for non-2xx responses' do
+      stub_request(:get, stores_url(store_id))
+        .to_return(status: 404, body: { code: 'store_id_not_found' }.to_json, headers: { 'Content-Type' => 'application/json' })
+
+      expect {
+        subject.execute_api_request(
+          method:      :get,
+          path:        '/stores/{store_id}',
+          path_params: { store_id: }
+        )
+      }.to raise_error(OpenFga::ApiError)
+    end
+  end
 end

data/vendor/bundle/ruby/4.0.0/extensions/x86_64-linux/4.0.0/bigdecimal-4.0.1/gem_make.out

@@ -22,17 +22,17 @@ checking for RB_WARN_CATEGORY_DEPRECATED in ruby.h... yes
 creating Makefile
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/bigdecimal-4.0.1/ext/bigdecimal
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-cz6r9q sitelibdir\=./.gem.20260417-2252-cz6r9q clean
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-8ayezx sitelibdir\=./.gem.20260625-2219-8ayezx clean
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/bigdecimal-4.0.1/ext/bigdecimal
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-cz6r9q sitelibdir\=./.gem.20260417-2252-cz6r9q
-compiling bigdecimal.c
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-8ayezx sitelibdir\=./.gem.20260625-2219-8ayezx
 compiling missing.c
+compiling bigdecimal.c
 linking shared-object bigdecimal.so
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/bigdecimal-4.0.1/ext/bigdecimal
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-cz6r9q sitelibdir\=./.gem.20260417-2252-cz6r9q install
-/usr/bin/install -c -m 0755 bigdecimal.so ./.gem.20260417-2252-cz6r9q
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-8ayezx sitelibdir\=./.gem.20260625-2219-8ayezx install
+/usr/bin/install -c -m 0755 bigdecimal.so ./.gem.20260625-2219-8ayezx
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/bigdecimal-4.0.1/ext/bigdecimal
-make DESTDIR\= sitearchdir\=./.gem.20260417-2252-cz6r9q sitelibdir\=./.gem.20260417-2252-cz6r9q clean
+make DESTDIR\= sitearchdir\=./.gem.20260625-2219-8ayezx sitelibdir\=./.gem.20260625-2219-8ayezx clean

data/vendor/bundle/ruby/4.0.0/extensions/x86_64-linux/4.0.0/bigdecimal-4.0.1/mkmf.log

@@ -135,7 +135,7 @@ checked program was:
 have_func: checking for _lzcnt_u32() in x86intrin.h... -------------------- no
 
 LD_LIBRARY_PATH=.:/opt/hostedtoolcache/Ruby/4.0.1/x64/lib LSAN_OPTIONS=detect_leaks=0 "gcc -o conftest -I/opt/hostedtoolcache/Ruby/4.0.1/x64/include/ruby-4.0.0/x86_64-linux -I/opt/hostedtoolcache/Ruby/4.0.1/x64/include/ruby-4.0.0/ruby/backward -I/opt/hostedtoolcache/Ruby/4.0.1/x64/include/ruby-4.0.0 -I. -DENABLE_PATH_CHECK=0   -fstack-protector-strong -U_FORTIFY_SOURCE -D_FORTIFY_SOURCE=2  -O3 -fno-fast-math -ggdb3 -Wall -Wextra -Wdeprecated-declarations -Wdiv-by-zero -Wduplicated-cond -Wimplicit-function-declaration -Wimplicit-int -Wpointer-arith -Wwrite-strings -Wold-style-definition -Wimplicit-fallthrough=0 -Wmissing-noreturn -Wno-cast-function-type -Wno-constant-logical-operand -Wno-long-long -Wno-missing-field-initializers -Wno-overlength-strings -Wno-packed-bitfield-compat -Wno-parentheses-equality -Wno-self-assign -Wno-tautological-compare -Wno-unused-parameter -Wno-unused-value -Wsuggest-attribute=format -Wsuggest-attribute=noreturn -Wunused-variable -Wmisleading-indentation -Wundef  -fPIC conftest.c -L. -L/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -Wl,-rpath,/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -L. -fstack-protector-strong -rdynamic -Wl,-export-dynamic -Wl,--no-as-needed     -Wl,-rpath,/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -L/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -lruby  -lm -lpthread  -lc"
-/usr/bin/ld: /tmp/ccB6b3my.o: in function `t':
+/usr/bin/ld: /tmp/cchVHUwO.o: in function `t':
 /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/bigdecimal-4.0.1/ext/bigdecimal/conftest.c:16:(.text+0x7): undefined reference to `_lzcnt_u32'
 collect2: error: ld returned 1 exit status
 checked program was:
@@ -197,7 +197,7 @@ checked program was:
 have_func: checking for _lzcnt_u64() in x86intrin.h... -------------------- no
 
 LD_LIBRARY_PATH=.:/opt/hostedtoolcache/Ruby/4.0.1/x64/lib LSAN_OPTIONS=detect_leaks=0 "gcc -o conftest -I/opt/hostedtoolcache/Ruby/4.0.1/x64/include/ruby-4.0.0/x86_64-linux -I/opt/hostedtoolcache/Ruby/4.0.1/x64/include/ruby-4.0.0/ruby/backward -I/opt/hostedtoolcache/Ruby/4.0.1/x64/include/ruby-4.0.0 -I. -DENABLE_PATH_CHECK=0   -fstack-protector-strong -U_FORTIFY_SOURCE -D_FORTIFY_SOURCE=2  -O3 -fno-fast-math -ggdb3 -Wall -Wextra -Wdeprecated-declarations -Wdiv-by-zero -Wduplicated-cond -Wimplicit-function-declaration -Wimplicit-int -Wpointer-arith -Wwrite-strings -Wold-style-definition -Wimplicit-fallthrough=0 -Wmissing-noreturn -Wno-cast-function-type -Wno-constant-logical-operand -Wno-long-long -Wno-missing-field-initializers -Wno-overlength-strings -Wno-packed-bitfield-compat -Wno-parentheses-equality -Wno-self-assign -Wno-tautological-compare -Wno-unused-parameter -Wno-unused-value -Wsuggest-attribute=format -Wsuggest-attribute=noreturn -Wunused-variable -Wmisleading-indentation -Wundef  -fPIC conftest.c -L. -L/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -Wl,-rpath,/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -L. -fstack-protector-strong -rdynamic -Wl,-export-dynamic -Wl,--no-as-needed     -Wl,-rpath,/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -L/opt/hostedtoolcache/Ruby/4.0.1/x64/lib -lruby  -lm -lpthread  -lc"
-/usr/bin/ld: /tmp/ccPvZ3eH.o: in function `t':
+/usr/bin/ld: /tmp/cc0DFTcc.o: in function `t':
 /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/bigdecimal-4.0.1/ext/bigdecimal/conftest.c:16:(.text+0x7): undefined reference to `_lzcnt_u64'
 collect2: error: ld returned 1 exit status
 checked program was:

data/vendor/bundle/ruby/4.0.0/extensions/x86_64-linux/4.0.0/byebug-13.0.0/gem_make.out

@@ -3,23 +3,23 @@ current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bu
 creating Makefile
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/byebug-13.0.0/ext/byebug
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-ou69bz sitelibdir\=./.gem.20260417-2252-ou69bz clean
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-efvxys sitelibdir\=./.gem.20260625-2219-efvxys clean
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/byebug-13.0.0/ext/byebug
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-ou69bz sitelibdir\=./.gem.20260417-2252-ou69bz
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-efvxys sitelibdir\=./.gem.20260625-2219-efvxys
 compiling breakpoint.c
 compiling byebug.c
 compiling context.c
-compiling locker.c
 compiling threads.c
-byebug.c: In function ‘check_started’:
-byebug.c:69:1: warning: old-style function definition [-Wold-style-definition]
-   69 | check_started()
-      | ^~~~~~~~~~~~~
+compiling locker.c
 locker.c: In function ‘byebug_pop_from_locked’:
 locker.c:53:1: warning: old-style function definition [-Wold-style-definition]
    53 | byebug_pop_from_locked()
       | ^~~~~~~~~~~~~~~~~~~~~~
+byebug.c: In function ‘check_started’:
+byebug.c:69:1: warning: old-style function definition [-Wold-style-definition]
+   69 | check_started()
+      | ^~~~~~~~~~~~~
 byebug.c: In function ‘Init_byebug’:
 byebug.c:871:1: warning: old-style function definition [-Wold-style-definition]
   871 | Init_byebug()
@@ -35,8 +35,8 @@ cc1: note: unrecognized command-line option ‘-Wno-constant-logical-operand’
 linking shared-object byebug/byebug.so
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/byebug-13.0.0/ext/byebug
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-ou69bz sitelibdir\=./.gem.20260417-2252-ou69bz install
-/usr/bin/install -c -m 0755 byebug.so ./.gem.20260417-2252-ou69bz/byebug
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-efvxys sitelibdir\=./.gem.20260625-2219-efvxys install
+/usr/bin/install -c -m 0755 byebug.so ./.gem.20260625-2219-efvxys/byebug
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/byebug-13.0.0/ext/byebug
-make DESTDIR\= sitearchdir\=./.gem.20260417-2252-ou69bz sitelibdir\=./.gem.20260417-2252-ou69bz clean
+make DESTDIR\= sitearchdir\=./.gem.20260625-2219-efvxys sitelibdir\=./.gem.20260625-2219-efvxys clean

data/vendor/bundle/ruby/4.0.0/extensions/x86_64-linux/4.0.0/json-2.18.1/gem_make.out

@@ -10,16 +10,16 @@ checking for cpuid.h... yes
 creating Makefile
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/json-2.18.1/ext/json/ext/parser
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-xyozx9 sitelibdir\=./.gem.20260417-2252-xyozx9 clean
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-2s49ni sitelibdir\=./.gem.20260625-2219-2s49ni clean
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/json-2.18.1/ext/json/ext/parser
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-xyozx9 sitelibdir\=./.gem.20260417-2252-xyozx9
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-2s49ni sitelibdir\=./.gem.20260625-2219-2s49ni
 compiling parser.c
 linking shared-object json/ext/parser.so
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/json-2.18.1/ext/json/ext/parser
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-xyozx9 sitelibdir\=./.gem.20260417-2252-xyozx9 install
-/usr/bin/install -c -m 0755 parser.so ./.gem.20260417-2252-xyozx9/json/ext
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-2s49ni sitelibdir\=./.gem.20260625-2219-2s49ni install
+/usr/bin/install -c -m 0755 parser.so ./.gem.20260625-2219-2s49ni/json/ext
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/json-2.18.1/ext/json/ext/parser
-make DESTDIR\= sitearchdir\=./.gem.20260417-2252-xyozx9 sitelibdir\=./.gem.20260417-2252-xyozx9 clean
+make DESTDIR\= sitearchdir\=./.gem.20260625-2219-2s49ni sitelibdir\=./.gem.20260625-2219-2s49ni clean

data/vendor/bundle/ruby/4.0.0/extensions/x86_64-linux/4.0.0/prism-1.9.0/gem_make.out

@@ -6,15 +6,15 @@ checking for whether -fvisibility=hidden is accepted as CFLAGS... yes
 creating Makefile
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/prism-1.9.0/ext/prism
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-miuykf sitelibdir\=./.gem.20260417-2252-miuykf clean
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-q0aq54 sitelibdir\=./.gem.20260625-2219-q0aq54 clean
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/prism-1.9.0/ext/prism
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-miuykf sitelibdir\=./.gem.20260417-2252-miuykf
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-q0aq54 sitelibdir\=./.gem.20260625-2219-q0aq54
 compiling api_node.c
 compiling api_pack.c
 compiling extension.c
-compiling ./../../src/diagnostic.c
 compiling ./../../src/encoding.c
+compiling ./../../src/diagnostic.c
 compiling ./../../src/node.c
 compiling ./../../src/options.c
 compiling ./../../src/pack.c
@@ -37,8 +37,8 @@ compiling ./../../src/util/pm_strpbrk.c
 linking shared-object prism/prism.so
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/prism-1.9.0/ext/prism
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-miuykf sitelibdir\=./.gem.20260417-2252-miuykf install
-/usr/bin/install -c -m 0755 prism.so ./.gem.20260417-2252-miuykf/prism
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-q0aq54 sitelibdir\=./.gem.20260625-2219-q0aq54 install
+/usr/bin/install -c -m 0755 prism.so ./.gem.20260625-2219-q0aq54/prism
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/prism-1.9.0/ext/prism
-make DESTDIR\= sitearchdir\=./.gem.20260417-2252-miuykf sitelibdir\=./.gem.20260417-2252-miuykf clean
+make DESTDIR\= sitearchdir\=./.gem.20260625-2219-q0aq54 sitelibdir\=./.gem.20260625-2219-q0aq54 clean

data/vendor/bundle/ruby/4.0.0/extensions/x86_64-linux/4.0.0/racc-1.8.1/gem_make.out

@@ -3,16 +3,16 @@ current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bu
 creating Makefile
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/racc-1.8.1/ext/racc/cparse
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-zbf2hm sitelibdir\=./.gem.20260417-2252-zbf2hm clean
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-rl1ihv sitelibdir\=./.gem.20260625-2219-rl1ihv clean
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/racc-1.8.1/ext/racc/cparse
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-zbf2hm sitelibdir\=./.gem.20260417-2252-zbf2hm
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-rl1ihv sitelibdir\=./.gem.20260625-2219-rl1ihv
 compiling cparse.c
 linking shared-object racc/cparse.so
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/racc-1.8.1/ext/racc/cparse
-make -j5 DESTDIR\= sitearchdir\=./.gem.20260417-2252-zbf2hm sitelibdir\=./.gem.20260417-2252-zbf2hm install
-/usr/bin/install -c -m 0755 cparse.so ./.gem.20260417-2252-zbf2hm/racc
+make -j5 DESTDIR\= sitearchdir\=./.gem.20260625-2219-rl1ihv sitelibdir\=./.gem.20260625-2219-rl1ihv install
+/usr/bin/install -c -m 0755 cparse.so ./.gem.20260625-2219-rl1ihv/racc
 
 current directory: /home/runner/work/openfga-ruby-sdk/openfga-ruby-sdk/vendor/bundle/ruby/4.0.0/gems/racc-1.8.1/ext/racc/cparse
-make DESTDIR\= sitearchdir\=./.gem.20260417-2252-zbf2hm sitelibdir\=./.gem.20260417-2252-zbf2hm clean
+make DESTDIR\= sitearchdir\=./.gem.20260625-2219-rl1ihv sitelibdir\=./.gem.20260625-2219-rl1ihv clean

data/vendor/bundle/ruby/4.0.0/specifications/bundler-2.5.9.gemspec

@@ -21,5 +21,5 @@ Gem::Specification.new do |s|
   s.rubygems_version = "3.5.9".freeze
   s.summary = "The best way to manage your application's dependencies".freeze
 
-  s.installed_by_version = "4.0.10".freeze
+  s.installed_by_version = "4.0.15".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openfga
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Carla Urrea Stabile, Steven Hobbs
@@ -196,6 +196,8 @@ files:
 - docs/WriteRequest.md
 - docs/WriteRequestDeletes.md
 - docs/WriteRequestWrites.md
+- example/api-executor/README.md
+- example/api-executor/main.rb
 - example/example1/README.md
 - example/example1/main.rb
 - example/example2/.env.example
@@ -209,6 +211,8 @@ files:
 - lib/openfga/api_model_base.rb
 - lib/openfga/client.rb
 - lib/openfga/client/client_errors.rb
+- lib/openfga/client/models/api_executor_request.rb
+- lib/openfga/client/models/api_executor_response.rb
 - lib/openfga/client/openfga_client.rb
 - lib/openfga/configuration.rb
 - lib/openfga/constants.rb
@@ -308,6 +312,7 @@ files:
 - release-please-config.json
 - spec/api/open_fga_api_spec.rb
 - spec/api_client_spec.rb
+- spec/client/api_executor_spec.rb
 - spec/client/openfga_client_spec.rb
 - spec/configuration_spec.rb
 - spec/fixtures/expand_response.json
@@ -4224,7 +4229,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.15
 specification_version: 4
 summary: This is community-driven Ruby SDK for OpenFGA. It provides a wrapper around
   the [OpenFGA API definition](https://openfga.dev/api).