feat: add more formatter, parser and validator

Author: MikeSpa

src/format/number.test.ts

@@ -4,6 +4,7 @@ import {
   formatCompact,
   formatCurrency,
   formatCHF,
+  parseCHF,
   formatPercent,
   formatBytes,
 } from './number';
@@ -54,6 +55,45 @@ describe('formatCHF', () => {
 });
 
 
+describe('parseCHF', () => {
+  it('parses apostrophe-thousands with CHF suffix', () => {
+    expect(parseCHF("1'234.50 CHF")).toBe(1234.5);
+  });
+
+  it('parses a plain amount with no separators', () => {
+    expect(parseCHF('50')).toBe(50);
+  });
+
+  it('parses the whole-franc marker ".-"', () => {
+    expect(parseCHF('50.-')).toBe(50);
+    expect(parseCHF("1'234.-")).toBe(1234);
+  });
+
+  it('parses "Fr." and "SFr." labels', () => {
+    expect(parseCHF('Fr. 50.-')).toBe(50);
+    expect(parseCHF('SFr. 1\'234.50')).toBe(1234.5);
+    expect(parseCHF('sfr 50.-')).toBe(50);
+  });
+
+  it('parses a space thousands separator', () => {
+    expect(parseCHF('1 234.50')).toBe(1234.5);
+  });
+
+  it('parses a decimal comma', () => {
+    expect(parseCHF('1234,50')).toBe(1234.5);
+    expect(parseCHF("1'234,50")).toBe(1234.5);
+  });
+
+  it('handles negative amounts', () => {
+    expect(parseCHF("-1'234.50")).toBe(-1234.5);
+  });
+
+  it('returns null for unparseable input', () => {
+    expect(parseCHF('not a number')).toBeNull();
+    expect(parseCHF('')).toBeNull();
+  });
+});
+
 describe('formatPercent', () => {
   it('formats a decimal as a percentage (fr-CH)', () => {
     expect(formatPercent(0.456)).toBe('45,6%');

src/format/number.ts

@@ -34,6 +34,38 @@ export function formatCHF(amount: number): string {
   return `${intFormatted}.${dec} CHF`;
 }
 
+/**
+ * Parses a Swiss-formatted amount into a number. Accepts apostrophe or space thousands
+ * separators, "." or "," as the decimal separator, a trailing ".-" whole-franc marker
+ * (e.g. "50.-" -> 50), and an optional "CHF" / "Fr." / "SFr." label. Returns null if unparseable.
+ */
+export function parseCHF(input: string): number | null {
+  let s = input.trim();
+  if (!s) return null;
+
+  s = s
+    .replace(/^(CHF|SFr\.?|Fr\.?)\s*/i, '')
+    .replace(/\s*(CHF|SFr\.?|Fr\.?)$/i, '')
+    .trim();
+  s = s.replace(/\.-\s*$/, '.00');
+  s = s.replace(/['’\s]/g, '');
+
+  const lastComma = s.lastIndexOf(',');
+  const lastDot = s.lastIndexOf('.');
+  if (lastComma !== -1 && lastDot !== -1) {
+    s = lastComma > lastDot
+      ? s.replace(/\./g, '').replace(',', '.')
+      : s.replace(/,/g, '');
+  } else if (lastComma !== -1) {
+    const [whole, frac] = s.split(',');
+    s = frac !== undefined && frac.length <= 2 ? `${whole}.${frac}` : s.replace(/,/g, '');
+  }
+
+  if (!/^-?\d+(\.\d+)?$/.test(s)) return null;
+  const value = parseFloat(s);
+  return Number.isFinite(value) ? value : null;
+}
+
 /** Format a number as a percentage. e.g. 0.456 -> "45,6%" (fr-CH). `fractionDigits` is the maximum decimal places (trailing zeros stripped). */
 export function formatPercent(
   value: number,

src/format/swiss.test.ts

@@ -1,5 +1,17 @@
 import { describe, it, expect } from 'vitest';
-import { formatPhone, formatIBAN } from './swiss';
+import {
+  formatPhone,
+  isValidPhone,
+  formatIBAN,
+  isValidIBAN,
+  formatAHV,
+  isValidAHV,
+  formatQRReference,
+  isValidQRReference,
+  formatUID,
+  isValidUID,
+  isValidSwissPostalCode,
+} from './swiss';
 
 describe('formatPhone', () => {
   it('formats a number with leading 0', () => {
@@ -27,6 +39,33 @@ describe('formatPhone', () => {
   });
 });
 
+describe('isValidPhone', () => {
+  it('accepts a valid mobile number in any supported form', () => {
+    expect(isValidPhone('0791234567')).toBe(true);
+    expect(isValidPhone('+41791234567')).toBe(true);
+    expect(isValidPhone('0041 79 123 45 67')).toBe(true);
+  });
+
+  it('accepts a valid landline number', () => {
+    expect(isValidPhone('0441234567')).toBe(true);
+  });
+
+  it('rejects a national number starting with 0 or 1', () => {
+    expect(isValidPhone('0123456789')).toBe(false);
+    expect(isValidPhone('0012345678')).toBe(false);
+  });
+
+  it('rejects the wrong length', () => {
+    expect(isValidPhone('079123456')).toBe(false);
+    expect(isValidPhone('07912345678')).toBe(false);
+  });
+
+  it('rejects unparseable input', () => {
+    expect(isValidPhone('not-a-phone')).toBe(false);
+    expect(isValidPhone('')).toBe(false);
+  });
+});
+
 describe('formatIBAN', () => {
   it('groups a raw IBAN into blocks of 4', () => {
     expect(formatIBAN('CH5604835012345678009')).toBe('CH56 0483 5012 3456 7800 9');
@@ -44,3 +83,144 @@ describe('formatIBAN', () => {
     expect(formatIBAN('')).toBe('');
   });
 });
+
+describe('isValidIBAN', () => {
+  it('accepts a valid Swiss IBAN', () => {
+    expect(isValidIBAN('CH5604835012345678009')).toBe(true);
+  });
+
+  it('accepts a spaced IBAN', () => {
+    expect(isValidIBAN('CH56 0483 5012 3456 7800 9')).toBe(true);
+  });
+
+  it('accepts lowercase input', () => {
+    expect(isValidIBAN('ch5604835012345678009')).toBe(true);
+  });
+
+  it('accepts valid IBANs from other countries', () => {
+    expect(isValidIBAN('GB29 NWBK 6016 1331 9268 19')).toBe(true);
+    expect(isValidIBAN('DE89 3704 0044 0532 0130 00')).toBe(true);
+  });
+
+  it('rejects an IBAN with a bad check digit', () => {
+    expect(isValidIBAN('CH5604835012345678008')).toBe(false);
+  });
+
+  it('rejects malformed input', () => {
+    expect(isValidIBAN('not an iban')).toBe(false);
+    expect(isValidIBAN('')).toBe(false);
+    expect(isValidIBAN('CH12')).toBe(false);
+  });
+});
+
+describe('formatAHV', () => {
+  it('groups a 13-digit AHV number', () => {
+    expect(formatAHV('7569217076985')).toBe('756.9217.0769.85');
+  });
+
+  it('strips existing separators before formatting', () => {
+    expect(formatAHV('756.9217.0769.85')).toBe('756.9217.0769.85');
+  });
+
+  it('returns input unchanged if not 13 digits', () => {
+    expect(formatAHV('12345')).toBe('12345');
+  });
+});
+
+describe('isValidAHV', () => {
+  it('accepts a valid AHV number', () => {
+    expect(isValidAHV('756.9217.0769.85')).toBe(true);
+    expect(isValidAHV('7569217076985')).toBe(true);
+  });
+
+  it('rejects a wrong check digit', () => {
+    expect(isValidAHV('756.9217.0769.86')).toBe(false);
+  });
+
+  it('rejects a non-756 prefix', () => {
+    expect(isValidAHV('123.9217.0769.85')).toBe(false);
+  });
+
+  it('rejects the wrong length', () => {
+    expect(isValidAHV('756.9217.0769')).toBe(false);
+  });
+});
+
+describe('formatQRReference', () => {
+  it('groups a 27-digit reference in blocks of 5 from the right', () => {
+    expect(formatQRReference('210000000003139471430009017')).toBe(
+      '21 00000 00003 13947 14300 09017'
+    );
+  });
+
+  it('returns input unchanged for non-numeric input', () => {
+    expect(formatQRReference('not-a-reference')).toBe('not-a-reference');
+  });
+});
+
+describe('isValidQRReference', () => {
+  it('accepts a valid QR-bill reference', () => {
+    expect(isValidQRReference('210000000003139471430009017')).toBe(true);
+    expect(isValidQRReference('21 00000 00003 13947 14300 09017')).toBe(true);
+  });
+
+  it('rejects a wrong check digit', () => {
+    expect(isValidQRReference('210000000003139471430009018')).toBe(false);
+  });
+
+  it('rejects malformed input', () => {
+    expect(isValidQRReference('not-a-reference')).toBe(false);
+    expect(isValidQRReference('')).toBe(false);
+    expect(isValidQRReference('1')).toBe(false);
+  });
+});
+
+describe('formatUID', () => {
+  it('formats a 9-digit UID with CHE prefix', () => {
+    expect(formatUID('116281710')).toBe('CHE-116.281.710');
+  });
+
+  it('strips existing separators before formatting', () => {
+    expect(formatUID('CHE-116.281.710')).toBe('CHE-116.281.710');
+  });
+
+  it('returns input unchanged if not 9 digits', () => {
+    expect(formatUID('123')).toBe('123');
+  });
+});
+
+describe('isValidUID', () => {
+  it('accepts a valid UID (with or without CHE prefix)', () => {
+    expect(isValidUID('CHE-116.281.710')).toBe(true);
+    expect(isValidUID('116281710')).toBe(true);
+    expect(isValidUID('CHE-107.787.577')).toBe(true);
+  });
+
+  it('rejects a wrong check digit', () => {
+    expect(isValidUID('CHE-116.281.711')).toBe(false);
+  });
+
+  it('rejects malformed input', () => {
+    expect(isValidUID('not-a-uid')).toBe(false);
+    expect(isValidUID('')).toBe(false);
+  });
+});
+
+describe('isValidSwissPostalCode', () => {
+  it('accepts a valid postal code', () => {
+    expect(isValidSwissPostalCode('1000')).toBe(true);
+    expect(isValidSwissPostalCode('8001')).toBe(true);
+    expect(isValidSwissPostalCode('9658')).toBe(true);
+  });
+
+  it('rejects codes outside the assigned range', () => {
+    expect(isValidSwissPostalCode('0999')).toBe(false);
+    expect(isValidSwissPostalCode('9659')).toBe(false);
+  });
+
+  it('rejects malformed input', () => {
+    expect(isValidSwissPostalCode('12345')).toBe(false);
+    expect(isValidSwissPostalCode('abcd')).toBe(false);
+    expect(isValidSwissPostalCode('')).toBe(false);
+  });
+});