sec_id 6.1.0 → 7.0.0

data/lib/sec_id/iban.rb

@@ -6,8 +6,8 @@ module SecID
   # International Bank Account Number (IBAN) - an international standard for identifying
   # bank accounts across national borders (ISO 13616).
   #
-  # Format: 2-letter country code + 2-digit check digits + BBAN (Basic Bank Account Number, 11-30 chars)
-  # Note: Unlike other SecID identifiers, the check digits are in positions 3-4, not at the end.
+  # Format: 2-letter country code + 2-digit checksum + BBAN (Basic Bank Account Number, 11-30 chars)
+  # Note: Unlike other SecID identifiers, the checksum are in positions 3-4, not at the end.
   #
   # @see https://en.wikipedia.org/wiki/International_Bank_Account_Number
   # @see https://www.iban.com/structure
@@ -15,7 +15,7 @@ module SecID
   # @example Validate an IBAN
   #   SecID::IBAN.valid?('DE89370400440532013000')  #=> true
   #
-  # @example Restore check digits
+  # @example Restore checksum
   #   SecID::IBAN.restore!('DE00370400440532013000')  #=> #<SecID::IBAN>
   class IBAN < Base
     include Checkable
@@ -30,7 +30,7 @@ module SecID
     VALID_CHARS_REGEX = /\A[A-Z0-9]+\z/
 
     # Regular expression for parsing IBAN components.
-    # Note: Check digit positioning is handled in initialize, not in the regex.
+    # Note: Checksum positioning is handled in initialize, not in the regex.
     ID_REGEX = /\A
       (?<country_code>[A-Z]{2})
       (?<rest>[A-Z0-9]{13,32})
@@ -62,7 +62,7 @@ module SecID
     # @return [String, nil] the account number (extracted from BBAN if country rules define it)
     attr_reader :account_number
 
-    # @return [String, nil] the national check digit (extracted from BBAN if country rules define it)
+    # @return [String, nil] the national checksum (extracted from BBAN if country rules define it)
     attr_reader :national_check
 
     # @param iban [String] the IBAN string to parse
@@ -72,7 +72,7 @@ module SecID
       rest = iban_parts[:rest]
 
       if @country_code && rest
-        extract_check_digit_and_bban(rest)
+        extract_checksum_and_bban(rest)
         @identifier = "#{@country_code}#{@bban}" if @bban
       end
 
@@ -82,19 +82,19 @@ module SecID
     # @return [String]
     # @raise [InvalidFormatError] if the IBAN format is invalid
     def restore
-      cd = calculate_check_digit
+      cd = calculate_checksum
       "#{country_code}#{cd.to_s.rjust(2, '0')}#{bban}"
     end
 
     # @return [Integer] the calculated 2-digit check value (1-98)
     # @raise [InvalidFormatError] if the IBAN format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod97(numeric_string_for_check)
     end
 
-    # Generates a random IBAN body for a numeric-BBAN country with placeholder check digits.
-    # The default {Generatable::ClassMethods#generate} restores the real check digits via `restore!`.
+    # Generates a random IBAN body for a numeric-BBAN country with placeholder checksum.
+    # The default {Generatable::ClassMethods#generate} restores the real checksum via `restore!`.
     #
     # @param random [Random] source of randomness
     # @return [String] a country code + "00" + numeric BBAN
@@ -126,9 +126,9 @@ module SecID
 
     # @return [String]
     def to_s
-      return full_id unless check_digit
+      return full_id unless checksum
 
-      "#{country_code}#{check_digit.to_s.rjust(2, '0')}#{bban}"
+      "#{country_code}#{checksum.to_s.rjust(2, '0')}#{bban}"
     end
 
     # @return [String, nil]
@@ -140,7 +140,7 @@ module SecID
 
     # @return [Hash]
     def components
-      hash = { country_code:, bban:, check_digit: }
+      hash = { country_code:, bban:, checksum: }
       hash[:bank_code] = bank_code if bank_code
       hash[:branch_code] = branch_code if branch_code
       hash[:account_number] = account_number if account_number
@@ -149,7 +149,7 @@ module SecID
     end
 
     # @return [Integer]
-    def check_digit_width
+    def checksum_width
       2
     end
 
@@ -177,14 +177,14 @@ module SecID
 
     # @param rest [String] the IBAN string after country code
     # @return [void]
-    def extract_check_digit_and_bban(rest)
+    def extract_checksum_and_bban(rest)
       expected = expected_bban_length_for_country
 
-      if check_digits?(rest, expected)
-        @check_digit = rest[0, 2].to_i
+      if checksum?(rest, expected)
+        @checksum = rest[0, 2].to_i
         @bban = rest[2..]
       else
-        @check_digit = nil
+        @checksum = nil
         @bban = rest
       end
     end
@@ -197,11 +197,11 @@ module SecID
     # @param rest [String] the IBAN string after country code
     # @param expected_bban_length [Integer, nil] the expected BBAN length for the country
     # @return [Boolean]
-    def check_digits?(rest, expected_bban_length)
+    def checksum?(rest, expected_bban_length)
       return false unless rest[0, 2].match?(/\A\d{2}\z/)
       return true unless expected_bban_length
 
-      # If we know expected BBAN length, check if rest matches with or without check digits
+      # If we know expected BBAN length, check if rest matches with or without checksum
       rest.length == expected_bban_length + 2 || rest.length != expected_bban_length
     end
 

data/lib/sec_id/isin.rb

@@ -4,14 +4,14 @@ module SecID
   # International Securities Identification Number (ISIN) - a 12-character alphanumeric code
   # that uniquely identifies a security globally.
   #
-  # Format: 2-letter country code + 9-character NSIN + 1-digit check digit
+  # Format: 2-letter country code + 9-character NSIN + 1-digit checksum
   #
   # @see https://en.wikipedia.org/wiki/International_Securities_Identification_Number
   #
   # @example Validate an ISIN
   #   SecID::ISIN.valid?('US5949181045')  #=> true
   #
-  # @example Restore check digit
+  # @example Restore checksum
   #   SecID::ISIN.restore!('US594918104')  #=> #<SecID::ISIN>
   class ISIN < Base
     include Checkable
@@ -30,7 +30,7 @@ module SecID
       (?<identifier>
         (?<country_code>[A-Z]{2})
         (?<nsin>[A-Z0-9]{9}))
-      (?<check_digit>\d)?
+      (?<checksum>\d)?
     \z/x
 
     # Country codes that use CUSIP Global Services (CGS) for NSIN assignment.
@@ -71,19 +71,19 @@ module SecID
       @identifier = isin_parts[:identifier]
       @country_code = isin_parts[:country_code]
       @nsin = isin_parts[:nsin]
-      @check_digit = isin_parts[:check_digit]&.to_i
+      @checksum = isin_parts[:checksum]&.to_i
     end
 
     # @return [String, nil]
     def to_pretty_s
       return nil unless valid?
 
-      "#{country_code} #{nsin} #{check_digit}"
+      "#{country_code} #{nsin} #{checksum}"
     end
 
-    # @return [Integer] the calculated check digit (0-9)
+    # @return [Integer] the calculated checksum (0-9)
     # @raise [InvalidFormatError] if the ISIN format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod10(luhn_sum_standard(reversed_digits_multi(identifier)))
     end
@@ -91,7 +91,7 @@ module SecID
     # Generates a random ISIN body: 2-letter country code + 9-character NSIN.
     #
     # @param random [Random] source of randomness
-    # @return [String] an 11-character ISIN body without check digit
+    # @return [String] an 11-character ISIN body without checksum
     def self.generate_body(random)
       "#{random_string(ALPHA, 2, random: random)}#{random_string(ALPHANUMERIC, 9, random: random)}"
     end
@@ -177,6 +177,6 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { country_code:, nsin:, check_digit: }
+    def components = { country_code:, nsin:, checksum: }
   end
 end

data/lib/sec_id/lei.rb

@@ -4,7 +4,7 @@ module SecID
   # Legal Entity Identifier (LEI) - a 20-character alphanumeric code that
   # uniquely identifies legal entities participating in financial transactions.
   #
-  # Format: 4-character LOU ID + 2-character reserved + 12-character entity ID + 2-digit check digit
+  # Format: 4-character LOU ID + 2-character reserved + 12-character entity ID + 2-digit checksum
   #
   # @see https://en.wikipedia.org/wiki/Legal_Entity_Identifier
   # @see https://www.gleif.org/en/about-lei/iso-17442-the-lei-code-structure
@@ -12,8 +12,8 @@ module SecID
   # @example Validate a LEI
   #   SecID::LEI.valid?('529900T8BM49AURSDO55')  #=> true
   #
-  # @example Calculate check digit
-  #   SecID::LEI.check_digit('529900T8BM49AURSDO')  #=> 55
+  # @example Calculate checksum
+  #   SecID::LEI.checksum('529900T8BM49AURSDO')  #=> 55
   class LEI < Base
     include Checkable
 
@@ -32,7 +32,7 @@ module SecID
         (?<lou_id>[0-9A-Z]{4})
         (?<reserved>[0-9A-Z]{2})
         (?<entity_id>[0-9A-Z]{12}))
-      (?<check_digit>\d{2})?
+      (?<checksum>\d{2})?
     \z/x
 
     # @return [String, nil] the 4-character Local Operating Unit (LOU) identifier
@@ -51,7 +51,7 @@ module SecID
       @lou_id = lei_parts[:lou_id]
       @reserved = lei_parts[:reserved]
       @entity_id = lei_parts[:entity_id]
-      @check_digit = lei_parts[:check_digit]&.to_i
+      @checksum = lei_parts[:checksum]&.to_i
     end
 
     # @return [String, nil]
@@ -61,9 +61,9 @@ module SecID
       to_s.scan(/.{1,4}/).join(' ')
     end
 
-    # @return [Integer] the calculated 2-digit check digit (1-98)
+    # @return [Integer] the calculated 2-digit checksum (1-98)
     # @raise [InvalidFormatError] if the LEI format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod97("#{numeric_identifier}00")
     end
@@ -71,7 +71,7 @@ module SecID
     # Generates a random LEI body: 18 alphanumeric characters.
     #
     # @param random [Random] source of randomness
-    # @return [String] an 18-character LEI body without check digits
+    # @return [String] an 18-character LEI body without checksum
     def self.generate_body(random)
       random_string(ALPHANUMERIC, 18, random: random)
     end
@@ -80,10 +80,10 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { lou_id:, reserved:, entity_id:, check_digit: }
+    def components = { lou_id:, reserved:, entity_id:, checksum: }
 
     # @return [Integer]
-    def check_digit_width
+    def checksum_width
       2
     end
 

data/lib/sec_id/occ.rb

@@ -6,7 +6,7 @@ module SecID
   # OCC Option Symbol - standardized option symbol format used by Option Clearing Corporation.
   # Format: 6-char underlying (padded) + 6-char date (YYMMDD) + type (C/P) + 8-digit strike (in mills).
   #
-  # @note OCC identifiers have no check digit and validation includes both format
+  # @note OCC identifiers have no checksum and validation includes both format
   #   and date parseability checks.
   #
   # @see https://en.wikipedia.org/wiki/Option_symbol#The_OCC_Option_Symbol

data/lib/sec_id/sedol.rb

@@ -4,7 +4,7 @@ module SecID
   # Stock Exchange Daily Official List (SEDOL) - a 7-character alphanumeric code
   # that identifies securities traded on the London Stock Exchange and other UK exchanges.
   #
-  # Format: 6-character identifier + 1-digit check digit
+  # Format: 6-character identifier + 1-digit checksum
   # Note: SEDOL excludes vowels (A, E, I, O, U) to avoid forming words.
   #
   # @see https://en.wikipedia.org/wiki/SEDOL
@@ -12,8 +12,8 @@ module SecID
   # @example Validate a SEDOL
   #   SecID::SEDOL.valid?('B19GKT4')  #=> true
   #
-  # @example Calculate check digit
-  #   SecID::SEDOL.check_digit('B19GKT')  #=> 4
+  # @example Calculate checksum
+  #   SecID::SEDOL.checksum('B19GKT')  #=> 4
   class SEDOL < Base
     include Checkable
 
@@ -30,10 +30,10 @@ module SecID
     # Excludes vowels (A, E, I, O, U) from valid characters.
     ID_REGEX = /\A
       (?<identifier>[0-9BCDFGHJKLMNPQRSTVWXYZ]{6})
-      (?<check_digit>\d)?
+      (?<checksum>\d)?
     \z/x
 
-    # Weights applied to each character position in the check digit calculation.
+    # Weights applied to each character position in the checksum calculation.
     CHARACTER_WEIGHTS = [1, 3, 1, 7, 3, 9].freeze
 
     # Characters valid in a SEDOL body (alphanumeric excluding vowels).
@@ -43,14 +43,14 @@ module SecID
     def initialize(sedol)
       sedol_parts = parse sedol
       @identifier = sedol_parts[:identifier]
-      @check_digit = sedol_parts[:check_digit]&.to_i
+      @checksum = sedol_parts[:checksum]&.to_i
     end
 
     # Valid country codes for SEDOL to ISIN conversion.
     ISIN_COUNTRY_CODES = Set.new(%w[GB IE GG IM JE FK]).freeze
 
     # @param country_code [String] the ISO 3166-1 alpha-2 country code (default: 'GB')
-    # @return [ISIN] a new ISIN instance with calculated check digit
+    # @return [ISIN] a new ISIN instance with calculated checksum
     # @raise [InvalidFormatError] if the country code is not valid for SEDOL
     def to_isin(country_code = 'GB')
       unless ISIN_COUNTRY_CODES.include?(country_code)
@@ -60,9 +60,9 @@ module SecID
       ISIN.new("#{country_code}00#{restore}").restore!
     end
 
-    # @return [Integer] the calculated check digit (0-9)
+    # @return [Integer] the calculated checksum (0-9)
     # @raise [InvalidFormatError] if the SEDOL format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod10(weighted_sum)
     end
@@ -70,7 +70,7 @@ module SecID
     # Generates a random SEDOL body: 6 characters excluding vowels.
     #
     # @param random [Random] source of randomness
-    # @return [String] a 6-character SEDOL body without check digit
+    # @return [String] a 6-character SEDOL body without checksum
     def self.generate_body(random)
       random_string(GENERATE_CHARSET, 6, random: random)
     end
@@ -79,7 +79,7 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { check_digit: }
+    def components = { checksum: }
 
     # NOTE: Not idiomatic Ruby, but optimized for performance.
     #

data/lib/sec_id/upi.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module SecID
+  # Unique Product Identifier (UPI, ISO 4914) - a 12-character code that identifies
+  # OTC derivative products for regulatory reporting, issued by the ANNA Derivatives
+  # Service Bureau.
+  #
+  # Format: fixed 'QZ' prefix + 9-character body + 1 check character, drawn from a
+  # 30-symbol alphabet (digits 0-9 plus consonants; vowels and 'Y' never appear).
+  # Validated fully offline via ISO 7064 hybrid MOD 31,30 over the 11 preceding characters.
+  #
+  # @see https://www.anna-dsb.com
+  #
+  # @example Validate a UPI
+  #   SecID::UPI.valid?('QZRBG6ZTKS42')  #=> true
+  #
+  # @example Restore check character
+  #   SecID::UPI.restore('QZRBG6ZTKS4')  #=> 'QZRBG6ZTKS42'
+  class UPI < Base
+    include Checkable
+
+    # Human-readable name of the standard.
+    FULL_NAME = 'Unique Product Identifier'
+    # Valid length of a normalized identifier.
+    ID_LENGTH = 12
+    # A representative valid identifier.
+    EXAMPLE = 'QZRBG6ZTKS42'
+    # Pattern matching the identifier's permitted character set (digits + consonants, no vowels/Y).
+    VALID_CHARS_REGEX = /\A[0-9B-DF-HJ-NP-TV-XZ]+\z/
+
+    # Regular expression for parsing UPI components: fixed 'QZ' prefix, 9-character body,
+    # optional check character.
+    ID_REGEX = /\A
+      (?<identifier>QZ[0-9B-DF-HJ-NP-TV-XZ]{9})
+      (?<checksum>[0-9B-DF-HJ-NP-TV-XZ])?
+    \z/x
+
+    # The 30-symbol UPI alphabet, ordered by check-character value (0-29).
+    ALPHABET = '0123456789BCDFGHJKLMNPQRSTVWXZ'.chars.freeze
+
+    # Maps each alphabet character to its check-character value (0-29).
+    ALPHABET_VALUE = ALPHABET.each_with_index.to_h.freeze
+
+    # Characters valid in a UPI body (same alphabet as VALID_CHARS_REGEX).
+    GENERATE_CHARSET = ALPHANUMERIC.grep(VALID_CHARS_REGEX).freeze
+
+    # @param upi [String] the UPI string to parse
+    def initialize(upi)
+      upi_parts = parse upi
+      @identifier = upi_parts[:identifier]
+      @checksum = upi_parts[:checksum]
+    end
+
+    # @return [String] the calculated check character
+    # @raise [InvalidFormatError] if the UPI format is invalid
+    def calculate_checksum
+      validate_format_for_calculation!
+      mod31_30_check_char(identifier, ALPHABET, ALPHABET_VALUE)
+    end
+
+    # Generates a random UPI body: the fixed 'QZ' prefix plus 9 characters drawn
+    # from the UPI alphabet.
+    #
+    # @param random [Random] source of randomness
+    # @return [String] an 11-character UPI body without check character
+    def self.generate_body(random)
+      "QZ#{random_string(GENERATE_CHARSET, 9, random: random)}"
+    end
+    private_class_method :generate_body
+
+    private
+
+    # @return [Hash]
+    def components = { checksum: }
+  end
+end

data/lib/sec_id/valoren.rb

@@ -6,7 +6,7 @@ module SecID
   #
   # Format: 5-9 numeric digits
   #
-  # @note Valoren identifiers have no check digit and validation is based solely on format.
+  # @note Valoren identifiers have no checksum and validation is based solely on format.
   #
   # @see https://en.wikipedia.org/wiki/Valoren_number
   #
@@ -52,7 +52,7 @@ module SecID
     end
 
     # @param country_code [String] the ISO 3166-1 alpha-2 country code (default: 'CH')
-    # @return [ISIN] a new ISIN instance with calculated check digit
+    # @return [ISIN] a new ISIN instance with calculated checksum
     # @raise [InvalidFormatError] if the country code is not CH or LI
     def to_isin(country_code = 'CH')
       unless ISIN_COUNTRY_CODES.include?(country_code)

data/lib/sec_id/version.rb

@@ -2,5 +2,5 @@
 
 module SecID
   # Current gem version.
-  VERSION = '6.1.0'
+  VERSION = '7.0.0'
 end

data/lib/sec_id/wkn.rb

@@ -38,7 +38,7 @@ module SecID
     end
 
     # @param country_code [String] the ISO 3166-1 alpha-2 country code (default: 'DE')
-    # @return [ISIN] a new ISIN instance with calculated check digit
+    # @return [ISIN] a new ISIN instance with calculated checksum
     # @raise [InvalidFormatError] if the country code is not DE
     # @raise [InvalidFormatError] if the WKN format is invalid
     def to_isin(country_code = 'DE')

data/lib/sec_id.rb

@@ -4,7 +4,7 @@ require 'sec_id/version'
 
 # Toolkit for securities identifiers — validate, normalize, parse, detect, convert,
 # generate, and classify ISIN, CUSIP, CEI, SEDOL, FIGI, LEI, IBAN, CIK, OCC, WKN,
-# Valoren, CFI, FISN, BIC, and DTI.
+# Valoren, CFI, FISN, BIC, DTI, and UPI.
 #
 # @see https://github.com/svyatov/sec_id
 module SecID
@@ -14,8 +14,12 @@ module SecID
   # Raised for invalid format, length, or characters.
   class InvalidFormatError < Error; end
 
-  # Raised when the check digit does not match the calculated value.
-  class InvalidCheckDigitError < Error; end
+  # Raised when the checksum does not match the calculated value.
+  class InvalidChecksumError < Error; end
+
+  # @deprecated Use {InvalidChecksumError}. Kept as a v7 bridge (same class object,
+  #   so `rescue` under either name keeps working); removed in v8.
+  InvalidCheckDigitError = InvalidChecksumError
 
   # Raised for type-specific structural errors (invalid prefix, category, group, BBAN, or date).
   class InvalidStructureError < Error; end
@@ -195,6 +199,7 @@ module SecID
   end
 end
 
+require 'sec_id/deprecation'
 require 'sec_id/deep_freeze'
 require 'sec_id/errors'
 require 'sec_id/concerns/normalizable'
@@ -219,6 +224,7 @@ require 'sec_id/cfi'
 require 'sec_id/fisn'
 require 'sec_id/bic'
 require 'sec_id/dti'
+require 'sec_id/upi'
 
 # Auto-activate the ActiveModel validator inside Rails; a no-op everywhere else (keeps the
 # default require zero-dependency). See SecID::Railtie and lib/sec_id/active_model.rb.

data/sec_id.gemspec

@@ -13,11 +13,11 @@ Gem::Specification.new do |spec|
   spec.summary       = 'A Ruby toolkit for securities identifiers — validate, parse, normalize, detect, convert, ' \
                        'generate, and classify.'
   spec.description   = 'Validate, normalize, parse, convert, generate, and classify securities identifiers. ' \
-                       'Auto-detect identifier type from any string. Calculate and restore check digits. Generate ' \
+                       'Auto-detect identifier type from any string. Calculate and restore checksums. Generate ' \
                        'format-valid identifiers as test fixtures. Decode CFI codes to full ISO 10962:2021 ' \
                        'classifications. Includes an opt-in ActiveModel/Rails validator that adds no runtime ' \
                        'dependency. Supports ISIN, CUSIP, CEI, SEDOL, FIGI, LEI, IBAN, CIK, OCC, WKN, Valoren, ' \
-                       'CFI, FISN, BIC, and DTI.'
+                       'CFI, FISN, BIC, DTI, and UPI.'
   spec.homepage      = 'https://github.com/svyatov/sec_id'
   spec.license       = 'MIT'
 

data/sig/sec_id/base.rbs

@@ -42,7 +42,11 @@ module SecID
     def self.length_values: () -> (::Array[Integer] | ::Range[Integer])
     def self.length_specificity: () -> (Integer | Float | nil)
     def self.example: () -> String
+    def self.has_checksum?: () -> bool
+
+    # @deprecated v7 bridge alias for `has_checksum?`; removed in v8.
     def self.has_check_digit?: () -> bool
+
     def self.inherited: (singleton(Base) subclass) -> void
 
     def initialize: (SecID::input _sec_id_number) -> void
@@ -54,24 +58,25 @@ module SecID
     def as_json: (*untyped) -> Hash[Symbol, untyped]
     def deconstruct_keys: (::Array[Symbol]? _keys) -> Hash[Symbol, untyped]
 
-    # Check-digit surface. Only the types that `include Checkable` implement these
+    # Checksum surface. Only the types that `include Checkable` implement these
     # (they raise/NoMethodError otherwise); declared on Base so `Generatable#generate`
-    # and `Checkable::ClassMethods` type-check without narrowing on `has_check_digit?`.
+    # and `Checkable::ClassMethods` type-check without narrowing on `has_checksum?`.
     def restore: () -> String
     def restore!: () -> self
-    def calculate_check_digit: () -> (Integer | String)
+    def calculate_checksum: () -> (Integer | String)
 
     def comparison_id: () -> String
 
     private
 
+    def components_with_deprecation_bridge: () -> Hash[Symbol, untyped]
     def components: () -> Hash[Symbol, untyped]
     def parse: (SecID::input sec_id_number) -> (::MatchData | ::Hash[Symbol, untyped])
 
     @full_id: String
     @identifier: untyped
     self.@short_name: String
-    self.@has_check_digit: bool
+    self.@has_checksum: bool
     self.@type_key: Symbol
     self.@detection_priority: Array[Integer | Float | nil]
   end

data/sig/sec_id/cei.rbs

@@ -15,7 +15,11 @@ module SecID
     attr_reader entity_id: String?
 
     def initialize: (SecID::input cei) -> void
+    def calculate_checksum: () -> Integer
+    def self.checksum: (SecID::input id) -> Integer
+    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
     def calculate_check_digit: () -> Integer
+    # @deprecated v7 bridge alias for `checksum`; removed in v8.
     def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
 

data/sig/sec_id/concerns/checkable.rbs

@@ -1,26 +1,35 @@
 module SecID
-  # Provides check-digit validation and calculation for identifiers with a check digit.
+  # Provides checksum validation and calculation for identifiers with a checksum.
   module Checkable : SecID::Base
     CHAR_TO_DIGITS: Hash[String, Integer | Array[Integer]]
     CHAR_TO_DIGIT: Hash[String, Integer]
 
     def self.included: (Module base) -> void
 
-    attr_reader check_digit: (Integer | String)?
+    attr_reader checksum: (Integer | String)?
 
     # Class methods added when Checkable is included.
     module ClassMethods : SecID::_IdentifierClass
-      def restore: (SecID::input id_without_check_digit) -> String
-      def restore!: (SecID::input id_without_check_digit) -> Base
+      def restore: (SecID::input id_without_checksum) -> String
+      def restore!: (SecID::input id_without_checksum) -> Base
+      def checksum: (SecID::input id) -> (Integer | String)
+
+      # @deprecated v7 bridge alias for `checksum`; removed in v8.
       def check_digit: (SecID::input id) -> (Integer | String)
     end
 
     def valid?: () -> bool
     def restore: () -> String
     def restore!: () -> self
-    def calculate_check_digit: () -> (Integer | String)
+    def calculate_checksum: () -> (Integer | String)
     def to_s: () -> String
 
+    # @deprecated v7 bridge alias for `checksum`; removed in v8.
+    def check_digit: () -> (Integer | String)?
+
+    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
+    def calculate_check_digit: () -> (Integer | String)
+
     private
 
     def luhn_sum_double_add_double: (Array[Integer] digits) -> Integer
@@ -29,13 +38,14 @@ module SecID
     def reversed_digits_single: (untyped id) -> Array[Integer]
     def reversed_digits_multi: (untyped id) -> Array[Integer]
     def error_codes: () -> Array[Symbol]
-    def check_digit_width: () -> Integer
+    def checksum_width: () -> Integer
     def validation_message: (Symbol code) -> String?
     def validate_format_for_calculation!: () -> void
     def mod10: (Integer sum) -> Integer
     def div10mod10: (Integer number) -> Integer
     def mod97: (String numeric_string) -> Integer
+    def mod31_30_check_char: (untyped base, Array[String] alphabet, Hash[String, Integer] alphabet_value) -> String
 
-    @check_digit: (Integer | String)?
+    @checksum: (Integer | String)?
   end
 end

data/sig/sec_id/concerns/generatable.rbs

@@ -10,7 +10,7 @@ module SecID
     # The class-object surface Generatable's methods call once extended.
     interface _GeneratableClass
       def new: (SecID::input) -> Base
-      def has_check_digit?: () -> bool
+      def has_checksum?: () -> bool
     end
 
     # Class methods added when Generatable is included.

data/sig/sec_id/concerns/validatable.rbs

@@ -33,7 +33,7 @@ module SecID
     def detect_errors: () -> Array[Symbol]
     def valid_length?: () -> bool
     def valid_characters?: () -> bool
-    def check_digit_width: () -> Integer
+    def checksum_width: () -> Integer
     def validation_message: (Symbol code) -> String?
     def build_error: (Symbol code, String? message) -> Errors::detail
 

data/sig/sec_id/cusip.rbs

@@ -16,7 +16,11 @@ module SecID
 
     def initialize: (SecID::input cusip) -> void
     def to_pretty_s: () -> String?
+    def calculate_checksum: () -> Integer
+    def self.checksum: (SecID::input id) -> Integer
+    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
     def calculate_check_digit: () -> Integer
+    # @deprecated v7 bridge alias for `checksum`; removed in v8.
     def self.check_digit: (SecID::input id) -> Integer
     private def self.generate_body: (Random random) -> String
     def to_isin: (String country_code) -> ISIN