@mohit_dev/india-location-master 0.0.0-stage → 1.0.0

package/data/states.json

@@ -0,0 +1,38 @@
+[
+  { "id": "AN", "name": "Andaman and Nicobar Islands", "type": "Union Territory", "languages": ["Hindi", "English", "Bengali"] },
+  { "id": "AP", "name": "Andhra Pradesh", "type": "State", "languages": ["Telugu"] },
+  { "id": "AR", "name": "Arunachal Pradesh", "type": "State", "languages": ["English", "Hindi"] },
+  { "id": "AS", "name": "Assam", "type": "State", "languages": ["Assamese", "Bodo", "Bengali"] },
+  { "id": "BR", "name": "Bihar", "type": "State", "languages": ["Hindi", "Maithili", "Urdu"] },
+  { "id": "CH", "name": "Chandigarh", "type": "Union Territory", "languages": ["English", "Punjabi", "Hindi"] },
+  { "id": "CG", "name": "Chhattisgarh", "type": "State", "languages": ["Chhattisgarhi", "Hindi"] },
+  { "id": "DN", "name": "Dadra and Nagar Haveli and Daman and Diu", "type": "Union Territory", "languages": ["Gujarati", "Hindi", "Marathi", "Konkani"] },
+  { "id": "DL", "name": "Delhi", "type": "Union Territory", "languages": ["Hindi", "English", "Punjabi", "Urdu"] },
+  { "id": "GA", "name": "Goa", "type": "State", "languages": ["Konkani", "Marathi"] },
+  { "id": "GJ", "name": "Gujarat", "type": "State", "languages": ["Gujarati"] },
+  { "id": "HR", "name": "Haryana", "type": "State", "languages": ["Hindi", "Haryanvi", "Punjabi"] },
+  { "id": "HP", "name": "Himachal Pradesh", "type": "State", "languages": ["Hindi", "Pahari"] },
+  { "id": "JK", "name": "Jammu and Kashmir", "type": "Union Territory", "languages": ["Kashmiri", "Dogri", "Hindi", "Urdu"] },
+  { "id": "JH", "name": "Jharkhand", "type": "State", "languages": ["Hindi", "Santali", "Urdu"] },
+  { "id": "KA", "name": "Karnataka", "type": "State", "languages": ["Kannada"] },
+  { "id": "KL", "name": "Kerala", "type": "State", "languages": ["Malayalam"] },
+  { "id": "LA", "name": "Ladakh", "type": "Union Territory", "languages": ["Ladakhi", "Balti", "Hindi"] },
+  { "id": "LD", "name": "Lakshadweep", "type": "Union Territory", "languages": ["Malayalam", "Mahl"] },
+  { "id": "MP", "name": "Madhya Pradesh", "type": "State", "languages": ["Hindi"] },
+  { "id": "MH", "name": "Maharashtra", "type": "State", "languages": ["Marathi"] },
+  { "id": "MN", "name": "Manipur", "type": "State", "languages": ["Manipuri (Meitei)"] },
+  { "id": "ML", "name": "Meghalaya", "type": "State", "languages": ["English", "Khasi", "Garo"] },
+  { "id": "MZ", "name": "Mizoram", "type": "State", "languages": ["Mizo", "English"] },
+  { "id": "NL", "name": "Nagaland", "type": "State", "languages": ["English"] },
+  { "id": "OD", "name": "Odisha", "type": "State", "languages": ["Odia"] },
+  { "id": "PY", "name": "Puducherry", "type": "Union Territory", "languages": ["Tamil", "Malayalam", "Telugu", "French"] },
+  { "id": "PB", "name": "Punjab", "type": "State", "languages": ["Punjabi"] },
+  { "id": "RJ", "name": "Rajasthan", "type": "State", "languages": ["Hindi", "Rajasthani"] },
+  { "id": "SK", "name": "Sikkim", "type": "State", "languages": ["Nepali", "Sikkimese", "Lepcha"] },
+  { "id": "TN", "name": "Tamil Nadu", "type": "State", "languages": ["Tamil"] },
+  { "id": "TS", "name": "Telangana", "type": "State", "languages": ["Telugu", "Urdu"] },
+  { "id": "TR", "name": "Tripura", "type": "State", "languages": ["Bengali", "Kokborok"] },
+  { "id": "UP", "name": "Uttar Pradesh", "type": "State", "languages": ["Hindi", "Urdu"] },
+  { "id": "UK", "name": "Uttarakhand", "type": "State", "languages": ["Hindi", "Garhwali", "Kumaoni"] },
+  { "id": "WB", "name": "West Bengal", "type": "State", "languages": ["Bengali"] }
+]

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@mohit_dev/india-location-master",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Comprehensive India state, district, and city location data with easy query helper functions and Google Maps style autocomplete suggestions",
+  "main": "src/index.js",
+  "files": [
+    "src/",
+    "data/",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node test.js",
+    "test": "node test.js"
+  },
+  "keywords": [
+    "india",
+    "location",
+    "state",
+    "district",
+    "city",
+    "states",
+    "districts",
+    "cities",
+    "india-data",
+    "pincode",
+    "autocomplete",
+    "suggestions"
+  ],
+  "author": "",
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,268 @@
+const states = require("../data/states.json");
+const districts = require("../data/districts.json");
+const cities = require("../data/cities.json");
+
+// Fast lookup maps for parent context resolution
+const stateMap = new Map(states.map((s) => [s.id, s]));
+const districtMap = new Map(districts.map((d) => [d.id, d]));
+
+/**
+ * Get all States and Union Territories
+ * @returns {Array} List of states
+ */
+function getStates() {
+  return states;
+}
+
+/**
+ * Get Districts for a given State ID or Name
+ * @param {string} [stateId] State ID (e.g., "MP") or State Name (optional)
+ * @returns {Array} List of districts
+ */
+function getDistricts(stateId) {
+  if (!stateId) return districts;
+  const normalized = stateId.trim().toLowerCase();
+  
+  const matchedState = states.find(
+    (s) => s.id.toLowerCase() === normalized || s.name.toLowerCase() === normalized
+  );
+  const targetId = matchedState ? matchedState.id.toLowerCase() : normalized;
+
+  return districts.filter(
+    (district) => district.stateId.toLowerCase() === targetId
+  );
+}
+
+/**
+ * Get Cities for a given District ID or Name
+ * @param {string} [districtId] District ID or District Name (optional)
+ * @returns {Array} List of cities
+ */
+function getCities(districtId) {
+  if (!districtId) return cities;
+  const normalized = districtId.trim().toLowerCase();
+
+  const matchedDistrict = districts.find(
+    (d) => d.id.toLowerCase() === normalized || d.name.toLowerCase() === normalized
+  );
+  const targetId = matchedDistrict ? matchedDistrict.id.toLowerCase() : normalized;
+
+  return cities.filter(
+    (city) => city.districtId.toLowerCase() === targetId
+  );
+}
+
+/**
+ * Get State by Name or ID
+ * @param {string} name State Name or State ID
+ * @returns {Object|null} State object
+ */
+function getStateByName(name) {
+  if (!name) return null;
+  const normalized = name.trim().toLowerCase();
+  return (
+    states.find(
+      (s) =>
+        s.name.toLowerCase() === normalized ||
+        s.id.toLowerCase() === normalized
+    ) || null
+  );
+}
+
+/**
+ * Get District by Name or ID
+ * @param {string} name District Name or ID
+ * @returns {Object|null} District object
+ */
+function getDistrictByName(name) {
+  if (!name) return null;
+  const normalized = name.trim().toLowerCase();
+  return (
+    districts.find(
+      (d) =>
+        d.name.toLowerCase() === normalized ||
+        d.id.toLowerCase() === normalized
+    ) || null
+  );
+}
+
+/**
+ * Search cities by partial name query
+ * @param {string} query Search string
+ * @param {number} [limit=50] Maximum number of results to return
+ * @returns {Array} Array of matching city objects
+ */
+function searchCities(query, limit = 50) {
+  if (!query) return [];
+  const normalized = query.trim().toLowerCase();
+  const results = [];
+  for (let i = 0; i < cities.length; i++) {
+    if (cities[i].name.toLowerCase().includes(normalized)) {
+      results.push(cities[i]);
+      if (results.length >= limit) break;
+    }
+  }
+  return results;
+}
+
+/**
+ * Find locations/cities by PIN code
+ * @param {string|number} pincode 6-digit PIN code
+ * @returns {Array} List of matching city objects
+ */
+function getCitiesByPincode(pincode) {
+  if (!pincode) return [];
+  const pinStr = String(pincode).trim();
+  return cities.filter(
+    (city) => city.pincodes && city.pincodes.includes(pinStr)
+  );
+}
+
+/**
+ * Google Maps style Place Autocomplete / Search Suggestions
+ * Searches across States, Districts, Cities, and PIN codes
+ * @param {string} query User search text (e.g. "mhow", "indore", "453441")
+ * @param {number} [limit=10] Maximum suggestions to return
+ * @returns {Array} Array of suggestion objects formatted for UI dropdowns
+ */
+function getSuggestions(query, limit = 10) {
+  if (!query || typeof query !== "string" || !query.trim()) return [];
+  const normalized = query.trim().toLowerCase();
+  const suggestions = [];
+
+  // 1. Search States
+  for (let i = 0; i < states.length; i++) {
+    const s = states[i];
+    if (s.name.toLowerCase().includes(normalized) || s.id.toLowerCase() === normalized) {
+      suggestions.push({
+        id: s.id,
+        type: "state",
+        name: s.name,
+        state: s.name,
+        stateId: s.id,
+        languages: s.languages || [],
+        displayText: `${s.name} (State)`
+      });
+      if (suggestions.length >= limit) return suggestions;
+    }
+  }
+
+  // 2. Search Districts
+  for (let i = 0; i < districts.length; i++) {
+    const d = districts[i];
+    if (d.name.toLowerCase().includes(normalized)) {
+      const parentState = stateMap.get(d.stateId);
+      const stateName = parentState ? parentState.name : d.stateId;
+      suggestions.push({
+        id: d.id,
+        type: "district",
+        name: d.name,
+        district: d.name,
+        state: stateName,
+        stateId: d.stateId,
+        lat: d.lat || null,
+        lng: d.lng || null,
+        displayText: `${d.name} (District), ${stateName}`
+      });
+      if (suggestions.length >= limit) return suggestions;
+    }
+  }
+
+  // 3. Search Cities / PIN codes
+  for (let i = 0; i < cities.length; i++) {
+    const c = cities[i];
+    const nameMatch = c.name.toLowerCase().includes(normalized);
+    const pinMatch = c.pincodes && c.pincodes.some((pin) => pin.includes(normalized));
+
+    if (nameMatch || pinMatch) {
+      const parentDistrict = districtMap.get(c.districtId);
+      const districtName = parentDistrict ? parentDistrict.name : c.districtId;
+      const stateId = parentDistrict ? parentDistrict.stateId : "";
+      const parentState = stateMap.get(stateId);
+      const stateName = parentState ? parentState.name : stateId;
+
+      const pincodeText = c.pincodes && c.pincodes.length > 0 ? ` - ${c.pincodes.join(", ")}` : "";
+
+      suggestions.push({
+        id: c.id,
+        type: "city",
+        name: c.name,
+        district: districtName,
+        districtId: c.districtId,
+        state: stateName,
+        stateId: stateId,
+        pincodes: c.pincodes || [],
+        lat: c.lat || null,
+        lng: c.lng || null,
+        displayText: `${c.name}, ${districtName}, ${stateName}${pincodeText}`
+      });
+      if (suggestions.length >= limit) return suggestions;
+    }
+  }
+
+  return suggestions;
+}
+
+/**
+ * Get native / official languages for a given State or District
+ * @param {string} locationName State ID, State Name, or District Name
+ * @returns {Array} Array of native/official language names
+ */
+function getLanguages(locationName) {
+  if (!locationName) return [];
+  const normalized = locationName.trim().toLowerCase();
+
+  let state = states.find(
+    (s) => s.id.toLowerCase() === normalized || s.name.toLowerCase() === normalized
+  );
+
+  if (!state) {
+    const district = districts.find(
+      (d) => d.id.toLowerCase() === normalized || d.name.toLowerCase() === normalized
+    );
+    if (district) {
+      state = states.find((s) => s.id.toLowerCase() === district.stateId.toLowerCase());
+    }
+  }
+
+  return state ? state.languages || [] : [];
+}
+
+/**
+ * Get states where a specific language is officially spoken
+ * @param {string} language Language name (e.g., "Hindi", "Marathi", "Tamil")
+ * @returns {Array} List of state objects
+ */
+function getStatesByLanguage(language) {
+  if (!language) return [];
+  const normalized = language.trim().toLowerCase();
+  return states.filter(
+    (s) => s.languages && s.languages.some((l) => l.toLowerCase() === normalized)
+  );
+}
+
+/**
+ * Get complete location dataset
+ * @returns {Object} Object containing states, districts, and cities
+ */
+function getAllLocations() {
+  return {
+    states,
+    districts,
+    cities,
+  };
+}
+
+module.exports = {
+  getStates,
+  getDistricts,
+  getCities,
+  getStateByName,
+  getDistrictByName,
+  searchCities,
+  getCitiesByPincode,
+  getSuggestions,
+  getLanguages,
+  getStatesByLanguage,
+  getAllLocations,
+};