atlas_rb 1.6.0 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: decab10cfb0c67c68615a9695a8c5084aa1bd349e199dccd77a76d024a3e7ba3
-  data.tar.gz: 90c4db9a3ffd80e9f226334f4862b9982534e431a3a6eb58746bfa96442ee701
+  metadata.gz: f0b6def06432136a4f0fda238a5c8ff3599de63234325e8609d0fcc49012d42d
+  data.tar.gz: a50c8fbbcaa1776a171f199e86e5ab90a8034f8c9415547c97893f52dc26a449
 SHA512:
-  metadata.gz: 7fc789c2d47882f6d93664de27f7ab2f2a0d7d43957f4244436600e4247a332c5f8b3df030a5b11fb064187bd55439c0417a04974ca321df88861d47e0da2f15
-  data.tar.gz: 7189e8bcc3b4d483f623cfdc7a0881f41735646ef085f05a1418436b927fc84c2be514844ea44572c0d2c85f48e057be3a86d5774ac55bf8e09ae3ac4238fc4a
+  metadata.gz: 19578a460cb38f49fd97a7513cc2ba6d782fa260a82f3c1071cc88e01a6a21ad6026969422033af5ad013f3e81d2d4d400fab42c72b300bd410582dc806d7f29
+  data.tar.gz: 941ce0caf062890a63891e5a458d83e1300e9240240f8adaf39a9e7ed7879ddaf4ef8168c566b052c5c7f7fde50c66e00e93baa66f71462a5464f2ea1b4a03ad

data/.version

@@ -1 +1 @@
-1.6.0
+1.6.1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    atlas_rb (1.6.0)
+    atlas_rb (1.6.1)
       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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: atlas_rb
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.6.1
 platform: ruby
 authors:
 - David Cliff