@profullstack/nichedb 0.31.0 → 0.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/nichedb",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "CLI and MCP bridge for NicheDB: browse collections, manage sources and feeds, search items, from any deployment",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -15,7 +15,7 @@ import { homedir, tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
 
-export const VERSION = '0.31.0';
+export const VERSION = '0.32.0';
 const GEO_FLAGS = ['lat', 'long', 'radius', 'unit', 'bbox', 'sort', 'offset'];
 const DEFAULT_API = process.env.NICHEDB_API ?? 'https://nichedb.dev';
 const CONFIG_DIR = join(process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config'), 'nichedb');
@@ -182,6 +182,13 @@ export const COMMANDS = [
     summary: 'Print the RSS URL (or the feed itself with --fetch).',
     options: ['--fetch'],
   },
+  {
+    name: 'population',
+    usage: 'population [<country> [<state> [<city>]]] | zip <zip> | find <name>',
+    summary:
+      'Population from the world to the ZIP code: an area, its measures and its largest children.',
+    options: ['--level country|state|city|zip', '--limit', '--offset', '--json'],
+  },
   {
     name: 'profiles',
     usage: 'profiles [<query>] [--since <iso>] [--mine]',
@@ -740,6 +747,64 @@ export async function run(
       out(await res.text());
       return 0;
     }
+    case 'population': {
+      const qs = new URLSearchParams();
+      if (flags.level) qs.set('level', flags.level);
+      if (flags.limit) qs.set('limit', flags.limit);
+      if (flags.offset) qs.set('offset', flags.offset);
+      const people = (n) =>
+        n === null || n === undefined ? '—' : Math.round(n).toLocaleString('en-US');
+      const [sub, ...args] = rest;
+
+      if (sub === 'find') {
+        const name = args.join(' ');
+        if (!name) throw new Error('population find <name>');
+        const { areas } = await client.get(
+          `/api/v1/population/search?q=${encodeURIComponent(name)}`,
+        );
+        if (json) {
+          out(JSON.stringify(areas, null, 2));
+          return 0;
+        }
+        for (const a of areas)
+          out(`${pad(a.key, 34)} ${pad(a.level, 8)} ${pad(people(a.population), 14)} ${a.title}`);
+        if (areas.length === 0) out('(no place by that name)');
+        return 0;
+      }
+
+      let path = '/api/v1/population';
+      if (sub === 'zip') {
+        if (!args[0]) throw new Error('population zip <zip>');
+        path = `/api/v1/population/zip/${encodeURIComponent(String(args[0]).trim())}`;
+      } else if (sub) {
+        path = `/api/v1/population/${encodeURIComponent(rest.join('-').toLowerCase())}`;
+      }
+      const body = await client.get(`${path}${qs.size ? `?${qs}` : ''}`);
+      if (json) {
+        out(JSON.stringify(body, null, 2));
+        return 0;
+      }
+      if (body.area) {
+        const a = body.area;
+        out(`${a.title}  (${a.key}, ${a.level})`);
+        out(
+          `  ${pad('population', 24)} ${people(a.population)}${a.year ? `  (${a.survey ?? a.year})` : ''}`,
+        );
+        for (const [k, v] of Object.entries(a.measures ?? {})) {
+          if (typeof v === 'number') out(`  ${pad(k, 24)} ${v.toLocaleString('en-US')}`);
+        }
+        out(`  ${a.page}`);
+      }
+      const kids = body.children?.areas ?? body.countries ?? [];
+      const total = body.children?.total ?? body.total ?? kids.length;
+      if (kids.length) {
+        out(
+          `\n${body.children?.level ?? 'country'}: ${kids.length} of ${Number(total).toLocaleString('en-US')}`,
+        );
+        for (const k of kids) out(`  ${pad(k.key, 34)} ${pad(people(k.population), 14)} ${k.name}`);
+      }
+      return 0;
+    }
     case 'profiles': {
       const term = rest.join(' ');
       const qs = new URLSearchParams();