feat: faker.finance.pin()

src/finance.ts

@@ -290,6 +290,23 @@ export class Finance {
     return cvv;
   }
 
+  /**
+   * Generates a random PIN number.
+   *
+   * @param length The length of the PIN to generate. Defaults to `4`.
+   * @throws Will throw an error if length is less than 1.
+   *
+   * @example
+   * faker.finance.pin() // '5067'
+   * faker.finance.pin(6) // '213789'
+   */
+  pin(length: number = 4): string {
+    if (length < 1) {
+      throw new Error('minimum length is 1');
+    }
+    return Array.from({ length }, () => this.faker.datatype.number(9)).join('');
+  }
+
   /**
    * Generates a random ethereum Address.
    *

test/finance.spec.ts

@@ -20,6 +20,7 @@ const seedRuns = [
       litecoinAddress: '3XbJMAAara64sSkA9HD24YHQWd1b',
       creditCardNumber: '3581-7755-1410-0486',
       creditCardCVV: '379',
+      pin: '3791',
       ethereumAddress: '0x8be4abdd39321ad7d3fe01ffce404f4d6db0906b',
       iban: 'GT30Y75110867098F1E3542612J4',
       bic: 'UYEOSCP1514',
@@ -43,6 +44,7 @@ const seedRuns = [
       litecoinAddress: 'Madhxs2jewAgkYgJi7No6Cn8JZar',
       creditCardNumber: '6011-6212-2540-3255-2392',
       creditCardCVV: '251',
+      pin: '2512',
       ethereumAddress: '0x5c346ba075bd57f5a62b82d72af39cbbb07a98cb',
       iban: 'FO7710540350900318',
       bic: 'OEFELYL1032',
@@ -66,6 +68,7 @@ const seedRuns = [
       litecoinAddress: 'MTMe8Z3EaFdLqmaGKP1LEEJQVriSZRZds',
       creditCardNumber: '4872190616276',
       creditCardCVV: '948',
+      pin: '9487',
       ethereumAddress: '0xeadb42f0e3f4a973fab0aeefce96dfcf49cd438d',
       iban: 'TN0382001124170679299069',
       bic: 'LXUEBTZ1',
@@ -89,6 +92,7 @@ const functionNames = [
   'litecoinAddress',
   'creditCardNumber',
   'creditCardCVV',
+  'pin',
   'ethereumAddress',
   'iban',
   'bic',
@@ -452,6 +456,34 @@ describe('finance', () => {
         });
       });
 
+      describe('pin()', () => {
+        it('should return a string', () => {
+          const pin = faker.finance.pin();
+          expect(pin).toBeTypeOf('string');
+        });
+
+        it('should contain only digits', () => {
+          const pin = faker.finance.pin();
+          expect(pin).toMatch(/^[0-9]+$/);
+        });
+
+        it('should default to a length of 4', () => {
+          const pin = faker.finance.pin();
+          expect(pin).toHaveLength(4);
+        });
+
+        it('should return a pin with the specified length', () => {
+          const pin = faker.finance.pin(5);
+          expect(pin).toHaveLength(5);
+        });
+
+        it('should throw an error when length is less than 1', () => {
+          expect(() => faker.finance.pin(-5)).toThrowError(
+            /^minimum length is 1$/
+          );
+        });
+      });
+
       describe('ethereumAddress()', () => {
         it('should return a valid ethereum address', () => {
           const ethereumAddress = faker.finance.ethereumAddress();