phaseo_sdk 2.1.0

data/lib/phaseo_sdk/version.rb

@@ -0,0 +1,3 @@
+module PhaseoSdk
+  VERSION = "2.1.0"
+end

data/lib/phaseo_sdk.rb

@@ -0,0 +1,2 @@
+require_relative "phaseo_sdk/version"
+require_relative "index"

data/phaseo_sdk.gemspec

@@ -0,0 +1,22 @@
+require_relative "lib/phaseo_sdk/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "phaseo_sdk"
+  spec.version = PhaseoSdk::VERSION
+  spec.authors = ["Phaseo"]
+  spec.email = ["danielbutler500@gmail.com"]
+
+  spec.summary = "Official Phaseo Gateway SDK for Ruby"
+  spec.description = "Ruby client for the Phaseo Gateway API with generated endpoints and typed wrappers."
+  spec.homepage = "https://phaseo.app"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/phaseoteam/Phaseo"
+  spec.metadata["changelog_uri"] = "https://github.com/phaseoteam/Phaseo/blob/main/packages/sdk/sdk-ruby/CHANGELOG.md"
+
+  spec.files = Dir.glob("{lib,examples,tests}/**/*").select { |f| File.file?(f) }
+  spec.files += %w[README.md phaseo_sdk.gemspec]
+  spec.require_paths = ["lib"]
+end

data/tests/api_key_mutations_test.rb

@@ -0,0 +1,39 @@
+require "minitest/autorun"
+require_relative "../lib/index"
+
+class ApiKeyMutationsTest < Minitest::Test
+  def test_api_key_mutation_helpers_return_payloads
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      case [method, path]
+      when ["POST", "/keys"]
+        { "data" => { "id" => "key_123", "name" => "Admin Key", "status" => "active" } }
+      when ["PATCH", "/keys/key_123"]
+        { "data" => { "id" => "key_123", "name" => "Renamed Key", "status" => "disabled" } }
+      when ["DELETE", "/keys/key_123"]
+        { "data" => { "id" => "key_123", "deleted" => true } }
+      else
+        raise "Unexpected request"
+      end
+    end
+
+    created = client.create_api_key("name" => "Admin Key", "scopes" => ["gateway:read"])
+    updated = client.update_api_key("key_123", "name" => "Renamed Key", "disabled" => true)
+    deleted = client.delete_api_key("key_123")
+
+    assert_equal "active", created["data"]["status"]
+    assert_equal "disabled", updated["data"]["status"]
+    assert_equal true, deleted["data"]["deleted"]
+    assert_equal [
+      ["POST", "/keys", nil, nil, { "name" => "Admin Key", "scopes" => ["gateway:read"] }],
+      ["PATCH", "/keys/key_123", nil, nil, { "name" => "Renamed Key", "disabled" => true }],
+      ["DELETE", "/keys/key_123", nil, nil, nil]
+    ], calls
+  end
+end

data/tests/api_key_test.rb

@@ -0,0 +1,30 @@
+require "minitest/autorun"
+require_relative "../lib/index"
+
+class ApiKeyTest < Minitest::Test
+  def test_get_api_key_returns_payload
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      {
+        "data" => {
+          "id" => "key_123",
+          "hash" => "keyhash_123",
+          "status" => "active"
+        }
+      }
+    end
+
+    response = client.get_api_key("key_123")
+
+    assert_equal "key_123", response["data"]["id"]
+    assert_equal "keyhash_123", response["data"]["hash"]
+    assert_equal "active", response["data"]["status"]
+    assert_equal [["GET", "/keys/key_123", nil, nil, nil]], calls
+  end
+end

data/tests/api_keys_test.rb

@@ -0,0 +1,30 @@
+require "minitest/autorun"
+require_relative "../lib/index"
+
+class ApiKeysTest < Minitest::Test
+  def test_list_api_keys_returns_payload
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      {
+        "object" => "list",
+        "data" => [
+          { "id" => "key_123", "status" => "active" },
+          { "id" => "key_456", "status" => "disabled" }
+        ]
+      }
+    end
+
+    response = client.list_api_keys("disabled" => "true", "limit" => "2")
+
+    assert_equal "list", response["object"]
+    assert_equal "key_123", response["data"][0]["id"]
+    assert_equal "disabled", response["data"][1]["status"]
+    assert_equal [["GET", "/keys", { "disabled" => "true", "limit" => "2" }, nil, nil]], calls
+  end
+end

data/tests/async_jobs_test.rb

@@ -0,0 +1,13 @@
+require "minitest/autorun"
+require_relative "../lib/index"
+
+class AsyncJobsTest < Minitest::Test
+  def test_async_jobs_resource_builds_expected_url
+    client = PhaseoSdk::Phaseo.new(api_key: "test", enable_deprecation_warnings: false)
+
+    assert_equal(
+      "wss://api.phaseo.app/v1/async/video/video%20123/ws?interval_ms=1500&close_on_terminal=false",
+      client.async_jobs.websocket_url("video", "video 123", interval_ms: 1500, close_on_terminal: false)
+    )
+  end
+end

data/tests/batches_test.rb

@@ -0,0 +1,124 @@
+require "minitest/autorun"
+require_relative "../lib/index"
+
+class BatchesTest < Minitest::Test
+  def test_create_batch_returns_payload
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      {
+        "id" => "batch_123",
+        "status" => "validating",
+        "provider" => "openai",
+        "request_id" => "req_ruby_batch_1",
+        "session_id" => "session_ruby_batch_1",
+        "pricing_lines" => [{ "provider" => "openai", "cost_usd" => 0.03 }]
+      }
+    end
+
+    response = client.create_batch(
+      "input_file_id" => "file_123",
+      "endpoint" => "/v1/responses",
+      "completion_window" => "24h",
+      "session_id" => "session_ruby_batch_1"
+    )
+
+    assert_equal "batch_123", response["id"]
+    assert_equal "validating", response["status"]
+    assert_equal "openai", response["provider"]
+    assert_equal "req_ruby_batch_1", response["request_id"]
+    assert_equal "session_ruby_batch_1", response["session_id"]
+    assert_equal "openai", response.dig("pricing_lines", 0, "provider")
+    assert_equal [["POST", "/batches", nil, nil, {
+      "input_file_id" => "file_123",
+      "endpoint" => "/v1/responses",
+      "completion_window" => "24h",
+      "session_id" => "session_ruby_batch_1"
+    }]], calls
+  end
+
+  def test_retrieve_batch_returns_payload
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      {
+        "id" => "batch_123",
+        "status" => "completed",
+        "provider" => "openai",
+        "request_id" => "req_ruby_batch_2",
+        "session_id" => "session_ruby_batch_1",
+        "request_counts" => { "total" => 4, "completed" => 3, "failed" => 1 },
+        "billing" => { "charged" => true, "cost_usd" => 0.12 }
+      }
+    end
+
+    response = client.retrieve_batch("batch_123")
+
+    assert_equal "batch_123", response["id"]
+    assert_equal "completed", response["status"]
+    assert_equal "openai", response["provider"]
+    assert_equal "req_ruby_batch_2", response["request_id"]
+    assert_equal "session_ruby_batch_1", response["session_id"]
+    assert_equal 4, response.dig("request_counts", "total")
+    assert_equal true, response.dig("billing", "charged")
+    assert_equal [["GET", "/batches/batch_123", nil, nil, nil]], calls
+  end
+
+  def test_cancel_batch_returns_payload
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      { "id" => "batch_123", "status" => "cancelling" }
+    end
+
+    response = client.cancel_batch("batch_123")
+
+    assert_equal "batch_123", response["id"]
+    assert_equal "cancelling", response["status"]
+    assert_equal(
+      "wss://api.phaseo.app/v1/async/batch/batch_123/ws?interval_ms=1500&close_on_terminal=false",
+      client.batch_websocket_url("batch_123", interval_ms: 1500, close_on_terminal: false)
+    )
+    assert_equal(
+      "wss://api.phaseo.app/v1/async/video/video%20123/ws?interval_ms=1500&close_on_terminal=false",
+      client.get_async_job_websocket_url("video", "video 123", interval_ms: 1500, close_on_terminal: false)
+    )
+    assert_equal [["POST", "/batches/batch_123/cancel", nil, nil, nil]], calls
+  end
+
+  def test_cancel_batch_surfaces_request_errors
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    client.raw_client.define_singleton_method(:request) do |**_args|
+      raise Phaseo::Gen::RequestError.new(
+        status_code: 404,
+        status_message: "Not Found",
+        response_body: "{\"error\":\"not found\"}"
+      )
+    end
+
+    error = assert_raises(Phaseo::Gen::RequestError) do
+      client.cancel_batch("batch_missing_123")
+    end
+
+    assert_equal 404, error.status_code
+  end
+end

data/tests/chat_test.rb

@@ -0,0 +1,75 @@
+require "minitest/autorun"
+require_relative "../lib/index"
+
+class ChatTest < Minitest::Test
+  def test_generate_text_preserves_gateway_metadata
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      if method == "GET" && path == "/models"
+        next({
+          "models" => [
+            {
+              "model_id" => "openai/gpt-5-nano",
+              "status" => "active"
+            }
+          ]
+        })
+      end
+      {
+        "id" => "req_ruby_chat_1",
+        "nativeResponseId" => "chatcmpl_ruby_1",
+        "object" => "chat.completion",
+        "created" => 1_723_000_000,
+        "model" => "openai/gpt-5-nano",
+        "provider" => "openai",
+        "session_id" => "session_ruby_chat_1",
+        "upstream_request_id" => "upstream_ruby_chat_1",
+        "provider_attempts" => [
+          { "provider" => "openai", "status_code" => 200, "duration_ms" => 412 }
+        ],
+        "pricing_lines" => [
+          { "provider" => "openai", "cost_usd" => 0.0025 }
+        ],
+        "usage" => {
+          "input_tokens" => 2,
+          "output_tokens" => 1,
+          "total_tokens" => 3
+        },
+        "choices" => [
+          {
+            "index" => 0,
+            "message" => { "role" => "assistant", "content" => "hi" },
+            "finish_reason" => "stop"
+          }
+        ]
+      }
+    end
+
+    response = client.generate_text(
+      {
+        model: "openai/gpt-5-nano",
+        messages: [{ role: "user", content: "hi" }]
+      }
+    )
+
+    assert_equal "openai", response["provider"]
+    assert_equal "chatcmpl_ruby_1", response["nativeResponseId"]
+    assert_equal "session_ruby_chat_1", response["session_id"]
+    assert_equal "upstream_ruby_chat_1", response["upstream_request_id"]
+    assert_equal "openai", response.dig("provider_attempts", 0, "provider")
+    assert_equal "openai", response.dig("pricing_lines", 0, "provider")
+    assert_equal 2, response["usage"]["input_tokens"]
+    assert_equal 1, response["usage"]["output_tokens"]
+    assert_equal 3, response["usage"]["total_tokens"]
+    assert_equal [
+      ["GET", "/models", { "model_id" => "openai/gpt-5-nano", "limit" => "1" }, nil, nil],
+      ["POST", "/chat/completions", nil, nil, { model: "openai/gpt-5-nano", messages: [{ role: "user", content: "hi" }] }]
+    ], calls
+  end
+end

data/tests/current_key_test.rb

@@ -0,0 +1,29 @@
+require "minitest/autorun"
+require_relative "../lib/index"
+
+class CurrentKeyTest < Minitest::Test
+  def test_get_current_api_key_returns_payload
+    client = PhaseoSdk::Phaseo.new(
+      api_key: "test",
+      enable_deprecation_warnings: false
+    )
+
+    calls = []
+    client.raw_client.define_singleton_method(:request) do |method:, path:, query: nil, headers: nil, body: nil|
+      calls << [method, path, query, headers, body]
+      {
+        "data" => {
+          "id" => "key_123",
+          "prefix" => "phaseo_v1_sk_test",
+          "status" => "active"
+        }
+      }
+    end
+
+    response = client.get_current_api_key
+
+    assert_equal "key_123", response["data"]["id"]
+    assert_equal "active", response["data"]["status"]
+    assert_equal [["GET", "/key", nil, nil, nil]], calls
+  end
+end