fsdk-2237-ruby-e2e 0.1.0

data/lib/petstore/internal/iterators/offset_page_iterator.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    class OffsetPageIterator
+      include Enumerable
+
+      # The raw HTTP response from the most recent page response.
+      # @return [Net::HTTPResponse, nil]
+      attr_reader :http_response
+
+      # Instantiates an OffsetPageIterator, an Enumerable class which wraps calls to an offset-based paginated API and yields pages of items from it.
+      #
+      # @param initial_page [Integer] The initial page to use when iterating, if any.
+      # @param item_field [Symbol] The field to pull the list of items to iterate over.
+      # @param has_next_field [Symbol] The field to pull the boolean of whether a next page exists from, if any.
+      # @param step [Boolean] If true, treats the page number as a true offset (i.e. increments the page number by the number of items returned from each call rather than just 1)
+      # @param block [Proc] A block which is responsible for receiving a page number to use and returning the given page from the API.
+      #   The block should return a two-element array: [parsed_page, raw_http_response].
+      # @return [::Petstore::Internal::OffsetPageIterator]
+      def initialize(initial_page:, item_field:, has_next_field:, step:, &block)
+        @page_number = initial_page || (step ? 0 : 1)
+        @item_field = item_field
+        @has_next_field = has_next_field
+        @step = step
+        @get_next_page = block
+
+        # A cache of whether the API has another page, if it gives us that information...
+        @next_page = nil
+        # ...or the actual next page, preloaded, if it doesn't.
+        @has_next_page = nil
+
+        @http_response = nil
+      end
+
+      # Iterates over each page returned by the API.
+      #
+      # @yield [page] Each retrieved page.
+      # @return [NilClass]
+      def each
+        while (page = next_page)
+          yield(page)
+        end
+      end
+
+      # Whether another page will be available from the API.
+      #
+      # @return [Boolean]
+      def next?
+        return @has_next_page unless @has_next_page.nil?
+        return true if @next_page
+
+        fetched_page = fetch_page(@page_number)
+        fetched_page_items = resolve_field(fetched_page, @item_field)
+        if fetched_page_items.nil? || fetched_page_items.empty?
+          @has_next_page = false
+        else
+          @next_page = fetched_page
+          true
+        end
+      end
+
+      # Returns the next page from the API.
+      def next_page
+        return nil if @page_number.nil?
+
+        if @next_page
+          this_page = @next_page
+          @next_page = nil
+        else
+          this_page = fetch_page(@page_number)
+        end
+
+        @has_next_page = resolve_field(this_page, @has_next_field) if @has_next_field
+
+        items = resolve_field(this_page, @item_field)
+        if items.nil? || items.empty?
+          @page_number = nil
+          return nil
+        elsif @step
+          @page_number += items.length
+        else
+          @page_number += 1
+        end
+
+        this_page
+      end
+
+      private
+
+      # Resolves a field accessor (Symbol) or nested accessor path (Array<Symbol>) against a page.
+      def resolve_field(page, field)
+        return nil if page.nil? || field.nil?
+
+        Array(field).reduce(page) { |value, accessor| value&.send(accessor) }
+      end
+
+      def fetch_page(page_number)
+        result = @get_next_page.call(page_number)
+        if result.is_a?(Array)
+          fetched_page, raw_response = result
+          @http_response = raw_response
+          fetched_page
+        else
+          result
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/json/request.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module JSON
+      # @api private
+      class Request < ::Petstore::Internal::Http::BaseRequest
+        attr_reader :body
+
+        # @param base_url [String] The base URL for the request
+        # @param path [String] The path for the request
+        # @param method [Symbol] The HTTP method for the request (:get, :post, etc.)
+        # @param headers [Hash] Additional headers for the request (optional)
+        # @param query [Hash] Query parameters for the request (optional)
+        # @param body [Object, nil] The JSON request body (optional)
+        # @param content_type [String] The media type declared for the request body. JSON-family
+        #   types are not interchangeable: `application/merge-patch+json` selects merge-patch
+        #   semantics, and sending `application/json` instead changes what the server does.
+        # @param accept [String] The media type declared for the RESPONSE body. A server that
+        #   content-negotiates on Accept can 406 a request that asks for the wrong one, so an
+        #   endpoint returning `application/vnd.api+json` has to say so.
+        # @param request_options [::Petstore::RequestOptions, Hash{Symbol=>Object}, nil]
+        def initialize(base_url:, path:, method:, headers: {}, query: {}, body: nil, content_type: 'application/json', accept: 'application/json', request_options: {})
+          super(base_url:, path:, method:, headers:, query:, request_options:)
+
+          @body = body
+          @content_type = content_type
+          @accept = accept
+        end
+
+        # @return [Hash] The encoded HTTP request headers.
+        # @param protected_keys [Array<String>] Header keys set by the SDK client (e.g. auth, metadata)
+        #   that must not be overridden by additional_headers from request_options.
+        def encode_headers(protected_keys: [])
+          sdk_headers = {
+            'Content-Type' => @content_type,
+            'Accept' => @accept,
+          }.merge(@headers)
+          merge_additional_headers(sdk_headers, protected_keys:)
+        end
+
+        # @return [String, nil] The encoded HTTP request body.
+        #
+        # `additional_body_parameters` from request_options is the per-request escape hatch for
+        # sending undocumented or beta fields without a new SDK version. It is shallow-merged onto
+        # an object body with the extras winning, so an extra key named like a declared field
+        # replaces it. A nil body becomes the extras; an array or primitive body has no object to
+        # merge onto and is sent unchanged. Keys are stringified because a model's `#to_h` is keyed
+        # by wire name (a String) and a Symbol key would otherwise emit the field twice.
+        def encode_body
+          extra = @request_options&.dig(:additional_body_parameters) || @request_options&.dig('additional_body_parameters')
+          return @body.nil? ? nil : ::JSON.generate(@body) unless extra.is_a?(::Hash) && !extra.empty?
+          return ::JSON.generate(extra.transform_keys(&:to_s)) if @body.nil?
+          return ::JSON.generate(@body) unless @body.is_a?(::Hash)
+
+          ::JSON.generate(@body.merge(extra.transform_keys(&:to_s)))
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/json/serializable.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module JSON
+      module Serializable
+        # Loads data from JSON into its deserialized form
+        #
+        # @param str [String] Raw JSON to load into an object
+        # @return [Object]
+        def load(str)
+          raise NotImplementedError
+        end
+
+        # Dumps data from its deserialized form into JSON
+        #
+        # @param value [Object] The deserialized value
+        # @return [String]
+        def dump(value)
+          raise NotImplementedError
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/multipart/multipart_encoder.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module Multipart
+      # Encodes parameters into a `multipart/form-data` payload as described by RFC
+      # 2388:
+      #
+      #     https://tools.ietf.org/html/rfc2388
+      #
+      # This is most useful for transferring file-like objects.
+      #
+      # Parameters should be added with `#encode`. When ready, use `#body` to get
+      # the encoded result and `#content_type` to get the value that should be
+      # placed in the `Content-Type` header of a subsequent request (which includes
+      # a boundary value).
+      #
+      # This abstraction is heavily inspired by Stripe's multipart/form-data implementation,
+      # which can be found here:
+      #
+      #     https://github.com/stripe/stripe-ruby/blob/ca00b676f04ac421cf5cb5ff0325f243651677b6/lib/stripe/multipart_encoder.rb#L18
+      #
+      # @api private
+      class Encoder
+        CONTENT_TYPE = 'multipart/form-data'
+        CRLF = "\r\n"
+
+        attr_reader :boundary, :body
+
+        def initialize
+          # Chose the same number of random bytes that Go uses in its standard
+          # library implementation. Easily enough entropy to ensure that it won't
+          # be present in a file we're sending.
+          @boundary = SecureRandom.hex(30)
+
+          @body = +''
+          @closed = false
+          @first_field = true
+        end
+
+        # Gets the content type string including the boundary.
+        #
+        # @return [String] The content type with boundary
+        def content_type
+          "#{CONTENT_TYPE}; boundary=#{@boundary}"
+        end
+
+        # Encode the given FormData object into a multipart/form-data payload.
+        #
+        # @param form_data [FormData] The form data to encode
+        # @return [String] The encoded body.
+        def encode(form_data)
+          return '' if form_data.parts.empty?
+
+          form_data.parts.each do |part|
+            write_part(part)
+          end
+          close
+
+          @body
+        end
+
+        # Writes a FormDataPart to the encoder.
+        #
+        # @param part [FormDataPart] The part to write
+        # @return [nil]
+        def write_part(part)
+          raise 'Cannot write to closed encoder' if @closed
+
+          write_field(
+            name: part.name,
+            data: part.contents,
+            filename: part.filename,
+            headers: part.headers,
+          )
+
+          nil
+        end
+
+        # Writes a field to the encoder.
+        #
+        # @param name [String] The field name
+        # @param data [String] The field data
+        # @param filename [String, nil] Optional filename
+        # @param headers [Hash<String, String>, nil] Optional additional headers
+        # @return [nil]
+        def write_field(name:, data:, filename: nil, headers: nil)
+          raise 'Cannot write to closed encoder' if @closed
+
+          if @first_field
+            @first_field = false
+          else
+            @body << CRLF
+          end
+
+          @body << "--#{@boundary}#{CRLF}"
+          @body << %(Content-Disposition: form-data; name="#{escape(name.to_s)}")
+          @body << %(; filename="#{escape(filename)}") if filename
+          @body << CRLF
+
+          if headers
+            headers.each do |key, value|
+              @body << "#{key}: #{value}#{CRLF}"
+            end
+          elsif filename
+            # Default content type for files.
+            @body << "Content-Type: application/octet-stream#{CRLF}"
+          end
+
+          @body << CRLF
+          @body << data.to_s
+
+          nil
+        end
+
+        # Finalizes the encoder by writing the final boundary.
+        #
+        # @return [nil]
+        def close
+          raise 'Encoder already closed' if @closed
+
+          @body << CRLF
+          @body << "--#{@boundary}--"
+          @closed = true
+
+          nil
+        end
+
+        private
+
+        # Escapes quotes for use in header values and replaces line breaks with spaces.
+        #
+        # @param str [String] The string to escape
+        # @return [String] The escaped string
+        def escape(str)
+          str.to_s.gsub('"', '%22').tr("\n", ' ').tr("\r", ' ')
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/multipart/multipart_form_data.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module Multipart
+      # @api private
+      class FormData
+        # @return [Array<FormDataPart>] The parts in this multipart form data.
+        attr_reader :parts
+
+        # @return [Encoder] The encoder for this multipart form data.
+        private attr_reader :encoder
+
+        def initialize
+          @encoder = Encoder.new
+          @parts = []
+        end
+
+        # Adds a new part to the multipart form data.
+        #
+        # @param name [String] The name of the form field
+        # @param value [String, Integer, Float, Boolean, #read] The value of the field
+        # @param content_type [String, nil] Optional content type
+        # @return [self] Returns self for chaining
+        def add(name:, value:, content_type: nil)
+          headers = content_type ? { 'Content-Type' => content_type } : nil
+          add_part(FormDataPart.new(name:, value:, headers:))
+        end
+
+        # Adds a file to the multipart form data.
+        #
+        # @param name [String] The name of the form field
+        # @param file [#read] The file or readable object
+        # @param filename [String, nil] Optional filename (defaults to basename of path for File objects)
+        # @param content_type [String, nil] Optional content type (e.g. "image/png")
+        # @return [self] Returns self for chaining
+        def add_file(name:, file:, filename: nil, content_type: nil)
+          headers = content_type ? { 'Content-Type' => content_type } : nil
+          filename ||= filename_for(file)
+          add_part(FormDataPart.new(name:, value: file, filename:, headers:))
+        end
+
+        # Adds a pre-created part to the multipart form data.
+        #
+        # @param part [FormDataPart] The part to add
+        # @return [self] Returns self for chaining
+        def add_part(part)
+          @parts << part
+          self
+        end
+
+        # Gets the content type string including the boundary.
+        #
+        # @return [String] The content type with boundary.
+        def content_type
+          @encoder.content_type
+        end
+
+        # Encode the multipart form data into a multipart/form-data payload.
+        #
+        # @return [String] The encoded body.
+        def encode
+          @encoder.encode(self)
+        end
+
+        private
+
+        def filename_for(file)
+          if file.is_a?(::File) || file.respond_to?(:path)
+            ::File.basename(file.path)
+          elsif file.respond_to?(:name)
+            file.name
+          end
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/multipart/multipart_form_data_part.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module Petstore
+  module Internal
+    module Multipart
+      # @api private
+      class FormDataPart
+        attr_reader :name, :contents, :filename, :headers
+
+        # @param name [String] The name of the form field
+        # @param value [String, Integer, Float, Boolean, File, #read] The value of the field
+        # @param filename [String, nil] Optional filename for file uploads
+        # @param headers [Hash<String, String>, nil] Optional additional headers
+        def initialize(name:, value:, filename: nil, headers: nil)
+          @name = name
+          @contents = convert_to_content(value)
+          @filename = filename
+          @headers = headers
+        end
+
+        # Converts the part to a hash suitable for serialization.
+        #
+        # @return [Hash] A hash representation of the part
+        def to_hash
+          result = {
+            name: @name,
+            contents: @contents,
+          }
+          result[:filename] = @filename if @filename
+          result[:headers] = @headers if @headers
+          result
+        end
+
+        private
+
+        # Converts various types of values to a content representation
+        # @param value [String, Integer, Float, Boolean, #read] The value to convert
+        # @return [String] The string representation of the value
+        def convert_to_content(value)
+          if value.respond_to?(:read)
+            value.read
+          else
+            value.to_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/multipart/multipart_request.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module Multipart
+      # @api private
+      class Request < ::Petstore::Internal::Http::BaseRequest
+        attr_reader :body
+
+        # @param base_url [String] The base URL for the request
+        # @param path [String] The path for the request
+        # @param method [Symbol] The HTTP method for the request (:get, :post, etc.)
+        # @param headers [Hash] Additional headers for the request (optional)
+        # @param query [Hash] Query parameters for the request (optional)
+        # @param body [MultipartFormData, nil] The multipart form data for the request (optional)
+        # @param request_options [::Petstore::RequestOptions, Hash{Symbol=>Object}, nil]
+        def initialize(base_url:, path:, method:, headers: {}, query: {}, body: nil, request_options: {})
+          super(base_url:, path:, method:, headers:, query:, request_options:)
+
+          @body = body
+        end
+
+        # @return [Hash] The encoded HTTP request headers.
+        # @param protected_keys [Array<String>] Header keys set by the SDK client (e.g. auth, metadata)
+        #   that must not be overridden by additional_headers from request_options.
+        def encode_headers(protected_keys: [])
+          sdk_headers = {
+            'Content-Type' => @body.content_type,
+          }.merge(@headers)
+          merge_additional_headers(sdk_headers, protected_keys:)
+        end
+
+        # @return [String, nil] The encoded HTTP request body.
+        #
+        # MEMOISED for the same reason as `Raw::Request#encode_body`: `RawClient#send` encodes once
+        # per attempt, and `MultipartEncoder#close` marks the encoder closed — so a second `encode`
+        # raised `RuntimeError: Cannot write to closed encoder`. A retried multipart upload (a POST
+        # carrying an idempotency key) therefore died inside the SDK instead of being replayed.
+        def encode_body
+          # The memo is named after the METHOD rather than after the value it holds, which is the
+          # naming convention the generated .rubocop.yml enforces.
+          return @encode_body if defined?(@encode_body)
+
+          @encode_body = @body&.encode
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/raw/request.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module Raw
+      # A request whose body is sent to the server exactly as the caller supplied it.
+      #
+      # `Internal::JSON::Request` is the wrong carrier for a declared non-JSON body: `encode_body`
+      # runs `::JSON.generate`, which turns a `text/plain` string into a quoted JSON string
+      # (`"hello"` on the wire, not `hello`) and RAISES on binary bytes
+      # (`Encoding::UndefinedConversionError`) — so an `application/octet-stream` upload failed
+      # inside the SDK's own encoder before it ever reached the network. With the body left
+      # untouched here, the declared media type in `Content-Type` is finally the truth about what
+      # was sent, which is what let FSDK-1442 stop defaulting a non-JSON type to `application/json`.
+      #
+      # @api private
+      class Request < ::Petstore::Internal::Http::BaseRequest
+        attr_reader :body
+
+        # @param base_url [String] The base URL for the request
+        # @param path [String] The path for the request
+        # @param method [Symbol] The HTTP method for the request (:get, :post, etc.)
+        # @param headers [Hash] Additional headers for the request (optional)
+        # @param query [Hash] Query parameters for the request (optional)
+        # @param body [String, #read, nil] The raw request body (optional)
+        # @param content_type [String] The media type declared for the request body.
+        # @param accept [String] The media type declared for the response body.
+        # @param request_options [::Petstore::RequestOptions, Hash{Symbol=>Object}, nil]
+        def initialize(base_url:, path:, method:, headers: {}, query: {}, body: nil, content_type: 'application/octet-stream', accept: '*/*', request_options: {})
+          super(base_url:, path:, method:, headers:, query:, request_options:)
+
+          @body = body
+          @content_type = content_type
+          @accept = accept
+        end
+
+        # @return [Hash] The encoded HTTP request headers.
+        # @param protected_keys [Array<String>] Header keys set by the SDK client (e.g. auth, metadata)
+        #   that must not be overridden by additional_headers from request_options.
+        def encode_headers(protected_keys: [])
+          sdk_headers = {
+            'Content-Type' => @content_type,
+            'Accept' => @accept,
+          }.merge(@headers)
+          merge_additional_headers(sdk_headers, protected_keys:)
+        end
+
+        # @return [String, nil] The encoded HTTP request body.
+        #
+        # An IO/File is READ rather than `to_s`-ed, because `File#to_s` is
+        # `"#<File:0x000...>"` — the object's inspect output, not its bytes. `binmode` first so the
+        # bytes arrive as ASCII-8BIT: a `File.open(path)` defaults to the external encoding, and a
+        # UTF-8-tagged string holding invalid UTF-8 raises when concatenated downstream.
+        # MEMOISED, because `RawClient#send` calls this once per attempt and an IO can only be
+        # drained once: on a retry the handle already sits at EOF, so attempt 2 read `nil`/`""` and
+        # the SDK uploaded an EMPTY body while reporting success. Reading once and replaying the
+        # bytes is what makes a raw upload survive a retry. `rewind` additionally covers a handle
+        # that arrives already partly consumed; a non-seekable IO (a pipe) refuses it, which is
+        # harmless here since it is read exactly once anyway.
+        def encode_body
+          return nil if @body.nil?
+          # The memo is named after the METHOD rather than after the value it holds, which is the
+          # naming convention the generated .rubocop.yml enforces.
+          return @encode_body if defined?(@encode_body)
+
+          @encode_body =
+            if @body.respond_to?(:read)
+              @body.binmode if @body.respond_to?(:binmode)
+              rewind_body
+              @body.read
+            elsif @body.is_a?(::String)
+              @body
+            else
+              @body.to_s
+            end
+        end
+
+        private
+
+        def rewind_body
+          @body.rewind if @body.respond_to?(:rewind)
+        rescue ::IOError, ::SystemCallError
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/types/array.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module Types
+      # An array of a specific type
+      class Array
+        include ::Petstore::Internal::Types::Type
+
+        attr_reader :type
+
+        class << self
+          # Instantiates a new `Array` of a given type
+          #
+          # @param type [Object] The member type of this array
+          #
+          # @return [::Petstore::Internal::Types::Array]
+          def [](type)
+            new(type)
+          end
+        end
+
+        # @api private
+        def initialize(type)
+          @type = type
+        end
+
+        # Coerces a value into this array
+        #
+        # @param value [Object]
+        # @option strict [Boolean]
+        # @return [::Array]
+        def coerce(value, strict: strict?)
+          unless value.is_a?(::Array)
+            raise Errors::TypeError, "cannot coerce `#{value.class}` to Array<#{type}>" if strict
+
+            return value
+          end
+
+          value.map do |element|
+            Utils.coerce(type, element, strict: strict)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/petstore/internal/types/boolean.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Petstore
+  module Internal
+    module Types
+      module Boolean
+        extend ::Petstore::Internal::Types::Union
+
+        member TrueClass
+        member FalseClass
+
+        # Overrides the base coercion method for enums to allow integer and string values to become booleans
+        #
+        # @param value [Object]
+        # @option strict [Boolean]
+        # @return [Object]
+        def self.coerce(value, strict: strict?)
+          case value
+          when TrueClass, FalseClass
+            return value
+          when Integer
+            return value == 1
+          when String
+            return %w[1 true].include?(value)
+          end
+
+          raise Errors::TypeError, "cannot coerce `#{value.class}` to Boolean" if strict
+
+          value
+        end
+      end
+    end
+  end
+end