stdnum 1.10.0 → 1.10.2

package/src/ar/cbu.spec.ts

@@ -0,0 +1,28 @@
+import { validate, format } from './cbu';
+import { InvalidLength, InvalidChecksum } from '../exceptions';
+
+describe('ar/cbu', () => {
+  it('format:2850590940090418135201', () => {
+    const result = format('2850590940090418135201');
+
+    expect(result).toEqual('28505909 40090418135201');
+  });
+
+  it('validate:2850590940090418135201', () => {
+    const result = validate('2850590940090418135201');
+
+    expect(result.isValid && result.compact).toEqual('2850590940090418135201');
+  });
+
+  it('validate:281059094009041813520', () => {
+    const result = validate('281059094009041813520');
+
+    expect(result.error).toBeInstanceOf(InvalidLength);
+  });
+
+  it('validate:2810590940090418135201', () => {
+    const result = validate('2810590940090418135201');
+
+    expect(result.error).toBeInstanceOf(InvalidChecksum);
+  });
+});

package/src/ar/cbu.ts

@@ -0,0 +1,96 @@
+/**
+ *
+ * CBU (Clave Bancaria Uniforme, Argentine bank account number).
+ *
+ * CBU it s a code of the Banks of Argentina to identify customer accounts. The
+ * number consists of 22 digits and consists of a 3 digit bank identifier,
+ * followed by a 4 digit branch identifier, a check digit, a 13 digit account
+ * identifier and another check digit.
+ *
+ * Sources:
+ *   https://es.wikipedia.org/wiki/Clave_Bancaria_Uniforme
+ *
+ * BANK
+ */
+
+import * as exceptions from '../exceptions';
+import { ValidateReturn, Validator } from '../types';
+import { strings, weightedSum } from '../util';
+
+function clean(input: string): ReturnType<typeof strings.cleanUnicode> {
+  return strings.cleanUnicode(input, ' -');
+}
+
+const impl: Validator = {
+  name: 'Single Banking Code',
+  localName: 'Clave Bancaria Uniforme',
+  abbreviation: 'CBU',
+  compact(input: string): string {
+    const [value, err] = clean(input);
+
+    if (err) {
+      throw err;
+    }
+
+    return value;
+  },
+
+  format(input: string): string {
+    const [value] = clean(input);
+    const [a, b] = strings.splitAt(value, 8);
+
+    return `${a} ${b}`;
+  },
+
+  /**
+   * Check if the number is a valid Argentinian CBU number.
+   * This checks the length, formatting and other contraints. It does not check
+   * for control letter.
+   */
+  validate(input: string): ValidateReturn {
+    const [value, error] = clean(input);
+
+    if (error) {
+      return { isValid: false, error };
+    }
+    if (value.length !== 22) {
+      return { isValid: false, error: new exceptions.InvalidLength() };
+    }
+    if (!strings.isdigits(value)) {
+      return { isValid: false, error: new exceptions.InvalidComponent() };
+    }
+
+    const [front, c1, back, c2] = strings.splitAt(value, 7, 8, 21);
+
+    const s1 = String(
+      10 -
+        weightedSum(front, {
+          reverse: true,
+          weights: [3, 1, 7, 9, 3, 1, 7],
+          modulus: 10,
+        }),
+    );
+    const s2 = String(
+      10 -
+        weightedSum(back, {
+          reverse: true,
+          weights: [3, 1, 7, 9, 3, 1, 7, 9, 3, 1, 7, 9, 3, 1],
+          modulus: 10,
+        }),
+    );
+
+    if (s1 !== c1 || s2 !== c2) {
+      return { isValid: false, error: new exceptions.InvalidChecksum() };
+    }
+
+    return {
+      isValid: true,
+      compact: value,
+      isIndividual: false,
+      isCompany: false,
+    };
+  },
+};
+
+export const { name, localName, abbreviation, validate, format, compact } =
+  impl;

package/src/ar/cuit.spec.ts

@@ -0,0 +1,28 @@
+import { validate, format } from './cuit';
+import { InvalidLength, InvalidChecksum } from '../exceptions';
+
+describe('ar/cuit', () => {
+  it('format:20-05536168-2', () => {
+    const result = format('20-05536168-2');
+
+    expect(result).toEqual('20-05536168-2');
+  });
+
+  it('validate:20-05536168-2', () => {
+    const result = validate('20-05536168-2');
+
+    expect(result.isValid && result.compact).toEqual('20055361682');
+  });
+
+  it('validate:2026756539', () => {
+    const result = validate('2026756539');
+
+    expect(result.error).toBeInstanceOf(InvalidLength);
+  });
+
+  it('validate:20267565392', () => {
+    const result = validate('20267565392');
+
+    expect(result.error).toBeInstanceOf(InvalidChecksum);
+  });
+});

package/src/ar/cuit.ts

@@ -0,0 +1,102 @@
+/**
+ *
+ * CUIT (Código Único de Identificación Tributaria, Argentinian tax number).
+ *
+ * The CUIT is a taxpayer identification number used for VAT (IVA, Impuesto al
+ * Valor Agregado) and other taxes.
+ *
+ * Sources:
+ *   https://es.wikipedia.org/wiki/Clave_Única_de_Identificación_Tributaria
+ *
+ * TAX PERSON/ENTITY
+ */
+
+import * as exceptions from '../exceptions';
+import { ValidateReturn, Validator } from '../types';
+import { strings, weightedSum } from '../util';
+
+const cuitTypes = [
+  // individuals
+  '20',
+  '23',
+  '24',
+  '27',
+  // companies
+  '30',
+  '33',
+  '34',
+  // international purposes
+  '50',
+  '51',
+  '55',
+];
+
+function clean(input: string): ReturnType<typeof strings.cleanUnicode> {
+  return strings.cleanUnicode(input, ' -');
+}
+
+const impl: Validator = {
+  name: 'Argentinian VAT Number',
+  localName: 'Código Único de Identificación Tributaria',
+  abbreviation: 'CUIT',
+  compact(input: string): string {
+    const [value, err] = clean(input);
+
+    if (err) {
+      throw err;
+    }
+
+    return value;
+  },
+
+  format(input: string): string {
+    const [value] = clean(input);
+
+    return strings.splitAt(value, 2, 10).join('-');
+  },
+
+  /**
+   * Check if the number is a valid CUIT number.
+   * This checks the length, formatting and other contraints. It does not check
+   * for control letter.
+   */
+  validate(input: string): ValidateReturn {
+    const [value, error] = clean(input);
+
+    if (error) {
+      return { isValid: false, error };
+    }
+    if (value.length !== 11) {
+      return { isValid: false, error: new exceptions.InvalidLength() };
+    }
+    if (!strings.isdigits(value)) {
+      return { isValid: false, error: new exceptions.InvalidFormat() };
+    }
+
+    const [front, body, check] = strings.splitAt(value, 2, 10);
+
+    if (!cuitTypes.includes(front)) {
+      return { isValid: false, error: new exceptions.InvalidComponent() };
+    }
+
+    const cs = weightedSum(front + body, {
+      weights: [5, 4, 3, 2, 7, 6, 5, 4, 3, 2],
+      modulus: 11,
+    });
+    const digit = '012345678990'[11 - cs];
+
+    if (digit !== check) {
+      return { isValid: false, error: new exceptions.InvalidChecksum() };
+    }
+
+    return {
+      isValid: true,
+      compact: value,
+      isIndividual: front[0] === '2',
+      isCompany: front[0] === '3',
+    };
+  },
+};
+
+export const { name, localName, abbreviation, validate, format, compact } =
+  impl;

package/src/ar/dni.spec.ts

@@ -0,0 +1,22 @@
+import { validate, format } from './dni';
+import { InvalidLength } from '../exceptions';
+
+describe('ar/dni', () => {
+  it('format:20123456', () => {
+    const result = format('20123456');
+
+    expect(result).toEqual('20.123.456');
+  });
+
+  it('validate:20.123.456', () => {
+    const result = validate('20.123.456');
+
+    expect(result.isValid && result.compact).toEqual('20123456');
+  });
+
+  it('validate:2012345699', () => {
+    const result = validate('2012345699');
+
+    expect(result.error).toBeInstanceOf(InvalidLength);
+  });
+});

package/src/ar/dni.ts

@@ -0,0 +1,72 @@
+/**
+ *
+ * DNI (Documento Nacional de Identidad, Argentinian national identity nr.).
+ *
+ * The DNI number is the number that appears on the Argentinian national
+ * identity document and is used to identify citizen and foreigners residing in
+ * the country.
+ *
+ * Sources:
+ *   https://en.wikipedia.org/wiki/Documento_Nacional_de_Identidad_(Argentina)
+ *
+ *  PERSON
+ */
+
+import * as exceptions from '../exceptions';
+import { ValidateReturn, Validator } from '../types';
+import { strings } from '../util';
+
+function clean(input: string): ReturnType<typeof strings.cleanUnicode> {
+  return strings.cleanUnicode(input, ' .');
+}
+
+const impl: Validator = {
+  name: 'Argentinian National Identity Document',
+  localName: 'Documento Nacional de Identidad',
+  abbreviation: 'DNI',
+
+  compact(input: string): string {
+    const [value, err] = clean(input);
+
+    if (err) {
+      throw err;
+    }
+
+    return value;
+  },
+
+  format(input: string): string {
+    const [value] = clean(input);
+
+    return strings.splitAt(value, value.length - 6, value.length - 3).join('.');
+  },
+
+  /**
+   * Check if the number is a valid DNI number.
+   * This checks the length, formatting and other contraints. It does not check
+   * for control letter.
+   */
+  validate(input: string): ValidateReturn {
+    const [value, error] = clean(input);
+
+    if (error) {
+      return { isValid: false, error };
+    }
+    if (value.length !== 7 && value.length !== 8) {
+      return { isValid: false, error: new exceptions.InvalidLength() };
+    }
+    if (!strings.isdigits(value)) {
+      return { isValid: false, error: new exceptions.InvalidComponent() };
+    }
+
+    return {
+      isValid: true,
+      compact: value,
+      isIndividual: true,
+      isCompany: false,
+    };
+  },
+};
+
+export const { name, localName, abbreviation, validate, format, compact } =
+  impl;

package/src/ar/index.ts

@@ -0,0 +1,3 @@
+export * as cbu from './cbu';
+export * as cuit from './cuit';
+export * as dni from './dni';

package/src/at/businessid.spec.ts

@@ -0,0 +1,34 @@
+import { validate, format } from './businessid';
+import { InvalidFormat } from '../exceptions';
+
+describe('at/businessid', () => {
+  it('format:800280610', () => {
+    const result = format('122119m');
+
+    expect(result).toEqual('122119M');
+  });
+
+  it('validate:FN 122119m', () => {
+    const result = validate('FN 122119m');
+
+    expect(result.isValid && result.compact).toEqual('122119M');
+  });
+
+  it('validate:8765432-6', () => {
+    const result = validate('122119m');
+
+    expect(result.isValid && result.compact).toEqual('122119M');
+  });
+
+  it('validate:m122119', () => {
+    const result = validate('m122119');
+
+    expect(result.error).toBeInstanceOf(InvalidFormat);
+  });
+
+  it('validate:abc', () => {
+    const result = validate('abc');
+
+    expect(result.error).toBeInstanceOf(InvalidFormat);
+  });
+});

package/src/at/businessid.ts

@@ -0,0 +1,73 @@
+/**
+ *
+ * Austrian Company Register Numbers.
+ *
+ * Sources:
+ *
+ * ENTITY
+ *
+ */
+
+import * as exceptions from '../exceptions';
+import { strings } from '../util';
+import { Validator, ValidateReturn } from '../types';
+
+function clean(input: string): ReturnType<typeof strings.cleanUnicode> {
+  const [value, err] = strings.cleanUnicode(input, ' -./');
+
+  if (err) {
+    return [value, err];
+  }
+
+  if (value.startsWith('FN')) {
+    return [value.substring(2), null];
+  }
+
+  return [value, null];
+}
+
+const impl: Validator = {
+  name: 'Austrian Company Register Number',
+  localName: 'Company Register Number',
+  compact(input: string): string {
+    const [value, err] = clean(input);
+
+    if (err) {
+      throw err;
+    }
+
+    return value;
+  },
+
+  format(input: string): string {
+    const [value] = clean(input);
+
+    return value;
+  },
+
+  /**
+   * Check if the number is a valid Business ID number.
+   * This checks the length, formatting and other contraints. It does not check
+   * for control letter.
+   */
+  validate(input: string): ValidateReturn {
+    const [value, error] = clean(input);
+
+    if (error) {
+      return { isValid: false, error };
+    }
+    if (!/^\d+[A-Z]$/.test(value)) {
+      return { isValid: false, error: new exceptions.InvalidFormat() };
+    }
+
+    return {
+      isValid: true,
+      compact: value,
+      isIndividual: false,
+      isCompany: true,
+    };
+  },
+};
+
+export const { name, localName, abbreviation, validate, format, compact } =
+  impl;

package/src/at/index.ts

@@ -0,0 +1,4 @@
+export * as businessid from './businessid';
+export * as tin from './tin';
+export * as uid from './uid';
+export * as vnr from './vnr';

package/src/at/tin.spec.ts

@@ -0,0 +1,173 @@
+import { validate, format } from './tin';
+import {
+  InvalidLength,
+  InvalidChecksum,
+  InvalidComponent,
+} from '../exceptions';
+
+describe('at/tin', () => {
+  it('format:591199013', () => {
+    const result = format('591199013');
+
+    expect(result).toEqual('59-119/9013');
+  });
+
+  it('validate:59-119/9013', () => {
+    const result = validate('59-119/9013');
+
+    expect(result.isValid && result.compact).toEqual('591199013');
+  });
+
+  it('validate:660-3', () => {
+    const result = validate('660-3');
+
+    expect(result.error).toBeInstanceOf(InvalidLength);
+  });
+
+  it('validate:59-119/9012', () => {
+    const result = validate('59-119/9012');
+
+    expect(result.error).toBeInstanceOf(InvalidChecksum);
+  });
+
+  it('validate:00-119/9012', () => {
+    const result = validate('00-119/9012');
+
+    expect(result.error).toBeInstanceOf(InvalidComponent);
+  });
+
+  it.each([
+    '98-123/4560',
+    '90-123/4567',
+    '12-987/6546',
+    '46-376/5321',
+    '03-826/1574',
+    '54-267/9451',
+    '03 318/8822',
+    '109999102',
+    '12 035/4980',
+    '12 504/1558',
+    '12 528/1691',
+    '22 283/3014',
+    '29 122/4046',
+    '38-999/9384',
+    '41 248/1145',
+    '46 1744591',
+    '52-123/4567',
+    '52-360/5855',
+    '53 226/8059',
+    '54 202/0565',
+    '59 059/6383',
+    '59 119/9013',
+    '59 149/7540',
+    '61 075/1679',
+    '68 481/8826',
+    '68 545 4266',
+    '68 626/5406',
+    '68 649/8114',
+    '72 222/3526',
+    '81 - 590/9908',
+    '91 166/9307',
+    '91 195/7272',
+    '98 0100127',
+    '98 0207336',
+    '98 0300131',
+    '98 0400378',
+    '98 0500219',
+    '98 0600092',
+    '98 0700306',
+    '98 0800130',
+    '98 0900096',
+    '98 1000284',
+    '98 1100803',
+    '98 1200363',
+    '98 1300460',
+    '98 1400534',
+    '98 1500234',
+    '98 1600042',
+    '98 1700198',
+    '98 1800212',
+    '98 1900087',
+    '98 2017196',
+    '98 2102535',
+    '98 2210643',
+    '98 2300873',
+    '98 2400038',
+    '98 2500597',
+    '98 2612509',
+    '98 2700601',
+    '98 2800047',
+    '98 2900110',
+    '98 3001314',
+    '98 3100249',
+    '98 3200445',
+    '98 3300104',
+    '98 3400326',
+    '98 3500091',
+    '98 3601303',
+    '98 3700030',
+    '98 3800194',
+    '98 3900234',
+    '98 4000257',
+    '98 4100164',
+    '98 4200287',
+    '98 4300152',
+    '98 4400010',
+    '98 4500207',
+    '98 4600254',
+    '98 4700211',
+    '98 4800318',
+    '98 4900050',
+    '98 5000157',
+    '98 5100411',
+    '98 5201573',
+    '98 5300227',
+    '98 5400027',
+    '98 5500701',
+    '98 5600360',
+    '98 9300280',
+    '98 9300363',
+    '98 9300454',
+    '98 9300579',
+    '98 9300686',
+    '98 9300736',
+    '98 9300801',
+    '98 9300819',
+    '98 9300827',
+    '98 9300850',
+    '98 9300868',
+    '98 9301015',
+    '98 9301080',
+    '98 9301155',
+    '98 9301189',
+    '98 9301247',
+    '98 9301270',
+    '98 9301304',
+    '98 9301387',
+    '98 9301528',
+    '98 9301593',
+    '98 9301676',
+    '98 9301684',
+    '98 9301841',
+    '98 9301908',
+    '98 9302021',
+    '98 9302104',
+    '98 9302161',
+    '98 9302286',
+    '98 9302310',
+    '98 9302450',
+    '98 9302500',
+    '98 9302559',
+    '98 9302690',
+    '98 9302807',
+    '98 9302831',
+    '98 9302864',
+    '98 9302914',
+    '98 9302963',
+    '98 9303086',
+  ])('validate:%s', testcase => {
+    const result = validate(testcase);
+
+    expect(result.isValid).toBeTruthy();
+  });
+});