india-pincode 1.0.0 → 2.0.0

package/dist/index.d.mts

@@ -1,17 +1,36 @@
+declare enum ErrorCode {
+    INVALID_PINCODE = "INVALID_PINCODE",
+    PINCODE_NOT_FOUND = "PINCODE_NOT_FOUND",
+    STATE_NOT_FOUND = "STATE_NOT_FOUND",
+    DISTRICT_NOT_FOUND = "DISTRICT_NOT_FOUND",
+    INVALID_COORDINATES = "INVALID_COORDINATES",
+    INVALID_INPUT = "INVALID_INPUT",
+    NO_RESULTS = "NO_RESULTS"
+}
+interface ApiError {
+    code: ErrorCode;
+    message: string;
+}
+interface ApiResponse<T> {
+    success: boolean;
+    data: T | null;
+    error?: ApiError;
+}
 interface PostOffice {
     pincode: string;
-    officeName: string;
+    city: string;
     officeType: OfficeType;
     delivery: boolean;
     district: string;
     state: string;
+    country: string;
     circle: string;
     region: string;
     division: string;
     latitude: number | null;
     longitude: number | null;
 }
-type OfficeType = 'BO' | 'PO' | 'HO';
+type OfficeType = 'BO' | 'SO' | 'HO' | 'PO' | 'GPO';
 interface QueryOptions {
     /** Max results to return (default: 100) */
     limit?: number;
@@ -36,21 +55,24 @@ interface PincodeSummary {
     pincode: string;
     district: string;
     state: string;
-    offices: PostOffice[];
-    deliveryOffices: number;
+    country: string;
+    cities: PostOffice[];
+    deliveryCities: number;
     hasCoordinates: boolean;
 }
 interface DistrictSummary {
     district: string;
     state: string;
-    totalOffices: number;
+    country: string;
+    totalCities: number;
     totalPincodes: number;
     pincodes: string[];
 }
 interface StateSummary {
     state: string;
+    country: string;
     totalDistricts: number;
-    totalOffices: number;
+    totalCities: number;
     totalPincodes: number;
     districts: string[];
 }
@@ -61,55 +83,56 @@ interface StateSummary {
  * Architecture:
  * - All indexes are lazy-built on first access, then cached.
  * - Pincode → O(1) HashMap lookup.
- * - State / District / Office → O(1) index lookup.
+ * - State / District / City → O(1) index lookup.
  * - Geo-nearby → Haversine with early bounding-box pruning.
+ * - All responses wrapped in ApiResponse with proper error codes.
  */
 declare class IndiaPincode {
     private _byPincode;
     private _byState;
     private _byDistrict;
-    private _byOffice;
+    private _byCity;
     private indexByPincode;
     private indexByState;
     private indexByDistrict;
-    private indexByOffice;
+    private indexByCity;
     private buildIndex;
     private paginate;
-    /** Get all post offices for a pincode. */
-    getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    /** Get all post offices for a pincode. Returns error for invalid/missing pincodes. */
+    getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get a complete summary for a pincode. */
-    getPincodeSummary(pincode: string): PincodeSummary | null;
+    getPincodeSummary(pincode: string): ApiResponse<PincodeSummary>;
     /** Get all post offices in a state. */
-    getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get a summary for a state — districts, pincode count, etc. */
-    getStateSummary(state: string): StateSummary | null;
+    getStateSummary(state: string): ApiResponse<StateSummary>;
     /** Get all unique state names. */
     getAllStates(): string[];
     /** Get all post offices in a district. */
-    getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get a summary for a district. */
-    getDistrictSummary(district: string): DistrictSummary | null;
+    getDistrictSummary(district: string): ApiResponse<DistrictSummary>;
     /** Get all districts for a state. */
     getDistrictsByState(state: string): string[];
     /** Get all unique district names. */
     getAllDistricts(): string[];
-    /** Get post offices by exact office name (case-insensitive). */
-    getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    /** Get post offices by exact city name (case-insensitive). */
+    getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get all pincodes in a state. */
     getPincodesByState(state: string): string[];
     /** Get all pincodes in a district. */
     getPincodesByDistrict(district: string): string[];
     /**
-     * Search across pincode, office name, district, state.
+     * Search across pincode, city name, district, state.
      * Returns early once limit is reached — no wasted iteration.
      */
-    search(query: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /**
      * Find post offices near a given coordinate.
      * Uses bounding-box pre-filter + Haversine for accuracy.
      * Returns sorted by distance ascending.
      */
-    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): NearbyResult[];
+    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): ApiResponse<NearbyResult[]>;
     /** Total number of post office records loaded. */
     getTotalRecords(): number;
     /** Total number of unique pincodes. */
@@ -121,10 +144,19 @@ declare class IndiaPincode {
 declare function getIndiaPincode(): IndiaPincode;
 
 /**
- * Loads and expands all pincode data.
+ * Loads, validates, sanitizes and deduplicates all pincode data.
  * Cached after first call — subsequent calls return instantly.
+ *
+ * Records that fail validation are silently dropped:
+ * - Missing required fields (pincode, city, district, state)
+ * - Invalid pincode format (must be 6 digits, starting 1–9)
+ * - Out-of-range coordinates
+ * - NaN / undefined / null in required fields
+ * - Duplicate records (same pincode + city + district + officeType)
  */
 declare function loadData(): PostOffice[];
+/** Validates an Indian pincode format. Returns true if valid. */
+declare function isValidPincode(pincode: string): boolean;
 /** Clears all cached data (useful for testing / hot-reload). */
 declare function clearDataCache(): void;
 
@@ -156,23 +188,23 @@ declare class PincodeModule {
 declare class PincodeService {
     private readonly engine;
     constructor();
-    getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    getPincodeSummary(pincode: string): PincodeSummary | null;
-    getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    getStateSummary(state: string): StateSummary | null;
+    getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    getPincodeSummary(pincode: string): ApiResponse<PincodeSummary>;
+    getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    getStateSummary(state: string): ApiResponse<StateSummary>;
     getAllStates(): string[];
-    getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    getDistrictSummary(district: string): DistrictSummary | null;
+    getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    getDistrictSummary(district: string): ApiResponse<DistrictSummary>;
     getDistrictsByState(state: string): string[];
     getAllDistricts(): string[];
-    getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     getPincodesByState(state: string): string[];
     getPincodesByDistrict(district: string): string[];
-    search(query: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): NearbyResult[];
+    search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): ApiResponse<NearbyResult[]>;
     getTotalRecords(): number;
     getTotalPincodes(): number;
     clearCache(): void;
 }
 
-export { type DistrictSummary, IndiaPincode, type NearbyResult, type OfficeType, type PaginatedResult, PincodeModule, PincodeService, type PincodeSummary, type PostOffice, type QueryOptions, type StateSummary, clearDataCache, getIndiaPincode, loadData };
+export { type ApiError, type ApiResponse, type DistrictSummary, ErrorCode, IndiaPincode, type NearbyResult, type OfficeType, type PaginatedResult, PincodeModule, PincodeService, type PincodeSummary, type PostOffice, type QueryOptions, type StateSummary, clearDataCache, getIndiaPincode, isValidPincode, loadData };

package/dist/index.d.ts

@@ -1,17 +1,36 @@
+declare enum ErrorCode {
+    INVALID_PINCODE = "INVALID_PINCODE",
+    PINCODE_NOT_FOUND = "PINCODE_NOT_FOUND",
+    STATE_NOT_FOUND = "STATE_NOT_FOUND",
+    DISTRICT_NOT_FOUND = "DISTRICT_NOT_FOUND",
+    INVALID_COORDINATES = "INVALID_COORDINATES",
+    INVALID_INPUT = "INVALID_INPUT",
+    NO_RESULTS = "NO_RESULTS"
+}
+interface ApiError {
+    code: ErrorCode;
+    message: string;
+}
+interface ApiResponse<T> {
+    success: boolean;
+    data: T | null;
+    error?: ApiError;
+}
 interface PostOffice {
     pincode: string;
-    officeName: string;
+    city: string;
     officeType: OfficeType;
     delivery: boolean;
     district: string;
     state: string;
+    country: string;
     circle: string;
     region: string;
     division: string;
     latitude: number | null;
     longitude: number | null;
 }
-type OfficeType = 'BO' | 'PO' | 'HO';
+type OfficeType = 'BO' | 'SO' | 'HO' | 'PO' | 'GPO';
 interface QueryOptions {
     /** Max results to return (default: 100) */
     limit?: number;
@@ -36,21 +55,24 @@ interface PincodeSummary {
     pincode: string;
     district: string;
     state: string;
-    offices: PostOffice[];
-    deliveryOffices: number;
+    country: string;
+    cities: PostOffice[];
+    deliveryCities: number;
     hasCoordinates: boolean;
 }
 interface DistrictSummary {
     district: string;
     state: string;
-    totalOffices: number;
+    country: string;
+    totalCities: number;
     totalPincodes: number;
     pincodes: string[];
 }
 interface StateSummary {
     state: string;
+    country: string;
     totalDistricts: number;
-    totalOffices: number;
+    totalCities: number;
     totalPincodes: number;
     districts: string[];
 }
@@ -61,55 +83,56 @@ interface StateSummary {
  * Architecture:
  * - All indexes are lazy-built on first access, then cached.
  * - Pincode → O(1) HashMap lookup.
- * - State / District / Office → O(1) index lookup.
+ * - State / District / City → O(1) index lookup.
  * - Geo-nearby → Haversine with early bounding-box pruning.
+ * - All responses wrapped in ApiResponse with proper error codes.
  */
 declare class IndiaPincode {
     private _byPincode;
     private _byState;
     private _byDistrict;
-    private _byOffice;
+    private _byCity;
     private indexByPincode;
     private indexByState;
     private indexByDistrict;
-    private indexByOffice;
+    private indexByCity;
     private buildIndex;
     private paginate;
-    /** Get all post offices for a pincode. */
-    getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    /** Get all post offices for a pincode. Returns error for invalid/missing pincodes. */
+    getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get a complete summary for a pincode. */
-    getPincodeSummary(pincode: string): PincodeSummary | null;
+    getPincodeSummary(pincode: string): ApiResponse<PincodeSummary>;
     /** Get all post offices in a state. */
-    getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get a summary for a state — districts, pincode count, etc. */
-    getStateSummary(state: string): StateSummary | null;
+    getStateSummary(state: string): ApiResponse<StateSummary>;
     /** Get all unique state names. */
     getAllStates(): string[];
     /** Get all post offices in a district. */
-    getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get a summary for a district. */
-    getDistrictSummary(district: string): DistrictSummary | null;
+    getDistrictSummary(district: string): ApiResponse<DistrictSummary>;
     /** Get all districts for a state. */
     getDistrictsByState(state: string): string[];
     /** Get all unique district names. */
     getAllDistricts(): string[];
-    /** Get post offices by exact office name (case-insensitive). */
-    getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    /** Get post offices by exact city name (case-insensitive). */
+    getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /** Get all pincodes in a state. */
     getPincodesByState(state: string): string[];
     /** Get all pincodes in a district. */
     getPincodesByDistrict(district: string): string[];
     /**
-     * Search across pincode, office name, district, state.
+     * Search across pincode, city name, district, state.
      * Returns early once limit is reached — no wasted iteration.
      */
-    search(query: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     /**
      * Find post offices near a given coordinate.
      * Uses bounding-box pre-filter + Haversine for accuracy.
      * Returns sorted by distance ascending.
      */
-    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): NearbyResult[];
+    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): ApiResponse<NearbyResult[]>;
     /** Total number of post office records loaded. */
     getTotalRecords(): number;
     /** Total number of unique pincodes. */
@@ -121,10 +144,19 @@ declare class IndiaPincode {
 declare function getIndiaPincode(): IndiaPincode;
 
 /**
- * Loads and expands all pincode data.
+ * Loads, validates, sanitizes and deduplicates all pincode data.
  * Cached after first call — subsequent calls return instantly.
+ *
+ * Records that fail validation are silently dropped:
+ * - Missing required fields (pincode, city, district, state)
+ * - Invalid pincode format (must be 6 digits, starting 1–9)
+ * - Out-of-range coordinates
+ * - NaN / undefined / null in required fields
+ * - Duplicate records (same pincode + city + district + officeType)
  */
 declare function loadData(): PostOffice[];
+/** Validates an Indian pincode format. Returns true if valid. */
+declare function isValidPincode(pincode: string): boolean;
 /** Clears all cached data (useful for testing / hot-reload). */
 declare function clearDataCache(): void;
 
@@ -156,23 +188,23 @@ declare class PincodeModule {
 declare class PincodeService {
     private readonly engine;
     constructor();
-    getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    getPincodeSummary(pincode: string): PincodeSummary | null;
-    getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    getStateSummary(state: string): StateSummary | null;
+    getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    getPincodeSummary(pincode: string): ApiResponse<PincodeSummary>;
+    getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    getStateSummary(state: string): ApiResponse<StateSummary>;
     getAllStates(): string[];
-    getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    getDistrictSummary(district: string): DistrictSummary | null;
+    getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    getDistrictSummary(district: string): ApiResponse<DistrictSummary>;
     getDistrictsByState(state: string): string[];
     getAllDistricts(): string[];
-    getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice>;
+    getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
     getPincodesByState(state: string): string[];
     getPincodesByDistrict(district: string): string[];
-    search(query: string, options?: QueryOptions): PaginatedResult<PostOffice>;
-    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): NearbyResult[];
+    search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>>;
+    findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): ApiResponse<NearbyResult[]>;
     getTotalRecords(): number;
     getTotalPincodes(): number;
     clearCache(): void;
 }
 
-export { type DistrictSummary, IndiaPincode, type NearbyResult, type OfficeType, type PaginatedResult, PincodeModule, PincodeService, type PincodeSummary, type PostOffice, type QueryOptions, type StateSummary, clearDataCache, getIndiaPincode, loadData };
+export { type ApiError, type ApiResponse, type DistrictSummary, ErrorCode, IndiaPincode, type NearbyResult, type OfficeType, type PaginatedResult, PincodeModule, PincodeService, type PincodeSummary, type PostOffice, type QueryOptions, type StateSummary, clearDataCache, getIndiaPincode, isValidPincode, loadData };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var R=require('fs'),w=require('path'),common=require('@nestjs/common');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var R__namespace=/*#__PURE__*/_interopNamespace(R);var w__namespace=/*#__PURE__*/_interopNamespace(w);var x=(s,e,t,i)=>{for(var n=e,r=s.length-1,o;r>=0;r--)(o=s[r])&&(n=(o(n))||n);return n};var P=null;function _(s){return {pincode:s.p,officeName:s.o,officeType:s.t,delivery:s.d===1,district:s.i!=="NA"?s.i:"",state:s.s!=="NA"?s.s:"",circle:s.c,region:s.r,division:s.v,latitude:s.a!==0?s.a:null,longitude:s.n!==0?s.n:null}}function m(){if(P)return P;let s=w__namespace.resolve(__dirname,"..","data","pincodes.json");return P=JSON.parse(R__namespace.readFileSync(s,"utf-8")).map(_),P}function D(){P=null;}var h=class{constructor(){this._byPincode=null;this._byState=null;this._byDistrict=null;this._byOffice=null;}indexByPincode(){return this._byPincode?this._byPincode:(this._byPincode=this.buildIndex(e=>e.pincode),this._byPincode)}indexByState(){return this._byState?this._byState:(this._byState=this.buildIndex(e=>e.state.toLowerCase()),this._byState)}indexByDistrict(){return this._byDistrict?this._byDistrict:(this._byDistrict=this.buildIndex(e=>e.district.toLowerCase()),this._byDistrict)}indexByOffice(){return this._byOffice?this._byOffice:(this._byOffice=this.buildIndex(e=>e.officeName.toLowerCase()),this._byOffice)}buildIndex(e){let t=m(),i=new Map;for(let n=0;n<t.length;n++){let r=e(t[n]);if(!r)continue;let o=i.get(r);o?o.push(t[n]):i.set(r,[t[n]]);}return i}paginate(e,t){let i=t?.limit??100,n=t?.page??1,r=e;t?.officeType&&(r=r.filter(g=>g.officeType===t.officeType)),t?.deliveryOnly&&(r=r.filter(g=>g.delivery));let o=r.length,u=Math.ceil(o/i),y=(n-1)*i;return {data:r.slice(y,y+i),total:o,page:n,limit:i,totalPages:u}}getByPincode(e,t){let i=this.indexByPincode().get(e)??[];return this.paginate(i,t)}getPincodeSummary(e){let t=this.indexByPincode().get(e);if(!t||t.length===0)return null;let i=t[0];return {pincode:e,district:i.district,state:i.state,offices:t,deliveryOffices:t.filter(n=>n.delivery).length,hasCoordinates:t.some(n=>n.latitude!==null)}}getByState(e,t){let i=this.indexByState().get(e.toLowerCase())??[];return this.paginate(i,t)}getStateSummary(e){let t=this.indexByState().get(e.toLowerCase());if(!t||t.length===0)return null;let i=new Set,n=new Set;for(let r of t)r.district&&i.add(r.district),n.add(r.pincode);return {state:t[0].state,totalDistricts:i.size,totalOffices:t.length,totalPincodes:n.size,districts:Array.from(i).sort()}}getAllStates(){let e=this.indexByState();return Array.from(e.keys()).filter(t=>t.length>0).map(t=>{let i=e.get(t);return i?i[0].state:t}).sort()}getByDistrict(e,t){let i=this.indexByDistrict().get(e.toLowerCase())??[];return this.paginate(i,t)}getDistrictSummary(e){let t=this.indexByDistrict().get(e.toLowerCase());if(!t||t.length===0)return null;let i=new Set;for(let n of t)i.add(n.pincode);return {district:t[0].district,state:t[0].state,totalOffices:t.length,totalPincodes:i.size,pincodes:Array.from(i).sort()}}getDistrictsByState(e){let t=this.indexByState().get(e.toLowerCase())??[],i=new Set;for(let n of t)n.district&&i.add(n.district);return Array.from(i).sort()}getAllDistricts(){let e=this.indexByDistrict();return Array.from(e.keys()).filter(t=>t.length>0).map(t=>{let i=e.get(t);return i?i[0].district:t}).sort()}getByOfficeName(e,t){let i=this.indexByOffice().get(e.toLowerCase())??[];return this.paginate(i,t)}getPincodesByState(e){let t=this.indexByState().get(e.toLowerCase())??[],i=new Set;for(let n of t)i.add(n.pincode);return Array.from(i).sort()}getPincodesByDistrict(e){let t=this.indexByDistrict().get(e.toLowerCase())??[],i=new Set;for(let n of t)i.add(n.pincode);return Array.from(i).sort()}search(e,t){let i=m(),n=e.toLowerCase(),r=t?.limit??100,o=t?.page??1,u=t?.officeType,y=t?.deliveryOnly,l=[],g=o*r+r;for(let a=0;a<i.length&&l.length<g;a++){let c=i[a];u&&c.officeType!==u||y&&!c.delivery||(c.pincode.includes(n)||c.officeName.toLowerCase().includes(n)||c.district.toLowerCase().includes(n)||c.state.toLowerCase().includes(n)||c.circle.toLowerCase().includes(n)||c.region.toLowerCase().includes(n))&&l.push(c);}let b=l.length,p=Math.ceil(b/r),f=(o-1)*r;return {data:l.slice(f,f+r),total:b,page:o,limit:r,totalPages:p}}findNearby(e,t,i=10,n=20){let r=m(),o=i/111,u=i/(111*Math.cos(S(e))),y=e-o,l=e+o,g=t-u,b=t+u,p=[];for(let f=0;f<r.length;f++){let a=r[f];if(a.latitude===null||a.longitude===null||a.latitude<y||a.latitude>l||a.longitude<g||a.longitude>b)continue;let c=L(e,t,a.latitude,a.longitude);c<=i&&p.push({...a,distanceKm:Math.round(c*100)/100});}return p.sort((f,a)=>f.distanceKm-a.distanceKm),p.slice(0,n)}getTotalRecords(){return m().length}getTotalPincodes(){return this.indexByPincode().size}clearCache(){this._byPincode=null,this._byState=null,this._byDistrict=null,this._byOffice=null,D();}};function S(s){return s*(Math.PI/180)}function L(s,e,t,i){let r=S(t-s),o=S(i-e),u=Math.sin(r/2)**2+Math.cos(S(s))*Math.cos(S(t))*Math.sin(o/2)**2;return 6371*2*Math.atan2(Math.sqrt(u),Math.sqrt(1-u))}var B=null;function M(){return B||(B=new h),B}exports.PincodeService=class d{constructor(){this.engine=new h;}getByPincode(e,t){return this.engine.getByPincode(e,t)}getPincodeSummary(e){return this.engine.getPincodeSummary(e)}getByState(e,t){return this.engine.getByState(e,t)}getStateSummary(e){return this.engine.getStateSummary(e)}getAllStates(){return this.engine.getAllStates()}getByDistrict(e,t){return this.engine.getByDistrict(e,t)}getDistrictSummary(e){return this.engine.getDistrictSummary(e)}getDistrictsByState(e){return this.engine.getDistrictsByState(e)}getAllDistricts(){return this.engine.getAllDistricts()}getByOfficeName(e,t){return this.engine.getByOfficeName(e,t)}getPincodesByState(e){return this.engine.getPincodesByState(e)}getPincodesByDistrict(e){return this.engine.getPincodesByDistrict(e)}search(e,t){return this.engine.search(e,t)}findNearby(e,t,i,n){return this.engine.findNearby(e,t,i,n)}getTotalRecords(){return this.engine.getTotalRecords()}getTotalPincodes(){return this.engine.getTotalPincodes()}clearCache(){this.engine.clearCache();}};exports.PincodeService=x([common.Injectable()],exports.PincodeService);exports.PincodeModule=class O{};exports.PincodeModule=x([common.Global(),common.Module({providers:[exports.PincodeService],exports:[exports.PincodeService]})],exports.PincodeModule);exports.IndiaPincode=h;exports.clearDataCache=D;exports.getIndiaPincode=M;exports.loadData=m;//# sourceMappingURL=index.js.map
+'use strict';var v=require('fs'),w=require('path'),common=require('@nestjs/common');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var v__namespace=/*#__PURE__*/_interopNamespace(v);var w__namespace=/*#__PURE__*/_interopNamespace(w);var T=(n,t,e,i)=>{for(var r=t,s=n.length-1,o;s>=0;s--)(o=n[s])&&(r=(o(r))||r);return r};var R=(u=>(u.INVALID_PINCODE="INVALID_PINCODE",u.PINCODE_NOT_FOUND="PINCODE_NOT_FOUND",u.STATE_NOT_FOUND="STATE_NOT_FOUND",u.DISTRICT_NOT_FOUND="DISTRICT_NOT_FOUND",u.INVALID_COORDINATES="INVALID_COORDINATES",u.INVALID_INPUT="INVALID_INPUT",u.NO_RESULTS="NO_RESULTS",u))(R||{});var V="INDIA",U=/^[1-9]\d{5}$/,$=/\s+\(?(?:B\.?O\.?|S\.?O\.?|H\.?O\.?|P\.?O\.?|G\.?P\.?O\.?|M\.?D\.?G\.?|R\.?M\.?S\.?)\)?\s*$/i,S=null;function F(n){return !n||typeof n!="string"?"":n.replace($,"").replace(/\s{2,}/g," ").trim()}function y(n){if(n==null)return "";let t=String(n).trim();return t==="NA"?"":t.replace(/\s{2,}/g," ")}function B(n){if(n==null)return null;let t=Number(n);return !Number.isFinite(t)||t===0?null:t}function Q(n){return n===null||n>=-90&&n<=90}function k(n){return n===null||n>=-180&&n<=180}function q(n){let t=String(n).replace(/\./g,"").toUpperCase().trim();return ["BO","SO","HO","PO","GPO"].includes(t)?t:"BO"}function G(n){let t=y(n.p),e=F(y(n.o)),i=y(n.i),r=y(n.s);if(!t||!e||!i||!r||!U.test(t))return null;let s=B(n.a),o=B(n.n);return !Q(s)||!k(o)?null:{pincode:t,city:e,officeType:q(n.t),delivery:n.d===1,district:i,state:r,country:V,circle:y(n.c),region:y(n.r),division:y(n.v),latitude:s,longitude:o}}function z(n){return `${n.pincode}|${n.city.toLowerCase()}|${n.district.toLowerCase()}|${n.officeType}`}function O(){if(S)return S;let n=w__namespace.resolve(__dirname,"..","data","pincodes.json"),t=JSON.parse(v__namespace.readFileSync(n,"utf-8")),e=new Set,i=[];for(let r=0;r<t.length;r++){let s=G(t[r]);if(!s)continue;let o=z(s);e.has(o)||(e.add(o),i.push(s));}return S=i,S}function _(n){return typeof n=="string"&&U.test(n.trim())}function A(){S=null;}var C="INDIA";function f(n){return {success:true,data:n}}function c(n,t){return {success:false,data:null,error:{code:n,message:t}}}var P=class{constructor(){this._byPincode=null;this._byState=null;this._byDistrict=null;this._byCity=null;}indexByPincode(){return this._byPincode?this._byPincode:(this._byPincode=this.buildIndex(t=>t.pincode),this._byPincode)}indexByState(){return this._byState?this._byState:(this._byState=this.buildIndex(t=>t.state.toLowerCase()),this._byState)}indexByDistrict(){return this._byDistrict?this._byDistrict:(this._byDistrict=this.buildIndex(t=>t.district.toLowerCase()),this._byDistrict)}indexByCity(){return this._byCity?this._byCity:(this._byCity=this.buildIndex(t=>t.city.toLowerCase()),this._byCity)}buildIndex(t){let e=O(),i=new Map;for(let r=0;r<e.length;r++){let s=t(e[r]);if(!s)continue;let o=i.get(s);o?o.push(e[r]):i.set(s,[e[r]]);}return i}paginate(t,e){let i=Math.max(1,e?.limit??100),r=Math.max(1,e?.page??1),s=t;e?.officeType&&(s=s.filter(m=>m.officeType===e.officeType)),e?.deliveryOnly&&(s=s.filter(m=>m.delivery));let o=s.length,u=Math.ceil(o/i),p=(r-1)*i;return {data:s.slice(p,p+i),total:o,page:r,limit:i,totalPages:u}}getByPincode(t,e){if(!t||typeof t!="string")return c("INVALID_INPUT","Pincode is required and must be a string.");let i=t.trim();if(!_(i))return c("INVALID_PINCODE",`Invalid pincode "${i}". Indian pincodes must be exactly 6 digits starting with 1-9.`);let r=this.indexByPincode().get(i);return !r||r.length===0?c("PINCODE_NOT_FOUND",`No data found for pincode "${i}".`):f(this.paginate(r,e))}getPincodeSummary(t){if(!t||typeof t!="string")return c("INVALID_INPUT","Pincode is required and must be a string.");let e=t.trim();if(!_(e))return c("INVALID_PINCODE",`Invalid pincode "${e}". Indian pincodes must be exactly 6 digits starting with 1-9.`);let i=this.indexByPincode().get(e);if(!i||i.length===0)return c("PINCODE_NOT_FOUND",`No data found for pincode "${e}".`);let r=i[0];return f({pincode:e,district:r.district,state:r.state,country:C,cities:i,deliveryCities:i.filter(s=>s.delivery).length,hasCoordinates:i.some(s=>s.latitude!==null)})}getByState(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","State name is required and must be a non-empty string.");let i=this.indexByState().get(t.trim().toLowerCase());return !i||i.length===0?c("STATE_NOT_FOUND",`No data found for state "${t.trim()}".`):f(this.paginate(i,e))}getStateSummary(t){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","State name is required and must be a non-empty string.");let e=this.indexByState().get(t.trim().toLowerCase());if(!e||e.length===0)return c("STATE_NOT_FOUND",`No data found for state "${t.trim()}".`);let i=new Set,r=new Set;for(let s of e)s.district&&i.add(s.district),r.add(s.pincode);return f({state:e[0].state,country:C,totalDistricts:i.size,totalCities:e.length,totalPincodes:r.size,districts:Array.from(i).sort()})}getAllStates(){let t=this.indexByState();return Array.from(t.keys()).filter(e=>e.length>0).map(e=>{let i=t.get(e);return i?i[0].state:e}).sort()}getByDistrict(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","District name is required and must be a non-empty string.");let i=this.indexByDistrict().get(t.trim().toLowerCase());return !i||i.length===0?c("DISTRICT_NOT_FOUND",`No data found for district "${t.trim()}".`):f(this.paginate(i,e))}getDistrictSummary(t){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","District name is required and must be a non-empty string.");let e=this.indexByDistrict().get(t.trim().toLowerCase());if(!e||e.length===0)return c("DISTRICT_NOT_FOUND",`No data found for district "${t.trim()}".`);let i=new Set;for(let r of e)i.add(r.pincode);return f({district:e[0].district,state:e[0].state,country:C,totalCities:e.length,totalPincodes:i.size,pincodes:Array.from(i).sort()})}getDistrictsByState(t){let e=this.indexByState().get(t.toLowerCase())??[],i=new Set;for(let r of e)r.district&&i.add(r.district);return Array.from(i).sort()}getAllDistricts(){let t=this.indexByDistrict();return Array.from(t.keys()).filter(e=>e.length>0).map(e=>{let i=t.get(e);return i?i[0].district:e}).sort()}getByCity(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","City name is required and must be a non-empty string.");let i=this.indexByCity().get(t.trim().toLowerCase());return !i||i.length===0?c("NO_RESULTS",`No data found for city "${t.trim()}".`):f(this.paginate(i,e))}getPincodesByState(t){let e=this.indexByState().get(t.toLowerCase())??[],i=new Set;for(let r of e)i.add(r.pincode);return Array.from(i).sort()}getPincodesByDistrict(t){let e=this.indexByDistrict().get(t.toLowerCase())??[],i=new Set;for(let r of e)i.add(r.pincode);return Array.from(i).sort()}search(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","Search query is required and must be a non-empty string.");let i=O(),r=t.trim().toLowerCase(),s=Math.max(1,e?.limit??100),o=Math.max(1,e?.page??1),u=e?.officeType,p=e?.deliveryOnly,g=[],m=o*s+s;for(let d=0;d<i.length&&g.length<m;d++){let a=i[d];u&&a.officeType!==u||p&&!a.delivery||(a.pincode.includes(r)||a.city.toLowerCase().includes(r)||a.district.toLowerCase().includes(r)||a.state.toLowerCase().includes(r)||a.circle.toLowerCase().includes(r)||a.region.toLowerCase().includes(r))&&g.push(a);}if(g.length===0)return c("NO_RESULTS",`No results found for "${t.trim()}".`);let I=g.length,h=Math.ceil(I/s),b=(o-1)*s;return f({data:g.slice(b,b+s),total:I,page:o,limit:s,totalPages:h})}findNearby(t,e,i=10,r=20){if(typeof t!="number"||typeof e!="number"||!Number.isFinite(t)||!Number.isFinite(e))return c("INVALID_COORDINATES","Latitude and longitude must be valid numbers.");if(t<-90||t>90||e<-180||e>180)return c("INVALID_COORDINATES",`Invalid coordinates (${t}, ${e}). Latitude must be -90 to 90, longitude -180 to 180.`);let s=O(),o=i/111,u=i/(111*Math.cos(N(t))),p=t-o,g=t+o,m=e-u,I=e+u,h=[];for(let d=0;d<s.length;d++){let a=s[d];if(a.latitude===null||a.longitude===null||a.latitude<p||a.latitude>g||a.longitude<m||a.longitude>I)continue;let L=H(t,e,a.latitude,a.longitude);L<=i&&h.push({...a,distanceKm:Math.round(L*100)/100});}h.sort((d,a)=>d.distanceKm-a.distanceKm);let b=h.slice(0,r);return b.length===0?c("NO_RESULTS",`No post offices found within ${i}km of (${t}, ${e}).`):f(b)}getTotalRecords(){return O().length}getTotalPincodes(){return this.indexByPincode().size}clearCache(){this._byPincode=null,this._byState=null,this._byDistrict=null,this._byCity=null,A();}};function N(n){return n*(Math.PI/180)}function H(n,t,e,i){let s=N(e-n),o=N(i-t),u=Math.sin(s/2)**2+Math.cos(N(n))*Math.cos(N(e))*Math.sin(o/2)**2;return 6371*2*Math.atan2(Math.sqrt(u),Math.sqrt(1-u))}var x=null;function X(){return x||(x=new P),x}exports.PincodeService=class l{constructor(){this.engine=new P;}getByPincode(t,e){return this.engine.getByPincode(t,e)}getPincodeSummary(t){return this.engine.getPincodeSummary(t)}getByState(t,e){return this.engine.getByState(t,e)}getStateSummary(t){return this.engine.getStateSummary(t)}getAllStates(){return this.engine.getAllStates()}getByDistrict(t,e){return this.engine.getByDistrict(t,e)}getDistrictSummary(t){return this.engine.getDistrictSummary(t)}getDistrictsByState(t){return this.engine.getDistrictsByState(t)}getAllDistricts(){return this.engine.getAllDistricts()}getByCity(t,e){return this.engine.getByCity(t,e)}getPincodesByState(t){return this.engine.getPincodesByState(t)}getPincodesByDistrict(t){return this.engine.getPincodesByDistrict(t)}search(t,e){return this.engine.search(t,e)}findNearby(t,e,i,r){return this.engine.findNearby(t,e,i,r)}getTotalRecords(){return this.engine.getTotalRecords()}getTotalPincodes(){return this.engine.getTotalPincodes()}clearCache(){this.engine.clearCache();}};exports.PincodeService=T([common.Injectable()],exports.PincodeService);exports.PincodeModule=class D{};exports.PincodeModule=T([common.Global(),common.Module({providers:[exports.PincodeService],exports:[exports.PincodeService]})],exports.PincodeModule);exports.ErrorCode=R;exports.IndiaPincode=P;exports.clearDataCache=A;exports.getIndiaPincode=X;exports.isValidPincode=_;exports.loadData=O;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/data-loader.ts","../src/pincode-lookup.ts","../src/pincode.service.ts","../src/pincode.module.ts"],"names":["cachedData","expand","rec","loadData","dataPath","w","R","clearDataCache","IndiaPincode","o","keyFn","data","index","i","key","arr","records","options","limit","page","filtered","r","total","totalPages","start","pincode","offices","first","state","districtSet","pincodeSet","idx","s","district","set","d","name","query","q","officeType","deliveryOnly","matches","maxScan","lat","lng","radiusKm","dLat","dLng","toRad","minLat","maxLat","minLng","maxLng","results","haversine","a","b","deg","lat1","lon1","lat2","lon2","dLon","_instance","getIndiaPincode","PincodeService","__decorateClass","Injectable","PincodeModule","Global","Module"],"mappings":"6eAAA,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,IAAA,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,MAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,IAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,CAAA,CAAA,OAAA,CAAA,CAAA,CAmBA,IAAIA,CAAAA,CAAkC,IAAA,CAGtC,SAASC,CAAAA,CAAOC,EAAgC,CAC9C,OAAO,CACL,OAAA,CAASA,CAAAA,CAAI,EACb,UAAA,CAAYA,CAAAA,CAAI,CAAA,CAChB,UAAA,CAAYA,EAAI,CAAA,CAChB,QAAA,CAAUA,CAAAA,CAAI,CAAA,GAAM,EACpB,QAAA,CAAUA,CAAAA,CAAI,CAAA,GAAM,IAAA,CAAOA,EAAI,CAAA,CAAI,EAAA,CACnC,MAAOA,CAAAA,CAAI,CAAA,GAAM,KAAOA,CAAAA,CAAI,CAAA,CAAI,EAAA,CAChC,MAAA,CAAQA,EAAI,CAAA,CACZ,MAAA,CAAQA,CAAAA,CAAI,CAAA,CACZ,SAAUA,CAAAA,CAAI,CAAA,CACd,QAAA,CAAUA,CAAAA,CAAI,IAAM,CAAA,CAAIA,CAAAA,CAAI,EAAI,IAAA,CAChC,SAAA,CAAWA,EAAI,CAAA,GAAM,CAAA,CAAIA,CAAAA,CAAI,CAAA,CAAI,IACnC,CACF,CAMO,SAASC,CAAAA,EAAyB,CACvC,GAAIH,CAAAA,CAAY,OAAOA,CAAAA,CAEvB,IAAMI,EAAgBC,YAAA,CAAA,OAAA,CAAQ,SAAA,CAAW,KAAM,MAAA,CAAQ,eAAe,EAEtE,OAAAL,CAAAA,CAD6B,IAAA,CAAK,KAAA,CAASM,0BAAaF,CAAAA,CAAU,OAAO,CAAC,CAAA,CACzD,IAAIH,CAAM,CAAA,CACpBD,CACT,CAGO,SAASO,CAAAA,EAAuB,CACrCP,EAAa,KACf,KClCaQ,CAAAA,CAAN,KAAmB,CAAnB,WAAA,EAAA,CAEL,KAAQ,UAAA,CAA+C,IAAA,CACvD,KAAQ,QAAA,CAA6C,IAAA,CACrD,KAAQ,WAAA,CAAgD,IAAA,CACxD,IAAA,CAAQ,SAAA,CAA8C,MAG9C,cAAA,EAA4C,CAClD,OAAI,IAAA,CAAK,UAAA,CAAmB,KAAK,UAAA,EACjC,IAAA,CAAK,UAAA,CAAa,IAAA,CAAK,WAAYC,CAAAA,EAAMA,CAAAA,CAAE,OAAO,CAAA,CAC3C,KAAK,UAAA,CACd,CAEQ,YAAA,EAA0C,CAChD,OAAI,IAAA,CAAK,QAAA,CAAiB,KAAK,QAAA,EAC/B,IAAA,CAAK,SAAW,IAAA,CAAK,UAAA,CAAYA,CAAAA,EAAMA,CAAAA,CAAE,MAAM,WAAA,EAAa,EACrD,IAAA,CAAK,QAAA,CACd,CAEQ,eAAA,EAA6C,CACnD,OAAI,IAAA,CAAK,YAAoB,IAAA,CAAK,WAAA,EAClC,KAAK,WAAA,CAAc,IAAA,CAAK,WAAYA,CAAAA,EAAMA,CAAAA,CAAE,QAAA,CAAS,WAAA,EAAa,CAAA,CAC3D,IAAA,CAAK,WAAA,CACd,CAEQ,eAA2C,CACjD,OAAI,IAAA,CAAK,SAAA,CAAkB,KAAK,SAAA,EAChC,IAAA,CAAK,UAAY,IAAA,CAAK,UAAA,CAAYA,GAAMA,CAAAA,CAAE,UAAA,CAAW,WAAA,EAAa,EAC3D,IAAA,CAAK,SAAA,CACd,CAEQ,UAAA,CAAWC,EAA6D,CAC9E,IAAMC,CAAAA,CAAOR,CAAAA,GACPS,CAAAA,CAAQ,IAAI,IAClB,IAAA,IAASC,CAAAA,CAAI,EAAGA,CAAAA,CAAIF,CAAAA,CAAK,MAAA,CAAQE,CAAAA,EAAAA,CAAK,CACpC,IAAMC,CAAAA,CAAMJ,CAAAA,CAAMC,CAAAA,CAAKE,CAAC,CAAC,CAAA,CACzB,GAAI,CAACC,EAAK,SACV,IAAMC,EAAMH,CAAAA,CAAM,GAAA,CAAIE,CAAG,CAAA,CACrBC,CAAAA,CAAKA,CAAAA,CAAI,IAAA,CAAKJ,EAAKE,CAAC,CAAC,EACpBD,CAAAA,CAAM,GAAA,CAAIE,EAAK,CAACH,CAAAA,CAAKE,CAAC,CAAC,CAAC,EAC/B,CACA,OAAOD,CACT,CAGQ,SACNI,CAAAA,CACAC,CAAAA,CAC6B,CAC7B,IAAMC,EAAQD,CAAAA,EAAS,KAAA,EAAS,GAAA,CAC1BE,CAAAA,CAAOF,GAAS,IAAA,EAAQ,CAAA,CAC1BG,CAAAA,CAAWJ,CAAAA,CAEXC,GAAS,UAAA,GACXG,CAAAA,CAAWA,EAAS,MAAA,CAAQC,CAAAA,EAAMA,EAAE,UAAA,GAAeJ,CAAAA,CAAQ,UAAU,CAAA,CAAA,CAEnEA,GAAS,YAAA,GACXG,CAAAA,CAAWA,EAAS,MAAA,CAAQC,CAAAA,EAAMA,EAAE,QAAQ,CAAA,CAAA,CAG9C,IAAMC,CAAAA,CAAQF,EAAS,MAAA,CACjBG,CAAAA,CAAa,KAAK,IAAA,CAAKD,CAAAA,CAAQJ,CAAK,CAAA,CACpCM,CAAAA,CAAAA,CAASL,CAAAA,CAAO,CAAA,EAAKD,EAG3B,OAAO,CAAE,IAAA,CAFIE,CAAAA,CAAS,MAAMI,CAAAA,CAAOA,CAAAA,CAAQN,CAAK,CAAA,CAEjC,MAAAI,CAAAA,CAAO,IAAA,CAAAH,EAAM,KAAA,CAAAD,CAAAA,CAAO,WAAAK,CAAW,CAChD,CASA,YAAA,CAAaE,EAAiBR,CAAAA,CAAqD,CACjF,IAAMD,CAAAA,CAAU,IAAA,CAAK,gBAAe,CAAE,GAAA,CAAIS,CAAO,CAAA,EAAK,EAAC,CACvD,OAAO,KAAK,QAAA,CAAST,CAAAA,CAASC,CAAO,CACvC,CAGA,iBAAA,CAAkBQ,CAAAA,CAAwC,CACxD,IAAMC,CAAAA,CAAU,IAAA,CAAK,cAAA,GAAiB,GAAA,CAAID,CAAO,CAAA,CACjD,GAAI,CAACC,CAAAA,EAAWA,CAAAA,CAAQ,SAAW,CAAA,CAAG,OAAO,KAC7C,IAAMC,CAAAA,CAAQD,CAAAA,CAAQ,CAAC,EACvB,OAAO,CACL,OAAA,CAAAD,CAAAA,CACA,SAAUE,CAAAA,CAAM,QAAA,CAChB,KAAA,CAAOA,CAAAA,CAAM,MACb,OAAA,CAAAD,CAAAA,CACA,gBAAiBA,CAAAA,CAAQ,MAAA,CAAQjB,GAAMA,CAAAA,CAAE,QAAQ,CAAA,CAAE,MAAA,CACnD,eAAgBiB,CAAAA,CAAQ,IAAA,CAAMjB,CAAAA,EAAMA,CAAAA,CAAE,WAAa,IAAI,CACzD,CACF,CAKA,WAAWmB,CAAAA,CAAeX,CAAAA,CAAqD,CAC7E,IAAMD,CAAAA,CAAU,KAAK,YAAA,EAAa,CAAE,GAAA,CAAIY,CAAAA,CAAM,aAAa,CAAA,EAAK,EAAC,CACjE,OAAO,KAAK,QAAA,CAASZ,CAAAA,CAASC,CAAO,CACvC,CAGA,eAAA,CAAgBW,CAAAA,CAAoC,CAClD,IAAMZ,CAAAA,CAAU,KAAK,YAAA,EAAa,CAAE,GAAA,CAAIY,CAAAA,CAAM,aAAa,CAAA,CAC3D,GAAI,CAACZ,GAAWA,CAAAA,CAAQ,MAAA,GAAW,CAAA,CAAG,OAAO,KAC7C,IAAMa,CAAAA,CAAc,IAAI,GAAA,CAClBC,CAAAA,CAAa,IAAI,GAAA,CACvB,IAAA,IAAW,CAAA,IAAKd,CAAAA,CACV,EAAE,QAAA,EAAUa,CAAAA,CAAY,IAAI,CAAA,CAAE,QAAQ,EAC1CC,CAAAA,CAAW,GAAA,CAAI,CAAA,CAAE,OAAO,EAE1B,OAAO,CACL,MAAOd,CAAAA,CAAQ,CAAC,EAAE,KAAA,CAClB,cAAA,CAAgBa,CAAAA,CAAY,IAAA,CAC5B,aAAcb,CAAAA,CAAQ,MAAA,CACtB,aAAA,CAAec,CAAAA,CAAW,KAC1B,SAAA,CAAW,KAAA,CAAM,IAAA,CAAKD,CAAW,EAAE,IAAA,EACrC,CACF,CAGA,YAAA,EAAyB,CACvB,IAAME,CAAAA,CAAM,IAAA,CAAK,YAAA,GACjB,OAAO,KAAA,CAAM,KAAKA,CAAAA,CAAI,IAAA,EAAM,CAAA,CACzB,MAAA,CAAQC,CAAAA,EAAMA,CAAAA,CAAE,OAAS,CAAC,CAAA,CAC1B,IAAKA,CAAAA,EAAM,CACV,IAAML,CAAAA,CAAQI,CAAAA,CAAI,GAAA,CAAIC,CAAC,EACvB,OAAOL,CAAAA,CAAQA,CAAAA,CAAM,CAAC,EAAE,KAAA,CAAQK,CAClC,CAAC,CAAA,CACA,MACL,CAKA,cAAcC,CAAAA,CAAkBhB,CAAAA,CAAqD,CACnF,IAAMD,CAAAA,CAAU,IAAA,CAAK,eAAA,GAAkB,GAAA,CAAIiB,CAAAA,CAAS,aAAa,CAAA,EAAK,EAAC,CACvE,OAAO,IAAA,CAAK,QAAA,CAASjB,EAASC,CAAO,CACvC,CAGA,kBAAA,CAAmBgB,CAAAA,CAA0C,CAC3D,IAAMjB,CAAAA,CAAU,IAAA,CAAK,eAAA,GAAkB,GAAA,CAAIiB,CAAAA,CAAS,WAAA,EAAa,EACjE,GAAI,CAACjB,CAAAA,EAAWA,CAAAA,CAAQ,SAAW,CAAA,CAAG,OAAO,KAC7C,IAAMc,CAAAA,CAAa,IAAI,GAAA,CACvB,IAAA,IAAWT,CAAAA,IAAKL,CAAAA,CAASc,EAAW,GAAA,CAAIT,CAAAA,CAAE,OAAO,CAAA,CACjD,OAAO,CACL,QAAA,CAAUL,CAAAA,CAAQ,CAAC,CAAA,CAAE,SACrB,KAAA,CAAOA,CAAAA,CAAQ,CAAC,CAAA,CAAE,KAAA,CAClB,aAAcA,CAAAA,CAAQ,MAAA,CACtB,aAAA,CAAec,CAAAA,CAAW,KAC1B,QAAA,CAAU,KAAA,CAAM,IAAA,CAAKA,CAAU,EAAE,IAAA,EACnC,CACF,CAGA,oBAAoBF,CAAAA,CAAyB,CAC3C,IAAMZ,CAAAA,CAAU,IAAA,CAAK,cAAa,CAAE,GAAA,CAAIY,CAAAA,CAAM,WAAA,EAAa,CAAA,EAAK,GAC1DM,CAAAA,CAAM,IAAI,IAChB,IAAA,IAAWb,CAAAA,IAAKL,CAAAA,CACVK,CAAAA,CAAE,UAAUa,CAAAA,CAAI,GAAA,CAAIb,EAAE,QAAQ,CAAA,CAEpC,OAAO,KAAA,CAAM,IAAA,CAAKa,CAAG,CAAA,CAAE,MACzB,CAGA,eAAA,EAA4B,CAC1B,IAAMH,CAAAA,CAAM,IAAA,CAAK,eAAA,EAAgB,CACjC,OAAO,KAAA,CAAM,IAAA,CAAKA,EAAI,IAAA,EAAM,EACzB,MAAA,CAAQI,CAAAA,EAAMA,CAAAA,CAAE,MAAA,CAAS,CAAC,CAAA,CAC1B,GAAA,CAAKA,GAAM,CACV,IAAMR,EAAQI,CAAAA,CAAI,GAAA,CAAII,CAAC,CAAA,CACvB,OAAOR,CAAAA,CAAQA,CAAAA,CAAM,CAAC,CAAA,CAAE,QAAA,CAAWQ,CACrC,CAAC,CAAA,CACA,IAAA,EACL,CAKA,eAAA,CAAgBC,CAAAA,CAAcnB,CAAAA,CAAqD,CACjF,IAAMD,CAAAA,CAAU,IAAA,CAAK,aAAA,EAAc,CAAE,IAAIoB,CAAAA,CAAK,WAAA,EAAa,CAAA,EAAK,GAChE,OAAO,IAAA,CAAK,QAAA,CAASpB,CAAAA,CAASC,CAAO,CACvC,CAKA,kBAAA,CAAmBW,CAAAA,CAAyB,CAC1C,IAAMZ,CAAAA,CAAU,IAAA,CAAK,YAAA,GAAe,GAAA,CAAIY,CAAAA,CAAM,aAAa,CAAA,EAAK,EAAC,CAC3DM,CAAAA,CAAM,IAAI,GAAA,CAChB,QAAWb,CAAAA,IAAKL,CAAAA,CAASkB,CAAAA,CAAI,GAAA,CAAIb,EAAE,OAAO,CAAA,CAC1C,OAAO,KAAA,CAAM,KAAKa,CAAG,CAAA,CAAE,MACzB,CAGA,sBAAsBD,CAAAA,CAA4B,CAChD,IAAMjB,CAAAA,CAAU,KAAK,eAAA,EAAgB,CAAE,IAAIiB,CAAAA,CAAS,WAAA,EAAa,CAAA,EAAK,EAAC,CACjEC,CAAAA,CAAM,IAAI,GAAA,CAChB,IAAA,IAAWb,KAAKL,CAAAA,CAASkB,CAAAA,CAAI,IAAIb,CAAAA,CAAE,OAAO,CAAA,CAC1C,OAAO,MAAM,IAAA,CAAKa,CAAG,CAAA,CAAE,IAAA,EACzB,CAQA,MAAA,CAAOG,CAAAA,CAAepB,CAAAA,CAAqD,CACzE,IAAMN,CAAAA,CAAOR,GAAS,CAChBmC,CAAAA,CAAID,EAAM,WAAA,EAAY,CACtBnB,CAAAA,CAAQD,CAAAA,EAAS,OAAS,GAAA,CAC1BE,CAAAA,CAAOF,GAAS,IAAA,EAAQ,CAAA,CACxBsB,EAAatB,CAAAA,EAAS,UAAA,CACtBuB,CAAAA,CAAevB,CAAAA,EAAS,aAExBwB,CAAAA,CAAwB,GACxBC,CAAAA,CAAWvB,CAAAA,CAAOD,EAASA,CAAAA,CAEjC,IAAA,IAASL,CAAAA,CAAI,CAAA,CAAGA,EAAIF,CAAAA,CAAK,MAAA,EAAU8B,CAAAA,CAAQ,MAAA,CAASC,EAAS7B,CAAAA,EAAAA,CAAK,CAChE,IAAMQ,CAAAA,CAAIV,EAAKE,CAAC,CAAA,CACZ0B,GAAclB,CAAAA,CAAE,UAAA,GAAekB,GAC/BC,CAAAA,EAAgB,CAACnB,CAAAA,CAAE,QAAA,EAAA,CAGrBA,EAAE,OAAA,CAAQ,QAAA,CAASiB,CAAC,CAAA,EACpBjB,CAAAA,CAAE,WAAW,WAAA,EAAY,CAAE,QAAA,CAASiB,CAAC,GACrCjB,CAAAA,CAAE,QAAA,CAAS,aAAY,CAAE,QAAA,CAASiB,CAAC,CAAA,EACnCjB,CAAAA,CAAE,KAAA,CAAM,WAAA,GAAc,QAAA,CAASiB,CAAC,CAAA,EAChCjB,CAAAA,CAAE,OAAO,WAAA,EAAY,CAAE,QAAA,CAASiB,CAAC,GACjCjB,CAAAA,CAAE,MAAA,CAAO,aAAY,CAAE,QAAA,CAASiB,CAAC,CAAA,GAEjCG,CAAAA,CAAQ,IAAA,CAAKpB,CAAC,EAElB,CAEA,IAAMC,EAAQmB,CAAAA,CAAQ,MAAA,CAChBlB,EAAa,IAAA,CAAK,IAAA,CAAKD,CAAAA,CAAQJ,CAAK,EACpCM,CAAAA,CAAAA,CAASL,CAAAA,CAAO,GAAKD,CAAAA,CAC3B,OAAO,CACL,IAAA,CAAMuB,CAAAA,CAAQ,KAAA,CAAMjB,CAAAA,CAAOA,EAAQN,CAAK,CAAA,CACxC,KAAA,CAAAI,CAAAA,CACA,KAAAH,CAAAA,CACA,KAAA,CAAAD,CAAAA,CACA,UAAA,CAAAK,CACF,CACF,CASA,WACEoB,CAAAA,CACAC,CAAAA,CACAC,EAAW,EAAA,CACX3B,CAAAA,CAAQ,EAAA,CACQ,CAChB,IAAMP,CAAAA,CAAOR,CAAAA,GAEP2C,CAAAA,CAAOD,CAAAA,CAAW,IAClBE,CAAAA,CAAOF,CAAAA,EAAY,GAAA,CAAM,IAAA,CAAK,IAAIG,CAAAA,CAAML,CAAG,CAAC,CAAA,CAAA,CAC5CM,CAAAA,CAASN,EAAMG,CAAAA,CACfI,CAAAA,CAASP,CAAAA,CAAMG,CAAAA,CACfK,EAASP,CAAAA,CAAMG,CAAAA,CACfK,CAAAA,CAASR,CAAAA,CAAMG,EAEfM,CAAAA,CAA0B,EAAC,CAEjC,IAAA,IAASxC,EAAI,CAAA,CAAGA,CAAAA,CAAIF,EAAK,MAAA,CAAQE,CAAAA,EAAAA,CAAK,CACpC,IAAMQ,CAAAA,CAAIV,CAAAA,CAAKE,CAAC,EAIhB,GAHIQ,CAAAA,CAAE,WAAa,IAAA,EAAQA,CAAAA,CAAE,YAAc,IAAA,EAEvCA,CAAAA,CAAE,QAAA,CAAW4B,CAAAA,EAAU5B,EAAE,QAAA,CAAW6B,CAAAA,EACpC7B,EAAE,SAAA,CAAY8B,CAAAA,EAAU9B,EAAE,SAAA,CAAY+B,CAAAA,CAAQ,SAElD,IAAMjB,EAAImB,CAAAA,CAAUX,CAAAA,CAAKC,CAAAA,CAAKvB,CAAAA,CAAE,SAAUA,CAAAA,CAAE,SAAS,CAAA,CACjDc,CAAAA,EAAKU,GACPQ,CAAAA,CAAQ,IAAA,CAAK,CAAE,GAAGhC,CAAAA,CAAG,WAAY,IAAA,CAAK,KAAA,CAAMc,CAAAA,CAAI,GAAG,EAAI,GAAI,CAAC,EAEhE,CAEA,OAAAkB,EAAQ,IAAA,CAAK,CAACE,CAAAA,CAAGC,CAAAA,GAAMD,EAAE,UAAA,CAAaC,CAAAA,CAAE,UAAU,CAAA,CAC3CH,CAAAA,CAAQ,MAAM,CAAA,CAAGnC,CAAK,CAC/B,CAKA,iBAA0B,CACxB,OAAOf,CAAAA,EAAS,CAAE,MACpB,CAGA,gBAAA,EAA2B,CACzB,OAAO,KAAK,cAAA,EAAe,CAAE,IAC/B,CAGA,UAAA,EAAmB,CACjB,IAAA,CAAK,UAAA,CAAa,IAAA,CAClB,IAAA,CAAK,SAAW,IAAA,CAChB,IAAA,CAAK,WAAA,CAAc,IAAA,CACnB,KAAK,SAAA,CAAY,IAAA,CACjBI,CAAAA,GACF,CACF,EAGA,SAASyC,EAAMS,CAAAA,CAAqB,CAClC,OAAOA,CAAAA,EAAO,IAAA,CAAK,EAAA,CAAK,GAAA,CAC1B,CAEA,SAASH,CAAAA,CAAUI,CAAAA,CAAcC,CAAAA,CAAcC,EAAcC,CAAAA,CAAsB,CAEjF,IAAMf,CAAAA,CAAOE,EAAMY,CAAAA,CAAOF,CAAI,EACxBI,CAAAA,CAAOd,CAAAA,CAAMa,EAAOF,CAAI,CAAA,CACxBJ,CAAAA,CACJ,IAAA,CAAK,IAAIT,CAAAA,CAAO,CAAC,GAAK,CAAA,CACtB,IAAA,CAAK,IAAIE,CAAAA,CAAMU,CAAI,CAAC,CAAA,CAAI,KAAK,GAAA,CAAIV,CAAAA,CAAMY,CAAI,CAAC,CAAA,CAAI,KAAK,GAAA,CAAIE,CAAAA,CAAO,CAAC,CAAA,EAAK,EACxE,OAAO,IAAA,CAAI,CAAA,CAAI,IAAA,CAAK,MAAM,IAAA,CAAK,IAAA,CAAKP,CAAC,CAAA,CAAG,KAAK,IAAA,CAAK,CAAA,CAAIA,CAAC,CAAC,CAC1D,CAGA,IAAIQ,CAAAA,CAAiC,IAAA,CAG9B,SAASC,GAAgC,CAC9C,OAAKD,IAAWA,CAAAA,CAAY,IAAIvD,GACzBuD,CACT,CCpVaE,sBAAAA,CAAN,OAAqB,CAG1B,WAAA,EAAc,CACZ,IAAA,CAAK,MAAA,CAAS,IAAIzD,EACpB,CAEA,YAAA,CAAaiB,CAAAA,CAAiBR,EAAqD,CACjF,OAAO,KAAK,MAAA,CAAO,YAAA,CAAaQ,EAASR,CAAO,CAClD,CAEA,iBAAA,CAAkBQ,EAAwC,CACxD,OAAO,KAAK,MAAA,CAAO,iBAAA,CAAkBA,CAAO,CAC9C,CAEA,UAAA,CAAWG,CAAAA,CAAeX,EAAqD,CAC7E,OAAO,KAAK,MAAA,CAAO,UAAA,CAAWW,EAAOX,CAAO,CAC9C,CAEA,eAAA,CAAgBW,EAAoC,CAClD,OAAO,IAAA,CAAK,MAAA,CAAO,gBAAgBA,CAAK,CAC1C,CAEA,YAAA,EAAyB,CACvB,OAAO,IAAA,CAAK,OAAO,YAAA,EACrB,CAEA,aAAA,CAAcK,CAAAA,CAAkBhB,CAAAA,CAAqD,CACnF,OAAO,IAAA,CAAK,MAAA,CAAO,cAAcgB,CAAAA,CAAUhB,CAAO,CACpD,CAEA,kBAAA,CAAmBgB,CAAAA,CAA0C,CAC3D,OAAO,IAAA,CAAK,MAAA,CAAO,mBAAmBA,CAAQ,CAChD,CAEA,mBAAA,CAAoBL,CAAAA,CAAyB,CAC3C,OAAO,KAAK,MAAA,CAAO,mBAAA,CAAoBA,CAAK,CAC9C,CAEA,eAAA,EAA4B,CAC1B,OAAO,IAAA,CAAK,OAAO,eAAA,EACrB,CAEA,eAAA,CAAgBQ,CAAAA,CAAcnB,EAAqD,CACjF,OAAO,IAAA,CAAK,MAAA,CAAO,gBAAgBmB,CAAAA,CAAMnB,CAAO,CAClD,CAEA,kBAAA,CAAmBW,EAAyB,CAC1C,OAAO,IAAA,CAAK,MAAA,CAAO,mBAAmBA,CAAK,CAC7C,CAEA,qBAAA,CAAsBK,CAAAA,CAA4B,CAChD,OAAO,IAAA,CAAK,MAAA,CAAO,qBAAA,CAAsBA,CAAQ,CACnD,CAEA,MAAA,CAAOI,CAAAA,CAAepB,EAAqD,CACzE,OAAO,IAAA,CAAK,MAAA,CAAO,OAAOoB,CAAAA,CAAOpB,CAAO,CAC1C,CAEA,UAAA,CAAW0B,EAAaC,CAAAA,CAAaC,CAAAA,CAAmB3B,CAAAA,CAAgC,CACtF,OAAO,IAAA,CAAK,MAAA,CAAO,WAAWyB,CAAAA,CAAKC,CAAAA,CAAKC,EAAU3B,CAAK,CACzD,CAEA,eAAA,EAA0B,CACxB,OAAO,IAAA,CAAK,OAAO,eAAA,EACrB,CAEA,gBAAA,EAA2B,CACzB,OAAO,IAAA,CAAK,OAAO,gBAAA,EACrB,CAEA,UAAA,EAAmB,CACjB,IAAA,CAAK,MAAA,CAAO,UAAA,GACd,CACF,EA1Ea+C,sBAAAA,CAANC,EAAA,CADNC,iBAAAA,IACYF,sBAAAA,CAAAA,CCSAG,qBAAAA,CAAN,OAAoB,GAAdA,qBAAAA,CAANF,EAAA,CALNG,aAAAA,GACAC,aAAAA,CAAO,CACN,SAAA,CAAW,CAACL,sBAAc,CAAA,CAC1B,OAAA,CAAS,CAACA,sBAAc,CAC1B,CAAC,CAAA,CAAA,CACYG,qBAAAA,CAAAA","file":"index.js","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport { PostOffice } from './types';\n\n/** Compact JSON record shape (short keys for minimal file size) */\ninterface CompactRecord {\n  c: string;  // circlename\n  r: string;  // regionname\n  v: string;  // divisionname\n  o: string;  // officename\n  p: string;  // pincode\n  t: string;  // officetype\n  d: number;  // delivery (1 = yes, 0 = no)\n  i: string;  // district\n  s: string;  // statename\n  a: number;  // latitude (0 = not available)\n  n: number;  // longitude (0 = not available)\n}\n\nlet cachedData: PostOffice[] | null = null;\n\n/** Expand a compact record into a full PostOffice */\nfunction expand(rec: CompactRecord): PostOffice {\n  return {\n    pincode: rec.p,\n    officeName: rec.o,\n    officeType: rec.t as PostOffice['officeType'],\n    delivery: rec.d === 1,\n    district: rec.i !== 'NA' ? rec.i : '',\n    state: rec.s !== 'NA' ? rec.s : '',\n    circle: rec.c,\n    region: rec.r,\n    division: rec.v,\n    latitude: rec.a !== 0 ? rec.a : null,\n    longitude: rec.n !== 0 ? rec.n : null,\n  };\n}\n\n/**\n * Loads and expands all pincode data.\n * Cached after first call — subsequent calls return instantly.\n */\nexport function loadData(): PostOffice[] {\n  if (cachedData) return cachedData;\n\n  const dataPath = path.resolve(__dirname, '..', 'data', 'pincodes.json');\n  const raw: CompactRecord[] = JSON.parse(fs.readFileSync(dataPath, 'utf-8'));\n  cachedData = raw.map(expand);\n  return cachedData;\n}\n\n/** Clears all cached data (useful for testing / hot-reload). */\nexport function clearDataCache(): void {\n  cachedData = null;\n}\n","import {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n} from './types';\nimport { loadData, clearDataCache } from './data-loader';\n\n/**\n * High-performance Indian Pincode lookup engine.\n *\n * Architecture:\n * - All indexes are lazy-built on first access, then cached.\n * - Pincode → O(1) HashMap lookup.\n * - State / District / Office → O(1) index lookup.\n * - Geo-nearby → Haversine with early bounding-box pruning.\n */\nexport class IndiaPincode {\n  // ─── Indexes (lazy) ─────────────────────────────────────────\n  private _byPincode: Map<string, PostOffice[]> | null = null;\n  private _byState: Map<string, PostOffice[]> | null = null;\n  private _byDistrict: Map<string, PostOffice[]> | null = null;\n  private _byOffice: Map<string, PostOffice[]> | null = null;\n\n  // ─── Index builders ─────────────────────────────────────────\n  private indexByPincode(): Map<string, PostOffice[]> {\n    if (this._byPincode) return this._byPincode;\n    this._byPincode = this.buildIndex((o) => o.pincode);\n    return this._byPincode;\n  }\n\n  private indexByState(): Map<string, PostOffice[]> {\n    if (this._byState) return this._byState;\n    this._byState = this.buildIndex((o) => o.state.toLowerCase());\n    return this._byState;\n  }\n\n  private indexByDistrict(): Map<string, PostOffice[]> {\n    if (this._byDistrict) return this._byDistrict;\n    this._byDistrict = this.buildIndex((o) => o.district.toLowerCase());\n    return this._byDistrict;\n  }\n\n  private indexByOffice(): Map<string, PostOffice[]> {\n    if (this._byOffice) return this._byOffice;\n    this._byOffice = this.buildIndex((o) => o.officeName.toLowerCase());\n    return this._byOffice;\n  }\n\n  private buildIndex(keyFn: (o: PostOffice) => string): Map<string, PostOffice[]> {\n    const data = loadData();\n    const index = new Map<string, PostOffice[]>();\n    for (let i = 0; i < data.length; i++) {\n      const key = keyFn(data[i]);\n      if (!key) continue;\n      const arr = index.get(key);\n      if (arr) arr.push(data[i]);\n      else index.set(key, [data[i]]);\n    }\n    return index;\n  }\n\n  // ─── Helper: apply filters + pagination ─────────────────────\n  private paginate(\n    records: PostOffice[],\n    options?: QueryOptions,\n  ): PaginatedResult<PostOffice> {\n    const limit = options?.limit ?? 100;\n    const page = options?.page ?? 1;\n    let filtered = records;\n\n    if (options?.officeType) {\n      filtered = filtered.filter((r) => r.officeType === options.officeType);\n    }\n    if (options?.deliveryOnly) {\n      filtered = filtered.filter((r) => r.delivery);\n    }\n\n    const total = filtered.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    const data = filtered.slice(start, start + limit);\n\n    return { data, total, page, limit, totalPages };\n  }\n\n  // ═══════════════════════════════════════════════════════════════\n  //  PUBLIC API\n  // ═══════════════════════════════════════════════════════════════\n\n  // ─── Pincode lookup (O(1)) ──────────────────────────────────\n\n  /** Get all post offices for a pincode. */\n  getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByPincode().get(pincode) ?? [];\n    return this.paginate(records, options);\n  }\n\n  /** Get a complete summary for a pincode. */\n  getPincodeSummary(pincode: string): PincodeSummary | null {\n    const offices = this.indexByPincode().get(pincode);\n    if (!offices || offices.length === 0) return null;\n    const first = offices[0];\n    return {\n      pincode,\n      district: first.district,\n      state: first.state,\n      offices,\n      deliveryOffices: offices.filter((o) => o.delivery).length,\n      hasCoordinates: offices.some((o) => o.latitude !== null),\n    };\n  }\n\n  // ─── State queries ──────────────────────────────────────────\n\n  /** Get all post offices in a state. */\n  getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    return this.paginate(records, options);\n  }\n\n  /** Get a summary for a state — districts, pincode count, etc. */\n  getStateSummary(state: string): StateSummary | null {\n    const records = this.indexByState().get(state.toLowerCase());\n    if (!records || records.length === 0) return null;\n    const districtSet = new Set<string>();\n    const pincodeSet = new Set<string>();\n    for (const r of records) {\n      if (r.district) districtSet.add(r.district);\n      pincodeSet.add(r.pincode);\n    }\n    return {\n      state: records[0].state,\n      totalDistricts: districtSet.size,\n      totalOffices: records.length,\n      totalPincodes: pincodeSet.size,\n      districts: Array.from(districtSet).sort(),\n    };\n  }\n\n  /** Get all unique state names. */\n  getAllStates(): string[] {\n    const idx = this.indexByState();\n    return Array.from(idx.keys())\n      .filter((s) => s.length > 0)\n      .map((s) => {\n        const first = idx.get(s);\n        return first ? first[0].state : s;\n      })\n      .sort();\n  }\n\n  // ─── District queries ───────────────────────────────────────\n\n  /** Get all post offices in a district. */\n  getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByDistrict().get(district.toLowerCase()) ?? [];\n    return this.paginate(records, options);\n  }\n\n  /** Get a summary for a district. */\n  getDistrictSummary(district: string): DistrictSummary | null {\n    const records = this.indexByDistrict().get(district.toLowerCase());\n    if (!records || records.length === 0) return null;\n    const pincodeSet = new Set<string>();\n    for (const r of records) pincodeSet.add(r.pincode);\n    return {\n      district: records[0].district,\n      state: records[0].state,\n      totalOffices: records.length,\n      totalPincodes: pincodeSet.size,\n      pincodes: Array.from(pincodeSet).sort(),\n    };\n  }\n\n  /** Get all districts for a state. */\n  getDistrictsByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) {\n      if (r.district) set.add(r.district);\n    }\n    return Array.from(set).sort();\n  }\n\n  /** Get all unique district names. */\n  getAllDistricts(): string[] {\n    const idx = this.indexByDistrict();\n    return Array.from(idx.keys())\n      .filter((d) => d.length > 0)\n      .map((d) => {\n        const first = idx.get(d);\n        return first ? first[0].district : d;\n      })\n      .sort();\n  }\n\n  // ─── Office name queries ────────────────────────────────────\n\n  /** Get post offices by exact office name (case-insensitive). */\n  getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByOffice().get(name.toLowerCase()) ?? [];\n    return this.paginate(records, options);\n  }\n\n  // ─── Pincode range queries ──────────────────────────────────\n\n  /** Get all pincodes in a state. */\n  getPincodesByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  /** Get all pincodes in a district. */\n  getPincodesByDistrict(district: string): string[] {\n    const records = this.indexByDistrict().get(district.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  // ─── Free-text search ───────────────────────────────────────\n\n  /**\n   * Search across pincode, office name, district, state.\n   * Returns early once limit is reached — no wasted iteration.\n   */\n  search(query: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const data = loadData();\n    const q = query.toLowerCase();\n    const limit = options?.limit ?? 100;\n    const page = options?.page ?? 1;\n    const officeType = options?.officeType;\n    const deliveryOnly = options?.deliveryOnly;\n\n    const matches: PostOffice[] = [];\n    const maxScan = (page * limit) + limit; // fetch enough for pagination\n\n    for (let i = 0; i < data.length && matches.length < maxScan; i++) {\n      const r = data[i];\n      if (officeType && r.officeType !== officeType) continue;\n      if (deliveryOnly && !r.delivery) continue;\n\n      if (\n        r.pincode.includes(q) ||\n        r.officeName.toLowerCase().includes(q) ||\n        r.district.toLowerCase().includes(q) ||\n        r.state.toLowerCase().includes(q) ||\n        r.circle.toLowerCase().includes(q) ||\n        r.region.toLowerCase().includes(q)\n      ) {\n        matches.push(r);\n      }\n    }\n\n    const total = matches.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    return {\n      data: matches.slice(start, start + limit),\n      total,\n      page,\n      limit,\n      totalPages,\n    };\n  }\n\n  // ─── Geo: nearby search ─────────────────────────────────────\n\n  /**\n   * Find post offices near a given coordinate.\n   * Uses bounding-box pre-filter + Haversine for accuracy.\n   * Returns sorted by distance ascending.\n   */\n  findNearby(\n    lat: number,\n    lng: number,\n    radiusKm = 10,\n    limit = 20,\n  ): NearbyResult[] {\n    const data = loadData();\n    // Bounding-box pre-filter (1 degree ≈ 111 km)\n    const dLat = radiusKm / 111;\n    const dLng = radiusKm / (111 * Math.cos(toRad(lat)));\n    const minLat = lat - dLat;\n    const maxLat = lat + dLat;\n    const minLng = lng - dLng;\n    const maxLng = lng + dLng;\n\n    const results: NearbyResult[] = [];\n\n    for (let i = 0; i < data.length; i++) {\n      const r = data[i];\n      if (r.latitude === null || r.longitude === null) continue;\n      // Bounding box check (cheap)\n      if (r.latitude < minLat || r.latitude > maxLat) continue;\n      if (r.longitude < minLng || r.longitude > maxLng) continue;\n      // Haversine (accurate)\n      const d = haversine(lat, lng, r.latitude, r.longitude);\n      if (d <= radiusKm) {\n        results.push({ ...r, distanceKm: Math.round(d * 100) / 100 });\n      }\n    }\n\n    results.sort((a, b) => a.distanceKm - b.distanceKm);\n    return results.slice(0, limit);\n  }\n\n  // ─── Bulk / utility ─────────────────────────────────────────\n\n  /** Total number of post office records loaded. */\n  getTotalRecords(): number {\n    return loadData().length;\n  }\n\n  /** Total number of unique pincodes. */\n  getTotalPincodes(): number {\n    return this.indexByPincode().size;\n  }\n\n  /** Clear all cached data and indexes — reloads fresh on next call. */\n  clearCache(): void {\n    this._byPincode = null;\n    this._byState = null;\n    this._byDistrict = null;\n    this._byOffice = null;\n    clearDataCache();\n  }\n}\n\n// ─── Haversine helpers ────────────────────────────────────────────\nfunction toRad(deg: number): number {\n  return deg * (Math.PI / 180);\n}\n\nfunction haversine(lat1: number, lon1: number, lat2: number, lon2: number): number {\n  const R = 6371;\n  const dLat = toRad(lat2 - lat1);\n  const dLon = toRad(lon2 - lon1);\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2;\n  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n}\n\n// ─── Singleton ────────────────────────────────────────────────────\nlet _instance: IndiaPincode | null = null;\n\n/** Returns a singleton IndiaPincode instance. */\nexport function getIndiaPincode(): IndiaPincode {\n  if (!_instance) _instance = new IndiaPincode();\n  return _instance;\n}\n","import { Injectable } from '@nestjs/common';\nimport { IndiaPincode } from './pincode-lookup';\nimport {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n} from './types';\n\n/**\n * NestJS Injectable service — wraps IndiaPincode for DI.\n * Import PincodeModule in your AppModule, then inject this anywhere.\n */\n@Injectable()\nexport class PincodeService {\n  private readonly engine: IndiaPincode;\n\n  constructor() {\n    this.engine = new IndiaPincode();\n  }\n\n  getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByPincode(pincode, options);\n  }\n\n  getPincodeSummary(pincode: string): PincodeSummary | null {\n    return this.engine.getPincodeSummary(pincode);\n  }\n\n  getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByState(state, options);\n  }\n\n  getStateSummary(state: string): StateSummary | null {\n    return this.engine.getStateSummary(state);\n  }\n\n  getAllStates(): string[] {\n    return this.engine.getAllStates();\n  }\n\n  getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByDistrict(district, options);\n  }\n\n  getDistrictSummary(district: string): DistrictSummary | null {\n    return this.engine.getDistrictSummary(district);\n  }\n\n  getDistrictsByState(state: string): string[] {\n    return this.engine.getDistrictsByState(state);\n  }\n\n  getAllDistricts(): string[] {\n    return this.engine.getAllDistricts();\n  }\n\n  getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByOfficeName(name, options);\n  }\n\n  getPincodesByState(state: string): string[] {\n    return this.engine.getPincodesByState(state);\n  }\n\n  getPincodesByDistrict(district: string): string[] {\n    return this.engine.getPincodesByDistrict(district);\n  }\n\n  search(query: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.search(query, options);\n  }\n\n  findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): NearbyResult[] {\n    return this.engine.findNearby(lat, lng, radiusKm, limit);\n  }\n\n  getTotalRecords(): number {\n    return this.engine.getTotalRecords();\n  }\n\n  getTotalPincodes(): number {\n    return this.engine.getTotalPincodes();\n  }\n\n  clearCache(): void {\n    this.engine.clearCache();\n  }\n}\n","import { Module, Global } from '@nestjs/common';\nimport { PincodeService } from './pincode.service';\n\n/**\n * NestJS Module for Indian Pincode data.\n *\n * Usage in your NestJS app:\n * ```ts\n * import { PincodeModule } from 'india-pincode';\n *\n * @Module({\n *   imports: [PincodeModule],\n * })\n * export class AppModule {}\n * ```\n *\n * Then inject PincodeService in any controller/service:\n * ```ts\n * constructor(private readonly pincodeService: PincodeService) {}\n * ```\n */\n@Global()\n@Module({\n  providers: [PincodeService],\n  exports: [PincodeService],\n})\nexport class PincodeModule {}\n"]}
+{"version":3,"sources":["../src/types.ts","../src/data-loader.ts","../src/pincode-lookup.ts","../src/pincode.service.ts","../src/pincode.module.ts"],"names":["ErrorCode","COUNTRY","PINCODE_REGEX","OFFICE_SUFFIX_REGEX","cachedData","sanitizeCityName","raw","trimStr","val","s","safeNum","n","isValidLatitude","lat","isValidLongitude","lng","normalizeOfficeType","upper","expand","rec","pincode","city","district","state","latitude","longitude","dedupKey","r","loadData","dataPath","w","v","seen","result","i","record","key","isValidPincode","clearDataCache","ok","data","fail","code","message","IndiaPincode","o","keyFn","index","arr","records","options","limit","page","filtered","total","totalPages","start","trimmed","cities","first","districtSet","pincodeSet","idx","set","d","name","query","q","officeType","deliveryOnly","matches","maxScan","radiusKm","dLat","dLng","toRad","minLat","maxLat","minLng","maxLng","results","haversine","a","b","sliced","deg","lat1","lon1","lat2","lon2","dLon","_instance","getIndiaPincode","PincodeService","__decorateClass","Injectable","PincodeModule","Global","Module"],"mappings":"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","file":"index.js","sourcesContent":["// ─── Error handling ─────────────────────────────────────────────\nexport enum ErrorCode {\n  INVALID_PINCODE = 'INVALID_PINCODE',\n  PINCODE_NOT_FOUND = 'PINCODE_NOT_FOUND',\n  STATE_NOT_FOUND = 'STATE_NOT_FOUND',\n  DISTRICT_NOT_FOUND = 'DISTRICT_NOT_FOUND',\n  INVALID_COORDINATES = 'INVALID_COORDINATES',\n  INVALID_INPUT = 'INVALID_INPUT',\n  NO_RESULTS = 'NO_RESULTS',\n}\n\nexport interface ApiError {\n  code: ErrorCode;\n  message: string;\n}\n\nexport interface ApiResponse<T> {\n  success: boolean;\n  data: T | null;\n  error?: ApiError;\n}\n\n// ─── Normalized public type ─────────────────────────────────────\nexport interface PostOffice {\n  pincode: string;\n  city: string;\n  officeType: OfficeType;\n  delivery: boolean;\n  district: string;\n  state: string;\n  country: string;\n  circle: string;\n  region: string;\n  division: string;\n  latitude: number | null;\n  longitude: number | null;\n}\n\nexport type OfficeType = 'BO' | 'SO' | 'HO' | 'PO' | 'GPO';\n\n// ─── Query options ──────────────────────────────────────────────\nexport interface QueryOptions {\n  /** Max results to return (default: 100) */\n  limit?: number;\n  /** Page number, 1-based (default: 1) */\n  page?: number;\n  /** Filter by office type */\n  officeType?: OfficeType;\n  /** Filter only delivery offices */\n  deliveryOnly?: boolean;\n}\n\n// ─── Paginated result ───────────────────────────────────────────\nexport interface PaginatedResult<T> {\n  data: T[];\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\n// ─── Location result (with distance) ────────────────────────────\nexport interface NearbyResult extends PostOffice {\n  distanceKm: number;\n}\n\n// ─── Summary types ──────────────────────────────────────────────\nexport interface PincodeSummary {\n  pincode: string;\n  district: string;\n  state: string;\n  country: string;\n  cities: PostOffice[];\n  deliveryCities: number;\n  hasCoordinates: boolean;\n}\n\nexport interface DistrictSummary {\n  district: string;\n  state: string;\n  country: string;\n  totalCities: number;\n  totalPincodes: number;\n  pincodes: string[];\n}\n\nexport interface StateSummary {\n  state: string;\n  country: string;\n  totalDistricts: number;\n  totalCities: number;\n  totalPincodes: number;\n  districts: string[];\n}\n","import * as fs from 'fs';\nimport * as path from 'path';\nimport { PostOffice, OfficeType } from './types';\n\nconst COUNTRY = 'INDIA';\nconst PINCODE_REGEX = /^[1-9]\\d{5}$/;\n\n/**\n * Regex to strip office-type suffixes from city names.\n * Handles: B.O, S.O, H.O, P.O, G.P.O, M.D.G, R.M.S and their\n * dot-less variants (BO, SO, HO, PO, GPO, MDG, RMS).\n */\nconst OFFICE_SUFFIX_REGEX =\n  /\\s+\\(?(?:B\\.?O\\.?|S\\.?O\\.?|H\\.?O\\.?|P\\.?O\\.?|G\\.?P\\.?O\\.?|M\\.?D\\.?G\\.?|R\\.?M\\.?S\\.?)\\)?\\s*$/i;\n\n/** Compact JSON record shape (short keys for minimal file size) */\ninterface CompactRecord {\n  c: string;  // circlename\n  r: string;  // regionname\n  v: string;  // divisionname\n  o: string;  // officename\n  p: string;  // pincode\n  t: string;  // officetype\n  d: number;  // delivery (1 = yes, 0 = no)\n  i: string;  // district\n  s: string;  // statename\n  a: number;  // latitude (0 = not available)\n  n: number;  // longitude (0 = not available)\n}\n\nlet cachedData: PostOffice[] | null = null;\n\n// ─── Sanitization helpers ───────────────────────────────────────\n\n/** Strip office-type suffixes (B.O, S.O, H.O, etc.) and trim */\nfunction sanitizeCityName(raw: string): string {\n  if (!raw || typeof raw !== 'string') return '';\n  return raw.replace(OFFICE_SUFFIX_REGEX, '').replace(/\\s{2,}/g, ' ').trim();\n}\n\n/** Trim and collapse extra whitespace */\nfunction trimStr(val: unknown): string {\n  if (val === null || val === undefined) return '';\n  const s = String(val).trim();\n  return s === 'NA' ? '' : s.replace(/\\s{2,}/g, ' ');\n}\n\n/** Parse a numeric field, returning null for invalid / NaN / 0 */\nfunction safeNum(val: unknown): number | null {\n  if (val === null || val === undefined) return null;\n  const n = Number(val);\n  if (!Number.isFinite(n) || n === 0) return null;\n  return n;\n}\n\n/** Validate latitude is within valid range */\nfunction isValidLatitude(lat: number | null): boolean {\n  return lat === null || (lat >= -90 && lat <= 90);\n}\n\n/** Validate longitude is within valid range */\nfunction isValidLongitude(lng: number | null): boolean {\n  return lng === null || (lng >= -180 && lng <= 180);\n}\n\n/** Normalize office type string to valid OfficeType */\nfunction normalizeOfficeType(raw: string): OfficeType {\n  const upper = String(raw).replace(/\\./g, '').toUpperCase().trim();\n  const valid: OfficeType[] = ['BO', 'SO', 'HO', 'PO', 'GPO'];\n  return (valid.includes(upper as OfficeType) ? upper : 'BO') as OfficeType;\n}\n\n// ─── Expand & validate ──────────────────────────────────────────\n\n/** Expand a compact record into a validated PostOffice (or null if invalid) */\nfunction expand(rec: CompactRecord): PostOffice | null {\n  const pincode = trimStr(rec.p);\n  const city = sanitizeCityName(trimStr(rec.o));\n  const district = trimStr(rec.i);\n  const state = trimStr(rec.s);\n\n  // Required field checks\n  if (!pincode || !city || !district || !state) return null;\n\n  // Pincode must be exactly 6 digits starting with 1-9\n  if (!PINCODE_REGEX.test(pincode)) return null;\n\n  const latitude = safeNum(rec.a);\n  const longitude = safeNum(rec.n);\n\n  // Reject out-of-range coordinates\n  if (!isValidLatitude(latitude) || !isValidLongitude(longitude)) return null;\n\n  return {\n    pincode,\n    city,\n    officeType: normalizeOfficeType(rec.t),\n    delivery: rec.d === 1,\n    district,\n    state,\n    country: COUNTRY,\n    circle: trimStr(rec.c),\n    region: trimStr(rec.r),\n    division: trimStr(rec.v),\n    latitude,\n    longitude,\n  };\n}\n\n/** Build a dedup key for a record */\nfunction dedupKey(r: PostOffice): string {\n  return `${r.pincode}|${r.city.toLowerCase()}|${r.district.toLowerCase()}|${r.officeType}`;\n}\n\n/**\n * Loads, validates, sanitizes and deduplicates all pincode data.\n * Cached after first call — subsequent calls return instantly.\n *\n * Records that fail validation are silently dropped:\n * - Missing required fields (pincode, city, district, state)\n * - Invalid pincode format (must be 6 digits, starting 1–9)\n * - Out-of-range coordinates\n * - NaN / undefined / null in required fields\n * - Duplicate records (same pincode + city + district + officeType)\n */\nexport function loadData(): PostOffice[] {\n  if (cachedData) return cachedData;\n\n  const dataPath = path.resolve(__dirname, '..', 'data', 'pincodes.json');\n  const raw: CompactRecord[] = JSON.parse(fs.readFileSync(dataPath, 'utf-8'));\n\n  const seen = new Set<string>();\n  const result: PostOffice[] = [];\n\n  for (let i = 0; i < raw.length; i++) {\n    const record = expand(raw[i]);\n    if (!record) continue;\n\n    const key = dedupKey(record);\n    if (seen.has(key)) continue;\n\n    seen.add(key);\n    result.push(record);\n  }\n\n  cachedData = result;\n  return cachedData;\n}\n\n/** Validates an Indian pincode format. Returns true if valid. */\nexport function isValidPincode(pincode: string): boolean {\n  return typeof pincode === 'string' && PINCODE_REGEX.test(pincode.trim());\n}\n\n/** Clears all cached data (useful for testing / hot-reload). */\nexport function clearDataCache(): void {\n  cachedData = null;\n}\n","import {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n  ApiResponse,\n  ErrorCode,\n} from './types';\nimport { loadData, clearDataCache, isValidPincode } from './data-loader';\n\nconst COUNTRY = 'INDIA';\n\n// ─── Response helpers ─────────────────────────────────────────────\n\nfunction ok<T>(data: T): ApiResponse<T> {\n  return { success: true, data };\n}\n\nfunction fail<T>(code: ErrorCode, message: string): ApiResponse<T> {\n  return { success: false, data: null, error: { code, message } };\n}\n\n/**\n * High-performance Indian Pincode lookup engine.\n *\n * Architecture:\n * - All indexes are lazy-built on first access, then cached.\n * - Pincode → O(1) HashMap lookup.\n * - State / District / City → O(1) index lookup.\n * - Geo-nearby → Haversine with early bounding-box pruning.\n * - All responses wrapped in ApiResponse with proper error codes.\n */\nexport class IndiaPincode {\n  // ─── Indexes (lazy) ─────────────────────────────────────────\n  private _byPincode: Map<string, PostOffice[]> | null = null;\n  private _byState: Map<string, PostOffice[]> | null = null;\n  private _byDistrict: Map<string, PostOffice[]> | null = null;\n  private _byCity: Map<string, PostOffice[]> | null = null;\n\n  // ─── Index builders ─────────────────────────────────────────\n  private indexByPincode(): Map<string, PostOffice[]> {\n    if (this._byPincode) return this._byPincode;\n    this._byPincode = this.buildIndex((o) => o.pincode);\n    return this._byPincode;\n  }\n\n  private indexByState(): Map<string, PostOffice[]> {\n    if (this._byState) return this._byState;\n    this._byState = this.buildIndex((o) => o.state.toLowerCase());\n    return this._byState;\n  }\n\n  private indexByDistrict(): Map<string, PostOffice[]> {\n    if (this._byDistrict) return this._byDistrict;\n    this._byDistrict = this.buildIndex((o) => o.district.toLowerCase());\n    return this._byDistrict;\n  }\n\n  private indexByCity(): Map<string, PostOffice[]> {\n    if (this._byCity) return this._byCity;\n    this._byCity = this.buildIndex((o) => o.city.toLowerCase());\n    return this._byCity;\n  }\n\n  private buildIndex(keyFn: (o: PostOffice) => string): Map<string, PostOffice[]> {\n    const data = loadData();\n    const index = new Map<string, PostOffice[]>();\n    for (let i = 0; i < data.length; i++) {\n      const key = keyFn(data[i]);\n      if (!key) continue;\n      const arr = index.get(key);\n      if (arr) arr.push(data[i]);\n      else index.set(key, [data[i]]);\n    }\n    return index;\n  }\n\n  // ─── Helper: apply filters + pagination ─────────────────────\n  private paginate(\n    records: PostOffice[],\n    options?: QueryOptions,\n  ): PaginatedResult<PostOffice> {\n    const limit = Math.max(1, options?.limit ?? 100);\n    const page = Math.max(1, options?.page ?? 1);\n    let filtered = records;\n\n    if (options?.officeType) {\n      filtered = filtered.filter((r) => r.officeType === options.officeType);\n    }\n    if (options?.deliveryOnly) {\n      filtered = filtered.filter((r) => r.delivery);\n    }\n\n    const total = filtered.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    const data = filtered.slice(start, start + limit);\n\n    return { data, total, page, limit, totalPages };\n  }\n\n  // ═══════════════════════════════════════════════════════════════\n  //  PUBLIC API\n  // ═══════════════════════════════════════════════════════════════\n\n  // ─── Pincode lookup (O(1)) ──────────────────────────────────\n\n  /** Get all post offices for a pincode. Returns error for invalid/missing pincodes. */\n  getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!pincode || typeof pincode !== 'string') {\n      return fail(ErrorCode.INVALID_INPUT, 'Pincode is required and must be a string.');\n    }\n\n    const trimmed = pincode.trim();\n    if (!isValidPincode(trimmed)) {\n      return fail(\n        ErrorCode.INVALID_PINCODE,\n        `Invalid pincode \"${trimmed}\". Indian pincodes must be exactly 6 digits starting with 1-9.`,\n      );\n    }\n\n    const records = this.indexByPincode().get(trimmed);\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.PINCODE_NOT_FOUND, `No data found for pincode \"${trimmed}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  /** Get a complete summary for a pincode. */\n  getPincodeSummary(pincode: string): ApiResponse<PincodeSummary> {\n    if (!pincode || typeof pincode !== 'string') {\n      return fail(ErrorCode.INVALID_INPUT, 'Pincode is required and must be a string.');\n    }\n\n    const trimmed = pincode.trim();\n    if (!isValidPincode(trimmed)) {\n      return fail(\n        ErrorCode.INVALID_PINCODE,\n        `Invalid pincode \"${trimmed}\". Indian pincodes must be exactly 6 digits starting with 1-9.`,\n      );\n    }\n\n    const cities = this.indexByPincode().get(trimmed);\n    if (!cities || cities.length === 0) {\n      return fail(ErrorCode.PINCODE_NOT_FOUND, `No data found for pincode \"${trimmed}\".`);\n    }\n\n    const first = cities[0];\n    return ok({\n      pincode: trimmed,\n      district: first.district,\n      state: first.state,\n      country: COUNTRY,\n      cities,\n      deliveryCities: cities.filter((o) => o.delivery).length,\n      hasCoordinates: cities.some((o) => o.latitude !== null),\n    });\n  }\n\n  // ─── State queries ──────────────────────────────────────────\n\n  /** Get all post offices in a state. */\n  getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!state || typeof state !== 'string' || !state.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'State name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByState().get(state.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.STATE_NOT_FOUND, `No data found for state \"${state.trim()}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  /** Get a summary for a state — districts, pincode count, etc. */\n  getStateSummary(state: string): ApiResponse<StateSummary> {\n    if (!state || typeof state !== 'string' || !state.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'State name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByState().get(state.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.STATE_NOT_FOUND, `No data found for state \"${state.trim()}\".`);\n    }\n\n    const districtSet = new Set<string>();\n    const pincodeSet = new Set<string>();\n    for (const r of records) {\n      if (r.district) districtSet.add(r.district);\n      pincodeSet.add(r.pincode);\n    }\n\n    return ok({\n      state: records[0].state,\n      country: COUNTRY,\n      totalDistricts: districtSet.size,\n      totalCities: records.length,\n      totalPincodes: pincodeSet.size,\n      districts: Array.from(districtSet).sort(),\n    });\n  }\n\n  /** Get all unique state names. */\n  getAllStates(): string[] {\n    const idx = this.indexByState();\n    return Array.from(idx.keys())\n      .filter((s) => s.length > 0)\n      .map((s) => {\n        const first = idx.get(s);\n        return first ? first[0].state : s;\n      })\n      .sort();\n  }\n\n  // ─── District queries ───────────────────────────────────────\n\n  /** Get all post offices in a district. */\n  getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!district || typeof district !== 'string' || !district.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'District name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByDistrict().get(district.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.DISTRICT_NOT_FOUND, `No data found for district \"${district.trim()}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  /** Get a summary for a district. */\n  getDistrictSummary(district: string): ApiResponse<DistrictSummary> {\n    if (!district || typeof district !== 'string' || !district.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'District name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByDistrict().get(district.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.DISTRICT_NOT_FOUND, `No data found for district \"${district.trim()}\".`);\n    }\n\n    const pincodeSet = new Set<string>();\n    for (const r of records) pincodeSet.add(r.pincode);\n\n    return ok({\n      district: records[0].district,\n      state: records[0].state,\n      country: COUNTRY,\n      totalCities: records.length,\n      totalPincodes: pincodeSet.size,\n      pincodes: Array.from(pincodeSet).sort(),\n    });\n  }\n\n  /** Get all districts for a state. */\n  getDistrictsByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) {\n      if (r.district) set.add(r.district);\n    }\n    return Array.from(set).sort();\n  }\n\n  /** Get all unique district names. */\n  getAllDistricts(): string[] {\n    const idx = this.indexByDistrict();\n    return Array.from(idx.keys())\n      .filter((d) => d.length > 0)\n      .map((d) => {\n        const first = idx.get(d);\n        return first ? first[0].district : d;\n      })\n      .sort();\n  }\n\n  // ─── City name queries ───────────────────────────────────────\n\n  /** Get post offices by exact city name (case-insensitive). */\n  getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!name || typeof name !== 'string' || !name.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'City name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByCity().get(name.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.NO_RESULTS, `No data found for city \"${name.trim()}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  // ─── Pincode range queries ──────────────────────────────────\n\n  /** Get all pincodes in a state. */\n  getPincodesByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  /** Get all pincodes in a district. */\n  getPincodesByDistrict(district: string): string[] {\n    const records = this.indexByDistrict().get(district.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  // ─── Free-text search ───────────────────────────────────────\n\n  /**\n   * Search across pincode, city name, district, state.\n   * Returns early once limit is reached — no wasted iteration.\n   */\n  search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!query || typeof query !== 'string' || !query.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'Search query is required and must be a non-empty string.');\n    }\n\n    const data = loadData();\n    const q = query.trim().toLowerCase();\n    const limit = Math.max(1, options?.limit ?? 100);\n    const page = Math.max(1, options?.page ?? 1);\n    const officeType = options?.officeType;\n    const deliveryOnly = options?.deliveryOnly;\n\n    const matches: PostOffice[] = [];\n    const maxScan = (page * limit) + limit; // fetch enough for pagination\n\n    for (let i = 0; i < data.length && matches.length < maxScan; i++) {\n      const r = data[i];\n      if (officeType && r.officeType !== officeType) continue;\n      if (deliveryOnly && !r.delivery) continue;\n\n      if (\n        r.pincode.includes(q) ||\n        r.city.toLowerCase().includes(q) ||\n        r.district.toLowerCase().includes(q) ||\n        r.state.toLowerCase().includes(q) ||\n        r.circle.toLowerCase().includes(q) ||\n        r.region.toLowerCase().includes(q)\n      ) {\n        matches.push(r);\n      }\n    }\n\n    if (matches.length === 0) {\n      return fail(ErrorCode.NO_RESULTS, `No results found for \"${query.trim()}\".`);\n    }\n\n    const total = matches.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n\n    return ok({\n      data: matches.slice(start, start + limit),\n      total,\n      page,\n      limit,\n      totalPages,\n    });\n  }\n\n  // ─── Geo: nearby search ─────────────────────────────────────\n\n  /**\n   * Find post offices near a given coordinate.\n   * Uses bounding-box pre-filter + Haversine for accuracy.\n   * Returns sorted by distance ascending.\n   */\n  findNearby(\n    lat: number,\n    lng: number,\n    radiusKm = 10,\n    limit = 20,\n  ): ApiResponse<NearbyResult[]> {\n    if (typeof lat !== 'number' || typeof lng !== 'number' || !Number.isFinite(lat) || !Number.isFinite(lng)) {\n      return fail(ErrorCode.INVALID_COORDINATES, 'Latitude and longitude must be valid numbers.');\n    }\n    if (lat < -90 || lat > 90 || lng < -180 || lng > 180) {\n      return fail(\n        ErrorCode.INVALID_COORDINATES,\n        `Invalid coordinates (${lat}, ${lng}). Latitude must be -90 to 90, longitude -180 to 180.`,\n      );\n    }\n    const data = loadData();\n    // Bounding-box pre-filter (1 degree ≈ 111 km)\n    const dLat = radiusKm / 111;\n    const dLng = radiusKm / (111 * Math.cos(toRad(lat)));\n    const minLat = lat - dLat;\n    const maxLat = lat + dLat;\n    const minLng = lng - dLng;\n    const maxLng = lng + dLng;\n\n    const results: NearbyResult[] = [];\n\n    for (let i = 0; i < data.length; i++) {\n      const r = data[i];\n      if (r.latitude === null || r.longitude === null) continue;\n      // Bounding box check (cheap)\n      if (r.latitude < minLat || r.latitude > maxLat) continue;\n      if (r.longitude < minLng || r.longitude > maxLng) continue;\n      // Haversine (accurate)\n      const d = haversine(lat, lng, r.latitude, r.longitude);\n      if (d <= radiusKm) {\n        results.push({ ...r, distanceKm: Math.round(d * 100) / 100 });\n      }\n    }\n\n    results.sort((a, b) => a.distanceKm - b.distanceKm);\n    const sliced = results.slice(0, limit);\n\n    if (sliced.length === 0) {\n      return fail(ErrorCode.NO_RESULTS, `No post offices found within ${radiusKm}km of (${lat}, ${lng}).`);\n    }\n\n    return ok(sliced);\n  }\n\n  // ─── Bulk / utility ─────────────────────────────────────────\n\n  /** Total number of post office records loaded. */\n  getTotalRecords(): number {\n    return loadData().length;\n  }\n\n  /** Total number of unique pincodes. */\n  getTotalPincodes(): number {\n    return this.indexByPincode().size;\n  }\n\n  /** Clear all cached data and indexes — reloads fresh on next call. */\n  clearCache(): void {\n    this._byPincode = null;\n    this._byState = null;\n    this._byDistrict = null;\n    this._byCity = null;\n    clearDataCache();\n  }\n}\n\n// ─── Haversine helpers ────────────────────────────────────────────\nfunction toRad(deg: number): number {\n  return deg * (Math.PI / 180);\n}\n\nfunction haversine(lat1: number, lon1: number, lat2: number, lon2: number): number {\n  const R = 6371;\n  const dLat = toRad(lat2 - lat1);\n  const dLon = toRad(lon2 - lon1);\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2;\n  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n}\n\n// ─── Singleton ────────────────────────────────────────────────────\nlet _instance: IndiaPincode | null = null;\n\n/** Returns a singleton IndiaPincode instance. */\nexport function getIndiaPincode(): IndiaPincode {\n  if (!_instance) _instance = new IndiaPincode();\n  return _instance;\n}\n","import { Injectable } from '@nestjs/common';\nimport { IndiaPincode } from './pincode-lookup';\nimport {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n  ApiResponse,\n} from './types';\n\n/**\n * NestJS Injectable service — wraps IndiaPincode for DI.\n * Import PincodeModule in your AppModule, then inject this anywhere.\n */\n@Injectable()\nexport class PincodeService {\n  private readonly engine: IndiaPincode;\n\n  constructor() {\n    this.engine = new IndiaPincode();\n  }\n\n  getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByPincode(pincode, options);\n  }\n\n  getPincodeSummary(pincode: string): ApiResponse<PincodeSummary> {\n    return this.engine.getPincodeSummary(pincode);\n  }\n\n  getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByState(state, options);\n  }\n\n  getStateSummary(state: string): ApiResponse<StateSummary> {\n    return this.engine.getStateSummary(state);\n  }\n\n  getAllStates(): string[] {\n    return this.engine.getAllStates();\n  }\n\n  getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByDistrict(district, options);\n  }\n\n  getDistrictSummary(district: string): ApiResponse<DistrictSummary> {\n    return this.engine.getDistrictSummary(district);\n  }\n\n  getDistrictsByState(state: string): string[] {\n    return this.engine.getDistrictsByState(state);\n  }\n\n  getAllDistricts(): string[] {\n    return this.engine.getAllDistricts();\n  }\n\n  getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByCity(name, options);\n  }\n\n  getPincodesByState(state: string): string[] {\n    return this.engine.getPincodesByState(state);\n  }\n\n  getPincodesByDistrict(district: string): string[] {\n    return this.engine.getPincodesByDistrict(district);\n  }\n\n  search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.search(query, options);\n  }\n\n  findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): ApiResponse<NearbyResult[]> {\n    return this.engine.findNearby(lat, lng, radiusKm, limit);\n  }\n\n  getTotalRecords(): number {\n    return this.engine.getTotalRecords();\n  }\n\n  getTotalPincodes(): number {\n    return this.engine.getTotalPincodes();\n  }\n\n  clearCache(): void {\n    this.engine.clearCache();\n  }\n}\n","import { Module, Global } from '@nestjs/common';\nimport { PincodeService } from './pincode.service';\n\n/**\n * NestJS Module for Indian Pincode data.\n *\n * Usage in your NestJS app:\n * ```ts\n * import { PincodeModule } from 'india-pincode';\n *\n * @Module({\n *   imports: [PincodeModule],\n * })\n * export class AppModule {}\n * ```\n *\n * Then inject PincodeService in any controller/service:\n * ```ts\n * constructor(private readonly pincodeService: PincodeService) {}\n * ```\n */\n@Global()\n@Module({\n  providers: [PincodeService],\n  exports: [PincodeService],\n})\nexport class PincodeModule {}\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import*as R from'fs';import*as w from'path';import {Injectable,Global,Module}from'@nestjs/common';var x=(s,e,t,i)=>{for(var n=e,r=s.length-1,o;r>=0;r--)(o=s[r])&&(n=(o(n))||n);return n};var P=null;function _(s){return {pincode:s.p,officeName:s.o,officeType:s.t,delivery:s.d===1,district:s.i!=="NA"?s.i:"",state:s.s!=="NA"?s.s:"",circle:s.c,region:s.r,division:s.v,latitude:s.a!==0?s.a:null,longitude:s.n!==0?s.n:null}}function m(){if(P)return P;let s=w.resolve(__dirname,"..","data","pincodes.json");return P=JSON.parse(R.readFileSync(s,"utf-8")).map(_),P}function D(){P=null;}var h=class{constructor(){this._byPincode=null;this._byState=null;this._byDistrict=null;this._byOffice=null;}indexByPincode(){return this._byPincode?this._byPincode:(this._byPincode=this.buildIndex(e=>e.pincode),this._byPincode)}indexByState(){return this._byState?this._byState:(this._byState=this.buildIndex(e=>e.state.toLowerCase()),this._byState)}indexByDistrict(){return this._byDistrict?this._byDistrict:(this._byDistrict=this.buildIndex(e=>e.district.toLowerCase()),this._byDistrict)}indexByOffice(){return this._byOffice?this._byOffice:(this._byOffice=this.buildIndex(e=>e.officeName.toLowerCase()),this._byOffice)}buildIndex(e){let t=m(),i=new Map;for(let n=0;n<t.length;n++){let r=e(t[n]);if(!r)continue;let o=i.get(r);o?o.push(t[n]):i.set(r,[t[n]]);}return i}paginate(e,t){let i=t?.limit??100,n=t?.page??1,r=e;t?.officeType&&(r=r.filter(g=>g.officeType===t.officeType)),t?.deliveryOnly&&(r=r.filter(g=>g.delivery));let o=r.length,u=Math.ceil(o/i),y=(n-1)*i;return {data:r.slice(y,y+i),total:o,page:n,limit:i,totalPages:u}}getByPincode(e,t){let i=this.indexByPincode().get(e)??[];return this.paginate(i,t)}getPincodeSummary(e){let t=this.indexByPincode().get(e);if(!t||t.length===0)return null;let i=t[0];return {pincode:e,district:i.district,state:i.state,offices:t,deliveryOffices:t.filter(n=>n.delivery).length,hasCoordinates:t.some(n=>n.latitude!==null)}}getByState(e,t){let i=this.indexByState().get(e.toLowerCase())??[];return this.paginate(i,t)}getStateSummary(e){let t=this.indexByState().get(e.toLowerCase());if(!t||t.length===0)return null;let i=new Set,n=new Set;for(let r of t)r.district&&i.add(r.district),n.add(r.pincode);return {state:t[0].state,totalDistricts:i.size,totalOffices:t.length,totalPincodes:n.size,districts:Array.from(i).sort()}}getAllStates(){let e=this.indexByState();return Array.from(e.keys()).filter(t=>t.length>0).map(t=>{let i=e.get(t);return i?i[0].state:t}).sort()}getByDistrict(e,t){let i=this.indexByDistrict().get(e.toLowerCase())??[];return this.paginate(i,t)}getDistrictSummary(e){let t=this.indexByDistrict().get(e.toLowerCase());if(!t||t.length===0)return null;let i=new Set;for(let n of t)i.add(n.pincode);return {district:t[0].district,state:t[0].state,totalOffices:t.length,totalPincodes:i.size,pincodes:Array.from(i).sort()}}getDistrictsByState(e){let t=this.indexByState().get(e.toLowerCase())??[],i=new Set;for(let n of t)n.district&&i.add(n.district);return Array.from(i).sort()}getAllDistricts(){let e=this.indexByDistrict();return Array.from(e.keys()).filter(t=>t.length>0).map(t=>{let i=e.get(t);return i?i[0].district:t}).sort()}getByOfficeName(e,t){let i=this.indexByOffice().get(e.toLowerCase())??[];return this.paginate(i,t)}getPincodesByState(e){let t=this.indexByState().get(e.toLowerCase())??[],i=new Set;for(let n of t)i.add(n.pincode);return Array.from(i).sort()}getPincodesByDistrict(e){let t=this.indexByDistrict().get(e.toLowerCase())??[],i=new Set;for(let n of t)i.add(n.pincode);return Array.from(i).sort()}search(e,t){let i=m(),n=e.toLowerCase(),r=t?.limit??100,o=t?.page??1,u=t?.officeType,y=t?.deliveryOnly,l=[],g=o*r+r;for(let a=0;a<i.length&&l.length<g;a++){let c=i[a];u&&c.officeType!==u||y&&!c.delivery||(c.pincode.includes(n)||c.officeName.toLowerCase().includes(n)||c.district.toLowerCase().includes(n)||c.state.toLowerCase().includes(n)||c.circle.toLowerCase().includes(n)||c.region.toLowerCase().includes(n))&&l.push(c);}let b=l.length,p=Math.ceil(b/r),f=(o-1)*r;return {data:l.slice(f,f+r),total:b,page:o,limit:r,totalPages:p}}findNearby(e,t,i=10,n=20){let r=m(),o=i/111,u=i/(111*Math.cos(S(e))),y=e-o,l=e+o,g=t-u,b=t+u,p=[];for(let f=0;f<r.length;f++){let a=r[f];if(a.latitude===null||a.longitude===null||a.latitude<y||a.latitude>l||a.longitude<g||a.longitude>b)continue;let c=L(e,t,a.latitude,a.longitude);c<=i&&p.push({...a,distanceKm:Math.round(c*100)/100});}return p.sort((f,a)=>f.distanceKm-a.distanceKm),p.slice(0,n)}getTotalRecords(){return m().length}getTotalPincodes(){return this.indexByPincode().size}clearCache(){this._byPincode=null,this._byState=null,this._byDistrict=null,this._byOffice=null,D();}};function S(s){return s*(Math.PI/180)}function L(s,e,t,i){let r=S(t-s),o=S(i-e),u=Math.sin(r/2)**2+Math.cos(S(s))*Math.cos(S(t))*Math.sin(o/2)**2;return 6371*2*Math.atan2(Math.sqrt(u),Math.sqrt(1-u))}var B=null;function M(){return B||(B=new h),B}var d=class{constructor(){this.engine=new h;}getByPincode(e,t){return this.engine.getByPincode(e,t)}getPincodeSummary(e){return this.engine.getPincodeSummary(e)}getByState(e,t){return this.engine.getByState(e,t)}getStateSummary(e){return this.engine.getStateSummary(e)}getAllStates(){return this.engine.getAllStates()}getByDistrict(e,t){return this.engine.getByDistrict(e,t)}getDistrictSummary(e){return this.engine.getDistrictSummary(e)}getDistrictsByState(e){return this.engine.getDistrictsByState(e)}getAllDistricts(){return this.engine.getAllDistricts()}getByOfficeName(e,t){return this.engine.getByOfficeName(e,t)}getPincodesByState(e){return this.engine.getPincodesByState(e)}getPincodesByDistrict(e){return this.engine.getPincodesByDistrict(e)}search(e,t){return this.engine.search(e,t)}findNearby(e,t,i,n){return this.engine.findNearby(e,t,i,n)}getTotalRecords(){return this.engine.getTotalRecords()}getTotalPincodes(){return this.engine.getTotalPincodes()}clearCache(){this.engine.clearCache();}};d=x([Injectable()],d);var O=class{};O=x([Global(),Module({providers:[d],exports:[d]})],O);export{h as IndiaPincode,O as PincodeModule,d as PincodeService,D as clearDataCache,M as getIndiaPincode,m as loadData};//# sourceMappingURL=index.mjs.map
+import*as v from'fs';import*as w from'path';import {Injectable,Global,Module}from'@nestjs/common';var T=(n,t,e,i)=>{for(var r=t,s=n.length-1,o;s>=0;s--)(o=n[s])&&(r=(o(r))||r);return r};var R=(u=>(u.INVALID_PINCODE="INVALID_PINCODE",u.PINCODE_NOT_FOUND="PINCODE_NOT_FOUND",u.STATE_NOT_FOUND="STATE_NOT_FOUND",u.DISTRICT_NOT_FOUND="DISTRICT_NOT_FOUND",u.INVALID_COORDINATES="INVALID_COORDINATES",u.INVALID_INPUT="INVALID_INPUT",u.NO_RESULTS="NO_RESULTS",u))(R||{});var V="INDIA",U=/^[1-9]\d{5}$/,$=/\s+\(?(?:B\.?O\.?|S\.?O\.?|H\.?O\.?|P\.?O\.?|G\.?P\.?O\.?|M\.?D\.?G\.?|R\.?M\.?S\.?)\)?\s*$/i,S=null;function F(n){return !n||typeof n!="string"?"":n.replace($,"").replace(/\s{2,}/g," ").trim()}function y(n){if(n==null)return "";let t=String(n).trim();return t==="NA"?"":t.replace(/\s{2,}/g," ")}function B(n){if(n==null)return null;let t=Number(n);return !Number.isFinite(t)||t===0?null:t}function Q(n){return n===null||n>=-90&&n<=90}function k(n){return n===null||n>=-180&&n<=180}function q(n){let t=String(n).replace(/\./g,"").toUpperCase().trim();return ["BO","SO","HO","PO","GPO"].includes(t)?t:"BO"}function G(n){let t=y(n.p),e=F(y(n.o)),i=y(n.i),r=y(n.s);if(!t||!e||!i||!r||!U.test(t))return null;let s=B(n.a),o=B(n.n);return !Q(s)||!k(o)?null:{pincode:t,city:e,officeType:q(n.t),delivery:n.d===1,district:i,state:r,country:V,circle:y(n.c),region:y(n.r),division:y(n.v),latitude:s,longitude:o}}function z(n){return `${n.pincode}|${n.city.toLowerCase()}|${n.district.toLowerCase()}|${n.officeType}`}function O(){if(S)return S;let n=w.resolve(__dirname,"..","data","pincodes.json"),t=JSON.parse(v.readFileSync(n,"utf-8")),e=new Set,i=[];for(let r=0;r<t.length;r++){let s=G(t[r]);if(!s)continue;let o=z(s);e.has(o)||(e.add(o),i.push(s));}return S=i,S}function _(n){return typeof n=="string"&&U.test(n.trim())}function A(){S=null;}var C="INDIA";function f(n){return {success:true,data:n}}function c(n,t){return {success:false,data:null,error:{code:n,message:t}}}var P=class{constructor(){this._byPincode=null;this._byState=null;this._byDistrict=null;this._byCity=null;}indexByPincode(){return this._byPincode?this._byPincode:(this._byPincode=this.buildIndex(t=>t.pincode),this._byPincode)}indexByState(){return this._byState?this._byState:(this._byState=this.buildIndex(t=>t.state.toLowerCase()),this._byState)}indexByDistrict(){return this._byDistrict?this._byDistrict:(this._byDistrict=this.buildIndex(t=>t.district.toLowerCase()),this._byDistrict)}indexByCity(){return this._byCity?this._byCity:(this._byCity=this.buildIndex(t=>t.city.toLowerCase()),this._byCity)}buildIndex(t){let e=O(),i=new Map;for(let r=0;r<e.length;r++){let s=t(e[r]);if(!s)continue;let o=i.get(s);o?o.push(e[r]):i.set(s,[e[r]]);}return i}paginate(t,e){let i=Math.max(1,e?.limit??100),r=Math.max(1,e?.page??1),s=t;e?.officeType&&(s=s.filter(m=>m.officeType===e.officeType)),e?.deliveryOnly&&(s=s.filter(m=>m.delivery));let o=s.length,u=Math.ceil(o/i),p=(r-1)*i;return {data:s.slice(p,p+i),total:o,page:r,limit:i,totalPages:u}}getByPincode(t,e){if(!t||typeof t!="string")return c("INVALID_INPUT","Pincode is required and must be a string.");let i=t.trim();if(!_(i))return c("INVALID_PINCODE",`Invalid pincode "${i}". Indian pincodes must be exactly 6 digits starting with 1-9.`);let r=this.indexByPincode().get(i);return !r||r.length===0?c("PINCODE_NOT_FOUND",`No data found for pincode "${i}".`):f(this.paginate(r,e))}getPincodeSummary(t){if(!t||typeof t!="string")return c("INVALID_INPUT","Pincode is required and must be a string.");let e=t.trim();if(!_(e))return c("INVALID_PINCODE",`Invalid pincode "${e}". Indian pincodes must be exactly 6 digits starting with 1-9.`);let i=this.indexByPincode().get(e);if(!i||i.length===0)return c("PINCODE_NOT_FOUND",`No data found for pincode "${e}".`);let r=i[0];return f({pincode:e,district:r.district,state:r.state,country:C,cities:i,deliveryCities:i.filter(s=>s.delivery).length,hasCoordinates:i.some(s=>s.latitude!==null)})}getByState(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","State name is required and must be a non-empty string.");let i=this.indexByState().get(t.trim().toLowerCase());return !i||i.length===0?c("STATE_NOT_FOUND",`No data found for state "${t.trim()}".`):f(this.paginate(i,e))}getStateSummary(t){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","State name is required and must be a non-empty string.");let e=this.indexByState().get(t.trim().toLowerCase());if(!e||e.length===0)return c("STATE_NOT_FOUND",`No data found for state "${t.trim()}".`);let i=new Set,r=new Set;for(let s of e)s.district&&i.add(s.district),r.add(s.pincode);return f({state:e[0].state,country:C,totalDistricts:i.size,totalCities:e.length,totalPincodes:r.size,districts:Array.from(i).sort()})}getAllStates(){let t=this.indexByState();return Array.from(t.keys()).filter(e=>e.length>0).map(e=>{let i=t.get(e);return i?i[0].state:e}).sort()}getByDistrict(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","District name is required and must be a non-empty string.");let i=this.indexByDistrict().get(t.trim().toLowerCase());return !i||i.length===0?c("DISTRICT_NOT_FOUND",`No data found for district "${t.trim()}".`):f(this.paginate(i,e))}getDistrictSummary(t){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","District name is required and must be a non-empty string.");let e=this.indexByDistrict().get(t.trim().toLowerCase());if(!e||e.length===0)return c("DISTRICT_NOT_FOUND",`No data found for district "${t.trim()}".`);let i=new Set;for(let r of e)i.add(r.pincode);return f({district:e[0].district,state:e[0].state,country:C,totalCities:e.length,totalPincodes:i.size,pincodes:Array.from(i).sort()})}getDistrictsByState(t){let e=this.indexByState().get(t.toLowerCase())??[],i=new Set;for(let r of e)r.district&&i.add(r.district);return Array.from(i).sort()}getAllDistricts(){let t=this.indexByDistrict();return Array.from(t.keys()).filter(e=>e.length>0).map(e=>{let i=t.get(e);return i?i[0].district:e}).sort()}getByCity(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","City name is required and must be a non-empty string.");let i=this.indexByCity().get(t.trim().toLowerCase());return !i||i.length===0?c("NO_RESULTS",`No data found for city "${t.trim()}".`):f(this.paginate(i,e))}getPincodesByState(t){let e=this.indexByState().get(t.toLowerCase())??[],i=new Set;for(let r of e)i.add(r.pincode);return Array.from(i).sort()}getPincodesByDistrict(t){let e=this.indexByDistrict().get(t.toLowerCase())??[],i=new Set;for(let r of e)i.add(r.pincode);return Array.from(i).sort()}search(t,e){if(!t||typeof t!="string"||!t.trim())return c("INVALID_INPUT","Search query is required and must be a non-empty string.");let i=O(),r=t.trim().toLowerCase(),s=Math.max(1,e?.limit??100),o=Math.max(1,e?.page??1),u=e?.officeType,p=e?.deliveryOnly,g=[],m=o*s+s;for(let d=0;d<i.length&&g.length<m;d++){let a=i[d];u&&a.officeType!==u||p&&!a.delivery||(a.pincode.includes(r)||a.city.toLowerCase().includes(r)||a.district.toLowerCase().includes(r)||a.state.toLowerCase().includes(r)||a.circle.toLowerCase().includes(r)||a.region.toLowerCase().includes(r))&&g.push(a);}if(g.length===0)return c("NO_RESULTS",`No results found for "${t.trim()}".`);let I=g.length,h=Math.ceil(I/s),b=(o-1)*s;return f({data:g.slice(b,b+s),total:I,page:o,limit:s,totalPages:h})}findNearby(t,e,i=10,r=20){if(typeof t!="number"||typeof e!="number"||!Number.isFinite(t)||!Number.isFinite(e))return c("INVALID_COORDINATES","Latitude and longitude must be valid numbers.");if(t<-90||t>90||e<-180||e>180)return c("INVALID_COORDINATES",`Invalid coordinates (${t}, ${e}). Latitude must be -90 to 90, longitude -180 to 180.`);let s=O(),o=i/111,u=i/(111*Math.cos(N(t))),p=t-o,g=t+o,m=e-u,I=e+u,h=[];for(let d=0;d<s.length;d++){let a=s[d];if(a.latitude===null||a.longitude===null||a.latitude<p||a.latitude>g||a.longitude<m||a.longitude>I)continue;let L=H(t,e,a.latitude,a.longitude);L<=i&&h.push({...a,distanceKm:Math.round(L*100)/100});}h.sort((d,a)=>d.distanceKm-a.distanceKm);let b=h.slice(0,r);return b.length===0?c("NO_RESULTS",`No post offices found within ${i}km of (${t}, ${e}).`):f(b)}getTotalRecords(){return O().length}getTotalPincodes(){return this.indexByPincode().size}clearCache(){this._byPincode=null,this._byState=null,this._byDistrict=null,this._byCity=null,A();}};function N(n){return n*(Math.PI/180)}function H(n,t,e,i){let s=N(e-n),o=N(i-t),u=Math.sin(s/2)**2+Math.cos(N(n))*Math.cos(N(e))*Math.sin(o/2)**2;return 6371*2*Math.atan2(Math.sqrt(u),Math.sqrt(1-u))}var x=null;function X(){return x||(x=new P),x}var l=class{constructor(){this.engine=new P;}getByPincode(t,e){return this.engine.getByPincode(t,e)}getPincodeSummary(t){return this.engine.getPincodeSummary(t)}getByState(t,e){return this.engine.getByState(t,e)}getStateSummary(t){return this.engine.getStateSummary(t)}getAllStates(){return this.engine.getAllStates()}getByDistrict(t,e){return this.engine.getByDistrict(t,e)}getDistrictSummary(t){return this.engine.getDistrictSummary(t)}getDistrictsByState(t){return this.engine.getDistrictsByState(t)}getAllDistricts(){return this.engine.getAllDistricts()}getByCity(t,e){return this.engine.getByCity(t,e)}getPincodesByState(t){return this.engine.getPincodesByState(t)}getPincodesByDistrict(t){return this.engine.getPincodesByDistrict(t)}search(t,e){return this.engine.search(t,e)}findNearby(t,e,i,r){return this.engine.findNearby(t,e,i,r)}getTotalRecords(){return this.engine.getTotalRecords()}getTotalPincodes(){return this.engine.getTotalPincodes()}clearCache(){this.engine.clearCache();}};l=T([Injectable()],l);var D=class{};D=T([Global(),Module({providers:[l],exports:[l]})],D);export{R as ErrorCode,P as IndiaPincode,D as PincodeModule,l as PincodeService,A as clearDataCache,X as getIndiaPincode,_ as isValidPincode,O as loadData};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/data-loader.ts","../src/pincode-lookup.ts","../src/pincode.service.ts","../src/pincode.module.ts"],"names":["cachedData","expand","rec","loadData","dataPath","clearDataCache","IndiaPincode","o","keyFn","data","index","i","key","arr","records","options","limit","page","filtered","r","total","totalPages","start","pincode","offices","first","state","districtSet","pincodeSet","idx","s","district","set","d","name","query","q","officeType","deliveryOnly","matches","maxScan","lat","lng","radiusKm","dLat","dLng","toRad","minLat","maxLat","minLng","maxLng","results","haversine","a","b","deg","lat1","lon1","lat2","lon2","dLon","_instance","getIndiaPincode","PincodeService","__decorateClass","Injectable","PincodeModule","Global","Module"],"mappings":"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","file":"index.mjs","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport { PostOffice } from './types';\n\n/** Compact JSON record shape (short keys for minimal file size) */\ninterface CompactRecord {\n  c: string;  // circlename\n  r: string;  // regionname\n  v: string;  // divisionname\n  o: string;  // officename\n  p: string;  // pincode\n  t: string;  // officetype\n  d: number;  // delivery (1 = yes, 0 = no)\n  i: string;  // district\n  s: string;  // statename\n  a: number;  // latitude (0 = not available)\n  n: number;  // longitude (0 = not available)\n}\n\nlet cachedData: PostOffice[] | null = null;\n\n/** Expand a compact record into a full PostOffice */\nfunction expand(rec: CompactRecord): PostOffice {\n  return {\n    pincode: rec.p,\n    officeName: rec.o,\n    officeType: rec.t as PostOffice['officeType'],\n    delivery: rec.d === 1,\n    district: rec.i !== 'NA' ? rec.i : '',\n    state: rec.s !== 'NA' ? rec.s : '',\n    circle: rec.c,\n    region: rec.r,\n    division: rec.v,\n    latitude: rec.a !== 0 ? rec.a : null,\n    longitude: rec.n !== 0 ? rec.n : null,\n  };\n}\n\n/**\n * Loads and expands all pincode data.\n * Cached after first call — subsequent calls return instantly.\n */\nexport function loadData(): PostOffice[] {\n  if (cachedData) return cachedData;\n\n  const dataPath = path.resolve(__dirname, '..', 'data', 'pincodes.json');\n  const raw: CompactRecord[] = JSON.parse(fs.readFileSync(dataPath, 'utf-8'));\n  cachedData = raw.map(expand);\n  return cachedData;\n}\n\n/** Clears all cached data (useful for testing / hot-reload). */\nexport function clearDataCache(): void {\n  cachedData = null;\n}\n","import {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n} from './types';\nimport { loadData, clearDataCache } from './data-loader';\n\n/**\n * High-performance Indian Pincode lookup engine.\n *\n * Architecture:\n * - All indexes are lazy-built on first access, then cached.\n * - Pincode → O(1) HashMap lookup.\n * - State / District / Office → O(1) index lookup.\n * - Geo-nearby → Haversine with early bounding-box pruning.\n */\nexport class IndiaPincode {\n  // ─── Indexes (lazy) ─────────────────────────────────────────\n  private _byPincode: Map<string, PostOffice[]> | null = null;\n  private _byState: Map<string, PostOffice[]> | null = null;\n  private _byDistrict: Map<string, PostOffice[]> | null = null;\n  private _byOffice: Map<string, PostOffice[]> | null = null;\n\n  // ─── Index builders ─────────────────────────────────────────\n  private indexByPincode(): Map<string, PostOffice[]> {\n    if (this._byPincode) return this._byPincode;\n    this._byPincode = this.buildIndex((o) => o.pincode);\n    return this._byPincode;\n  }\n\n  private indexByState(): Map<string, PostOffice[]> {\n    if (this._byState) return this._byState;\n    this._byState = this.buildIndex((o) => o.state.toLowerCase());\n    return this._byState;\n  }\n\n  private indexByDistrict(): Map<string, PostOffice[]> {\n    if (this._byDistrict) return this._byDistrict;\n    this._byDistrict = this.buildIndex((o) => o.district.toLowerCase());\n    return this._byDistrict;\n  }\n\n  private indexByOffice(): Map<string, PostOffice[]> {\n    if (this._byOffice) return this._byOffice;\n    this._byOffice = this.buildIndex((o) => o.officeName.toLowerCase());\n    return this._byOffice;\n  }\n\n  private buildIndex(keyFn: (o: PostOffice) => string): Map<string, PostOffice[]> {\n    const data = loadData();\n    const index = new Map<string, PostOffice[]>();\n    for (let i = 0; i < data.length; i++) {\n      const key = keyFn(data[i]);\n      if (!key) continue;\n      const arr = index.get(key);\n      if (arr) arr.push(data[i]);\n      else index.set(key, [data[i]]);\n    }\n    return index;\n  }\n\n  // ─── Helper: apply filters + pagination ─────────────────────\n  private paginate(\n    records: PostOffice[],\n    options?: QueryOptions,\n  ): PaginatedResult<PostOffice> {\n    const limit = options?.limit ?? 100;\n    const page = options?.page ?? 1;\n    let filtered = records;\n\n    if (options?.officeType) {\n      filtered = filtered.filter((r) => r.officeType === options.officeType);\n    }\n    if (options?.deliveryOnly) {\n      filtered = filtered.filter((r) => r.delivery);\n    }\n\n    const total = filtered.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    const data = filtered.slice(start, start + limit);\n\n    return { data, total, page, limit, totalPages };\n  }\n\n  // ═══════════════════════════════════════════════════════════════\n  //  PUBLIC API\n  // ═══════════════════════════════════════════════════════════════\n\n  // ─── Pincode lookup (O(1)) ──────────────────────────────────\n\n  /** Get all post offices for a pincode. */\n  getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByPincode().get(pincode) ?? [];\n    return this.paginate(records, options);\n  }\n\n  /** Get a complete summary for a pincode. */\n  getPincodeSummary(pincode: string): PincodeSummary | null {\n    const offices = this.indexByPincode().get(pincode);\n    if (!offices || offices.length === 0) return null;\n    const first = offices[0];\n    return {\n      pincode,\n      district: first.district,\n      state: first.state,\n      offices,\n      deliveryOffices: offices.filter((o) => o.delivery).length,\n      hasCoordinates: offices.some((o) => o.latitude !== null),\n    };\n  }\n\n  // ─── State queries ──────────────────────────────────────────\n\n  /** Get all post offices in a state. */\n  getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    return this.paginate(records, options);\n  }\n\n  /** Get a summary for a state — districts, pincode count, etc. */\n  getStateSummary(state: string): StateSummary | null {\n    const records = this.indexByState().get(state.toLowerCase());\n    if (!records || records.length === 0) return null;\n    const districtSet = new Set<string>();\n    const pincodeSet = new Set<string>();\n    for (const r of records) {\n      if (r.district) districtSet.add(r.district);\n      pincodeSet.add(r.pincode);\n    }\n    return {\n      state: records[0].state,\n      totalDistricts: districtSet.size,\n      totalOffices: records.length,\n      totalPincodes: pincodeSet.size,\n      districts: Array.from(districtSet).sort(),\n    };\n  }\n\n  /** Get all unique state names. */\n  getAllStates(): string[] {\n    const idx = this.indexByState();\n    return Array.from(idx.keys())\n      .filter((s) => s.length > 0)\n      .map((s) => {\n        const first = idx.get(s);\n        return first ? first[0].state : s;\n      })\n      .sort();\n  }\n\n  // ─── District queries ───────────────────────────────────────\n\n  /** Get all post offices in a district. */\n  getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByDistrict().get(district.toLowerCase()) ?? [];\n    return this.paginate(records, options);\n  }\n\n  /** Get a summary for a district. */\n  getDistrictSummary(district: string): DistrictSummary | null {\n    const records = this.indexByDistrict().get(district.toLowerCase());\n    if (!records || records.length === 0) return null;\n    const pincodeSet = new Set<string>();\n    for (const r of records) pincodeSet.add(r.pincode);\n    return {\n      district: records[0].district,\n      state: records[0].state,\n      totalOffices: records.length,\n      totalPincodes: pincodeSet.size,\n      pincodes: Array.from(pincodeSet).sort(),\n    };\n  }\n\n  /** Get all districts for a state. */\n  getDistrictsByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) {\n      if (r.district) set.add(r.district);\n    }\n    return Array.from(set).sort();\n  }\n\n  /** Get all unique district names. */\n  getAllDistricts(): string[] {\n    const idx = this.indexByDistrict();\n    return Array.from(idx.keys())\n      .filter((d) => d.length > 0)\n      .map((d) => {\n        const first = idx.get(d);\n        return first ? first[0].district : d;\n      })\n      .sort();\n  }\n\n  // ─── Office name queries ────────────────────────────────────\n\n  /** Get post offices by exact office name (case-insensitive). */\n  getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const records = this.indexByOffice().get(name.toLowerCase()) ?? [];\n    return this.paginate(records, options);\n  }\n\n  // ─── Pincode range queries ──────────────────────────────────\n\n  /** Get all pincodes in a state. */\n  getPincodesByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  /** Get all pincodes in a district. */\n  getPincodesByDistrict(district: string): string[] {\n    const records = this.indexByDistrict().get(district.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  // ─── Free-text search ───────────────────────────────────────\n\n  /**\n   * Search across pincode, office name, district, state.\n   * Returns early once limit is reached — no wasted iteration.\n   */\n  search(query: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    const data = loadData();\n    const q = query.toLowerCase();\n    const limit = options?.limit ?? 100;\n    const page = options?.page ?? 1;\n    const officeType = options?.officeType;\n    const deliveryOnly = options?.deliveryOnly;\n\n    const matches: PostOffice[] = [];\n    const maxScan = (page * limit) + limit; // fetch enough for pagination\n\n    for (let i = 0; i < data.length && matches.length < maxScan; i++) {\n      const r = data[i];\n      if (officeType && r.officeType !== officeType) continue;\n      if (deliveryOnly && !r.delivery) continue;\n\n      if (\n        r.pincode.includes(q) ||\n        r.officeName.toLowerCase().includes(q) ||\n        r.district.toLowerCase().includes(q) ||\n        r.state.toLowerCase().includes(q) ||\n        r.circle.toLowerCase().includes(q) ||\n        r.region.toLowerCase().includes(q)\n      ) {\n        matches.push(r);\n      }\n    }\n\n    const total = matches.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    return {\n      data: matches.slice(start, start + limit),\n      total,\n      page,\n      limit,\n      totalPages,\n    };\n  }\n\n  // ─── Geo: nearby search ─────────────────────────────────────\n\n  /**\n   * Find post offices near a given coordinate.\n   * Uses bounding-box pre-filter + Haversine for accuracy.\n   * Returns sorted by distance ascending.\n   */\n  findNearby(\n    lat: number,\n    lng: number,\n    radiusKm = 10,\n    limit = 20,\n  ): NearbyResult[] {\n    const data = loadData();\n    // Bounding-box pre-filter (1 degree ≈ 111 km)\n    const dLat = radiusKm / 111;\n    const dLng = radiusKm / (111 * Math.cos(toRad(lat)));\n    const minLat = lat - dLat;\n    const maxLat = lat + dLat;\n    const minLng = lng - dLng;\n    const maxLng = lng + dLng;\n\n    const results: NearbyResult[] = [];\n\n    for (let i = 0; i < data.length; i++) {\n      const r = data[i];\n      if (r.latitude === null || r.longitude === null) continue;\n      // Bounding box check (cheap)\n      if (r.latitude < minLat || r.latitude > maxLat) continue;\n      if (r.longitude < minLng || r.longitude > maxLng) continue;\n      // Haversine (accurate)\n      const d = haversine(lat, lng, r.latitude, r.longitude);\n      if (d <= radiusKm) {\n        results.push({ ...r, distanceKm: Math.round(d * 100) / 100 });\n      }\n    }\n\n    results.sort((a, b) => a.distanceKm - b.distanceKm);\n    return results.slice(0, limit);\n  }\n\n  // ─── Bulk / utility ─────────────────────────────────────────\n\n  /** Total number of post office records loaded. */\n  getTotalRecords(): number {\n    return loadData().length;\n  }\n\n  /** Total number of unique pincodes. */\n  getTotalPincodes(): number {\n    return this.indexByPincode().size;\n  }\n\n  /** Clear all cached data and indexes — reloads fresh on next call. */\n  clearCache(): void {\n    this._byPincode = null;\n    this._byState = null;\n    this._byDistrict = null;\n    this._byOffice = null;\n    clearDataCache();\n  }\n}\n\n// ─── Haversine helpers ────────────────────────────────────────────\nfunction toRad(deg: number): number {\n  return deg * (Math.PI / 180);\n}\n\nfunction haversine(lat1: number, lon1: number, lat2: number, lon2: number): number {\n  const R = 6371;\n  const dLat = toRad(lat2 - lat1);\n  const dLon = toRad(lon2 - lon1);\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2;\n  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n}\n\n// ─── Singleton ────────────────────────────────────────────────────\nlet _instance: IndiaPincode | null = null;\n\n/** Returns a singleton IndiaPincode instance. */\nexport function getIndiaPincode(): IndiaPincode {\n  if (!_instance) _instance = new IndiaPincode();\n  return _instance;\n}\n","import { Injectable } from '@nestjs/common';\nimport { IndiaPincode } from './pincode-lookup';\nimport {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n} from './types';\n\n/**\n * NestJS Injectable service — wraps IndiaPincode for DI.\n * Import PincodeModule in your AppModule, then inject this anywhere.\n */\n@Injectable()\nexport class PincodeService {\n  private readonly engine: IndiaPincode;\n\n  constructor() {\n    this.engine = new IndiaPincode();\n  }\n\n  getByPincode(pincode: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByPincode(pincode, options);\n  }\n\n  getPincodeSummary(pincode: string): PincodeSummary | null {\n    return this.engine.getPincodeSummary(pincode);\n  }\n\n  getByState(state: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByState(state, options);\n  }\n\n  getStateSummary(state: string): StateSummary | null {\n    return this.engine.getStateSummary(state);\n  }\n\n  getAllStates(): string[] {\n    return this.engine.getAllStates();\n  }\n\n  getByDistrict(district: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByDistrict(district, options);\n  }\n\n  getDistrictSummary(district: string): DistrictSummary | null {\n    return this.engine.getDistrictSummary(district);\n  }\n\n  getDistrictsByState(state: string): string[] {\n    return this.engine.getDistrictsByState(state);\n  }\n\n  getAllDistricts(): string[] {\n    return this.engine.getAllDistricts();\n  }\n\n  getByOfficeName(name: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.getByOfficeName(name, options);\n  }\n\n  getPincodesByState(state: string): string[] {\n    return this.engine.getPincodesByState(state);\n  }\n\n  getPincodesByDistrict(district: string): string[] {\n    return this.engine.getPincodesByDistrict(district);\n  }\n\n  search(query: string, options?: QueryOptions): PaginatedResult<PostOffice> {\n    return this.engine.search(query, options);\n  }\n\n  findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): NearbyResult[] {\n    return this.engine.findNearby(lat, lng, radiusKm, limit);\n  }\n\n  getTotalRecords(): number {\n    return this.engine.getTotalRecords();\n  }\n\n  getTotalPincodes(): number {\n    return this.engine.getTotalPincodes();\n  }\n\n  clearCache(): void {\n    this.engine.clearCache();\n  }\n}\n","import { Module, Global } from '@nestjs/common';\nimport { PincodeService } from './pincode.service';\n\n/**\n * NestJS Module for Indian Pincode data.\n *\n * Usage in your NestJS app:\n * ```ts\n * import { PincodeModule } from 'india-pincode';\n *\n * @Module({\n *   imports: [PincodeModule],\n * })\n * export class AppModule {}\n * ```\n *\n * Then inject PincodeService in any controller/service:\n * ```ts\n * constructor(private readonly pincodeService: PincodeService) {}\n * ```\n */\n@Global()\n@Module({\n  providers: [PincodeService],\n  exports: [PincodeService],\n})\nexport class PincodeModule {}\n"]}
+{"version":3,"sources":["../src/types.ts","../src/data-loader.ts","../src/pincode-lookup.ts","../src/pincode.service.ts","../src/pincode.module.ts"],"names":["ErrorCode","COUNTRY","PINCODE_REGEX","OFFICE_SUFFIX_REGEX","cachedData","sanitizeCityName","raw","trimStr","val","s","safeNum","n","isValidLatitude","lat","isValidLongitude","lng","normalizeOfficeType","upper","expand","rec","pincode","city","district","state","latitude","longitude","dedupKey","r","loadData","dataPath","seen","result","i","record","key","isValidPincode","clearDataCache","ok","data","fail","code","message","IndiaPincode","o","keyFn","index","arr","records","options","limit","page","filtered","total","totalPages","start","trimmed","cities","first","districtSet","pincodeSet","idx","set","d","name","query","q","officeType","deliveryOnly","matches","maxScan","radiusKm","dLat","dLng","toRad","minLat","maxLat","minLng","maxLng","results","haversine","a","b","sliced","deg","lat1","lon1","lat2","lon2","dLon","_instance","getIndiaPincode","PincodeService","__decorateClass","Injectable","PincodeModule","Global","Module"],"mappings":"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","file":"index.mjs","sourcesContent":["// ─── Error handling ─────────────────────────────────────────────\nexport enum ErrorCode {\n  INVALID_PINCODE = 'INVALID_PINCODE',\n  PINCODE_NOT_FOUND = 'PINCODE_NOT_FOUND',\n  STATE_NOT_FOUND = 'STATE_NOT_FOUND',\n  DISTRICT_NOT_FOUND = 'DISTRICT_NOT_FOUND',\n  INVALID_COORDINATES = 'INVALID_COORDINATES',\n  INVALID_INPUT = 'INVALID_INPUT',\n  NO_RESULTS = 'NO_RESULTS',\n}\n\nexport interface ApiError {\n  code: ErrorCode;\n  message: string;\n}\n\nexport interface ApiResponse<T> {\n  success: boolean;\n  data: T | null;\n  error?: ApiError;\n}\n\n// ─── Normalized public type ─────────────────────────────────────\nexport interface PostOffice {\n  pincode: string;\n  city: string;\n  officeType: OfficeType;\n  delivery: boolean;\n  district: string;\n  state: string;\n  country: string;\n  circle: string;\n  region: string;\n  division: string;\n  latitude: number | null;\n  longitude: number | null;\n}\n\nexport type OfficeType = 'BO' | 'SO' | 'HO' | 'PO' | 'GPO';\n\n// ─── Query options ──────────────────────────────────────────────\nexport interface QueryOptions {\n  /** Max results to return (default: 100) */\n  limit?: number;\n  /** Page number, 1-based (default: 1) */\n  page?: number;\n  /** Filter by office type */\n  officeType?: OfficeType;\n  /** Filter only delivery offices */\n  deliveryOnly?: boolean;\n}\n\n// ─── Paginated result ───────────────────────────────────────────\nexport interface PaginatedResult<T> {\n  data: T[];\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\n// ─── Location result (with distance) ────────────────────────────\nexport interface NearbyResult extends PostOffice {\n  distanceKm: number;\n}\n\n// ─── Summary types ──────────────────────────────────────────────\nexport interface PincodeSummary {\n  pincode: string;\n  district: string;\n  state: string;\n  country: string;\n  cities: PostOffice[];\n  deliveryCities: number;\n  hasCoordinates: boolean;\n}\n\nexport interface DistrictSummary {\n  district: string;\n  state: string;\n  country: string;\n  totalCities: number;\n  totalPincodes: number;\n  pincodes: string[];\n}\n\nexport interface StateSummary {\n  state: string;\n  country: string;\n  totalDistricts: number;\n  totalCities: number;\n  totalPincodes: number;\n  districts: string[];\n}\n","import * as fs from 'fs';\nimport * as path from 'path';\nimport { PostOffice, OfficeType } from './types';\n\nconst COUNTRY = 'INDIA';\nconst PINCODE_REGEX = /^[1-9]\\d{5}$/;\n\n/**\n * Regex to strip office-type suffixes from city names.\n * Handles: B.O, S.O, H.O, P.O, G.P.O, M.D.G, R.M.S and their\n * dot-less variants (BO, SO, HO, PO, GPO, MDG, RMS).\n */\nconst OFFICE_SUFFIX_REGEX =\n  /\\s+\\(?(?:B\\.?O\\.?|S\\.?O\\.?|H\\.?O\\.?|P\\.?O\\.?|G\\.?P\\.?O\\.?|M\\.?D\\.?G\\.?|R\\.?M\\.?S\\.?)\\)?\\s*$/i;\n\n/** Compact JSON record shape (short keys for minimal file size) */\ninterface CompactRecord {\n  c: string;  // circlename\n  r: string;  // regionname\n  v: string;  // divisionname\n  o: string;  // officename\n  p: string;  // pincode\n  t: string;  // officetype\n  d: number;  // delivery (1 = yes, 0 = no)\n  i: string;  // district\n  s: string;  // statename\n  a: number;  // latitude (0 = not available)\n  n: number;  // longitude (0 = not available)\n}\n\nlet cachedData: PostOffice[] | null = null;\n\n// ─── Sanitization helpers ───────────────────────────────────────\n\n/** Strip office-type suffixes (B.O, S.O, H.O, etc.) and trim */\nfunction sanitizeCityName(raw: string): string {\n  if (!raw || typeof raw !== 'string') return '';\n  return raw.replace(OFFICE_SUFFIX_REGEX, '').replace(/\\s{2,}/g, ' ').trim();\n}\n\n/** Trim and collapse extra whitespace */\nfunction trimStr(val: unknown): string {\n  if (val === null || val === undefined) return '';\n  const s = String(val).trim();\n  return s === 'NA' ? '' : s.replace(/\\s{2,}/g, ' ');\n}\n\n/** Parse a numeric field, returning null for invalid / NaN / 0 */\nfunction safeNum(val: unknown): number | null {\n  if (val === null || val === undefined) return null;\n  const n = Number(val);\n  if (!Number.isFinite(n) || n === 0) return null;\n  return n;\n}\n\n/** Validate latitude is within valid range */\nfunction isValidLatitude(lat: number | null): boolean {\n  return lat === null || (lat >= -90 && lat <= 90);\n}\n\n/** Validate longitude is within valid range */\nfunction isValidLongitude(lng: number | null): boolean {\n  return lng === null || (lng >= -180 && lng <= 180);\n}\n\n/** Normalize office type string to valid OfficeType */\nfunction normalizeOfficeType(raw: string): OfficeType {\n  const upper = String(raw).replace(/\\./g, '').toUpperCase().trim();\n  const valid: OfficeType[] = ['BO', 'SO', 'HO', 'PO', 'GPO'];\n  return (valid.includes(upper as OfficeType) ? upper : 'BO') as OfficeType;\n}\n\n// ─── Expand & validate ──────────────────────────────────────────\n\n/** Expand a compact record into a validated PostOffice (or null if invalid) */\nfunction expand(rec: CompactRecord): PostOffice | null {\n  const pincode = trimStr(rec.p);\n  const city = sanitizeCityName(trimStr(rec.o));\n  const district = trimStr(rec.i);\n  const state = trimStr(rec.s);\n\n  // Required field checks\n  if (!pincode || !city || !district || !state) return null;\n\n  // Pincode must be exactly 6 digits starting with 1-9\n  if (!PINCODE_REGEX.test(pincode)) return null;\n\n  const latitude = safeNum(rec.a);\n  const longitude = safeNum(rec.n);\n\n  // Reject out-of-range coordinates\n  if (!isValidLatitude(latitude) || !isValidLongitude(longitude)) return null;\n\n  return {\n    pincode,\n    city,\n    officeType: normalizeOfficeType(rec.t),\n    delivery: rec.d === 1,\n    district,\n    state,\n    country: COUNTRY,\n    circle: trimStr(rec.c),\n    region: trimStr(rec.r),\n    division: trimStr(rec.v),\n    latitude,\n    longitude,\n  };\n}\n\n/** Build a dedup key for a record */\nfunction dedupKey(r: PostOffice): string {\n  return `${r.pincode}|${r.city.toLowerCase()}|${r.district.toLowerCase()}|${r.officeType}`;\n}\n\n/**\n * Loads, validates, sanitizes and deduplicates all pincode data.\n * Cached after first call — subsequent calls return instantly.\n *\n * Records that fail validation are silently dropped:\n * - Missing required fields (pincode, city, district, state)\n * - Invalid pincode format (must be 6 digits, starting 1–9)\n * - Out-of-range coordinates\n * - NaN / undefined / null in required fields\n * - Duplicate records (same pincode + city + district + officeType)\n */\nexport function loadData(): PostOffice[] {\n  if (cachedData) return cachedData;\n\n  const dataPath = path.resolve(__dirname, '..', 'data', 'pincodes.json');\n  const raw: CompactRecord[] = JSON.parse(fs.readFileSync(dataPath, 'utf-8'));\n\n  const seen = new Set<string>();\n  const result: PostOffice[] = [];\n\n  for (let i = 0; i < raw.length; i++) {\n    const record = expand(raw[i]);\n    if (!record) continue;\n\n    const key = dedupKey(record);\n    if (seen.has(key)) continue;\n\n    seen.add(key);\n    result.push(record);\n  }\n\n  cachedData = result;\n  return cachedData;\n}\n\n/** Validates an Indian pincode format. Returns true if valid. */\nexport function isValidPincode(pincode: string): boolean {\n  return typeof pincode === 'string' && PINCODE_REGEX.test(pincode.trim());\n}\n\n/** Clears all cached data (useful for testing / hot-reload). */\nexport function clearDataCache(): void {\n  cachedData = null;\n}\n","import {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n  ApiResponse,\n  ErrorCode,\n} from './types';\nimport { loadData, clearDataCache, isValidPincode } from './data-loader';\n\nconst COUNTRY = 'INDIA';\n\n// ─── Response helpers ─────────────────────────────────────────────\n\nfunction ok<T>(data: T): ApiResponse<T> {\n  return { success: true, data };\n}\n\nfunction fail<T>(code: ErrorCode, message: string): ApiResponse<T> {\n  return { success: false, data: null, error: { code, message } };\n}\n\n/**\n * High-performance Indian Pincode lookup engine.\n *\n * Architecture:\n * - All indexes are lazy-built on first access, then cached.\n * - Pincode → O(1) HashMap lookup.\n * - State / District / City → O(1) index lookup.\n * - Geo-nearby → Haversine with early bounding-box pruning.\n * - All responses wrapped in ApiResponse with proper error codes.\n */\nexport class IndiaPincode {\n  // ─── Indexes (lazy) ─────────────────────────────────────────\n  private _byPincode: Map<string, PostOffice[]> | null = null;\n  private _byState: Map<string, PostOffice[]> | null = null;\n  private _byDistrict: Map<string, PostOffice[]> | null = null;\n  private _byCity: Map<string, PostOffice[]> | null = null;\n\n  // ─── Index builders ─────────────────────────────────────────\n  private indexByPincode(): Map<string, PostOffice[]> {\n    if (this._byPincode) return this._byPincode;\n    this._byPincode = this.buildIndex((o) => o.pincode);\n    return this._byPincode;\n  }\n\n  private indexByState(): Map<string, PostOffice[]> {\n    if (this._byState) return this._byState;\n    this._byState = this.buildIndex((o) => o.state.toLowerCase());\n    return this._byState;\n  }\n\n  private indexByDistrict(): Map<string, PostOffice[]> {\n    if (this._byDistrict) return this._byDistrict;\n    this._byDistrict = this.buildIndex((o) => o.district.toLowerCase());\n    return this._byDistrict;\n  }\n\n  private indexByCity(): Map<string, PostOffice[]> {\n    if (this._byCity) return this._byCity;\n    this._byCity = this.buildIndex((o) => o.city.toLowerCase());\n    return this._byCity;\n  }\n\n  private buildIndex(keyFn: (o: PostOffice) => string): Map<string, PostOffice[]> {\n    const data = loadData();\n    const index = new Map<string, PostOffice[]>();\n    for (let i = 0; i < data.length; i++) {\n      const key = keyFn(data[i]);\n      if (!key) continue;\n      const arr = index.get(key);\n      if (arr) arr.push(data[i]);\n      else index.set(key, [data[i]]);\n    }\n    return index;\n  }\n\n  // ─── Helper: apply filters + pagination ─────────────────────\n  private paginate(\n    records: PostOffice[],\n    options?: QueryOptions,\n  ): PaginatedResult<PostOffice> {\n    const limit = Math.max(1, options?.limit ?? 100);\n    const page = Math.max(1, options?.page ?? 1);\n    let filtered = records;\n\n    if (options?.officeType) {\n      filtered = filtered.filter((r) => r.officeType === options.officeType);\n    }\n    if (options?.deliveryOnly) {\n      filtered = filtered.filter((r) => r.delivery);\n    }\n\n    const total = filtered.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    const data = filtered.slice(start, start + limit);\n\n    return { data, total, page, limit, totalPages };\n  }\n\n  // ═══════════════════════════════════════════════════════════════\n  //  PUBLIC API\n  // ═══════════════════════════════════════════════════════════════\n\n  // ─── Pincode lookup (O(1)) ──────────────────────────────────\n\n  /** Get all post offices for a pincode. Returns error for invalid/missing pincodes. */\n  getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!pincode || typeof pincode !== 'string') {\n      return fail(ErrorCode.INVALID_INPUT, 'Pincode is required and must be a string.');\n    }\n\n    const trimmed = pincode.trim();\n    if (!isValidPincode(trimmed)) {\n      return fail(\n        ErrorCode.INVALID_PINCODE,\n        `Invalid pincode \"${trimmed}\". Indian pincodes must be exactly 6 digits starting with 1-9.`,\n      );\n    }\n\n    const records = this.indexByPincode().get(trimmed);\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.PINCODE_NOT_FOUND, `No data found for pincode \"${trimmed}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  /** Get a complete summary for a pincode. */\n  getPincodeSummary(pincode: string): ApiResponse<PincodeSummary> {\n    if (!pincode || typeof pincode !== 'string') {\n      return fail(ErrorCode.INVALID_INPUT, 'Pincode is required and must be a string.');\n    }\n\n    const trimmed = pincode.trim();\n    if (!isValidPincode(trimmed)) {\n      return fail(\n        ErrorCode.INVALID_PINCODE,\n        `Invalid pincode \"${trimmed}\". Indian pincodes must be exactly 6 digits starting with 1-9.`,\n      );\n    }\n\n    const cities = this.indexByPincode().get(trimmed);\n    if (!cities || cities.length === 0) {\n      return fail(ErrorCode.PINCODE_NOT_FOUND, `No data found for pincode \"${trimmed}\".`);\n    }\n\n    const first = cities[0];\n    return ok({\n      pincode: trimmed,\n      district: first.district,\n      state: first.state,\n      country: COUNTRY,\n      cities,\n      deliveryCities: cities.filter((o) => o.delivery).length,\n      hasCoordinates: cities.some((o) => o.latitude !== null),\n    });\n  }\n\n  // ─── State queries ──────────────────────────────────────────\n\n  /** Get all post offices in a state. */\n  getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!state || typeof state !== 'string' || !state.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'State name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByState().get(state.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.STATE_NOT_FOUND, `No data found for state \"${state.trim()}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  /** Get a summary for a state — districts, pincode count, etc. */\n  getStateSummary(state: string): ApiResponse<StateSummary> {\n    if (!state || typeof state !== 'string' || !state.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'State name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByState().get(state.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.STATE_NOT_FOUND, `No data found for state \"${state.trim()}\".`);\n    }\n\n    const districtSet = new Set<string>();\n    const pincodeSet = new Set<string>();\n    for (const r of records) {\n      if (r.district) districtSet.add(r.district);\n      pincodeSet.add(r.pincode);\n    }\n\n    return ok({\n      state: records[0].state,\n      country: COUNTRY,\n      totalDistricts: districtSet.size,\n      totalCities: records.length,\n      totalPincodes: pincodeSet.size,\n      districts: Array.from(districtSet).sort(),\n    });\n  }\n\n  /** Get all unique state names. */\n  getAllStates(): string[] {\n    const idx = this.indexByState();\n    return Array.from(idx.keys())\n      .filter((s) => s.length > 0)\n      .map((s) => {\n        const first = idx.get(s);\n        return first ? first[0].state : s;\n      })\n      .sort();\n  }\n\n  // ─── District queries ───────────────────────────────────────\n\n  /** Get all post offices in a district. */\n  getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!district || typeof district !== 'string' || !district.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'District name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByDistrict().get(district.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.DISTRICT_NOT_FOUND, `No data found for district \"${district.trim()}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  /** Get a summary for a district. */\n  getDistrictSummary(district: string): ApiResponse<DistrictSummary> {\n    if (!district || typeof district !== 'string' || !district.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'District name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByDistrict().get(district.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.DISTRICT_NOT_FOUND, `No data found for district \"${district.trim()}\".`);\n    }\n\n    const pincodeSet = new Set<string>();\n    for (const r of records) pincodeSet.add(r.pincode);\n\n    return ok({\n      district: records[0].district,\n      state: records[0].state,\n      country: COUNTRY,\n      totalCities: records.length,\n      totalPincodes: pincodeSet.size,\n      pincodes: Array.from(pincodeSet).sort(),\n    });\n  }\n\n  /** Get all districts for a state. */\n  getDistrictsByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) {\n      if (r.district) set.add(r.district);\n    }\n    return Array.from(set).sort();\n  }\n\n  /** Get all unique district names. */\n  getAllDistricts(): string[] {\n    const idx = this.indexByDistrict();\n    return Array.from(idx.keys())\n      .filter((d) => d.length > 0)\n      .map((d) => {\n        const first = idx.get(d);\n        return first ? first[0].district : d;\n      })\n      .sort();\n  }\n\n  // ─── City name queries ───────────────────────────────────────\n\n  /** Get post offices by exact city name (case-insensitive). */\n  getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!name || typeof name !== 'string' || !name.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'City name is required and must be a non-empty string.');\n    }\n\n    const records = this.indexByCity().get(name.trim().toLowerCase());\n    if (!records || records.length === 0) {\n      return fail(ErrorCode.NO_RESULTS, `No data found for city \"${name.trim()}\".`);\n    }\n\n    return ok(this.paginate(records, options));\n  }\n\n  // ─── Pincode range queries ──────────────────────────────────\n\n  /** Get all pincodes in a state. */\n  getPincodesByState(state: string): string[] {\n    const records = this.indexByState().get(state.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  /** Get all pincodes in a district. */\n  getPincodesByDistrict(district: string): string[] {\n    const records = this.indexByDistrict().get(district.toLowerCase()) ?? [];\n    const set = new Set<string>();\n    for (const r of records) set.add(r.pincode);\n    return Array.from(set).sort();\n  }\n\n  // ─── Free-text search ───────────────────────────────────────\n\n  /**\n   * Search across pincode, city name, district, state.\n   * Returns early once limit is reached — no wasted iteration.\n   */\n  search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    if (!query || typeof query !== 'string' || !query.trim()) {\n      return fail(ErrorCode.INVALID_INPUT, 'Search query is required and must be a non-empty string.');\n    }\n\n    const data = loadData();\n    const q = query.trim().toLowerCase();\n    const limit = Math.max(1, options?.limit ?? 100);\n    const page = Math.max(1, options?.page ?? 1);\n    const officeType = options?.officeType;\n    const deliveryOnly = options?.deliveryOnly;\n\n    const matches: PostOffice[] = [];\n    const maxScan = (page * limit) + limit; // fetch enough for pagination\n\n    for (let i = 0; i < data.length && matches.length < maxScan; i++) {\n      const r = data[i];\n      if (officeType && r.officeType !== officeType) continue;\n      if (deliveryOnly && !r.delivery) continue;\n\n      if (\n        r.pincode.includes(q) ||\n        r.city.toLowerCase().includes(q) ||\n        r.district.toLowerCase().includes(q) ||\n        r.state.toLowerCase().includes(q) ||\n        r.circle.toLowerCase().includes(q) ||\n        r.region.toLowerCase().includes(q)\n      ) {\n        matches.push(r);\n      }\n    }\n\n    if (matches.length === 0) {\n      return fail(ErrorCode.NO_RESULTS, `No results found for \"${query.trim()}\".`);\n    }\n\n    const total = matches.length;\n    const totalPages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n\n    return ok({\n      data: matches.slice(start, start + limit),\n      total,\n      page,\n      limit,\n      totalPages,\n    });\n  }\n\n  // ─── Geo: nearby search ─────────────────────────────────────\n\n  /**\n   * Find post offices near a given coordinate.\n   * Uses bounding-box pre-filter + Haversine for accuracy.\n   * Returns sorted by distance ascending.\n   */\n  findNearby(\n    lat: number,\n    lng: number,\n    radiusKm = 10,\n    limit = 20,\n  ): ApiResponse<NearbyResult[]> {\n    if (typeof lat !== 'number' || typeof lng !== 'number' || !Number.isFinite(lat) || !Number.isFinite(lng)) {\n      return fail(ErrorCode.INVALID_COORDINATES, 'Latitude and longitude must be valid numbers.');\n    }\n    if (lat < -90 || lat > 90 || lng < -180 || lng > 180) {\n      return fail(\n        ErrorCode.INVALID_COORDINATES,\n        `Invalid coordinates (${lat}, ${lng}). Latitude must be -90 to 90, longitude -180 to 180.`,\n      );\n    }\n    const data = loadData();\n    // Bounding-box pre-filter (1 degree ≈ 111 km)\n    const dLat = radiusKm / 111;\n    const dLng = radiusKm / (111 * Math.cos(toRad(lat)));\n    const minLat = lat - dLat;\n    const maxLat = lat + dLat;\n    const minLng = lng - dLng;\n    const maxLng = lng + dLng;\n\n    const results: NearbyResult[] = [];\n\n    for (let i = 0; i < data.length; i++) {\n      const r = data[i];\n      if (r.latitude === null || r.longitude === null) continue;\n      // Bounding box check (cheap)\n      if (r.latitude < minLat || r.latitude > maxLat) continue;\n      if (r.longitude < minLng || r.longitude > maxLng) continue;\n      // Haversine (accurate)\n      const d = haversine(lat, lng, r.latitude, r.longitude);\n      if (d <= radiusKm) {\n        results.push({ ...r, distanceKm: Math.round(d * 100) / 100 });\n      }\n    }\n\n    results.sort((a, b) => a.distanceKm - b.distanceKm);\n    const sliced = results.slice(0, limit);\n\n    if (sliced.length === 0) {\n      return fail(ErrorCode.NO_RESULTS, `No post offices found within ${radiusKm}km of (${lat}, ${lng}).`);\n    }\n\n    return ok(sliced);\n  }\n\n  // ─── Bulk / utility ─────────────────────────────────────────\n\n  /** Total number of post office records loaded. */\n  getTotalRecords(): number {\n    return loadData().length;\n  }\n\n  /** Total number of unique pincodes. */\n  getTotalPincodes(): number {\n    return this.indexByPincode().size;\n  }\n\n  /** Clear all cached data and indexes — reloads fresh on next call. */\n  clearCache(): void {\n    this._byPincode = null;\n    this._byState = null;\n    this._byDistrict = null;\n    this._byCity = null;\n    clearDataCache();\n  }\n}\n\n// ─── Haversine helpers ────────────────────────────────────────────\nfunction toRad(deg: number): number {\n  return deg * (Math.PI / 180);\n}\n\nfunction haversine(lat1: number, lon1: number, lat2: number, lon2: number): number {\n  const R = 6371;\n  const dLat = toRad(lat2 - lat1);\n  const dLon = toRad(lon2 - lon1);\n  const a =\n    Math.sin(dLat / 2) ** 2 +\n    Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2;\n  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));\n}\n\n// ─── Singleton ────────────────────────────────────────────────────\nlet _instance: IndiaPincode | null = null;\n\n/** Returns a singleton IndiaPincode instance. */\nexport function getIndiaPincode(): IndiaPincode {\n  if (!_instance) _instance = new IndiaPincode();\n  return _instance;\n}\n","import { Injectable } from '@nestjs/common';\nimport { IndiaPincode } from './pincode-lookup';\nimport {\n  PostOffice,\n  QueryOptions,\n  PaginatedResult,\n  NearbyResult,\n  PincodeSummary,\n  DistrictSummary,\n  StateSummary,\n  ApiResponse,\n} from './types';\n\n/**\n * NestJS Injectable service — wraps IndiaPincode for DI.\n * Import PincodeModule in your AppModule, then inject this anywhere.\n */\n@Injectable()\nexport class PincodeService {\n  private readonly engine: IndiaPincode;\n\n  constructor() {\n    this.engine = new IndiaPincode();\n  }\n\n  getByPincode(pincode: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByPincode(pincode, options);\n  }\n\n  getPincodeSummary(pincode: string): ApiResponse<PincodeSummary> {\n    return this.engine.getPincodeSummary(pincode);\n  }\n\n  getByState(state: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByState(state, options);\n  }\n\n  getStateSummary(state: string): ApiResponse<StateSummary> {\n    return this.engine.getStateSummary(state);\n  }\n\n  getAllStates(): string[] {\n    return this.engine.getAllStates();\n  }\n\n  getByDistrict(district: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByDistrict(district, options);\n  }\n\n  getDistrictSummary(district: string): ApiResponse<DistrictSummary> {\n    return this.engine.getDistrictSummary(district);\n  }\n\n  getDistrictsByState(state: string): string[] {\n    return this.engine.getDistrictsByState(state);\n  }\n\n  getAllDistricts(): string[] {\n    return this.engine.getAllDistricts();\n  }\n\n  getByCity(name: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.getByCity(name, options);\n  }\n\n  getPincodesByState(state: string): string[] {\n    return this.engine.getPincodesByState(state);\n  }\n\n  getPincodesByDistrict(district: string): string[] {\n    return this.engine.getPincodesByDistrict(district);\n  }\n\n  search(query: string, options?: QueryOptions): ApiResponse<PaginatedResult<PostOffice>> {\n    return this.engine.search(query, options);\n  }\n\n  findNearby(lat: number, lng: number, radiusKm?: number, limit?: number): ApiResponse<NearbyResult[]> {\n    return this.engine.findNearby(lat, lng, radiusKm, limit);\n  }\n\n  getTotalRecords(): number {\n    return this.engine.getTotalRecords();\n  }\n\n  getTotalPincodes(): number {\n    return this.engine.getTotalPincodes();\n  }\n\n  clearCache(): void {\n    this.engine.clearCache();\n  }\n}\n","import { Module, Global } from '@nestjs/common';\nimport { PincodeService } from './pincode.service';\n\n/**\n * NestJS Module for Indian Pincode data.\n *\n * Usage in your NestJS app:\n * ```ts\n * import { PincodeModule } from 'india-pincode';\n *\n * @Module({\n *   imports: [PincodeModule],\n * })\n * export class AppModule {}\n * ```\n *\n * Then inject PincodeService in any controller/service:\n * ```ts\n * constructor(private readonly pincodeService: PincodeService) {}\n * ```\n */\n@Global()\n@Module({\n  providers: [PincodeService],\n  exports: [PincodeService],\n})\nexport class PincodeModule {}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "india-pincode",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Ultra-fast lookup for Indian pincode data — state, city, district, latitude, longitude. Works standalone or as a NestJS module.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -53,8 +53,14 @@
     "rxjs": ">=7.0.0"
   },
   "peerDependenciesMeta": {
-    "@nestjs/common": { "optional": true },
-    "reflect-metadata": { "optional": true },
-    "rxjs": { "optional": true }
+    "@nestjs/common": {
+      "optional": true
+    },
+    "reflect-metadata": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
   }
 }