Free, Open Source, Self-Hosted WhatsApp API Gateway
TypeScript apibotgatewayself-hostedwhatsappwhatsapp-apiwhatsapp-automationwhatsapp-botwhatsapp-gatewaywhatsapp-gateway-apiwhatsapp-webwhatsapp-web-api
import { buildVCard } from './vcard';
describe('buildVCard', () => {
it('strips CR/LF from name and number so extra vCard lines cannot be injected', () => {
const vcard = buildVCard({ name: 'Alice\r\nEMAIL:[email protected]', number: '+1 234\r\nNOTE:x' });
// A bare CR left behind would still read as a line break to some vCard consumers.
expect(vcard).not.toMatch(/\r/);
const lines = vcard.split('\n');
// No injected lines — exactly the five canonical vCard lines. The crafted text is folded into the
// FN/TEL values as inline text rather than becoming a standalone EMAIL/NOTE property line.
expect(lines).toHaveLength(5);
expect(lines.some(l => l.startsWith('EMAIL:') || l.startsWith('NOTE:'))).toBe(false);
expect(lines[0]).toBe('BEGIN:VCARD');
expect(lines[4]).toBe('END:VCARD');
});
it('reduces the waid to digits only', () => {
const vcard = buildVCard({ name: 'Bob', number: '+1 (234) 567-8900' });
expect(vcard).toContain('waid=12345678900:');
});
it('produces a VERSION:3.0 vCard with FN and TEL', () => {
const vcard = buildVCard({ name: 'Carol', number: '628123' });
expect(vcard.split('\n')).toEqual([
'BEGIN:VCARD',
'VERSION:3.0',
'FN:Carol',
'TEL;type=CELL;type=VOICE;waid=628123:628123',
'END:VCARD',
]);
});
it('escapes vCard structural characters (backslash, semicolon, comma) in FN', () => {
// name = Acme;Corp,Ltd\X (one literal backslash before X)
const vcard = buildVCard({ name: 'Acme;Corp,Ltd\\X', number: '628123' });
const fnLine = vcard.split('\n').find(l => l.startsWith('FN:'));
// backslash escaped first, then ; and , — so the value carries a literal backslash before each.
expect(fnLine).toBe('FN:Acme\\;Corp\\,Ltd\\\\X');
// the bare (unescaped) structural sequence must not survive — proves the escape isn't a JS no-op.
expect(fnLine?.includes('Acme;Corp')).toBe(false);
});
});