@profullstack/nichedb 0.31.0 → 0.33.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/nichedb",
-  "version": "0.31.0",
+  "version": "0.33.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.33.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,47 @@ 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: 'tlds',
+    usage: 'tlds [<query>] [--registrar <slug>] [--type <t>] [--max-renew <n>] [--trap] [--sort …]',
+    summary:
+      "Top-level domains with each one's cheapest register, renew and transfer price, renewal first.",
+    options: [
+      '--registrar <porkbun|dynadot|cloudflare|ovh>',
+      '--type <generic|country-code|…>',
+      '--max-renew <n>',
+      '--max-register <n>',
+      '--trap (renews at 2x the first year or more)',
+      '--idn / --no-idn',
+      '--status <delegated|removed|all>',
+      '--sort <renew|register|transfer|ratio|tld|registrars|first_seen>',
+      '--order <asc|desc>',
+      '--limit',
+      '--csv',
+      '--json',
+    ],
+  },
+  {
+    name: 'tld',
+    usage: 'tld <tld> | tld changes',
+    summary:
+      'One top-level domain: registry, RDAP server and every registrar price; or what changed in the root.',
+    options: ['--json'],
+  },
+  {
+    name: 'check',
+    usage: 'check <name> [--tlds com,dev,io]',
+    summary:
+      'Is a domain name registered? Asks the registry over RDAP; a bare word is tried under each ending.',
+    options: ['--tlds <list>', '--json'],
+  },
   {
     name: 'profiles',
     usage: 'profiles [<query>] [--since <iso>] [--mine]',
@@ -740,6 +781,176 @@ 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 'tlds': {
+      const qs = new URLSearchParams();
+      const term = rest.join(' ');
+      if (term) qs.set('q', term);
+      for (const [flag, param] of [
+        ['registrar', 'registrar'],
+        ['type', 'type'],
+        ['maxRenew', 'max_renew'],
+        ['maxRegister', 'max_register'],
+        ['status', 'status'],
+        ['sort', 'sort'],
+        ['order', 'order'],
+        ['limit', 'limit'],
+        ['offset', 'offset'],
+        ['manager', 'manager'],
+        ['band', 'band'],
+      ])
+        if (flags[flag] !== undefined && flags[flag] !== true) qs.set(param, flags[flag]);
+      if (flags.trap) qs.set('trap', '1');
+      if (flags.idn) qs.set('idn', '1');
+      if (flags.noIdn) qs.set('idn', '0');
+      if (flags.csv) {
+        qs.set('format', 'csv');
+        const res = await fetchImpl(`${api}/api/v1/tlds?${qs}`);
+        out((await res.text()).trimEnd());
+        return 0;
+      }
+      const r = await client.get(`/api/v1/tlds?${qs}`);
+      if (json) {
+        out(JSON.stringify(r, null, 2));
+        return 0;
+      }
+      const m = (p) =>
+        p ? `${p.amount.toFixed(2)} ${p.currency === 'USD' ? '' : p.currency}`.trim() : '-';
+      out(
+        `${pad('TLD', 22)} ${pad('REGISTER', 10)} ${pad('RENEW', 10)} ${pad('x', 5)} ${pad('TRANSFER', 10)} ${pad('CHEAPEST RENEWAL AT', 22)} REGISTRY`,
+      );
+      for (const t of r.tlds) {
+        out(
+          `${pad(`.${t.unicode ?? t.tld}`, 22)} ${pad(m(t.best?.register), 10)} ${pad(m(t.best?.renew), 10)} ${pad(t.renewal_ratio ? `${t.renewal_ratio}x` : '', 5)} ${pad(m(t.best?.transfer), 10)} ${pad(t.best?.renew?.registrar_name ?? '', 22)} ${t.manager ?? ''}`,
+        );
+      }
+      out(`(${r.tlds.length} of ${r.total}${r.compare_currency ? '; cheapest in USD' : ''})`);
+      return 0;
+    }
+    case 'tld': {
+      const [arg] = rest;
+      if (!arg) throw new Error('tld <tld> | tld changes');
+      if (arg === 'changes') {
+        const r = await client.get('/api/v1/tlds/changes');
+        if (json) {
+          out(JSON.stringify(r.changes, null, 2));
+          return 0;
+        }
+        for (const c of r.changes)
+          out(
+            `${when(c.at)}  ${pad(c.change, 8)} .${pad(c.unicode ?? c.tld, 24)} ${c.list_version ?? ''}`,
+          );
+        if (!r.changes.length) out('(no changes since tracking began)');
+        return 0;
+      }
+      const t = await client.get(`/api/v1/tlds/${encodeURIComponent(arg.replace(/^\./, ''))}`);
+      if (json) {
+        out(JSON.stringify(t, null, 2));
+        return 0;
+      }
+      out(`.${t.unicode ?? t.tld}${t.unicode ? ` (${t.tld})` : ''}  ${t.status}  ${t.type ?? ''}`);
+      out(`registry  ${t.manager ?? '-'}`);
+      out(`rdap      ${t.rdap ?? 'none published'}`);
+      out('');
+      out(
+        `${pad('REGISTRAR', 24)} ${pad('CUR', 4)} ${pad('REGISTER', 10)} ${pad('RENEW', 10)} ${pad('TRANSFER', 10)} RESTORE`,
+      );
+      const f = (v) => (v === null || v === undefined ? '-' : Number(v).toFixed(2));
+      for (const p of t.prices)
+        out(
+          `${pad(p.registrar_name, 24)} ${pad(p.currency, 4)} ${pad(f(p.register), 10)} ${pad(f(p.renew), 10)} ${pad(f(p.transfer), 10)} ${f(p.restore)}`,
+        );
+      if (!t.prices.length) out('(no registrar read here sells it)');
+      out(`\n${t.page}`);
+      return 0;
+    }
+    case 'check': {
+      const name = rest.join(',');
+      if (!name) throw new Error('check <name> [--tlds com,dev,io]');
+      const qs = new URLSearchParams({ name });
+      if (flags.tlds && flags.tlds !== true) qs.set('tlds', flags.tlds);
+      const r = await client.get(`/api/v1/tlds/check?${qs}`);
+      if (json) {
+        out(JSON.stringify(r, null, 2));
+        return 0;
+      }
+      const word = {
+        registered: 'taken',
+        not_registered: 'not registered',
+        unknown: 'unknown',
+        invalid: 'invalid',
+      };
+      for (const x of r.results) {
+        const detail =
+          x.status === 'registered'
+            ? `${x.registrar ?? ''}${x.expires ? `, expires ${String(x.expires).slice(0, 10)}` : ''}`
+            : x.status === 'not_registered'
+              ? x.cheapest?.register
+                ? `from ${x.cheapest.register.amount.toFixed(2)} at ${x.cheapest.register.registrar_name}, renews ${x.cheapest.renew?.amount?.toFixed(2) ?? '?'}`
+                : ''
+              : (x.reason ?? '');
+        out(`${pad(x.name, 32)} ${pad(word[x.status] ?? x.status, 15)} ${detail}`);
+      }
+      if (r.truncated) out('(only the first names were checked)');
+      return 0;
+    }
     case 'profiles': {
       const term = rest.join(' ');
       const qs = new URLSearchParams();