@countrystatecity/cli 0.1.3 → 0.1.5

package/README.md

@@ -55,11 +55,18 @@ csc search countries
 csc search countries --filter "united"
 csc search countries --json
 
+# List all states globally
+csc search states
+
 # List states for a country
 csc search states --country IN
 csc search states -c US --filter "new"
 
-# List cities for a state
+# List all cities for a country
+csc search cities --country IN
+csc search cities --country IN --json
+
+# List cities for a specific state
 csc search cities --country IN --state MH
 csc search cities -c US -s CA --json
 

package/dist/index.js

@@ -449,28 +449,25 @@ function registerSearchCommands(program2) {
     }
     printUsageFooter(usage, flags);
   });
-  search3.command("states").description("List states for a country").option("-c, --country <iso2>", "Country ISO2 code").option("--filter <text>", "Filter by name").action(async (options, cmd) => {
+  search3.command("states").description("List states for a country, or all states globally").option("-c, --country <iso2>", "Country ISO2 code (omit to get all states globally)").option("--filter <text>", "Filter by name").action(async (options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const flags = {
       json: globalOpts.json ?? false,
       quiet: globalOpts.quiet ?? false,
       noFooter: globalOpts.footer === false
     };
-    let code = options.country?.toUpperCase();
-    if (!code) {
-      if (isTTY()) {
-        const countrySpinner = await createSpinner("Loading countries...", flags);
-        const { data: allCountries } = await get("/countries");
-        countrySpinner.stop();
-        code = await promptCountry(allCountries);
-      } else {
-        process.stderr.write(chalk5.red("Country code required. Use --country IN\n"));
-        process.exit(1);
-        return;
-      }
+    const code = options.country?.toUpperCase();
+    let endpoint;
+    let spinnerText;
+    if (code) {
+      endpoint = `/countries/${code}/states`;
+      spinnerText = `Fetching states for ${code}...`;
+    } else {
+      endpoint = "/states";
+      spinnerText = "Fetching all states...";
     }
-    const spinner = await createSpinner(`Fetching states for ${code}...`, flags);
-    const { data, usage } = await get(`/countries/${code}/states`);
+    const spinner = await createSpinner(spinnerText, flags);
+    const { data, usage } = await get(endpoint);
     spinner.stop();
     let states = data;
     if (options.filter) {
@@ -490,7 +487,7 @@ function registerSearchCommands(program2) {
     }
     printUsageFooter(usage, flags);
   });
-  search3.command("cities").description("List cities for a state").option("-c, --country <iso2>", "Country ISO2 code").option("-s, --state <iso2>", "State ISO2 code").option("--filter <text>", "Filter by name").action(
+  search3.command("cities").description("List cities for a country or state").option("-c, --country <iso2>", "Country ISO2 code").option("-s, --state <iso2>", "State ISO2 code (omit to get all cities in the country)").option("--filter <text>", "Filter by name").action(
     async (options, cmd) => {
       const globalOpts = cmd.optsWithGlobals();
       const flags = {
@@ -511,26 +508,18 @@ function registerSearchCommands(program2) {
           return;
         }
       }
-      let stateCode = options.state?.toUpperCase();
-      if (!stateCode) {
-        if (isTTY()) {
-          const stateSpinner = await createSpinner(`Loading states for ${countryCode}...`, flags);
-          const { data: allStates } = await get(`/countries/${countryCode}/states`);
-          stateSpinner.stop();
-          stateCode = await promptState(allStates);
-        } else {
-          process.stderr.write(chalk5.red("State code required. Use --state MH\n"));
-          process.exit(1);
-          return;
-        }
+      const stateCode = options.state?.toUpperCase();
+      let endpoint;
+      let spinnerText;
+      if (stateCode) {
+        endpoint = `/countries/${countryCode}/states/${stateCode}/cities`;
+        spinnerText = `Fetching cities for ${countryCode}/${stateCode}...`;
+      } else {
+        endpoint = `/countries/${countryCode}/cities`;
+        spinnerText = `Fetching all cities for ${countryCode}...`;
       }
-      const spinner = await createSpinner(
-        `Fetching cities for ${countryCode}/${stateCode}...`,
-        flags
-      );
-      const { data, usage } = await get(
-        `/countries/${countryCode}/states/${stateCode}/cities`
-      );
+      const spinner = await createSpinner(spinnerText, flags);
+      const { data, usage } = await get(endpoint);
       spinner.stop();
       let cities = data;
       if (options.filter) {
@@ -1328,7 +1317,7 @@ async function promptCountry2(countries) {
     }
   });
 }
-async function promptState2(states) {
+async function promptState3(states) {
   return search2({
     message: "Select a state",
     source: (input) => {
@@ -1396,7 +1385,7 @@ async function runExploreSession(flags) {
     stderr(`No states found for ${countryIso}.`);
     return latestUsage;
   }
-  const stateIso = await promptState2(states);
+  const stateIso = await promptState3(states);
   const selectedState = states.find((s) => s.iso2 === stateIso);
   const stateName = selectedState?.name ?? stateIso;
   let running = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@countrystatecity/cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Official CLI for the Country State City API - search, explore, and generate code from geographic data",
   "files": [
     "dist",