terminal-shop 2.0.0 → 2.1.0

data/rbi/lib/terminal-shop/type/converter.rbi

@@ -0,0 +1,101 @@
+# typed: strong
+
+module TerminalShop
+  module Type
+    # @api private
+    module Converter
+      Input = T.type_alias { T.any(TerminalShop::Type::Converter, T::Class[T.anything]) }
+
+      State =
+        T.type_alias do
+          {
+            strictness: T.any(T::Boolean, Symbol),
+            exactness: {yes: Integer, no: Integer, maybe: Integer},
+            branched: Integer
+          }
+        end
+
+      # @api private
+      sig do
+        overridable.params(value: T.anything, state: TerminalShop::Type::Converter::State).returns(T.anything)
+      end
+      def coerce(value, state:)
+      end
+
+      # @api private
+      sig { overridable.params(value: T.anything).returns(T.anything) }
+      def dump(value)
+      end
+
+      class << self
+        # @api private
+        sig do
+          params(
+            spec: T.any(
+              {
+                const: T.nilable(T.any(NilClass, T::Boolean, Integer, Float, Symbol)),
+                enum: T.nilable(T.proc.returns(TerminalShop::Type::Converter::Input)),
+                union: T.nilable(T.proc.returns(TerminalShop::Type::Converter::Input))
+              },
+              T.proc.returns(TerminalShop::Type::Converter::Input),
+              TerminalShop::Type::Converter::Input
+            )
+          )
+            .returns(T.proc.returns(T.anything))
+        end
+        def self.type_info(spec)
+        end
+
+        # @api private
+        #
+        # Based on `target`, transform `value` into `target`, to the extent possible:
+        #
+        #   1. if the given `value` conforms to `target` already, return the given `value`
+        #   2. if it's possible and safe to convert the given `value` to `target`, then the
+        #      converted value
+        #   3. otherwise, the given `value` unaltered
+        #
+        #   The coercion process is subject to improvement between minor release versions.
+        #   See https://docs.pydantic.dev/latest/concepts/unions/#smart-mode
+        sig do
+          params(
+            target: TerminalShop::Type::Converter::Input,
+            value: T.anything,
+            state: TerminalShop::Type::Converter::State
+          )
+            .returns(T.anything)
+        end
+        def self.coerce(
+          target,
+          value,
+          # The `strictness` is one of `true`, `false`, or `:strong`. This informs the
+          #   coercion strategy when we have to decide between multiple possible conversion
+          #   targets:
+          #
+          #   - `true`: the conversion must be exact, with minimum coercion.
+          #   - `false`: the conversion can be approximate, with some coercion.
+          #   - `:strong`: the conversion must be exact, with no coercion, and raise an error
+          #     if not possible.
+          #
+          #   The `exactness` is `Hash` with keys being one of `yes`, `no`, or `maybe`. For
+          #   any given conversion attempt, the exactness will be updated based on how closely
+          #   the value recursively matches the target type:
+          #
+          #   - `yes`: the value can be converted to the target type with minimum coercion.
+          #   - `maybe`: the value can be converted to the target type with some reasonable
+          #     coercion.
+          #   - `no`: the value cannot be converted to the target type.
+          #
+          #   See implementation below for more details.
+          state: {strictness: true, exactness: {yes: 0, no: 0, maybe: 0}, branched: 0}
+        )
+        end
+
+        # @api private
+        sig { params(target: TerminalShop::Type::Converter::Input, value: T.anything).returns(T.anything) }
+        def self.dump(target, value)
+        end
+      end
+    end
+  end
+end

data/rbi/lib/terminal-shop/type/enum.rbi

@@ -0,0 +1,58 @@
+# typed: strong
+
+module TerminalShop
+  module Type
+    # @api private
+    #
+    # A value from among a specified list of options. OpenAPI enum values map to Ruby
+    #   values in the SDK as follows:
+    #
+    #   1. boolean => true | false
+    #   2. integer => Integer
+    #   3. float => Float
+    #   4. string => Symbol
+    #
+    #   We can therefore convert string values to Symbols, but can't convert other
+    #   values safely.
+    module Enum
+      include TerminalShop::Type::Converter
+
+      # All of the valid Symbol values for this enum.
+      sig { overridable.returns(T::Array[T.any(NilClass, T::Boolean, Integer, Float, Symbol)]) }
+      def values
+      end
+
+      # @api private
+      #
+      # Guard against thread safety issues by instantiating `@values`.
+      sig { void }
+      private def finalize!
+      end
+
+      sig { params(other: T.anything).returns(T::Boolean) }
+      def ===(other)
+      end
+
+      sig { params(other: T.anything).returns(T::Boolean) }
+      def ==(other)
+      end
+
+      # @api private
+      #
+      # Unlike with primitives, `Enum` additionally validates that the value is a member
+      #   of the enum.
+      sig do
+        override
+          .params(value: T.any(String, Symbol, T.anything), state: TerminalShop::Type::Converter::State)
+          .returns(T.any(Symbol, T.anything))
+      end
+      def coerce(value, state:)
+      end
+
+      # @api private
+      sig { override.params(value: T.any(Symbol, T.anything)).returns(T.any(Symbol, T.anything)) }
+      def dump(value)
+      end
+    end
+  end
+end

data/rbi/lib/terminal-shop/type/hash_of.rbi

@@ -0,0 +1,85 @@
+# typed: strong
+
+module TerminalShop
+  module Type
+    # @api private
+    #
+    # Hash of items of a given type.
+    class HashOf
+      include TerminalShop::Type::Converter
+
+      abstract!
+      final!
+
+      Elem = type_member(:out)
+
+      sig(:final) do
+        params(
+          type_info: T.any(
+            TerminalShop::Util::AnyHash,
+            T.proc.returns(TerminalShop::Type::Converter::Input),
+            TerminalShop::Type::Converter::Input
+          ),
+          spec: TerminalShop::Util::AnyHash
+        )
+          .returns(T.attached_class)
+      end
+      def self.[](type_info, spec = {})
+      end
+
+      sig(:final) { params(other: T.anything).returns(T::Boolean) }
+      def ===(other)
+      end
+
+      sig(:final) { params(other: T.anything).returns(T::Boolean) }
+      def ==(other)
+      end
+
+      # @api private
+      sig(:final) do
+        override
+          .params(
+            value: T.any(T::Hash[T.anything, T.anything], T.anything),
+            state: TerminalShop::Type::Converter::State
+          )
+          .returns(T.any(TerminalShop::Util::AnyHash, T.anything))
+      end
+      def coerce(value, state:)
+      end
+
+      # @api private
+      sig(:final) do
+        override
+          .params(value: T.any(T::Hash[T.anything, T.anything], T.anything))
+          .returns(T.any(TerminalShop::Util::AnyHash, T.anything))
+      end
+      def dump(value)
+      end
+
+      # @api private
+      sig(:final) { returns(Elem) }
+      protected def item_type
+      end
+
+      # @api private
+      sig(:final) { returns(T::Boolean) }
+      protected def nilable?
+      end
+
+      # @api private
+      sig(:final) do
+        params(
+          type_info: T.any(
+            TerminalShop::Util::AnyHash,
+            T.proc.returns(TerminalShop::Type::Converter::Input),
+            TerminalShop::Type::Converter::Input
+          ),
+          spec: TerminalShop::Util::AnyHash
+        )
+          .void
+      end
+      def initialize(type_info, spec = {})
+      end
+    end
+  end
+end

data/rbi/lib/terminal-shop/type/request_parameters.rbi

@@ -0,0 +1,20 @@
+# typed: strong
+
+module TerminalShop
+  module Type
+    # @api private
+    module RequestParameters
+      # Options to specify HTTP behaviour for this request.
+      sig { returns(T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash)) }
+      attr_accessor :request_options
+
+      # @api private
+      module Converter
+        # @api private
+        sig { params(params: T.anything).returns([T.anything, TerminalShop::Util::AnyHash]) }
+        def dump_request(params)
+        end
+      end
+    end
+  end
+end

data/rbi/lib/terminal-shop/type/union.rbi

@@ -0,0 +1,68 @@
+# typed: strong
+
+module TerminalShop
+  module Type
+    # @api private
+    module Union
+      include TerminalShop::Type::Converter
+
+      # @api private
+      #
+      # All of the specified variant info for this union.
+      sig { returns(T::Array[[T.nilable(Symbol), T.proc.returns(TerminalShop::Type::Converter::Input)]]) }
+      private def known_variants
+      end
+
+      # @api private
+      sig { returns(T::Array[[T.nilable(Symbol), T.anything]]) }
+      protected def derefed_variants
+      end
+
+      # All of the specified variants for this union.
+      sig { overridable.returns(T::Array[T.anything]) }
+      def variants
+      end
+
+      # @api private
+      sig { params(property: Symbol).void }
+      private def discriminator(property)
+      end
+
+      # @api private
+      sig do
+        params(
+          key: T.any(Symbol, TerminalShop::Util::AnyHash, T.proc.returns(T.anything), T.anything),
+          spec: T.any(TerminalShop::Util::AnyHash, T.proc.returns(T.anything), T.anything)
+        )
+          .void
+      end
+      private def variant(key, spec = nil)
+      end
+
+      # @api private
+      sig { params(value: T.anything).returns(T.nilable(T.anything)) }
+      private def resolve_variant(value)
+      end
+
+      sig { params(other: T.anything).returns(T::Boolean) }
+      def ===(other)
+      end
+
+      sig { params(other: T.anything).returns(T::Boolean) }
+      def ==(other)
+      end
+
+      # @api private
+      sig do
+        override.params(value: T.anything, state: TerminalShop::Type::Converter::State).returns(T.anything)
+      end
+      def coerce(value, state:)
+      end
+
+      # @api private
+      sig { override.params(value: T.anything).returns(T.anything) }
+      def dump(value)
+      end
+    end
+  end
+end

data/rbi/lib/terminal-shop/type/unknown.rbi

@@ -0,0 +1,37 @@
+# typed: strong
+
+module TerminalShop
+  module Type
+    # @api private
+    #
+    # When we don't know what to expect for the value.
+    class Unknown
+      extend TerminalShop::Type::Converter
+
+      abstract!
+      final!
+
+      sig(:final) { params(other: T.anything).returns(T::Boolean) }
+      def self.===(other)
+      end
+
+      sig(:final) { params(other: T.anything).returns(T::Boolean) }
+      def self.==(other)
+      end
+
+      class << self
+        # @api private
+        sig(:final) do
+          override.params(value: T.anything, state: TerminalShop::Type::Converter::State).returns(T.anything)
+        end
+        def coerce(value, state:)
+        end
+
+        # @api private
+        sig(:final) { override.params(value: T.anything).returns(T.anything) }
+        def dump(value)
+        end
+      end
+    end
+  end
+end

data/rbi/lib/terminal-shop/type.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+module TerminalShop
+  Unknown = TerminalShop::Type::Unknown
+
+  BooleanModel = TerminalShop::Type::BooleanModel
+
+  Enum = TerminalShop::Type::Enum
+
+  Union = TerminalShop::Type::Union
+
+  ArrayOf = TerminalShop::Type::ArrayOf
+
+  HashOf = TerminalShop::Type::HashOf
+
+  BaseModel = TerminalShop::Type::BaseModel
+
+  RequestParameters = TerminalShop::Type::RequestParameters
+
+  # This module contains various type declarations.
+  module Type
+  end
+end

data/rbi/lib/terminal-shop/version.rbi

@@ -1,5 +1,5 @@
 # typed: strong
 
 module TerminalShop
-  VERSION = "2.0.0"
+  VERSION = "2.1.0"
 end

data/sig/terminal-shop/client.rbs

@@ -1,5 +1,5 @@
 module TerminalShop
-  class Client < TerminalShop::BaseClient
+  class Client < TerminalShop::Transport::BaseClient
     DEFAULT_MAX_RETRIES: 2
 
     DEFAULT_TIMEOUT_IN_SECONDS: Float

data/sig/terminal-shop/models/address_create_params.rbs

@@ -14,7 +14,7 @@ module TerminalShop
       & TerminalShop::request_parameters
 
     class AddressCreateParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor city: String

data/sig/terminal-shop/models/address_delete_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type address_delete_params = {  } & TerminalShop::request_parameters
 
     class AddressDeleteParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/address_get_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type address_get_params = {  } & TerminalShop::request_parameters
 
     class AddressGetParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/address_list_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type address_list_params = {  } & TerminalShop::request_parameters
 
     class AddressListParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/app_create_params.rbs

@@ -4,7 +4,7 @@ module TerminalShop
       { name: String, redirect_uri: String } & TerminalShop::request_parameters
 
     class AppCreateParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor name: String

data/sig/terminal-shop/models/app_delete_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type app_delete_params = {  } & TerminalShop::request_parameters
 
     class AppDeleteParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/app_get_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type app_get_params = {  } & TerminalShop::request_parameters
 
     class AppGetParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/app_list_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type app_list_params = {  } & TerminalShop::request_parameters
 
     class AppListParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/card_collect_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type card_collect_params = {  } & TerminalShop::request_parameters
 
     class CardCollectParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/card_create_params.rbs

@@ -4,7 +4,7 @@ module TerminalShop
       { token: String } & TerminalShop::request_parameters
 
     class CardCreateParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor token: String

data/sig/terminal-shop/models/card_delete_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type card_delete_params = {  } & TerminalShop::request_parameters
 
     class CardDeleteParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/card_get_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type card_get_params = {  } & TerminalShop::request_parameters
 
     class CardGetParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/card_list_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type card_list_params = {  } & TerminalShop::request_parameters
 
     class CardListParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/cart_clear_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type cart_clear_params = {  } & TerminalShop::request_parameters
 
     class CartClearParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/cart_convert_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type cart_convert_params = {  } & TerminalShop::request_parameters
 
     class CartConvertParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/cart_get_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type cart_get_params = {  } & TerminalShop::request_parameters
 
     class CartGetParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/cart_set_address_params.rbs

@@ -4,7 +4,7 @@ module TerminalShop
       { address_id: String } & TerminalShop::request_parameters
 
     class CartSetAddressParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor address_id: String

data/sig/terminal-shop/models/cart_set_card_params.rbs

@@ -4,7 +4,7 @@ module TerminalShop
       { card_id: String } & TerminalShop::request_parameters
 
     class CartSetCardParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor card_id: String

data/sig/terminal-shop/models/cart_set_item_params.rbs

@@ -5,7 +5,7 @@ module TerminalShop
       & TerminalShop::request_parameters
 
     class CartSetItemParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor product_variant_id: String

data/sig/terminal-shop/models/email_create_params.rbs

@@ -4,7 +4,7 @@ module TerminalShop
       { email: String } & TerminalShop::request_parameters
 
     class EmailCreateParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor email: String

data/sig/terminal-shop/models/order_create_params.rbs

@@ -5,7 +5,7 @@ module TerminalShop
       & TerminalShop::request_parameters
 
     class OrderCreateParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       attr_accessor address_id: String

data/sig/terminal-shop/models/order_get_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type order_get_params = {  } & TerminalShop::request_parameters
 
     class OrderGetParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/order_list_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type order_list_params = {  } & TerminalShop::request_parameters
 
     class OrderListParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/product_get_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type product_get_params = {  } & TerminalShop::request_parameters
 
     class ProductGetParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void

data/sig/terminal-shop/models/product_list_params.rbs

@@ -3,7 +3,7 @@ module TerminalShop
     type product_list_params = {  } & TerminalShop::request_parameters
 
     class ProductListParams < TerminalShop::BaseModel
-      extend TerminalShop::RequestParameters::Converter
+      extend TerminalShop::Type::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
       def initialize: (?request_options: TerminalShop::request_opts) -> void