tracking_number 2.4.0 → 3.0.0

data/lib/data/couriers/usps.json

@@ -5,7 +5,7 @@
     {
       "name": "USPS 20",
       "id": "usps_20",
-      "description": "20 digit USPS numbers",
+      "description": "Delivery and Signature Confirmation numbers, printed without the application identifier",
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "regex": [
         "\\s*(?<SerialNumber>",
@@ -18,8 +18,10 @@
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
         }
       },
       "test_numbers": {
@@ -37,43 +39,54 @@
           "name": "Service Type",
           "regex_group_name": "ServiceType",
           "lookup": [
-            {
-              "matches": "71",
-              "name": "Certified Mail"
-            },
-            {
-              "matches": "73",
-              "name": "Insured Mail"
-            },
-            {
-              "matches": "77",
-              "name": "Registered Mail"
-            },
-            {
-              "matches": "81",
-              "name": "Return Receipt For Merchanise"
-            }
+            { "matches": "01", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "02", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "0[34]", "name": "Delivery Confirmation", "description": "Retail" },
+            { "matches": "05", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured over $50" },
+            { "matches": "06", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured over $50" },
+            { "matches": "07", "name": "Delivery Confirmation", "description": "Priority Mail, insured $50 or under" },
+            { "matches": "08", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured $50 or under" },
+            { "matches": "14", "name": "Delivery Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "21", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "22", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "2[34]", "name": "Signature Confirmation", "description": "Retail" },
+            { "matches": "25", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured, all values" },
+            { "matches": "26", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured, all values" },
+            { "matches": "34", "name": "Signature Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "50", "name": "Electronic File Header", "description": "Used in the file header record only, never on a package" },
+            { "matches": "56", "name": "Passive Enroute Scan", "description": "A free scan as the parcel passes through a sorting plant, with no confirmation service attached" },
+            { "matches": "73", "name": "Insured Mail", "description": "Insured only, value over $50" },
+            { "matches": "82", "name": "Merchandise Return", "description": "With Delivery Confirmation" },
+            { "matches": "83", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value $50 or under" },
+            { "matches": "85", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value over $50" }
           ]
         }
       ]
     },
     {
-      "name": "USPS 22",
-      "id": "usps_22",
-      "description": "22 digit USPS numbers",
+      "name": "USPS IMpb N",
+      "id": "usps_impb_n",
+      "description": "IMpb constructs N01 through N10, issued online or by a vendor or meter",
+      "glossary": {
+        "ShipperId": { "description": "The company that holds the postal permit the package was mailed under, which Publication 199 calls the Mailer ID. Nine digits when it starts with 9, six otherwise." }
+      },
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "regex": [
-        "\\s*((?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}))?",
+        "\\s*((?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}(?=([0-9]\\s*){22}(?![0-9])|([0-9]\\s*){26}(?![0-9])))(?<DestinationZipPlus4>([0-9]\\s*){4}(?=([0-9]\\s*){22}(?![0-9])))?)?",
         "(?<SerialNumber>",
-        "(?<ServiceType>(9\\s*[4-8]\\s*))",
-        "(?<ShipperId>([0-9]\\s*){9})",
-        "(?<PackageId>([0-9]\\s*){10})",
+        "(?<ApplicationIdentifier>9\\s*4\\s*)",
+        "(?<ServiceType>([0-9]\\s*){3})",
+        "(?=9\\s*([0-9]\\s*){8}(([0-9]\\s*){15}|([0-9]\\s*){11}|([0-9]\\s*){7})[0-9]\\s*(?![0-9])",
+        "|[0-8]\\s*([0-9]\\s*){5}(([0-9]\\s*){14}|([0-9]\\s*){10})[0-9]\\s*(?![0-9]))",
+        "(?<ShipperId>9\\s*([0-9]\\s*){8}|[0-8]\\s*([0-9]\\s*){5})",
+        "(?<PackageId>([0-9]\\s*){15}|([0-9]\\s*){14}|([0-9]\\s*){11}|([0-9]\\s*){10}|([0-9]\\s*){7})",
         ")",
         "(?<CheckDigit>[0-9]\\s*)"
       ],
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
           "odds_multiplier": 1,
           "reverse": true
@@ -83,6 +96,8 @@
         "valid": [
           "420787459400111206206406260787",
           "9400111206206406260787",
+          "9400 1112 0108 0805 4830 16",
+          "9405803699300124287899",
           "9434611206206406227577",
           "9434611206206407667136",
           "9400111206206407628746",
@@ -94,160 +109,144 @@
           "2334611306206407667222"
         ]
       },
-      "partners": [{
-        "description": "DHL ECommerce uses USPS for last mile delivery",
-        "partner_type": "shipper",
-        "partner_id": "dhl_ecommerce_30",
-        "validation": {
-          "matches_all": [
-            {
-              "regex_group_name": "RoutingApplicationId",
-              "matches": "420"
-            },
-            {
-              "matches_regex": "9[24]",
-              "regex_group_name": "ServiceType"
-            }
-          ]
-        }
-      }],
       "additional": [
         {
-          "name": "Service Type",
-          "regex_group_name": "ServiceType",
+          "name": "Application Identifier",
+          "regex_group_name": "ApplicationIdentifier",
           "lookup": [
-            { "matches": "92", "name": "Signature Confirmation" },
-            { "matches": "93", "name": "Collect on Delivery (COD)" },
-            { "matches": "94", "name": "USPS Tracking" },
-            { "matches": "95", "name": "Certified Mail" },
-            { "matches": "96", "name": "Insured Mail" },
-            { "matches": "97", "name": "Registered Mail" },
-            { "matches": "98", "name": "Return Receipt for Merchandise" }
+            { "matches": "94", "name": "Online or vendor label", "description": "Issued through USPS WebTools, or an authorized PC Postage provider" }
           ]
         }
       ]
     },
     {
-      "name": "USPS 34v2",
-      "id": "usps_32V2",
-      "description": "variation on 34 digit USPS IMpd numbers",
+      "name": "USPS Legacy",
+      "id": "usps_legacy",
+      "description": "Delivery and Signature Confirmation numbers, carrying the 91 application identifier",
+      "glossary": {
+        "ApplicationIdentifier": { "description": "Present only when the barcode is UCC/EAN Code 128." }
+      },
       "regex": [
-        "\\s*(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})",
-        "(?<RoutingNumber>([0-9]\\s*){4})",
+        "\\s*(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})(?<DestinationZipPlus4>([0-9]\\s*){4})?)?",
         "(?<SerialNumber>",
-        "(?<ApplicationIdentifier>9\\s*[2345]\\s*)?",
-        "(?<ShipperId>([0-9]\\s*){8})",
-        "(?<PackageId>([0-9]\\s*){11})",
+        "(?<ApplicationIdentifier>9\\s*1\\s*)?",
+        "(?<ServiceType>([0-9]\\s*){2})",
+        "(?<ShipperId>([0-9]\\s*){9})",
+        "(?<PackageId>([0-9]\\s*){8})",
         ")",
         "(?<CheckDigit>[0-9]\\s*)"
       ],
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
+          "odds_multiplier": 1,
+          "reverse": false
+        },
+        "serial_number_format": {
+          "prepend_if": {
+            "matches_regex": "^(?!9\\s*1).+",
+            "content": "91"
+          }
         }
       },
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "test_numbers": {
         "valid": [
-          "4201002334249200190132607600833457",
-          "4201028200009261290113185417468510",
-          " 4 2 0 1 0 2 8 2 0 0 0 0 9 2 6 1 2 9 0 1 1 3 1 8 5 4 1 7 4 6 8 5 1 0 "
+          "420 22153 9101026837331000039521",
+          "9101 1234 5678 9000 0000 13",
+          "7196 9010 7560 0307 7385"
         ],
         "invalid": [
-          "4201028200009261290113185417468511"
+          "9101 1234 5678 9000 0000 14",
+          "7196 9010 7560 0307 7386"
         ]
-      }
+      },
+      "additional": [
+        {
+          "name": "Service Type",
+          "regex_group_name": "ServiceType",
+          "lookup": [
+            { "matches": "01", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "02", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "0[34]", "name": "Delivery Confirmation", "description": "Retail" },
+            { "matches": "05", "name": "Delivery Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured over $50" },
+            { "matches": "06", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured over $50" },
+            { "matches": "07", "name": "Delivery Confirmation", "description": "Priority Mail, insured $50 or under" },
+            { "matches": "08", "name": "Delivery Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured $50 or under" },
+            { "matches": "14", "name": "Delivery Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "21", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels" },
+            { "matches": "22", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels" },
+            { "matches_regex": "2[34]", "name": "Signature Confirmation", "description": "Retail" },
+            { "matches": "25", "name": "Signature Confirmation", "description": "Priority Mail or First-Class Mail Parcels, insured, all values" },
+            { "matches": "26", "name": "Signature Confirmation", "description": "Package Services, Parcel Select or Standard Mail Parcels, insured, all values" },
+            { "matches": "34", "name": "Signature Confirmation", "description": "Software vendors only, by approval" },
+            { "matches": "50", "name": "Electronic File Header", "description": "Used in the file header record only, never on a package" },
+            { "matches": "56", "name": "Passive Enroute Scan", "description": "A free scan as the parcel passes through a sorting plant, with no confirmation service attached" },
+            { "matches": "73", "name": "Insured Mail", "description": "Insured only, value over $50" },
+            { "matches": "82", "name": "Merchandise Return", "description": "With Delivery Confirmation" },
+            { "matches": "83", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value $50 or under" },
+            { "matches": "85", "name": "Merchandise Return", "description": "With Delivery Confirmation, insured value over $50" }
+          ]
+        }
+      ]
     },
     {
-      "name": "USPS 91",
-      "id": "usps_91",
-      "description": "USPS now calls this the IMpd barcode format",
+      "name": "USPS IMpb C",
+      "id": "usps_impb_c",
+      "description": "IMpb constructs C01 through C10, plus USPS retail",
+      "glossary": {
+        "ShipperId": { "description": "The company that holds the postal permit the package was mailed under, which Publication 199 calls the Mailer ID. Nine digits when it starts with 9, six otherwise." }
+      },
       "regex": [
-        "\\s*(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5}))?",
+        "\\s*(?:(?<RoutingApplicationId>4\\s*2\\s*0\\s*)(?<DestinationZip>([0-9]\\s*){5})(?<DestinationZipPlus4>([0-9]\\s*){4}(?=([0-9]\\s*){22}(?![0-9])))?)?",
         "(?<SerialNumber>",
-        "(?<ApplicationIdentifier>9\\s*[12345]\\s*)?",
-        "(?<SCNC>([0-9]\\s*){2})",
-        "(?<ServiceType>([0-9]\\s*){2})",
-        "(?<ShipperId>([0-9]\\s*){8})",
-        "(?<PackageId>([0-9]\\s*){11}|([0-9]\\s*){7})",
+        "(?<ApplicationIdentifier>9\\s*2\\s*(?=([0-9]\\s*){3}9)|9\\s*3\\s*(?=([0-9]\\s*){3}[0-8])|9\\s*5\\s*)",
+        "(?<ServiceType>([0-9]\\s*){3})",
+        "(?=9\\s*([0-9]\\s*){8}(([0-9]\\s*){11}|([0-9]\\s*){7})[0-9]\\s*(?![0-9])",
+        "|[0-8]\\s*([0-9]\\s*){5}(([0-9]\\s*){14}|([0-9]\\s*){10})[0-9]\\s*(?![0-9]))",
+        "(?<ShipperId>9\\s*([0-9]\\s*){8}|[0-8]\\s*([0-9]\\s*){5})",
+        "(?<PackageId>([0-9]\\s*){14}|([0-9]\\s*){11}|([0-9]\\s*){10}|([0-9]\\s*){7})",
         ")",
         "(?<CheckDigit>[0-9]\\s*)"
       ],
       "validation": {
         "checksum": {
           "name": "mod10",
+          "modulo": 10,
           "evens_multiplier": 3,
-          "odds_multiplier": 1
-        },
-        "serial_number_format": {
-          "prepend_if": {
-            "matches_regex": "^(?!9[1-5]).+",
-            "content": "91"
-          }
-        }
-      },
-      "partners": [{
-        "description": "FedEx SmartPost uses USPS for last mile delivery, but not all USPS91 numbers are SmartPosts",
-        "partner_type": "shipper",
-        "partner_id": "fedex_smartpost",
-        "validation": {
-          "matches_all": [
-            {
-              "regex_group_name": "ServiceType",
-              "matches": "29"
-            },
-            {
-              "matches": "61",
-              "regex_group_name": "SCNC"
-            },
-            {
-              "regex_group_name": "ApplicationIdentifier",
-              "matches": "92" 
-            }
-          ]
+          "odds_multiplier": 1,
+          "reverse": false
         }
       },
-      {
-        "description": "DHL uses USPS for last mile delivery, but not all USPS91 numbers are DHL Ecommerce",
-        "partner_type": "shipper",
-        "partner_id": "dhl_ecommerce_30",
-        "validation": {
-          "matches_all": [
-            {
-              "regex_group_name": "ServiceType",
-              "matches": "29"
-            },
-            {
-              "matches": "61",
-              "regex_group_name": "SCNC"
-            },
-            {
-              "matches": "420",
-              "regex_group_name": "RoutingApplicationId"
-            }
-          ]
-        }
-      }],
       "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=%s",
       "test_numbers": {
         "valid": [
-          "420 22153 9101026837331000039521",
-          "7196 9010 7560 0307 7385",
+          "4201002334249200190132607600833457",
+          "4201028200009261290113185417468510",
+          " 4 2 0 1 0 2 8 2 0 0 0 0 9 2 6 1 2 9 0 1 1 3 1 8 5 4 1 7 4 6 8 5 1 0 ",
           "9505 5110 6960 5048 6006 24",
-          "9101 1234 5678 9000 0000 13",
           "92748931507708513018050063",
           "92001903060085300042901077",
-          "9400 1112 0108 0805 4830 16",
           "9361 2898 7870 0317 6337 95",
-          "9405803699300124287899"
+          "9261292700768711948021",
+          "420 11213 92 6129098349792366623 8",
+          "92 6129098349792366623 8",
+          "420902459261290336128704042634",
+          "420941179261290336128704062441",
+          "420926029261290336128704067248",
+          "420902729261290336128704124163",
+          "420950549261290336128704133837",
+          "420193809261290336128704280838",
+          "420900469261290336128704216936"
         ],
         "invalid": [
           "61299998820821171811",
           "9200000000000000000000",
           "420000000000000000000000000000",
-          "420000009200000000000000000000"
+          "420000009200000000000000000000",
+          "4201028200009261290113185417468511"
         ]
       },
       "additional": [
@@ -255,14 +254,16 @@
           "name": "Service Type",
           "regex_group_name": "ServiceType",
           "lookup": [
-            {
-              "matches": "11",
-              "name": "First Class (R)"
-            },
-            {
-              "matches": "29",
-              "name": "Fedex Smart Post"
-            }
+            { "matches": "612", "name": "Parcel Select" }
+          ]
+        },
+        {
+          "name": "Application Identifier",
+          "regex_group_name": "ApplicationIdentifier",
+          "lookup": [
+            { "matches": "92", "name": "Commercial mailer", "description": "Nine digit mailer ID, and may have been carried by another company before USPS" },
+            { "matches": "93", "name": "Commercial mailer", "description": "Six digit mailer ID, and may have been carried by another company before USPS" },
+            { "matches": "95", "name": "USPS Retail", "description": "Issued at a post office counter, an automated postal center, or a self-service kiosk" }
           ]
         }
       ]

data/lib/data/couriers/yodel.json

@@ -0,0 +1,29 @@
+{
+  "name": "Yodel",
+  "courier_code": "yodel",
+  "tracking_numbers": [
+    {
+      "name": "Yodel",
+      "id": "yodel",
+      "description": "Yodel's UK domestic numbers, carried on a JD or JJD prefix. Numbers entering the Yodel network from other carriers can take other formats.",
+      "regex": [
+        "\\s*J\\s*(J\\s*)?D\\s*(?<SerialNumber>([0-9]\\s*){16})\\s*"
+      ],
+      "validation": {},
+      "tracking_url": "https://www.yodel.co.uk/tracking/%s",
+      "test_numbers": {
+        "valid": [
+          "JJD0002257639032011",
+          "JJD0002255380054291",
+          "JD0002242617644732",
+          "JD0002254405060992",
+          "J J D 0 0 0 2 2 5 7 6 3 9 0 3 2 0 2 0"
+        ],
+        "invalid": [
+          "JD000225440506099",
+          "JC0002254405060992"
+        ]
+      }
+    }
+  ]
+}

data/lib/data/couriers/yunexpress.json

@@ -0,0 +1,25 @@
+{
+  "name": "YunExpress",
+  "courier_code": "yunexpress",
+  "tracking_numbers": [
+    {
+      "name": "YunExpress",
+      "id": "yunexpress",
+      "tracking_url": "https://www.yuntrack.com/parcelTracking?id=%s",
+      "regex": [
+        "\\s*Y\\s*T\\s*(?<SerialNumber>([0-9]\\s*){16})\\s*"
+      ],
+      "validation": {},
+      "test_numbers": {
+        "valid": [
+          "YT2229521272164446",
+          "YT2229521272164447",
+          " Y T 2 2 2 9 5 2 1 2 7 2 1 6 4 4 4 7 "
+        ],
+        "invalid": [
+          "YT123456789012345"
+        ]
+      }
+    }
+  ]
+}

data/lib/tracking_number/version.rb

@@ -1,3 +1,3 @@
 module TrackingNumber
-  VERSION = "2.4.0"
+  VERSION = "3.0.0"
 end

data/lib/tracking_number.rb

@@ -60,4 +60,29 @@ module TrackingNumber
   def self.new(tracking_number)
     detect(tracking_number)
   end
+
+  # Renamed in tracking_number_data 2.0. The old constant still describes the same barcode.
+  RENAMED_TYPES = { USPS91: :USPSIMpbC, USPS22: :USPSIMpbN, USPS34v2: :USPSIMpbC }.freeze
+
+  # Removed in tracking_number_data 2.0. An alias would answer is_a? for every IMpb number,
+  # which is the claim the data stopped making, so these raise instead.
+  WITHDRAWN_TYPES = {
+    FedExSmartPost: 'USPSIMpbC',
+    DHLECommerce30: 'USPSIMpbC'
+  }.freeze
+
+  def self.const_missing(name)
+    if (renamed = RENAMED_TYPES[name])
+      warn "TrackingNumber::#{name} is now TrackingNumber::#{renamed}"
+      return const_get(renamed)
+    end
+
+    if (replacement = WITHDRAWN_TYPES[name])
+      raise NameError, "TrackingNumber::#{name} no longer exists. These are USPS IMpb barcodes " \
+                       "carrying nothing that identifies the shipper, so they now decode as " \
+                       "TrackingNumber::#{replacement}."
+    end
+
+    super
+  end
 end

data/package.json

@@ -38,31 +38,7 @@
               "release": "minor"
             },
             {
-              "type": "build",
-              "release": "patch"
-            },
-            {
-              "type": "ci",
-              "release": "patch"
-            },
-            {
-              "type": "chore",
-              "release": "patch"
-            },
-            {
-              "type": "docs",
-              "release": "patch"
-            },
-            {
-              "type": "refactor",
-              "release": "patch"
-            },
-            {
-              "type": "style",
-              "release": "patch"
-            },
-            {
-              "type": "test",
+              "type": "fix",
               "release": "patch"
             }
           ],

data/test/partnership_test.rb

@@ -0,0 +1,71 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+# No shipped definition declares partners currently at the tracking number data 2.0 release, 
+# but the concept is still supported in the data spec, and should be tested, so we're faking it here
+
+class PartnershipTest < Minitest::Test
+  NUMBER = 'ZZ1234567890'.freeze
+
+  def setup
+    @shipper = build_class('test_shipper', partner_id: 'test_carrier', partner_type: 'carrier')
+    @carrier = build_class('test_carrier', partner_id: 'test_shipper', partner_type: 'shipper')
+
+    TrackingNumber::TYPES.push(@shipper, @carrier)
+  end
+
+  def teardown
+    TrackingNumber::TYPES.delete(@shipper)
+    TrackingNumber::TYPES.delete(@carrier)
+  end
+
+  should "report a partnership from both sides" do
+    assert @shipper.new(NUMBER).partnership?
+    assert @carrier.new(NUMBER).partnership?
+  end
+
+  should "pair each side with the other" do
+    partners = @carrier.new(NUMBER).partners
+
+    assert_instance_of @shipper, partners.shipper
+    assert_instance_of @carrier, partners.carrier
+  end
+
+  should "report which side of the partnership each is" do
+    assert @shipper.new(NUMBER).shipper?
+    assert !@shipper.new(NUMBER).carrier?
+
+    assert @carrier.new(NUMBER).carrier?
+    assert !@carrier.new(NUMBER).shipper?
+  end
+
+  should "only match the carrier side when searching by default" do
+    matches = TrackingNumber.search("shipped as #{NUMBER} today")
+
+    assert_equal [@carrier], matches.collect(&:class)
+  end
+
+  should "match both sides when searching for all" do
+    matches = TrackingNumber.search("shipped as #{NUMBER} today", match: :all)
+
+    assert_equal [@shipper, @carrier], matches.collect(&:class)
+  end
+
+  private
+
+  def build_class(id, partner_id:, partner_type:)
+    pattern = 'Z\s*Z\s*(?<SerialNumber>([0-9]\s*){10})'
+
+    klass = Class.new(TrackingNumber::Base)
+    klass.const_set('ID', id)
+    klass.const_set('COURIER_CODE', id.to_sym)
+    klass.const_set('COURIER_INFO', name: id, courier_code: id.to_sym)
+    klass.const_set('SEARCH_PATTERN', Regexp.new("\\b#{pattern}\\b"))
+    klass.const_set('VERIFY_PATTERN', Regexp.new("^#{pattern}$"))
+    klass.const_set('VALIDATION', {})
+    klass.const_set('ADDITIONAL', nil)
+    klass.const_set('TRACKING_URL', nil)
+    klass.const_set('PARTNERS', [{ partner_id: partner_id, partner_type: partner_type }])
+
+    klass
+  end
+end

data/test/renamed_types_test.rb

@@ -0,0 +1,44 @@
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+class RenamedTypesTest < Minitest::Test
+  NUMBER = '420112139261290983497923666238'.freeze
+
+  should "resolve a renamed constant to the definition that replaced it" do
+    assert_equal TrackingNumber::USPSIMpbC, silenced { TrackingNumber::USPS91 }
+    assert_equal TrackingNumber::USPSIMpbN, silenced { TrackingNumber::USPS22 }
+    assert_equal TrackingNumber::USPSIMpbC, silenced { TrackingNumber::USPS34v2 }
+  end
+
+  should "keep is_a? answering for a renamed constant" do
+    assert TrackingNumber.new(NUMBER).is_a?(silenced { TrackingNumber::USPS91 })
+  end
+
+  should "warn once a renamed constant is reached for" do
+    _, err = capture_io { TrackingNumber::USPS91 }
+
+    assert_match(/USPS91 is now TrackingNumber::USPSIMpbC/, err)
+  end
+
+  # An alias would answer is_a? for every IMpb number, including labels these carriers never touched
+  should "refuse a withdrawn constant and name its replacement" do
+    error = assert_raises(NameError) { TrackingNumber::FedExSmartPost }
+    assert_match(/no longer exists/, error.message)
+    assert_match(/USPSIMpbC/, error.message)
+
+    assert_raises(NameError) { TrackingNumber::DHLECommerce30 }
+  end
+
+  should "leave an unrelated missing constant alone" do
+    error = assert_raises(NameError) { TrackingNumber::NotADefinition }
+
+    assert_match(/uninitialized constant/, error.message)
+  end
+
+  private
+
+  def silenced
+    resolved = nil
+    capture_io { resolved = yield }
+    resolved
+  end
+end

data/test/test_helper.rb

@@ -50,10 +50,11 @@ class Minitest::Test
     assert !t.valid?
   end
 
-  def should_fail_on_check_digit_changes(valid_number)
+  def should_fail_on_check_digit_changes(valid_number, klass)
     digits = valid_number.gsub(/\s/, "").chars.compact.to_a
-    last = digits.pop.to_i
-    digits << (last <= 2 ? last + 3 : last - 3).to_s
+    position = digits.join.match(klass::VERIFY_PATTERN).begin("CheckDigit")
+    current = digits[position].to_i
+    digits[position] = (current <= 2 ? current + 3 : current - 3).to_s
     invalid_number = digits.join
     t = TrackingNumber.new(invalid_number)
     assert !t.valid?, "#{invalid_number} reported as a valid #{t.class}, and it shouldn't be"

data/test/tracking_number_meta_test.rb

@@ -30,7 +30,7 @@ class TrackingNumberMetaTest < Minitest::Test
           if tracking_info[:validation][:checksum]
             # only run this test if number format has checksum
             should "fail on check digit changes with #{valid_number}" do
-              should_fail_on_check_digit_changes(valid_number)
+              should_fail_on_check_digit_changes(valid_number, klass)
             end
           end