card-validator 10.0.2 → 10.0.4

package/.github/ISSUE_TEMPLATE/bug_report_form.yml

@@ -0,0 +1,47 @@
+name: Bug Report
+description: File a bug report.
+title: "[Bug]: "
+labels: ["bug", "triage"]
+projects: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Detail the bad behavior and the steps required to duplicate it
+      placeholder: Tell us what you see!
+      value: "A bug happened!"
+    validations:
+      required: true
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: What did you expect to happen?
+      description: What did you expect to happen when performing the action?
+      placeholder: Expected behavior
+      value: "Expected behavior"
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version of this library are you running?
+      placeholder: "v0.0.0"
+      value:
+    validations:
+      required: true
+  - type: textarea
+    id: browsers
+    attributes:
+      label: What browsers are you seeing the problem on?
+      description: |
+        List browsers where you see the problem reported. For example:
+          * Mac OS 15.3.5, Chrome 130.0.1234.987
+          * Android 14, Firefox 133.0
+          * iPadOS 17.1, Safari
+      placeholder: "For each browser specify 1) operating system and version 2) browser name and version"

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Contact Developer Support
+    url: https://developer.paypal.com/braintree/help
+    about: If you need help troubleshooting your integration, reach out to Braintree Support. Only open a GitHub issue if you've found an issue with our SDK.

package/.github/ISSUE_TEMPLATE/feature_request_form.yml

@@ -0,0 +1,30 @@
+name: Feature Request
+description: Request a new feature.
+title: "[FR]: "
+labels: ["feature", "request", "enhancement", "triage"]
+projects: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this feature request!
+  - type: textarea
+    id: feat-summary
+    attributes:
+      label: Feature Summary
+      description: In a few sentences or less, provide a concise description of the feature being requested.
+      placeholder: "New feature that does ___; it can be used when ..."
+    validations:
+      required: true
+  - type: textarea
+    id: detailed-description
+    attributes:
+      label: Detailed description of new feature.
+      description: |
+        Please provide a detailed description of proposed feature.
+          - What problem would this new feature solve?
+          - How will this change affect users?
+          - Is it a modification to existing functionality? Are you requesting a new/modified function input or output? Please provide an example of what the change might look like?
+      placeholder: "New feature details."
+    validations:
+      required: true

package/.github/workflows/security.yml

@@ -0,0 +1,24 @@
+name: Security
+
+permissions:
+  contents: write # Needed by both CodeQL and dependency review
+  pull-requests: write # Needed by dependency review
+  statuses: write # Needed by dependency review (to post checks)
+  security-events: write # Needed by CodeQL to upload SARIF
+  packages: read # Needed by CodeQL for private/internal packs
+  actions: read # Needed by CodeQL to access internal actions
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  codeql-javascript:
+    uses: braintree/security-workflows/.github/workflows/codeql.yml@main
+    with:
+      language: javascript-typescript
+  dependency-review:
+    uses: braintree/security-workflows/.github/workflows/dependency-review.yml@main

package/dist/card-number.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cardNumber = void 0;
+exports.cardNumber = cardNumber;
 var luhn10 = require("./luhn-10");
 var getCardTypes = require("credit-card-type");
 function verification(card, isPotentiallyValid, isValid) {
@@ -51,4 +51,3 @@ function cardNumber(value, options) {
     }
     return verification(cardType, testCardValue.length < maxLength, false);
 }
-exports.cardNumber = cardNumber;

package/dist/cardholder-name.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cardholderName = void 0;
+exports.cardholderName = cardholderName;
 var CARD_NUMBER_REGEX = /^[\d\s-]*$/;
 var MAX_LENGTH = 255;
 function verification(isValid, isPotentiallyValid) {
@@ -21,4 +21,3 @@ function cardholderName(value) {
     }
     return verification(true, true);
 }
-exports.cardholderName = cardholderName;

package/dist/cvv.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.cvv = void 0;
+exports.cvv = cvv;
 var DEFAULT_LENGTH = 3;
 function includes(array, thing) {
     for (var i = 0; i < array.length; i++) {
@@ -41,4 +41,3 @@ function cvv(value, maxLength) {
     }
     return verification(true, true);
 }
-exports.cvv = cvv;

package/dist/expiration-date.js

@@ -11,7 +11,7 @@ var __assign = (this && this.__assign) || function () {
     return __assign.apply(this, arguments);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expirationDate = void 0;
+exports.expirationDate = expirationDate;
 var parse_date_1 = require("./lib/parse-date");
 var expiration_month_1 = require("./expiration-month");
 var expiration_year_1 = require("./expiration-year");
@@ -55,4 +55,3 @@ function expirationDate(value, maxElapsedYear) {
     }
     return verification(false, false, null, null);
 }
-exports.expirationDate = expirationDate;

package/dist/expiration-month.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expirationMonth = void 0;
+exports.expirationMonth = expirationMonth;
 function verification(isValid, isPotentiallyValid, isValidForThisYear) {
     return {
         isValid: isValid,
@@ -26,4 +26,3 @@ function expirationMonth(value) {
     var result = month > 0 && month < 13;
     return verification(result, result, result && month >= currentMonth);
 }
-exports.expirationMonth = expirationMonth;

package/dist/expiration-year.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expirationYear = void 0;
+exports.expirationYear = expirationYear;
 var DEFAULT_VALID_NUMBER_OF_YEARS_IN_THE_FUTURE = 19;
 function verification(isValid, isPotentiallyValid, isCurrentYear) {
     return {
@@ -55,4 +55,3 @@ function expirationYear(value, maxElapsedYear) {
     }
     return verification(valid, valid, isCurrentYear);
 }
-exports.expirationYear = expirationYear;

package/dist/index.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var creditCardType = __importStar(require("credit-card-type"));
 var cardholder_name_1 = require("./cardholder-name");
 var card_number_1 = require("./card-number");

package/dist/lib/parse-date.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseDate = void 0;
+exports.parseDate = parseDate;
 var expiration_year_1 = require("../expiration-year");
 var is_array_1 = require("./is-array");
 function getNumberOfMonthDigitsInDateString(dateString) {
@@ -97,4 +97,3 @@ function parseDate(datestring) {
         year: datestring.substr(month.length),
     };
 }
-exports.parseDate = parseDate;

package/dist/postal-code.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.postalCode = void 0;
-var DEFAULT_MIN_POSTAL_CODE_LENGTH = 3;
+exports.postalCode = postalCode;
+var DEFAULT_MIN_POSTAL_CODE_LENGTH = 2;
 var ALPHANUM = new RegExp(/^[a-z0-9]+$/i);
 function verification(isValid, isPotentiallyValid) {
     return { isValid: isValid, isPotentiallyValid: isPotentiallyValid };
@@ -20,4 +20,3 @@ function postalCode(value, options) {
     }
     return verification(true, true);
 }
-exports.postalCode = postalCode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "card-validator",
-  "version": "10.0.2",
+  "version": "10.0.4",
   "description": "A library for validating credit card fields",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,20 +20,20 @@
   "author": "Braintree <code@getbraintree.com> (https://www.braintreepayments.com/)",
   "license": "MIT",
   "devDependencies": {
-    "@types/jest": "^29.5.3",
-    "@types/node": "^20.5.2",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.3",
     "@typescript-eslint/eslint-plugin": "^5.54.1",
-    "eslint": "^8.47.0",
+    "eslint": "^8.57.1",
     "eslint-config-braintree": "^6.0.0-typescript-prep-rc.2",
     "eslint-plugin-prettier": "^5.0.0",
-    "jest": "^29.6.3",
-    "jest-environment-jsdom": "^29.6.3",
-    "prettier": "^3.0.2",
-    "ts-jest": "^29.1.1",
-    "typescript": "^5.1.6"
+    "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "prettier": "^3.7.4",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
   },
   "dependencies": {
-    "credit-card-type": "^10.0.2"
+    "credit-card-type": "^10.1.0"
   },
   "jest": {
     "testEnvironment": "jsdom",

package/src/__tests__/expiration-year.ts

@@ -1,252 +1,163 @@
 import { expirationYear, ExpirationYearVerification } from "../expiration-year";
 
-const currentYear = new Date().getFullYear();
+const INVALID: ExpirationYearVerification = {
+  isValid: false,
+  isPotentiallyValid: false,
+  isCurrentYear: false,
+};
 
-function yearsFromNow(fromNow: number, digits?: number): string {
-  let result = String(currentYear + fromNow);
+const POTENTIALLY_VALID: ExpirationYearVerification = {
+  isValid: false,
+  isPotentiallyValid: true,
+  isCurrentYear: false,
+};
 
-  if (digits === 2) {
-    result = result.substr(2, 2);
-  }
+const VALID: ExpirationYearVerification = {
+  isValid: true,
+  isPotentiallyValid: true,
+  isCurrentYear: false,
+};
 
-  return result;
-}
+const CURRENT_YEAR: ExpirationYearVerification = {
+  isValid: true,
+  isPotentiallyValid: true,
+  isCurrentYear: true,
+};
 
 describe("expirationYear", () => {
-  const FALSE_VALIDATION = {
-    isValid: false,
-    isPotentiallyValid: false,
-    isCurrentYear: false,
-  };
-
-  describe.each([
-    [
-      "returns false if not a string",
-      [
-        [[], FALSE_VALIDATION],
-        [{}, FALSE_VALIDATION],
-        [null, FALSE_VALIDATION],
-        [undefined, FALSE_VALIDATION], // eslint-disable-line no-undefined
-        [Infinity, FALSE_VALIDATION],
-        [0 / 0, FALSE_VALIDATION],
-        [0, FALSE_VALIDATION],
-        [1, FALSE_VALIDATION],
-        [2, FALSE_VALIDATION],
-        [12, FALSE_VALIDATION],
-        [-1, FALSE_VALIDATION],
-        [-12, FALSE_VALIDATION],
-      ],
-    ],
-
-    [
-      "returns false for malformed strings",
-      [
-        ["foo", FALSE_VALIDATION],
-        ["1.2", FALSE_VALIDATION],
-        ["1/20", FALSE_VALIDATION],
-        ["1 2", FALSE_VALIDATION],
-        ["1 ", FALSE_VALIDATION],
-        [" 1", FALSE_VALIDATION],
-        ["20015", FALSE_VALIDATION],
-      ],
-    ],
-
-    [
-      "returns the appropriate values for incomplete strings",
-      [
-        [
-          "",
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          "2",
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          "9",
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          "200",
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          "123",
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-        [
-          "20",
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-      ],
-    ],
-
-    [
-      "accepts four-digit years",
-      [
-        [
-          yearsFromNow(0),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: true },
-        ],
-        [
-          yearsFromNow(-5),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(5),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(10),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(11),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(12),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(19),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(20),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(25),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(33),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-      ],
-    ],
-
-    [
-      "accepts two-digit years",
-      [
-        [
-          yearsFromNow(0, 2),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: true },
-        ],
-        [
-          yearsFromNow(-5, 2),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(5, 2),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(10, 2),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(11, 2),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(12, 2),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(19, 2),
-          { isValid: true, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(20, 2),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(25, 2),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(33, 2),
-          { isValid: false, isPotentiallyValid: false, isCurrentYear: false },
-        ],
-      ],
-    ],
-
-    /*
-     *  This doesn't take 20xx -> 21xx into account, but probably YAGNI
-     *  (with apologies to whoever is possibly looking at this legacy
-     *  code long after we're dead
-     *  */
-    [
-      "accepts three-digit years",
-      [
-        [
-          yearsFromNow(-3).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(-1).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(0).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(1).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(5).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(11).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(17).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-        [
-          yearsFromNow(23).slice(0, 3),
-          { isValid: false, isPotentiallyValid: true, isCurrentYear: false },
-        ],
-      ],
-    ],
-  ] as Array<[string, Array<[unknown, ExpirationYearVerification]>]>)(
-    "%s",
-    (description, tests) => {
-      it.each(tests)("parses %s to be %p", (exp, meta) => {
-        expect(expirationYear(exp)).toEqual(meta);
+  // Date picked at random from the past 5 years
+  const mockToday = new Date(2021, 5, 9);
+  jest.useFakeTimers().setSystemTime(mockToday);
+
+  describe("given a non-string value", () => {
+    test.each([
+      [[], INVALID],
+      [{}, INVALID],
+      [null, INVALID],
+      [undefined, INVALID], // eslint-disable-line no-undefined
+      [Infinity, INVALID],
+      [0 / 0, INVALID],
+      [0, INVALID],
+      [1, INVALID],
+      [2, INVALID],
+      [12, INVALID],
+      [-1, INVALID],
+      [-12, INVALID],
+    ])("%p is invalid", (value, output) => {
+      expect(expirationYear(value)).toEqual(output);
+    });
+  });
+
+  describe("given an empty string", () => {
+    it("returns as potentially valid", () => {
+      expect(expirationYear("")).toEqual(POTENTIALLY_VALID);
+    });
+  });
+
+  describe("given only whitespace", () => {
+    it("returns as potentially valid", () => {
+      expect(expirationYear("    ")).toEqual(POTENTIALLY_VALID);
+    });
+  });
+
+  describe("given a malformed string value", () => {
+    test.each([
+      ["foo", INVALID],
+      ["1.2", INVALID],
+      ["1/20", INVALID],
+      ["1 2", INVALID],
+      ["1 ", INVALID],
+      [" 1", INVALID],
+      ["20015", INVALID],
+    ])("%p is invalid", (value, output) => {
+      expect(expirationYear(value)).toEqual(output);
+    });
+  });
+
+  describe("given a 1 digit string", () => {
+    describe("that's not a number", () => {
+      test.each(["a", "#", ";", "\\", "+"])("%p is invalid", (value) => {
+        expect(expirationYear(value)).toEqual(INVALID);
       });
-    },
-  );
-
-  it("defaults maxElapsedYear is 19", () => {
-    expect(expirationYear(yearsFromNow(19))).toEqual({
-      isValid: true,
-      isPotentiallyValid: true,
-      isCurrentYear: false,
     });
-    expect(expirationYear(yearsFromNow(20))).toEqual({
-      isValid: false,
-      isPotentiallyValid: false,
-      isCurrentYear: false,
+
+    describe("that is a number", () => {
+      test.each(["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"])(
+        "%p is potentially valid",
+        (value) => {
+          expect(expirationYear(value)).toEqual(POTENTIALLY_VALID);
+        },
+      );
+    });
+  });
+
+  describe("given a 2 digit string", () => {
+    test.each([
+      ["19", INVALID],
+      ["20", POTENTIALLY_VALID],
+      ["21", CURRENT_YEAR],
+      ["22", VALID],
+      ["40", VALID],
+      ["41", INVALID],
+    ])("%p gives expected output", (value, output) => {
+      expect(expirationYear(value)).toEqual(output);
+    });
+  });
+
+  describe("given a 3 digit string", () => {
+    test.each([
+      ["000", INVALID],
+      ["123", INVALID],
+      ["200", POTENTIALLY_VALID],
+      ["201", POTENTIALLY_VALID],
+      ["202", POTENTIALLY_VALID],
+      ["203", POTENTIALLY_VALID],
+      ["204", POTENTIALLY_VALID],
+      ["205", POTENTIALLY_VALID],
+      ["206", POTENTIALLY_VALID],
+      ["207", POTENTIALLY_VALID],
+      ["208", POTENTIALLY_VALID],
+      ["209", POTENTIALLY_VALID],
+      ["210", INVALID],
+      ["300", INVALID],
+      ["999", INVALID],
+    ])("%p gives expected output", (value, output) => {
+      expect(expirationYear(value)).toEqual(output);
     });
   });
 
-  it("accepts maxElapsedYear", () => {
-    expect(expirationYear(yearsFromNow(20), 20)).toEqual({
-      isValid: true,
-      isPotentiallyValid: true,
-      isCurrentYear: false,
+  describe("given a 4 digit string", () => {
+    test.each([
+      ["0000", INVALID],
+      ["1234", INVALID],
+      ["2020", INVALID],
+      ["2021", CURRENT_YEAR],
+      ["2022", VALID],
+      ["2040", VALID],
+      ["2041", INVALID],
+      ["3000", INVALID],
+      ["9999", INVALID],
+    ])("%p gives expected output", (value, output) => {
+      expect(expirationYear(value)).toEqual(output);
     });
-    expect(expirationYear(yearsFromNow(21), 20)).toEqual({
-      isValid: false,
-      isPotentiallyValid: false,
-      isCurrentYear: false,
+  });
+
+  describe("given a more than 4 digit string", () => {
+    test.each(["00000", "12345", "20021", "20202", "20211", "30000", "99999"])(
+      "%p is invalid",
+      (value) => {
+        expect(expirationYear(value)).toEqual(INVALID);
+      },
+    );
+  });
+
+  describe("given a custom max elapsed year", () => {
+    it("uses it correctly", () => {
+      expect(expirationYear("2020", 5)).toEqual(INVALID);
+      expect(expirationYear("2021", 5)).toEqual(CURRENT_YEAR);
+      expect(expirationYear("2022", 5)).toEqual(VALID);
+      expect(expirationYear("2026", 5)).toEqual(VALID);
+      expect(expirationYear("2027", 5)).toEqual(INVALID);
     });
   });
 });

package/src/__tests__/postal-code.ts

@@ -32,6 +32,8 @@ describe("postalCode", () => {
         ["557016", { isValid: true, isPotentiallyValid: true }], // Romania
         ["110001", { isValid: true, isPotentiallyValid: true }], // India
         ["SE1 2LN", { isValid: true, isPotentiallyValid: true }], // UK
+        ["S9 1DF", { isValid: true, isPotentiallyValid: true }], // UK
+        ["AA9A 9AA", { isValid: true, isPotentiallyValid: true }], // UK
         ["01234567890123456789", { isValid: true, isPotentiallyValid: true }], // some hypothetical country
       ],
     ],
@@ -52,11 +54,11 @@ describe("postalCode", () => {
     ],
 
     [
-      "returns isPotentiallyValid for shorter-than-3 strings",
+      "returns isPotentiallyValid for shorter-than-2 strings",
       [
         ["", { isValid: false, isPotentiallyValid: true }],
         ["1", { isValid: false, isPotentiallyValid: true }],
-        ["12", { isValid: false, isPotentiallyValid: true }],
+        ["12", { isValid: true, isPotentiallyValid: true }],
       ],
     ],
   ] as Array<[string, Array<[string, Verification]>]>)(
@@ -79,10 +81,18 @@ describe("postalCode", () => {
         isPotentiallyValid: true,
       });
       expect(postalCode("12")).toEqual({
-        isValid: false,
+        isValid: true,
         isPotentiallyValid: true,
       });
       expect(postalCode("12", {})).toEqual({
+        isValid: true,
+        isPotentiallyValid: true,
+      });
+      expect(postalCode("1")).toEqual({
+        isValid: false,
+        isPotentiallyValid: true,
+      });
+      expect(postalCode("1", {})).toEqual({
         isValid: false,
         isPotentiallyValid: true,
       });

package/src/postal-code.ts

@@ -4,7 +4,7 @@ type PostalCodeOptions = {
   minLength?: number;
 };
 
-const DEFAULT_MIN_POSTAL_CODE_LENGTH = 3;
+const DEFAULT_MIN_POSTAL_CODE_LENGTH = 2;
 const ALPHANUM = new RegExp(/^[a-z0-9]+$/i);
 
 function verification(