statelydb 0.29.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d5953d075d48d8ca4449644bb88fe0792587f00da52e29d0937b02416b0c0a0
-  data.tar.gz: 424e94dd43130382ec000b986d701581dd3a76a7e404ae7c4d2f0b3f3d8927b1
+  metadata.gz: e351019a0ad023595d08e9bf19a94facc2d1b92d00682516b929a2fe7c5593f7
+  data.tar.gz: d347e52bee873414dfa4709d9be9a3a6fae27cbb0482a369bc725224c863eea5
 SHA512:
-  metadata.gz: 2f4c26cdb3399124ee45110ad92611551a64d14df7548d92a537797eef804191d538c267bfc82d9c6c20f9e2f3812fd13f9f4fcfb3b60339df743b265b05e1e9
-  data.tar.gz: 4661408175189b2ef7320a145bee131404eb0b6a542b00e846dfb8fee0a4d3fdbdfb660d43a675b7362d5b7b94d6e17c3fd0a63cda284e624e4d13419ab7b3be
+  metadata.gz: faf9e62e260a7c05b57071ae982105d03de3edc23137d5c068e9478afa5a5c03ed2367caca7f698a41c8b9e71862b49006ce6898db1a828bb5ec393df6d8eccf
+  data.tar.gz: e731ba43fdb7699136c2ffdd82f2ff6e2a1b83fe317371ccfb994f657b3a3260d04d5246e1e518470a48e8f9b1295c4118b220a3a2bdb90b24b578cdde82b708

data/lib/api/db/list_filters_pb.rb

@@ -5,7 +5,7 @@
 require 'google/protobuf'
 
 
-descriptor_data = "\n\x15\x64\x62/list_filters.proto\x12\nstately.db\"9\n\x0f\x46ilterCondition\x12\x1d\n\titem_type\x18\x01 \x01(\tH\x00R\x08itemTypeB\x07\n\x05valueBk\n\x0e\x63om.stately.dbB\x10ListFiltersProtoP\x01\xa2\x02\x03SDX\xaa\x02\nStately.Db\xca\x02\nStately\\Db\xe2\x02\x16Stately\\Db\\GPBMetadata\xea\x02\x0bStately::Dbb\x06proto3"
+descriptor_data = "\n\x15\x64\x62/list_filters.proto\x12\nstately.db\"}\n\x0f\x46ilterCondition\x12\x1d\n\titem_type\x18\x01 \x01(\tH\x00R\x08itemType\x12\x42\n\x0e\x63\x65l_expression\x18\x02 \x01(\x0b\x32\x19.stately.db.CelExpressionH\x00R\rcelExpressionB\x07\n\x05value\"L\n\rCelExpression\x12\x1b\n\titem_type\x18\x01 \x01(\tR\x08itemType\x12\x1e\n\nexpression\x18\x02 \x01(\tR\nexpressionBk\n\x0e\x63om.stately.dbB\x10ListFiltersProtoP\x01\xa2\x02\x03SDX\xaa\x02\nStately.Db\xca\x02\nStately\\Db\xe2\x02\x16Stately\\Db\\GPBMetadata\xea\x02\x0bStately::Dbb\x06proto3"
 
 pool = ::Google::Protobuf::DescriptorPool.generated_pool
 pool.add_serialized_file(descriptor_data)
@@ -13,5 +13,6 @@ pool.add_serialized_file(descriptor_data)
 module Stately
   module Db
     FilterCondition = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("stately.db.FilterCondition").msgclass
+    CelExpression = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("stately.db.CelExpression").msgclass
   end
 end

data/lib/statelydb.rb

@@ -84,7 +84,7 @@ module StatelyDB
 
     # Fetch a single Item from a StatelyDB Store at the given key_path.
     #
-    # @param key_path [String] the path to the item
+    # @param key_path [StatelyDB::KeyPath, String] the path to the item
     # @return [StatelyDB::Item, NilClass] the Item or nil if not found
     # @raise [StatelyDB::Error] if the parameters are invalid or if the item is not found
     #
@@ -99,7 +99,8 @@ module StatelyDB
 
     # Fetch a batch of up to 100 Items from a StatelyDB Store at the given key_paths.
     #
-    # @param key_paths [String, Array<String>] the paths to the items. Max 100 key paths.
+    # @param key_paths [StatelyDB::KeyPath, String, Array<StatelyDB::KeyPath, String>] the paths
+    #   to the items. Max 100 key paths.
     # @return [Array<StatelyDB::Item>, NilClass] the items or nil if not found
     # @raise [StatelyDB::Error] if the parameters are invalid or if the item is not found
     #
@@ -124,7 +125,7 @@ module StatelyDB
 
     # Begin listing Items from a StatelyDB Store at the given prefix.
     #
-    # @param prefix [String] the prefix to list
+    # @param prefix [StatelyDB::KeyPath, String] the prefix to list
     # @param limit [Integer] the maximum number of items to return
     # @param sort_property [String] the property to sort by
     # @param sort_direction [Symbol, String, Integer] the direction to sort by (:ascending or :descending)
@@ -350,7 +351,8 @@ module StatelyDB
 
     # Delete up to 50 Items from a StatelyDB Store at the given key_paths.
     #
-    # @param key_paths [String, Array<String>] the paths to the items. Max 50 key paths.
+    # @param key_paths [StatelyDB::KeyPath, String, Array<StatelyDB::KeyPath, String>] the paths
+    #   to the items. Max 50 key paths.
     # @raise [StatelyDB::Error] if the parameters are invalid
     # @raise [StatelyDB::Error] if the item is not found
     # @return [void] nil

data/lib/transaction/transaction.rb

@@ -178,7 +178,7 @@ module StatelyDB
       # Fetch Items from a StatelyDB Store at the given key_path. Note that Items need to exist before being retrieved inside a
       # transaction.
       #
-      # @param key_path [String] the path to the item
+      # @param key_path [StatelyDB::KeyPath, String] the path to the item
       # @return [StatelyDB::Item, NilClass] the item or nil if not found
       # @raise [StatelyDB::Error::InvalidParameters] if the parameters are invalid
       # @raise [StatelyDB::Error::NotFound] if the item is not found
@@ -198,7 +198,7 @@ module StatelyDB
       # key_paths. Note that Items need to exist before being retrieved inside a
       # transaction.
       #
-      # @param key_paths [String, Array<String>] the paths to the items. Max 100
+      # @param key_paths [StatelyDB::KeyPath, String, Array<StatelyDB::KeyPath, String>] the paths to the items. Max 100
       # key paths.
       # @return [Array<StatelyDB::Item>] the items
       # @raise [StatelyDB::Error::InvalidParameters] if the parameters are invalid
@@ -310,7 +310,8 @@ module StatelyDB
       # Delete up to 50 Items from a StatelyDB Store at the given key_paths. Results are not returned until the transaction is
       # committed and will be available in the Result object returned by commit.
       #
-      # @param key_paths [String, Array<String>] the paths to the items. Max 50 key paths.
+      # @param key_paths [StatelyDB::KeyPath, String, Array<StatelyDB::KeyPath, String>] the paths
+      #   to the items. Max 50 key paths.
       # @return [void] nil
       #
       # Example:
@@ -330,7 +331,7 @@ module StatelyDB
 
       # Begin listing Items from a StatelyDB Store at the given prefix.
       #
-      # @param prefix [String] the prefix to list
+      # @param prefix [StatelyDB::KeyPath, String] the prefix to list
       # @param limit [Integer] the maximum number of items to return
       # @param sort_property [String] the property to sort by
       # @param sort_direction [Symbol] the direction to sort by (:ascending or :descending)

data/lib/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StatelyDB
-  VERSION = "0.29.0"
+  VERSION = "0.30.0"
 end

data/rbi/db/list_filters_pb.rbi

@@ -8,29 +8,55 @@ class Stately::Db::FilterCondition
 
   sig do
     params(
-      item_type: T.nilable(String)
+      item_type: T.nilable(String),
+      cel_expression: T.nilable(Stately::Db::CelExpression)
     ).void
   end
   def initialize(
-    item_type: ""
+    item_type: "",
+    cel_expression: nil
   )
   end
 
-  # item_type is the type of item to filter by.
+  # item_type is the type of item to include in a query response.
   sig { returns(String) }
   def item_type
   end
 
-  # item_type is the type of item to filter by.
+  # item_type is the type of item to include in a query response.
   sig { params(value: String).void }
   def item_type=(value)
   end
 
-  # item_type is the type of item to filter by.
+  # item_type is the type of item to include in a query response.
   sig { void }
   def clear_item_type
   end
 
+  # cel_expression is a CEL expression to evaluate against a specific item type.
+# If an expression evaluates to true, the item is included in the results.
+# This expression *only* applies to the item type specified in the
+# CelExpression.item_type field, and is not applied to other item types in the query.
+  sig { returns(T.nilable(Stately::Db::CelExpression)) }
+  def cel_expression
+  end
+
+  # cel_expression is a CEL expression to evaluate against a specific item type.
+# If an expression evaluates to true, the item is included in the results.
+# This expression *only* applies to the item type specified in the
+# CelExpression.item_type field, and is not applied to other item types in the query.
+  sig { params(value: T.nilable(Stately::Db::CelExpression)).void }
+  def cel_expression=(value)
+  end
+
+  # cel_expression is a CEL expression to evaluate against a specific item type.
+# If an expression evaluates to true, the item is included in the results.
+# This expression *only* applies to the item type specified in the
+# CelExpression.item_type field, and is not applied to other item types in the query.
+  sig { void }
+  def clear_cel_expression
+  end
+
   sig { returns(T.nilable(Symbol)) }
   def value
   end
@@ -67,3 +93,100 @@ class Stately::Db::FilterCondition
   def self.descriptor
   end
 end
+
+class Stately::Db::CelExpression
+  include ::Google::Protobuf::MessageExts
+  extend ::Google::Protobuf::MessageExts::ClassMethods
+
+  sig do
+    params(
+      item_type: T.nilable(String),
+      expression: T.nilable(String)
+    ).void
+  end
+  def initialize(
+    item_type: "",
+    expression: ""
+  )
+  end
+
+  # item_type is the itemType to evaluate the expression against.
+  sig { returns(String) }
+  def item_type
+  end
+
+  # item_type is the itemType to evaluate the expression against.
+  sig { params(value: String).void }
+  def item_type=(value)
+  end
+
+  # item_type is the itemType to evaluate the expression against.
+  sig { void }
+  def clear_item_type
+  end
+
+  # expression is the CEL expression to evaluate.
+# If the expression evaluates to true, the item is included in the results,
+# otherwise it is excluded.
+#
+# In the context of the CEL expression, 'this' refers to the item being evaluated.
+# For example, the expression is "this.foo == 'bar'" means that the item
+# must have a property 'foo' with the value 'bar' to be included in the results.
+  sig { returns(String) }
+  def expression
+  end
+
+  # expression is the CEL expression to evaluate.
+# If the expression evaluates to true, the item is included in the results,
+# otherwise it is excluded.
+#
+# In the context of the CEL expression, 'this' refers to the item being evaluated.
+# For example, the expression is "this.foo == 'bar'" means that the item
+# must have a property 'foo' with the value 'bar' to be included in the results.
+  sig { params(value: String).void }
+  def expression=(value)
+  end
+
+  # expression is the CEL expression to evaluate.
+# If the expression evaluates to true, the item is included in the results,
+# otherwise it is excluded.
+#
+# In the context of the CEL expression, 'this' refers to the item being evaluated.
+# For example, the expression is "this.foo == 'bar'" means that the item
+# must have a property 'foo' with the value 'bar' to be included in the results.
+  sig { void }
+  def clear_expression
+  end
+
+  sig { params(field: String).returns(T.untyped) }
+  def [](field)
+  end
+
+  sig { params(field: String, value: T.untyped).void }
+  def []=(field, value)
+  end
+
+  sig { returns(T::Hash[Symbol, T.untyped]) }
+  def to_h
+  end
+
+  sig { params(str: String).returns(Stately::Db::CelExpression) }
+  def self.decode(str)
+  end
+
+  sig { params(msg: Stately::Db::CelExpression).returns(String) }
+  def self.encode(msg)
+  end
+
+  sig { params(str: String, kw: T.untyped).returns(Stately::Db::CelExpression) }
+  def self.decode_json(str, **kw)
+  end
+
+  sig { params(msg: Stately::Db::CelExpression, kw: T.untyped).returns(String) }
+  def self.encode_json(msg, **kw)
+  end
+
+  sig { returns(::Google::Protobuf::Descriptor) }
+  def self.descriptor
+  end
+end

data/rbi/statelydb.rbi

@@ -245,7 +245,7 @@ module StatelyDB
     # ```ruby
     # client.get("/ItemType-identifier")
     # ```
-    sig { params(key_path: String).returns(T.any(StatelyDB::Item, NilClass)) }
+    sig { params(key_path: T.any(StatelyDB::KeyPath, String)).returns(T.any(StatelyDB::Item, NilClass)) }
     def get(key_path); end
 
     # Fetch a batch of up to 100 Items from a StatelyDB Store at the given key_paths.
@@ -257,7 +257,7 @@ module StatelyDB
     # ```ruby
     # client.data.get_batch("/ItemType-identifier", "/ItemType-identifier2")
     # ```
-    sig { params(key_paths: T.any(String, T::Array[String])).returns(T.any(T::Array[StatelyDB::Item], NilClass)) }
+    sig { params(key_paths: T.any(StatelyDB::KeyPath, String, T::Array[T.any(StatelyDB::KeyPath, String)])).returns(T.any(T::Array[StatelyDB::Item], NilClass)) }
     def get_batch(*key_paths); end
 
     # _@return_ — the list of Items and the token
@@ -400,7 +400,7 @@ module StatelyDB
     # ```ruby
     # client.data.delete("/ItemType-identifier", "/ItemType-identifier2")
     # ```
-    sig { params(key_paths: T.any(String, T::Array[String])).void }
+    sig { params(key_paths: T.any(StatelyDB::KeyPath, String, T::Array[T.any(StatelyDB::KeyPath, String)])).void }
     def delete(*key_paths); end
 
     # Transaction takes a block and executes the block within a transaction.
@@ -927,7 +927,7 @@ module StatelyDB
       #   item = txn.get("/ItemType-identifier")
       # end
       # ```
-      sig { params(key_path: String).returns(T.any(StatelyDB::Item, NilClass)) }
+      sig { params(key_path: T.any(StatelyDB::KeyPath, String)).returns(T.any(StatelyDB::Item, NilClass)) }
       def get(key_path); end
 
       # Fetch a batch of up to 100 Items from a StatelyDB Store at the given
@@ -943,7 +943,7 @@ module StatelyDB
       # _@param_ `key_paths` — the paths to the items. Max 100
       # 
       # _@return_ — the items
-      sig { params(key_paths: T.any(String, T::Array[String])).returns(T::Array[StatelyDB::Item]) }
+      sig { params(key_paths: T.any(StatelyDB::KeyPath, String, T::Array[T.any(StatelyDB::KeyPath, String)])).returns(T::Array[StatelyDB::Item]) }
       def get_batch(*key_paths); end
 
       # Put a single Item into a StatelyDB store. Results are not returned until the transaction is
@@ -1003,7 +1003,7 @@ module StatelyDB
       # _@param_ `key_paths` — the paths to the items. Max 50 key paths.
       # 
       # _@return_ — nil
-      sig { params(key_paths: T.any(String, T::Array[String])).void }
+      sig { params(key_paths: T.any(StatelyDB::KeyPath, String, T::Array[T.any(StatelyDB::KeyPath, String)])).void }
       def delete(*key_paths); end
 
       # Example:

data/sig/statelydb.rbs

@@ -208,7 +208,7 @@ module StatelyDB
     # ```ruby
     # client.get("/ItemType-identifier")
     # ```
-    def get: (String key_path) -> (StatelyDB::Item | NilClass)
+    def get: ((StatelyDB::KeyPath | String) key_path) -> (StatelyDB::Item | NilClass)
 
     # Fetch a batch of up to 100 Items from a StatelyDB Store at the given key_paths.
     # 
@@ -219,7 +219,7 @@ module StatelyDB
     # ```ruby
     # client.data.get_batch("/ItemType-identifier", "/ItemType-identifier2")
     # ```
-    def get_batch: (*(String | ::Array[String]) key_paths) -> (::Array[StatelyDB::Item] | NilClass)
+    def get_batch: (*(StatelyDB::KeyPath | String | ::Array[(StatelyDB::KeyPath | String)]) key_paths) -> (::Array[StatelyDB::Item] | NilClass)
 
     # _@return_ — the list of Items and the token
     # 
@@ -350,7 +350,7 @@ module StatelyDB
     # ```ruby
     # client.data.delete("/ItemType-identifier", "/ItemType-identifier2")
     # ```
-    def delete: (*(String | ::Array[String]) key_paths) -> void
+    def delete: (*(StatelyDB::KeyPath | String | ::Array[(StatelyDB::KeyPath | String)]) key_paths) -> void
 
     # Transaction takes a block and executes the block within a transaction.
     # If the block raises an exception, the transaction is rolled back.
@@ -813,7 +813,7 @@ module StatelyDB
       #   item = txn.get("/ItemType-identifier")
       # end
       # ```
-      def get: (String key_path) -> (StatelyDB::Item | NilClass)
+      def get: ((StatelyDB::KeyPath | String) key_path) -> (StatelyDB::Item | NilClass)
 
       # Fetch a batch of up to 100 Items from a StatelyDB Store at the given
       # key_paths. Note that Items need to exist before being retrieved inside a
@@ -828,7 +828,7 @@ module StatelyDB
       # _@param_ `key_paths` — the paths to the items. Max 100
       # 
       # _@return_ — the items
-      def get_batch: (*(String | ::Array[String]) key_paths) -> ::Array[StatelyDB::Item]
+      def get_batch: (*(StatelyDB::KeyPath | String | ::Array[(StatelyDB::KeyPath | String)]) key_paths) -> ::Array[StatelyDB::Item]
 
       # Put a single Item into a StatelyDB store. Results are not returned until the transaction is
       # committed and will be available in the Result object returned by commit. An identifier for
@@ -885,7 +885,7 @@ module StatelyDB
       # _@param_ `key_paths` — the paths to the items. Max 50 key paths.
       # 
       # _@return_ — nil
-      def delete: (*(String | ::Array[String]) key_paths) -> void
+      def delete: (*(StatelyDB::KeyPath | String | ::Array[(StatelyDB::KeyPath | String)]) key_paths) -> void
 
       # Example:
       #   client.data.transaction do |txn|
@@ -1008,6 +1008,7 @@ module Stately
     TransactionListResponse: untyped
     TransactionFinished: untyped
     FilterCondition: untyped
+    CelExpression: untyped
     ContinueListRequest: untyped
     ContinueListDirection: untyped
     ContinueScanRequest: untyped

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statelydb
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
 - Stately Cloud, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-25 00:00:00.000000000 Z
+date: 2025-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async