autorender 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc9441f36a45b932be9e8caa0a0a3f12580420ad68b27d3c64c9abb3d791498f
-  data.tar.gz: 2a937fb734038ed639845493215a96352f22b4575c981b582bda934bff1ac3a7
+  metadata.gz: defd4e8363dacdf1f19948eee28cc1af98be7d4d582fbe164f80da2c0653f2fd
+  data.tar.gz: 9eb9eca1bb6c55520f0a9d9f0e53a41f10da68a6a2dc68fdffaf87dffa7f2014
 SHA512:
-  metadata.gz: 2745ef9c4f4ff9000696e81e39570fc39b12facdedd153af59927f48bbcfbb21477eb5aa379e39af06ed39e755cbfd236b53c2789332172f126e0b3115bd4e55
-  data.tar.gz: f35add17672d57d708f65fe509e02844deed80c9b01e972c5fb575838eaa06cf045b8781ccf8767b78acedba3c2d121a0992ea76ca0df39d99e9e429754fb009
+  metadata.gz: 570081ccc7ceaa84f94ed9b4f28b4ccf7c99558f88e712934ad29f0a480b5c9e9b8ad7cd43bef16afd390d9f6dcfc148ed3c74f05e45c06b86d5ee7a3334d96c
+  data.tar.gz: ab593adc2d49f15766a5a1f5503ca8d507fbfb9211c5403b3e8d99152695ed04db921b343aeeef7dc658a57f6c53f39944d548dd436e9e65dbf12150a617ffd0

data/CHANGELOG.md

@@ -1,79 +1,86 @@
 # Changelog
 
-## [0.2.1](https://github.com/autorenderhq/autorender-ruby/compare/v0.2.0...v0.2.1) (2026-06-29)
+## [0.2.2](https://github.com/autorender/autorender-ruby/compare/v0.2.1...v0.2.2) (2026-07-12)
 
 
 ### Chores
 
-* remove Stainless attribution from README and SECURITY ([32ce08b](https://github.com/autorenderhq/autorender-ruby/commit/32ce08b5603dd5e667b5eccccddf94fae9851e84))
-* strip internal workflows; preserve production-managed files ([0a1a663](https://github.com/autorenderhq/autorender-ruby/commit/0a1a663a70d3ac323769ca574a3e86d1c3cbbed4))
+* rename autorenderhq -> autorender references (GitHub org rename) ([#11](https://github.com/autorender/autorender-ruby/issues/11)) ([36a12a6](https://github.com/autorender/autorender-ruby/commit/36a12a61bf4824ce266a5294911f74cd3075da6a))
 
-## [0.2.0](https://github.com/autorenderhq/autorender-ruby/compare/v0.1.0...v0.2.0) (2026-06-12)
+## [0.2.1](https://github.com/autorender/autorender-ruby/compare/v0.2.0...v0.2.1) (2026-06-29)
+
+
+### Chores
+
+* remove Stainless attribution from README and SECURITY ([32ce08b](https://github.com/autorender/autorender-ruby/commit/32ce08b5603dd5e667b5eccccddf94fae9851e84))
+* strip internal workflows; preserve production-managed files ([0a1a663](https://github.com/autorender/autorender-ruby/commit/0a1a663a70d3ac323769ca574a3e86d1c3cbbed4))
+
+## [0.2.0](https://github.com/autorender/autorender-ruby/compare/v0.1.0...v0.2.0) (2026-06-12)
 
 
 ### Features
 
-* **java:** enable maven publishing with release-please ([1786303](https://github.com/autorenderhq/autorender-ruby/commit/1786303cbb54cff6672d54e610b9ade78c7c5854))
-* **ruby:** enable rubygems publishing with release-please ([bc8804f](https://github.com/autorenderhq/autorender-ruby/commit/bc8804f6dcb6942d92c55b45da53010aa0f7655a))
+* **java:** enable maven publishing with release-please ([1786303](https://github.com/autorender/autorender-ruby/commit/1786303cbb54cff6672d54e610b9ade78c7c5854))
+* **ruby:** enable rubygems publishing with release-please ([bc8804f](https://github.com/autorender/autorender-ruby/commit/bc8804f6dcb6942d92c55b45da53010aa0f7655a))
 
 
 ### Bug Fixes
 
-* preserve production-managed files in release branch ([37f9bd5](https://github.com/autorenderhq/autorender-ruby/commit/37f9bd51d07018eff16ef491dc3fc4f747fc07ec))
-* strip internal workflows from production release branch ([cd8fd3f](https://github.com/autorenderhq/autorender-ruby/commit/cd8fd3f3dce0f1e02440ae92d9f5f6f5bd9fa087))
-* update promote workflow and add back-sync from production ([8604ca6](https://github.com/autorenderhq/autorender-ruby/commit/8604ca61b2b63aa688a5387fc2dd0b741996249d))
-* use blob comparison in overlay; add language-specific version files ([383f0ae](https://github.com/autorenderhq/autorender-ruby/commit/383f0ae3e39903225c4f22aecffb72b1745dba23))
-* use persist-credentials: false in sync workflow ([22a5b7c](https://github.com/autorenderhq/autorender-ruby/commit/22a5b7cd5104fa7addc8d8da5408a8aa53b6d542))
+* preserve production-managed files in release branch ([37f9bd5](https://github.com/autorender/autorender-ruby/commit/37f9bd51d07018eff16ef491dc3fc4f747fc07ec))
+* strip internal workflows from production release branch ([cd8fd3f](https://github.com/autorender/autorender-ruby/commit/cd8fd3f3dce0f1e02440ae92d9f5f6f5bd9fa087))
+* update promote workflow and add back-sync from production ([8604ca6](https://github.com/autorender/autorender-ruby/commit/8604ca61b2b63aa688a5387fc2dd0b741996249d))
+* use blob comparison in overlay; add language-specific version files ([383f0ae](https://github.com/autorender/autorender-ruby/commit/383f0ae3e39903225c4f22aecffb72b1745dba23))
+* use persist-credentials: false in sync workflow ([22a5b7c](https://github.com/autorender/autorender-ruby/commit/22a5b7cd5104fa7addc8d8da5408a8aa53b6d542))
 
 
 ### Chores
 
-* preserve production-managed files ([04101d4](https://github.com/autorenderhq/autorender-ruby/commit/04101d4aad8a09a5e00a383c35f9b7fb1bba3481))
-* remove staging-only workflows from production ([446e9ad](https://github.com/autorenderhq/autorender-ruby/commit/446e9ad2ca81b41c7d18f62bb341c2303c0906a5))
-* remove staging-only workflows from production ([79686f1](https://github.com/autorenderhq/autorender-ruby/commit/79686f15b7c6c5f130bc05e00e8fe595c4877236))
-* strip internal workflows; preserve production-managed files ([c2cb80d](https://github.com/autorenderhq/autorender-ruby/commit/c2cb80de0aab1a578c5798c3fd99efc8bf8f4b77))
+* preserve production-managed files ([04101d4](https://github.com/autorender/autorender-ruby/commit/04101d4aad8a09a5e00a383c35f9b7fb1bba3481))
+* remove staging-only workflows from production ([446e9ad](https://github.com/autorender/autorender-ruby/commit/446e9ad2ca81b41c7d18f62bb341c2303c0906a5))
+* remove staging-only workflows from production ([79686f1](https://github.com/autorender/autorender-ruby/commit/79686f15b7c6c5f130bc05e00e8fe595c4877236))
+* strip internal workflows; preserve production-managed files ([c2cb80d](https://github.com/autorender/autorender-ruby/commit/c2cb80de0aab1a578c5798c3fd99efc8bf8f4b77))
 
 
 ### Documentation
 
-* add auto-generated notice to CONTRIBUTING.md ([802ed52](https://github.com/autorenderhq/autorender-ruby/commit/802ed521f5609bfedbc004c755835a97b060eff0))
+* add auto-generated notice to CONTRIBUTING.md ([802ed52](https://github.com/autorender/autorender-ruby/commit/802ed521f5609bfedbc004c755835a97b060eff0))
 
-## [0.1.0](https://github.com/autorenderhq/autorender-ruby/compare/v0.0.1...v0.1.0) (2026-05-25)
+## [0.1.0](https://github.com/autorender/autorender-ruby/compare/v0.0.1...v0.1.0) (2026-05-25)
 
 
 ### Features
 
-* add stlc generate workflow and setup-stlc action ([33702ec](https://github.com/autorenderhq/autorender-ruby/commit/33702eca050ca28e7f94e57cfec04b73f23c9df5))
-* add test CI job ([a8fbe66](https://github.com/autorenderhq/autorender-ruby/commit/a8fbe662d965ca5f29d9e3c6c22d566f4c2a8fc1))
-* **api:** api update ([5e0fc16](https://github.com/autorenderhq/autorender-ruby/commit/5e0fc16a5851c3352fbde1e93e7dfe113c01174d))
-* **api:** api update ([6dc9820](https://github.com/autorenderhq/autorender-ruby/commit/6dc98208876904a00fe6060c77bf37444402772b))
-* **api:** api update ([dd609a7](https://github.com/autorenderhq/autorender-ruby/commit/dd609a73898016e39ade678854a3eeeaa2b48238))
-* **api:** api update ([4cc94ad](https://github.com/autorenderhq/autorender-ruby/commit/4cc94adc26ad538f01d79808130029bd744a2ee3))
-* **api:** api update ([c8a41c7](https://github.com/autorenderhq/autorender-ruby/commit/c8a41c7d7564bc736de43fa4c791608348bdb0f7))
-* **api:** api update ([0e228df](https://github.com/autorenderhq/autorender-ruby/commit/0e228df68c6f36ce4daa497df77bbb053c2244f7))
-* **api:** api update ([4367475](https://github.com/autorenderhq/autorender-ruby/commit/4367475283baab31f04e1617ea462ae8784758d1))
-* **api:** api update ([a9470bb](https://github.com/autorenderhq/autorender-ruby/commit/a9470bb8ea34fd597ba981dd1aedbceda9bd0210))
-* **api:** api update ([df3c1b1](https://github.com/autorenderhq/autorender-ruby/commit/df3c1b1561943ccc9de1b51abe60adabcd576aa8))
-* **api:** api update ([fb07d3e](https://github.com/autorenderhq/autorender-ruby/commit/fb07d3eff80815340117fca67aae513e3a91b987))
-* initial stlc build ([8972f10](https://github.com/autorenderhq/autorender-ruby/commit/8972f10cca09ae385f9757795c55e658923c949b))
-* support setting headers via env ([3707a7d](https://github.com/autorenderhq/autorender-ruby/commit/3707a7d00abf789957185ad54eeddca000b3e398))
+* add stlc generate workflow and setup-stlc action ([33702ec](https://github.com/autorender/autorender-ruby/commit/33702eca050ca28e7f94e57cfec04b73f23c9df5))
+* add test CI job ([a8fbe66](https://github.com/autorender/autorender-ruby/commit/a8fbe662d965ca5f29d9e3c6c22d566f4c2a8fc1))
+* **api:** api update ([5e0fc16](https://github.com/autorender/autorender-ruby/commit/5e0fc16a5851c3352fbde1e93e7dfe113c01174d))
+* **api:** api update ([6dc9820](https://github.com/autorender/autorender-ruby/commit/6dc98208876904a00fe6060c77bf37444402772b))
+* **api:** api update ([dd609a7](https://github.com/autorender/autorender-ruby/commit/dd609a73898016e39ade678854a3eeeaa2b48238))
+* **api:** api update ([4cc94ad](https://github.com/autorender/autorender-ruby/commit/4cc94adc26ad538f01d79808130029bd744a2ee3))
+* **api:** api update ([c8a41c7](https://github.com/autorender/autorender-ruby/commit/c8a41c7d7564bc736de43fa4c791608348bdb0f7))
+* **api:** api update ([0e228df](https://github.com/autorender/autorender-ruby/commit/0e228df68c6f36ce4daa497df77bbb053c2244f7))
+* **api:** api update ([4367475](https://github.com/autorender/autorender-ruby/commit/4367475283baab31f04e1617ea462ae8784758d1))
+* **api:** api update ([a9470bb](https://github.com/autorender/autorender-ruby/commit/a9470bb8ea34fd597ba981dd1aedbceda9bd0210))
+* **api:** api update ([df3c1b1](https://github.com/autorender/autorender-ruby/commit/df3c1b1561943ccc9de1b51abe60adabcd576aa8))
+* **api:** api update ([fb07d3e](https://github.com/autorender/autorender-ruby/commit/fb07d3eff80815340117fca67aae513e3a91b987))
+* initial stlc build ([8972f10](https://github.com/autorender/autorender-ruby/commit/8972f10cca09ae385f9757795c55e658923c949b))
+* support setting headers via env ([3707a7d](https://github.com/autorender/autorender-ruby/commit/3707a7d00abf789957185ad54eeddca000b3e398))
 
 
 ### Bug Fixes
 
-* **client:** elide content type header on requests without body ([553ad30](https://github.com/autorenderhq/autorender-ruby/commit/553ad304fe2053211d95d0cefce4ed9c922f1d92))
-* patch multipart buffer replay, bodyless DELETE content-type, and test adapter ([eb66723](https://github.com/autorenderhq/autorender-ruby/commit/eb667233b4b537e158d25f357bf91adee5304675))
-* **python:** rename pagination field has_next_page -> has_next to fix pyright lint ([d49e480](https://github.com/autorenderhq/autorender-ruby/commit/d49e480c617a82896affa131551605b80ab84004))
-* restore content-type stripping and eager multipart buffering ([a67c6fb](https://github.com/autorenderhq/autorender-ruby/commit/a67c6fb5b4e7efc52152d6a8d9b642e198ab406b))
-* restore content-type stripping and eager multipart buffering ([5ae6d69](https://github.com/autorenderhq/autorender-ruby/commit/5ae6d69493de87916ed23ddaf7753fae116a4aa8))
-* restore content-type stripping and eager multipart buffering for retries ([8fc3542](https://github.com/autorenderhq/autorender-ruby/commit/8fc3542cbd8a1a5df00057846b890dbb2f1fde24))
-* restore content-type stripping and eager multipart buffering for retries ([c1ea3dd](https://github.com/autorenderhq/autorender-ruby/commit/c1ea3dd618ab041d7753b6d7ec0b99a5f94c349f))
-* restore content-type stripping and eager multipart buffering for retries ([16b199f](https://github.com/autorenderhq/autorender-ruby/commit/16b199ff3f5541ace9bc55bee9724db1c398c153))
-* **test:** pass body as String to ReadIOAdapter so CGI can multi-read ([09e3684](https://github.com/autorenderhq/autorender-ruby/commit/09e3684b6a6e9a921f4bf2ea2927d360622b5189))
-* update FakeCGI test helper to handle buffered String body ([b0bd179](https://github.com/autorenderhq/autorender-ruby/commit/b0bd179fb8ac25c6953fc75db832fe2ab734dd16))
+* **client:** elide content type header on requests without body ([553ad30](https://github.com/autorender/autorender-ruby/commit/553ad304fe2053211d95d0cefce4ed9c922f1d92))
+* patch multipart buffer replay, bodyless DELETE content-type, and test adapter ([eb66723](https://github.com/autorender/autorender-ruby/commit/eb667233b4b537e158d25f357bf91adee5304675))
+* **python:** rename pagination field has_next_page -> has_next to fix pyright lint ([d49e480](https://github.com/autorender/autorender-ruby/commit/d49e480c617a82896affa131551605b80ab84004))
+* restore content-type stripping and eager multipart buffering ([a67c6fb](https://github.com/autorender/autorender-ruby/commit/a67c6fb5b4e7efc52152d6a8d9b642e198ab406b))
+* restore content-type stripping and eager multipart buffering ([5ae6d69](https://github.com/autorender/autorender-ruby/commit/5ae6d69493de87916ed23ddaf7753fae116a4aa8))
+* restore content-type stripping and eager multipart buffering for retries ([8fc3542](https://github.com/autorender/autorender-ruby/commit/8fc3542cbd8a1a5df00057846b890dbb2f1fde24))
+* restore content-type stripping and eager multipart buffering for retries ([c1ea3dd](https://github.com/autorender/autorender-ruby/commit/c1ea3dd618ab041d7753b6d7ec0b99a5f94c349f))
+* restore content-type stripping and eager multipart buffering for retries ([16b199f](https://github.com/autorender/autorender-ruby/commit/16b199ff3f5541ace9bc55bee9724db1c398c153))
+* **test:** pass body as String to ReadIOAdapter so CGI can multi-read ([09e3684](https://github.com/autorender/autorender-ruby/commit/09e3684b6a6e9a921f4bf2ea2927d360622b5189))
+* update FakeCGI test helper to handle buffered String body ([b0bd179](https://github.com/autorender/autorender-ruby/commit/b0bd179fb8ac25c6953fc75db832fe2ab734dd16))
 
 
 ### Chores
 
-* **internal:** more robust bootstrap script ([127a1d1](https://github.com/autorenderhq/autorender-ruby/commit/127a1d1ae9215aff1f662e563de5dc48d269115e))
-* **tests:** bump steady to v0.22.1 ([9ddf2e0](https://github.com/autorenderhq/autorender-ruby/commit/9ddf2e0d1b60a4dd82f50d6c6c74e6e901c01e11))
+* **internal:** more robust bootstrap script ([127a1d1](https://github.com/autorender/autorender-ruby/commit/127a1d1ae9215aff1f662e563de5dc48d269115e))
+* **tests:** bump steady to v0.22.1 ([9ddf2e0](https://github.com/autorender/autorender-ruby/commit/9ddf2e0d1b60a4dd82f50d6c6c74e6e901c01e11))

data/README.md

@@ -1,12 +1,12 @@
 # Autorender Ruby API library
 
-The Autorender Ruby library provides convenient access to the Autorender REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/autorenderhq/autorender-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
+The Autorender Ruby library provides convenient access to the Autorender REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/autorender/autorender-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
 
 ## Documentation
 
 Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/autorender).
 
-The REST API documentation can be found on [autorender.mintlify.app](https://autorender.mintlify.app/).
+The REST API documentation can be found on [autorender.io](https://autorender.io/docs).
 
 ## Installation
 
@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "autorender", "~> 0.2.1"
+gem "autorender", "~> 0.2.2"
 ```
 
 <!-- x-release-please-end -->
@@ -30,9 +30,37 @@ autorender = Autorender::Client.new(
   api_key: ENV["AUTORENDER_API_KEY"] # This is the default and can be omitted
 )
 
-files = autorender.files.list(limit: 10)
+page = autorender.files.list(limit: 10)
 
-puts(files.files)
+puts(page.id)
+```
+
+### Pagination
+
+List methods in the Autorender API are paginated.
+
+This library provides auto-paginating iterators with each list response, so you do not have to request successive pages manually:
+
+```ruby
+page = autorender.files.list
+
+# Fetch single item from page.
+file = page.files[0]
+puts(file.id)
+
+# Automatically fetches more pages as needed.
+page.auto_paging_each do |file|
+  puts(file.id)
+end
+```
+
+Alternatively, you can use the `#next_page?` and `#next_page` methods for more granular control working with pages.
+
+```ruby
+if page.next_page?
+  new_page = page.next_page
+  puts(new_page.files[0].id)
+end
 ```
 
 ### File uploads
@@ -261,4 +289,4 @@ Ruby 3.2.0 or higher.
 
 ## Contributing
 
-See [the contributing documentation](https://github.com/autorenderhq/autorender-ruby/tree/main/CONTRIBUTING.md).
+See [the contributing documentation](https://github.com/autorender/autorender-ruby/tree/main/CONTRIBUTING.md).

data/lib/autorender/internal/page_pagination.rb

@@ -10,27 +10,21 @@ module Autorender
     #   end
     #
     # @example
-    #   page_pagination.auto_paging_each do |item|
-    #     puts(item)
+    #   page_pagination.auto_paging_each do |file|
+    #     puts(file)
     #   end
     class PagePagination
       include Autorender::Internal::Type::BasePage
 
       # @return [Array<generic<Elem>>, nil]
-      attr_accessor :data
+      attr_accessor :files
 
-      # @return [Integer]
-      attr_accessor :current_page
-
-      # @return [Boolean]
-      attr_accessor :has_next
-
-      # @return [Integer]
-      attr_accessor :total_results
+      # @return [Meta]
+      attr_accessor :meta
 
       # @return [Boolean]
       def next_page?
-        !data.to_a.empty?
+        meta&.has_next
       end
 
       # @raise [Autorender::HTTP::Error]
@@ -41,7 +35,7 @@ module Autorender
           raise RuntimeError.new(message)
         end
 
-        req = Autorender::Internal::Util.deep_merge(@req, {query: {page: (current_page || 1).to_i.succ}})
+        req = Autorender::Internal::Util.deep_merge(@req, {query: {page: (meta&.page || 1).to_i.succ}})
         @client.request(req)
       end
 
@@ -55,7 +49,7 @@ module Autorender
 
         page = self
         loop do
-          page.data&.each(&blk)
+          page.files&.each(&blk)
 
           break unless page.next_page?
           page = page.next_page
@@ -72,24 +66,43 @@ module Autorender
         super
 
         case page_data
-        in {data: Array => data}
-          @data = data.map { Autorender::Internal::Type::Converter.coerce(@model, _1) }
+        in {files: Array => files}
+          @files = files.map { Autorender::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        case page_data
+        in {meta: Hash | nil => meta}
+          @meta = Autorender::Internal::Type::Converter.coerce(
+            Autorender::Internal::PagePagination::Meta,
+            meta
+          )
         else
         end
-        @current_page = page_data[:current_page]
-        @has_next = page_data[:has_next]
-        @total_results = page_data[:total_results]
       end
 
       # @api private
       #
       # @return [String]
       def inspect
-        # rubocop:disable Layout/LineLength
         model = Autorender::Internal::Type::Converter.inspect(@model, depth: 1)
 
-        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)} current_page=#{current_page.inspect} has_next=#{has_next.inspect} total_results=#{total_results.inspect}>"
-        # rubocop:enable Layout/LineLength
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)}>"
+      end
+
+      class Meta < Autorender::Internal::Type::BaseModel
+        # @!attribute has_next
+        #
+        #   @return [Boolean, nil]
+        optional :has_next, Autorender::Internal::Type::Boolean, api_name: :hasNext
+
+        # @!attribute page
+        #
+        #   @return [Integer, nil]
+        optional :page, Integer
+
+        # @!method initialize(has_next: nil, page: nil)
+        #   @param has_next [Boolean]
+        #   @param page [Integer]
       end
     end
   end

data/lib/autorender/models/file_list_response.rb

@@ -4,164 +4,109 @@ module Autorender
   module Models
     # @see Autorender::Resources::Files#list
     class FileListResponse < Autorender::Internal::Type::BaseModel
-      # @!attribute files
-      #
-      #   @return [Array<Autorender::Models::FileListResponse::File>]
-      required :files, -> { Autorender::Internal::Type::ArrayOf[Autorender::Models::FileListResponse::File] }
-
-      # @!attribute meta
-      #
-      #   @return [Autorender::Models::FileListResponse::Meta]
-      required :meta, -> { Autorender::Models::FileListResponse::Meta }
-
-      # @!method initialize(files:, meta:)
-      #   Files list
-      #
-      #   @param files [Array<Autorender::Models::FileListResponse::File>]
-      #   @param meta [Autorender::Models::FileListResponse::Meta]
-
-      class File < Autorender::Internal::Type::BaseModel
-        # @!attribute id
-        #
-        #   @return [String]
-        required :id, String
-
-        # @!attribute created_at
-        #
-        #   @return [Time]
-        required :created_at, Time
-
-        # @!attribute file_no
-        #
-        #   @return [String]
-        required :file_no, String
-
-        # @!attribute folder_name
-        #
-        #   @return [String, nil]
-        required :folder_name, String, nil?: true
-
-        # @!attribute folder_no
-        #
-        #   @return [String, nil]
-        required :folder_no, String, nil?: true
-
-        # @!attribute format_
-        #
-        #   @return [String, nil]
-        required :format_, String, api_name: :format, nil?: true
-
-        # @!attribute height
-        #
-        #   @return [Integer, nil]
-        required :height, Integer, nil?: true
-
-        # @!attribute metadata
-        #
-        #   @return [Hash{Symbol=>Object}, nil]
-        required :metadata,
-                 Autorender::Internal::Type::HashOf[Autorender::Internal::Type::Unknown],
-                 nil?: true
-
-        # @!attribute mime_type
-        #
-        #   @return [String]
-        required :mime_type, String
-
-        # @!attribute name
-        #
-        #   @return [String]
-        required :name, String
-
-        # @!attribute path
-        #
-        #   @return [String]
-        required :path, String
-
-        # @!attribute size
-        #
-        #   @return [Integer]
-        required :size, Integer
-
-        # @!attribute source
-        #
-        #   @return [String]
-        required :source, String
-
-        # @!attribute tags
-        #
-        #   @return [Array<String>]
-        required :tags, Autorender::Internal::Type::ArrayOf[String]
-
-        # @!attribute updated_at
-        #
-        #   @return [Time, nil]
-        required :updated_at, Time, nil?: true
-
-        # @!attribute url
-        #
-        #   @return [String]
-        required :url, String
-
-        # @!attribute width
-        #
-        #   @return [Integer, nil]
-        required :width, Integer, nil?: true
-
-        # @!method initialize(id:, created_at:, file_no:, folder_name:, folder_no:, format_:, height:, metadata:, mime_type:, name:, path:, size:, source:, tags:, updated_at:, url:, width:)
-        #   @param id [String]
-        #   @param created_at [Time]
-        #   @param file_no [String]
-        #   @param folder_name [String, nil]
-        #   @param folder_no [String, nil]
-        #   @param format_ [String, nil]
-        #   @param height [Integer, nil]
-        #   @param metadata [Hash{Symbol=>Object}, nil]
-        #   @param mime_type [String]
-        #   @param name [String]
-        #   @param path [String]
-        #   @param size [Integer]
-        #   @param source [String]
-        #   @param tags [Array<String>]
-        #   @param updated_at [Time, nil]
-        #   @param url [String]
-        #   @param width [Integer, nil]
-      end
-
-      # @see Autorender::Models::FileListResponse#meta
-      class Meta < Autorender::Internal::Type::BaseModel
-        # @!attribute has_next
-        #
-        #   @return [Boolean]
-        required :has_next, Autorender::Internal::Type::Boolean, api_name: :hasNext
-
-        # @!attribute has_prev
-        #
-        #   @return [Boolean]
-        required :has_prev, Autorender::Internal::Type::Boolean, api_name: :hasPrev
-
-        # @!attribute limit
-        #
-        #   @return [Integer]
-        required :limit, Integer
-
-        # @!attribute page
-        #
-        #   @return [Integer]
-        required :page, Integer
-
-        # @!attribute total
-        #
-        #   @return [Integer]
-        required :total, Integer
-
-        # @!method initialize(has_next:, has_prev:, limit:, page:, total:)
-        #   @param has_next [Boolean]
-        #   @param has_prev [Boolean]
-        #   @param limit [Integer]
-        #   @param page [Integer]
-        #   @param total [Integer]
-      end
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute file_no
+      #
+      #   @return [String]
+      required :file_no, String
+
+      # @!attribute folder_name
+      #
+      #   @return [String, nil]
+      required :folder_name, String, nil?: true
+
+      # @!attribute folder_no
+      #
+      #   @return [String, nil]
+      required :folder_no, String, nil?: true
+
+      # @!attribute format_
+      #
+      #   @return [String, nil]
+      required :format_, String, api_name: :format, nil?: true
+
+      # @!attribute height
+      #
+      #   @return [Integer, nil]
+      required :height, Integer, nil?: true
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      required :metadata, Autorender::Internal::Type::HashOf[Autorender::Internal::Type::Unknown], nil?: true
+
+      # @!attribute mime_type
+      #
+      #   @return [String]
+      required :mime_type, String
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute path
+      #
+      #   @return [String]
+      required :path, String
+
+      # @!attribute size
+      #
+      #   @return [Integer]
+      required :size, Integer
+
+      # @!attribute source
+      #
+      #   @return [String]
+      required :source, String
+
+      # @!attribute tags
+      #
+      #   @return [Array<String>]
+      required :tags, Autorender::Internal::Type::ArrayOf[String]
+
+      # @!attribute updated_at
+      #
+      #   @return [Time, nil]
+      required :updated_at, Time, nil?: true
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute width
+      #
+      #   @return [Integer, nil]
+      required :width, Integer, nil?: true
+
+      # @!method initialize(id:, created_at:, file_no:, folder_name:, folder_no:, format_:, height:, metadata:, mime_type:, name:, path:, size:, source:, tags:, updated_at:, url:, width:)
+      #   @param id [String]
+      #   @param created_at [Time]
+      #   @param file_no [String]
+      #   @param folder_name [String, nil]
+      #   @param folder_no [String, nil]
+      #   @param format_ [String, nil]
+      #   @param height [Integer, nil]
+      #   @param metadata [Hash{Symbol=>Object}, nil]
+      #   @param mime_type [String]
+      #   @param name [String]
+      #   @param path [String]
+      #   @param size [Integer]
+      #   @param source [String]
+      #   @param tags [Array<String>]
+      #   @param updated_at [Time, nil]
+      #   @param url [String]
+      #   @param width [Integer, nil]
     end
   end
 end

data/lib/autorender/resources/files.rb

@@ -39,7 +39,7 @@ module Autorender
       #
       # @param request_options [Autorender::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Autorender::Models::FileListResponse]
+      # @return [Autorender::Internal::PagePagination<Autorender::Models::FileListResponse>]
       #
       # @see Autorender::Models::FileListParams
       def list(params = {})
@@ -49,6 +49,7 @@ module Autorender
           method: :get,
           path: "api/v1/files",
           query: query,
+          page: Autorender::Internal::PagePagination,
           model: Autorender::Models::FileListResponse,
           options: options
         )

data/lib/autorender/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Autorender
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

data/rbi/autorender/internal/page_pagination.rbi

@@ -8,21 +8,41 @@ module Autorender
       Elem = type_member
 
       sig { returns(T.nilable(T::Array[Elem])) }
-      attr_accessor :data
+      attr_accessor :files
 
-      sig { returns(Integer) }
-      attr_accessor :current_page
-
-      sig { returns(T::Boolean) }
-      attr_accessor :has_next
-
-      sig { returns(Integer) }
-      attr_accessor :total_results
+      sig { returns(Meta) }
+      attr_accessor :meta
 
       # @api private
       sig { returns(String) }
       def inspect
       end
+
+      class Meta < Autorender::Internal::Type::BaseModel
+        OrHash = T.type_alias { T.any(Meta, Autorender::Internal::AnyHash) }
+
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :has_next
+
+        sig { params(has_next: T::Boolean).void }
+        attr_writer :has_next
+
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :page
+
+        sig { params(page: Integer).void }
+        attr_writer :page
+
+        sig do
+          params(has_next: T::Boolean, page: Integer).returns(T.attached_class)
+        end
+        def self.new(has_next: nil, page: nil)
+        end
+
+        sig { override.returns({ has_next: T::Boolean, page: Integer }) }
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/autorender/models/file_list_response.rbi

@@ -11,100 +11,102 @@ module Autorender
           )
         end
 
-      sig { returns(T::Array[Autorender::Models::FileListResponse::File]) }
-      attr_accessor :files
+      sig { returns(String) }
+      attr_accessor :id
 
-      sig { returns(Autorender::Models::FileListResponse::Meta) }
-      attr_reader :meta
+      sig { returns(Time) }
+      attr_accessor :created_at
 
-      sig do
-        params(meta: Autorender::Models::FileListResponse::Meta::OrHash).void
-      end
-      attr_writer :meta
-
-      # Files list
-      sig do
-        params(
-          files: T::Array[Autorender::Models::FileListResponse::File::OrHash],
-          meta: Autorender::Models::FileListResponse::Meta::OrHash
-        ).returns(T.attached_class)
-      end
-      def self.new(files:, meta:)
-      end
-
-      sig do
-        override.returns(
-          {
-            files: T::Array[Autorender::Models::FileListResponse::File],
-            meta: Autorender::Models::FileListResponse::Meta
-          }
-        )
-      end
-      def to_hash
-      end
+      sig { returns(String) }
+      attr_accessor :file_no
 
-      class File < Autorender::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              Autorender::Models::FileListResponse::File,
-              Autorender::Internal::AnyHash
-            )
-          end
+      sig { returns(T.nilable(String)) }
+      attr_accessor :folder_name
 
-        sig { returns(String) }
-        attr_accessor :id
+      sig { returns(T.nilable(String)) }
+      attr_accessor :folder_no
 
-        sig { returns(Time) }
-        attr_accessor :created_at
+      sig { returns(T.nilable(String)) }
+      attr_accessor :format_
 
-        sig { returns(String) }
-        attr_accessor :file_no
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :height
 
-        sig { returns(T.nilable(String)) }
-        attr_accessor :folder_name
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_accessor :metadata
 
-        sig { returns(T.nilable(String)) }
-        attr_accessor :folder_no
+      sig { returns(String) }
+      attr_accessor :mime_type
 
-        sig { returns(T.nilable(String)) }
-        attr_accessor :format_
+      sig { returns(String) }
+      attr_accessor :name
 
-        sig { returns(T.nilable(Integer)) }
-        attr_accessor :height
+      sig { returns(String) }
+      attr_accessor :path
 
-        sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
-        attr_accessor :metadata
+      sig { returns(Integer) }
+      attr_accessor :size
 
-        sig { returns(String) }
-        attr_accessor :mime_type
+      sig { returns(String) }
+      attr_accessor :source
 
-        sig { returns(String) }
-        attr_accessor :name
+      sig { returns(T::Array[String]) }
+      attr_accessor :tags
 
-        sig { returns(String) }
-        attr_accessor :path
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :updated_at
 
-        sig { returns(Integer) }
-        attr_accessor :size
+      sig { returns(String) }
+      attr_accessor :url
 
-        sig { returns(String) }
-        attr_accessor :source
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :width
 
-        sig { returns(T::Array[String]) }
-        attr_accessor :tags
-
-        sig { returns(T.nilable(Time)) }
-        attr_accessor :updated_at
-
-        sig { returns(String) }
-        attr_accessor :url
-
-        sig { returns(T.nilable(Integer)) }
-        attr_accessor :width
+      sig do
+        params(
+          id: String,
+          created_at: Time,
+          file_no: String,
+          folder_name: T.nilable(String),
+          folder_no: T.nilable(String),
+          format_: T.nilable(String),
+          height: T.nilable(Integer),
+          metadata: T.nilable(T::Hash[Symbol, T.anything]),
+          mime_type: String,
+          name: String,
+          path: String,
+          size: Integer,
+          source: String,
+          tags: T::Array[String],
+          updated_at: T.nilable(Time),
+          url: String,
+          width: T.nilable(Integer)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        id:,
+        created_at:,
+        file_no:,
+        folder_name:,
+        folder_no:,
+        format_:,
+        height:,
+        metadata:,
+        mime_type:,
+        name:,
+        path:,
+        size:,
+        source:,
+        tags:,
+        updated_at:,
+        url:,
+        width:
+      )
+      end
 
-        sig do
-          params(
+      sig do
+        override.returns(
+          {
             id: String,
             created_at: Time,
             file_no: String,
@@ -122,105 +124,10 @@ module Autorender
             updated_at: T.nilable(Time),
             url: String,
             width: T.nilable(Integer)
-          ).returns(T.attached_class)
-        end
-        def self.new(
-          id:,
-          created_at:,
-          file_no:,
-          folder_name:,
-          folder_no:,
-          format_:,
-          height:,
-          metadata:,
-          mime_type:,
-          name:,
-          path:,
-          size:,
-          source:,
-          tags:,
-          updated_at:,
-          url:,
-          width:
+          }
         )
-        end
-
-        sig do
-          override.returns(
-            {
-              id: String,
-              created_at: Time,
-              file_no: String,
-              folder_name: T.nilable(String),
-              folder_no: T.nilable(String),
-              format_: T.nilable(String),
-              height: T.nilable(Integer),
-              metadata: T.nilable(T::Hash[Symbol, T.anything]),
-              mime_type: String,
-              name: String,
-              path: String,
-              size: Integer,
-              source: String,
-              tags: T::Array[String],
-              updated_at: T.nilable(Time),
-              url: String,
-              width: T.nilable(Integer)
-            }
-          )
-        end
-        def to_hash
-        end
       end
-
-      class Meta < Autorender::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              Autorender::Models::FileListResponse::Meta,
-              Autorender::Internal::AnyHash
-            )
-          end
-
-        sig { returns(T::Boolean) }
-        attr_accessor :has_next
-
-        sig { returns(T::Boolean) }
-        attr_accessor :has_prev
-
-        sig { returns(Integer) }
-        attr_accessor :limit
-
-        sig { returns(Integer) }
-        attr_accessor :page
-
-        sig { returns(Integer) }
-        attr_accessor :total
-
-        sig do
-          params(
-            has_next: T::Boolean,
-            has_prev: T::Boolean,
-            limit: Integer,
-            page: Integer,
-            total: Integer
-          ).returns(T.attached_class)
-        end
-        def self.new(has_next:, has_prev:, limit:, page:, total:)
-        end
-
-        sig do
-          override.returns(
-            {
-              has_next: T::Boolean,
-              has_prev: T::Boolean,
-              limit: Integer,
-              page: Integer,
-              total: Integer
-            }
-          )
-        end
-        def to_hash
-        end
+      def to_hash
       end
     end
   end

data/rbi/autorender/resources/files.rbi

@@ -23,7 +23,11 @@ module Autorender
           search: String,
           sort: Autorender::FileListParams::Sort::OrSymbol,
           request_options: Autorender::RequestOptions::OrHash
-        ).returns(Autorender::Models::FileListResponse)
+        ).returns(
+          Autorender::Internal::PagePagination[
+            Autorender::Models::FileListResponse
+          ]
+        )
       end
       def list(
         # Filter by folder number

data/sig/autorender/internal/page_pagination.rbs

@@ -3,15 +3,26 @@ module Autorender
     class PagePagination[Elem]
       include Autorender::Internal::Type::BasePage[Elem]
 
-      attr_accessor data: ::Array[Elem]?
+      attr_accessor files: ::Array[Elem]?
 
-      attr_accessor current_page: Integer
+      attr_accessor meta: Meta
 
-      attr_accessor has_next: bool
+      def inspect: -> String
 
-      attr_accessor total_results: Integer
+      type meta = { has_next: bool, page: Integer }
+      class Meta < Autorender::Internal::Type::BaseModel
+        attr_reader has_next: bool?
 
-      def inspect: -> String
+        def has_next=: (bool) -> bool
+
+        attr_reader page: Integer?
+
+        def page=: (Integer) -> Integer
+
+        def initialize: (?has_next: bool, ?page: Integer) -> void
+
+        def to_hash: -> { has_next: bool, page: Integer }
+      end
     end
   end
 end

data/sig/autorender/models/file_list_response.rbs

@@ -2,158 +2,99 @@ module Autorender
   module Models
     type file_list_response =
       {
-        files: ::Array[Autorender::Models::FileListResponse::File],
-        meta: Autorender::Models::FileListResponse::Meta
+        id: String,
+        created_at: Time,
+        file_no: String,
+        folder_name: String?,
+        folder_no: String?,
+        format_: String?,
+        height: Integer?,
+        metadata: ::Hash[Symbol, top]?,
+        mime_type: String,
+        name: String,
+        path: String,
+        size: Integer,
+        source: String,
+        tags: ::Array[String],
+        updated_at: Time?,
+        url: String,
+        width: Integer?
       }
 
     class FileListResponse < Autorender::Internal::Type::BaseModel
-      attr_accessor files: ::Array[Autorender::Models::FileListResponse::File]
+      attr_accessor id: String
 
-      attr_accessor meta: Autorender::Models::FileListResponse::Meta
+      attr_accessor created_at: Time
+
+      attr_accessor file_no: String
+
+      attr_accessor folder_name: String?
+
+      attr_accessor folder_no: String?
+
+      attr_accessor format_: String?
+
+      attr_accessor height: Integer?
+
+      attr_accessor metadata: ::Hash[Symbol, top]?
+
+      attr_accessor mime_type: String
+
+      attr_accessor name: String
+
+      attr_accessor path: String
+
+      attr_accessor size: Integer
+
+      attr_accessor source: String
+
+      attr_accessor tags: ::Array[String]
+
+      attr_accessor updated_at: Time?
+
+      attr_accessor url: String
+
+      attr_accessor width: Integer?
 
       def initialize: (
-        files: ::Array[Autorender::Models::FileListResponse::File],
-        meta: Autorender::Models::FileListResponse::Meta
+        id: String,
+        created_at: Time,
+        file_no: String,
+        folder_name: String?,
+        folder_no: String?,
+        format_: String?,
+        height: Integer?,
+        metadata: ::Hash[Symbol, top]?,
+        mime_type: String,
+        name: String,
+        path: String,
+        size: Integer,
+        source: String,
+        tags: ::Array[String],
+        updated_at: Time?,
+        url: String,
+        width: Integer?
       ) -> void
 
       def to_hash: -> {
-        files: ::Array[Autorender::Models::FileListResponse::File],
-        meta: Autorender::Models::FileListResponse::Meta
+        id: String,
+        created_at: Time,
+        file_no: String,
+        folder_name: String?,
+        folder_no: String?,
+        format_: String?,
+        height: Integer?,
+        metadata: ::Hash[Symbol, top]?,
+        mime_type: String,
+        name: String,
+        path: String,
+        size: Integer,
+        source: String,
+        tags: ::Array[String],
+        updated_at: Time?,
+        url: String,
+        width: Integer?
       }
-
-      type file =
-        {
-          id: String,
-          created_at: Time,
-          file_no: String,
-          folder_name: String?,
-          folder_no: String?,
-          format_: String?,
-          height: Integer?,
-          metadata: ::Hash[Symbol, top]?,
-          mime_type: String,
-          name: String,
-          path: String,
-          size: Integer,
-          source: String,
-          tags: ::Array[String],
-          updated_at: Time?,
-          url: String,
-          width: Integer?
-        }
-
-      class File < Autorender::Internal::Type::BaseModel
-        attr_accessor id: String
-
-        attr_accessor created_at: Time
-
-        attr_accessor file_no: String
-
-        attr_accessor folder_name: String?
-
-        attr_accessor folder_no: String?
-
-        attr_accessor format_: String?
-
-        attr_accessor height: Integer?
-
-        attr_accessor metadata: ::Hash[Symbol, top]?
-
-        attr_accessor mime_type: String
-
-        attr_accessor name: String
-
-        attr_accessor path: String
-
-        attr_accessor size: Integer
-
-        attr_accessor source: String
-
-        attr_accessor tags: ::Array[String]
-
-        attr_accessor updated_at: Time?
-
-        attr_accessor url: String
-
-        attr_accessor width: Integer?
-
-        def initialize: (
-          id: String,
-          created_at: Time,
-          file_no: String,
-          folder_name: String?,
-          folder_no: String?,
-          format_: String?,
-          height: Integer?,
-          metadata: ::Hash[Symbol, top]?,
-          mime_type: String,
-          name: String,
-          path: String,
-          size: Integer,
-          source: String,
-          tags: ::Array[String],
-          updated_at: Time?,
-          url: String,
-          width: Integer?
-        ) -> void
-
-        def to_hash: -> {
-          id: String,
-          created_at: Time,
-          file_no: String,
-          folder_name: String?,
-          folder_no: String?,
-          format_: String?,
-          height: Integer?,
-          metadata: ::Hash[Symbol, top]?,
-          mime_type: String,
-          name: String,
-          path: String,
-          size: Integer,
-          source: String,
-          tags: ::Array[String],
-          updated_at: Time?,
-          url: String,
-          width: Integer?
-        }
-      end
-
-      type meta =
-        {
-          has_next: bool,
-          has_prev: bool,
-          limit: Integer,
-          page: Integer,
-          total: Integer
-        }
-
-      class Meta < Autorender::Internal::Type::BaseModel
-        attr_accessor has_next: bool
-
-        attr_accessor has_prev: bool
-
-        attr_accessor limit: Integer
-
-        attr_accessor page: Integer
-
-        attr_accessor total: Integer
-
-        def initialize: (
-          has_next: bool,
-          has_prev: bool,
-          limit: Integer,
-          page: Integer,
-          total: Integer
-        ) -> void
-
-        def to_hash: -> {
-          has_next: bool,
-          has_prev: bool,
-          limit: Integer,
-          page: Integer,
-          total: Integer
-        }
-      end
     end
   end
 end

data/sig/autorender/resources/files.rbs

@@ -13,7 +13,7 @@ module Autorender
         ?search: String,
         ?sort: Autorender::Models::FileListParams::sort,
         ?request_options: Autorender::request_opts
-      ) -> Autorender::Models::FileListResponse
+      ) -> Autorender::Internal::PagePagination[Autorender::Models::FileListResponse]
 
       def delete: (
         String file_no,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: autorender
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Autorender
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-29 00:00:00.000000000 Z
+date: 2026-08-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -199,7 +199,7 @@ homepage: https://gemdocs.org/gems/autorender
 licenses: []
 metadata:
   homepage_uri: https://gemdocs.org/gems/autorender
-  source_code_uri: https://github.com/autorenderhq/autorender-ruby
+  source_code_uri: https://github.com/autorender/autorender-ruby
   rubygems_mfa_required: 'false'
 post_install_message:
 rdoc_options: []