atlas_rb 1.13.0 → 1.13.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c55fceb9d85a211c8e28903ae67f1b8b98a9114c8ab403c63af68721bef76df4
-  data.tar.gz: 2b0684c399abf35c57bb6aac6def417f6996126b5afec576295d5d57cd5f72d2
+  metadata.gz: ee82f1db7ce18ffe409251ea5a22e0d8692d06d27feb2563ffaeeb8ebb3ac808
+  data.tar.gz: 448a08729406f6565e33fb42d317f3a52f4ccbe252381cea05717b473022aa69
 SHA512:
-  metadata.gz: 46728839d509e41136a4a87f774c8f343055b0fd219d45e04732c6ef95ba635c5f13715e52b7f6dfd700ffe149e59debce03b77bf748e2c03b94f837540d24ff
-  data.tar.gz: 3bcd0432f0eab0d5bba7d0f7e8da7d1f29b50a083631cfe357c00eaf1d6403ac526dcb9c3ca6ecd68d26b4459d64d7407aa3a2b926bf9585f433e316369cdcbc
+  metadata.gz: 709a6b7987e43637465f30345224a52792e936383f146c0a70311dce3484d3b4bd129c54bc84051c3047778871d8692bdd26e132557cffef1e87af609de14b65
+  data.tar.gz: 409ee2cfd24bae4d5b2bb89b9cdfd1eafc50c011f6f9c0842151d7c36ff09f53f19a61f9ffcab19c53e1beffe62bf179be21e106b3f813efee2af7dbca521a8d

data/.version

@@ -1 +1 @@
-1.13.0
+1.13.2

data/CHANGELOG.md

@@ -1,5 +1,34 @@
 # 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
+
+`AtlasRb::Maintenance.read` took no `nuid:`, unlike every other read binding,
+so on the relay-signing path it had no NUID to sign into the assertion `sub`
+and raised `ConfigurationError`. It worked only in BYO-JWT mode or when the
+host configured `AtlasRb.config.default_nuid`. It now takes `nuid:` and
+`on_behalf_of:` like its neighbours.
+
+```ruby
+AtlasRb::Maintenance.read(nuid: current_user.nuid)
+```
+
+`.write` is unchanged — it runs on the system connection, which deliberately
+never consults ambient identity.
+
 ## 1.13.0
 
 ### Added — maintenance mode no longer passes through silently

data/Gemfile.lock

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

data/README.md

@@ -523,7 +523,7 @@ Read the flag to render a banner before a caller trips it. The read is answered
 even while the window is open, so a client can always see the flag it honours:
 
 ```ruby
-window = AtlasRb::Maintenance.read
+window = AtlasRb::Maintenance.read(nuid: current_user.nuid)
 window["read_only"]    # => true
 window["source"]       # => "deploy" / "operator"
 window["message"]      # => "Scheduled maintenance until 10:00"

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

data/lib/atlas_rb/maintenance.rb

@@ -33,11 +33,18 @@ module AtlasRb
     # Cheap and safe to poll behind a short-TTL cache; Cerberus renders its
     # banner and its client-side write gate from this.
     #
+    # @param nuid [String, nil] the acting NUID, signed into the assertion `sub`
+    #   on the relay path. Optional only in BYO-JWT mode or when the host
+    #   configures {AtlasRb.config#default_nuid}; the read sits behind Atlas's
+    #   authenticated read floor, so it needs a principal like any other read.
+    # @param on_behalf_of [String, nil] optional NUID carried as a signed `obo`
+    #   claim.
     # @return [AtlasRb::Mash] `read_only` (Boolean), `source`
     #   (`"operator"` / `"deploy"` / nil), `since` (ISO-8601 or nil), `message`
     #   (String or nil), and `retry_after` (Integer seconds).
-    def self.read
-      AtlasRb::Mash.new(JSON.parse(connection({}).get("/maintenance").body))
+    def self.read(nuid: nil, on_behalf_of: nil)
+      response = connection({}, nuid, on_behalf_of: on_behalf_of).get("/maintenance")
+      AtlasRb::Mash.new(JSON.parse(response.body))
     end
 
     # Open or close the window (`PUT /maintenance`). System-gated in Atlas.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.13.0
+  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