sec_id 6.0.0 → 7.0.0

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.0.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
@@ -85,7 +89,7 @@ module SecID
     # @return [Hash] hash with :input and :candidates keys
     def explain(str, types: nil)
       input = str.to_s.strip
-      target_keys = types || identifier_list.map { |k| k.short_name.downcase.to_sym }
+      target_keys = types || identifier_list.map(&:type_key)
       candidates = target_keys.map do |key|
         instance = self[key].new(input)
         { type: key, valid: instance.valid?, errors: instance.errors.details }
@@ -143,8 +147,7 @@ module SecID
 
     # @return [void]
     def register_identifier(klass)
-      key = klass.name.split('::').last.downcase.to_sym
-      identifier_map[key] = klass
+      identifier_map[klass.type_key] = klass
       identifier_list << klass
       @detector = nil
       @scanner = nil
@@ -196,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'
@@ -220,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

@@ -33,13 +33,20 @@ module SecID
     # RBS forbids narrowing an inherited ivar's type.
     def identifier: () -> String?
 
+    def self.type_key: () -> Symbol
+    # `@api private` in YARD, but public here: Detector and Scanner call it from outside.
+    def self.detection_priority: () -> Array[Integer | Float | nil]
     def self.short_name: () -> String
     def self.full_name: () -> String
     def self.id_length: () -> (Integer | ::Range[Integer] | ::Array[Integer])
     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
@@ -49,24 +56,28 @@ module SecID
     def hash: () -> Integer
     def to_h: () -> Hash[Symbol, untyped]
     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
 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

data/sig/sec_id/deprecation.rbs

@@ -0,0 +1,6 @@
+module SecID
+  # Emits standardized, silenceable deprecation warnings for the v7 → v8 rename bridge.
+  module Deprecation
+    def self.warn: (old: String, new: String, ?removed_in: String) -> void
+  end
+end

data/sig/sec_id/detector.rbs

@@ -3,8 +3,6 @@ module SecID
   #
   # @api private
   class Detector
-    type priority = Array[Integer | Float | nil]
-
     def initialize: (Array[singleton(Base)] identifier_list) -> void
     def call: (SecID::input str) -> Array[Symbol]
     def matches?: (SecID::input str) -> bool
@@ -17,8 +15,6 @@ module SecID
     def precompute: () -> void
     def build_discriminator_sets: () -> void
     def build_length_table: () -> void
-    def build_priority_table: () -> void
-    def build_key_table: () -> void
     def stage1_special_chars: (String upcased) -> Array[singleton(Base)]?
     def stage2_length: (Integer length) -> Array[singleton(Base)]
     def stage3_charset: (String upcased, Array[singleton(Base)] candidates) -> Array[singleton(Base)]
@@ -29,7 +25,5 @@ module SecID
     @space_only_types: Array[singleton(Base)]
     @special_types: Array[singleton(Base)]
     @candidates_by_length: Hash[Integer, Array[singleton(Base)]]
-    @priority_for: Hash[singleton(Base), priority]
-    @key_for: Hash[singleton(Base), Symbol]
   end
 end

data/sig/sec_id/dti.rbs

@@ -15,13 +15,18 @@ module SecID
     GRANDFATHERED_CODES: Hash[String, String]
 
     def initialize: (SecID::input dti) -> void
+    def calculate_checksum: () -> String
+    def self.checksum: (SecID::input id) -> String
+    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
     def calculate_check_digit: () -> String
+    # @deprecated v7 bridge alias for `checksum`; removed in v8.
+    def self.check_digit: (SecID::input id) -> String
     private def self.generate_body: (Random random) -> String
 
     private
 
     def components: () -> Hash[Symbol, untyped]
-    def grandfathered_check_digit: (untyped base) -> String?
+    def grandfathered_checksum: (untyped base) -> String?
     def iso7064_mod31_30_check_char: (untyped base) -> String
   end
 end

data/sig/sec_id/figi.rbs

@@ -17,7 +17,11 @@ module SecID
 
     def initialize: (SecID::input figi) -> 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
 

data/sig/sec_id/iban.rbs

@@ -26,7 +26,11 @@ module SecID
 
     def initialize: (SecID::input iban) -> void
     def restore: () -> 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 valid_bban_format?: () -> bool
@@ -38,13 +42,13 @@ module SecID
     private
 
     def components: () -> Hash[Symbol, untyped]
-    def check_digit_width: () -> Integer
+    def checksum_width: () -> Integer
     def valid_format?: () -> bool
     def detect_errors: () -> Array[Symbol]
     def validation_message: (Symbol code) -> String?
-    def extract_check_digit_and_bban: (String rest) -> void
+    def extract_checksum_and_bban: (String rest) -> void
     def expected_bban_length_for_country: () -> Integer?
-    def check_digits?: (untyped rest, Integer? expected_bban_length) -> bool
+    def checksum?: (untyped rest, Integer? expected_bban_length) -> bool
     def extract_bban_components: () -> void
     def valid_bban_length_only?: () -> bool
     def numeric_string_for_check: () -> String

data/sig/sec_id/isin.rbs

@@ -19,7 +19,11 @@ module SecID
 
     def initialize: (SecID::input isin) -> 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_cusip: () -> CUSIP

data/sig/sec_id/lei.rbs

@@ -20,14 +20,18 @@ module SecID
 
     def initialize: (SecID::input lei) -> 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
 
     private
 
     def components: () -> Hash[Symbol, untyped]
-    def check_digit_width: () -> Integer
+    def checksum_width: () -> Integer
     def numeric_identifier: () -> String
   end
 end

data/sig/sec_id/scanner.rbs

@@ -28,8 +28,8 @@ module SecID
     private
 
     def precompute: () -> void
-    def build_key_table: () -> void
-    def build_priority_table: () -> void
+    def build_candidate_partitions: () -> void
+    def build_length_table: () -> void
     def scan_text: (String input, Array[singleton(Base)] target_classes) { (Match) -> void } -> void
     def identify_candidate: (untyped match_data, Array[singleton(Base)] target_classes) -> Match?
     def try_classes: (String raw, String cleaned, Integer start_pos, Array[singleton(Base)] classes) -> Match?
@@ -40,7 +40,5 @@ module SecID
     @occ_classes: Array[singleton(Base)]
     @simple_classes: Array[singleton(Base)]
     @candidates_by_length: Hash[Integer, Array[singleton(Base)]]
-    @priority_for: Hash[singleton(Base), Array[Integer | Float | nil]]
-    @key_for: Hash[singleton(Base), Symbol]
   end
 end

data/sig/sec_id/sedol.rbs

@@ -19,7 +19,11 @@ module SecID
 
     def initialize: (SecID::input sedol) -> void
     def to_isin: (?String country_code) -> ISIN
+    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/upi.rbs

@@ -0,0 +1,29 @@
+module SecID
+  # Unique Product Identifier (UPI, ISO 4914).
+  class UPI < Base
+    include Checkable
+    extend Checkable::ClassMethods
+
+    FULL_NAME: String
+    ID_LENGTH: Integer
+    EXAMPLE: String
+    VALID_CHARS_REGEX: ::Regexp
+    ID_REGEX: ::Regexp
+    ALPHABET: Array[String]
+    ALPHABET_VALUE: Hash[String, Integer]
+    GENERATE_CHARSET: Array[String]
+
+    def initialize: (SecID::input upi) -> void
+    def calculate_checksum: () -> String
+    def self.checksum: (SecID::input id) -> String
+    # @deprecated v7 bridge alias for `calculate_checksum`; removed in v8.
+    def calculate_check_digit: () -> String
+    # @deprecated v7 bridge alias for `checksum`; removed in v8.
+    def self.check_digit: (SecID::input id) -> String
+    private def self.generate_body: (Random random) -> String
+
+    private
+
+    def components: () -> Hash[Symbol, untyped]
+  end
+end

data/sig/sec_id.rbs

@@ -7,10 +7,13 @@ module SecID
   class InvalidFormatError < Error
   end
 
-  # Raised when the check digit does not match the calculated value.
-  class InvalidCheckDigitError < Error
+  # Raised when the checksum does not match the calculated value.
+  class InvalidChecksumError < Error
   end
 
+  # @deprecated v7 bridge constant alias for `InvalidChecksumError` (same class object); removed in v8.
+  InvalidCheckDigitError: singleton(InvalidChecksumError)
+
   # Raised for type-specific structural errors.
   class InvalidStructureError < Error
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sec_id
 version: !ruby/object:Gem::Version
-  version: 6.0.0
+  version: 7.0.0
 platform: ruby
 authors:
 - Leonid Svyatov
@@ -11,10 +11,10 @@ date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Validate, normalize, parse, convert, generate, and classify securities
   identifiers. Auto-detect identifier type from any string. Calculate and restore
-  check digits. Generate format-valid identifiers as test fixtures. Decode CFI codes
+  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.
+  CIK, OCC, WKN, Valoren, CFI, FISN, BIC, DTI, and UPI.
 email:
 - leonid@svyatov.ru
 executables: []
@@ -44,6 +44,7 @@ files:
 - lib/sec_id/concerns/validatable.rb
 - lib/sec_id/cusip.rb
 - lib/sec_id/deep_freeze.rb
+- lib/sec_id/deprecation.rb
 - lib/sec_id/detector.rb
 - lib/sec_id/dti.rb
 - lib/sec_id/errors.rb
@@ -57,6 +58,7 @@ files:
 - lib/sec_id/railtie.rb
 - lib/sec_id/scanner.rb
 - lib/sec_id/sedol.rb
+- lib/sec_id/upi.rb
 - lib/sec_id/valoren.rb
 - lib/sec_id/version.rb
 - lib/sec_id/wkn.rb
@@ -79,6 +81,7 @@ files:
 - sig/sec_id/concerns/validatable.rbs
 - sig/sec_id/cusip.rbs
 - sig/sec_id/deep_freeze.rbs
+- sig/sec_id/deprecation.rbs
 - sig/sec_id/detector.rbs
 - sig/sec_id/dti.rbs
 - sig/sec_id/errors.rbs
@@ -91,6 +94,7 @@ files:
 - sig/sec_id/occ.rbs
 - sig/sec_id/scanner.rbs
 - sig/sec_id/sedol.rbs
+- sig/sec_id/upi.rbs
 - sig/sec_id/valoren.rbs
 - sig/sec_id/version.rbs
 - sig/sec_id/wkn.rbs