thaizip 0.7.6 → 0.7.8

package/dist/index.cjs

@@ -42,6 +42,12 @@ var MAX_POSTING_BUDGET = 1e6;
 function typeErr(table, id, field, expected, value) {
   return new TypeError(`[thaizip] ${table} ${id}: expected ${expected} for ${field}, got ${typeof value}`);
 }
+function assertId(table, id, field, value) {
+  if (typeof value !== "number") throw typeErr(table, id, field, "number", value);
+  if (!Number.isSafeInteger(value)) {
+    throw new TypeError(`[thaizip] ${table} ${id}: expected safe integer for ${field}, got ${value}`);
+  }
+}
 function typeName(value) {
   return value === null ? "null" : typeof value;
 }
@@ -68,7 +74,7 @@ function validateRawData(data) {
     if (p === null || typeof p !== "object") {
       throw new TypeError(`[thaizip] province[${i}]: expected object, got ${typeName(p)}`);
     }
-    if (typeof p.id !== "number") throw typeErr("province", p.id, "id", "number", p.id);
+    assertId("province", p.id, "id", p.id);
     if (provinceById.has(p.id)) throw new TypeError(`[thaizip] duplicate province id: ${p.id}`);
     provinceById.set(p.id, p);
     if (typeof p.name_th !== "string") throw typeErr("province", p.id, "name_th", "string", p.name_th);
@@ -82,12 +88,12 @@ function validateRawData(data) {
     if (a === null || typeof a !== "object") {
       throw new TypeError(`[thaizip] amphure[${i}]: expected object, got ${typeName(a)}`);
     }
-    if (typeof a.id !== "number") throw typeErr("amphure", a.id, "id", "number", a.id);
+    assertId("amphure", a.id, "id", a.id);
     if (amphureById.has(a.id)) throw new TypeError(`[thaizip] duplicate amphure id: ${a.id}`);
     amphureById.set(a.id, a);
     if (typeof a.name_th !== "string") throw typeErr("amphure", a.id, "name_th", "string", a.name_th);
     if (typeof a.name_en !== "string") throw typeErr("amphure", a.id, "name_en", "string", a.name_en);
-    if (typeof a.province_id !== "number") throw typeErr("amphure", a.id, "province_id", "number", a.province_id);
+    assertId("amphure", a.id, "province_id", a.province_id);
     if (a.name_th.length > MAX_NAME_LENGTH) throw new RangeError(`[thaizip] amphure ${a.id}: name_th too long`);
     if (a.name_en.length > MAX_NAME_LENGTH) throw new RangeError(`[thaizip] amphure ${a.id}: name_en too long`);
   }
@@ -100,7 +106,7 @@ function validateRawData(data) {
     if (t === null || typeof t !== "object") {
       throw new TypeError(`[thaizip] tambon[${i}]: expected object, got ${typeName(t)}`);
     }
-    if (typeof t.id !== "number") throw typeErr("tambon", t.id, "id", "number", t.id);
+    assertId("tambon", t.id, "id", t.id);
     if (seenTambonIds.has(t.id)) throw new TypeError(`[thaizip] duplicate tambon id: ${t.id}`);
     seenTambonIds.add(t.id);
     if (typeof t.name_th !== "string") throw typeErr("tambon", t.id, "name_th", "string", t.name_th);
@@ -111,7 +117,7 @@ function validateRawData(data) {
     if (zipType !== "string" && zipType !== "number") {
       throw typeErr("tambon", t.id, "zip_code", "string or number", t.zip_code);
     }
-    if (typeof t.amphure_id !== "number") throw typeErr("tambon", t.id, "amphure_id", "number", t.amphure_id);
+    assertId("tambon", t.id, "amphure_id", t.amphure_id);
     const zipLength = String(t.zip_code).length;
     if (zipLength > MAX_ZIP_LENGTH) throw new RangeError(`[thaizip] tambon ${t.id}: zip_code too long`);
     if (t.deleted_at) continue;
@@ -421,7 +427,7 @@ function searchThaiAddress(index, query, options) {
   if (ZIP_CODE_RE.test(normalized)) {
     if (normalized.length < 2) return [];
     return lookupByZipCode(index, normalized, {
-      zipLimit: options?.zipLimit ?? Infinity
+      zipLimit: options?.zipLimit ?? (normalized.length >= 5 ? Infinity : limit)
     });
   }
   if (normalized.length < 3) return [];
@@ -583,5 +589,3 @@ exports.normalizeThaiAddressText = normalizeThaiAddressText;
 exports.resolveThaiAddress = resolveThaiAddress;
 exports.searchThaiAddress = searchThaiAddress;
 exports.validateRawData = validateRawData;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -101,9 +101,11 @@ type SearchOptions = {
     limit?: number;
     threshold?: number;
     /**
-     * Maximum results for all-digit (zip code) queries. A zip code maps to at most
-     * a few dozen tambons, so this defaults to `Infinity` — capping zip results at
-     * the text-autocomplete `limit` silently hides valid subdistricts.
+     * Maximum results for all-digit (zip code) queries. When omitted, a complete
+     * 5-digit zip returns every matching tambon (at most a few dozen — capping
+     * those at the text-autocomplete `limit` would silently hide valid
+     * subdistricts), while a partial prefix (2–4 digits, which can match hundreds
+     * of records) is capped at `limit`. Pass `Infinity` to return every prefix match.
      */
     zipLimit?: number;
     /**
@@ -145,6 +147,10 @@ type BuildIndexOptions = {
      * Validate that every consumed field has the expected runtime type and throw a
      * descriptive `TypeError` if not. Defaults to `true`; set to `false` to skip
      * the checks when the data source is already trusted (e.g. the bundled index).
+     *
+     * `false` also skips the row, name-length and posting-budget limits that bound
+     * memory and CPU use, so never disable it for data you do not control
+     * (user uploads, third-party APIs, a CMS editable by others).
      */
     validate?: boolean;
 };

package/dist/index.d.ts

@@ -101,9 +101,11 @@ type SearchOptions = {
     limit?: number;
     threshold?: number;
     /**
-     * Maximum results for all-digit (zip code) queries. A zip code maps to at most
-     * a few dozen tambons, so this defaults to `Infinity` — capping zip results at
-     * the text-autocomplete `limit` silently hides valid subdistricts.
+     * Maximum results for all-digit (zip code) queries. When omitted, a complete
+     * 5-digit zip returns every matching tambon (at most a few dozen — capping
+     * those at the text-autocomplete `limit` would silently hide valid
+     * subdistricts), while a partial prefix (2–4 digits, which can match hundreds
+     * of records) is capped at `limit`. Pass `Infinity` to return every prefix match.
      */
     zipLimit?: number;
     /**
@@ -145,6 +147,10 @@ type BuildIndexOptions = {
      * Validate that every consumed field has the expected runtime type and throw a
      * descriptive `TypeError` if not. Defaults to `true`; set to `false` to skip
      * the checks when the data source is already trusted (e.g. the bundled index).
+     *
+     * `false` also skips the row, name-length and posting-budget limits that bound
+     * memory and CPU use, so never disable it for data you do not control
+     * (user uploads, third-party APIs, a CMS editable by others).
      */
     validate?: boolean;
 };

package/dist/index.js

@@ -40,6 +40,12 @@ var MAX_POSTING_BUDGET = 1e6;
 function typeErr(table, id, field, expected, value) {
   return new TypeError(`[thaizip] ${table} ${id}: expected ${expected} for ${field}, got ${typeof value}`);
 }
+function assertId(table, id, field, value) {
+  if (typeof value !== "number") throw typeErr(table, id, field, "number", value);
+  if (!Number.isSafeInteger(value)) {
+    throw new TypeError(`[thaizip] ${table} ${id}: expected safe integer for ${field}, got ${value}`);
+  }
+}
 function typeName(value) {
   return value === null ? "null" : typeof value;
 }
@@ -66,7 +72,7 @@ function validateRawData(data) {
     if (p === null || typeof p !== "object") {
       throw new TypeError(`[thaizip] province[${i}]: expected object, got ${typeName(p)}`);
     }
-    if (typeof p.id !== "number") throw typeErr("province", p.id, "id", "number", p.id);
+    assertId("province", p.id, "id", p.id);
     if (provinceById.has(p.id)) throw new TypeError(`[thaizip] duplicate province id: ${p.id}`);
     provinceById.set(p.id, p);
     if (typeof p.name_th !== "string") throw typeErr("province", p.id, "name_th", "string", p.name_th);
@@ -80,12 +86,12 @@ function validateRawData(data) {
     if (a === null || typeof a !== "object") {
       throw new TypeError(`[thaizip] amphure[${i}]: expected object, got ${typeName(a)}`);
     }
-    if (typeof a.id !== "number") throw typeErr("amphure", a.id, "id", "number", a.id);
+    assertId("amphure", a.id, "id", a.id);
     if (amphureById.has(a.id)) throw new TypeError(`[thaizip] duplicate amphure id: ${a.id}`);
     amphureById.set(a.id, a);
     if (typeof a.name_th !== "string") throw typeErr("amphure", a.id, "name_th", "string", a.name_th);
     if (typeof a.name_en !== "string") throw typeErr("amphure", a.id, "name_en", "string", a.name_en);
-    if (typeof a.province_id !== "number") throw typeErr("amphure", a.id, "province_id", "number", a.province_id);
+    assertId("amphure", a.id, "province_id", a.province_id);
     if (a.name_th.length > MAX_NAME_LENGTH) throw new RangeError(`[thaizip] amphure ${a.id}: name_th too long`);
     if (a.name_en.length > MAX_NAME_LENGTH) throw new RangeError(`[thaizip] amphure ${a.id}: name_en too long`);
   }
@@ -98,7 +104,7 @@ function validateRawData(data) {
     if (t === null || typeof t !== "object") {
       throw new TypeError(`[thaizip] tambon[${i}]: expected object, got ${typeName(t)}`);
     }
-    if (typeof t.id !== "number") throw typeErr("tambon", t.id, "id", "number", t.id);
+    assertId("tambon", t.id, "id", t.id);
     if (seenTambonIds.has(t.id)) throw new TypeError(`[thaizip] duplicate tambon id: ${t.id}`);
     seenTambonIds.add(t.id);
     if (typeof t.name_th !== "string") throw typeErr("tambon", t.id, "name_th", "string", t.name_th);
@@ -109,7 +115,7 @@ function validateRawData(data) {
     if (zipType !== "string" && zipType !== "number") {
       throw typeErr("tambon", t.id, "zip_code", "string or number", t.zip_code);
     }
-    if (typeof t.amphure_id !== "number") throw typeErr("tambon", t.id, "amphure_id", "number", t.amphure_id);
+    assertId("tambon", t.id, "amphure_id", t.amphure_id);
     const zipLength = String(t.zip_code).length;
     if (zipLength > MAX_ZIP_LENGTH) throw new RangeError(`[thaizip] tambon ${t.id}: zip_code too long`);
     if (t.deleted_at) continue;
@@ -419,7 +425,7 @@ function searchThaiAddress(index, query, options) {
   if (ZIP_CODE_RE.test(normalized)) {
     if (normalized.length < 2) return [];
     return lookupByZipCode(index, normalized, {
-      zipLimit: options?.zipLimit ?? Infinity
+      zipLimit: options?.zipLimit ?? (normalized.length >= 5 ? Infinity : limit)
     });
   }
   if (normalized.length < 3) return [];
@@ -571,5 +577,3 @@ function resolveThaiAddress(record) {
 }
 
 export { applyRomanizationAliases, buildThaiAddressIndex, formatThaiAddressSuggestion, listAmphures, listProvinces, listTambons, lookupByZipCode, normalizeThaiAddressText, resolveThaiAddress, searchThaiAddress, validateRawData };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/react.cjs

@@ -225,7 +225,7 @@ function searchThaiAddress(index, query, options) {
   if (ZIP_CODE_RE.test(normalized)) {
     if (normalized.length < 2) return [];
     return lookupByZipCode(index, normalized, {
-      zipLimit: options?.zipLimit ?? Infinity
+      zipLimit: options?.zipLimit ?? (normalized.length >= 5 ? Infinity : limit)
     });
   }
   if (normalized.length < 3) return [];
@@ -402,5 +402,3 @@ function useThaiAddressAutocomplete(options) {
 }
 
 exports.useThaiAddressAutocomplete = useThaiAddressAutocomplete;
-//# sourceMappingURL=react.cjs.map
-//# sourceMappingURL=react.cjs.map

package/dist/react.d.cts

@@ -79,6 +79,7 @@ type UseThaiAddressAutocompleteOptions = {
     limit?: number;
     debounce?: number;
     threshold?: number;
+    /** Maximum results for zip code queries; see `SearchOptions.zipLimit` for the default. */
     zipLimit?: number;
     /** Seed value for `query` on first render. Defaults to `''`. */
     initialQuery?: string;

package/dist/react.d.ts

@@ -79,6 +79,7 @@ type UseThaiAddressAutocompleteOptions = {
     limit?: number;
     debounce?: number;
     threshold?: number;
+    /** Maximum results for zip code queries; see `SearchOptions.zipLimit` for the default. */
     zipLimit?: number;
     /** Seed value for `query` on first render. Defaults to `''`. */
     initialQuery?: string;

package/dist/react.js

@@ -223,7 +223,7 @@ function searchThaiAddress(index, query, options) {
   if (ZIP_CODE_RE.test(normalized)) {
     if (normalized.length < 2) return [];
     return lookupByZipCode(index, normalized, {
-      zipLimit: options?.zipLimit ?? Infinity
+      zipLimit: options?.zipLimit ?? (normalized.length >= 5 ? Infinity : limit)
     });
   }
   if (normalized.length < 3) return [];
@@ -400,5 +400,3 @@ function useThaiAddressAutocomplete(options) {
 }
 
 export { useThaiAddressAutocomplete };
-//# sourceMappingURL=react.js.map
-//# sourceMappingURL=react.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thaizip",
-  "version": "0.7.6",
+  "version": "0.7.8",
   "description": "Fast, fuzzy Thai address autocomplete library (headless + React)",
   "keywords": [
     "thai",
@@ -55,17 +55,17 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
-    "@testing-library/react": "^16.3.2",
-    "@types/node": "^25.5.2",
-    "@types/react": "^19.2.14",
-    "@vitest/coverage-v8": "^4.1.11",
-    "jsdom": "^29.0.1",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
+    "@testing-library/react": "^16.3.3",
+    "@types/node": "^26.6.5",
+    "@types/react": "^19.3.0",
+    "@vitest/coverage-v8": "^5.0.4",
+    "jsdom": "^30.1.2",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "tsup": "^8.5.1",
-    "tsx": "^4.23.13",
+    "tsx": "^4.23.15",
     "typescript": "^6.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.4"
   },
   "overrides": {
     "esbuild": "^0.28.1"