validate-kaike-js

🚀 validate-kaike-js

A modern and lightweight library for validating emails, identity cards (ID), IBANs, passports, and phone numbers. ✅

📦 Installation

Install the library using your favorite package manager:

# Using npm
npm install validate-kaike-js

# Using yarn
yarn add validate-kaike-js

# Using pnpm
pnpm add validate-kaike-js

🚀 How to Use

The validate function must always be used for both single and multiple validations, ensuring consistency and simplicity in implementation.

🎯 Single Validation

import {
  validate,
  validateEmail,
  validateIdentityCard,
  validateIban,
  validatePassport,
  validatePhoneCountryCode,
} from "validate-kaike-js";

validate([{ fn: validateEmail, input: "[e-mail]", provider: "GMAIL" }])
  .then(console.log)
  .catch(console.error);

validate([{ fn: validateIdentityCard, input: "123456789LA001", country: "AO" }])
  .then(console.log)
  .catch(console.error);

If the input is invalid, an error will be thrown:

validate([{ fn: validateEmail, input: "invalid_email", provider: "GMAIL" }]).catch(console.error);

Output:

[{ message: "Invalid email", value: "invalid_email" }];

🔄 Multiple Validation

Validate multiple inputs simultaneously with validate():

validate([
  { fn: validateEmail, input: "[e-mail]", provider: "GMAIL" },
  { fn: validateIdentityCard, input: "123456789LA001", country: "AO" },
  { fn: validateIban, input: "AO06123456789012345678901", country: "AO" },
  { fn: validatePassport, input: "A1234567", country: "US" },
  { fn: validatePhoneCountryCode, input: "[phone]", phoneCountryCode: "+244" },
])
  .then(console.log)
  .catch(console.error);

✅ If all validations pass, the return will be an array with the results:

[
  { message: "Valid email", value: "[e-mail]" },
  { message: "Valid identity card", value: "123456789LA001" },
  { message: "Valid IBAN", value: "AO06123456789012345678901" },
  { message: "Valid Passport", value: "A1234567" },
  { message: "Valid phone country code", value: "[phone]" },
];

❌ If any validation fails, validate rejects the promise with an array of errors:

validate([{ fn: validateEmail, input: "invalid_email", provider: "GMAIL" }]).catch(console.error);

Output:

[{ message: "Invalid email", value: "invalid_email" }];

📜 Available Methods

Method	Validates	Valid Example	Invalid Example	Additional Argument
validateEmail	Email	[e-mail]	invalid_email	provider (only for this method)
validateIdentityCard	Identity card	123456789LA001	12345ABC	country (only for this method)
validateIban	IBAN	AO06123456789012345678901	123456	country (only for this method)
validatePassport	Passport	A1234567	XYZ12	country (only for this method)
validatePhoneCountryCode	Phone country code	[phone]	+000000000000	phoneCountryCode (only for this method)

🎓 License

MIT © 2025 - Kaike Bartolomeu