runapi-core 0.2.14 → 0.2.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c441c1752f41281ef46e89e708570844c321371e91b400879e92c1555038a61
-  data.tar.gz: 927b1f5259c7d7e799f1509eb2f0b67ed8635722bbf920c4c49ce67a72f92838
+  metadata.gz: f199f45d065827bb1931ab5faff8dd945fd62b3cb0a5260b268fdfee41875a45
+  data.tar.gz: 6d2c40ffded8406818798c40bfddca448e1a7149981fd0b012dc5c0f4d17e02e
 SHA512:
-  metadata.gz: 26702004f5ea1b631203123c83353c64ab858c0cc440c2f506717d666574d14d2a284f14bcb1874ecac7fed28a5c8b40bdd14425e25e31948c380a99c6f7515e
-  data.tar.gz: 87ac2f48d103c696e196a9bbc00ba56cdf2d87322aebcb4453dae655db9ef89bfe3fa116a21127e4b5188823facb4ae838add55686a4c45950463dda5e23313f
+  metadata.gz: 17e79439f00b8b10fbbbbcf00b3d074cfd9e3cf9d70c4b20b91743aee12cba2e122c9da364a66c0c21844d5e2153083102acacfb639871e1a24377899b3bda41
+  data.tar.gz: 707cadac8b31ca82c31fa191cb017e58192eb7c6b4da7bd15aba8fe40209f783537ee2452bc4846538c123ddc0843c31c7b24a86158a766f7740ec309e269d38

data/README.md

@@ -16,6 +16,8 @@ Use the core gem for common client options, error classes, request helpers, and
 
 RunAPI accepts an optional `X-Client-Request-Id` header on public API calls. Use printable ASCII values up to 512 characters. Accepted values are echoed in the response and stored with the RunAPI task for support and reconciliation.
 
+Task-creation calls also accept an optional opaque `Idempotency-Key` up to 512 characters. Generate one value per logical task and reuse it only with identical input after an unknown result. Reusing the value with different input returns `409 Conflict`; do not derive it from `X-Client-Request-Id`.
+
 High-level Ruby Provider Client resource methods accept per-request options and keep response headers on the returned model object. This example uses the Suno Provider Client; install `runapi-suno` to run it.
 
 ```ruby
@@ -23,7 +25,10 @@ require "runapi/suno"
 
 client = RunApi::Suno::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY"))
 options = RunApi::Core::RequestOptions.new(
-  headers: {"X-Client-Request-Id" => "order-123"}
+  headers: {
+    "X-Client-Request-Id" => "order-123",
+    "Idempotency-Key" => "opaque-logical-task-123"
+  }
 )
 
 response = client.text_to_music.create(

data/lib/runapi/core/client.rb

@@ -17,11 +17,17 @@ module RunApi
       def initialize(api_key: nil, **options)
         @api_key = Core::Auth.resolve_api_key(api_key)
         client_options = Core::ClientOptions.new(api_key: @api_key, **options)
+        @owns_http_client = client_options.http_client.nil?
         @http = client_options.http_client || Core::HttpClient.new(client_options)
         @files = Files.new(@http)
         @account = Account.new(@http)
       end
 
+      # Closes the SDK-created HTTP client. Injected clients remain caller-owned.
+      def close
+        @http.close if @owns_http_client
+      end
+
       protected
 
       attr_reader :http

data/lib/runapi/core/http_client.rb

@@ -60,6 +60,12 @@ module RunApi
         close_multipart_files(req)
       end
 
+      def close
+        @pool.shutdown do |http|
+          http.finish if http.started?
+        end
+      end
+
       # PUT bytes straight to a pre-authorized upload URL with the exact headers
       # issued for it. Skips the base URL, auth, and retries: the URL is single-use
       # and the body is not safe to replay.

data/lib/runapi/core/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runapi-core
 version: !ruby/object:Gem::Version
-  version: 0.2.14
+  version: 0.2.16
 platform: ruby
 authors:
 - RunAPI
@@ -13,16 +13,22 @@ dependencies:
   name: connection_pool
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.4'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4'
 description: The RunAPI Core Ruby SDK provides shared authentication, HTTP, retry,
   error, and polling primitives for RunAPI model gems. Install `runapi-core` only
   when you are building SDK infrastructure or shared Ruby tooling; application code
@@ -77,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.17
 specification_version: 4
 summary: RunAPI Core Ruby SDK
 test_files: []