@osimatic/helpers-js 1.4.22 → 1.4.24

package/tests/bank.test.js

@@ -0,0 +1,158 @@
+const { IBAN, BankCard } = require('../bank');
+
+describe('IBAN', () => {
+	describe('format', () => {
+		test('should format IBAN with spaces every 4 characters', () => {
+			const iban = 'FR7630006000011234567890189';
+			expect(IBAN.format(iban)).toBe('FR76 3000 6000 0112 3456 7890 189');
+		});
+
+		test('should remove non-alphanumeric characters', () => {
+			const iban = 'FR76-3000-6000-0112-3456-7890-189';
+			expect(IBAN.format(iban)).toBe('FR76 3000 6000 0112 3456 7890 189');
+		});
+
+		test('should handle IBAN with spaces', () => {
+			const iban = 'FR76 3000 6000 0112 3456 7890 189';
+			expect(IBAN.format(iban)).toBe('FR76 3000 6000 0112 3456 7890 189');
+		});
+
+		test('should handle lowercase letters', () => {
+			const iban = 'fr7630006000011234567890189';
+			expect(IBAN.format(iban)).toBe('FR76 3000 6000 0112 3456 7890 189');
+		});
+
+		test('should remove special characters and spaces', () => {
+			const iban = 'FR76 3000.6000/0112-3456_7890*189';
+			expect(IBAN.format(iban)).toBe('FR76 3000 6000 0112 3456 7890 189');
+		});
+
+		test('should handle German IBAN', () => {
+			const iban = 'DE89370400440532013000';
+			expect(IBAN.format(iban)).toBe('DE89 3704 0044 0532 0130 00');
+		});
+
+		test('should handle Belgian IBAN', () => {
+			const iban = 'BE68539007547034';
+			expect(IBAN.format(iban)).toBe('BE68 5390 0754 7034');
+		});
+
+		test('should handle empty string', () => {
+			expect(IBAN.format('')).toBe('');
+		});
+
+		test('should handle IBAN with mixed case and special chars', () => {
+			const iban = 'fR76@3000#6000$0112%3456^7890&189';
+			expect(IBAN.format(iban)).toBe('FR76 3000 6000 0112 3456 7890 189');
+		});
+	});
+});
+
+describe('BankCard', () => {
+	describe('formatCardNumber', () => {
+		test('should format 16-digit card number with dashes', () => {
+			const cardNumber = '1234567890123456';
+			expect(BankCard.formatCardNumber(cardNumber)).toBe('1234-5678-9012-3456');
+		});
+
+		test('should replace asterisks with X', () => {
+			const cardNumber = '1234********3456';
+			expect(BankCard.formatCardNumber(cardNumber)).toBe('1234-****-****-3456');
+		});
+
+		test('should replace asterisks with custom hiddenChar', () => {
+			const cardNumber = '1234********3456';
+			expect(BankCard.formatCardNumber(cardNumber, 'X')).toBe('1234-XXXX-XXXX-3456');
+		});
+
+		test('should replace X with custom hiddenChar', () => {
+			const cardNumber = '1234XXXXXXXX3456';
+			expect(BankCard.formatCardNumber(cardNumber, '#')).toBe('1234-####-####-3456');
+		});
+
+		test('should replace both * and X with hiddenChar', () => {
+			const cardNumber = '1234**XX**XX3456';
+			// After formatting: 1234-**XX-**XX-3456
+			// After replacing * and X with -: 1234-----------3456 (11 dashes: 3 from formatting + 8 from replacement)
+			expect(BankCard.formatCardNumber(cardNumber, '-')).toBe('1234-----------3456');
+		});
+
+		test('should handle lowercase x', () => {
+			const cardNumber = '1234xxxxxxxx3456';
+			expect(BankCard.formatCardNumber(cardNumber, '•')).toBe('1234-••••-••••-3456');
+		});
+
+		test('should not format if not 16 digits', () => {
+			const cardNumber = '12345678901234';
+			expect(BankCard.formatCardNumber(cardNumber)).toBe('12345678901234');
+		});
+
+		test('should not format if more than 16 digits', () => {
+			const cardNumber = '12345678901234567';
+			expect(BankCard.formatCardNumber(cardNumber)).toBe('12345678901234567');
+		});
+
+		test('should handle card number with all zeros', () => {
+			const cardNumber = '0000000000000000';
+			expect(BankCard.formatCardNumber(cardNumber)).toBe('0000-0000-0000-0000');
+		});
+
+		test('should handle card number with letters (treated as 16 chars)', () => {
+			const cardNumber = '123456789012ABCD';
+			expect(BankCard.formatCardNumber(cardNumber)).toBe('1234-5678-9012-ABCD');
+		});
+
+		test('should handle empty string', () => {
+			expect(BankCard.formatCardNumber('')).toBe('');
+		});
+	});
+
+	describe('formatExpirationDate', () => {
+		// Mock SqlDateTime since it's imported from another module
+		beforeAll(() => {
+			global.SqlDateTime = {
+				getMonthName: jest.fn((date, locale) => {
+					// Mock implementation
+					const d = new Date(date);
+					const month = d.toLocaleString(locale, { month: 'long' });
+					return month.charAt(0).toUpperCase() + month.slice(1);
+				}),
+				getYear: jest.fn((date) => {
+					const d = new Date(date);
+					return d.getFullYear();
+				})
+			};
+		});
+
+		afterAll(() => {
+			delete global.SqlDateTime;
+		});
+
+		test('should format expiration date in French', () => {
+			const date = '2025-12-31';
+			const result = BankCard.formatExpirationDate(date, 'fr-FR');
+			expect(result).toContain('2025');
+			expect(SqlDateTime.getMonthName).toHaveBeenCalledWith(date, 'fr-FR');
+			expect(SqlDateTime.getYear).toHaveBeenCalledWith(date);
+		});
+
+		test('should use default locale fr-FR', () => {
+			const date = '2025-06-15';
+			BankCard.formatExpirationDate(date);
+			expect(SqlDateTime.getMonthName).toHaveBeenCalledWith(date, 'fr-FR');
+		});
+
+		test('should format expiration date in English', () => {
+			const date = '2025-03-20';
+			const result = BankCard.formatExpirationDate(date, 'en-US');
+			expect(result).toContain('2025');
+			expect(SqlDateTime.getMonthName).toHaveBeenCalledWith(date, 'en-US');
+		});
+
+		test('should handle different date formats', () => {
+			const date = '2026-01-01';
+			const result = BankCard.formatExpirationDate(date);
+			expect(result).toContain('2026');
+		});
+	});
+});

package/tests/contact_details.test.js

@@ -0,0 +1,391 @@
+const { PersonName, Email, TelephoneNumber } = require('../contact_details');
+
+describe('PersonName', () => {
+	describe('format', () => {
+		test('should format full name with firstName and lastName', () => {
+			expect(PersonName.format('John', 'Doe')).toBe('John Doe');
+		});
+
+		test('should format with only firstName', () => {
+			expect(PersonName.format('John', null)).toBe('John');
+			expect(PersonName.format('John', '')).toBe('John');
+		});
+
+		test('should format with only lastName', () => {
+			expect(PersonName.format(null, 'Doe')).toBe('Doe');
+			expect(PersonName.format('', 'Doe')).toBe('Doe');
+		});
+
+		test('should return empty string when both are null', () => {
+			expect(PersonName.format(null, null)).toBe('');
+			expect(PersonName.format('', '')).toBe('');
+		});
+
+		test('should trim extra spaces', () => {
+			expect(PersonName.format('  John  ', '  Doe  ')).toBe('John Doe');
+		});
+
+		test('should handle names with special characters', () => {
+			expect(PersonName.format('Jean-Paul', 'O\'Brien')).toBe('Jean-Paul O\'Brien');
+		});
+	});
+
+	describe('checkFirstName', () => {
+		test('should accept valid first names', () => {
+			expect(PersonName.checkFirstName('John')).toBe(true);
+			expect(PersonName.checkFirstName('Jean-Paul')).toBe(true);
+			expect(PersonName.checkFirstName('O\'Brien')).toBe(true);
+			expect(PersonName.checkFirstName('José')).toBe(true);
+			expect(PersonName.checkFirstName('François')).toBe(true);
+		});
+
+		test('should reject first names shorter than 2 characters', () => {
+			expect(PersonName.checkFirstName('J')).toBe(false);
+			expect(PersonName.checkFirstName('')).toBe(false);
+		});
+
+		test('should reject first names longer than 64 characters', () => {
+			const longName = 'A'.repeat(65);
+			expect(PersonName.checkFirstName(longName)).toBe(false);
+		});
+
+		test('should reject first names with numbers', () => {
+			expect(PersonName.checkFirstName('John123')).toBe(false);
+		});
+
+		test('should reject first names with special characters', () => {
+			expect(PersonName.checkFirstName('John@')).toBe(false);
+			expect(PersonName.checkFirstName('John!')).toBe(false);
+		});
+
+		test('should accept first names with spaces', () => {
+			expect(PersonName.checkFirstName('Jean Paul')).toBe(true);
+		});
+
+		test('should accept first names with accented characters', () => {
+			expect(PersonName.checkFirstName('Zoé')).toBe(true);
+			expect(PersonName.checkFirstName('Chloë')).toBe(true);
+		});
+	});
+
+	describe('checkLastName', () => {
+		test('should accept valid last names', () => {
+			expect(PersonName.checkLastName('Doe')).toBe(true);
+			expect(PersonName.checkLastName('Smith-Jones')).toBe(true);
+			expect(PersonName.checkLastName('O\'Brien')).toBe(true);
+			expect(PersonName.checkLastName('Müller')).toBe(true);
+		});
+
+		test('should reject last names shorter than 2 characters', () => {
+			expect(PersonName.checkLastName('D')).toBe(false);
+			expect(PersonName.checkLastName('')).toBe(false);
+		});
+
+		test('should reject last names longer than 64 characters', () => {
+			const longName = 'A'.repeat(65);
+			expect(PersonName.checkLastName(longName)).toBe(false);
+		});
+
+		test('should reject last names with numbers', () => {
+			expect(PersonName.checkLastName('Doe123')).toBe(false);
+		});
+
+		test('should reject last names with special characters', () => {
+			expect(PersonName.checkLastName('Doe@')).toBe(false);
+			expect(PersonName.checkLastName('Doe!')).toBe(false);
+		});
+
+		test('should accept last names with spaces', () => {
+			expect(PersonName.checkLastName('Van Der Berg')).toBe(true);
+		});
+	});
+});
+
+describe('Email', () => {
+	describe('validateEmail', () => {
+		test('should validate correct email addresses', () => {
+			expect(Email.validateEmail('test@example.com')).toBe(true);
+			expect(Email.validateEmail('user.name@example.com')).toBe(true);
+			expect(Email.validateEmail('user+tag@example.co.uk')).toBe(true);
+			expect(Email.validateEmail('user_name@example.com')).toBe(true);
+		});
+
+		test('should reject invalid email addresses', () => {
+			expect(Email.validateEmail('invalid')).toBe(false);
+			expect(Email.validateEmail('invalid@')).toBe(false);
+			expect(Email.validateEmail('@example.com')).toBe(false);
+			expect(Email.validateEmail('invalid@.com')).toBe(false);
+			expect(Email.validateEmail('invalid @example.com')).toBe(false);
+		});
+
+		test('should reject emails with multiple @ symbols', () => {
+			expect(Email.validateEmail('user@@example.com')).toBe(false);
+		});
+
+		test('should accept emails with dots in local part', () => {
+			expect(Email.validateEmail('first.last@example.com')).toBe(true);
+		});
+
+		test('should accept emails with subdomains', () => {
+			expect(Email.validateEmail('user@mail.example.com')).toBe(true);
+		});
+	});
+
+	describe('checkEmail', () => {
+		test('should validate correct email addresses', () => {
+			expect(Email.checkEmail('test@example.com')).toBe(true);
+			expect(Email.checkEmail('user.name@example.co')).toBe(true);
+			expect(Email.checkEmail('user_name@example.org')).toBe(true);
+		});
+
+		test('should reject invalid email addresses', () => {
+			expect(Email.checkEmail('invalid')).toBe(false);
+			expect(Email.checkEmail('invalid@')).toBe(false);
+			expect(Email.checkEmail('@example.com')).toBe(false);
+		});
+
+		test('should reject emails with TLD longer than 5 characters', () => {
+			expect(Email.checkEmail('test@example.museum')).toBe(false);
+		});
+
+		test('should accept emails with TLD up to 5 characters', () => {
+			expect(Email.checkEmail('test@example.co')).toBe(true);
+			expect(Email.checkEmail('test@example.com')).toBe(true);
+			expect(Email.checkEmail('test@example.info')).toBe(true);
+		});
+	});
+
+	describe('getMailToLink', () => {
+		test('should generate mailto link', () => {
+			const email = 'test@example.com';
+			const expected = '<a href="mailto:test@example.com">test@example.com</a>';
+			expect(Email.getMailToLink(email)).toBe(expected);
+		});
+
+		test('should handle email with special characters', () => {
+			const email = 'user+tag@example.com';
+			const expected = '<a href="mailto:user+tag@example.com">user+tag@example.com</a>';
+			expect(Email.getMailToLink(email)).toBe(expected);
+		});
+	});
+});
+
+describe('TelephoneNumber', () => {
+	// Mock libphonenumber
+	beforeAll(() => {
+		global.libphonenumber = {
+			parsePhoneNumber: jest.fn((phoneNumber, countryCode) => {
+				// Simple mock implementation
+				if (phoneNumber === '+33612345678') {
+					return {
+						country: 'FR',
+						formatNational: () => '06 12 34 56 78',
+						formatInternational: () => '+33 6 12 34 56 78',
+						isValid: () => true,
+						getType: () => 'MOBILE'
+					};
+				}
+				if (phoneNumber === '+14155552671') {
+					return {
+						country: 'US',
+						formatNational: () => '(415) 555-2671',
+						formatInternational: () => '+1 415-555-2671',
+						isValid: () => true,
+						getType: () => 'FIXED_LINE_OR_MOBILE'
+					};
+				}
+				if (phoneNumber === 'invalid') {
+					throw new Error('Invalid phone number');
+				}
+				return null;
+			})
+		};
+
+		global.Country = {
+			getCountryName: jest.fn((code) => {
+				const countries = { FR: 'France', US: 'United States' };
+				return countries[code] || code;
+			}),
+			getFlagImg: jest.fn((code) => {
+				return `<img src="/flags/${code.toLowerCase()}.png" />`;
+			})
+		};
+	});
+
+	afterAll(() => {
+		delete global.libphonenumber;
+		delete global.Country;
+	});
+
+	describe('setLocalCountryCode', () => {
+		test('should set local country code', () => {
+			TelephoneNumber.setLocalCountryCode('FR');
+			expect(TelephoneNumber.localCountryCode).toBe('FR');
+		});
+	});
+
+	describe('setIntlTelInputUtilsPath', () => {
+		test('should set intl tel input utils path', () => {
+			const path = '/path/to/utils.js';
+			TelephoneNumber.setIntlTelInputUtilsPath(path);
+			expect(TelephoneNumber.intlTelInputUtilsPath).toBe(path);
+		});
+	});
+
+	describe('getCountryIsoCode', () => {
+		test('should return country code for valid phone number', () => {
+			const result = TelephoneNumber.getCountryIsoCode('+33612345678', 'FR');
+			expect(result).toBe('FR');
+		});
+
+		test('should return null for invalid phone number', () => {
+			const result = TelephoneNumber.getCountryIsoCode('invalid', 'FR');
+			expect(result).toBeNull();
+		});
+	});
+
+	describe('formatNational', () => {
+		test('should format phone number in national format', () => {
+			const result = TelephoneNumber.formatNational('+33612345678', 'FR');
+			expect(result).toBe('06 12 34 56 78');
+		});
+
+		test('should return empty string for invalid phone number', () => {
+			const result = TelephoneNumber.formatNational('invalid', 'FR');
+			expect(result).toBe('');
+		});
+	});
+
+	describe('formatInternational', () => {
+		test('should format phone number in international format', () => {
+			const result = TelephoneNumber.formatInternational('+33612345678', 'FR');
+			expect(result).toBe('+33 6 12 34 56 78');
+		});
+
+		test('should return empty string for invalid phone number', () => {
+			const result = TelephoneNumber.formatInternational('invalid', 'FR');
+			expect(result).toBe('');
+		});
+	});
+
+	describe('formatInternationalWithTelLink', () => {
+		test('should format phone number with tel link', () => {
+			const result = TelephoneNumber.formatInternationalWithTelLink('+33612345678', 'FR');
+			expect(result).toBe('<a href="tel:+33612345678">+33 6 12 34 56 78</a>');
+		});
+	});
+
+	describe('parse', () => {
+		test('should parse valid phone number', () => {
+			const result = TelephoneNumber.parse('+33612345678', 'FR');
+			expect(result).toBe('+33 6 12 34 56 78');
+		});
+
+		test('should return null for invalid phone number', () => {
+			const result = TelephoneNumber.parse('invalid', 'FR');
+			expect(result).toBeNull();
+		});
+	});
+
+	describe('check', () => {
+		test('should validate correct phone number', () => {
+			const result = TelephoneNumber.check('+33612345678', 'FR');
+			expect(result).toBe(true);
+		});
+
+		test('should reject invalid phone number', () => {
+			const result = TelephoneNumber.check('invalid', 'FR');
+			expect(result).toBe(false);
+		});
+	});
+
+	describe('checkSyntaxe', () => {
+		test('should validate French phone numbers', () => {
+			expect(TelephoneNumber.checkSyntaxe('0612345678')).toBe(true);
+			expect(TelephoneNumber.checkSyntaxe('06 12 34 56 78')).toBe(true);
+			expect(TelephoneNumber.checkSyntaxe('06.12.34.56.78')).toBe(true);
+			expect(TelephoneNumber.checkSyntaxe('06-12-34-56-78')).toBe(true);
+		});
+
+		test('should validate international phone numbers', () => {
+			expect(TelephoneNumber.checkSyntaxe('+33612345678')).toBe(true);
+			expect(TelephoneNumber.checkSyntaxe('+33 6 12 34 56 78')).toBe(true);
+			expect(TelephoneNumber.checkSyntaxe('0033612345678')).toBe(true);
+		});
+
+		test('should reject invalid phone numbers', () => {
+			expect(TelephoneNumber.checkSyntaxe('123')).toBe(false);
+			expect(TelephoneNumber.checkSyntaxe('abcdefghij')).toBe(false);
+		});
+	});
+
+	describe('getType', () => {
+		test('should return phone type', () => {
+			const result = TelephoneNumber.getType('+33612345678', 'FR');
+			expect(result).toBe('MOBILE');
+		});
+
+		test('should return MASKED for null or empty phone number', () => {
+			expect(TelephoneNumber.getType(null, 'FR')).toBe('MASKED');
+			expect(TelephoneNumber.getType('', 'FR')).toBe('MASKED');
+		});
+
+		test('should return null for invalid phone number', () => {
+			const result = TelephoneNumber.getType('invalid', 'FR');
+			expect(result).toBeNull();
+		});
+	});
+
+	describe('getTypeLabelList', () => {
+		test('should return type labels object', () => {
+			const labels = TelephoneNumber.getTypeLabelList();
+			expect(labels).toHaveProperty('MOBILE', 'Mobile');
+			expect(labels).toHaveProperty('FIXED_LINE', 'Fixe');
+			expect(labels).toHaveProperty('MASKED', 'Masqué');
+		});
+	});
+
+	describe('getTypeLabel', () => {
+		test('should return label for known type', () => {
+			expect(TelephoneNumber.getTypeLabel('MOBILE')).toBe('Mobile');
+			expect(TelephoneNumber.getTypeLabel('FIXED_LINE')).toBe('Fixe');
+		});
+
+		test('should return Inconnu for unknown type', () => {
+			expect(TelephoneNumber.getTypeLabel('UNKNOWN_TYPE')).toBe('Inconnu');
+		});
+	});
+
+	describe('getCountryName', () => {
+		test('should return country name for phone number', () => {
+			const result = TelephoneNumber.getCountryName('+33612345678', 'FR');
+			expect(result).toBe('France');
+			expect(Country.getCountryName).toHaveBeenCalledWith('FR');
+		});
+	});
+
+	describe('getFlagImg', () => {
+		test('should return flag image for phone number', () => {
+			const result = TelephoneNumber.getFlagImg('+33612345678', 'FR');
+			expect(result).toContain('<img src="/flags/fr.png"');
+			expect(Country.getFlagImg).toHaveBeenCalledWith('FR');
+		});
+	});
+
+	describe('formatNationalWithFlagImg', () => {
+		test('should format phone number with flag image', () => {
+			const result = TelephoneNumber.formatNationalWithFlagImg('+33612345678', 'FR');
+			expect(result).toContain('<img src="/flags/fr.png"');
+			expect(result).toContain('06 12 34 56 78');
+		});
+	});
+
+	describe('formatNationalWithFlagImgAndTelLink', () => {
+		test('should format phone number with flag and tel link', () => {
+			const result = TelephoneNumber.formatNationalWithFlagImgAndTelLink('+33612345678', 'FR');
+			expect(result).toContain('<img src="/flags/fr.png"');
+			expect(result).toContain('<a href="tel:+33612345678">');
+			expect(result).toContain('06 12 34 56 78');
+		});
+	});
+});