phoebe 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df562241307cad128d5e189df4ae0efe98be043601239991a9dd0179a085e1e7
-  data.tar.gz: d407be244d1f103c295d5f803dc015d66143dd5c8c81e4e0e1880a6e4ce4d508
+  metadata.gz: 436ba8dede7b74afe553da785e9f212de840562adc8d36eb92141af7c19ebba1
+  data.tar.gz: 884945cac800c0c18da46102ff683f075113f8fb9a97520adc3eed26cf413fea
 SHA512:
-  metadata.gz: a0b51f30d11952bbd7e4a6bde3e69292a0355a664035348806d17307fc1f5bb31ee26c260c16efdd447db28ea5652da37382525933342d4ba7aed7f052965b2b
-  data.tar.gz: 65b4ac646bfb478b609b200256ec64095891365593285b1120a3c4235ef6e2146c4ea9b4af894d5618b51cea3d26552d1a23112fbe78ba9814d5f5083d4557b0
+  metadata.gz: d1060f89f0ee3f41461b7e2c5fcd235f1d7166dbd7b1186f63ed8742cb83decd9a4debddaf69735b9821f9d57d0e8135ad602210a4c955e895b388da90296bcd
+  data.tar.gz: 427d20e01005775fc1b2ce828205568465c7a65ab84be2c28055a35ad2901ff52fafea37eea465e74c79131b3e78eea7eb04e8e3d6e8a11a4ebc4f5a4c7b5d43

data/CHANGELOG.md

@@ -1,5 +1,87 @@
 # Changelog
 
+## 0.1.0-alpha.2 (2026-05-14)
+
+Full Changelog: [v0.1.0-alpha.1...v0.1.0-alpha.2](https://github.com/phoebe-bird/phoebe-ruby/compare/v0.1.0-alpha.1...v0.1.0-alpha.2)
+
+### Features
+
+* **api:** manual updates ([109d3c5](https://github.com/phoebe-bird/phoebe-ruby/commit/109d3c57864c1b48b470cb29c152326362fff332))
+* bump default connection pool size limit to minimum of 99 ([01ac449](https://github.com/phoebe-bird/phoebe-ruby/commit/01ac44998fab2e93a78b02e0a12caa3f5d022c43))
+* expose base client options as read only attributes ([77d99c6](https://github.com/phoebe-bird/phoebe-ruby/commit/77d99c6e6021c0eecd95f800084b94936f74d5ff))
+* expose recursive `#to_h` conversion ([940fafb](https://github.com/phoebe-bird/phoebe-ruby/commit/940fafb56476afbc94d8e7b1fe43db3ce3644150))
+* support sorbet aliases at the runtime ([1c8b871](https://github.com/phoebe-bird/phoebe-ruby/commit/1c8b871035a4483f139fdcb85e3245c6a566c300))
+
+
+### Bug Fixes
+
+* `to_sorbet_type` should not return branded types ([37084eb](https://github.com/phoebe-bird/phoebe-ruby/commit/37084ebfc8ae89551c3dc97748f3fcf2a56a1e0a))
+* calling `break` out of streams should be instantaneous ([fca92bf](https://github.com/phoebe-bird/phoebe-ruby/commit/fca92bfa572f66749c43303792fb36141ae0051e))
+* correctly instantiate sorbet type aliases for enums and unions ([0676b84](https://github.com/phoebe-bird/phoebe-ruby/commit/0676b84f5075698c18618c98c9d3deef6348eaad))
+* default content-type for text in multi-part formdata uploads should be text/plain ([decfc76](https://github.com/phoebe-bird/phoebe-ruby/commit/decfc76bed3c5dad19da4b609665b9fc7868e661))
+* **internal:** update gemspec name ([f56d626](https://github.com/phoebe-bird/phoebe-ruby/commit/f56d62659d2e993f7207abbb4651d0923de40679))
+* issue where json.parse errors when receiving HTTP 204 with nobody ([8cfbcb5](https://github.com/phoebe-bird/phoebe-ruby/commit/8cfbcb5c1c3a8ecc53bc875935b133973874a6c2))
+* issue where we cannot mutate arrays on base model derivatives ([715fcdf](https://github.com/phoebe-bird/phoebe-ruby/commit/715fcdfa7aee36ca5c36a79dcb90841805ff6040))
+* prevent rubocop from mangling `===` to `is_a?` check ([bbc3a94](https://github.com/phoebe-bird/phoebe-ruby/commit/bbc3a94869eb86c9e980a17e94c3d9fa2d8b1cec))
+* should not reuse buffers for `IO.copy_stream` interop ([43ba832](https://github.com/phoebe-bird/phoebe-ruby/commit/43ba83288707aa952a0aff40f022b46f180f6047))
+* sorbet types for enums, and make tapioca detection ignore `tapioca dsl` ([cdef832](https://github.com/phoebe-bird/phoebe-ruby/commit/cdef832fdaebe9c970da0e3a2b07d4ec01c8b3b9))
+
+
+### Chores
+
+* **ci:** enable for pull requests ([469208a](https://github.com/phoebe-bird/phoebe-ruby/commit/469208a0deb9d712b4959e48f08d10facf9bf73b))
+* **ci:** only run for pushes and fork pull requests ([6e6d2c7](https://github.com/phoebe-bird/phoebe-ruby/commit/6e6d2c773e1a56ad14012a302c1d4be1f23aefa7))
+* **ci:** skip uploading artifacts on stainless-internal branches ([fd00827](https://github.com/phoebe-bird/phoebe-ruby/commit/fd00827c5b2e333619e7c6454c703d97b1960d7b))
+* configure new SDK language ([08c8fe7](https://github.com/phoebe-bird/phoebe-ruby/commit/08c8fe7e2ad9ca0f315325590f4a3d0d6f2a7605))
+* **docs:** grammar improvements ([1d2a214](https://github.com/phoebe-bird/phoebe-ruby/commit/1d2a21499e071fd16fadaccd51a7e5ad248d85ee))
+* fix misc linting / minor issues ([e965adc](https://github.com/phoebe-bird/phoebe-ruby/commit/e965adc3ceae1bd3c575bc9147341e1135961b66))
+* fix typo in descriptions ([92d6940](https://github.com/phoebe-bird/phoebe-ruby/commit/92d69409f9daa721a7356a955b7acb48a0a8bbd9))
+* force utf-8 locale via `RUBYOPT` when formatting ([6e6b75b](https://github.com/phoebe-bird/phoebe-ruby/commit/6e6b75b4dc805645862526c5ccaa8c888660d650))
+* **internal:** allow streams to also be unwrapped on a per-row basis ([41961d8](https://github.com/phoebe-bird/phoebe-ruby/commit/41961d85ce1577f72619467a62751404bc98f926))
+* **internal:** codegen related update ([1240216](https://github.com/phoebe-bird/phoebe-ruby/commit/124021629d657159ad717365d4e573382ee5a996))
+* **internal:** codegen related update ([4648023](https://github.com/phoebe-bird/phoebe-ruby/commit/46480234b1911d2d1558859f64e95e6cf8460d3f))
+* **internal:** codegen related update ([cacb367](https://github.com/phoebe-bird/phoebe-ruby/commit/cacb3671d92be2f4b4de23a595443921a2ce22ed))
+* **internal:** codegen related update ([c1c6aec](https://github.com/phoebe-bird/phoebe-ruby/commit/c1c6aec66fcf7b36f729836bee082d818a65b81e))
+* **internal:** codegen related update ([25c8d52](https://github.com/phoebe-bird/phoebe-ruby/commit/25c8d527124702fec3b496a475e6f99f874de467))
+* **internal:** codegen related update ([95dc19d](https://github.com/phoebe-bird/phoebe-ruby/commit/95dc19d20c13b2c2368079578364f8fc8354d53d))
+* **internal:** codegen related update ([52fcd8d](https://github.com/phoebe-bird/phoebe-ruby/commit/52fcd8de4df2284a9eade9ceec4d97fb1c3d68d8))
+* **internal:** codegen related update ([400d5f5](https://github.com/phoebe-bird/phoebe-ruby/commit/400d5f5df2157b72505487daff44f27d58bb83b4))
+* **internal:** codegen related update ([9b61f34](https://github.com/phoebe-bird/phoebe-ruby/commit/9b61f34f0a10fb177e78a8ee7b861b91b47e1d65))
+* **internal:** codegen related update ([4c982a9](https://github.com/phoebe-bird/phoebe-ruby/commit/4c982a9ab7fb720eb15aa3a2fd28665c0c0a1c4e))
+* **internal:** codegen related update ([cd3b18f](https://github.com/phoebe-bird/phoebe-ruby/commit/cd3b18f6ce8008b59ff89e8d59e871da83dbfa1b))
+* **internal:** codegen related update ([31ebe27](https://github.com/phoebe-bird/phoebe-ruby/commit/31ebe2730f6c42e322ccf6be4cacf6b7160ad21e))
+* **internal:** codegen related update ([3134935](https://github.com/phoebe-bird/phoebe-ruby/commit/31349351855890f7eea7f1c649652995a21f7531))
+* **internal:** codegen related update ([84b61c6](https://github.com/phoebe-bird/phoebe-ruby/commit/84b61c68526cbce40b53d90314ec51f61cf70287))
+* **internal:** codegen related update ([d8b62a5](https://github.com/phoebe-bird/phoebe-ruby/commit/d8b62a5ee6a2a813a0f805b96b566479367654d5))
+* **internal:** codegen related update ([6849f19](https://github.com/phoebe-bird/phoebe-ruby/commit/6849f1903a602356217bd8db9c4b64d37640fb0a))
+* **internal:** codegen related update ([e1206e5](https://github.com/phoebe-bird/phoebe-ruby/commit/e1206e54dd46adb0715194cf3d8c6b0e84875236))
+* **internal:** codegen related update ([4b78f7d](https://github.com/phoebe-bird/phoebe-ruby/commit/4b78f7da2326b012f7b9dcad1c4920f930ead7c6))
+* **internal:** codegen related update ([d75cd8e](https://github.com/phoebe-bird/phoebe-ruby/commit/d75cd8e2eca41ee7ea28388f4b1bb5e709092e9b))
+* **internal:** codegen related update ([a30d0e2](https://github.com/phoebe-bird/phoebe-ruby/commit/a30d0e2855b40a82ccfa4119dea264b9fc71799b))
+* **internal:** codegen related update ([4d0d53a](https://github.com/phoebe-bird/phoebe-ruby/commit/4d0d53aa6a136812160592d5a9106613428583bb))
+* **internal:** codegen related update ([45a93b7](https://github.com/phoebe-bird/phoebe-ruby/commit/45a93b7580f89366400fe6ec0255f9621e44af09))
+* **internal:** codegen related update ([a84cbb3](https://github.com/phoebe-bird/phoebe-ruby/commit/a84cbb34aee0524ee74c64c918af9f218bee5571))
+* **internal:** codegen related update ([a951643](https://github.com/phoebe-bird/phoebe-ruby/commit/a951643c914e2289aff7031d4e5b8e0eb6e09c78))
+* **internal:** codegen related update ([cd5e4fb](https://github.com/phoebe-bird/phoebe-ruby/commit/cd5e4fbdc79946fe48b2ad209979d92009e6fa1b))
+* **internal:** codegen related update ([ca43f16](https://github.com/phoebe-bird/phoebe-ruby/commit/ca43f16c65936ab35a33605d773d7d55c5bce8f8))
+* **internal:** codegen related update ([5146050](https://github.com/phoebe-bird/phoebe-ruby/commit/514605007368f304b8a4676a5a1a6cd6cd38b250))
+* **internal:** codegen related update ([df3cb28](https://github.com/phoebe-bird/phoebe-ruby/commit/df3cb2805cb24253e1d2039d199c7831cec60852))
+* **internal:** codegen related update ([2157d6c](https://github.com/phoebe-bird/phoebe-ruby/commit/2157d6c7fca81d9c102080d9151eb323f311e70a))
+* **internal:** codegen related update ([88d9205](https://github.com/phoebe-bird/phoebe-ruby/commit/88d9205b7db0cc5e1192d34cc7442dfb9308ad68))
+* **internal:** update `actions/checkout` version ([ac471b9](https://github.com/phoebe-bird/phoebe-ruby/commit/ac471b9e685cea1b15ec0c7f9f8134f13839baa6))
+* **internal:** version bump ([5d56366](https://github.com/phoebe-bird/phoebe-ruby/commit/5d56366f132c78114b7c626bd6688d6f9e16fef0))
+* move `cgi` into dependencies for ruby 4 ([efeb572](https://github.com/phoebe-bird/phoebe-ruby/commit/efeb572bcf6b178808a6a7c1400b759558944bc8))
+* refine Yard and Sorbet types and ensure linting is turned on for examples ([bbd825d](https://github.com/phoebe-bird/phoebe-ruby/commit/bbd825d7facd9955f9adcfe83ad7d148417c1f1f))
+* update contribute.md ([5aad15e](https://github.com/phoebe-bird/phoebe-ruby/commit/5aad15e8964e69599ae8d434dae4a0d9d7da64f6))
+* use fully qualified names for yard annotations and rbs aliases ([82f1786](https://github.com/phoebe-bird/phoebe-ruby/commit/82f1786851dcf9f3f3173207c8d2246f6e5c6874))
+* whitespaces ([e6f232f](https://github.com/phoebe-bird/phoebe-ruby/commit/e6f232f1a243ac10d7d53eaf4d4c8f8b705dbd88))
+
+
+### Documentation
+
+* prominently feature MCP server setup in root SDK readmes ([9583d55](https://github.com/phoebe-bird/phoebe-ruby/commit/9583d55d390bd9d0f9aa4e28974551b0f16edb1a))
+* rewrite much of README.md for readability ([4fbff9f](https://github.com/phoebe-bird/phoebe-ruby/commit/4fbff9f778a037d1028af37c64e498d62337ef4c))
+
 ## 0.1.0-alpha.1 (2025-11-25)
 
 Full Changelog: [v0.0.1-alpha.0...v0.1.0-alpha.1](https://github.com/phoebe-bird/phoebe-ruby/compare/v0.0.1-alpha.0...v0.1.0-alpha.1)

data/README.md

@@ -4,6 +4,15 @@ The Phoebe Ruby library provides convenient access to the Phoebe REST API from a
 
 It is generated with [Stainless](https://www.stainless.com/).
 
+## MCP Server
+
+Use the Phoebe MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
+
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=phoebe-ebird-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInBob2ViZS1lYmlyZC1tY3AiXSwiZW52Ijp7IkVCSVJEX0FQSV9LRVkiOiJNeSBBUEkgS2V5In19)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22phoebe-ebird-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22phoebe-ebird-mcp%22%5D%2C%22env%22%3A%7B%22EBIRD_API_KEY%22%3A%22My%20API%20Key%22%7D%7D)
+
+> Note: You may need to set environment variables in your MCP client.
+
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/phoebe).
@@ -17,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "phoebe", "~> 0.1.0.pre.alpha.1"
+gem "phoebe", "~> 0.1.0.pre.alpha.2"
 ```
 
 <!-- x-release-please-end -->

data/lib/phoebe/client.rb

@@ -62,6 +62,19 @@ module Phoebe
         raise ArgumentError.new("api_key is required, and can be set via environ: \"EBIRD_API_KEY\"")
       end
 
+      headers = {}
+      custom_headers_env = ENV["PHOEBE_CUSTOM_HEADERS"]
+      unless custom_headers_env.nil?
+        parsed = {}
+        custom_headers_env.split("\n").each do |line|
+          colon = line.index(":")
+          unless colon.nil?
+            parsed[line[0...colon].strip] = line[(colon + 1)..].strip
+          end
+        end
+        headers = parsed.merge(headers)
+      end
+
       @api_key = api_key.to_s
 
       super(
@@ -69,7 +82,8 @@ module Phoebe
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        headers: headers
       )
 
       @data = Phoebe::Resources::Data.new(client: self)

data/lib/phoebe/internal/transport/base_client.rb

@@ -306,6 +306,8 @@ module Phoebe
               Phoebe::Internal::Util.deep_merge(*[req[:body], opts[:extra_body]].compact)
             end
 
+          headers.delete("content-type") if body.nil?
+
           url = Phoebe::Internal::Util.join_parsed_uri(
             @base_url_components,
             {**req, path: path, query: query}

data/lib/phoebe/internal/transport/pooled_net_requester.rb

@@ -75,7 +75,7 @@ module Phoebe
 
             case body
             in nil
-              nil
+              req["content-length"] ||= 0 unless req["transfer-encoding"]
             in String
               req["content-length"] ||= body.bytesize.to_s unless req["transfer-encoding"]
               req.body_stream = Phoebe::Internal::Util::ReadIOAdapter.new(body, &blk)
@@ -153,17 +153,19 @@ module Phoebe
                   end
 
                   self.class.calibrate_socket_timeout(conn, deadline)
-                  conn.request(req) do |rsp|
-                    y << [req, rsp]
-                    break if finished
-
-                    rsp.read_body do |bytes|
-                      y << bytes.force_encoding(Encoding::BINARY)
-                      break if finished
-
-                      self.class.calibrate_socket_timeout(conn, deadline)
+                  ::Kernel.catch(:jump) do
+                    conn.request(req) do |rsp|
+                      y << [req, rsp]
+                      ::Kernel.throw(:jump) if finished
+
+                      rsp.read_body do |bytes|
+                        y << bytes.force_encoding(Encoding::BINARY)
+                        ::Kernel.throw(:jump) if finished
+
+                        self.class.calibrate_socket_timeout(conn, deadline)
+                      end
+                      eof = true
                     end
-                    eof = true
                   end
                 end
               ensure

data/lib/phoebe/internal/util.rb

@@ -157,7 +157,7 @@ module Phoebe
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Phoebe::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Phoebe::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -237,6 +237,11 @@ module Phoebe
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Phoebe
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Phoebe::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Phoebe
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -485,11 +499,42 @@ module Phoebe
       end
 
       # @type [Regexp]
-      JSON_CONTENT = %r{^application/(?:vnd(?:\.[^.]+)*\+)?json(?!l)}
+      JSON_CONTENT = %r{^application/(?:[a-zA-Z0-9.-]+\+)?json(?!l)}
       # @type [Regexp]
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection[key] = element.map(&:to_s).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]
@@ -540,16 +585,15 @@ module Phoebe
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           case val
           in Phoebe::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end
@@ -566,6 +610,7 @@ module Phoebe
         #
         # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
+          # rubocop:disable Style/CaseEquality
           # RFC 1521 Section 7.2.1 says we should have 70 char maximum for boundary length
           boundary = SecureRandom.urlsafe_base64(46)
 
@@ -575,7 +620,7 @@ module Phoebe
             in Hash
               body.each do |key, val|
                 case val
-                in Array if val.all? { primitive?(_1) }
+                in Array if val.all? { primitive?(_1) || Phoebe::Internal::Type::FileInput === _1 }
                   val.each do |v|
                     write_multipart_chunk(y, boundary: boundary, key: key, val: v, closing: closing)
                   end
@@ -591,6 +636,7 @@ module Phoebe
 
           fused_io = fused_enum(strio) { closing.each(&:call) }
           [boundary, fused_io]
+          # rubocop:enable Style/CaseEquality
         end
 
         # @api private
@@ -657,7 +703,8 @@ module Phoebe
         def decode_content(headers, stream:, suppress_error: false)
           case (content_type = headers["content-type"])
           in Phoebe::Internal::Util::JSON_CONTENT
-            json = stream.to_a.join
+            return nil if (json = stream.to_a.join).empty?
+
             begin
               JSON.parse(json, symbolize_names: true)
             rescue JSON::ParserError => e
@@ -667,7 +714,11 @@ module Phoebe
           in Phoebe::Internal::Util::JSONL_CONTENT
             lines = decode_lines(stream)
             chain_fused(lines) do |y|
-              lines.each { y << JSON.parse(_1, symbolize_names: true) }
+              lines.each do
+                next if _1.empty?
+
+                y << JSON.parse(_1, symbolize_names: true)
+              end
             end
           in %r{^text/event-stream}
             lines = decode_lines(stream)

data/lib/phoebe/models/data/observations/geo/recent/specie_list_params.rb

@@ -11,6 +11,11 @@ module Phoebe
               extend Phoebe::Internal::Type::RequestParameters::Converter
               include Phoebe::Internal::Type::RequestParameters
 
+              # @!attribute species_code
+              #
+              #   @return [String]
+              required :species_code, String
+
               # @!attribute lat
               #
               #   @return [Float]
@@ -57,7 +62,9 @@ module Phoebe
               #   @return [String, nil]
               optional :spp_locale, String
 
-              # @!method initialize(lat:, lng:, back: nil, dist: nil, hotspot: nil, include_provisional: nil, max_results: nil, spp_locale: nil, request_options: {})
+              # @!method initialize(species_code:, lat:, lng:, back: nil, dist: nil, hotspot: nil, include_provisional: nil, max_results: nil, spp_locale: nil, request_options: {})
+              #   @param species_code [String]
+              #
               #   @param lat [Float]
               #
               #   @param lng [Float]

data/lib/phoebe/models/data/observations/nearest/geo_specie_list_params.rb

@@ -10,6 +10,11 @@ module Phoebe
             extend Phoebe::Internal::Type::RequestParameters::Converter
             include Phoebe::Internal::Type::RequestParameters
 
+            # @!attribute species_code
+            #
+            #   @return [String]
+            required :species_code, String
+
             # @!attribute lat
             #
             #   @return [Float]
@@ -56,7 +61,9 @@ module Phoebe
             #   @return [String, nil]
             optional :spp_locale, String
 
-            # @!method initialize(lat:, lng:, back: nil, dist: nil, hotspot: nil, include_provisional: nil, max_results: nil, spp_locale: nil, request_options: {})
+            # @!method initialize(species_code:, lat:, lng:, back: nil, dist: nil, hotspot: nil, include_provisional: nil, max_results: nil, spp_locale: nil, request_options: {})
+            #   @param species_code [String]
+            #
             #   @param lat [Float]
             #
             #   @param lng [Float]

data/lib/phoebe/models/data/observations/recent/historic_list_params.rb

@@ -25,6 +25,11 @@ module Phoebe
             #   @return [Integer]
             required :m, Integer
 
+            # @!attribute d
+            #
+            #   @return [Integer]
+            required :d, Integer
+
             # @!attribute cat
             #   Only fetch observations from these taxonomic categories
             #
@@ -73,13 +78,15 @@ module Phoebe
             #   @return [String, nil]
             optional :spp_locale, String
 
-            # @!method initialize(region_code:, y_:, m:, cat: nil, detail: nil, hotspot: nil, include_provisional: nil, max_results: nil, r: nil, rank: nil, spp_locale: nil, request_options: {})
+            # @!method initialize(region_code:, y_:, m:, d:, cat: nil, detail: nil, hotspot: nil, include_provisional: nil, max_results: nil, r: nil, rank: nil, spp_locale: nil, request_options: {})
             #   @param region_code [String]
             #
             #   @param y_ [Integer]
             #
             #   @param m [Integer]
             #
+            #   @param d [Integer]
+            #
             #   @param cat [Symbol, Phoebe::Models::Data::Observations::Recent::HistoricListParams::Cat] Only fetch observations from these taxonomic categories
             #
             #   @param detail [Symbol, Phoebe::Models::Data::Observations::Recent::HistoricListParams::Detail] Include a subset (simple), or all (full), of the fields available.

data/lib/phoebe/models/data/observations/recent/notable_list_params.rb

@@ -10,6 +10,11 @@ module Phoebe
             extend Phoebe::Internal::Type::RequestParameters::Converter
             include Phoebe::Internal::Type::RequestParameters
 
+            # @!attribute region_code
+            #
+            #   @return [String]
+            required :region_code, String
+
             # @!attribute back
             #   The number of days back to fetch observations.
             #
@@ -46,7 +51,9 @@ module Phoebe
             #   @return [String, nil]
             optional :spp_locale, String
 
-            # @!method initialize(back: nil, detail: nil, hotspot: nil, max_results: nil, r: nil, spp_locale: nil, request_options: {})
+            # @!method initialize(region_code:, back: nil, detail: nil, hotspot: nil, max_results: nil, r: nil, spp_locale: nil, request_options: {})
+            #   @param region_code [String]
+            #
             #   @param back [Integer] The number of days back to fetch observations.
             #
             #   @param detail [Symbol, Phoebe::Models::Data::Observations::Recent::NotableListParams::Detail] Include a subset (simple), or all (full), of the fields available.

data/lib/phoebe/models/data/observations/recent/specie_retrieve_params.rb

@@ -15,6 +15,11 @@ module Phoebe
             #   @return [String]
             required :region_code, String
 
+            # @!attribute species_code
+            #
+            #   @return [String]
+            required :species_code, String
+
             # @!attribute back
             #   The number of days back to fetch observations.
             #
@@ -51,9 +56,11 @@ module Phoebe
             #   @return [String, nil]
             optional :spp_locale, String
 
-            # @!method initialize(region_code:, back: nil, hotspot: nil, include_provisional: nil, max_results: nil, r: nil, spp_locale: nil, request_options: {})
+            # @!method initialize(region_code:, species_code:, back: nil, hotspot: nil, include_provisional: nil, max_results: nil, r: nil, spp_locale: nil, request_options: {})
             #   @param region_code [String]
             #
+            #   @param species_code [String]
+            #
             #   @param back [Integer] The number of days back to fetch observations.
             #
             #   @param hotspot [Boolean] Only fetch observations from hotspots

data/lib/phoebe/models/data/observations/recent_list_params.rb

@@ -9,6 +9,11 @@ module Phoebe
           extend Phoebe::Internal::Type::RequestParameters::Converter
           include Phoebe::Internal::Type::RequestParameters
 
+          # @!attribute region_code
+          #
+          #   @return [String]
+          required :region_code, String
+
           # @!attribute back
           #   The number of days back to fetch observations.
           #
@@ -51,7 +56,9 @@ module Phoebe
           #   @return [String, nil]
           optional :spp_locale, String
 
-          # @!method initialize(back: nil, cat: nil, hotspot: nil, include_provisional: nil, max_results: nil, r: nil, spp_locale: nil, request_options: {})
+          # @!method initialize(region_code:, back: nil, cat: nil, hotspot: nil, include_provisional: nil, max_results: nil, r: nil, spp_locale: nil, request_options: {})
+          #   @param region_code [String]
+          #
           #   @param back [Integer] The number of days back to fetch observations.
           #
           #   @param cat [Symbol, Phoebe::Models::Data::Observations::RecentListParams::Cat] Only fetch observations from these taxonomic categories

data/lib/phoebe/models/product/checklist_view_params.rb

@@ -8,7 +8,13 @@ module Phoebe
         extend Phoebe::Internal::Type::RequestParameters::Converter
         include Phoebe::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute sub_id
+        #
+        #   @return [String]
+        required :sub_id, String
+
+        # @!method initialize(sub_id:, request_options: {})
+        #   @param sub_id [String]
         #   @param request_options [Phoebe::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/phoebe/models/product/list_retrieve_params.rb

@@ -8,13 +8,20 @@ module Phoebe
         extend Phoebe::Internal::Type::RequestParameters::Converter
         include Phoebe::Internal::Type::RequestParameters
 
+        # @!attribute region_code
+        #
+        #   @return [String]
+        required :region_code, String
+
         # @!attribute max_results
         #   Only fetch this number of checklists.
         #
         #   @return [Integer, nil]
         optional :max_results, Integer
 
-        # @!method initialize(max_results: nil, request_options: {})
+        # @!method initialize(region_code:, max_results: nil, request_options: {})
+        #   @param region_code [String]
+        #
         #   @param max_results [Integer] Only fetch this number of checklists.
         #
         #   @param request_options [Phoebe::RequestOptions, Hash{Symbol=>Object}]

data/lib/phoebe/models/product/lists/historical_retrieve_params.rb

@@ -24,6 +24,11 @@ module Phoebe
           #   @return [Integer]
           required :m, Integer
 
+          # @!attribute d
+          #
+          #   @return [Integer]
+          required :d, Integer
+
           # @!attribute max_results
           #   Only fetch this number of checklists.
           #
@@ -36,13 +41,15 @@ module Phoebe
           #   @return [Symbol, Phoebe::Models::Product::Lists::HistoricalRetrieveParams::SortKey, nil]
           optional :sort_key, enum: -> { Phoebe::Product::Lists::HistoricalRetrieveParams::SortKey }
 
-          # @!method initialize(region_code:, y_:, m:, max_results: nil, sort_key: nil, request_options: {})
+          # @!method initialize(region_code:, y_:, m:, d:, max_results: nil, sort_key: nil, request_options: {})
           #   @param region_code [String]
           #
           #   @param y_ [Integer]
           #
           #   @param m [Integer]
           #
+          #   @param d [Integer]
+          #
           #   @param max_results [Integer] Only fetch this number of checklists.
           #
           #   @param sort_key [Symbol, Phoebe::Models::Product::Lists::HistoricalRetrieveParams::SortKey] Order the results by the date of the checklist or by the date it was submitted.

data/lib/phoebe/models/product/species_list_list_params.rb

@@ -8,7 +8,13 @@ module Phoebe
         extend Phoebe::Internal::Type::RequestParameters::Converter
         include Phoebe::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute region_code
+        #
+        #   @return [String]
+        required :region_code, String
+
+        # @!method initialize(region_code:, request_options: {})
+        #   @param region_code [String]
         #   @param request_options [Phoebe::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/phoebe/models/product/stat_retrieve_params.rb

@@ -23,10 +23,16 @@ module Phoebe
         #   @return [Integer]
         required :m, Integer
 
-        # @!method initialize(region_code:, y_:, m:, request_options: {})
+        # @!attribute d
+        #
+        #   @return [Integer]
+        required :d, Integer
+
+        # @!method initialize(region_code:, y_:, m:, d:, request_options: {})
         #   @param region_code [String]
         #   @param y_ [Integer]
         #   @param m [Integer]
+        #   @param d [Integer]
         #   @param request_options [Phoebe::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/phoebe/models/product/top100_retrieve_params.rb

@@ -23,6 +23,11 @@ module Phoebe
         #   @return [Integer]
         required :m, Integer
 
+        # @!attribute d
+        #
+        #   @return [Integer]
+        required :d, Integer
+
         # @!attribute max_results
         #   Only fetch this number of contributors.
         #
@@ -35,13 +40,15 @@ module Phoebe
         #   @return [Symbol, Phoebe::Models::Product::Top100RetrieveParams::RankedBy, nil]
         optional :ranked_by, enum: -> { Phoebe::Product::Top100RetrieveParams::RankedBy }
 
-        # @!method initialize(region_code:, y_:, m:, max_results: nil, ranked_by: nil, request_options: {})
+        # @!method initialize(region_code:, y_:, m:, d:, max_results: nil, ranked_by: nil, request_options: {})
         #   @param region_code [String]
         #
         #   @param y_ [Integer]
         #
         #   @param m [Integer]
         #
+        #   @param d [Integer]
+        #
         #   @param max_results [Integer] Only fetch this number of contributors.
         #
         #   @param ranked_by [Symbol, Phoebe::Models::Product::Top100RetrieveParams::RankedBy] Order by number of complete checklists (cl) or by number of species seen (spp).