atlas_rb 1.6.5 → 1.6.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19c01cf68a6a94d94dceff16d5e8ea00e147b8db2c6fd51f8d6c1e9b8ec36fac
-  data.tar.gz: 457092385fc63ed58a2c2e871983bfb2a62d2d69448a74c78796d6a6f14506be
+  metadata.gz: 73faf0ef6535c48fc4e56f6aead845d9110cd9cc41966a8fc336d397840040b0
+  data.tar.gz: 36ad840afae41129b06fafd5b4957502d9264800dc27b3998e36dfaa6d3c1a4a
 SHA512:
-  metadata.gz: 2008dd0082b8de90ca4016a8a66c378bc88a6a6cc61b44070d9fcf9c9fd13ed5d21f81787dbd1b0131194b8edbd10eaf4904366c5e496452fd689fe2eedab429
-  data.tar.gz: 801b406750972c2dc014c4e202fcb53a2d204e554197c5594015f4dd0c0b60d58839ad6aab8b7c8659399082618483be9bc918543355f06d6a7ad3d125ed7107
+  metadata.gz: 830fc91838b5aaa0a6faa92f040657caa59aa5da3b304c251faf5966cea78807b045af0299220378a0a5c8214c88e8aad335c0aa98f9ff0ec8148204d36bb6a9
+  data.tar.gz: be1b28b4473fe3761c9d99f00e7138b9bb7ef7445bf62b58d990d94b9b34627434e5a72b4d9cfe9bb4666f0a5c1ec0a95a4a9f6d795aea97078b7b2bf8aa3ede

data/.version

@@ -1 +1 @@
-1.6.5
+1.6.6

data/Gemfile.lock

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

data/lib/atlas_rb/person.rb

@@ -5,7 +5,14 @@ module AtlasRb
   # directory. A Person correlates the several `users` rows that share a NUID
   # and carries the authoritative, librarian-editable `display_name` (the SSO
   # `users.name` is frequently wrong and is clobbered on every login), plus
-  # community affiliations.
+  # community affiliations and a stable **personal-root Collection**.
+  #
+  # The returned Mash carries `personal_root_id` — the **NOID** of that personal
+  # root, the structural parent the weighted-deposit publish conduit writes the
+  # person's own Works under (then linked into a community showcase via
+  # {Work.add_linked_member}). Atlas mints it eagerly at create, so it is always
+  # present on a Person; read it straight off the resolve/find Mash, e.g.
+  # `AtlasRb::Work.create(person["personal_root_id"], depositor: person["nuid"])`.
   #
   # Addressed by **NOID** (like Work/Collection) — the staff-facing NUID is kept
   # server-side and never put in a public URL. So the positional `id` argument
@@ -27,7 +34,8 @@ module AtlasRb
     # @param nuid [String, nil] acting principal (signed into the assertion sub).
     # @param on_behalf_of [String, nil] acting-as target.
     # @return [AtlasRb::Mash] the unwrapped `"person"` object (carries the
-    #   server-side `nuid` for callers that need it, e.g. depositor gating).
+    #   server-side `nuid` for callers that need it, e.g. depositor gating, and
+    #   `personal_root_id` for the publish-conduit parent).
     def self.find(id, nuid: nil, on_behalf_of: nil)
       AtlasRb::Mash.new(JSON.parse(
         connection({}, nuid, on_behalf_of: on_behalf_of).get(ROUTE + id)&.body
@@ -35,8 +43,9 @@ module AtlasRb
     end
 
     # List people — the NOID-keyed People-index source. Returns the page's
-    # Persons (each with `noid`, `display_name`, and the server-side `nuid`), so
-    # a consumer builds the index and profiles entirely through atlas_rb without
+    # Persons (each with `noid`, `display_name`, the server-side `nuid`, and
+    # `personal_root_id`), so a consumer builds the index and profiles entirely
+    # through atlas_rb without
     # routing People through the catalog/Solr or exposing a NUID publicly.
     #
     # @param page [Integer, nil] 1-based page (server default when nil).
@@ -54,11 +63,14 @@ module AtlasRb
 
     # Batch-resolve people to their authoritative display_name in one call
     # (supersedes the SSO users directory's resolve). Unresolved NUIDs drop.
+    # The deposit fork reads `affiliated_community_ids` and `personal_root_id`
+    # off the same resolve Mash it already makes for the depositor's Person.
     #
     # @param nuids [Array<String>] the NUIDs to resolve.
     # @param nuid [String, nil] acting principal.
     # @param on_behalf_of [String, nil] acting-as target.
-    # @return [Array<AtlasRb::Mash>] one unwrapped `"person"` per resolved NUID.
+    # @return [Array<AtlasRb::Mash>] one unwrapped `"person"` per resolved NUID
+    #   (each carries `nuid`, `affiliated_community_ids`, and `personal_root_id`).
     def self.resolve(nuids, nuid: nil, on_behalf_of: nil)
       JSON.parse(
         connection({ nuids: Array(nuids).join(",") }, nuid, on_behalf_of: on_behalf_of).get(ROUTE)&.body

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.6.5
+  version: 1.6.6
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-18 00:00:00.000000000 Z
+date: 2026-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday