atlas_rb 1.6.0 → 1.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: decab10cfb0c67c68615a9695a8c5084aa1bd349e199dccd77a76d024a3e7ba3
-  data.tar.gz: 90c4db9a3ffd80e9f226334f4862b9982534e431a3a6eb58746bfa96442ee701
+  metadata.gz: d84aa1546173f2a0ad397f7bb8f960be544c79c02187013fadf82301efa8afcf
+  data.tar.gz: 7873dec712e7bc46d10fd081e2401a96ff980c3c93d97a35799f08edbe701f26
 SHA512:
-  metadata.gz: 7fc789c2d47882f6d93664de27f7ab2f2a0d7d43957f4244436600e4247a332c5f8b3df030a5b11fb064187bd55439c0417a04974ca321df88861d47e0da2f15
-  data.tar.gz: 7189e8bcc3b4d483f623cfdc7a0881f41735646ef085f05a1418436b927fc84c2be514844ea44572c0d2c85f48e057be3a86d5774ac55bf8e09ae3ac4238fc4a
+  metadata.gz: 431d703701ca9f01511894590c3680147f96daf702930796acc8bfe6678b7c34eba571087c6ce491daf144797ea2c07bfd345e04d20cf077ff92034ec2c0c886
+  data.tar.gz: 83dc3bd542faa2ccca914f0f4029f4ef5427fd0971c641edeeacf607927d93d818e71faa45c9b5637f7f6ed9df0df7600a66bfa420a86965d3a59f71726d4b64

data/.version

@@ -1 +1 @@
-1.6.0
+1.6.2

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.6.0)
+    atlas_rb (1.6.2)
       faraday (~> 2.7)
       faraday-follow_redirects (~> 0.3.0)
       faraday-multipart (~> 1)
@@ -13,7 +13,7 @@ GEM
   specs:
     base64 (0.3.0)
     diff-lcs (1.6.1)
-    faraday (2.14.2)
+    faraday (2.14.3)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger

data/lib/atlas_rb/compilation.rb

@@ -53,16 +53,31 @@ module AtlasRb
       ))["compilation"]
     end
 
-    # List Compilations, owner-scoped and paginated (newest first).
-    #
-    # Defaults to the acting user's own Sets. Pass `owner:` to list another
-    # user's — that is admin-only and raises {AtlasRb::ForbiddenError} for
-    # anyone else. There is no public browse surface. Pass `q:` to narrow
-    # by case-insensitive title substring; the filter applies before
-    # pagination, so the `"pagination"` block describes the filtered result.
+    # List Compilations, paginated (newest first), in one of three modes.
+    #
+    # Default (no `scope:`) is owner-scoped: the acting user's own Sets. Pass
+    # `owner:` to list another user's — admin-only, raising
+    # {AtlasRb::ForbiddenError} for anyone else; there is no public browse
+    # surface.
+    #
+    # Pass `scope:` for grant-scoped discovery — Sets where the acting user is
+    # a *grantee* but **not** the owner (owned Sets are always excluded; list
+    # those with the default mode):
+    #   - `scope: :editable` — Sets the caller may edit (`edit_users` /
+    #     `edit_groups` grants).
+    #   - `scope: :shared` — Sets shared with the caller (`read_groups` grants,
+    #     plus the edit grants that imply read).
+    # Grant-scoped modes are keyed on the acting user; `owner:` is ignored and
+    # group membership is resolved server-side. An unknown `scope:` is a 400.
+    #
+    # Pass `q:` to narrow by case-insensitive title substring in any mode; the
+    # filter applies before pagination, so the `"pagination"` block describes
+    # the filtered result.
     #
     # @param owner [String, nil] NUID whose Sets to list (admin-only when it
-    #   isn't the acting user). Omit for "my Sets".
+    #   isn't the acting user). Omit for "my Sets". Ignored when `scope:` is set.
+    # @param scope [Symbol, String, nil] grant-scoped mode — `:editable` or
+    #   `:shared`. Omit for the owner-scoped default.
     # @param q [String, nil] case-insensitive title substring filter.
     # @param page [Integer, nil] 1-indexed page number.
     # @param per_page [Integer, nil] page size override.
@@ -82,11 +97,18 @@ module AtlasRb
     # @example Another user's Sets (admin)
     #   AtlasRb::Compilation.list(owner: "000000002", nuid: "000000004")
     #
+    # @example Sets shared with me that I can edit (not owned)
+    #   AtlasRb::Compilation.list(scope: :editable, nuid: "000000002")
+    #
+    # @example Sets shared with me to view (read + edit grants, not owned)
+    #   AtlasRb::Compilation.list(scope: :shared, nuid: "000000002")
+    #
     # @example Title typeahead
     #   AtlasRb::Compilation.list(q: "course", nuid: "000000002")
-    def self.list(owner: nil, q: nil, page: nil, per_page: nil, nuid: nil, on_behalf_of: nil)
+    def self.list(owner: nil, scope: nil, q: nil, page: nil, per_page: nil, nuid: nil, on_behalf_of: nil)
       params = {}
       params[:owner]    = owner    if owner
+      params[:scope]    = scope    if scope
       params[:q]        = q        if q
       params[:page]     = page     if page
       params[:per_page] = per_page if per_page

data/lib/atlas_rb/system.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module AtlasRb
+  # System-context callers — see {AtlasRb::System::User} for the namespace
+  # rationale (separate bearer token, hard-pinned `User:` header, the class
+  # itself as the carve-out marker).
+  #
+  # Beyond user provisioning, the namespace exposes Atlas's operational,
+  # `:system`-gated maintenance actions. These are not user operations — they
+  # never appear on the human CRUD surface — so they ride the system path.
+  module System
+    extend AtlasRb::FaradayHelper
+
+    # Re-project a single resource's Solr doc from Atlas's current
+    # Postgres/OCFL state. Solr-only on the server — no lifecycle transition,
+    # no audit event, no optimistic-lock bump. The purpose-built lever for
+    # refreshing a stale projection after an indexer ships or changes (e.g.
+    # the catalog's `classification_ssim` "Content" facet), without abusing
+    # `AtlasRb::Work.complete` to nudge Solr as a finalize side effect.
+    #
+    # Idempotent. Authenticates as the Atlas `:system` fixture via
+    # {FaradayHelper#system_connection}, so there is no way to issue it as a
+    # regular user.
+    #
+    # @param id [String] the NOID of any resource (Work, Collection,
+    #   Community, FileSet, ...).
+    # @return [Faraday::Response] the raw response. Status `204` on success;
+    #   `404` if the id does not resolve.
+    #
+    # @example Refresh one drifted Work after a new indexer shipped
+    #   AtlasRb::System.reindex("neu:abc123")
+    def self.reindex(id)
+      system_connection.post("/resources/#{id}/reindex")
+    end
+
+    # Re-project a resource AND its full descendant subtree — descendant
+    # containers (Collection/Community) plus the Works beneath them, a superset
+    # of Atlas's re-parent cascade so Work-level projections refresh too. Same
+    # Solr-only, side-effect-free semantics as {.reindex}.
+    #
+    # Synchronous on the server: rooted at a Collection it refreshes that
+    # Collection's contents; rooted at the top Community it backfills the whole
+    # repository. For a pathologically large subtree, root lower or drive the
+    # cascade in chunks (repeated calls) rather than relying on Atlas to grow a
+    # job runner — bulk orchestration lives in the consumer.
+    #
+    # @param id [String] the NOID of the subtree root.
+    # @return [Integer] the number of resources re-projected (the server's
+    #   `reindexed` count).
+    #
+    # @example Backfill a Collection's contents after an indexer change
+    #   AtlasRb::System.reindex_subtree("neu:collection1")  # => 42
+    def self.reindex_subtree(id)
+      response = system_connection.post("/resources/#{id}/reindex_subtree")
+      JSON.parse(response.body)["reindexed"]
+    end
+  end
+end

data/lib/atlas_rb.rb

@@ -27,6 +27,7 @@ require_relative "atlas_rb/admin"
 require_relative "atlas_rb/admin/work"
 require_relative "atlas_rb/admin/collection"
 require_relative "atlas_rb/admin/community"
+require_relative "atlas_rb/system"
 require_relative "atlas_rb/system/user"
 require_relative "atlas_rb/audit_event"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.6.2
 platform: ruby
 authors:
 - David Cliff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-16 00:00:00.000000000 Z
+date: 2026-06-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -148,6 +148,7 @@ files:
 - lib/atlas_rb/middleware/raise_on_resource_error.rb
 - lib/atlas_rb/middleware/raise_on_stale_resource.rb
 - lib/atlas_rb/resource.rb
+- lib/atlas_rb/system.rb
 - lib/atlas_rb/system/user.rb
 - lib/atlas_rb/user.rb
 - lib/atlas_rb/version.rb