terminal-shop 1.7.0 → 2.0.0

data/rbi/lib/terminal-shop/models/subscription_create_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/subscription_create_response.rbi

@@ -4,12 +4,7 @@ module TerminalShop
   module Models
     class SubscriptionCreateResponse < TerminalShop::BaseModel
       sig { returns(Symbol) }
-      def data
-      end
-
-      sig { params(_: Symbol).returns(Symbol) }
-      def data=(_)
-      end
+      attr_accessor :data
 
       sig { params(data: Symbol).returns(T.attached_class) }
       def self.new(data: :ok)

data/rbi/lib/terminal-shop/models/subscription_delete_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/subscription_delete_response.rbi

@@ -4,12 +4,7 @@ module TerminalShop
   module Models
     class SubscriptionDeleteResponse < TerminalShop::BaseModel
       sig { returns(Symbol) }
-      def data
-      end
-
-      sig { params(_: Symbol).returns(Symbol) }
-      def data=(_)
-      end
+      attr_accessor :data
 
       sig { params(data: Symbol).returns(T.attached_class) }
       def self.new(data: :ok)

data/rbi/lib/terminal-shop/models/subscription_get_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/subscription_get_response.rbi

@@ -3,15 +3,17 @@
 module TerminalShop
   module Models
     class SubscriptionGetResponse < TerminalShop::BaseModel
+      # Subscription to a Terminal shop product.
       sig { returns(TerminalShop::Models::SubscriptionAPI) }
-      def data
-      end
+      attr_reader :data
 
-      sig { params(_: TerminalShop::Models::SubscriptionAPI).returns(TerminalShop::Models::SubscriptionAPI) }
-      def data=(_)
-      end
+      sig { params(data: T.any(TerminalShop::Models::SubscriptionAPI, TerminalShop::Util::AnyHash)).void }
+      attr_writer :data
 
-      sig { params(data: TerminalShop::Models::SubscriptionAPI).returns(T.attached_class) }
+      sig do
+        params(data: T.any(TerminalShop::Models::SubscriptionAPI, TerminalShop::Util::AnyHash))
+          .returns(T.attached_class)
+      end
       def self.new(data:)
       end
 

data/rbi/lib/terminal-shop/models/subscription_list_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/subscription_list_response.rbi

@@ -3,18 +3,14 @@
 module TerminalShop
   module Models
     class SubscriptionListResponse < TerminalShop::BaseModel
+      # List of subscriptions.
       sig { returns(T::Array[TerminalShop::Models::SubscriptionAPI]) }
-      def data
-      end
+      attr_accessor :data
 
       sig do
-        params(_: T::Array[TerminalShop::Models::SubscriptionAPI])
-          .returns(T::Array[TerminalShop::Models::SubscriptionAPI])
-      end
-      def data=(_)
+        params(data: T::Array[T.any(TerminalShop::Models::SubscriptionAPI, TerminalShop::Util::AnyHash)])
+          .returns(T.attached_class)
       end
-
-      sig { params(data: T::Array[TerminalShop::Models::SubscriptionAPI]).returns(T.attached_class) }
       def self.new(data:)
       end
 

data/rbi/lib/terminal-shop/models/token.rbi

@@ -3,30 +3,20 @@
 module TerminalShop
   module Models
     class TokenAPI < TerminalShop::BaseModel
+      # Unique object identifier. The format and length of IDs may change over time.
       sig { returns(String) }
-      def id
-      end
-
-      sig { params(_: String).returns(String) }
-      def id=(_)
-      end
+      attr_accessor :id
 
+      # Personal access token (obfuscated).
       sig { returns(String) }
-      def token
-      end
-
-      sig { params(_: String).returns(String) }
-      def token=(_)
-      end
+      attr_accessor :token
 
+      # The created time for the token.
       sig { returns(String) }
-      def created
-      end
-
-      sig { params(_: String).returns(String) }
-      def created=(_)
-      end
+      attr_accessor :created
 
+      # A personal access token used to access the Terminal API. If you leak this,
+      #   expect large sums of coffee to be ordered on your credit card.
       sig { params(id: String, token: String, created: String).returns(T.attached_class) }
       def self.new(id:, token:, created:)
       end

data/rbi/lib/terminal-shop/models/token_create_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/token_create_response.rbi

@@ -4,17 +4,15 @@ module TerminalShop
   module Models
     class TokenCreateResponse < TerminalShop::BaseModel
       sig { returns(TerminalShop::Models::TokenCreateResponse::Data) }
-      def data
-      end
+      attr_reader :data
+
+      sig { params(data: T.any(TerminalShop::Models::TokenCreateResponse::Data, TerminalShop::Util::AnyHash)).void }
+      attr_writer :data
 
       sig do
-        params(_: TerminalShop::Models::TokenCreateResponse::Data)
-          .returns(TerminalShop::Models::TokenCreateResponse::Data)
-      end
-      def data=(_)
+        params(data: T.any(TerminalShop::Models::TokenCreateResponse::Data, TerminalShop::Util::AnyHash))
+          .returns(T.attached_class)
       end
-
-      sig { params(data: TerminalShop::Models::TokenCreateResponse::Data).returns(T.attached_class) }
       def self.new(data:)
       end
 
@@ -23,21 +21,14 @@ module TerminalShop
       end
 
       class Data < TerminalShop::BaseModel
+        # Personal token ID.
         sig { returns(String) }
-        def id
-        end
-
-        sig { params(_: String).returns(String) }
-        def id=(_)
-        end
+        attr_accessor :id
 
+        # Personal access token. Include this in the Authorization header
+        #   (`Bearer <token>`) when accessing the Terminal API.
         sig { returns(String) }
-        def token
-        end
-
-        sig { params(_: String).returns(String) }
-        def token=(_)
-        end
+        attr_accessor :token
 
         sig { params(id: String, token: String).returns(T.attached_class) }
         def self.new(id:, token:)

data/rbi/lib/terminal-shop/models/token_delete_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/token_delete_response.rbi

@@ -4,12 +4,7 @@ module TerminalShop
   module Models
     class TokenDeleteResponse < TerminalShop::BaseModel
       sig { returns(Symbol) }
-      def data
-      end
-
-      sig { params(_: Symbol).returns(Symbol) }
-      def data=(_)
-      end
+      attr_accessor :data
 
       sig { params(data: Symbol).returns(T.attached_class) }
       def self.new(data: :ok)

data/rbi/lib/terminal-shop/models/token_get_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/token_get_response.rbi

@@ -3,15 +3,15 @@
 module TerminalShop
   module Models
     class TokenGetResponse < TerminalShop::BaseModel
+      # A personal access token used to access the Terminal API. If you leak this,
+      #   expect large sums of coffee to be ordered on your credit card.
       sig { returns(TerminalShop::Models::TokenAPI) }
-      def data
-      end
+      attr_reader :data
 
-      sig { params(_: TerminalShop::Models::TokenAPI).returns(TerminalShop::Models::TokenAPI) }
-      def data=(_)
-      end
+      sig { params(data: T.any(TerminalShop::Models::TokenAPI, TerminalShop::Util::AnyHash)).void }
+      attr_writer :data
 
-      sig { params(data: TerminalShop::Models::TokenAPI).returns(T.attached_class) }
+      sig { params(data: T.any(TerminalShop::Models::TokenAPI, TerminalShop::Util::AnyHash)).returns(T.attached_class) }
       def self.new(data:)
       end
 

data/rbi/lib/terminal-shop/models/token_list_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/token_list_response.rbi

@@ -3,15 +3,14 @@
 module TerminalShop
   module Models
     class TokenListResponse < TerminalShop::BaseModel
+      # List of personal access tokens.
       sig { returns(T::Array[TerminalShop::Models::TokenAPI]) }
-      def data
-      end
+      attr_accessor :data
 
-      sig { params(_: T::Array[TerminalShop::Models::TokenAPI]).returns(T::Array[TerminalShop::Models::TokenAPI]) }
-      def data=(_)
+      sig do
+        params(data: T::Array[T.any(TerminalShop::Models::TokenAPI, TerminalShop::Util::AnyHash)])
+          .returns(T.attached_class)
       end
-
-      sig { params(data: T::Array[TerminalShop::Models::TokenAPI]).returns(T.attached_class) }
       def self.new(data:)
       end
 

data/rbi/lib/terminal-shop/models/view_init_params.rbi

@@ -7,7 +7,7 @@ module TerminalShop
       include TerminalShop::RequestParameters
 
       sig do
-        params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
+        params(request_options: T.any(TerminalShop::RequestOptions, TerminalShop::Util::AnyHash))
           .returns(T.attached_class)
       end
       def self.new(request_options: {})

data/rbi/lib/terminal-shop/models/view_init_response.rbi

@@ -3,18 +3,17 @@
 module TerminalShop
   module Models
     class ViewInitResponse < TerminalShop::BaseModel
+      # Initial app data.
       sig { returns(TerminalShop::Models::ViewInitResponse::Data) }
-      def data
-      end
+      attr_reader :data
+
+      sig { params(data: T.any(TerminalShop::Models::ViewInitResponse::Data, TerminalShop::Util::AnyHash)).void }
+      attr_writer :data
 
       sig do
-        params(_: TerminalShop::Models::ViewInitResponse::Data)
-          .returns(TerminalShop::Models::ViewInitResponse::Data)
-      end
-      def data=(_)
+        params(data: T.any(TerminalShop::Models::ViewInitResponse::Data, TerminalShop::Util::AnyHash))
+          .returns(T.attached_class)
       end
-
-      sig { params(data: TerminalShop::Models::ViewInitResponse::Data).returns(T.attached_class) }
       def self.new(data:)
       end
 
@@ -24,100 +23,57 @@ module TerminalShop
 
       class Data < TerminalShop::BaseModel
         sig { returns(T::Array[TerminalShop::Models::AddressAPI]) }
-        def addresses
-        end
-
-        sig { params(_: T::Array[TerminalShop::Models::AddressAPI]).returns(T::Array[TerminalShop::Models::AddressAPI]) }
-        def addresses=(_)
-        end
+        attr_accessor :addresses
 
         sig { returns(T::Array[TerminalShop::Models::AppAPI]) }
-        def apps
-        end
-
-        sig { params(_: T::Array[TerminalShop::Models::AppAPI]).returns(T::Array[TerminalShop::Models::AppAPI]) }
-        def apps=(_)
-        end
+        attr_accessor :apps
 
         sig { returns(T::Array[TerminalShop::Models::CardAPI]) }
-        def cards
-        end
-
-        sig { params(_: T::Array[TerminalShop::Models::CardAPI]).returns(T::Array[TerminalShop::Models::CardAPI]) }
-        def cards=(_)
-        end
+        attr_accessor :cards
 
+        # The current Terminal shop user's cart.
         sig { returns(TerminalShop::Models::CartAPI) }
-        def cart
-        end
+        attr_reader :cart
 
-        sig { params(_: TerminalShop::Models::CartAPI).returns(TerminalShop::Models::CartAPI) }
-        def cart=(_)
-        end
+        sig { params(cart: T.any(TerminalShop::Models::CartAPI, TerminalShop::Util::AnyHash)).void }
+        attr_writer :cart
 
         sig { returns(T::Array[TerminalShop::Models::OrderAPI]) }
-        def orders
-        end
-
-        sig { params(_: T::Array[TerminalShop::Models::OrderAPI]).returns(T::Array[TerminalShop::Models::OrderAPI]) }
-        def orders=(_)
-        end
+        attr_accessor :orders
 
         sig { returns(T::Array[TerminalShop::Models::ProductAPI]) }
-        def products
-        end
-
-        sig { params(_: T::Array[TerminalShop::Models::ProductAPI]).returns(T::Array[TerminalShop::Models::ProductAPI]) }
-        def products=(_)
-        end
+        attr_accessor :products
 
+        # A Terminal shop user's profile. (We have users, btw.)
         sig { returns(TerminalShop::Models::ProfileAPI) }
-        def profile
-        end
+        attr_reader :profile
 
-        sig { params(_: TerminalShop::Models::ProfileAPI).returns(TerminalShop::Models::ProfileAPI) }
-        def profile=(_)
-        end
-
-        sig { returns(Symbol) }
-        def region
-        end
+        sig { params(profile: T.any(TerminalShop::Models::ProfileAPI, TerminalShop::Util::AnyHash)).void }
+        attr_writer :profile
 
-        sig { params(_: Symbol).returns(Symbol) }
-        def region=(_)
-        end
+        # A Terminal shop user's region.
+        sig { returns(TerminalShop::Models::Region::TaggedSymbol) }
+        attr_accessor :region
 
         sig { returns(T::Array[TerminalShop::Models::SubscriptionAPI]) }
-        def subscriptions
-        end
-
-        sig do
-          params(_: T::Array[TerminalShop::Models::SubscriptionAPI])
-            .returns(T::Array[TerminalShop::Models::SubscriptionAPI])
-        end
-        def subscriptions=(_)
-        end
+        attr_accessor :subscriptions
 
         sig { returns(T::Array[TerminalShop::Models::TokenAPI]) }
-        def tokens
-        end
-
-        sig { params(_: T::Array[TerminalShop::Models::TokenAPI]).returns(T::Array[TerminalShop::Models::TokenAPI]) }
-        def tokens=(_)
-        end
+        attr_accessor :tokens
 
+        # Initial app data.
         sig do
           params(
-            addresses: T::Array[TerminalShop::Models::AddressAPI],
-            apps: T::Array[TerminalShop::Models::AppAPI],
-            cards: T::Array[TerminalShop::Models::CardAPI],
-            cart: TerminalShop::Models::CartAPI,
-            orders: T::Array[TerminalShop::Models::OrderAPI],
-            products: T::Array[TerminalShop::Models::ProductAPI],
-            profile: TerminalShop::Models::ProfileAPI,
-            region: Symbol,
-            subscriptions: T::Array[TerminalShop::Models::SubscriptionAPI],
-            tokens: T::Array[TerminalShop::Models::TokenAPI]
+            addresses: T::Array[T.any(TerminalShop::Models::AddressAPI, TerminalShop::Util::AnyHash)],
+            apps: T::Array[T.any(TerminalShop::Models::AppAPI, TerminalShop::Util::AnyHash)],
+            cards: T::Array[T.any(TerminalShop::Models::CardAPI, TerminalShop::Util::AnyHash)],
+            cart: T.any(TerminalShop::Models::CartAPI, TerminalShop::Util::AnyHash),
+            orders: T::Array[T.any(TerminalShop::Models::OrderAPI, TerminalShop::Util::AnyHash)],
+            products: T::Array[T.any(TerminalShop::Models::ProductAPI, TerminalShop::Util::AnyHash)],
+            profile: T.any(TerminalShop::Models::ProfileAPI, TerminalShop::Util::AnyHash),
+            region: TerminalShop::Models::Region::OrSymbol,
+            subscriptions: T::Array[T.any(TerminalShop::Models::SubscriptionAPI, TerminalShop::Util::AnyHash)],
+            tokens: T::Array[T.any(TerminalShop::Models::TokenAPI, TerminalShop::Util::AnyHash)]
           )
             .returns(T.attached_class)
         end
@@ -135,7 +91,7 @@ module TerminalShop
                 orders: T::Array[TerminalShop::Models::OrderAPI],
                 products: T::Array[TerminalShop::Models::ProductAPI],
                 profile: TerminalShop::Models::ProfileAPI,
-                region: Symbol,
+                region: TerminalShop::Models::Region::TaggedSymbol,
                 subscriptions: T::Array[TerminalShop::Models::SubscriptionAPI],
                 tokens: T::Array[TerminalShop::Models::TokenAPI]
               }

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

@@ -1,20 +1,35 @@
 # typed: strong
 
 module TerminalShop
+  # @api private
   class PooledNetRequester
-    RequestShape = T.type_alias do
-      {method: Symbol, url: URI::Generic, headers: T::Hash[String, String], body: T.anything, deadline: Float}
-    end
+    RequestShape =
+      T.type_alias do
+        {
+          method: Symbol,
+          url: URI::Generic,
+          headers: T::Hash[String, String],
+          body: T.anything,
+          deadline: Float
+        }
+      end
+
+    # from the golang stdlib
+    #   https://github.com/golang/go/blob/c8eced8580028328fde7c03cbfcb720ce15b2358/src/net/http/transport.go#L49
+    KEEP_ALIVE_TIMEOUT = 30
 
     class << self
+      # @api private
       sig { params(url: URI::Generic).returns(Net::HTTP) }
       def connect(url)
       end
 
+      # @api private
       sig { params(conn: Net::HTTP, deadline: Float).void }
       def calibrate_socket_timeout(conn, deadline)
       end
 
+      # @api private
       sig do
         params(request: TerminalShop::PooledNetRequester::RequestShape, blk: T.proc.params(arg0: String).void)
           .returns(Net::HTTPGenericRequest)
@@ -23,17 +38,20 @@ module TerminalShop
       end
     end
 
-    sig { params(url: URI::Generic, blk: T.proc.params(arg0: Net::HTTP).void).void }
-    private def with_pool(url, &blk)
+    # @api private
+    sig { params(url: URI::Generic, deadline: Float, blk: T.proc.params(arg0: Net::HTTP).void).void }
+    private def with_pool(url, deadline:, &blk)
     end
 
+    # @api private
     sig do
       params(request: TerminalShop::PooledNetRequester::RequestShape)
-        .returns([Net::HTTPResponse, T::Enumerable[String]])
+        .returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
     end
     def execute(request)
     end
 
+    # @api private
     sig { params(size: Integer).returns(T.attached_class) }
     def self.new(size: Etc.nprocessors)
     end

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

@@ -1,87 +1,62 @@
 # typed: strong
 
 module TerminalShop
+  # @api private
   module RequestParameters
-    abstract!
-
-    sig { returns(T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything])) }
-    def request_options
-    end
-
-    sig do
-      params(_: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
-        .returns(T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
-    end
-    def request_options=(_)
-    end
+    # 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
-      sig { params(params: T.anything).returns([T.anything, T::Hash[Symbol, T.anything]]) }
+      # @api private
+      sig { params(params: T.anything).returns([T.anything, TerminalShop::Util::AnyHash]) }
       def dump_request(params)
       end
     end
   end
 
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  #   or override those provided at the client level.
+  #
+  #   When making a request, you can pass an actual {RequestOptions} instance, or
+  #   simply pass a Hash with symbol keys matching the attributes on this class.
   class RequestOptions < TerminalShop::BaseModel
+    # @api private
     sig { params(opts: T.any(T.self_type, T::Hash[Symbol, T.anything])).void }
     def self.validate!(opts)
     end
 
+    # Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
     sig { returns(T.nilable(String)) }
-    def idempotency_key
-    end
-
-    sig { params(_: T.nilable(String)).returns(T.nilable(String)) }
-    def idempotency_key=(_)
-    end
+    attr_accessor :idempotency_key
 
+    # Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
     sig { returns(T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))])) }
-    def extra_query
-    end
-
-    sig do
-      params(_: T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]))
-        .returns(T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]))
-    end
-    def extra_query=(_)
-    end
+    attr_accessor :extra_query
 
+    # Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
     sig { returns(T.nilable(T::Hash[String, T.nilable(String)])) }
-    def extra_headers
-    end
+    attr_accessor :extra_headers
 
-    sig do
-      params(_: T.nilable(T::Hash[String, T.nilable(String)]))
-        .returns(T.nilable(T::Hash[String, T.nilable(String)]))
-    end
-    def extra_headers=(_)
-    end
-
-    sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
-    def extra_body
-    end
-
-    sig { params(_: T.nilable(T::Hash[Symbol, T.anything])).returns(T.nilable(T::Hash[Symbol, T.anything])) }
-    def extra_body=(_)
-    end
+    # Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    sig { returns(T.nilable(T.anything)) }
+    attr_accessor :extra_body
 
+    # Maximum number of retries to attempt after a failed initial request.
     sig { returns(T.nilable(Integer)) }
-    def max_retries
-    end
-
-    sig { params(_: T.nilable(Integer)).returns(T.nilable(Integer)) }
-    def max_retries=(_)
-    end
+    attr_accessor :max_retries
 
+    # Request timeout in seconds.
     sig { returns(T.nilable(Float)) }
-    def timeout
-    end
-
-    sig { params(_: T.nilable(Float)).returns(T.nilable(Float)) }
-    def timeout=(_)
-    end
+    attr_accessor :timeout
 
-    sig { params(values: T::Hash[Symbol, T.anything]).returns(T.attached_class) }
+    # Returns a new instance of RequestOptions.
+    sig { params(values: TerminalShop::Util::AnyHash).returns(T.attached_class) }
     def self.new(values = {})
     end
   end