momento 0.2.0 → 0.5.0

data/lib/momento/generated/permissionmessages_pb.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: permissionmessages.proto
+
+require 'google/protobuf'
+
+descriptor_data = "\n\x18permissionmessages.proto\x12\x13permission_messages\"\x94\x01\n\x0bPermissions\x12?\n\nsuper_user\x18\x01 \x01(\x0e\x32).permission_messages.SuperUserPermissionsH\x00\x12<\n\x08\x65xplicit\x18\x02 \x01(\x0b\x32(.permission_messages.ExplicitPermissionsH\x00\x42\x06\n\x04kind\"P\n\x13\x45xplicitPermissions\x12\x39\n\x0bpermissions\x18\x01 \x03(\x0b\x32$.permission_messages.PermissionsType\"\xee\x08\n\x0fPermissionsType\x12R\n\x11\x63\x61\x63he_permissions\x18\x01 \x01(\x0b\x32\x35.permission_messages.PermissionsType.CachePermissionsH\x00\x12R\n\x11topic_permissions\x18\x02 \x01(\x0b\x32\x35.permission_messages.PermissionsType.TopicPermissionsH\x00\x1a\x05\n\x03\x41ll\x1a-\n\rCacheSelector\x12\x14\n\ncache_name\x18\x01 \x01(\tH\x00\x42\x06\n\x04kind\x1a@\n\x11\x43\x61\x63heItemSelector\x12\r\n\x03key\x18\x01 \x01(\x0cH\x00\x12\x14\n\nkey_prefix\x18\x02 \x01(\x0cH\x00\x42\x06\n\x04kind\x1a\xf5\x02\n\x10\x43\x61\x63hePermissions\x12,\n\x04role\x18\x01 \x01(\x0e\x32\x1e.permission_messages.CacheRole\x12>\n\nall_caches\x18\x02 \x01(\x0b\x32(.permission_messages.PermissionsType.AllH\x00\x12L\n\x0e\x63\x61\x63he_selector\x18\x03 \x01(\x0b\x32\x32.permission_messages.PermissionsType.CacheSelectorH\x00\x12=\n\tall_items\x18\x04 \x01(\x0b\x32(.permission_messages.PermissionsType.AllH\x01\x12O\n\ritem_selector\x18\x05 \x01(\x0b\x32\x36.permission_messages.PermissionsType.CacheItemSelectorH\x01\x42\x07\n\x05\x63\x61\x63heB\x0c\n\ncache_item\x1aJ\n\rTopicSelector\x12\x14\n\ntopic_name\x18\x01 \x01(\tH\x00\x12\x1b\n\x11topic_name_prefix\x18\x02 \x01(\tH\x00\x42\x06\n\x04kind\x1a\xee\x02\n\x10TopicPermissions\x12,\n\x04role\x18\x01 \x01(\x0e\x32\x1e.permission_messages.TopicRole\x12>\n\nall_caches\x18\x02 \x01(\x0b\x32(.permission_messages.PermissionsType.AllH\x00\x12L\n\x0e\x63\x61\x63he_selector\x18\x03 \x01(\x0b\x32\x32.permission_messages.PermissionsType.CacheSelectorH\x00\x12>\n\nall_topics\x18\x04 \x01(\x0b\x32(.permission_messages.PermissionsType.AllH\x01\x12L\n\x0etopic_selector\x18\x05 \x01(\x0b\x32\x32.permission_messages.PermissionsType.TopicSelectorH\x01\x42\x07\n\x05\x63\x61\x63heB\x07\n\x05topicB\x06\n\x04kind*[\n\tCacheRole\x12\x13\n\x0f\x43\x61\x63hePermitNone\x10\x00\x12\x12\n\x0e\x43\x61\x63heReadWrite\x10\x01\x12\x11\n\rCacheReadOnly\x10\x02\x12\x12\n\x0e\x43\x61\x63heWriteOnly\x10\x03*[\n\tTopicRole\x12\x13\n\x0fTopicPermitNone\x10\x00\x12\x12\n\x0eTopicReadWrite\x10\x01\x12\x11\n\rTopicReadOnly\x10\x02\x12\x12\n\x0eTopicWriteOnly\x10\x03*%\n\x14SuperUserPermissions\x12\r\n\tSuperUser\x10\x00\x42r\n\x18grpc.permission_messagesP\x01Z0github.com/momentohq/client-sdk-go;client_sdk_go\xaa\x02!Momento.Protos.PermissionMessagesb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require_relative 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = []
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module MomentoProtos
+  module PermissionMessages
+    Permissions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.Permissions").msgclass
+    ExplicitPermissions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.ExplicitPermissions").msgclass
+    PermissionsType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.PermissionsType").msgclass
+    PermissionsType::All = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.PermissionsType.All").msgclass
+    PermissionsType::CacheSelector = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.PermissionsType.CacheSelector").msgclass
+    PermissionsType::CacheItemSelector = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.PermissionsType.CacheItemSelector").msgclass
+    PermissionsType::CachePermissions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.PermissionsType.CachePermissions").msgclass
+    PermissionsType::TopicSelector = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.PermissionsType.TopicSelector").msgclass
+    PermissionsType::TopicPermissions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.PermissionsType.TopicPermissions").msgclass
+    CacheRole = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.CacheRole").enummodule
+    TopicRole = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.TopicRole").enummodule
+    SuperUserPermissions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("permission_messages.SuperUserPermissions").enummodule
+  end
+end

data/lib/momento/generated/token_pb.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: token.proto
+
+require 'google/protobuf'
+
+require_relative 'permissionmessages_pb'
+
+descriptor_data = "\n\x0btoken.proto\x12\x05token\x1a\x18permissionmessages.proto\"\xe5\x01\n\x1f_GenerateDisposableTokenRequest\x12?\n\x07\x65xpires\x18\x01 \x01(\x0b\x32..token._GenerateDisposableTokenRequest.Expires\x12\x12\n\nauth_token\x18\x02 \x01(\t\x12\x35\n\x0bpermissions\x18\x03 \x01(\x0b\x32 .permission_messages.Permissions\x12\x10\n\x08token_id\x18\x04 \x01(\t\x1a$\n\x07\x45xpires\x12\x19\n\x11valid_for_seconds\x18\x01 \x01(\r\"Z\n _GenerateDisposableTokenResponse\x12\x0f\n\x07\x61pi_key\x18\x01 \x01(\t\x12\x10\n\x08\x65ndpoint\x18\x02 \x01(\t\x12\x13\n\x0bvalid_until\x18\x03 \x01(\x04\x32u\n\x05Token\x12l\n\x17GenerateDisposableToken\x12&.token._GenerateDisposableTokenRequest\x1a'.token._GenerateDisposableTokenResponse\"\x00\x42`\n\rmomento.tokenP\x01Z0github.com/momentohq/client-sdk-go;client_sdk_go\xaa\x02\x1aMomento.Protos.TokenClientb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require_relative 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["permission_messages.Permissions", "permissionmessages.proto"]
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module MomentoProtos
+  module Token
+    PB__GenerateDisposableTokenRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("token._GenerateDisposableTokenRequest").msgclass
+    PB__GenerateDisposableTokenRequest::Expires = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("token._GenerateDisposableTokenRequest.Expires").msgclass
+    PB__GenerateDisposableTokenResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("token._GenerateDisposableTokenResponse").msgclass
+  end
+end

data/lib/momento/generated/token_services_pb.rb

@@ -0,0 +1,23 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: token.proto for package 'token'
+
+require 'grpc'
+require_relative 'token_pb'
+
+module MomentoProtos
+  module Token
+    module Token
+      class Service
+        include ::GRPC::GenericService
+
+        self.marshal_class_method = :encode
+        self.unmarshal_class_method = :decode
+        self.service_name = 'token.Token'
+
+        rpc :GenerateDisposableToken, ::Token::PB__GenerateDisposableTokenRequest, ::Token::PB__GenerateDisposableTokenResponse
+      end
+
+      Stub = Service.rpc_stub_class
+    end
+  end
+end

data/lib/momento/generated/webhook_pb.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: webhook.proto
+
+require 'google/protobuf'
+
+descriptor_data = "\n\rwebhook.proto\x12\x07webhook\"6\n\n_WebhookId\x12\x12\n\ncache_name\x18\x01 \x01(\t\x12\x14\n\x0cwebhook_name\x18\x02 \x01(\t\"z\n\x08_Webhook\x12'\n\nwebhook_id\x18\x01 \x01(\x0b\x32\x13.webhook._WebhookId\x12\x12\n\ntopic_name\x18\x02 \x01(\t\x12\x31\n\x0b\x64\x65stination\x18\x03 \x01(\x0b\x32\x1c.webhook._WebhookDestination\"8\n\x12_PutWebhookRequest\x12\"\n\x07webhook\x18\x01 \x01(\x0b\x32\x11.webhook._Webhook\",\n\x13_PutWebhookResponse\x12\x15\n\rsecret_string\x18\x01 \x01(\t\"@\n\x15_DeleteWebhookRequest\x12'\n\nwebhook_id\x18\x01 \x01(\x0b\x32\x13.webhook._WebhookId\"\x18\n\x16_DeleteWebhookResponse\")\n\x13_ListWebhookRequest\x12\x12\n\ncache_name\x18\x01 \x01(\t\";\n\x15_ListWebhooksResponse\x12\"\n\x07webhook\x18\x01 \x03(\x0b\x32\x11.webhook._Webhook\"D\n\x18_GetWebhookSecretRequest\x12\x12\n\ncache_name\x18\x01 \x01(\t\x12\x14\n\x0cwebhook_name\x18\x02 \x01(\t\"\\\n\x19_GetWebhookSecretResponse\x12\x12\n\ncache_name\x18\x01 \x01(\t\x12\x14\n\x0cwebhook_name\x18\x02 \x01(\t\x12\x15\n\rsecret_string\x18\x03 \x01(\t\"1\n\x13_WebhookDestination\x12\x12\n\x08post_url\x18\x01 \x01(\tH\x00\x42\x06\n\x04kind\"F\n\x1b_RotateWebhookSecretRequest\x12'\n\nwebhook_id\x18\x01 \x01(\x0b\x32\x13.webhook._WebhookId\"5\n\x1c_RotateWebhookSecretResponse\x12\x15\n\rsecret_string\x18\x01 \x01(\t2\xbb\x03\n\x07Webhook\x12I\n\nPutWebhook\x12\x1b.webhook._PutWebhookRequest\x1a\x1c.webhook._PutWebhookResponse\"\x00\x12R\n\rDeleteWebhook\x12\x1e.webhook._DeleteWebhookRequest\x1a\x1f.webhook._DeleteWebhookResponse\"\x00\x12N\n\x0cListWebhooks\x12\x1c.webhook._ListWebhookRequest\x1a\x1e.webhook._ListWebhooksResponse\"\x00\x12[\n\x10GetWebhookSecret\x12!.webhook._GetWebhookSecretRequest\x1a\".webhook._GetWebhookSecretResponse\"\x00\x12\x64\n\x13RotateWebhookSecret\x12$.webhook._RotateWebhookSecretRequest\x1a%.webhook._RotateWebhookSecretResponse\"\x00\x42[\n\x0cgrpc.webhookP\x01Z0github.com/momentohq/client-sdk-go;client_sdk_go\xaa\x02\x16Momento.Protos.Webhookb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require_relative 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = []
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module MomentoProtos
+  module Webhook
+    PB__WebhookId = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._WebhookId").msgclass
+    PB__Webhook = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._Webhook").msgclass
+    PB__PutWebhookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._PutWebhookRequest").msgclass
+    PB__PutWebhookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._PutWebhookResponse").msgclass
+    PB__DeleteWebhookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._DeleteWebhookRequest").msgclass
+    PB__DeleteWebhookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._DeleteWebhookResponse").msgclass
+    PB__ListWebhookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._ListWebhookRequest").msgclass
+    PB__ListWebhooksResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._ListWebhooksResponse").msgclass
+    PB__GetWebhookSecretRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._GetWebhookSecretRequest").msgclass
+    PB__GetWebhookSecretResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._GetWebhookSecretResponse").msgclass
+    PB__WebhookDestination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._WebhookDestination").msgclass
+    PB__RotateWebhookSecretRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._RotateWebhookSecretRequest").msgclass
+    PB__RotateWebhookSecretResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("webhook._RotateWebhookSecretResponse").msgclass
+  end
+end

data/lib/momento/generated/webhook_services_pb.rb

@@ -0,0 +1,32 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: webhook.proto for package 'webhook'
+
+require 'grpc'
+require_relative 'webhook_pb'
+
+module MomentoProtos
+  module Webhook
+    module Webhook
+      # A Webhook is a mechanism to consume messages on a Topic.
+      # The primary purpose of webhooks in Momento is to enable
+      # Lambda to be a subscriber to the messages sent on a topic.
+      # Secondarily, webhooks open us up to a whole lot of integrations
+      # (slack, discord, event bridge, etc).
+      class Service
+        include ::GRPC::GenericService
+
+        self.marshal_class_method = :encode
+        self.unmarshal_class_method = :decode
+        self.service_name = 'webhook.Webhook'
+
+        rpc :PutWebhook, ::Webhook::PB__PutWebhookRequest, ::Webhook::PB__PutWebhookResponse
+        rpc :DeleteWebhook, ::Webhook::PB__DeleteWebhookRequest, ::Webhook::PB__DeleteWebhookResponse
+        rpc :ListWebhooks, ::Webhook::PB__ListWebhookRequest, ::Webhook::PB__ListWebhooksResponse
+        rpc :GetWebhookSecret, ::Webhook::PB__GetWebhookSecretRequest, ::Webhook::PB__GetWebhookSecretResponse
+        rpc :RotateWebhookSecret, ::Webhook::PB__RotateWebhookSecretRequest, ::Webhook::PB__RotateWebhookSecretResponse
+      end
+
+      Stub = Service.rpc_stub_class
+    end
+  end
+end

data/lib/momento/response/control/create_cache_response.rb

@@ -0,0 +1,61 @@
+require_relative '../error'
+require_relative '../../generated/controlclient_pb'
+
+module Momento
+  # A response from creating a cache.
+  class CreateCacheResponse < Response
+    # Does the cache already exist?
+    # @return [Boolean]
+    def already_exists?
+      false
+    end
+
+    # Was the cache created?
+    # @return [Boolean]
+    def success?
+      false
+    end
+
+    # @private
+    class AlreadyExists < CreateCacheResponse
+      def already_exists?
+        true
+      end
+    end
+
+    # @private
+    class Success < CreateCacheResponse
+      def success?
+        true
+      end
+    end
+
+    # @private
+    class Error < CreateCacheResponse
+      include ::Momento::Response::Error
+    end
+  end
+
+  # @private
+  class CreateCacheResponseBuilder < ResponseBuilder
+    # Build a Momento::CreateCacheResponse from a block of code
+    # which returns a Momento::ControlClient::CreateCacheResponse.
+    #
+    # @return [Momento::CreateCacheResponse]
+    # @raise [StandardError] when the exception is not recognized.
+    # @raise [TypeError] when the response is not recognized.
+    def from_block
+      response = yield
+    rescue GRPC::AlreadyExists
+      return CreateCacheResponse::AlreadyExists.new
+    rescue *RESCUED_EXCEPTIONS => e
+      CreateCacheResponse::Error.new(
+        exception: e, context: context
+      )
+    else
+      raise TypeError unless response.is_a?(::MomentoProtos::ControlClient::PB__CreateCacheResponse)
+
+      return CreateCacheResponse::Success.new
+    end
+  end
+end

data/lib/momento/{delete_cache_response_builder.rb → response/control/delete_cache_response.rb}

@@ -1,7 +1,28 @@
-require 'grpc'
-require_relative 'controlclient_pb'
+require_relative '../error'
+require_relative '../../generated/controlclient_pb'
 
 module Momento
+  # A response from deleting a cache.
+  class DeleteCacheResponse < Response
+    # Was the cache deleted?
+    # @return [Boolean]
+    def success?
+      false
+    end
+
+    # @private
+    class Error < DeleteCacheResponse
+      include ::Momento::Response::Error
+    end
+
+    # @private
+    class Success < DeleteCacheResponse
+      def success?
+        true
+      end
+    end
+  end
+
   # @private
   class DeleteCacheResponseBuilder < ResponseBuilder
     # Build a Momento::DeleteCacheResponse from a block of code
@@ -17,7 +38,7 @@ module Momento
         exception: e, context: context
       )
     else
-      raise TypeError unless response.is_a?(::Momento::ControlClient::DeleteCacheResponse)
+      raise TypeError unless response.is_a?(::MomentoProtos::ControlClient::PB__DeleteCacheResponse)
 
       return DeleteCacheResponse::Success.new
     end

data/lib/momento/response/control/list_caches_response.rb

@@ -0,0 +1,80 @@
+require_relative '../error'
+require_relative '../../generated/controlclient_pb'
+
+module Momento
+  # A response from listing the caches.
+  class ListCachesResponse < Response
+    # Did it get a list of caches?
+    # @return [Boolean]
+    def success?
+      false
+    end
+
+    # The names of the caches.
+    # @return [Array,nil]
+    def cache_names
+      nil
+    end
+
+    # @!method to_s
+    #   Displays the response and the list of cache names.
+    #   The list of cache names will be truncated.
+    #   @return [String]
+
+    # @private
+    class Success < ListCachesResponse
+      CACHE_NAMES_TO_DISPLAY = 5
+
+      # rubocop:disable Lint/MissingSuper
+      def initialize(grpc_response:)
+        @grpc_response = grpc_response
+      end
+      # rubocop:enable Lint/MissingSuper
+
+      def success?
+        true
+      end
+
+      def cache_names
+        @grpc_response.cache.map(&:cache_name)
+      end
+
+      def to_s
+        "#{super}: #{display_cache_names}"
+      end
+
+      private
+
+      def display_cache_names
+        display = cache_names&.take(CACHE_NAMES_TO_DISPLAY)&.join(", ")
+        cache_names&.size&.>(CACHE_NAMES_TO_DISPLAY) ? "#{display}, ..." : display.to_s
+      end
+    end
+
+    # @private
+    class Error < ListCachesResponse
+      include ::Momento::Response::Error
+    end
+  end
+
+  # @private
+  class ListCachesResponseBuilder < ResponseBuilder
+    # Build a Momento::ListCachesResponse from a block of code
+    # which returns a Momento::ControlClient::ListCachesResponse..
+    #
+    # @return [Momento::ListCachesResponse]
+    # @raise [StandardError] when the exception is not recognized.
+    # @raise [TypeError] when the response is not recognized.
+    def from_block
+      response = yield
+    rescue GRPC::BadStatus => e
+      ListCachesResponse::Error.new(
+        exception: e, context: context
+      )
+    else
+      raise TypeError unless response.is_a?(::MomentoProtos::ControlClient::PB__ListCachesResponse)
+
+      return ListCachesResponse::Success.new(grpc_response: response)
+    end
+  end
+end

data/lib/momento/{delete_response_builder.rb → response/delete_response.rb}

@@ -1,7 +1,29 @@
+require_relative 'error'
 require 'grpc'
-require_relative 'cacheclient_pb'
+require_relative '../generated/cacheclient_pb'
 
 module Momento
+  # A response from deleting a key.
+  class DeleteResponse < Response
+    # Was the key deleted?
+    # @return [Boolean]
+    def success?
+      false
+    end
+
+    # @private
+    class Success < DeleteResponse
+      def success?
+        true
+      end
+    end
+
+    # @private
+    class Error < DeleteResponse
+      include Momento::Response::Error
+    end
+  end
+
   # @private
   class DeleteResponseBuilder < ResponseBuilder
     # Build a Momento::DeleteResponse from a block of code
@@ -15,7 +37,7 @@ module Momento
     rescue *RESCUED_EXCEPTIONS => e
       DeleteResponse::Error.new(exception: e, context: context)
     else
-      raise TypeError unless response.is_a?(::Momento::CacheClient::DeleteResponse)
+      raise TypeError unless response.is_a?(::MomentoProtos::CacheClient::PB__DeleteResponse)
 
       DeleteResponse::Success.new
     end

data/lib/momento/{get_response.rb → response/get_response.rb}

@@ -1,4 +1,5 @@
-require_relative 'response/error'
+require_relative 'error'
+require_relative '../generated/cacheclient_pb'
 
 module Momento
   # A response containing the value retrieved from a cache.
@@ -22,15 +23,12 @@ module Momento
       nil
     end
 
-    # The gotten value, if any, as a string using your default encoding or specified one.
+    # The gotten value, if any, as a UTF-8 string.
     #
-    # @param encoding [Encoding] defaults to Encoding.default_external
-    # @return [String,nil] the value, if any, re-encoded
-    # rubocop:disable Lint/UnusedMethodArgument
-    def value_string(encoding = Encoding.default_external)
+    # @return [String,nil] the value, if any.
+    def value_string
       nil
     end
-    # rubocop:enable Lint/UnusedMethodArgument
 
     # @!method to_s
     #   Displays the response and the value, if any.
@@ -53,8 +51,8 @@ module Momento
         @grpc_response.cache_body
       end
 
-      def value_string(encoding = Encoding.default_external)
-        value_bytes.dup.force_encoding(encoding)
+      def value_string
+        value_bytes.dup.force_encoding('UTF-8')
       end
 
       def to_s
@@ -74,4 +72,36 @@ module Momento
       include Momento::Response::Error
     end
   end
+
+  # @private
+  class GetResponseBuilder < ResponseBuilder
+    # Build a Momento::GetResponse from a block of code
+    # which returns a Momento::ControlClient::GetResponse.
+    #
+    # @return [Momento::GetResponse]
+    # @raise [StandardError] when the exception is not recognized.
+    # @raise [TypeError] when the response is not recognized.
+    def from_block
+      response = yield
+    rescue *RESCUED_EXCEPTIONS => e
+      GetResponse::Error.new(exception: e, context: context)
+    else
+      from_response(response)
+    end
+
+    private
+
+    def from_response(response)
+      raise TypeError unless response.is_a?(MomentoProtos::CacheClient::PB__GetResponse)
+
+      case response.result
+      when :Hit
+        GetResponse::Hit.new(grpc_response: response)
+      when :Miss
+        GetResponse::Miss.new
+      else
+        raise "Unknown get result: #{response.result}"
+      end
+    end
+  end
 end

data/lib/momento/{response.rb → response/response.rb}

@@ -1,27 +1,24 @@
 require 'grpc'
-require_relative 'response/error'
 require_relative 'error'
-require_relative 'error/grpc_details'
-require_relative 'error/transport_details'
-require_relative 'error_builder'
+require_relative '../error'
+require_relative '../error/grpc_details'
+require_relative '../error/transport_details'
+require_relative '../error_builder'
 require_relative 'response_builder'
-require_relative 'create_cache_response'
-require_relative 'create_cache_response_builder'
+require_relative 'control/create_cache_response'
 require_relative 'delete_response'
-require_relative 'delete_response_builder'
-require_relative 'delete_cache_response'
-require_relative 'delete_cache_response_builder'
+require_relative 'control/delete_cache_response'
 require_relative 'get_response'
-require_relative 'get_response_builder'
-require_relative 'list_caches_response'
-require_relative 'list_caches_response_builder'
+require_relative 'control/list_caches_response'
 require_relative 'set_response'
-require_relative 'set_response_builder'
+require_relative 'sorted_set/sorted_set_put_element_response'
+require_relative 'sorted_set/sorted_set_put_elements_response'
+require_relative 'sorted_set/sorted_set_fetch_response'
 
 module Momento
   # The response from a Momento service request.
   #
-  # {Momento::SimpleCacheClient} returns a response for both success
+  # {Momento::CacheClient} returns a response for both success
   # and error, as well as other states. See the documenation for each
   # type of response for more.
   #

data/lib/momento/response/set_response.rb

@@ -0,0 +1,59 @@
+require_relative 'error'
+require_relative '../generated/cacheclient_pb'
+
+module Momento
+  # A response from setting a key.
+  class SetResponse < Response
+    # Was the key/value pair added to the cache?
+    # @return [Boolean]
+    def success?
+      false
+    end
+
+    # @private
+    class Success < SetResponse
+      attr_accessor :key, :value
+
+      # rubocop:disable Lint/MissingSuper
+      def initialize(key:, value:)
+        @key = key
+        @value = value
+
+        return
+      end
+      # rubocop:enable Lint/MissingSuper
+
+      def success?
+        true
+      end
+
+      def to_s
+        "#{super}: '#{display_string(key)}' = '#{display_string(value)}'"
+      end
+    end
+
+    # @private
+    class Error < SetResponse
+      include Momento::Response::Error
+    end
+  end
+
+  # @private
+  class SetResponseBuilder < ResponseBuilder
+    # Build a Momento::SetResponse from a block of code
+    # which returns a Momento::CacheClient::SetResponse..
+    #
+    # @return [Momento::SetResponse]
+    # @raise [StandardError] when the exception is not recognized.
+    # @raise [TypeError] when the response is not recognized.
+    def from_block
+      response = yield
+    rescue *RESCUED_EXCEPTIONS => e
+      SetResponse::Error.new(exception: e, context: context)
+    else
+      raise TypeError unless response.is_a?(::MomentoProtos::CacheClient::PB__SetResponse)
+
+      SetResponse::Success.new(key: context[:key], value: context[:value])
+    end
+  end
+end

data/lib/momento/response/sort_order.rb

@@ -0,0 +1,11 @@
+module Momento
+  # Represents whether a collection is sorted in ascending or descending fashion.
+  class SortOrder
+    ASCENDING = :ascending
+    DESCENDING = :descending
+
+    def self.valid?(order)
+      [ASCENDING, DESCENDING].include?(order)
+    end
+  end
+end