@countrystatecity/cli 0.1.2 → 0.1.4

package/README.md

@@ -1,5 +1,10 @@
 # @countrystatecity/cli
 
+[![npm](https://img.shields.io/npm/v/@countrystatecity/cli)](https://www.npmjs.com/package/@countrystatecity/cli)
+[![CI](https://github.com/dr5hn/countrystatecity-npm/workflows/Pipeline/badge.svg)](https://github.com/dr5hn/countrystatecity-npm/actions/workflows/ci.yml)
+[![npm downloads](https://img.shields.io/npm/dm/@countrystatecity/cli?label=cli)](https://www.npmjs.com/package/@countrystatecity/cli)
+[![npm downloads](https://img.shields.io/npm/dw/@countrystatecity/cli?label=cli)](https://www.npmjs.com/package/@countrystatecity/cli)
+
 Official CLI for the [Country State City API](https://countrystatecity.in) — search, explore, and generate code from geographic data.
 
 ```bash
@@ -19,6 +24,16 @@ csc search countries
 csc get country IN
 ```
 
+## Global Flags
+
+These flags work on every command:
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--json` | | Output raw JSON instead of formatted tables |
+| `--quiet` | `-q` | Suppress all decorative output (spinners, tips) |
+| `--no-footer` | | Hide the API usage footer after each command |
+
 ## Commands
 
 ### Authentication
@@ -27,7 +42,9 @@ csc get country IN
 csc auth login                # Interactive login with API key
 csc auth login --key <KEY>    # Login with key directly
 csc auth status               # Check current auth status
+csc auth status --json        # Returns { authenticated, key, tier, daily, monthly }
 csc auth logout               # Remove stored API key
+csc auth logout --json        # Returns { success: true }
 ```
 
 ### Search
@@ -42,7 +59,11 @@ csc search countries --json
 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
 
@@ -56,9 +77,12 @@ csc search india
 # Detailed country info (timezones, coordinates, currency, etc.)
 csc get country IN
 csc get country US --json
+csc get country           # Interactive — prompts to pick a country (TTY only)
 
 # Detailed state info
 csc get state IN MH
+csc get state IN MH --json
+csc get state             # Interactive — prompts for country then state (TTY only)
 ```
 
 ### Usage & Billing
@@ -66,9 +90,11 @@ csc get state IN MH
 ```bash
 # View API usage with progress bars
 csc usage
+csc usage --json          # Returns { plan, price, daily, monthly }
 
 # View plans and open pricing page
 csc upgrade
+csc upgrade --json        # Returns { plans, currentPlan }
 ```
 
 ### Code Generation
@@ -88,9 +114,9 @@ csc generate seed --entity countries --format prisma
 csc generate seed -e states -f prisma --country IN
 csc generate seed -e cities -f prisma -c IN -s MH
 
-# Options
+# Options (apply to both dropdown and seed)
 --output <dir>     # Output directory (default: current directory)
---no-typescript    # Generate .jsx instead of .tsx
+--no-typescript    # Generate .jsx instead of .tsx  (dropdown only)
 ```
 
 #### Example: Generated Country Dropdown

package/dist/index.js

@@ -490,7 +490,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 +511,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 +1320,7 @@ async function promptCountry2(countries) {
     }
   });
 }
-async function promptState2(states) {
+async function promptState3(states) {
   return search2({
     message: "Select a state",
     source: (input) => {
@@ -1396,7 +1388,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.2",
+  "version": "0.1.4",
   "description": "Official CLI for the Country State City API - search, explore, and generate code from geographic data",
   "files": [
     "dist",