domain-glossary-phone

A glossary of intuitive, universally unambiguous phone definitions and useful procedures.

purpose

declare a universally unambiguous serialization format for phones

• UniPhoneNumber = E.164
• UniPhone = { number: UniPhoneNumber }

usecases

• clarify the format a string should be in (const phoneNumber: UniPhoneNumber = '[phone]')
• cast date to universal format (const phoneNumber: UniPhoneNumber = asUniPhoneNumber('[phone]'))
• narrow type of strings with runtime validation (if (!isUniPhoneNumber(input)) throw new Error('wrong format'))

install

npm install domain-glossary-phone

use

Phone

declare that a phone or phone.number must be in the universal format

const phone: UniPhone;
const phoneNumber: UniPhoneNumber;

assure that a phone number is in the universal format

const phone: UniPhone = { number: isUniPhoneNumber.assure('[phone]') }

cast a phone number into the universal format

const phone: UniPhone = { number: asUniPhoneNumber('[phone]') }