atlas_rb 1.13.1 → 1.13.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 651cf253c9f27ae5b3f3a917e76d6c630d079623f971230080962d3abd966157
-  data.tar.gz: da553d3a5239463b46a80c1348c53a60dcce2c2b7cb92f2dafb76095f61c433b
+  metadata.gz: ee82f1db7ce18ffe409251ea5a22e0d8692d06d27feb2563ffaeeb8ebb3ac808
+  data.tar.gz: 448a08729406f6565e33fb42d317f3a52f4ccbe252381cea05717b473022aa69
 SHA512:
-  metadata.gz: e1f8bde0b540dd884930a4d0d78fd5441726caccadda299127f0a2548845ec690698c95e4cc114c70e11645d9197b4c11e29782bdeb0cf3539b1553d82a592b2
-  data.tar.gz: a10278be702677b1939ddc8cbc41a5dbcde9b6854f9016d0df7ab5040e07bd23edac96f6116299e335b670ee74955623eca400c5ad092f909431666363967766
+  metadata.gz: 709a6b7987e43637465f30345224a52792e936383f146c0a70311dce3484d3b4bd129c54bc84051c3047778871d8692bdd26e132557cffef1e87af609de14b65
+  data.tar.gz: 409ee2cfd24bae4d5b2bb89b9cdfd1eafc50c011f6f9c0842151d7c36ff09f53f19a61f9ffcab19c53e1beffe62bf179be21e106b3f813efee2af7dbca521a8d

data/.version

@@ -1 +1 @@
-1.13.1
+1.13.2

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.13.2
+
+### Documentation — point `children` callers at the batch resolver
+
+`Collection.children` and `Community.children` answer noids only, and nothing
+on either method said how to turn those noids into something renderable. The
+obvious reading — `find` per noid — costs a round-trip per child. Both now
+point at {AtlasRb::Resource.find_many} for one-call resolution, and at
+{AtlasRb::Resource.descendant_works} for a whole subtree.
+
+No behaviour change.
+
 ## 1.13.1
 
 ### Fixed — `Maintenance.read` could not name an acting principal

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.13.1)
+    atlas_rb (1.13.2)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)

data/lib/atlas_rb/collection.rb

@@ -190,6 +190,12 @@ module AtlasRb
     # @param on_behalf_of [String, nil] optional NUID for the `On-Behalf-Of`
     #   header. Falls through to {AtlasRb.config}.default_on_behalf_of when
     #   omitted.
+    # `children` answers noids only. To render them, resolve the whole list in
+    # one call with {AtlasRb::Resource.find_many}, which returns a
+    # title/thumbnail digest per id — calling `find` per noid costs a
+    # round-trip per child. For a whole subtree flattened to Works, use
+    # {AtlasRb::Resource.descendant_works}.
+    #
     # @return [Array<String>] child noids from `GET /collections/<id>/children`.
     #
     # @example

data/lib/atlas_rb/community.rb

@@ -169,6 +169,12 @@ module AtlasRb
     # @param on_behalf_of [String, nil] optional NUID for the `On-Behalf-Of`
     #   header. Falls through to {AtlasRb.config}.default_on_behalf_of when
     #   omitted.
+    # `children` answers noids only. To render them, resolve the whole list in
+    # one call with {AtlasRb::Resource.find_many}, which returns a
+    # title/thumbnail digest per id — calling `find` per noid costs a
+    # round-trip per child. For a whole subtree flattened to Works, use
+    # {AtlasRb::Resource.descendant_works}.
+    #
     # @return [Array<String>] child noids from `GET /communities/<id>/children`.
     #
     # @example

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.13.1
+  version: 1.13.2
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-25 00:00:00.000000000 Z
+date: 2026-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday