kessel-sdk 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ebc4d755f68e6022b70351cb5320d50150f99909d2c41abff3dc356f99d543e0
-  data.tar.gz: e3023bf1171a3ae11021393dc16640cdbe9c28fdff55120f3717dfd6985b1e05
+  metadata.gz: 81373567779a9dd8c588272da54dfe57497d254b0b031ec64ea4d4ae39847063
+  data.tar.gz: fde2a1a46df1ef25745e579e43f0bb1685f5ee49938eb3a868aa2254550f9563
 SHA512:
-  metadata.gz: 787acd87560a9a3e563ef6abb46eba11ea94a14d418798a8124d2f63c768a561321434ec0291652147377f8f53dc8092a46a0ac202d16d8366516aa9bf76c844
-  data.tar.gz: 1a8aa9c31fdef9a382eadf8fcfa9bd0cf096549e4119c1c2256cdca85659a4cff814fe7ad718ec108bfaeb5dcb4f7589866c378e66fd5564a12be97999f74320
+  metadata.gz: d3c7dc9fdef0bc16cbe30a34be7e6f6a191eaec26dd91bdec21044443b3ad7537a5b185231c8a7c67ec49d3b37a052dd412364efb5000ca01e51fa8cd0423212
+  data.tar.gz: e13000fdbee258e3a0f1d6689eea603f3c690a9b44b1f9840b0b74ac0d919668fc6075b260a852c95b3bbfb94f8d5c6de0fc69a884366a86f49fd5a3652514f1

data/README.md

@@ -221,10 +221,15 @@ rake install_local
 
 The `examples/` directory contains working examples:
 
+- `auth.rb` - OAuth 2.0 authentication
 - `check.rb` - Permission checking
-- `report_resource.rb` - Reporting resource state
-- `delete_resource.rb` - Deleting resources
+- `check_bulk.rb` - Bulk permission checks
 - `check_for_update.rb` - Checking for updates
+- `check_for_update_bulk.rb` - Bulk strongly consistent update checks
+- `delete_resource.rb` - Deleting resources
+- `fetch_workspaces.rb` - Fetching workspaces
+- `list_workspaces.rb` - Listing workspaces
+- `report_resource.rb` - Reporting resource state
 - `streamed_list_objects.rb` - Streaming resource lists
 
 Run examples:
@@ -269,12 +274,17 @@ This project follows [Semantic Versioning 2.0.0](https://semver.org/). Version n
 
 1. **Update the Version**
    ```bash
-   # Edit lib/kessel/version.rb
-   # Update the VERSION constant to the new version number
+   # Edit lib/kessel/version.rb and update the VERSION constant
    vim lib/kessel/version.rb
    ```
 
-2. **Update Dependencies**
+2. **Set the VERSION environment variable**
+   ```bash
+   export VERSION=$(ruby -e "require_relative './lib/kessel/version.rb'; puts Kessel::Inventory::VERSION")
+   echo "Releasing version: v${VERSION}"
+   ```
+
+3. **Update Dependencies**
    ```bash
    # Generate gRPC code from Kessel Inventory API
    buf generate
@@ -282,7 +292,7 @@ This project follows [Semantic Versioning 2.0.0](https://semver.org/). Version n
    bundle install
    ```
 
-3. **Run Quality Checks**
+4. **Run Quality Checks**
    ```bash
    # Run the full test suite
    bundle exec rspec
@@ -297,15 +307,14 @@ This project follows [Semantic Versioning 2.0.0](https://semver.org/). Version n
    rake install_local
    ```
 
-4. **Commit Changes**
+5. **Commit Changes**
    ```bash
-   export VERSION=$(ruby -e "require_relative './lib/kessel/version.rb'; puts Kessel::Inventory::VERSION")
    git add lib/kessel/version.rb Gemfile.lock
    git commit -m "Release version ${VERSION}"
    git push origin main # or git push upstream main
    ```
 
-5. **Build and Release the Gem**
+6. **Build and Release the Gem**
    ```bash
    # Build the gem
    gem build kessel-sdk.gemspec
@@ -314,21 +323,27 @@ This project follows [Semantic Versioning 2.0.0](https://semver.org/). Version n
    gem push kessel-sdk-${VERSION}.gem
    ```
 
-6. **Tag the Release**
+7. **Tag the Release**
    ```bash
    # Create and push a git tag
    git tag -a v${VERSION} -m "Release version ${VERSION}"
    git push origin v${VERSION} # or git push upstream v${VERSION} 
    ```
 
-7. **Create a new release in github**
-- Go to the [GitHub Releases page](https://github.com/project-kessel/kessel-sdk-ruby/releases)
-- Click "Create a new release"
-- Select the tag you just created
-- Add release notes describing the changes
-- Publish the release
+8. **Create GitHub Release**
+   ```bash
+   gh release create v${VERSION} --title "v${VERSION}" --generate-notes
+   ```
+
+   Or manually:
+
+   - Go to the [GitHub Releases page](https://github.com/project-kessel/kessel-sdk-ruby/releases)
+   - Click "Create a new release"
+   - Select the tag you just created
+   - Add release notes describing the changes
+   - Publish the release
 
-8. **Clean Up**
+9. **Clean Up**
    ```bash
    # Remove the built gem file
    rake clean
@@ -352,7 +367,7 @@ rake install
 rake release
 ```
 
-**Note**: The `rake release` command automates steps 5-6 above but requires proper git and RubyGems credentials to be configured.
+**Note**: The `rake release` command automates steps 6-7 above but requires proper git and RubyGems credentials to be configured.
 
 ## Contributing
 

data/lib/kessel/inventory/v1beta2/check_for_update_bulk_request_pb.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: kessel/inventory/v1beta2/check_for_update_bulk_request.proto
+
+require 'google/protobuf'
+
+require 'buf/validate/validate_pb'
+require 'kessel/inventory/v1beta2/check_bulk_request_pb'
+
+
+descriptor_data = "\n<kessel/inventory/v1beta2/check_for_update_bulk_request.proto\x12\x18kessel.inventory.v1beta2\x1a\x1b\x62uf/validate/validate.proto\x1a\x31kessel/inventory/v1beta2/check_bulk_request.proto\"n\n\x19\x43heckForUpdateBulkRequest\x12Q\n\x05items\x18\x01 \x03(\x0b\x32..kessel.inventory.v1beta2.CheckBulkRequestItemB\x0b\xbaH\x08\x92\x01\x05\x08\x01\x10\xe8\x07R\x05itemsBr\n(org.project_kessel.api.inventory.v1beta2P\x01ZDgithub.com/project-kessel/inventory-api/api/kessel/inventory/v1beta2b\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Kessel
+  module Inventory
+    module V1beta2
+      CheckForUpdateBulkRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kessel.inventory.v1beta2.CheckForUpdateBulkRequest").msgclass
+    end
+  end
+end

data/lib/kessel/inventory/v1beta2/check_for_update_bulk_response_pb.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: kessel/inventory/v1beta2/check_for_update_bulk_response.proto
+
+require 'google/protobuf'
+
+require 'kessel/inventory/v1beta2/check_bulk_request_pb'
+require 'kessel/inventory/v1beta2/consistency_token_pb'
+require 'kessel/inventory/v1beta2/allowed_pb'
+require 'buf/validate/validate_pb'
+require 'google/rpc/status_pb'
+
+
+descriptor_data = "\n=kessel/inventory/v1beta2/check_for_update_bulk_response.proto\x12\x18kessel.inventory.v1beta2\x1a\x31kessel/inventory/v1beta2/check_bulk_request.proto\x1a\x30kessel/inventory/v1beta2/consistency_token.proto\x1a&kessel/inventory/v1beta2/allowed.proto\x1a\x1b\x62uf/validate/validate.proto\x1a\x17google/rpc/status.proto\"]\n\x1e\x43heckForUpdateBulkResponseItem\x12;\n\x07\x61llowed\x18\x01 \x01(\x0e\x32!.kessel.inventory.v1beta2.AllowedR\x07\x61llowed\"\xf2\x01\n\x1e\x43heckForUpdateBulkResponsePair\x12H\n\x07request\x18\x01 \x01(\x0b\x32..kessel.inventory.v1beta2.CheckBulkRequestItemR\x07request\x12N\n\x04item\x18\x02 \x01(\x0b\x32\x38.kessel.inventory.v1beta2.CheckForUpdateBulkResponseItemH\x00R\x04item\x12*\n\x05\x65rror\x18\x03 \x01(\x0b\x32\x12.google.rpc.StatusH\x00R\x05\x65rrorB\n\n\x08response\"\xcf\x01\n\x1a\x43heckForUpdateBulkResponse\x12X\n\x05pairs\x18\x01 \x03(\x0b\x32\x38.kessel.inventory.v1beta2.CheckForUpdateBulkResponsePairB\x08\xbaH\x05\x92\x01\x02\x08\x01R\x05pairs\x12W\n\x11\x63onsistency_token\x18\x02 \x01(\x0b\x32*.kessel.inventory.v1beta2.ConsistencyTokenR\x10\x63onsistencyTokenBr\n(org.project_kessel.api.inventory.v1beta2P\x01ZDgithub.com/project-kessel/inventory-api/api/kessel/inventory/v1beta2b\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Kessel
+  module Inventory
+    module V1beta2
+      CheckForUpdateBulkResponseItem = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kessel.inventory.v1beta2.CheckForUpdateBulkResponseItem").msgclass
+      CheckForUpdateBulkResponsePair = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kessel.inventory.v1beta2.CheckForUpdateBulkResponsePair").msgclass
+      CheckForUpdateBulkResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kessel.inventory.v1beta2.CheckForUpdateBulkResponse").msgclass
+    end
+  end
+end

data/lib/kessel/inventory/v1beta2/inventory_service_pb.rb

@@ -21,9 +21,11 @@ require 'kessel/inventory/v1beta2/check_self_request_pb'
 require 'kessel/inventory/v1beta2/check_self_response_pb'
 require 'kessel/inventory/v1beta2/check_self_bulk_request_pb'
 require 'kessel/inventory/v1beta2/check_self_bulk_response_pb'
+require 'kessel/inventory/v1beta2/check_for_update_bulk_request_pb'
+require 'kessel/inventory/v1beta2/check_for_update_bulk_response_pb'
 
 
-descriptor_data = "\n0kessel/inventory/v1beta2/inventory_service.proto\x12\x18kessel.inventory.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a,kessel/inventory/v1beta2/check_request.proto\x1a-kessel/inventory/v1beta2/check_response.proto\x1a\x37kessel/inventory/v1beta2/check_for_update_request.proto\x1a\x38kessel/inventory/v1beta2/check_for_update_response.proto\x1a\x36kessel/inventory/v1beta2/report_resource_request.proto\x1a\x37kessel/inventory/v1beta2/report_resource_response.proto\x1a\x36kessel/inventory/v1beta2/delete_resource_request.proto\x1a\x37kessel/inventory/v1beta2/delete_resource_response.proto\x1a<kessel/inventory/v1beta2/streamed_list_objects_request.proto\x1a=kessel/inventory/v1beta2/streamed_list_objects_response.proto\x1a\x31kessel/inventory/v1beta2/check_bulk_request.proto\x1a\x32kessel/inventory/v1beta2/check_bulk_response.proto\x1a\x31kessel/inventory/v1beta2/check_self_request.proto\x1a\x32kessel/inventory/v1beta2/check_self_response.proto\x1a\x36kessel/inventory/v1beta2/check_self_bulk_request.proto\x1a\x37kessel/inventory/v1beta2/check_self_bulk_response.proto2\xc7\t\n\x16KesselInventoryService\x12~\n\x05\x43heck\x12&.kessel.inventory.v1beta2.CheckRequest\x1a\'.kessel.inventory.v1beta2.CheckResponse\"$\x82\xd3\xe4\x93\x02\x1e\"\x19/api/kessel/v1beta2/check:\x01*\x12\x8e\x01\n\tCheckSelf\x12*.kessel.inventory.v1beta2.CheckSelfRequest\x1a+.kessel.inventory.v1beta2.CheckSelfResponse\"(\x82\xd3\xe4\x93\x02\"\"\x1d/api/kessel/v1beta2/checkself:\x01*\x12\xa2\x01\n\x0e\x43heckForUpdate\x12/.kessel.inventory.v1beta2.CheckForUpdateRequest\x1a\x30.kessel.inventory.v1beta2.CheckForUpdateResponse\"-\x82\xd3\xe4\x93\x02\'\"\"/api/kessel/v1beta2/checkforupdate:\x01*\x12\x8e\x01\n\tCheckBulk\x12*.kessel.inventory.v1beta2.CheckBulkRequest\x1a+.kessel.inventory.v1beta2.CheckBulkResponse\"(\x82\xd3\xe4\x93\x02\"\"\x1d/api/kessel/v1beta2/checkbulk:\x01*\x12\x9e\x01\n\rCheckSelfBulk\x12..kessel.inventory.v1beta2.CheckSelfBulkRequest\x1a/.kessel.inventory.v1beta2.CheckSelfBulkResponse\",\x82\xd3\xe4\x93\x02&\"!/api/kessel/v1beta2/checkselfbulk:\x01*\x12\x9d\x01\n\x0eReportResource\x12/.kessel.inventory.v1beta2.ReportResourceRequest\x1a\x30.kessel.inventory.v1beta2.ReportResourceResponse\"(\x82\xd3\xe4\x93\x02\"\"\x1d/api/kessel/v1beta2/resources:\x01*\x12\x9d\x01\n\x0e\x44\x65leteResource\x12/.kessel.inventory.v1beta2.DeleteResourceRequest\x1a\x30.kessel.inventory.v1beta2.DeleteResourceResponse\"(\x82\xd3\xe4\x93\x02\"*\x1d/api/kessel/v1beta2/resources:\x01*\x12\x84\x01\n\x13StreamedListObjects\x12\x34.kessel.inventory.v1beta2.StreamedListObjectsRequest\x1a\x35.kessel.inventory.v1beta2.StreamedListObjectsResponse0\x01\x42r\n(org.project_kessel.api.inventory.v1beta2P\x01ZDgithub.com/project-kessel/inventory-api/api/kessel/inventory/v1beta2b\x06proto3"
+descriptor_data = "\n0kessel/inventory/v1beta2/inventory_service.proto\x12\x18kessel.inventory.v1beta2\x1a\x1cgoogle/api/annotations.proto\x1a,kessel/inventory/v1beta2/check_request.proto\x1a-kessel/inventory/v1beta2/check_response.proto\x1a\x37kessel/inventory/v1beta2/check_for_update_request.proto\x1a\x38kessel/inventory/v1beta2/check_for_update_response.proto\x1a\x36kessel/inventory/v1beta2/report_resource_request.proto\x1a\x37kessel/inventory/v1beta2/report_resource_response.proto\x1a\x36kessel/inventory/v1beta2/delete_resource_request.proto\x1a\x37kessel/inventory/v1beta2/delete_resource_response.proto\x1a<kessel/inventory/v1beta2/streamed_list_objects_request.proto\x1a=kessel/inventory/v1beta2/streamed_list_objects_response.proto\x1a\x31kessel/inventory/v1beta2/check_bulk_request.proto\x1a\x32kessel/inventory/v1beta2/check_bulk_response.proto\x1a\x31kessel/inventory/v1beta2/check_self_request.proto\x1a\x32kessel/inventory/v1beta2/check_self_response.proto\x1a\x36kessel/inventory/v1beta2/check_self_bulk_request.proto\x1a\x37kessel/inventory/v1beta2/check_self_bulk_response.proto\x1a<kessel/inventory/v1beta2/check_for_update_bulk_request.proto\x1a=kessel/inventory/v1beta2/check_for_update_bulk_response.proto2\xfc\n\n\x16KesselInventoryService\x12~\n\x05\x43heck\x12&.kessel.inventory.v1beta2.CheckRequest\x1a\'.kessel.inventory.v1beta2.CheckResponse\"$\x82\xd3\xe4\x93\x02\x1e\"\x19/api/kessel/v1beta2/check:\x01*\x12\x8e\x01\n\tCheckSelf\x12*.kessel.inventory.v1beta2.CheckSelfRequest\x1a+.kessel.inventory.v1beta2.CheckSelfResponse\"(\x82\xd3\xe4\x93\x02\"\"\x1d/api/kessel/v1beta2/checkself:\x01*\x12\xa2\x01\n\x0e\x43heckForUpdate\x12/.kessel.inventory.v1beta2.CheckForUpdateRequest\x1a\x30.kessel.inventory.v1beta2.CheckForUpdateResponse\"-\x82\xd3\xe4\x93\x02\'\"\"/api/kessel/v1beta2/checkforupdate:\x01*\x12\xb2\x01\n\x12\x43heckForUpdateBulk\x12\x33.kessel.inventory.v1beta2.CheckForUpdateBulkRequest\x1a\x34.kessel.inventory.v1beta2.CheckForUpdateBulkResponse\"1\x82\xd3\xe4\x93\x02+\"&/api/kessel/v1beta2/checkforupdatebulk:\x01*\x12\x8e\x01\n\tCheckBulk\x12*.kessel.inventory.v1beta2.CheckBulkRequest\x1a+.kessel.inventory.v1beta2.CheckBulkResponse\"(\x82\xd3\xe4\x93\x02\"\"\x1d/api/kessel/v1beta2/checkbulk:\x01*\x12\x9e\x01\n\rCheckSelfBulk\x12..kessel.inventory.v1beta2.CheckSelfBulkRequest\x1a/.kessel.inventory.v1beta2.CheckSelfBulkResponse\",\x82\xd3\xe4\x93\x02&\"!/api/kessel/v1beta2/checkselfbulk:\x01*\x12\x9d\x01\n\x0eReportResource\x12/.kessel.inventory.v1beta2.ReportResourceRequest\x1a\x30.kessel.inventory.v1beta2.ReportResourceResponse\"(\x82\xd3\xe4\x93\x02\"\"\x1d/api/kessel/v1beta2/resources:\x01*\x12\x9d\x01\n\x0e\x44\x65leteResource\x12/.kessel.inventory.v1beta2.DeleteResourceRequest\x1a\x30.kessel.inventory.v1beta2.DeleteResourceResponse\"(\x82\xd3\xe4\x93\x02\"*\x1d/api/kessel/v1beta2/resources:\x01*\x12\x84\x01\n\x13StreamedListObjects\x12\x34.kessel.inventory.v1beta2.StreamedListObjectsRequest\x1a\x35.kessel.inventory.v1beta2.StreamedListObjectsResponse0\x01\x42r\n(org.project_kessel.api.inventory.v1beta2P\x01ZDgithub.com/project-kessel/inventory-api/api/kessel/inventory/v1beta2b\x06proto3"
 
 pool = ::Google::Protobuf::DescriptorPool.generated_pool
 pool.add_serialized_file(descriptor_data)

data/lib/kessel/inventory/v1beta2/inventory_service_services_pb.rb

@@ -48,6 +48,14 @@ module Kessel
           # It is intended to be used just prior to sensitive operation (e.g., update, delete)
           # which depend on the current state of the relationship.
           rpc :CheckForUpdate, ::Kessel::Inventory::V1beta2::CheckForUpdateRequest, ::Kessel::Inventory::V1beta2::CheckForUpdateResponse
+          # Performs bulk strongly consistent "check for update" permission checks.
+          #
+          # This API is more efficient than making individual CheckForUpdate calls when verifying
+          # update permissions for multiple resource-subject-relation combinations. Each item
+          # is evaluated with strong consistency (same semantics as CheckForUpdate).
+          #
+          # Common use cases include batch pre-authorization before bulk update or delete operations.
+          rpc :CheckForUpdateBulk, ::Kessel::Inventory::V1beta2::CheckForUpdateBulkRequest, ::Kessel::Inventory::V1beta2::CheckForUpdateBulkResponse
           # Performs bulk permission checks for multiple resource-subject-relation combinations.
           #
           # This API is more efficient than making individual Check calls when verifying permissions

data/lib/kessel/version.rb

@@ -2,6 +2,6 @@
 
 module Kessel
   module Inventory
-    VERSION = '1.7.0'
+    VERSION = '1.8.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kessel-sdk
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Project Kessel
@@ -238,6 +238,8 @@ files:
 - lib/kessel/inventory/v1beta2/allowed_pb.rb
 - lib/kessel/inventory/v1beta2/check_bulk_request_pb.rb
 - lib/kessel/inventory/v1beta2/check_bulk_response_pb.rb
+- lib/kessel/inventory/v1beta2/check_for_update_bulk_request_pb.rb
+- lib/kessel/inventory/v1beta2/check_for_update_bulk_response_pb.rb
 - lib/kessel/inventory/v1beta2/check_for_update_request_pb.rb
 - lib/kessel/inventory/v1beta2/check_for_update_response_pb.rb
 - lib/kessel/inventory/v1beta2/check_request_pb.rb