pinoy-faker

JavaScript faker utilities focused on Philippine test data.

pinoy-faker helps you generate realistic sample values for common Filipino use cases like names, contact details, and government ID formats.

Installation

npm install pinoy-faker

Quick start

const faker = require('pinoy-faker');

console.log(faker.names.fullName());
console.log(faker.contact.mobileNumber());
console.log(faker.government.tin());

API

faker.names

Generate Filipino-style names.

• firstName(gender?)
  • gender can be male, female, m, man, boy, or numeric (> 0 = male).
  • If omitted, gender is randomized.
• lastName()
• fullName(gender?)

faker.names.firstName(); // random
faker.names.firstName('male');
faker.names.lastName();
faker.names.fullName('female');

faker.contact

Generate contact details with Philippine-friendly formats.

• mobileNumber() → 09XXXXXXXXX
• landlineNumber(areaCode = '02') → <areaCode>-XXXXXXX
• emailAddress(name = 'juan.dela.cruz')

faker.contact.mobileNumber(); // e.g. 09171234567
faker.contact.landlineNumber('032'); // e.g. 032-1234567
faker.contact.emailAddress('Juan Dela Cruz'); // juan.dela.cruz@gmail.com

faker.government

Generate formatted mock government numbers for testing (not valid real IDs).

• tin() → XXX-XXX-XXX-XXX
• sss() → XX-XXXXXXX-X
• philHealth() → XX-XXXXXXXXX-X
• pagIbig() → XXXX-XXXX-XXXX

faker.government.tin();
faker.government.sss();
faker.government.philHealth();
faker.government.pagIbig();

Notes

• Outputs are randomly generated strings intended for development/testing.
• Generated government numbers follow formatting only and are not guaranteed to pass official validation rules.

Development

Run tests:

npm test