Utilities and Errors

Phone number field helper

Use TiquoPhone.createField() on every phone input so international phone numbers are formatted correctly. It adds a country picker with flags, formats the number as the customer types, and validates it for the selected country. It needs DOM Package 1.7.0 or newer.

<input id="phone" type="tel" autocomplete="tel" />

import { TiquoPhone } from '@tiquo/dom-package';

const phoneField = TiquoPhone.createField('#phone', {
  defaultCountry: 'GB', // otherwise the browser's country
  preferredCountries: ['GB', 'US'],
});

// When the form is submitted:
const { e164, countryCode } = phoneField.getValue();
await tiquo.createEnquiry({
  customer: { email, phone: e164, phoneCountry: countryCode },
  enquiry: { type: 'YOUR_ENQUIRY_TYPE_ID', subject: 'Website enquiry' },
});

getValue() returns value (what the input shows), e164 (the normalized number, such as +447911123456, empty until the number is valid), countryCode, and valid. The field also emits a tiquo:phone-change event with the same values. Options include allowedCountries, countryDisplay (flag, code, dial-code, flag-code, or name), and classes for your own styling.

To keep your own markup, pass a container that holds a <select data-tiquo-phone-country> and an <input data-tiquo-phone-number>. The helper fills in the countries without adding elements, which suits React and other frameworks that render the page. Call phoneField.destroy() when the field is removed.

Phone number utilities

TiquoPhone provides static helpers for international phone inputs. You do not need to initialize Tiquo to use them.

import { TiquoPhone } from '@tiquo/dom-package';

const phone = TiquoPhone.buildPhone('GB', '07911 123456');
const result = TiquoPhone.validate(phone);

if (result.valid) {
  console.log(result.normalized); // +447911123456
}

getCountries() returns alphabetically sorted records with code, name, dialCode, format, and flag fields. updateProfile() and createEnquiry() also normalize supplied phone numbers before submission, but validating in the form gives the customer earlier feedback.

Typed errors

SDK operations reject with TiquoAuthError when the package can provide a structured code:

import { TiquoAuthError } from '@tiquo/dom-package';

try {
  await tiquo.verifyOTP(email, code);
} catch (error) {
  if (error instanceof TiquoAuthError) {
    console.error(error.code, error.message, error.statusCode);
  } else {
    throw error;
  }
}

Common codes include:

Use code for control flow and present an application-owned, customer-friendly message. Preserve statusCode and the original error in internal diagnostics, but never log access tokens, refresh tokens, or OTP values.