seam 2.139.0 → 2.141.0

data/lib/seam/url_search_params.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module Seam
+  # A mutable, ordered list of name/value string pairs modeling the parts of
+  # the WHATWG URLSearchParams interface that the Seam URL search params
+  # serializer needs.
+  class UrlSearchParams
+    include Enumerable
+
+    # @param init [String, Hash, Enumerable, nil]
+    def initialize(init = nil)
+      @pairs = []
+      return if init.nil?
+
+      case init
+      when String
+        query = init.delete_prefix("?")
+        URI.decode_www_form(query).each { |name, value| append(name, value) } unless query.empty?
+      when Hash
+        init.each { |name, value| append(name, value) }
+      else
+        init.each { |name, value| append(name, value) }
+      end
+    end
+
+    def append(name, value)
+      @pairs << [name.to_s, value.to_s]
+      nil
+    end
+
+    def set(name, value)
+      name = name.to_s
+      replaced = false
+      @pairs = @pairs.filter_map do |pair|
+        next pair unless pair.first == name
+        next nil if replaced
+
+        replaced = true
+        [name, value.to_s]
+      end
+      append(name, value) unless replaced
+      nil
+    end
+
+    def get(name)
+      name = name.to_s
+      @pairs.each { |pair_name, value| return value if pair_name == name }
+      nil
+    end
+
+    def get_all(name)
+      name = name.to_s
+      @pairs.filter_map { |pair_name, value| value if pair_name == name }
+    end
+
+    def has?(name)
+      name = name.to_s
+      @pairs.any? { |pair_name, _| pair_name == name }
+    end
+
+    def delete(name)
+      name = name.to_s
+      @pairs.reject! { |pair_name, _| pair_name == name }
+      nil
+    end
+
+    def sort!
+      @pairs = @pairs.each_with_index.sort_by do |(name, _), index|
+        [name.encode(Encoding::UTF_16BE).b, index]
+      end.map(&:first)
+      nil
+    end
+
+    def each(&block)
+      return @pairs.each unless block
+
+      @pairs.each(&block)
+      self
+    end
+
+    def size
+      @pairs.size
+    end
+    alias_method :length, :size
+
+    def empty?
+      @pairs.empty?
+    end
+
+    def to_s
+      @pairs.map do |name, value|
+        "#{self.class.encode_component(name)}=#{self.class.encode_component(value)}"
+      end.join("&")
+    end
+
+    def self.encode_component(string)
+      URI.encode_www_form_component(string.encode(Encoding::UTF_8))
+    end
+  end
+end

data/lib/seam/url_search_params_serializer.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+require "date"
+
+require_relative "null"
+require_relative "url_search_params"
+
+module Seam
+  class UnserializableParamError < StandardError
+    attr_reader :param_name
+
+    def initialize(param_name, reason)
+      @param_name = param_name
+      super("Could not serialize parameter: '#{param_name}' #{reason}")
+    end
+  end
+
+  def self.replace_null(value)
+    case value
+    when Seam::Null then nil
+    when Hash then value.transform_values { |v| replace_null(v) }
+    when Array then value.map { |v| replace_null(v) }
+    else value
+    end
+  end
+
+  # Serializes parameters to a URL query string following the
+  # @seamapi/url-search-params-serializer standard:
+  # https://github.com/seamapi/url-search-params-serializer
+  module UrlSearchParamsSerializer
+    # @param params [Hash]
+    # @param strict [Boolean] Whether to add +_strict=true+ to a non-empty
+    #   query string
+    # @return [String] The query string, without a leading +?+
+    # @raise [UnserializableParamError]
+    def self.serialize_url_search_params(params, strict: false)
+      search_params = UrlSearchParams.new
+      update_url_search_params(search_params, params, strict: strict)
+      search_params.to_s
+    end
+
+    # Serializes parameters into an existing {UrlSearchParams} collection,
+    # preserving pairs it does not overwrite.
+    #
+    # @param search_params [UrlSearchParams]
+    # @param params [Hash]
+    # @param strict [Boolean] Whether to add +_strict=true+ when the
+    #   resulting collection is non-empty
+    # @return [nil]
+    # @raise [UnserializableParamError]
+    def self.update_url_search_params(search_params, params, strict: false)
+      nested_update(search_params, params, [])
+      search_params.sort!
+
+      if strict && !search_params.empty?
+        search_params.delete("_strict")
+        search_params.append("_strict", "true")
+      end
+
+      nil
+    end
+
+    def self.nested_update(search_params, params, path)
+      params.each do |key, value|
+        unless key.is_a?(String) || key.is_a?(Symbol)
+          raise UnserializableParamError.new(
+            key.inspect,
+            "has a name that is not a string which is unsupported"
+          )
+        end
+        key = key.to_s
+
+        if key.include?(".")
+          raise UnserializableParamError.new(
+            key,
+            'contains one or more dots "." in its name which is unsupported'
+          )
+        end
+
+        current_path = [*path, key]
+
+        if value.is_a?(Hash)
+          nested_update(search_params, value, current_path)
+          next
+        end
+
+        name = current_path.join(".")
+
+        next if value.nil?
+
+        value = value.to_s if value.is_a?(Symbol)
+
+        next if value.is_a?(String) && value.empty?
+
+        if value.is_a?(Array)
+          serialize_array(search_params, name, value)
+          next
+        end
+
+        search_params.set(name, serialize_value(name, value))
+      end
+    end
+
+    def self.serialize_array(search_params, name, values)
+      # The parser reads a single pair with an empty value as an empty array.
+      if values.empty?
+        search_params.set(name, "")
+        return
+      end
+
+      values = values.map { |value| value.is_a?(Symbol) ? value.to_s : value }
+
+      if values.length == 1 && values.first == ""
+        raise UnserializableParamError.new(
+          name,
+          "is a single element array containing the empty string which is unsupported"
+        )
+      end
+
+      if values.any? { |value| value == "" }
+        raise UnserializableParamError.new(
+          name,
+          "is an array containing the empty string which is unsupported"
+        )
+      end
+
+      if values.any? { |value| value.nil? || value.is_a?(Seam::Null) }
+        raise UnserializableParamError.new(
+          name,
+          "is an array containing null or undefined values which is unsupported"
+        )
+      end
+
+      values.each { |value| search_params.append(name, serialize_value(name, value)) }
+    end
+
+    def self.serialize_value(name, value)
+      case value
+      when Seam::Null then ""
+      when String then value
+      when true, false then value.to_s
+      when Integer then value.to_s
+      when Float then serialize_float(name, value)
+      when Time then serialize_time(value)
+      when DateTime then serialize_time(value.to_time)
+      when Date then serialize_time(Time.utc(value.year, value.month, value.day))
+      else
+        raise UnserializableParamError.new(name, "is a #{value.class}")
+      end
+    end
+
+    # Formats a float exactly like ECMAScript Number::toString.
+    def self.serialize_float(name, value)
+      raise UnserializableParamError.new(name, "is NaN") if value.nan?
+      if value.infinite?
+        raise UnserializableParamError.new(name, "is #{value.positive? ? "Infinity" : "-Infinity"}")
+      end
+      return "0" if value.zero?
+
+      digits, point = shortest_decimal(value.abs)
+      count = digits.length
+
+      formatted = if point.between?(count, 21)
+        digits + "0" * (point - count)
+      elsif point.positive? && point <= 21
+        "#{digits[0, point]}.#{digits[point..]}"
+      elsif point > -6 && point <= 0
+        "0.#{"0" * -point}#{digits}"
+      else
+        mantissa = (count == 1) ? digits : "#{digits[0]}.#{digits[1..]}"
+        exponent = point - 1
+        "#{mantissa}e#{(exponent >= 0) ? "+" : "-"}#{exponent.abs}"
+      end
+
+      value.negative? ? "-#{formatted}" : formatted
+    end
+
+    # Returns the shortest round-tripping decimal digits of a positive float
+    # and the position of the decimal point relative to the first digit.
+    def self.shortest_decimal(value)
+      repr = value.to_s
+
+      if repr.include?("e")
+        mantissa, exponent = repr.split("e")
+        integer_part, fraction_part = mantissa.split(".")
+        digits = integer_part + (fraction_part || "")
+        point = integer_part.length + exponent.to_i
+      else
+        integer_part, fraction_part = repr.split(".")
+        digits = integer_part + (fraction_part || "")
+        point = integer_part.length
+      end
+
+      leading_zeros = digits[/\A0*/].length
+      digits = digits[leading_zeros..]
+      point -= leading_zeros
+
+      [digits.sub(/0+\z/, ""), point]
+    end
+
+    # Formats a time exactly like JavaScript's Date#toISOString.
+    def self.serialize_time(time)
+      utc = time.getutc
+      year = if utc.year.between?(0, 9999)
+        format("%04d", utc.year)
+      elsif utc.year > 9999
+        format("+%06d", utc.year)
+      else
+        format("-%06d", -utc.year)
+      end
+      format(
+        "%s-%02d-%02dT%02d:%02d:%02d.%03dZ",
+        year, utc.month, utc.day, utc.hour, utc.min, utc.sec, utc.nsec / 1_000_000
+      )
+    end
+  end
+end

data/lib/seam/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Seam
-  VERSION = "2.139.0"
+  VERSION = "2.141.0"
 end

data/lib/seam.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require_relative "seam/null"
+require_relative "seam/url_search_params"
+require_relative "seam/strict_url_search_params_serializer"
 require_relative "seam/http"
 require_relative "seam/http_without_workspace"
 require_relative "seam/webhook"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: seam
 version: !ruby/object:Gem::Version
-  version: 2.139.0
+  version: 2.141.0
 platform: ruby
 authors:
 - Seam Labs, Inc.
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-13 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -128,14 +127,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.21'
+        version: '1.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.21'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: simplecov-console
   requirement: !ruby/object:Gem::Requirement
@@ -170,14 +169,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.24.0
+        version: 3.26.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.24.0
+        version: 3.26.2
 description: SDK for the Seam API written in Ruby.
 email: engineering@getseam.com
 executables: []
@@ -198,6 +197,7 @@ files:
 - lib/seam/http.rb
 - lib/seam/http_single_workspace.rb
 - lib/seam/http_without_workspace.rb
+- lib/seam/null.rb
 - lib/seam/options.rb
 - lib/seam/paginator.rb
 - lib/seam/parse_options.rb
@@ -280,7 +280,10 @@ files:
 - lib/seam/routes/user_identities_unmanaged.rb
 - lib/seam/routes/webhooks.rb
 - lib/seam/routes/workspaces.rb
+- lib/seam/strict_url_search_params_serializer.rb
 - lib/seam/token.rb
+- lib/seam/url_search_params.rb
+- lib/seam/url_search_params_serializer.rb
 - lib/seam/version.rb
 - lib/seam/wait_for_action_attempt.rb
 - lib/seam/webhook.rb
@@ -293,7 +296,6 @@ metadata:
   bug_tracker_uri: https://github.com/seamapi/ruby-next/issues
   changelog_uri: https://github.com/seamapi/ruby-next/blob/main/CHANGELOG.md
   github_repo: git@github.com:seamapi/ruby-next.git
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -301,15 +303,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Seam Ruby SDK
 test_files: []