dependabot-common 0.381.0 → 0.382.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1bc1965fa1a1b0995cf9a71e47f098f471c2727513d3a69d7c8cf35b82a3cc3
-  data.tar.gz: 4273d18c7f649c135c28db5f864d82dc120f56a683a2b5fd823a09a486fc530b
+  metadata.gz: 6b53185ee3c744622d14656ac582aaa779b5b9f3394497824d49561fe78fe2d8
+  data.tar.gz: cd5ce58e980459603217ea2693475a224691f67149215d1fb5031472bc065507
 SHA512:
-  metadata.gz: 72acbd4917a61c50117d9014f26ac4cae89567215682764b01506c1a36f4eb80df3245f4ca4cad9ad7ab0f5d834e9e4540a67a6ea0dab5441d2d9c0a62f6acff
-  data.tar.gz: d2acef41e94afb6b5d0d171139e615adbbcc491e89a35ec78d7852b2d745e301ea3f9ec212b035452f7898cdfd791c8e2ff25decf021e5bc2fbda58011879688
+  metadata.gz: 1216f4ef150d1c76b7180f780b1d67831359c9f327bf1a00cf885d3f9b3313ce354a694803de8ec91c1eebc138e922d65cde4f4e5ede88f6da7ceb23c6306026
+  data.tar.gz: 1377f5537d8d8e637945e35d59ba58dde50ec048f29abf6e9d50c4239ce2a7ca292aa379cfd7c28af7c9efe12723bdf71d55a007ad7e4839a177472f57f7a256

data/lib/dependabot/config/ignore_condition.rb

@@ -52,7 +52,7 @@ module Dependabot
         update_types.map(&:downcase).filter_map(&:strip)
       end
 
-      sig { params(dependency: Dependency).returns(T::Array[T.untyped]) }
+      sig { params(dependency: Dependency).returns(T::Array[String]) }
       def versions_by_type(dependency)
         version = correct_version_for(dependency)
         return [] unless version

data/lib/dependabot/credential.rb

@@ -11,10 +11,20 @@ module Dependabot
 
     def_delegators :@credential, :fetch, :keys, :[]=, :delete, :slice, :values, :entries
 
-    sig { params(credential: T::Hash[String, T.any(T::Boolean, String)]).void }
+    sig { params(credential: T::Hash[String, T.any(T::Boolean, String, T::Array[String])]).void }
     def initialize(credential)
       @replaces_base = T.let(credential["replaces-base"] == true, T::Boolean)
       credential.delete("replaces-base")
+
+      raw_scope = credential.delete("scope")
+      @scope = T.let(
+        case raw_scope
+        when String then [raw_scope]
+        when Array then raw_scope
+        end,
+        T.nilable(T::Array[String])
+      )
+
       @credential = T.let(T.unsafe(credential), T::Hash[String, String])
     end
 
@@ -23,6 +33,9 @@ module Dependabot
       @replaces_base
     end
 
+    sig { returns(T.nilable(T::Array[String])) }
+    attr_reader :scope
+
     sig { params(key: String).returns(T.nilable(String)) }
     def [](key)
       @credential[key]

data/lib/dependabot/dependency.rb

@@ -2,6 +2,7 @@
 # frozen_string_literal: true
 
 require "sorbet-runtime"
+require "dependabot/dependency_requirement"
 require "dependabot/version"
 
 module Dependabot
@@ -90,7 +91,7 @@ module Dependabot
     sig { returns(T.nilable(String)) }
     attr_reader :version
 
-    sig { returns(T::Array[T::Hash[Symbol, T.untyped]]) }
+    sig { returns(T::Array[Dependabot::DependencyRequirement]) }
     attr_reader :requirements
 
     sig { returns(String) }
@@ -99,7 +100,7 @@ module Dependabot
     sig { returns(T.nilable(String)) }
     attr_reader :previous_version
 
-    sig { returns(T.nilable(T::Array[T::Hash[Symbol, T.untyped]])) }
+    sig { returns(T.nilable(T::Array[Dependabot::DependencyRequirement])) }
     attr_reader :previous_requirements
 
     sig { returns(T.nilable(String)) }
@@ -124,7 +125,6 @@ module Dependabot
     sig { returns(T.nilable(Time)) }
     attr_accessor :attribution_timestamp
 
-    # rubocop:disable Metrics/AbcSize
     # rubocop:disable Metrics/PerceivedComplexity
     sig do
       params(
@@ -162,12 +162,15 @@ module Dependabot
         T.nilable(String)
       )
       @version = nil if @version == ""
-      @requirements = T.let(requirements.map { |req| symbolize_keys(req) }, T::Array[T::Hash[Symbol, T.untyped]])
+      @requirements = T.let(
+        requirements.map { |req| DependencyRequirement.create(req) },
+        T::Array[Dependabot::DependencyRequirement]
+      )
       @previous_version = previous_version
       @previous_version = nil if @previous_version == ""
       @previous_requirements = T.let(
-        previous_requirements&.map { |req| symbolize_keys(req) },
-        T.nilable(T::Array[T::Hash[Symbol, T.untyped]])
+        previous_requirements&.map { |req| DependencyRequirement.create(req) },
+        T.nilable(T::Array[Dependabot::DependencyRequirement])
       )
       @package_manager = package_manager
       @directory = directory
@@ -181,7 +184,6 @@ module Dependabot
       @metadata = T.let(symbolize_keys(metadata || {}), T::Hash[Symbol, T.untyped])
       check_values
     end
-    # rubocop:enable Metrics/AbcSize
     # rubocop:enable Metrics/PerceivedComplexity
 
     sig { returns(T::Boolean) }
@@ -272,7 +274,7 @@ module Dependabot
       end
     end
 
-    sig { params(requirements: T::Array[T::Hash[Symbol, T.untyped]]).returns(T.nilable(String)) }
+    sig { params(requirements: T::Array[Dependabot::DependencyRequirement]).returns(T.nilable(String)) }
     def docker_digest_from_reqs(requirements)
       requirements
         .filter_map { |r| r.dig(:source, "digest") || r.dig(:source, :digest) }
@@ -340,9 +342,9 @@ module Dependabot
       self == other
     end
 
-    sig { returns(T::Array[T::Hash[Symbol, T.untyped]]) }
+    sig { returns(T::Array[Dependabot::DependencyRequirement]) }
     def specific_requirements
-      requirements.select { |r| requirement_class.new(r[:requirement]).specific? }
+      requirements.select { |r| requirement_class.new(r.requirement).specific? }
     end
 
     sig { returns(T.class_of(Dependabot::Requirement)) }

data/lib/dependabot/dependency_file.rb

@@ -123,7 +123,7 @@ module Dependabot
       raise "Only symlinked files must specify a target!" if symlink_target
     end
 
-    sig { returns(T::Hash[String, T.untyped]) }
+    sig { returns(T::Hash[String, T.nilable(T.any(String, T::Boolean))]) }
     def to_h
       details = {
         "name" => name,

data/lib/dependabot/dependency_requirement.rb

@@ -0,0 +1,94 @@
+# typed: strict
+# frozen_string_literal: true
+
+require "sorbet-runtime"
+
+module Dependabot
+  # A single requirement entry within Dependency#requirements, e.g.:
+  #
+  #   {
+  #     requirement: ">= 1.0, < 2.0",
+  #     file: "Gemfile",
+  #     groups: [:default],
+  #     source: { type: "rubygems", url: "https://rubygems.org" },
+  #     metadata: { property_name: "rails.version" } # optional
+  #   }
+  #
+  # Subclasses Hash so it is a drop-in replacement at call sites (and in
+  # type annotations) that treat requirement entries as
+  # T::Hash[Symbol, T.untyped], while exposing typed readers for the
+  # well-known keys. New code should prefer the typed readers; hash-style
+  # access remains supported while call sites are migrated gradually.
+  #
+  # Wire compatibility: instances serialise to JSON exactly like the plain
+  # hash they were created from, and compare equal (==/eql?/#hash) to plain
+  # hashes with the same content, so existing comparisons, Array/Set
+  # operations, and API payloads are unaffected.
+  #
+  # Note on Hash methods: in Ruby 3+, #merge, #dup and #compact preserve
+  # this class, while #select, #reject, #except, #transform_values and
+  # #to_h return plain Hash instances. Dependency#initialize re-wraps
+  # whatever it is given, so both styles remain safe.
+  class DependencyRequirement < Hash
+    extend T::Sig
+    extend T::Generic
+
+    # The values of a requirement entry are heterogeneous and
+    # ecosystem-specific, so this bridge class is necessarily untyped at
+    # the Hash level; the typed readers below are the migration path.
+    # rubocop:disable Sorbet/ForbidTUntyped
+    K = type_member { { fixed: Symbol } }
+    V = type_member { { fixed: T.untyped } }
+    Elem = type_member { { fixed: [Symbol, T.untyped] } }
+
+    # Builds a DependencyRequirement from a requirement hash, symbolising
+    # top-level keys. Accepts both plain hashes and existing
+    # DependencyRequirement instances and always returns a new instance.
+    sig { params(hash: T::Hash[T.any(Symbol, String), T.untyped]).returns(DependencyRequirement) }
+    def self.create(hash)
+      requirement = new
+      requirement.replace(hash.keys.to_h { |k| [k.to_sym, hash[k]] })
+      requirement
+    end
+
+    # The version constraint string, e.g. ">= 1.0, < 2.0". Nil when the
+    # dependency is pinned by a lockfile rather than a manifest constraint.
+    sig { returns(T.nilable(String)) }
+    def requirement
+      self[:requirement]
+    end
+
+    # The manifest file this requirement was declared in, e.g. "Gemfile".
+    sig { returns(T.nilable(String)) }
+    def file
+      self[:file]
+    end
+
+    # The dependency groups this requirement belongs to, e.g. ["dev"] or
+    # [:default]. Element types vary by ecosystem (strings or symbols).
+    # Nilable because some requirement entries are constructed with
+    # groups: nil, and the reader must reflect that to stay a drop-in for
+    # the underlying hash access under sorbet-runtime.
+    sig { returns(T.nilable(T::Array[T.untyped])) }
+    def groups
+      self[:groups]
+    end
+
+    # The source details for the dependency, e.g.
+    # { type: "git", url: "https://github.com/..." }. Keys may be symbols
+    # or strings depending on whether the requirement was built by a file
+    # parser or deserialised from a job definition.
+    sig { returns(T.nilable(T::Hash[T.any(Symbol, String), T.untyped])) }
+    def source
+      self[:source]
+    end
+
+    # Optional ecosystem-specific metadata about the requirement, e.g.
+    # { property_name: "rails.version" }.
+    sig { returns(T.nilable(T::Hash[T.any(Symbol, String), T.untyped])) }
+    def metadata
+      self[:metadata]
+    end
+    # rubocop:enable Sorbet/ForbidTUntyped
+  end
+end

data/lib/dependabot/file_parsers/base/dependency_set.rb

@@ -33,7 +33,7 @@ module Dependabot
           @dependencies.values.filter_map(&:combined)
         end
 
-        sig { params(dep: Dependabot::Dependency).returns(T.untyped) }
+        sig { params(dep: Dependabot::Dependency).returns(T.self_type) }
         def <<(dep)
           T.must(@dependencies[key_for_dependency(dep)]) << dep
           self

data/lib/dependabot/file_parsers/base.rb

@@ -28,6 +28,11 @@ module Dependabot
       sig { returns(T::Hash[Symbol, T.untyped]) }
       attr_reader :options
 
+      sig { returns(T::Boolean) }
+      def reject_external_code?
+        @reject_external_code
+      end
+
       sig do
         params(
           dependency_files: T::Array[Dependabot::DependencyFile],

data/lib/dependabot/file_updaters/artifact_updater.rb

@@ -1,4 +1,4 @@
-# typed: strict
+# typed: strong
 # frozen_string_literal: true
 
 require "sorbet-runtime"
@@ -120,25 +120,46 @@ module Dependabot
 
       sig do
         overridable
-          .params(parameters: T::Hash[Symbol, T.untyped])
+          .params(
+            name: String,
+            content: T.nilable(String),
+            directory: String,
+            type: String,
+            support_file: T::Boolean,
+            vendored_file: T::Boolean,
+            symlink_target: T.nilable(String),
+            content_encoding: String,
+            deleted: T::Boolean,
+            operation: String,
+            mode: T.nilable(String)
+          )
           .returns(Dependabot::DependencyFile)
       end
-      def create_dependency_file(parameters)
+      def create_dependency_file(
+        name:,
+        content: nil,
+        directory: "/",
+        type: "file",
+        support_file: false,
+        vendored_file: false,
+        symlink_target: nil,
+        content_encoding: Dependabot::DependencyFile::ContentEncoding::UTF_8,
+        deleted: false,
+        operation: Dependabot::DependencyFile::Operation::UPDATE,
+        mode: nil
+      )
         Dependabot::DependencyFile.new(
-          name: parameters.fetch(:name),
-          content: parameters[:content],
-          directory: parameters.fetch(:directory, "/"),
-          type: parameters.fetch(:type, "file"),
-          support_file: parameters.fetch(:support_file, false),
-          vendored_file: parameters.fetch(:vendored_file, false),
-          symlink_target: parameters[:symlink_target],
-          content_encoding: parameters.fetch(
-            :content_encoding,
-            Dependabot::DependencyFile::ContentEncoding::UTF_8
-          ),
-          deleted: parameters.fetch(:deleted, false),
-          operation: parameters.fetch(:operation, Dependabot::DependencyFile::Operation::UPDATE),
-          mode: parameters[:mode]
+          name: name,
+          content: content,
+          directory: directory,
+          type: type,
+          support_file: support_file,
+          vendored_file: vendored_file,
+          symlink_target: symlink_target,
+          content_encoding: content_encoding,
+          deleted: deleted,
+          operation: operation,
+          mode: mode
         )
       end
     end

data/lib/dependabot/file_updaters/vendor_updater.rb

@@ -31,27 +31,51 @@ module Dependabot
 
       private
 
+      # VendorUpdater always flags files as vendored, so it accepts but ignores
+      # the vendored_file argument. The parameter must stay to keep the override
+      # signature compatible with ArtifactUpdater#create_dependency_file.
       sig do
         override
-          .params(parameters: T::Hash[Symbol, T.untyped])
+          .params(
+            name: String,
+            content: T.nilable(String),
+            directory: String,
+            type: String,
+            support_file: T::Boolean,
+            vendored_file: T::Boolean,
+            symlink_target: T.nilable(String),
+            content_encoding: String,
+            deleted: T::Boolean,
+            operation: String,
+            mode: T.nilable(String)
+          )
           .returns(Dependabot::DependencyFile)
       end
-      def create_dependency_file(parameters)
-        Dependabot::DependencyFile.new(
-          name: parameters.fetch(:name),
-          content: parameters[:content],
-          directory: parameters.fetch(:directory, "/"),
-          type: parameters.fetch(:type, "file"),
-          support_file: parameters.fetch(:support_file, false),
+      def create_dependency_file(
+        name:,
+        content: nil,
+        directory: "/",
+        type: "file",
+        support_file: false,
+        vendored_file: false, # rubocop:disable Lint/UnusedMethodArgument
+        symlink_target: nil,
+        content_encoding: Dependabot::DependencyFile::ContentEncoding::UTF_8,
+        deleted: false,
+        operation: Dependabot::DependencyFile::Operation::UPDATE,
+        mode: nil
+      )
+        super(
+          name: name,
+          content: content,
+          directory: directory,
+          type: type,
+          support_file: support_file,
           vendored_file: true,
-          symlink_target: parameters[:symlink_target],
-          content_encoding: parameters.fetch(
-            :content_encoding,
-            Dependabot::DependencyFile::ContentEncoding::UTF_8
-          ),
-          deleted: parameters.fetch(:deleted, false),
-          operation: parameters.fetch(:operation, Dependabot::DependencyFile::Operation::UPDATE),
-          mode: parameters[:mode]
+          symlink_target: symlink_target,
+          content_encoding: content_encoding,
+          deleted: deleted,
+          operation: operation,
+          mode: mode
         )
       end
     end

data/lib/dependabot/git_commit_checker.rb

@@ -14,6 +14,7 @@ require "dependabot/source"
 require "dependabot/dependency"
 require "dependabot/credential"
 require "dependabot/git_metadata_fetcher"
+require "dependabot/git_tag_details"
 module Dependabot
   # rubocop:disable Metrics/ClassLength
   class GitCommitChecker
@@ -159,31 +160,31 @@ module Dependabot
       local_repo_git_metadata_fetcher.head_commit_for_ref(name)
     end
 
-    sig { returns(T.nilable(T::Hash[Symbol, T.untyped])) }
+    sig { returns(T.nilable(Dependabot::GitTagDetails)) }
     def local_ref_for_latest_version_matching_existing_precision
       allowed_refs = local_tag_for_pinned_sha ? allowed_version_tags : allowed_version_refs
 
       max_local_tag_for_current_precision(allowed_refs)
     end
 
-    sig { returns(T.nilable(T::Hash[Symbol, T.untyped])) }
+    sig { returns(T.nilable(Dependabot::GitTagDetails)) }
     def local_ref_for_latest_version_lower_precision
       allowed_refs = local_tag_for_pinned_sha ? allowed_version_tags : allowed_version_refs
 
       max_local_tag_for_lower_precision(allowed_refs)
     end
 
-    sig { returns(T.nilable(T::Hash[Symbol, T.untyped])) }
+    sig { returns(T.nilable(Dependabot::GitTagDetails)) }
     def local_tag_for_latest_version
       max_local_tag(allowed_version_tags)
     end
 
-    sig { returns(T::Array[T::Hash[Symbol, T.untyped]]) }
+    sig { returns(T::Array[Dependabot::GitTagDetails]) }
     def local_tags_for_allowed_versions_matching_existing_precision
       select_matching_existing_precision(allowed_version_tags).filter_map { |t| to_local_tag(t) }
     end
 
-    sig { returns(T::Array[T::Hash[Symbol, T.untyped]]) }
+    sig { returns(T::Array[Dependabot::GitTagDetails]) }
     def local_tags_for_allowed_versions
       allowed_version_tags.filter_map { |t| to_local_tag(t) }
     end
@@ -272,7 +273,7 @@ module Dependabot
       local_tags_matching_sha(commit_sha).map(&:name)
     end
 
-    sig { params(tags: T::Array[Dependabot::GitRef]).returns(T.nilable(T::Hash[Symbol, T.untyped])) }
+    sig { params(tags: T::Array[Dependabot::GitRef]).returns(T.nilable(Dependabot::GitTagDetails)) }
     def max_local_tag(tags)
       max_version_tag = tags.max_by { |t| version_from_tag(t) }
 
@@ -295,12 +296,12 @@ module Dependabot
     sig { returns(T::Array[String]) }
     attr_reader :ignored_versions
 
-    sig { params(tags: T::Array[Dependabot::GitRef]).returns(T.nilable(T::Hash[Symbol, T.untyped])) }
+    sig { params(tags: T::Array[Dependabot::GitRef]).returns(T.nilable(Dependabot::GitTagDetails)) }
     def max_local_tag_for_current_precision(tags)
       max_local_tag(select_matching_existing_precision(tags))
     end
 
-    sig { params(tags: T::Array[Dependabot::GitRef]).returns(T.nilable(T::Hash[Symbol, T.untyped])) }
+    sig { params(tags: T::Array[Dependabot::GitRef]).returns(T.nilable(Dependabot::GitTagDetails)) }
     def max_local_tag_for_lower_precision(tags)
       max_local_tag(select_lower_precision(tags))
     end
@@ -553,17 +554,17 @@ module Dependabot
       prefix.length > 1 ? prefix.gsub(/v$/i, "") : prefix.gsub(/^v$/i, "")
     end
 
-    sig { params(tag: T.nilable(Dependabot::GitRef)).returns(T.nilable(T::Hash[Symbol, T.untyped])) }
+    sig { params(tag: T.nilable(Dependabot::GitRef)).returns(T.nilable(Dependabot::GitTagDetails)) }
     def to_local_tag(tag)
       return unless tag
 
       version = version_from_tag(tag)
-      {
+      GitTagDetails.new(
         tag: tag.name,
         version: version,
         commit_sha: tag.commit_sha,
         tag_sha: tag.ref_sha
-      }
+      )
     end
 
     sig { returns(T.nilable(String)) }

data/lib/dependabot/git_tag_details.rb

@@ -0,0 +1,78 @@
+# typed: strict
+# frozen_string_literal: true
+
+require "sorbet-runtime"
+
+module Dependabot
+  # A git tag (or ref) resolved to a version, as produced by GitCommitChecker's
+  # local_tag_for_* / local_ref_for_* methods, e.g.:
+  #
+  #   {
+  #     tag: "v1.2.0",
+  #     version: Dependabot::Version.new("1.2.0"),
+  #     commit_sha: "a1b2c3...",
+  #     tag_sha: "d4e5f6..." # nil for lightweight tags
+  #   }
+  #
+  # Distinct from Dependabot::GitTagWithDetail, which carries a tag name and
+  # release date for cooldown handling.
+  #
+  # Subclasses Hash so it is a drop-in replacement at the many call sites that
+  # read entries with [:key] / fetch and treat them as
+  # T::Hash[Symbol, T.untyped], while exposing typed readers for the well-known
+  # keys. Instances compare equal (Hash#==) to plain hashes with the same
+  # content, so existing comparisons and API payloads are unaffected.
+  class GitTagDetails < Hash
+    extend T::Sig
+    extend T::Generic
+
+    # The values are heterogeneous (strings and a version object), so this
+    # bridge class is necessarily untyped at the Hash level; the typed readers
+    # below are the migration path.
+    # rubocop:disable Sorbet/ForbidTUntyped
+    K = type_member { { fixed: Symbol } }
+    V = type_member { { fixed: T.untyped } }
+    Elem = type_member { { fixed: [Symbol, T.untyped] } }
+    # rubocop:enable Sorbet/ForbidTUntyped
+
+    sig do
+      params(
+        tag: String,
+        version: T.nilable(Gem::Version),
+        commit_sha: T.nilable(String),
+        tag_sha: T.nilable(String)
+      ).void
+    end
+    def initialize(tag:, version: nil, commit_sha: nil, tag_sha: nil)
+      super()
+      self[:tag] = tag
+      self[:version] = version
+      self[:commit_sha] = commit_sha
+      self[:tag_sha] = tag_sha
+    end
+
+    # The tag or ref name, e.g. "v1.2.0".
+    sig { returns(String) }
+    def tag
+      self[:tag]
+    end
+
+    # The version parsed from the tag name.
+    sig { returns(T.nilable(Gem::Version)) }
+    def version
+      self[:version]
+    end
+
+    # The SHA of the commit the tag points at.
+    sig { returns(T.nilable(String)) }
+    def commit_sha
+      self[:commit_sha]
+    end
+
+    # The SHA of the tag object itself (nil for lightweight tags).
+    sig { returns(T.nilable(String)) }
+    def tag_sha
+      self[:tag_sha]
+    end
+  end
+end

data/lib/dependabot/metadata_finders/base/commits_finder.rb

@@ -145,7 +145,7 @@ module Dependabot
         end
 
         # TODO: Refactor me so that Composer doesn't need to be special cased
-        sig { params(requirements: T.nilable(T::Array[T::Hash[Symbol, T.untyped]])).returns(T::Boolean) }
+        sig { params(requirements: T.nilable(T::Array[Dependabot::DependencyRequirement])).returns(T::Boolean) }
         def git_source?(requirements)
           # Special case Composer, which uses git as a source but handles tags
           # internally

data/lib/dependabot/notices.rb

@@ -59,7 +59,7 @@ module Dependabot
 
     # Converts the Notice object to a hash.
     # @return [Hash] The hash representation of the notice.
-    sig { returns(T::Hash[Symbol, T.untyped]) }
+    sig { returns(T::Hash[Symbol, T.any(String, T::Boolean)]) }
     def to_hash
       {
         mode: @mode,

data/lib/dependabot/pull_request_creator/branch_namer/solo_strategy.rb

@@ -119,21 +119,21 @@ module Dependabot
 
         sig { params(dependency: Dependabot::Dependency).returns(String) }
         def sanitized_requirement(dependency)
-          new_library_requirement(dependency)
-            .delete(" ")
-            .gsub("!=", "neq-")
-            .gsub(">=", "gte-")
-            .gsub("<=", "lte-")
-            .gsub("~>", "tw-")
-            .gsub("^", "tw-")
-            .gsub("||", "or-")
-            .gsub("~", "approx-")
-            .gsub("~=", "tw-")
-            .gsub(/==*/, "eq-")
-            .gsub(">", "gt-")
-            .gsub("<", "lt-")
-            .gsub("*", "star")
-            .gsub(",", "-and-")
+          T.must(new_library_requirement(dependency))
+           .delete(" ")
+           .gsub("!=", "neq-")
+           .gsub(">=", "gte-")
+           .gsub("<=", "lte-")
+           .gsub("~>", "tw-")
+           .gsub("^", "tw-")
+           .gsub("||", "or-")
+           .gsub("~", "approx-")
+           .gsub("~=", "tw-")
+           .gsub(/==*/, "eq-")
+           .gsub(">", "gt-")
+           .gsub("<", "lt-")
+           .gsub("*", "star")
+           .gsub(",", "-and-")
         end
 
         sig { params(dependency: Dependabot::Dependency).returns(T.nilable(String)) }
@@ -176,7 +176,7 @@ module Dependabot
           previous_ref(dependency) != new_ref(dependency)
         end
 
-        sig { params(dependency: Dependabot::Dependency).returns(T.untyped) }
+        sig { params(dependency: Dependabot::Dependency).returns(T.nilable(String)) }
         def new_library_requirement(dependency)
           updated_reqs =
             dependency.requirements - T.must(dependency.previous_requirements)

data/lib/dependabot/update_checkers/base.rb

@@ -182,7 +182,7 @@ module Dependabot
         dependency.version
       end
 
-      sig { overridable.returns(T::Array[T::Hash[Symbol, T.untyped]]) }
+      sig { overridable.returns(T::Array[Dependabot::DependencyRequirement]) }
       def updated_requirements
         raise NotImplementedError
       end
@@ -226,6 +226,20 @@ module Dependabot
 
       private
 
+      # Wraps an array of raw requirement hashes (e.g. the output of an
+      # ecosystem RequirementsUpdater) into typed DependencyRequirement
+      # objects, so updated_requirements overrides can satisfy the typed
+      # return contract. Entries that are already DependencyRequirement
+      # instances are returned as-is; plain hashes are wrapped. Re-wrapping
+      # would produce a value-equal copy, so skipping it avoids needless
+      # allocations.
+      sig { params(requirements: T::Array[T::Hash[Symbol, T.untyped]]).returns(T::Array[Dependabot::DependencyRequirement]) }
+      def wrap_requirements(requirements)
+        requirements.map do |requirement|
+          requirement.is_a?(Dependabot::DependencyRequirement) ? requirement : Dependabot::DependencyRequirement.create(requirement)
+        end
+      end
+
       sig { returns(T::Array[Dependabot::SecurityAdvisory]) }
       def active_advisories
         security_advisories.select { |a| a.vulnerable?(T.must(current_version)) }

data/lib/dependabot.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Dependabot
-  VERSION = "0.381.0"
+  VERSION = "0.382.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dependabot-common
 version: !ruby/object:Gem::Version
-  version: 0.381.0
+  version: 0.382.0
 platform: ruby
 authors:
 - Dependabot
@@ -534,6 +534,7 @@ files:
 - lib/dependabot/dependency_graphers/base.rb
 - lib/dependabot/dependency_graphers/generic.rb
 - lib/dependabot/dependency_group.rb
+- lib/dependabot/dependency_requirement.rb
 - lib/dependabot/ecosystem.rb
 - lib/dependabot/errors.rb
 - lib/dependabot/experiments.rb
@@ -553,6 +554,7 @@ files:
 - lib/dependabot/git_commit_checker.rb
 - lib/dependabot/git_metadata_fetcher.rb
 - lib/dependabot/git_ref.rb
+- lib/dependabot/git_tag_details.rb
 - lib/dependabot/git_tag_with_detail.rb
 - lib/dependabot/logger.rb
 - lib/dependabot/metadata_finders.rb
@@ -617,7 +619,7 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/dependabot/dependabot-core/issues
-  changelog_uri: https://github.com/dependabot/dependabot-core/releases/tag/v0.381.0
+  changelog_uri: https://github.com/dependabot/dependabot-core/releases/tag/v0.382.0
 rdoc_options: []
 require_paths:
 - lib