@phonecheck/phone-number-validator-js 1.7.3-beta.1 → 2.0.0

package/dist/index.js

@@ -0,0 +1,254 @@
+'use strict';
+
+var bson = require('bson');
+var tinyLru = require('tiny-lru');
+var node_fs = require('node:fs');
+var node_path = require('node:path');
+var node_url = require('node:url');
+var libphonenumberJs = require('libphonenumber-js');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+const DEFAULT_CACHE_SIZE = 100;
+let cache = tinyLru.lru(DEFAULT_CACHE_SIZE);
+let maxSize = DEFAULT_CACHE_SIZE;
+function cacheGet(key) {
+  return cache.get(key);
+}
+function cacheSet(key, value) {
+  cache.set(key, value);
+}
+function clearCache() {
+  cache.clear();
+}
+function getCacheSize() {
+  return cache.size;
+}
+function getCacheStats() {
+  return { size: cache.size, maxSize };
+}
+function setCacheSize(size) {
+  if (size <= 0) {
+    throw new Error(`Cache size must be > 0 (got ${size})`);
+  }
+  if (size === maxSize)
+    return;
+  const previous = cache;
+  cache = tinyLru.lru(size);
+  maxSize = size;
+  const entries = [...previous.entries()].reverse();
+  for (const [key, value] of entries) {
+    if (cache.size >= size)
+      break;
+    cache.set(key, value);
+  }
+}
+
+const DEFAULT_LOCALE = "en";
+const TIMEZONES_PATH = "timezones.bson";
+let activeLoader = null;
+function setResourceLoader(loader) {
+  activeLoader = loader;
+}
+function getResourceLoader() {
+  return activeLoader;
+}
+function findByPrefix(table, key) {
+  for (let prefix = key; prefix.length > 0; prefix = prefix.slice(0, -1)) {
+    const value = table[prefix];
+    if (typeof value === "string" && value.length > 0)
+      return value;
+  }
+  return null;
+}
+function decodeBson(bytes) {
+  if (!bytes || bytes.byteLength === 0)
+    return null;
+  const buf = Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
+  return bson.deserialize(buf);
+}
+function logLoadError(path, err) {
+  if (process.env.NODE_ENV !== "production") {
+    console.error(`Error loading data from ${path}:`, err);
+  }
+}
+function rememberTable(path, bytes) {
+  const table = decodeBson(bytes);
+  if (!table)
+    return null;
+  cacheSet(path, table);
+  return table;
+}
+async function loadTableAsync(path) {
+  if (!activeLoader)
+    return null;
+  const cached = cacheGet(path);
+  if (cached)
+    return cached;
+  try {
+    return rememberTable(path, await activeLoader.loadResource(path));
+  } catch (err) {
+    logLoadError(path, err);
+    return null;
+  }
+}
+function loadTableSync(path) {
+  if (!(activeLoader === null || activeLoader === void 0 ? void 0 : activeLoader.loadResourceSync))
+    return null;
+  const cached = cacheGet(path);
+  if (cached)
+    return cached;
+  try {
+    return rememberTable(path, activeLoader.loadResourceSync(path));
+  } catch (err) {
+    logLoadError(path, err);
+    return null;
+  }
+}
+function localeResourcePath(kind, locale, countryCode) {
+  return `${kind}/${locale}/${countryCode}.bson`;
+}
+function localePaths(kind, locale, cc) {
+  if (locale === DEFAULT_LOCALE)
+    return [localeResourcePath(kind, DEFAULT_LOCALE, cc)];
+  return [localeResourcePath(kind, locale, cc), localeResourcePath(kind, DEFAULT_LOCALE, cc)];
+}
+function partsOf(phoneNumber) {
+  var _a, _b;
+  const national = (_a = phoneNumber === null || phoneNumber === void 0 ? void 0 : phoneNumber.nationalNumber) === null || _a === void 0 ? void 0 : _a.toString();
+  const cc = (_b = phoneNumber === null || phoneNumber === void 0 ? void 0 : phoneNumber.countryCallingCode) === null || _b === void 0 ? void 0 : _b.toString();
+  if (!national || !cc)
+    return null;
+  return { national, cc };
+}
+function timezoneKey(phoneNumber) {
+  var _a;
+  const raw = (_a = phoneNumber === null || phoneNumber === void 0 ? void 0 : phoneNumber.number) === null || _a === void 0 ? void 0 : _a.toString();
+  if (!raw)
+    return null;
+  return raw.startsWith("+") ? raw.slice(1) : raw;
+}
+function parseTimezones(value) {
+  if (!value)
+    return null;
+  const zones = value.split("&").filter((z) => z.length > 0);
+  return zones.length > 0 ? zones : null;
+}
+async function localizedAsync(kind, phoneNumber, locale) {
+  const parts = partsOf(phoneNumber);
+  if (!parts)
+    return null;
+  for (const path of localePaths(kind, locale, parts.cc)) {
+    const table = await loadTableAsync(path);
+    const hit = table ? findByPrefix(table, parts.national) : null;
+    if (hit)
+      return hit;
+  }
+  return null;
+}
+function localizedSync(kind, phoneNumber, locale) {
+  const parts = partsOf(phoneNumber);
+  if (!parts)
+    return null;
+  for (const path of localePaths(kind, locale, parts.cc)) {
+    const table = loadTableSync(path);
+    const hit = table ? findByPrefix(table, parts.national) : null;
+    if (hit)
+      return hit;
+  }
+  return null;
+}
+function geocoder(phoneNumber, locale = DEFAULT_LOCALE) {
+  return localizedSync("geocodes", phoneNumber, locale);
+}
+function carrier(phoneNumber, locale = DEFAULT_LOCALE) {
+  return localizedSync("carrier", phoneNumber, locale);
+}
+function timezones(phoneNumber) {
+  const key = timezoneKey(phoneNumber);
+  if (!key)
+    return null;
+  const table = loadTableSync(TIMEZONES_PATH);
+  return table ? parseTimezones(findByPrefix(table, key)) : null;
+}
+async function geocoderAsync(phoneNumber, locale = DEFAULT_LOCALE) {
+  return localizedAsync("geocodes", phoneNumber, locale);
+}
+async function carrierAsync(phoneNumber, locale = DEFAULT_LOCALE) {
+  return localizedAsync("carrier", phoneNumber, locale);
+}
+async function timezonesAsync(phoneNumber) {
+  const key = timezoneKey(phoneNumber);
+  if (!key)
+    return null;
+  const table = await loadTableAsync(TIMEZONES_PATH);
+  return table ? parseTimezones(findByPrefix(table, key)) : null;
+}
+async function enrichPhoneNumber(phoneNumber, options = {}) {
+  const [geocode, car, tz] = await Promise.all([
+    geocoderAsync(phoneNumber, options.locale),
+    carrierAsync(phoneNumber, options.carrierLocale),
+    timezonesAsync(phoneNumber)
+  ]);
+  return { geocode, carrier: car, timezones: tz };
+}
+
+function defaultResourcesDir() {
+  let here;
+  try {
+    here = __dirname;
+  } catch {
+    here = node_path.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.js', document.baseURI).href))));
+  }
+  let dir = here;
+  for (let i = 0; i < 6; i++) {
+    const candidate = node_path.resolve(dir, "resources");
+    if (node_fs.existsSync(node_path.resolve(candidate, "timezones.bson"))) {
+      return candidate;
+    }
+    const parent = node_path.resolve(dir, "..");
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  return node_path.resolve(here, "..", "resources");
+}
+class NodeFsResourceLoader {
+  constructor(options = {}) {
+    var _a;
+    this.baseDir = (_a = options.resourcesDir) !== null && _a !== void 0 ? _a : defaultResourcesDir();
+  }
+  async loadResource(path) {
+    return this.loadResourceSync(path);
+  }
+  loadResourceSync(path) {
+    const fullPath = node_path.join(this.baseDir, path);
+    if (!node_fs.existsSync(fullPath))
+      return null;
+    return node_fs.readFileSync(fullPath);
+  }
+}
+
+setResourceLoader(new NodeFsResourceLoader());
+
+exports.DEFAULT_CACHE_SIZE = DEFAULT_CACHE_SIZE;
+exports.NodeFsResourceLoader = NodeFsResourceLoader;
+exports.carrier = carrier;
+exports.carrierAsync = carrierAsync;
+exports.clearCache = clearCache;
+exports.enrichPhoneNumber = enrichPhoneNumber;
+exports.geocoder = geocoder;
+exports.geocoderAsync = geocoderAsync;
+exports.getCacheSize = getCacheSize;
+exports.getCacheStats = getCacheStats;
+exports.getResourceLoader = getResourceLoader;
+exports.setCacheSize = setCacheSize;
+exports.setResourceLoader = setResourceLoader;
+exports.timezones = timezones;
+exports.timezonesAsync = timezonesAsync;
+Object.keys(libphonenumberJs).forEach(function (k) {
+    if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+        enumerable: true,
+        get: function () { return libphonenumberJs[k]; }
+    });
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/cache.ts","../src/core.ts","../src/node-fs-loader.ts","../src/index.ts"],"sourcesContent":[null,null,null,null],"names":["lru","deserialize","dirname","fileURLToPath","resolve","existsSync","join","readFileSync"],"mappings":"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"}

package/{lib → dist}/locales.d.ts

@@ -1,3 +1,2 @@
-export type GeocoderLocale = 'ar' | 'be' | 'bg' | 'bs' | 'de' | 'el' | 'en' | 'es' | 'fa' | 'fi' | 'fr' | 'hr' | 'hu' | 'hy' | 'id' | 'it' | 'iw' | 'ja' | 'kk' | 'ko' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sq' | 'sr' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh_Hant';
+export type GeocoderLocale = 'ar' | 'be' | 'bg' | 'bs' | 'de' | 'el' | 'en' | 'es' | 'fa' | 'fi' | 'fr' | 'hr' | 'hu' | 'hy' | 'id' | 'it' | 'iw' | 'ja' | 'ko' | 'nl' | 'pl' | 'pt' | 'ro' | 'ru' | 'sq' | 'sr' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh_Hant';
 export type CarrierLocale = 'ar' | 'be' | 'en' | 'fa' | 'ko' | 'ru' | 'uk' | 'zh' | 'zh_Hant';
-//# sourceMappingURL=locales.d.ts.map

package/dist/node-fs-loader.d.ts

@@ -0,0 +1,19 @@
+import type { ResourceLoader } from './types';
+export interface NodeFsResourceLoaderOptions {
+    /**
+     * Override the directory where `geocodes/`, `carrier/`, and
+     * `timezones.bson` live. Defaults to the bundled `resources/` next to the
+     * built `dist/` directory.
+     */
+    resourcesDir?: string;
+}
+/**
+ * Sync + async loader backed by `node:fs`. Async methods exist for parity
+ * with custom loaders and just wrap the sync read.
+ */
+export declare class NodeFsResourceLoader implements ResourceLoader {
+    private readonly baseDir;
+    constructor(options?: NodeFsResourceLoaderOptions);
+    loadResource(path: string): Promise<Uint8Array | null>;
+    loadResourceSync(path: string): Uint8Array | null;
+}

package/dist/serverless/_shared/cors.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CORS header set used by every adapter. `methods` lets each platform
+ * advertise the verbs it actually supports without re-declaring the rest.
+ */
+export declare function corsHeaders(methods?: string): Record<string, string>;
+export declare function jsonHeaders(extra?: Record<string, string>): Record<string, string>;

package/dist/serverless/_shared/dispatch.d.ts

@@ -0,0 +1,22 @@
+import type { BatchOptions, ValidationDispatch } from './validation';
+export interface PhoneValidationResult {
+    input: string;
+    valid: boolean;
+    error?: string;
+    formatted?: {
+        e164: string;
+        international: string;
+        national: string;
+        rfc3966: string;
+    };
+    country?: string;
+    countryCallingCode?: string;
+    nationalNumber?: string;
+    type?: string;
+    geocode?: string | null;
+    carrier?: string | null;
+    timezones?: string[] | null;
+}
+export declare function executeValidation(dispatch: ValidationDispatch): Promise<PhoneValidationResult | PhoneValidationResult[]>;
+export declare function validateSingle(input: string, options?: BatchOptions): Promise<PhoneValidationResult>;
+export declare function validateBatch(inputs: string[], options?: BatchOptions): Promise<PhoneValidationResult[]>;

package/dist/serverless/_shared/lambda-helpers.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Helpers for Lambda-shaped runtimes (AWS API Gateway proxy events, Netlify
+ * Functions, classic GCP). Bodies arrive as strings (optionally base64) and
+ * responses are `{ statusCode, headers, body: string }` shapes.
+ */
+export interface LambdaLikeEvent {
+    body: string | null;
+    isBase64Encoded?: boolean;
+}
+export interface LambdaResult {
+    statusCode: number;
+    headers?: {
+        [key: string]: string;
+    };
+    body: string;
+}
+/**
+ * Decode an API Gateway / Netlify body, supporting base64 payloads. Throws
+ * `SyntaxError` on malformed JSON so callers can map it to a 400 cleanly.
+ */
+export declare function decodeLambdaBody(event: LambdaLikeEvent): unknown;
+/** Lambda-shaped JSON response shorthand. */
+export declare function lambdaResponse(statusCode: number, body: unknown, headers: Record<string, string>): LambdaResult;

package/dist/serverless/_shared/routes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pure routing decision used by every routed adapter. Adapters do their own
+ * path normalization (Netlify strips `/.netlify/functions/<name>`, Vercel +
+ * Azure use `/api/...`, AWS uses raw `/...`) and then ask `classifyRoute` to
+ * decide what to do.
+ *
+ * Centralising the decision tree means a new endpoint (say `/cache/clear`)
+ * lands in one place instead of six.
+ */
+export type Route = {
+    kind: 'preflight';
+} | {
+    kind: 'health';
+} | {
+    kind: 'validate-single';
+} | {
+    kind: 'validate-batch';
+} | {
+    kind: 'method-not-allowed';
+} | {
+    kind: 'not-found';
+};
+export declare function classifyRoute(path: string, method: string): Route;
+/** Standard healthy-status payload used by every adapter. */
+export declare function healthPayload(platform: string): {
+    status: 'healthy';
+    platform: string;
+    timestamp: string;
+};

package/dist/serverless/_shared/validation.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Request body classification shared by every serverless adapter.
+ *
+ * Every adapter accepts the same JSON shape:
+ *   { phoneNumber: "+14155552671", defaultCountry?: "US", locale?: "en", carrierLocale?: "en" }
+ *
+ * Or a batch:
+ *   { phoneNumbers: ["+14155552671", "+442079460958"], defaultCountry?: "US", ... }
+ *
+ * Centralising the shape (and the 100-entry batch cap) means a future change
+ * lands in one place instead of six adapter files.
+ */
+import type { CarrierLocale, GeocoderLocale } from '../../types';
+export declare const MAX_BATCH_SIZE = 100;
+/** Fields shared by request bodies and downstream `BatchOptions`. */
+interface ValidationCommon {
+    defaultCountry?: string;
+    locale?: GeocoderLocale;
+    carrierLocale?: CarrierLocale;
+    /** Run the geocoder lookup (default: true). */
+    geocode?: boolean;
+    /** Run the carrier lookup (default: true). */
+    carrier?: boolean;
+    /** Run the timezone lookup (default: true). */
+    timezones?: boolean;
+}
+export interface ValidationRequestBody extends ValidationCommon {
+    phoneNumber?: string;
+    phoneNumbers?: string[];
+}
+export type BatchOptions = ValidationCommon;
+export type ValidationDispatch = {
+    kind: 'single';
+    phoneNumber: string;
+    options: BatchOptions;
+} | {
+    kind: 'batch';
+    phoneNumbers: string[];
+    options: BatchOptions;
+};
+export interface ValidationFailure {
+    kind: 'invalid';
+    status: 400;
+    message: string;
+}
+export type BatchValidation = {
+    ok: true;
+    phoneNumbers: string[];
+} | {
+    ok: false;
+    status: 400;
+    message: string;
+};
+/** Lift the locale + enrichment fields out of a request body. */
+export declare function extractBatchOptions(body: ValidationRequestBody): BatchOptions;
+export declare function validateBatchField(phoneNumbers: unknown): BatchValidation;
+export declare function classifyRequest(body: ValidationRequestBody | null | undefined): ValidationDispatch | ValidationFailure;
+export {};

package/dist/serverless/_shared/web-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { ValidationRequestBody } from './validation';
+/**
+ * Map URL query params onto a `ValidationRequestBody`. `phoneNumbers` accepts
+ * a comma-separated list (`?phoneNumbers=+1,+44`). Boolean enrichment toggles
+ * accept any of `true|false|1|0|yes|no|on|off`.
+ */
+export declare function parseQueryParams(url: URL): ValidationRequestBody;
+/** Web-API JSON response shorthand. */
+export declare function jsonResponse(status: number, body: unknown, headers: Record<string, string>): Response;
+/** `application/json` content-type guard for routed POST endpoints. */
+export declare function requireJsonContentType(request: Request, headers: Record<string, string>): Response | null;
+/** Read a JSON body, mapping parse failures to a 400 response. */
+export declare function readJsonBody(request: Request, headers: Record<string, string>): Promise<{
+    body: unknown;
+} | {
+    error: Response;
+}>;