runapi-core 0.2.16 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f199f45d065827bb1931ab5faff8dd945fd62b3cb0a5260b268fdfee41875a45
-  data.tar.gz: 6d2c40ffded8406818798c40bfddca448e1a7149981fd0b012dc5c0f4d17e02e
+  metadata.gz: cb5369d4bc3ec00ba92341e7151b7e1d62b6972ef3e84fd35474638da86a9926
+  data.tar.gz: ed1fe305dba138db597e86e31421312bf0a017d9c3ed1564b0e44044a9a537a0
 SHA512:
-  metadata.gz: 17e79439f00b8b10fbbbbcf00b3d074cfd9e3cf9d70c4b20b91743aee12cba2e122c9da364a66c0c21844d5e2153083102acacfb639871e1a24377899b3bda41
-  data.tar.gz: 707cadac8b31ca82c31fa191cb017e58192eb7c6b4da7bd15aba8fe40209f783537ee2452bc4846538c123ddc0843c31c7b24a86158a766f7740ec309e269d38
+  metadata.gz: 7c885608b3f52f9e5ab11937e032149a164a781c8f413e19d394484a7b6576b622afd82c2c152ed52ca5ff67c389f9ee40d28aef174f7553947fd888c204a1cb
+  data.tar.gz: b0af7a1272a3f69003bb4fa80ca4848511f847dcd7a5a1e1c5678b358c90313962312ddc4f7a0f870a32de801cf2e5af94e33879fec14084ecf1b36e920be8ed

data/README.md

@@ -10,7 +10,31 @@ gem install runapi-core
 
 ## Notes
 
-Use the core gem for common client options, error classes, request helpers, and task polling behavior that Provider Clients share. Public SDK docs live at https://runapi.ai/docs#runapi-sdks and the model catalog lives at https://runapi.ai/models.
+Use the core gem for common client options, error classes, request helpers, and task polling behavior that Provider Clients share. Public SDK docs live at https://runapi.ai/docs/resources/sdks and the model catalog lives at https://runapi.ai/models.
+
+## Live Pricing
+
+Every Provider Client exposes `pricing`. Schedule lookup and quotes use the live API response and do not retain a local price cache.
+
+```ruby
+schedules = client.pricing.list(service: "suno")
+quote = client.pricing.quote(
+  service: "suno",
+  action: "convert_audio",
+  params: {}
+)
+```
+
+Public schedule lookup and quotes that use only public parameters work without an API key. Pass a standard API key when a quote references an account-owned source Task.
+
+Use `PricingClient` when pricing is the only capability needed:
+
+```ruby
+require "runapi/core"
+
+pricing = RunApi::Core::PricingClient.new
+schedules = pricing.list(service: "suno")
+```
 
 ## Request Identifiers
 

data/lib/runapi/core/auth.rb

@@ -19,15 +19,20 @@ module RunApi
       # @param explicit [String, nil] API key passed directly to a client constructor.
       # @return [String] the resolved API key
       def self.resolve_api_key(explicit = nil)
-        resolved = normalize(explicit) ||
-          normalize(RunApi.respond_to?(:api_key) ? RunApi.api_key : nil) ||
-          normalize(ENV[ENV_VAR_NAME])
+        resolved = resolve_optional_api_key(explicit)
 
         raise AuthenticationError, MISSING_KEY_MESSAGE unless resolved
 
         resolved
       end
 
+      # Resolve an API key when present without requiring one for public resources.
+      def self.resolve_optional_api_key(explicit = nil)
+        normalize(explicit) ||
+          normalize(RunApi.respond_to?(:api_key) ? RunApi.api_key : nil) ||
+          normalize(ENV[ENV_VAR_NAME])
+      end
+
       def self.normalize(value)
         return nil unless value.is_a?(String)
 

data/lib/runapi/core/client.rb

@@ -3,7 +3,7 @@
 module RunApi
   module Core
     # Base class for every RunAPI client. Resolves the API key, builds the shared
-    # HTTP client, and exposes the Universal Resources (file upload, account) that
+    # HTTP client, and exposes the Universal Resources (file upload, account, pricing) that
     # are available on any client regardless of which model gem was required.
     #
     # Provider clients inherit from this and build their model resources from the
@@ -13,6 +13,8 @@ module RunApi
       attr_reader :files
       # @return [Account] Account info and balance operations.
       attr_reader :account
+      # @return [Pricing] Live Price Schedule lookup and Price Quote operations.
+      attr_reader :pricing
 
       def initialize(api_key: nil, **options)
         @api_key = Core::Auth.resolve_api_key(api_key)
@@ -21,6 +23,7 @@ module RunApi
         @http = client_options.http_client || Core::HttpClient.new(client_options)
         @files = Files.new(@http)
         @account = Account.new(@http)
+        @pricing = Pricing.new(@http)
       end
 
       # Closes the SDK-created HTTP client. Injected clients remain caller-owned.

data/lib/runapi/core/http_client.rb

@@ -37,6 +37,10 @@ module RunApi
             raise NetworkError, e.message
           end
 
+          if response.is_a?(Net::HTTPNotModified) && options&.allow_not_modified
+            return Response.new(body: {"not_modified" => true}, headers: response_headers(response))
+          end
+
           if response.is_a?(Net::HTTPSuccess)
             body = parse_body(response.body)
             return nil if body.nil?
@@ -106,7 +110,7 @@ module RunApi
         klass = Net::HTTP.const_get(method.to_s.capitalize)
         req = klass.new(uri.request_uri)
 
-        req["Authorization"] = "Bearer #{@options.api_key}"
+        req["Authorization"] = "Bearer #{@options.api_key}" if @options.api_key
         req["Accept"] = "application/json"
         req["User-Agent"] = Constants::SDK_USER_AGENT
 

data/lib/runapi/core/pricing.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module RunApi
+  module Core
+    class Pricing
+      include RunApi::Core::ResourceHelpers
+
+      SCHEDULES_ENDPOINT = "/api/v1/price_schedules"
+      QUOTES_ENDPOINT = "/api/v1/price_quotes"
+
+      class Schedule < RunApi::Core::BaseModel
+        required :service, String
+        required :action, String
+        optional :model, String
+        required :pricing_status, String
+        required :catalog_status, String
+        required :currency, String
+        required :billing_unit, String
+        required :billing_strategy, String
+        optional :unit_price_cents, Numeric
+        optional :input_price_per_1m_cents, Numeric
+        optional :output_price_per_1m_cents, Numeric
+        optional :cache_read_price_per_1m_cents, Numeric
+        optional :cache_write_price_per_1m_cents, Numeric
+        optional :cache_write_5m_price_per_1m_cents, Numeric
+        optional :cache_write_1h_price_per_1m_cents, Numeric
+        required :billing_config, Hash
+      end
+
+      class ScheduleListResponse < RunApi::Core::BaseModel
+        required :as_of, String
+        required :price_schedules, [Schedule]
+      end
+
+      class ScheduleNotModifiedResponse < RunApi::Core::BaseModel
+        required :not_modified, TrueClass
+      end
+
+      class QuoteResponse < RunApi::Core::BaseModel
+        required :service, String
+        required :action, String
+        optional :model, String
+        required :pricing_status, String
+        required :currency, String
+        required :reservation_amount_cents, Numeric
+        required :estimate_basis, String
+        required :as_of, String
+      end
+
+      class QuoteEnvelope < RunApi::Core::BaseModel
+        required :price_quote, QuoteResponse
+      end
+
+      def initialize(http)
+        @http = http
+      end
+
+      def list(service: nil, action: nil, model: nil, options: nil)
+        query = URI.encode_www_form(compact_params(service:, action:, model:))
+        path = query.empty? ? SCHEDULES_ENDPOINT : "#{SCHEDULES_ENDPOINT}?#{query}"
+        request_options = (options || RequestOptions.new).dup
+        request_options.allow_not_modified = true
+        response = @http.request(:get, path, options: request_options)
+        payload = response.is_a?(Core::Response) ? response.body : response
+        response_class = payload["not_modified"] ? ScheduleNotModifiedResponse : ScheduleListResponse
+        result = RunApi::Core::BaseModel.coerce(payload, as: response_class)
+        result.with_response_headers(response.response_headers) if response.is_a?(Core::Response)
+        result
+      end
+
+      def quote(service:, action:, model: nil, params: {}, options: nil)
+        response = request(
+          :post,
+          QUOTES_ENDPOINT,
+          body: compact_params(service:, action:, model:, params:),
+          options:,
+          response_class: QuoteEnvelope
+        )
+        response.price_quote
+      end
+    end
+
+    # Standalone live Pricing client with optional API authentication.
+    class PricingClient < Pricing
+      def initialize(api_key: nil, **options)
+        client_options = Core::ClientOptions.new(
+          api_key: Core::Auth.resolve_optional_api_key(api_key),
+          **options
+        )
+        @owns_http_client = client_options.http_client.nil?
+        super(client_options.http_client || Core::HttpClient.new(client_options))
+      end
+
+      # Closes the SDK-created HTTP client. Injected clients remain caller-owned.
+      def close
+        @http.close if @owns_http_client
+      end
+    end
+  end
+end

data/lib/runapi/core/types.rb

@@ -22,7 +22,7 @@ module RunApi
     #   )
     #
     # @!attribute [rw] api_key
-    #   @return [String] API key for authentication. Required.
+    #   @return [String, nil] API key for authenticated resources and protected Price Quotes.
     # @!attribute [rw] base_url
     #   @return [String] Base URL for API requests. Defaults to RunApi.base_url.
     # @!attribute [rw] timeout
@@ -78,6 +78,7 @@ module RunApi
       :headers,
       :timeout,
       :max_retries,
+      :allow_not_modified,
       keyword_init: true
     )
 
@@ -100,6 +101,25 @@ module RunApi
       end
     end
 
+    class TaskReservation < BaseModel
+      required :amount_cents, Numeric
+    end
+
+    class TaskSettlement < BaseModel
+      required :charged_amount_cents, Numeric
+      required :amount_micro_cents, Numeric
+    end
+
+    class TaskRefund < BaseModel
+      required :refunded_at, String
+    end
+
+    class TaskBillingFacts < BaseModel
+      optional :reservation, TaskReservation
+      optional :settlement, TaskSettlement
+      optional :refund, TaskRefund
+    end
+
     # Typed response structure for async task operations.
     # Additional API-specific fields are preserved and exposed via dot notation.
     #
@@ -122,6 +142,7 @@ module RunApi
       optional :id, String
       optional :status, String
       optional :error, String
+      optional :billing, TaskBillingFacts
     end
   end
 end

data/lib/runapi/core/version.rb

@@ -2,7 +2,7 @@
 
 module RunApi
   module Core
-    VERSION = "0.2.16"
+    VERSION = "0.3.1"
   end
 
   VERSION = Core::VERSION

data/lib/runapi/core.rb

@@ -21,4 +21,5 @@ require_relative "core/polling"
 require_relative "core/resource_helpers"
 require_relative "core/files"
 require_relative "core/account"
+require_relative "core/pricing"
 require_relative "core/client"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-core
 version: !ruby/object:Gem::Version
-  version: 0.2.16
+  version: 0.3.1
 platform: ruby
 authors:
 - RunAPI
@@ -55,6 +55,7 @@ files:
 - lib/runapi/core/http_client.rb
 - lib/runapi/core/multipart_body.rb
 - lib/runapi/core/polling.rb
+- lib/runapi/core/pricing.rb
 - lib/runapi/core/resource_helpers.rb
 - lib/runapi/core/response.rb
 - lib/runapi/core/types.rb