@countrystatecity/cli 0.1.5 → 0.1.7

package/README.md

@@ -64,12 +64,15 @@ csc search states -c US --filter "new"
 
 # 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
 
+# List all world regions (requires Starter plan+)
+csc search regions
+csc search regions --filter "asia"
+
 # Global search (matches country names)
 csc search india
 ```

package/dist/index.js

@@ -74,6 +74,11 @@ async function get(path) {
         console.error(chalk.dim("Run `csc auth login` to set your key."));
         process.exit(1);
       }
+      if (status === 403) {
+        console.error(chalk.red("Access denied \u2014 this endpoint requires a higher plan."));
+        console.error(chalk.dim("Run `csc upgrade` to view available plans."));
+        process.exit(1);
+      }
       if (status === 429) {
         console.error(chalk.red("Daily limit reached."));
         console.error(chalk.yellow("Run `csc upgrade` to increase your limits."));
@@ -417,15 +422,14 @@ function printDetail(label, value) {
 }
 
 // src/commands/search.ts
+function resolveFlags(cmd) {
+  const g = cmd.optsWithGlobals();
+  return { json: g.json ?? false, quiet: g.quiet ?? false, noFooter: g.footer === false };
+}
 function registerSearchCommands(program2) {
-  const search3 = program2.command("search").description("Search countries, states, and cities");
+  const search3 = program2.command("search").description("Search countries, states, cities, and more");
   search3.command("countries").description("List all countries").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
-    };
+    const flags = resolveFlags(cmd);
     const spinner = await createSpinner("Fetching countries...", flags);
     const { data, usage } = await get("/countries");
     spinner.stop();
@@ -437,112 +441,103 @@ function registerSearchCommands(program2) {
     if (flags.json) {
       printJson(countries);
     } else {
-      const rows = countries.map((c) => [
-        c.iso2,
-        c.iso3,
-        c.name,
-        c.capital || "",
-        c.phonecode ? `+${c.phonecode.replace(/^\+/, "")}` : "",
-        c.currency || ""
-      ]);
-      printTable(["ISO2", "ISO3", "Name", "Capital", "Phone", "Currency"], rows);
+      printTable(
+        ["ISO2", "ISO3", "Name", "Capital", "Phone", "Currency"],
+        countries.map((c) => [
+          c.iso2,
+          c.iso3,
+          c.name,
+          c.capital || "",
+          c.phonecode ? `+${c.phonecode.replace(/^\+/, "")}` : "",
+          c.currency || ""
+        ])
+      );
     }
     printUsageFooter(usage, flags);
   });
   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
-    };
+    const flags = resolveFlags(cmd);
     const code = options.country?.toUpperCase();
+    const endpoint = code ? `/countries/${code}/states` : "/states";
+    const spinner = await createSpinner(code ? `Fetching states for ${code}...` : "Fetching all states...", flags);
+    const { data, usage } = await get(endpoint);
+    spinner.stop();
+    let states = data;
+    if (options.filter) {
+      const term = options.filter.toLowerCase();
+      states = states.filter((s) => s.name.toLowerCase().includes(term));
+    }
+    if (flags.json) {
+      printJson(states);
+    } else {
+      printTable(
+        code ? ["ID", "Name", "ISO2", "Type"] : ["ID", "Name", "ISO2", "Type", "Country"],
+        states.map(
+          (s) => code ? [String(s.id), s.name, s.iso2 || "", s.type || ""] : [String(s.id), s.name, s.iso2 || "", s.type || "", s.country_code || ""]
+        )
+      );
+    }
+    printUsageFooter(usage, flags);
+  });
+  search3.command("cities").description("List cities globally, for a country, or for a state").option("-c, --country <iso2>", "Country ISO2 code").option("-s, --state <iso2>", "State ISO2 code").option("--filter <text>", "Filter by name").action(async (options, cmd) => {
+    const flags = resolveFlags(cmd);
+    const countryCode = options.country?.toUpperCase();
+    const stateCode = options.state?.toUpperCase();
     let endpoint;
     let spinnerText;
-    if (code) {
-      endpoint = `/countries/${code}/states`;
-      spinnerText = `Fetching states for ${code}...`;
+    if (countryCode && stateCode) {
+      endpoint = `/countries/${countryCode}/states/${stateCode}/cities`;
+      spinnerText = `Fetching cities for ${countryCode}/${stateCode}...`;
+    } else if (countryCode) {
+      endpoint = `/countries/${countryCode}/cities`;
+      spinnerText = `Fetching all cities for ${countryCode}...`;
     } else {
-      endpoint = "/states";
-      spinnerText = "Fetching all states...";
+      process.stderr.write(chalk5.red("Country code required. Use --country IN\n"));
+      process.stderr.write(chalk5.dim("Use --state MH to filter by state.\n"));
+      process.exit(1);
+      return;
     }
     const spinner = await createSpinner(spinnerText, flags);
     const { data, usage } = await get(endpoint);
     spinner.stop();
-    let states = data;
+    let cities = data;
     if (options.filter) {
       const term = options.filter.toLowerCase();
-      states = states.filter((s) => s.name.toLowerCase().includes(term));
+      cities = cities.filter((c) => c.name.toLowerCase().includes(term));
     }
     if (flags.json) {
-      printJson(states);
+      printJson(cities);
     } else {
-      const rows = states.map((s) => [
-        String(s.id),
-        s.name,
-        s.iso2 || "",
-        s.type || ""
-      ]);
-      printTable(["ID", "Name", "ISO2", "Type"], rows);
+      const hasExtra = !countryCode;
+      printTable(
+        hasExtra ? ["ID", "Name", "State", "Country"] : ["ID", "Name"],
+        cities.map(
+          (c) => hasExtra ? [String(c.id), c.name, c.state_code || "", c.country_code || ""] : [String(c.id), c.name]
+        )
+      );
     }
     printUsageFooter(usage, flags);
   });
-  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 = {
-        json: globalOpts.json ?? false,
-        quiet: globalOpts.quiet ?? false,
-        noFooter: globalOpts.footer === false
-      };
-      let countryCode = options.country?.toUpperCase();
-      if (!countryCode) {
-        if (isTTY()) {
-          const countrySpinner = await createSpinner("Loading countries...", flags);
-          const { data: allCountries } = await get("/countries");
-          countrySpinner.stop();
-          countryCode = await promptCountry(allCountries);
-        } else {
-          process.stderr.write(chalk5.red("Country code required. Use --country IN\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(spinnerText, flags);
-      const { data, usage } = await get(endpoint);
-      spinner.stop();
-      let cities = data;
-      if (options.filter) {
-        const term = options.filter.toLowerCase();
-        cities = cities.filter((c) => c.name.toLowerCase().includes(term));
-      }
-      if (flags.json) {
-        printJson(cities);
-      } else {
-        const rows = cities.map((c) => [String(c.id), c.name]);
-        printTable(["ID", "Name"], rows);
-      }
-      printUsageFooter(usage, flags);
+  search3.command("regions").description("List all world regions").option("--filter <text>", "Filter by name").action(async (options, cmd) => {
+    const flags = resolveFlags(cmd);
+    const spinner = await createSpinner("Fetching regions...", flags);
+    const { data, usage } = await get("/regions");
+    spinner.stop();
+    let regions = data;
+    if (options.filter) {
+      const term = options.filter.toLowerCase();
+      regions = regions.filter((r) => r.name.toLowerCase().includes(term));
     }
-  );
+    if (flags.json) {
+      printJson(regions);
+    } else {
+      printTable(["ID", "Name"], regions.map((r) => [String(r.id), r.name]));
+    }
+    printUsageFooter(usage, flags);
+  });
   search3.argument("[query]", "Search term to match country names").action(async (query, options, cmd) => {
     if (!query) return;
-    const globalOpts = cmd.optsWithGlobals();
-    const flags = {
-      json: globalOpts.json ?? false,
-      quiet: globalOpts.quiet ?? false,
-      noFooter: globalOpts.footer === false
-    };
+    const flags = resolveFlags(cmd);
     const spinner = await createSpinner("Searching...", flags);
     const { data, usage } = await get("/countries");
     spinner.stop();
@@ -553,15 +548,17 @@ function registerSearchCommands(program2) {
     } else if (matches.length === 0) {
       console.log(chalk5.yellow(`No countries matching "${query}".`));
     } else {
-      const rows = matches.map((c) => [
-        c.iso2,
-        c.iso3,
-        c.name,
-        c.capital || "",
-        c.phonecode ? `+${c.phonecode.replace(/^\+/, "")}` : "",
-        c.currency || ""
-      ]);
-      printTable(["ISO2", "ISO3", "Name", "Capital", "Phone", "Currency"], rows);
+      printTable(
+        ["ISO2", "ISO3", "Name", "Capital", "Phone", "Currency"],
+        matches.map((c) => [
+          c.iso2,
+          c.iso3,
+          c.name,
+          c.capital || "",
+          c.phonecode ? `+${c.phonecode.replace(/^\+/, "")}` : "",
+          c.currency || ""
+        ])
+      );
     }
     if (!flags.json) {
       process.stderr.write(
@@ -1317,7 +1314,7 @@ async function promptCountry2(countries) {
     }
   });
 }
-async function promptState3(states) {
+async function promptState2(states) {
   return search2({
     message: "Select a state",
     source: (input) => {
@@ -1385,7 +1382,7 @@ async function runExploreSession(flags) {
     stderr(`No states found for ${countryIso}.`);
     return latestUsage;
   }
-  const stateIso = await promptState3(states);
+  const stateIso = await promptState2(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.5",
+  "version": "0.1.7",
   "description": "Official CLI for the Country State City API - search, explore, and generate code from geographic data",
   "files": [
     "dist",