terminal-shop 0.1.0.pre.alpha.14 → 1.0.0

data/lib/terminal-shop/pooled_net_requester.rb

@@ -131,16 +131,23 @@ module TerminalShop
       req = self.class.build_request(request)
 
       eof = false
+      finished = false
       enum = Enumerator.new do |y|
         with_pool(url) do |conn|
+          next if finished
+
           self.class.calibrate_socket_timeout(conn, deadline)
           conn.start unless conn.started?
 
           self.class.calibrate_socket_timeout(conn, deadline)
           conn.request(req) do |rsp|
             y << [conn, rsp]
+            break if finished
+
             rsp.read_body do |bytes|
               y << bytes
+              break if finished
+
               self.class.calibrate_socket_timeout(conn, deadline)
             end
             eof = true
@@ -148,16 +155,14 @@ module TerminalShop
         end
       end
 
-      # need to protect the `Enumerator` against `#.rewind`
-      fused = false
       conn, response = enum.next
-      body = Enumerator.new do |y|
-        next if fused
-
-        fused = true
-        loop { y << enum.next }
-      ensure
-        conn.finish if !eof && conn.started?
+      body = TerminalShop::Util.fused_enum(enum) do
+        finished = true
+        tap do
+          enum.next
+        rescue StopIteration
+        end
+        conn.finish if !eof && conn&.started?
       end
       [response, (response.body = body)]
     end

data/lib/terminal-shop/resources/address.rb

@@ -74,6 +74,25 @@ module TerminalShop
         )
       end
 
+      # Get the shipping address with the given ID.
+      #
+      # @param id [String] ID of the shipping address to get.
+      #
+      # @param params [TerminalShop::Models::AddressGetParams, Hash{Symbol=>Object}] .
+      #
+      #   @option params [TerminalShop::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      #
+      # @return [TerminalShop::Models::AddressGetResponse]
+      #
+      def get(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["address/%0s", id],
+          model: TerminalShop::Models::AddressGetResponse,
+          options: params[:request_options]
+        )
+      end
+
       # @param client [TerminalShop::Client]
       #
       def initialize(client:)

data/lib/terminal-shop/resources/app.rb

@@ -7,13 +7,9 @@ module TerminalShop
       #
       # @param params [TerminalShop::Models::AppCreateParams, Hash{Symbol=>Object}] .
       #
-      #   @option params [String] :id Unique object identifier. The format and length of IDs may change over time.
+      #   @option params [String] :name
       #
-      #   @option params [String] :name Name of the app.
-      #
-      #   @option params [String] :redirect_uri Redirect URI of the app.
-      #
-      #   @option params [String] :secret OAuth 2.0 client secret of the app (obfuscated).
+      #   @option params [String] :redirect_uri
       #
       #   @option params [TerminalShop::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
       #

data/lib/terminal-shop/resources/card.rb

@@ -79,6 +79,25 @@ module TerminalShop
         )
       end
 
+      # Get a credit card by ID associated with the current user.
+      #
+      # @param id [String] ID of the card to get.
+      #
+      # @param params [TerminalShop::Models::CardGetParams, Hash{Symbol=>Object}] .
+      #
+      #   @option params [TerminalShop::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      #
+      # @return [TerminalShop::Models::CardGetResponse]
+      #
+      def get(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["card/%0s", id],
+          model: TerminalShop::Models::CardGetResponse,
+          options: params[:request_options]
+        )
+      end
+
       # @param client [TerminalShop::Client]
       #
       def initialize(client:)

data/lib/terminal-shop/resources/product.rb

@@ -20,6 +20,25 @@ module TerminalShop
         )
       end
 
+      # Get a product by ID from the Terminal shop.
+      #
+      # @param id [String] ID of the product to get.
+      #
+      # @param params [TerminalShop::Models::ProductGetParams, Hash{Symbol=>Object}] .
+      #
+      #   @option params [TerminalShop::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      #
+      # @return [TerminalShop::Models::ProductGetResponse]
+      #
+      def get(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["product/%0s", id],
+          model: TerminalShop::Models::ProductGetResponse,
+          options: params[:request_options]
+        )
+      end
+
       # @param client [TerminalShop::Client]
       #
       def initialize(client:)

data/lib/terminal-shop/resources/profile.rb

@@ -7,15 +7,15 @@ module TerminalShop
       #
       # @param params [TerminalShop::Models::ProfileUpdateParams, Hash{Symbol=>Object}] .
       #
-      #   @option params [String, nil] :email Email address of the user.
+      #   @option params [String] :email
       #
-      #   @option params [String, nil] :name Name of the user.
+      #   @option params [String] :name
       #
       #   @option params [TerminalShop::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
       #
       # @return [TerminalShop::Models::ProfileUpdateResponse]
       #
-      def update(params = {})
+      def update(params)
         parsed, options = TerminalShop::Models::ProfileUpdateParams.dump_request(params)
         @client.request(
           method: :put,

data/lib/terminal-shop/resources/subscription.rb

@@ -72,6 +72,25 @@ module TerminalShop
         )
       end
 
+      # Get the subscription with the given ID.
+      #
+      # @param id [String] ID of the subscription to get.
+      #
+      # @param params [TerminalShop::Models::SubscriptionGetParams, Hash{Symbol=>Object}] .
+      #
+      #   @option params [TerminalShop::RequestOptions, Hash{Symbol=>Object}, nil] :request_options
+      #
+      # @return [TerminalShop::Models::SubscriptionGetResponse]
+      #
+      def get(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["subscription/%0s", id],
+          model: TerminalShop::Models::SubscriptionGetResponse,
+          options: params[:request_options]
+        )
+      end
+
       # @param client [TerminalShop::Client]
       #
       def initialize(client:)

data/lib/terminal-shop/util.rb

@@ -382,13 +382,19 @@ module TerminalShop
     class << self
       # @private
       #
-      # @param headers [Array<Hash{String=>String, Integer, nil}>]
+      # @param headers [Hash{String=>String, Integer, Array<String, Integer, nil>, nil}]
       #
       # @return [Hash{String=>String}]
       #
       def normalized_headers(*headers)
         {}.merge(*headers.compact).to_h do |key, val|
-          [key.downcase, val&.to_s&.strip]
+          case val
+          in Array
+            val.map { _1.to_s.strip }.join(", ")
+          else
+            val&.to_s&.strip
+          end
+          [key.downcase, val]
         end
       end
     end
@@ -490,7 +496,7 @@ module TerminalShop
       #
       def decode_content(headers, stream:, suppress_error: false)
         case headers["content-type"]
-        in %r{^application/json}
+        in %r{^application/(?:vnd\.api\+)?json}
           json = stream.to_a.join
           begin
             JSON.parse(json, symbolize_names: true)
@@ -498,6 +504,11 @@ module TerminalShop
             raise e unless suppress_error
             json
           end
+        in %r{^text/event-stream}
+          lines = enum_lines(stream)
+          parse_sse(lines)
+        in %r{^application/(?:x-)?jsonl}
+          enum_lines(stream)
         in %r{^text/}
           stream.to_a.join
         else
@@ -506,6 +517,135 @@ module TerminalShop
         end
       end
     end
+
+    class << self
+      # @private
+      #
+      # https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
+      #
+      # @param enum [Enumerable]
+      # @param close [Proc]
+      #
+      # @return [Enumerable]
+      #
+      def fused_enum(enum, &close)
+        fused = false
+        iter = Enumerator.new do |y|
+          next if fused
+
+          fused = true
+          loop { y << enum.next }
+        ensure
+          close&.call
+          close = nil
+        end
+
+        iter.define_singleton_method(:rewind) do
+          fused = true
+          self
+        end
+        iter
+      end
+
+      # @private
+      #
+      # @param enum [Enumerable, nil]
+      #
+      def close_fused!(enum)
+        return unless enum.is_a?(Enumerator)
+
+        # rubocop:disable Lint/UnreachableLoop
+        enum.rewind.each { break }
+        # rubocop:enable Lint/UnreachableLoop
+      end
+
+      # @private
+      #
+      # @param enum [Enumerable, nil]
+      # @param blk [Proc]
+      #
+      def chain_fused(enum, &blk)
+        iter = Enumerator.new { blk.call(_1) }
+        fused_enum(iter) { close_fused!(enum) }
+      end
+    end
+
+    class << self
+      # @private
+      #
+      # @param enum [Enumerable]
+      #
+      # @return [Enumerable]
+      #
+      def decode_lines(enum)
+        re = /(\r\n|\r|\n)/
+        buffer = String.new.b
+        cr_seen = nil
+
+        chain_fused(enum) do |y|
+          enum.each do |row|
+            buffer << row
+            while (match = re.match(buffer, cr_seen.to_i))
+              case [match.captures.first, cr_seen]
+              in ["\r", nil]
+                cr_seen = match.end(1)
+                next
+              in ["\r" | "\r\n", Integer]
+                y << buffer.slice!(..(cr_seen.pred))
+              else
+                y << buffer.slice!(..(match.end(1).pred))
+              end
+              cr_seen = nil
+            end
+          end
+
+          y << buffer.slice!(..(cr_seen.pred)) unless cr_seen.nil?
+          y << buffer unless buffer.empty?
+        end
+      end
+
+      # @private
+      #
+      # https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
+      #
+      # @param lines [Enumerable]
+      #
+      # @return [Hash{Symbol=>Object}]
+      #
+      def decode_sse(lines)
+        chain_fused(lines) do |y|
+          blank = {event: nil, data: nil, id: nil, retry: nil}
+          current = {}
+
+          lines.each do |line|
+            case line.sub(/\R$/, "")
+            in ""
+              next if current.empty?
+              y << {**blank, **current}
+              current = {}
+            in /^:/
+              next
+            in /^([^:]+):\s?(.*)$/
+              field, value = Regexp.last_match.captures
+              case field
+              in "event"
+                current.merge!(event: value)
+              in "data"
+                (current[:data] ||= String.new.b) << value << "\n"
+              in "id" unless value.include?("\0")
+                current.merge!(id: value)
+              in "retry" if /^\d+$/ =~ value
+                current.merge!(retry: Integer(value))
+              else
+              end
+            else
+            end
+          end
+
+          y << {**blank, **current} unless current.empty?
+        end
+      end
+    end
   end
 
   # rubocop:enable Metrics/ModuleLength

data/lib/terminal-shop/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TerminalShop
-  VERSION = "0.1.0-alpha.14"
+  VERSION = "1.0.0"
 end

data/lib/terminal-shop.rb

@@ -28,15 +28,17 @@ require_relative "terminal-shop/errors"
 require_relative "terminal-shop/base_client"
 require_relative "terminal-shop/pooled_net_requester"
 require_relative "terminal-shop/client"
-require_relative "terminal-shop/models/app"
 require_relative "terminal-shop/models/subscription"
 require_relative "terminal-shop/models/address"
 require_relative "terminal-shop/models/address_create_params"
 require_relative "terminal-shop/models/address_create_response"
 require_relative "terminal-shop/models/address_delete_params"
 require_relative "terminal-shop/models/address_delete_response"
+require_relative "terminal-shop/models/address_get_params"
+require_relative "terminal-shop/models/address_get_response"
 require_relative "terminal-shop/models/address_list_params"
 require_relative "terminal-shop/models/address_list_response"
+require_relative "terminal-shop/models/app"
 require_relative "terminal-shop/models/app_create_params"
 require_relative "terminal-shop/models/app_create_response"
 require_relative "terminal-shop/models/app_delete_params"
@@ -52,6 +54,8 @@ require_relative "terminal-shop/models/card_create_params"
 require_relative "terminal-shop/models/card_create_response"
 require_relative "terminal-shop/models/card_delete_params"
 require_relative "terminal-shop/models/card_delete_response"
+require_relative "terminal-shop/models/card_get_params"
+require_relative "terminal-shop/models/card_get_response"
 require_relative "terminal-shop/models/card_list_params"
 require_relative "terminal-shop/models/card_list_response"
 require_relative "terminal-shop/models/cart"
@@ -75,6 +79,8 @@ require_relative "terminal-shop/models/order_get_response"
 require_relative "terminal-shop/models/order_list_params"
 require_relative "terminal-shop/models/order_list_response"
 require_relative "terminal-shop/models/product"
+require_relative "terminal-shop/models/product_get_params"
+require_relative "terminal-shop/models/product_get_response"
 require_relative "terminal-shop/models/product_list_params"
 require_relative "terminal-shop/models/product_list_response"
 require_relative "terminal-shop/models/product_variant"
@@ -87,6 +93,8 @@ require_relative "terminal-shop/models/subscription_create_params"
 require_relative "terminal-shop/models/subscription_create_response"
 require_relative "terminal-shop/models/subscription_delete_params"
 require_relative "terminal-shop/models/subscription_delete_response"
+require_relative "terminal-shop/models/subscription_get_params"
+require_relative "terminal-shop/models/subscription_get_response"
 require_relative "terminal-shop/models/subscription_list_params"
 require_relative "terminal-shop/models/subscription_list_response"
 require_relative "terminal-shop/models/token"

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

@@ -9,10 +9,20 @@ module TerminalShop
         method: Symbol,
         path: T.any(String, T::Array[String]),
         query: T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]),
-        headers: T.nilable(T::Hash[String, T.nilable(String)]),
+        headers: T.nilable(
+          T::Hash[String,
+                  T.nilable(
+                    T.any(
+                      String,
+                      Integer,
+                      T::Array[T.nilable(T.any(String, Integer))]
+                    )
+                  )]
+        ),
         body: T.nilable(T.anything),
         unwrap: T.nilable(Symbol),
-        page: T.nilable(T::Class[TerminalShop::BaseModel]),
+        page: T.nilable(T::Class[TerminalShop::BasePage[TerminalShop::BaseModel]]),
+        stream: T.nilable(T::Class[T.anything]),
         model: T.nilable(TerminalShop::Converter::Input),
         options: T.nilable(T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
       }
@@ -69,7 +79,8 @@ module TerminalShop
         max_retries: Integer,
         initial_retry_delay: Float,
         max_retry_delay: Float,
-        headers: T::Hash[String, T.nilable(String)],
+        headers: T::Hash[String,
+                         T.nilable(T.any(String, Integer, T::Array[T.nilable(T.any(String, Integer))]))],
         idempotency_header: T.nilable(String)
       )
         .void
@@ -112,31 +123,30 @@ module TerminalShop
         retry_count: Integer,
         send_retry_header: T::Boolean
       )
-        .returns([Net::HTTPResponse, T::Enumerable[String]])
+        .returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
     end
     private def send_request(request, redirect_count:, retry_count:, send_retry_header:)
     end
 
-    sig do
-      params(
-        req: TerminalShop::BaseClient::RequestComponentsShape,
-        headers: T.any(T::Hash[String, String], Net::HTTPHeader),
-        stream: T::Enumerable[String]
-      )
-        .returns(T.anything)
-    end
-    private def parse_response(req, headers:, stream:)
-    end
-
     sig do
       params(
         method: Symbol,
         path: T.any(String, T::Array[String]),
         query: T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]),
-        headers: T.nilable(T::Hash[String, T.nilable(String)]),
+        headers: T.nilable(
+          T::Hash[String,
+                  T.nilable(
+                    T.any(
+                      String,
+                      Integer,
+                      T::Array[T.nilable(T.any(String, Integer))]
+                    )
+                  )]
+        ),
         body: T.nilable(T.anything),
         unwrap: T.nilable(Symbol),
-        page: T.nilable(T::Class[TerminalShop::BaseModel]),
+        page: T.nilable(T::Class[TerminalShop::BasePage[TerminalShop::BaseModel]]),
+        stream: T.nilable(T::Class[T.anything]),
         model: T.nilable(TerminalShop::Converter::Input),
         options: T.nilable(T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything]))
       )
@@ -150,6 +160,7 @@ module TerminalShop
       body: nil,
       unwrap: nil,
       page: nil,
+      stream: nil,
       model: TerminalShop::Unknown,
       options: {}
     )

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

@@ -29,11 +29,11 @@ module TerminalShop
         client: TerminalShop::BaseClient,
         req: TerminalShop::BaseClient::RequestComponentsShape,
         headers: T.any(T::Hash[String, String], Net::HTTPHeader),
-        unwrapped: T.anything
+        page_data: T.anything
       )
         .void
     end
-    def initialize(client:, req:, headers:, unwrapped:)
+    def initialize(client:, req:, headers:, page_data:)
     end
   end
 end

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

@@ -85,11 +85,12 @@ module TerminalShop
         status: Integer,
         body: T.nilable(Object),
         request: NilClass,
-        response: NilClass
+        response: NilClass,
+        message: T.nilable(String)
       )
         .returns(T.attached_class)
     end
-    def self.for(url:, status:, body:, request:, response:)
+    def self.for(url:, status:, body:, request:, response:, message: nil)
     end
 
     sig { returns(Integer) }

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

@@ -0,0 +1,18 @@
+# typed: strong
+
+module TerminalShop
+  module Models
+    class AddressGetParams < TerminalShop::BaseModel
+      extend TerminalShop::RequestParameters::Converter
+      include TerminalShop::RequestParameters
+
+      sig { params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything])).void }
+      def initialize(request_options: {})
+      end
+
+      sig { override.returns({request_options: TerminalShop::RequestOptions}) }
+      def to_hash
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+# typed: strong
+
+module TerminalShop
+  module Models
+    class AddressGetResponse < TerminalShop::BaseModel
+      sig { returns(TerminalShop::Models::AddressAPI) }
+      def data
+      end
+
+      sig { params(_: TerminalShop::Models::AddressAPI).returns(TerminalShop::Models::AddressAPI) }
+      def data=(_)
+      end
+
+      sig { params(data: TerminalShop::Models::AddressAPI).void }
+      def initialize(data:)
+      end
+
+      sig { override.returns({data: TerminalShop::Models::AddressAPI}) }
+      def to_hash
+      end
+    end
+  end
+end

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

@@ -2,15 +2,40 @@
 
 module TerminalShop
   module Models
-    class AppCreateParams < TerminalShop::Models::AppAPI
+    class AppCreateParams < TerminalShop::BaseModel
       extend TerminalShop::RequestParameters::Converter
       include TerminalShop::RequestParameters
 
-      sig { params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything])).void }
-      def initialize(request_options: {})
+      sig { returns(String) }
+      def name
       end
 
-      sig { override.returns({request_options: TerminalShop::RequestOptions}) }
+      sig { params(_: String).returns(String) }
+      def name=(_)
+      end
+
+      sig { returns(String) }
+      def redirect_uri
+      end
+
+      sig { params(_: String).returns(String) }
+      def redirect_uri=(_)
+      end
+
+      sig do
+        params(
+          name: String,
+          redirect_uri: String,
+          request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything])
+        )
+          .void
+      end
+      def initialize(name:, redirect_uri:, request_options: {})
+      end
+
+      sig do
+        override.returns({name: String, redirect_uri: String, request_options: TerminalShop::RequestOptions})
+      end
       def to_hash
       end
     end

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

@@ -0,0 +1,18 @@
+# typed: strong
+
+module TerminalShop
+  module Models
+    class CardGetParams < TerminalShop::BaseModel
+      extend TerminalShop::RequestParameters::Converter
+      include TerminalShop::RequestParameters
+
+      sig { params(request_options: T.any(TerminalShop::RequestOptions, T::Hash[Symbol, T.anything])).void }
+      def initialize(request_options: {})
+      end
+
+      sig { override.returns({request_options: TerminalShop::RequestOptions}) }
+      def to_hash
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+# typed: strong
+
+module TerminalShop
+  module Models
+    class CardGetResponse < TerminalShop::BaseModel
+      sig { returns(TerminalShop::Models::CardAPI) }
+      def data
+      end
+
+      sig { params(_: TerminalShop::Models::CardAPI).returns(TerminalShop::Models::CardAPI) }
+      def data=(_)
+      end
+
+      sig { params(data: TerminalShop::Models::CardAPI).void }
+      def initialize(data:)
+      end
+
+      sig { override.returns({data: TerminalShop::Models::CardAPI}) }
+      def to_hash
+      end
+    end
+  end
+end