geo-sl 1.0.0

package/dist/provinces.cjs

@@ -0,0 +1 @@
+'use strict';var i=[{id:"1",code:"WP",name_en:"Western",name_si:"\u0DB6\u0DC3\u0DCA\u0DB1\u0DCF\u0DC4\u0DD2\u0DBB",name_ta:"\u0BAE\u0BC7\u0BB1\u0BCD\u0B95\u0BC1"},{id:"2",code:"CP",name_en:"Central",name_si:"\u0DB8\u0DB0\u0DCA\u200D\u0DBA\u0DB8",name_ta:"\u0BAE\u0BA4\u0BCD\u0BA4\u0BBF\u0BAF"},{id:"3",code:"SP",name_en:"Southern",name_si:"\u0DAF\u0D9A\u0DD4\u0DAB",name_ta:"\u0BA4\u0BC6\u0BB1\u0BCD\u0B95\u0BC1"},{id:"4",code:"NP",name_en:"Northern",name_si:"\u0D8B\u0DAD\u0DD4\u0DBB",name_ta:"\u0BB5\u0B9F\u0B95\u0BCD\u0B95\u0BC1"},{id:"5",code:"EP",name_en:"Eastern",name_si:"\u0DB1\u0DD0\u0D9C\u0DD9\u0DB1\u0DC4\u0DD2\u0DBB",name_ta:"\u0B95\u0BBF\u0BB4\u0B95\u0BCD\u0B95\u0BC1"},{id:"6",code:"NWP",name_en:"North Western",name_si:"\u0DC0\u0DBA\u0DB9",name_ta:"\u0BB5\u0B9F \u0BAE\u0BC7\u0BB1\u0BCD\u0B95\u0BC1"},{id:"7",code:"NCP",name_en:"North Central",name_si:"\u0D8B\u0DAD\u0DD4\u0DBB\u0DD4 \u0DB8\u0DD0\u0DAF",name_ta:"\u0BB5\u0B9F \u0BAE\u0BA4\u0BCD\u0BA4\u0BBF\u0BAF"},{id:"8",code:"UP",name_en:"Uva",name_si:"\u0D8C\u0DC0",name_ta:"\u0B8A\u0BB5\u0BBE"},{id:"9",code:"SGP",name_en:"Sabaragamuwa",name_si:"\u0DC3\u0DB6\u0DBB\u0D9C\u0DB8\u0DD4\u0DC0",name_ta:"\u0B9A\u0BAA\u0BB0\u0B95\u0BAE\u0BC1\u0BB5"}];var r=Object.freeze(i.map(e=>Object.freeze({id:e.id,code:e.code,name:e.name_en,name_en:e.name_en,name_si:e.name_si,name_ta:e.name_ta}))),_=Object.freeze(r.reduce((e,n)=>(e[n.code]=n,e),{})),t=new Map;for(let e of r)t.set(e.code.toUpperCase(),e),t.set(e.id,e),t.set(e.name_en.toLowerCase(),e);function m(e){if(!e||typeof e!="string")return;let n=e.trim();return t.get(n.toUpperCase())||t.get(n.toLowerCase())||t.get(n)}function P(e,n="en"){let a=m(e);if(a)return n==="si"?a.name_si:n==="ta"?a.name_ta:a.name_en}function u(e,n){let a=m(e);if(!a)return;let o=n?.lang;return !o||o==="en"?a:{...a,name:o==="si"?a.name_si:a.name_ta}}function f(e){let n=typeof e=="string"?e:e?.lang;return !n||n==="en"?r:r.map(a=>({...a,name:n==="si"?a.name_si:a.name_ta}))}exports.PROVINCES=r;exports.PROVINCE_MAP=_;exports.getProvince=m;exports.getProvinceByCode=u;exports.getProvinceName=P;exports.getProvinces=f;

package/dist/provinces.d.cts

@@ -0,0 +1,35 @@
+import { Province, ProvinceCode, QueryOptions, Language } from './types.cjs';
+
+declare const PROVINCES: readonly Province[];
+declare const PROVINCE_MAP: Readonly<Record<ProvinceCode, Province>>;
+/**
+ * Finds a province by code (e.g. 'WP'), ID ('1'), or English name ('Western').
+ *
+ * @param codeOrId - Province code, ID, or name.
+ */
+declare function getProvince(codeOrId: ProvinceCode | string): Province | undefined;
+/**
+ * Returns the localized province name for a given province code or ID.
+ *
+ * @param codeOrId - Province code or ID.
+ * @param lang - Target language ('en' | 'si' | 'ta'). Default is 'en'.
+ *
+ * @example
+ * getProvinceName('WP', 'si') // => "බස්නාහිර"
+ * getProvinceName('WP', 'ta') // => "மேற்கு"
+ */
+declare function getProvinceName(codeOrId: ProvinceCode | string, lang?: Language): string | undefined;
+/**
+ * Alias for getProvince.
+ *
+ * @see getProvince
+ */
+declare function getProvinceByCode(code: string, options?: QueryOptions): Province | undefined;
+/**
+ * Returns all 9 provinces of Sri Lanka.
+ *
+ * @param optionsOrLang - Query options or language code.
+ */
+declare function getProvinces(optionsOrLang?: QueryOptions | Language): readonly Province[] | Province[];
+
+export { PROVINCES, PROVINCE_MAP, getProvince, getProvinceByCode, getProvinceName, getProvinces };

package/dist/provinces.d.ts

@@ -0,0 +1,35 @@
+import { Province, ProvinceCode, QueryOptions, Language } from './types.js';
+
+declare const PROVINCES: readonly Province[];
+declare const PROVINCE_MAP: Readonly<Record<ProvinceCode, Province>>;
+/**
+ * Finds a province by code (e.g. 'WP'), ID ('1'), or English name ('Western').
+ *
+ * @param codeOrId - Province code, ID, or name.
+ */
+declare function getProvince(codeOrId: ProvinceCode | string): Province | undefined;
+/**
+ * Returns the localized province name for a given province code or ID.
+ *
+ * @param codeOrId - Province code or ID.
+ * @param lang - Target language ('en' | 'si' | 'ta'). Default is 'en'.
+ *
+ * @example
+ * getProvinceName('WP', 'si') // => "බස්නාහිර"
+ * getProvinceName('WP', 'ta') // => "மேற்கு"
+ */
+declare function getProvinceName(codeOrId: ProvinceCode | string, lang?: Language): string | undefined;
+/**
+ * Alias for getProvince.
+ *
+ * @see getProvince
+ */
+declare function getProvinceByCode(code: string, options?: QueryOptions): Province | undefined;
+/**
+ * Returns all 9 provinces of Sri Lanka.
+ *
+ * @param optionsOrLang - Query options or language code.
+ */
+declare function getProvinces(optionsOrLang?: QueryOptions | Language): readonly Province[] | Province[];
+
+export { PROVINCES, PROVINCE_MAP, getProvince, getProvinceByCode, getProvinceName, getProvinces };

package/dist/provinces.js

@@ -0,0 +1 @@
+var i=[{id:"1",code:"WP",name_en:"Western",name_si:"\u0DB6\u0DC3\u0DCA\u0DB1\u0DCF\u0DC4\u0DD2\u0DBB",name_ta:"\u0BAE\u0BC7\u0BB1\u0BCD\u0B95\u0BC1"},{id:"2",code:"CP",name_en:"Central",name_si:"\u0DB8\u0DB0\u0DCA\u200D\u0DBA\u0DB8",name_ta:"\u0BAE\u0BA4\u0BCD\u0BA4\u0BBF\u0BAF"},{id:"3",code:"SP",name_en:"Southern",name_si:"\u0DAF\u0D9A\u0DD4\u0DAB",name_ta:"\u0BA4\u0BC6\u0BB1\u0BCD\u0B95\u0BC1"},{id:"4",code:"NP",name_en:"Northern",name_si:"\u0D8B\u0DAD\u0DD4\u0DBB",name_ta:"\u0BB5\u0B9F\u0B95\u0BCD\u0B95\u0BC1"},{id:"5",code:"EP",name_en:"Eastern",name_si:"\u0DB1\u0DD0\u0D9C\u0DD9\u0DB1\u0DC4\u0DD2\u0DBB",name_ta:"\u0B95\u0BBF\u0BB4\u0B95\u0BCD\u0B95\u0BC1"},{id:"6",code:"NWP",name_en:"North Western",name_si:"\u0DC0\u0DBA\u0DB9",name_ta:"\u0BB5\u0B9F \u0BAE\u0BC7\u0BB1\u0BCD\u0B95\u0BC1"},{id:"7",code:"NCP",name_en:"North Central",name_si:"\u0D8B\u0DAD\u0DD4\u0DBB\u0DD4 \u0DB8\u0DD0\u0DAF",name_ta:"\u0BB5\u0B9F \u0BAE\u0BA4\u0BCD\u0BA4\u0BBF\u0BAF"},{id:"8",code:"UP",name_en:"Uva",name_si:"\u0D8C\u0DC0",name_ta:"\u0B8A\u0BB5\u0BBE"},{id:"9",code:"SGP",name_en:"Sabaragamuwa",name_si:"\u0DC3\u0DB6\u0DBB\u0D9C\u0DB8\u0DD4\u0DC0",name_ta:"\u0B9A\u0BAA\u0BB0\u0B95\u0BAE\u0BC1\u0BB5"}];var r=Object.freeze(i.map(e=>Object.freeze({id:e.id,code:e.code,name:e.name_en,name_en:e.name_en,name_si:e.name_si,name_ta:e.name_ta}))),_=Object.freeze(r.reduce((e,n)=>(e[n.code]=n,e),{})),t=new Map;for(let e of r)t.set(e.code.toUpperCase(),e),t.set(e.id,e),t.set(e.name_en.toLowerCase(),e);function m(e){if(!e||typeof e!="string")return;let n=e.trim();return t.get(n.toUpperCase())||t.get(n.toLowerCase())||t.get(n)}function P(e,n="en"){let a=m(e);if(a)return n==="si"?a.name_si:n==="ta"?a.name_ta:a.name_en}function u(e,n){let a=m(e);if(!a)return;let o=n?.lang;return !o||o==="en"?a:{...a,name:o==="si"?a.name_si:a.name_ta}}function f(e){let n=typeof e=="string"?e:e?.lang;return !n||n==="en"?r:r.map(a=>({...a,name:n==="si"?a.name_si:a.name_ta}))}export{r as PROVINCES,_ as PROVINCE_MAP,m as getProvince,u as getProvinceByCode,P as getProvinceName,f as getProvinces};

package/dist/types.cjs

@@ -0,0 +1 @@
+'use strict';function e(i,n){return n==="si"?i.name_si:n==="ta"?i.name_ta:i.name_en}exports.getName=e;

package/dist/types.d.cts

@@ -0,0 +1,102 @@
+type Language = 'en' | 'si' | 'ta';
+type ProvinceCode = 'WP' | 'CP' | 'SP' | 'NP' | 'EP' | 'NWP' | 'NCP' | 'UP' | 'SGP';
+type DistrictAbbreviation = 'CO' | 'GQ' | 'KT' | 'KY' | 'MT' | 'NW' | 'GL' | 'MH' | 'HB' | 'JA' | 'KO' | 'MB' | 'VA' | 'MP' | 'BC' | 'AR' | 'TC' | 'KG' | 'PX' | 'AD' | 'PR' | 'BD' | 'MJ' | 'RN' | 'KE';
+type DistrictCode = DistrictAbbreviation;
+interface TrilingualName {
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+}
+declare function getName(item: TrilingualName, lang?: Language): string;
+interface Province {
+    id: string;
+    code: ProvinceCode;
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+}
+interface District {
+    id: string;
+    code: DistrictAbbreviation;
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    province_id: string;
+    province_code: ProvinceCode;
+    province_name: string;
+}
+interface City {
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    postal_code: string;
+    district: string;
+    district_code: string;
+    district_abbr: DistrictAbbreviation;
+    province: string;
+    province_code: ProvinceCode;
+    is_sub_post_office: boolean;
+    latitude: number | null;
+    longitude: number | null;
+}
+interface Division {
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    district: string;
+    province: string;
+}
+interface GNDivision {
+    code: string;
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    division: string;
+    district: string;
+}
+interface GNSearchOptions extends QueryOptions {
+    limit?: number;
+    division?: string;
+    district?: string;
+}
+interface Branch {
+    id: number;
+    code: string;
+    name: string;
+}
+interface Bank {
+    id: number;
+    code: string;
+    name: string;
+    branches: Branch[];
+}
+interface QueryOptions {
+    lang?: Language;
+}
+interface SearchOptions extends QueryOptions {
+    limit?: number;
+    district?: string;
+    province?: string;
+}
+interface CascadingDistrict {
+    id: string;
+    code: DistrictAbbreviation;
+    name: string;
+    cities: Array<{
+        name: string;
+        postal_code: string;
+        is_sub_post_office: boolean;
+    }>;
+}
+interface CascadingProvince {
+    id: string;
+    code: ProvinceCode;
+    name: string;
+    districts: CascadingDistrict[];
+}
+
+export { type Bank, type Branch, type CascadingDistrict, type CascadingProvince, type City, type District, type DistrictAbbreviation, type DistrictCode, type Division, type GNDivision, type GNSearchOptions, type Language, type Province, type ProvinceCode, type QueryOptions, type SearchOptions, type TrilingualName, getName };

package/dist/types.d.ts

@@ -0,0 +1,102 @@
+type Language = 'en' | 'si' | 'ta';
+type ProvinceCode = 'WP' | 'CP' | 'SP' | 'NP' | 'EP' | 'NWP' | 'NCP' | 'UP' | 'SGP';
+type DistrictAbbreviation = 'CO' | 'GQ' | 'KT' | 'KY' | 'MT' | 'NW' | 'GL' | 'MH' | 'HB' | 'JA' | 'KO' | 'MB' | 'VA' | 'MP' | 'BC' | 'AR' | 'TC' | 'KG' | 'PX' | 'AD' | 'PR' | 'BD' | 'MJ' | 'RN' | 'KE';
+type DistrictCode = DistrictAbbreviation;
+interface TrilingualName {
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+}
+declare function getName(item: TrilingualName, lang?: Language): string;
+interface Province {
+    id: string;
+    code: ProvinceCode;
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+}
+interface District {
+    id: string;
+    code: DistrictAbbreviation;
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    province_id: string;
+    province_code: ProvinceCode;
+    province_name: string;
+}
+interface City {
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    postal_code: string;
+    district: string;
+    district_code: string;
+    district_abbr: DistrictAbbreviation;
+    province: string;
+    province_code: ProvinceCode;
+    is_sub_post_office: boolean;
+    latitude: number | null;
+    longitude: number | null;
+}
+interface Division {
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    district: string;
+    province: string;
+}
+interface GNDivision {
+    code: string;
+    name: string;
+    name_en: string;
+    name_si: string;
+    name_ta: string;
+    division: string;
+    district: string;
+}
+interface GNSearchOptions extends QueryOptions {
+    limit?: number;
+    division?: string;
+    district?: string;
+}
+interface Branch {
+    id: number;
+    code: string;
+    name: string;
+}
+interface Bank {
+    id: number;
+    code: string;
+    name: string;
+    branches: Branch[];
+}
+interface QueryOptions {
+    lang?: Language;
+}
+interface SearchOptions extends QueryOptions {
+    limit?: number;
+    district?: string;
+    province?: string;
+}
+interface CascadingDistrict {
+    id: string;
+    code: DistrictAbbreviation;
+    name: string;
+    cities: Array<{
+        name: string;
+        postal_code: string;
+        is_sub_post_office: boolean;
+    }>;
+}
+interface CascadingProvince {
+    id: string;
+    code: ProvinceCode;
+    name: string;
+    districts: CascadingDistrict[];
+}
+
+export { type Bank, type Branch, type CascadingDistrict, type CascadingProvince, type City, type District, type DistrictAbbreviation, type DistrictCode, type Division, type GNDivision, type GNSearchOptions, type Language, type Province, type ProvinceCode, type QueryOptions, type SearchOptions, type TrilingualName, getName };

package/dist/types.js

@@ -0,0 +1 @@
+function e(i,n){return n==="si"?i.name_si:n==="ta"?i.name_ta:i.name_en}export{e as getName};

package/dist/validators.cjs

@@ -0,0 +1 @@
+'use strict';var m=[31,29,31,30,31,30,31,31,30,31,30,31];function P(e){if(!e||typeof e!="string")return null;let t=e.trim().toUpperCase(),n=/^(\d{2})(\d{3})(\d{4})([VX])$/,i=/^(\d{4})(\d{3})(\d{5})$/,a=0,r=0,o="old",s;if(n.test(t)){o="old";let l=t.match(n);a=1900+parseInt(l[1],10),r=parseInt(l[2],10),s=l[4]==="V";}else if(i.test(t)){o="new";let l=t.match(i);a=parseInt(l[1],10),r=parseInt(l[2],10);}else return null;let p=r>500?"female":"male",u=p==="female"?r-500:r;if(u<1||u>366)return null;let d=u,c=0;for(;c<m.length&&d>m[c];)d-=m[c],c++;let f=c+1,h=d,b=l=>String(l).padStart(2,"0"),N=`${a}-${b(f)}-${b(h)}`,g=new Date,w=g.getFullYear()-a,$=g.getMonth()+1,I=g.getDate();return ($<f||$===f&&I<h)&&w--,{isValid:true,nic:t,format:o,birthYear:a,birthDate:N,gender:p,age:w,...s!==void 0?{canVote:s}:{}}}function M(e){return P(e)!==null}function V(e){let t=P(e);if(!t||t.format!=="old")return null;let n=t.nic.slice(0,9);return `19${n.slice(0,5)}0${n.slice(5,9)}`}var x={70:"Mobitel",71:"Mobitel",72:"Hutch",74:"Dialog",75:"Airtel",76:"Dialog",77:"Dialog",78:"Hutch"},y={11:"Colombo",21:"Jaffna",23:"Mannar",24:"Vavuniya",25:"Anuradhapura",26:"Trincomalee",27:"Polonnaruwa",31:"Negombo",32:"Chilaw",33:"Gampaha",34:"Kalutara",35:"Kegalle",36:"Avissawella",37:"Kurunegala",38:"Panadura",41:"Matara",45:"Ratnapura",47:"Hambantota",51:"Hatton",52:"Nuwara Eliya",54:"Nawalapitiya",55:"Badulla",57:"Bandarawela",63:"Ampara",65:"Batticaloa",66:"Matale",67:"Kalmunai",81:"Kandy",91:"Galle"};function D(e){if(!e||typeof e!="string")return null;let t=e.replace(/[\s\-()]/g,"");if(t.startsWith("+94")?t=t.slice(3):t.startsWith("0094")?t=t.slice(4):t.startsWith("94")?t=t.slice(2):t.startsWith("0")&&(t=t.slice(1)),!/^\d{9}$/.test(t))return null;let n=t.slice(0,2),i=n in x,a=n in y;if(!i&&!a)return null;let r=t.slice(0,2),o=t.slice(2,5),s=t.slice(5);return {isValid:true,raw:e,number:t,type:i?"mobile":"fixed",...i?{operator:x[n]}:{},...a?{area:y[n]}:{},formatted:{international:`+94 ${r} ${o} ${s}`,local:`0${r} ${o} ${s}`,e164:`+94${t}`}}}function A(e){return D(e)!==null}function C(e,t="local"){let n=D(e);return n?n.formatted[t]:null}function R(e){if(!e||typeof e!="string")return  false;let t=e.trim();return /^\d{5}$/.test(t)}exports.convertOldNICToNew=V;exports.formatPhone=C;exports.parseNIC=P;exports.parsePhone=D;exports.validateNIC=M;exports.validatePhone=A;exports.validatePostalCode=R;

package/dist/validators.d.cts

@@ -0,0 +1,78 @@
+interface ParsedNIC {
+    isValid: boolean;
+    nic: string;
+    format: 'old' | 'new';
+    birthYear: number;
+    birthDate: string;
+    gender: 'male' | 'female';
+    age: number;
+    canVote?: boolean;
+}
+interface ParsedPhone {
+    isValid: boolean;
+    raw: string;
+    number: string;
+    type: 'mobile' | 'fixed' | 'unknown';
+    operator?: string;
+    area?: string;
+    formatted: {
+        international: string;
+        local: string;
+        e164: string;
+    };
+}
+/**
+ * Parses a Sri Lankan National Identity Card (NIC) number.
+ * Supports both old (9 digits + V/X) and new (12 digits) formats.
+ *
+ * @param nic - NIC string to parse.
+ * @returns ParsedNIC object with extracted demographic fields, or null if invalid.
+ */
+declare function parseNIC(nic: string): ParsedNIC | null;
+/**
+ * Validates whether the given string is a valid Sri Lankan NIC.
+ *
+ * @param nic - NIC string to validate.
+ */
+declare function validateNIC(nic: string): boolean;
+/**
+ * Converts a 10-character Old NIC format (e.g. '952134567V') to the 12-digit New standard.
+ *
+ * @param oldNic - 10-character NIC string.
+ * @returns 12-digit NIC string, or null if invalid.
+ */
+declare function convertOldNICToNew(oldNic: string): string | null;
+/**
+ * Parses and validates Sri Lankan telephone numbers (mobile and fixed-line).
+ * Supports international (+94), local (07X, 011), and plain 9-digit formats.
+ *
+ * @param phone - Phone number string.
+ * @returns ParsedPhone object or null if invalid.
+ */
+declare function parsePhone(phone: string): ParsedPhone | null;
+/**
+ * Validates whether the given string is a valid Sri Lankan phone number.
+ *
+ * @param phone - Phone number string.
+ */
+declare function validatePhone(phone: string): boolean;
+/**
+ * Formats a Sri Lankan phone number.
+ *
+ * @param phone - Phone number string.
+ * @param style - Format style ('international' | 'local' | 'e164'). Default is 'local'.
+ */
+declare function formatPhone(phone: string, style?: 'international' | 'local' | 'e164'): string | null;
+/**
+ * Validates whether a string matches the Sri Lankan 5-digit postal code format.
+ * To check if a code exists in the official postal database, use `isValidPostalCode()`.
+ *
+ * @param postalCode - Postal code string.
+ *
+ * @example
+ * validatePostalCode('00100') // => true
+ * validatePostalCode('123')   // => false
+ */
+declare function validatePostalCode(postalCode: string): boolean;
+
+export { type ParsedNIC, type ParsedPhone, convertOldNICToNew, formatPhone, parseNIC, parsePhone, validateNIC, validatePhone, validatePostalCode };

package/dist/validators.d.ts

@@ -0,0 +1,78 @@
+interface ParsedNIC {
+    isValid: boolean;
+    nic: string;
+    format: 'old' | 'new';
+    birthYear: number;
+    birthDate: string;
+    gender: 'male' | 'female';
+    age: number;
+    canVote?: boolean;
+}
+interface ParsedPhone {
+    isValid: boolean;
+    raw: string;
+    number: string;
+    type: 'mobile' | 'fixed' | 'unknown';
+    operator?: string;
+    area?: string;
+    formatted: {
+        international: string;
+        local: string;
+        e164: string;
+    };
+}
+/**
+ * Parses a Sri Lankan National Identity Card (NIC) number.
+ * Supports both old (9 digits + V/X) and new (12 digits) formats.
+ *
+ * @param nic - NIC string to parse.
+ * @returns ParsedNIC object with extracted demographic fields, or null if invalid.
+ */
+declare function parseNIC(nic: string): ParsedNIC | null;
+/**
+ * Validates whether the given string is a valid Sri Lankan NIC.
+ *
+ * @param nic - NIC string to validate.
+ */
+declare function validateNIC(nic: string): boolean;
+/**
+ * Converts a 10-character Old NIC format (e.g. '952134567V') to the 12-digit New standard.
+ *
+ * @param oldNic - 10-character NIC string.
+ * @returns 12-digit NIC string, or null if invalid.
+ */
+declare function convertOldNICToNew(oldNic: string): string | null;
+/**
+ * Parses and validates Sri Lankan telephone numbers (mobile and fixed-line).
+ * Supports international (+94), local (07X, 011), and plain 9-digit formats.
+ *
+ * @param phone - Phone number string.
+ * @returns ParsedPhone object or null if invalid.
+ */
+declare function parsePhone(phone: string): ParsedPhone | null;
+/**
+ * Validates whether the given string is a valid Sri Lankan phone number.
+ *
+ * @param phone - Phone number string.
+ */
+declare function validatePhone(phone: string): boolean;
+/**
+ * Formats a Sri Lankan phone number.
+ *
+ * @param phone - Phone number string.
+ * @param style - Format style ('international' | 'local' | 'e164'). Default is 'local'.
+ */
+declare function formatPhone(phone: string, style?: 'international' | 'local' | 'e164'): string | null;
+/**
+ * Validates whether a string matches the Sri Lankan 5-digit postal code format.
+ * To check if a code exists in the official postal database, use `isValidPostalCode()`.
+ *
+ * @param postalCode - Postal code string.
+ *
+ * @example
+ * validatePostalCode('00100') // => true
+ * validatePostalCode('123')   // => false
+ */
+declare function validatePostalCode(postalCode: string): boolean;
+
+export { type ParsedNIC, type ParsedPhone, convertOldNICToNew, formatPhone, parseNIC, parsePhone, validateNIC, validatePhone, validatePostalCode };

package/dist/validators.js

@@ -0,0 +1 @@
+var m=[31,29,31,30,31,30,31,31,30,31,30,31];function P(e){if(!e||typeof e!="string")return null;let t=e.trim().toUpperCase(),n=/^(\d{2})(\d{3})(\d{4})([VX])$/,i=/^(\d{4})(\d{3})(\d{5})$/,a=0,r=0,o="old",s;if(n.test(t)){o="old";let l=t.match(n);a=1900+parseInt(l[1],10),r=parseInt(l[2],10),s=l[4]==="V";}else if(i.test(t)){o="new";let l=t.match(i);a=parseInt(l[1],10),r=parseInt(l[2],10);}else return null;let p=r>500?"female":"male",u=p==="female"?r-500:r;if(u<1||u>366)return null;let d=u,c=0;for(;c<m.length&&d>m[c];)d-=m[c],c++;let f=c+1,h=d,b=l=>String(l).padStart(2,"0"),N=`${a}-${b(f)}-${b(h)}`,g=new Date,w=g.getFullYear()-a,$=g.getMonth()+1,I=g.getDate();return ($<f||$===f&&I<h)&&w--,{isValid:true,nic:t,format:o,birthYear:a,birthDate:N,gender:p,age:w,...s!==void 0?{canVote:s}:{}}}function M(e){return P(e)!==null}function V(e){let t=P(e);if(!t||t.format!=="old")return null;let n=t.nic.slice(0,9);return `19${n.slice(0,5)}0${n.slice(5,9)}`}var x={70:"Mobitel",71:"Mobitel",72:"Hutch",74:"Dialog",75:"Airtel",76:"Dialog",77:"Dialog",78:"Hutch"},y={11:"Colombo",21:"Jaffna",23:"Mannar",24:"Vavuniya",25:"Anuradhapura",26:"Trincomalee",27:"Polonnaruwa",31:"Negombo",32:"Chilaw",33:"Gampaha",34:"Kalutara",35:"Kegalle",36:"Avissawella",37:"Kurunegala",38:"Panadura",41:"Matara",45:"Ratnapura",47:"Hambantota",51:"Hatton",52:"Nuwara Eliya",54:"Nawalapitiya",55:"Badulla",57:"Bandarawela",63:"Ampara",65:"Batticaloa",66:"Matale",67:"Kalmunai",81:"Kandy",91:"Galle"};function D(e){if(!e||typeof e!="string")return null;let t=e.replace(/[\s\-()]/g,"");if(t.startsWith("+94")?t=t.slice(3):t.startsWith("0094")?t=t.slice(4):t.startsWith("94")?t=t.slice(2):t.startsWith("0")&&(t=t.slice(1)),!/^\d{9}$/.test(t))return null;let n=t.slice(0,2),i=n in x,a=n in y;if(!i&&!a)return null;let r=t.slice(0,2),o=t.slice(2,5),s=t.slice(5);return {isValid:true,raw:e,number:t,type:i?"mobile":"fixed",...i?{operator:x[n]}:{},...a?{area:y[n]}:{},formatted:{international:`+94 ${r} ${o} ${s}`,local:`0${r} ${o} ${s}`,e164:`+94${t}`}}}function A(e){return D(e)!==null}function C(e,t="local"){let n=D(e);return n?n.formatted[t]:null}function R(e){if(!e||typeof e!="string")return  false;let t=e.trim();return /^\d{5}$/.test(t)}export{V as convertOldNICToNew,C as formatPhone,P as parseNIC,D as parsePhone,M as validateNIC,A as validatePhone,R as validatePostalCode};

package/package.json

@@ -0,0 +1,149 @@
+{
+  "name": "geo-sl",
+  "version": "1.0.0",
+  "description": "Trilingual (English, සිංහල, தமிழ்) Sri Lanka geographic, postal code, and administrative dataset for TypeScript and JavaScript.",
+  "author": "Mahesh Abeykoon",
+  "license": "MIT",
+  "homepage": "https://github.com/mahesh-abeykoon/sl-geo#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mahesh-abeykoon/sl-geo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mahesh-abeykoon/sl-geo/issues"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./provinces": {
+      "import": {
+        "types": "./dist/provinces.d.ts",
+        "default": "./dist/provinces.js"
+      },
+      "require": {
+        "types": "./dist/provinces.d.cts",
+        "default": "./dist/provinces.cjs"
+      }
+    },
+    "./districts": {
+      "import": {
+        "types": "./dist/districts.d.ts",
+        "default": "./dist/districts.js"
+      },
+      "require": {
+        "types": "./dist/districts.d.cts",
+        "default": "./dist/districts.cjs"
+      }
+    },
+    "./cities": {
+      "import": {
+        "types": "./dist/cities.d.ts",
+        "default": "./dist/cities.js"
+      },
+      "require": {
+        "types": "./dist/cities.d.cts",
+        "default": "./dist/cities.cjs"
+      }
+    },
+    "./divisions": {
+      "import": {
+        "types": "./dist/divisions.d.ts",
+        "default": "./dist/divisions.js"
+      },
+      "require": {
+        "types": "./dist/divisions.d.cts",
+        "default": "./dist/divisions.cjs"
+      }
+    },
+    "./banks": {
+      "import": {
+        "types": "./dist/banks.d.ts",
+        "default": "./dist/banks.js"
+      },
+      "require": {
+        "types": "./dist/banks.d.cts",
+        "default": "./dist/banks.cjs"
+      }
+    },
+    "./validators": {
+      "import": {
+        "types": "./dist/validators.d.ts",
+        "default": "./dist/validators.js"
+      },
+      "require": {
+        "types": "./dist/validators.d.cts",
+        "default": "./dist/validators.cjs"
+      }
+    },
+    "./gn": {
+      "import": {
+        "types": "./dist/gn.d.ts",
+        "default": "./dist/gn.js"
+      },
+      "require": {
+        "types": "./dist/gn.d.cts",
+        "default": "./dist/gn.cjs"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/types.d.ts",
+        "default": "./dist/types.js"
+      },
+      "require": {
+        "types": "./dist/types.d.cts",
+        "default": "./dist/types.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "sri lanka",
+    "postal code",
+    "postcode",
+    "cities",
+    "districts",
+    "provinces",
+    "divisional secretariat",
+    "grama niladhari",
+    "colombo",
+    "sinhala",
+    "tamil",
+    "lankapay",
+    "banks",
+    "address autocomplete",
+    "checkout"
+  ],
+  "scripts": {
+    "build:data": "node scripts/build-datasets.mjs",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "tsup": "^8.0.2",
+    "tsx": "^4.23.13",
+    "typescript": "^5.3.3",
+    "vitest": "^1.3.1"
+  }
+}