@yext/phonenumber-util 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yext/phonenumber-util",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "author": "bajohnson@hearsaycorp.com",
   "license": "BSD-3-Clause",
   "description": "Utility for extracting and validating phone numbers",
@@ -26,11 +26,11 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.7.0",
-    "@vitest/coverage-v8": "^2.1.1",
-    "eslint": "^9.7.0",
-    "generate-license-file": "^3.5.1",
-    "globals": "^15.8.0",
-    "husky": "^9.1.5",
+    "@vitest/coverage-v8": "^2.1.5",
+    "eslint": "^9.15.0",
+    "generate-license-file": "^3.6.0",
+    "globals": "^15.12.0",
+    "husky": "^9.1.7",
     "istanbul-badges-readme": "^1.9.0",
     "lint-staged": "^15.2.10",
     "prettier": "^3.3.3",

package/src/areaCodeList.js

@@ -1,3 +1,7 @@
+// The AREA_CODE_LIST is used in validation of NANP phone numbers.  If a number is passed to `isValidPhoneNumber` that is not found in this array, `false` will be returned.
+// If a new area code is added to this array, it must also be added to the AREA_CODES object in phoneCodes.js.
+// If a new area code is added and covers a region that has multiple timezones, it will need to be added to the STATES_WITH_MULTIPLE_TIMEZONES object in timezones.js.
+// If a new area code is added and covers a region that has portions that do and portions that do not adhere to daylight savings time, it will need to be added to the AREA_CODES_WITH_MULTIPLE_DAYLIGHT_SAVINGS object in daylightSavings.js.
 export const AREA_CODE_LIST = [
   '201',
   '202',
@@ -21,6 +25,7 @@ export const AREA_CODE_LIST = [
   '223',
   '224',
   '225',
+  '226',
   '257',
   '228',
   '229',
@@ -49,6 +54,7 @@ export const AREA_CODE_LIST = [
   '276',
   '279',
   '281',
+  '283',
   '284',
   '289',
   '301',

package/src/compliance.js

@@ -1,3 +1,4 @@
+// Compliance settings are used to define quiet hours for the US (using TCPA) and Canada (using CRTC).
 export const TCPA_QUIET_HOURS = {
   start: 8,
   end: 21,
@@ -14,6 +15,7 @@ export const CRTC_QUIET_HOURS = {
   },
 };
 
+// The strings of CRTC_STATES must match the `name` field found within AREA_CODES object in phoneCodes.js.
 export const CRTC_STATES = [
   'Alberta',
   'British Columbia',

package/src/phoneCodes.js

@@ -256,6 +256,7 @@ export const AREA_CODES = {
   216: { name: 'Ohio', code: 'OH', region: UNITED_STATES },
   220: { name: 'Ohio', code: 'OH', region: UNITED_STATES },
   234: { name: 'Ohio', code: 'OH', region: UNITED_STATES },
+  283: { name: 'Ohio', code: 'OH', region: UNITED_STATES },
   326: { name: 'Ohio', code: 'OH', region: UNITED_STATES },
   330: { name: 'Ohio', code: 'OH', region: UNITED_STATES },
   380: { name: 'Ohio', code: 'OH', region: UNITED_STATES },
@@ -389,6 +390,7 @@ export const AREA_CODES = {
     state: 'NS/PE',
     region: CANADA,
   },
+  226: { name: 'Ontario', code: 'ON', region: CANADA },
   289: { name: 'Ontario', code: 'ON', region: CANADA },
   343: { name: 'Ontario', code: 'ON', region: CANADA },
   365: { name: 'Ontario', code: 'ON', region: CANADA },
@@ -420,7 +422,6 @@ export const AREA_CODES = {
     region: CANADA,
   },
   // Other North American Numbering Plan (NANP) Numbers
-  // These will return "United States, Canada" as the region, which is incorrect, but they follow the same standard.
   684: { region: { name: 'American Samoa', code: 'AS', flag: '🇦🇸' } },
   264: { region: { name: 'Anguilla', code: 'AI', flag: '🇦🇮' } },
   268: { region: { name: 'Antigua and Barbuda', code: 'AG', flag: '🇦🇬' } },
@@ -491,7 +492,7 @@ export const REGION_CODES = {
   235: { name: 'Chad', code: 'TD', flag: '🇹🇩' },
   56: { name: 'Chile', code: 'CL', flag: '🇨🇱' },
   86: { name: 'China', code: 'CN', flag: '🇨🇳' },
-  61: { name: 'Christmas Island, Cocos Islands', code: 'CX', flag: '🇨🇽' },
+  61: { name: 'Australia', code: 'AU', flag: '🇦🇺' },
   57: { name: 'Colombia', code: 'CO', flag: '🇨🇴' },
   269: { name: 'Comoros', code: 'KM', flag: '🇰🇲' },
   682: { name: 'Cook Islands', code: 'CK', flag: '🇨🇰' },

package/src/phoneFormats.js

@@ -1,3 +1,5 @@
+// For each region, provide a pretty format.  Some regions may have multiple formats, in which case an array can be used.  Each "x" will be replaced with a digit when the number of digits matches the number of "x"s in the format.
+// If no format is found with a correct matching length, a sanitized e164 is returned as a fall-back.
 export const PHONE_FORMATS = {
   1: '(xxx) xxx-xxxx', // United States
   7: '+x xxx xxx-xx-xx', // Russia

package/src/timezones.js

@@ -1,3 +1,6 @@
+// Default timezone for each state, region or province.
+// While some region may have multiple timezones, we set the most common one here as a default.  See STATES_WITH_MULTIPLE_TIMEZONES below for references to exceptions within these regions.
+// Time calculations are only provided for US and Canada.
 export const STATE_TIMEZONES = {
   Alabama: '-06:00',
   Alaska: '-09:00',