kessel-sdk 1.9.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9408aacf7604105abff5b811ad6548270be6d0c63f6193602fecd703ea79d522
-  data.tar.gz: 0237cd7effe27b00ff1ac07b1e8a2121f0275a2cbd48e215ae0a24ad511e8fb3
+  metadata.gz: 136206dbccfc87a36252fa0b635f195d00ebc861f9d26c3a35095403257e971c
+  data.tar.gz: 6e1366c5ed2fc78316fd7804f4ff31ac59819817e919fda84e689c7c8023f980
 SHA512:
-  metadata.gz: 6a6ee646283375fcb8f535f14475639e1d9b687212de54c06795eab2de4b07abc310a74c0ba9ed5d660efbcf8a039929f3cf6379ebaae18f8859434324fdd565
-  data.tar.gz: 6a92e7bb7b73d215fade25f2e818ecfad57638d5f84858c742fd4914294ac90132205cd9e252cb8906729927508fe73ba662e0fe93ee9e6528629be421137448
+  metadata.gz: 2c015adbcbf6838b582f598b31d7860d31541c4adeb622c60877399b67ae797a516f603185640890f6c711311e0ff9f09ef0968153219b9dddcc070bb75acfeb
+  data.tar.gz: 4967035e1789c864e4197e5e6ffcbf7bfe6e2d47dc24b2c1a4823b83e198171f043f0ceb0f9bee4cbbc5ae5f495882c2654b6d6e08989a4cc15fae5de3513a96

data/README.md

@@ -196,6 +196,10 @@ end
 
 ### List Workspaces (Streaming with Auto-Pagination)
 
+The `list_workspaces` helper automatically paginates through all workspaces
+a subject can access. Continuation tokens are handled internally, meaning you never
+need to manage them yourself.
+
 ```ruby
 include Kessel::Inventory::V1beta2
 include Kessel::RBAC::V2
@@ -204,11 +208,20 @@ client = KesselInventoryService::ClientBuilder.new('localhost:9000')
                                               .insecure
                                               .build
 
-list_workspaces(client, principal_subject('alice', 'redhat'), 'view_document').each do |response|
-  puts response
+subject = principal_subject("alice", "redhat")
+consistency = Kessel::Inventory::V1beta2::Consistency.new(minimize_latency: true)
+
+# Lazy iteration (constant memory)
+list_workspaces(client, subject, "viewer", consistency: consistency).each do |response|
+  puts response.object.resource_id
 end
+
+# Materialise into an Array
+all_workspaces = list_workspaces(client, subject, "viewer", consistency: consistency).to_a
 ```
 
+See [`examples/list_workspaces.rb`](./examples/list_workspaces.rb) for a complete working example.
+
 ### Available Services (V1beta2)
 
 The primary service is **`KesselInventoryService`** with these RPCs:

data/lib/kessel/auth.rb

@@ -130,6 +130,7 @@ module Kessel
         @client_secret = client_secret
         @token_endpoint = token_endpoint
         @token_mutex = Mutex.new
+        @generation = 0
       end
 
       # Gets the current access token with automatic caching and refresh.
@@ -146,13 +147,14 @@ module Kessel
       def get_token(force_refresh: false)
         return @cached_token if !force_refresh && token_valid?
 
-        @token_mutex.synchronize do
-          @cached_token = nil if force_refresh
+        generation = @generation
 
-          # Double-check: another thread might have refreshed the token
-          return @cached_token if token_valid?
+        @token_mutex.synchronize do
+          # Another thread already refreshed while we waited on the lock
+          return @cached_token if @generation != generation && token_valid?
 
           @cached_token = refresh
+          @generation += 1
 
           return @cached_token
         rescue StandardError => e

data/lib/kessel/rbac/v2.rb

@@ -22,7 +22,30 @@ module Kessel
         fetch_workspace(rbac_base_endpoint, org_id, 'root', auth: auth, http_client: http_client)
       end
 
-      def list_workspaces(inventory, subject, relation, continuation_token = nil)
+      # Lists all workspaces that a subject has a specific relation to.
+      #
+      # Pagination is handled automatically -- continuation tokens are managed
+      # internally. The returned +Enumerator+ is lazy; each page is fetched
+      # only when the next element is requested.
+      #
+      # @param inventory [Object] the inventory service client stub
+      # @param subject [SubjectReference] the subject to check permissions for
+      # @param relation [String] the relationship type (e.g. "member", "admin", "viewer")
+      # @param continuation_token [String, nil] optional token to resume listing
+      # @param consistency [Consistency, nil] optional consistency requirements for each request
+      # @return [Enumerator] a lazy enumerator of +StreamedListObjectsResponse+ objects
+      #
+      # @example Lazy iteration (constant memory)
+      #   consistency = Kessel::Inventory::V1beta2::Consistency.new(minimize_latency: true)
+      #   list_workspaces(inventory, subject, "viewer", consistency: consistency).each do |response|
+      #     puts response.object.resource_id
+      #   end
+      #
+      # @example Materialise into an Array (eager, all results in memory)
+      #   consistency = Kessel::Inventory::V1beta2::Consistency.new(minimize_latency: true)
+      #   all_workspaces = list_workspaces(inventory, subject, "viewer", consistency: consistency).to_a
+      #
+      def list_workspaces(inventory, subject, relation, continuation_token = nil, consistency: nil)
         Enumerator.new do |yielder|
           loop do
             request = StreamedListObjectsRequest.new(
@@ -32,7 +55,8 @@ module Kessel
               pagination: RequestPagination.new(
                 limit: DEFAULT_PAGE_LIMIT,
                 continuation_token: continuation_token
-              )
+              ),
+              consistency: consistency
             )
 
             has_responses = false

data/lib/kessel/version.rb

@@ -2,6 +2,6 @@
 
 module Kessel
   module Inventory
-    VERSION = '1.9.0'
+    VERSION = '1.10.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kessel-sdk
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Project Kessel
@@ -183,14 +183,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.31.0
+        version: 0.32.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.31.0
+        version: 0.32.0
 description: This is the official Ruby SDK for [Project Kessel](https://github.com/project-kessel),
   a system for unifying APIs and experiences with fine-grained authorization, common
   inventory, and CloudEvents.