{"_id":"@cloudparker/easy-country-state-data","_rev":"3-d95636370f3c2418b894550120da121c","name":"@cloudparker/easy-country-state-data","dist-tags":{"latest":"2.0.1"},"versions":{"1.0.0":{"name":"@cloudparker/easy-country-state-data","version":"1.0.0","keywords":[],"license":"ISC","_id":"@cloudparker/easy-country-state-data@1.0.0","dist":{"shasum":"77d5fa5ae25a1b0e61f01233f0d7605332169734","tarball":"https://registry.npmjs.org/@cloudparker/easy-country-state-data/-/easy-country-state-data-1.0.0.tgz","fileCount":5,"integrity":"sha512-CfZpEc6NuyZFJsg6Rso1DeJc71lcyoZqvl9eLsfKhD29nxYoL8CHvZFIUVi/ftZx9xoDgjmZWRYtCKdE0poYEw==","signatures":[{"sig":"MEQCIAnmObITUirKUerg/qErry8AT6h+iEkWWUTMbikYVwwcAiBN1cu424dzXx27DRVp41Y9QwpgVc6ABLbrDqeTX0k8QA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":164215},"main":"dist/index.js","types":"./dist/index.d.ts","_npmUser":{"name":"couldparker.com","email":"cloudparker.com@gmail.com"},"_npmVersion":"10.5.0","description":"Library to provide country's States Name , _id and countryId","directories":{},"_nodeVersion":"20.12.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/easy-country-state-data_1.0.0_1719930087345_0.7690702286974938","host":"s3://npm-registry-packages"}},"1.1.0":{"name":"@cloudparker/easy-country-state-data","version":"1.1.0","keywords":[],"license":"ISC","_id":"@cloudparker/easy-country-state-data@1.1.0","dist":{"shasum":"ebc6d54cb761127272520eacfef082bf24b12bad","tarball":"https://registry.npmjs.org/@cloudparker/easy-country-state-data/-/easy-country-state-data-1.1.0.tgz","fileCount":5,"integrity":"sha512-RXlG4xaL5YrsJ2z6SftR9nyNXeNiKkL+84IiMTu2pD0giKkiPSCOmIyKghDFPclTztOdd6CvZjNkzTeJwuBrOA==","signatures":[{"sig":"MEUCIQDgjLpVMDp4Fivr/tql5FlE9HZ7gpVjOMSO/iX8fIXWNwIgApu4iEIdcdQekdtz9XhE3+qdZFs5R8Ag0/HK7f2zEpA=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":164463},"main":"dist/index.js","types":"./dist/index.d.ts","gitHead":"2c235ee0890f00d24f8205549f12ef261f052d4b","_npmUser":{"name":"couldparker.com","email":"cloudparker.com@gmail.com"},"_npmVersion":"10.5.0","description":"Library to provide country's States Name , _id and countryId","directories":{},"_nodeVersion":"20.12.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/easy-country-state-data_1.1.0_1719931728717_0.7172313716470764","host":"s3://npm-registry-packages"}},"2.0.1":{"name":"@cloudparker/easy-country-state-data","version":"2.0.1","license":"ISC","keywords":[],"description":"Library to provide country's States Name , _id and countryId","main":"dist/index.js","_id":"@cloudparker/easy-country-state-data@2.0.1","gitHead":"eca260b6bdb60ec5d71990ef6612533fa10e6d9c","types":"./dist/index.d.ts","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-n0RygILHCina1+PFLx6kG8JiuYGvrh9FRjLZH9s4rQDe54gXfJu/mMJD6TGW9BPCoHxuNt+8sxQTJmTYEFWaCQ==","shasum":"045a89f29790f979743f66e1f7ba6aa8420408b3","tarball":"https://registry.npmjs.org/@cloudparker/easy-country-state-data/-/easy-country-state-data-2.0.1.tgz","fileCount":5,"unpackedSize":165696,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGMHy3F2ywZqz/v2nnwKqLXoSDzGw3Kc4btXO+6e5AayAiEAtgH2/XrZRkqtnJZdNzuZW9+BKrG9WDd7ZZjgc8SXvrM="}]},"_npmUser":{"name":"couldparker.com","email":"cloudparker.com@gmail.com"},"directories":{},"maintainers":[{"name":"couldparker.com","email":"cloudparker.com@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/easy-country-state-data_2.0.1_1765705576688_0.7657370690854464"},"_hasShrinkwrap":false}},"time":{"created":"2024-07-02T14:21:27.236Z","modified":"2025-12-14T09:46:17.178Z","1.0.0":"2024-07-02T14:21:27.523Z","1.1.0":"2024-07-02T14:48:48.897Z","2.0.1":"2025-12-14T09:46:16.963Z"},"license":"ISC","keywords":[],"description":"Library to provide country's States Name , _id and countryId","maintainers":[{"name":"couldparker.com","email":"cloudparker.com@gmail.com"}],"readme":"# easy-country-state-data\nLibrary to provide state/province data with name, _id, and countryId\n\n## Install \n\n```bash\nnpm i @cloudparker/easy-country-state-data\n```\n\n## CDN install\n\n```html\n<script src=\"https://cdn.jsdelivr.net/gh/paramanandapradhan/easy-country-state-data@main/dist/index.js\"></script>\n```\n\n## Usage\n\n### Node.js / ES Modules\n```js\nimport { getStates, getState } from \"@cloudparker/easy-country-state-data\";\n\n// Get list of states of all countries\ngetStates();\n// Returns: [ { _id: \"US:AK\", name: \"Alaska\", countryId: \"US\" }, ... , { _id: \"IN:AP\", name: \"Andhra Pradesh\", countryId: \"IN\" }, ... ]\n\n// Get list of states of a specific country (e.g., India)\ngetStates('IN');\n// Returns: [ { _id: \"IN:AP\", name: \"Andhra Pradesh\", countryId: \"IN\" }, ... ]\n\n// Get a specific state by ID\ngetState('IN:AP');\n// Returns: { _id: \"IN:AP\", name: \"Andhra Pradesh\", countryId: \"IN\" }\n\n// Get state with invalid or missing ID\ngetState();\n// Returns: null\n```\n\n### Browser\n```html\n<script src=\"https://cdn.jsdelivr.net/gh/paramanandapradhan/easy-country-state-data@main/dist/index.js\"></script>\n\n<script>\n// Get list of states of all countries\nEasyCountryStateData.getStates();\n// Returns: [ { _id: \"US:AK\", name: \"Alaska\", countryId: \"US\" }, ... , { _id: \"IN:AP\", name: \"Andhra Pradesh\", countryId: \"IN\" }, ... ]\n\n// Get list of states of a specific country (e.g., India)\nEasyCountryStateData.getStates('IN');\n// Returns: [ { _id: \"IN:AP\", name: \"Andhra Pradesh\", countryId: \"IN\" }, ... ]\n\n// Get a specific state by ID\nEasyCountryStateData.getState('IN:AP');\n// Returns: { _id: \"IN:AP\", name: \"Andhra Pradesh\", countryId: \"IN\" }\n</script>\n```\n\n## API\n\n### `getStates(countryId?: string): State[]`\nReturns an array of states. If `countryId` is provided, returns only states for that country.\n\n### `getState(stateId?: string): State | null`\nReturns a single state object by state ID, or `null` if not found or no ID provided.\n\n### `State` Type\n```typescript\n{\n    _id: string;        // Unique state identifier (e.g., \"IN:AP\")\n    name: string;       // State/province name (e.g., \"Andhra Pradesh\")\n    countryId: string;  // Country identifier (e.g., \"IN\")\n}\n```\n","readmeFilename":"readme.md"}