latinfo 0.3.0 → 0.4.1

package/dist/index.js

@@ -9,10 +9,19 @@ const http_1 = __importDefault(require("http"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const child_process_1 = require("child_process");
+const VERSION = '0.4.1';
 const API_URL = process.env.LATINFO_API_URL || 'https://api.latinfo.dev';
-const GITHUB_CLIENT_ID = 'Ov23li5fcQaiCsVtaMKK';
+const GITHUB_CLIENT_ID = process.env.GITHUB_CLIENT_ID || 'Ov23li5fcQaiCsVtaMKK';
 const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.latinfo');
 const CONFIG_FILE = path_1.default.join(CONFIG_DIR, 'config.json');
+// --- JSON mode ---
+const jsonFlag = process.argv.includes('--json');
+const liveFlag = process.argv.includes('--live');
+const rawArgs = process.argv.slice(2).filter(a => a !== '--json' && a !== '--live');
+function jsonError(error, message) {
+    process.stderr.write(JSON.stringify({ error, message }) + '\n');
+    process.exit(1);
+}
 function loadConfig() {
     try {
         return JSON.parse(fs_1.default.readFileSync(CONFIG_FILE, 'utf-8'));
@@ -58,6 +67,30 @@ async function waitForCallback(port) {
         setTimeout(() => { server.close(); reject(new Error('Timeout waiting for authorization')); }, 120_000);
     });
 }
+function requireAuth() {
+    const config = loadConfig();
+    if (!config) {
+        if (jsonFlag)
+            jsonError('auth_required', 'Not logged in. Run: latinfo login');
+        console.error('Not logged in. Run: latinfo login');
+        process.exit(1);
+    }
+    return config;
+}
+async function apiRequest(config, path) {
+    const res = await fetch(`${API_URL}${path}`, {
+        headers: { Authorization: `Bearer ${config.api_key}` },
+    });
+    if (!res.ok) {
+        const err = await res.json();
+        if (jsonFlag)
+            jsonError(err.error, err.message || err.error);
+        console.error(err.message || err.error);
+        process.exit(1);
+    }
+    return res;
+}
+// --- Commands ---
 async function login() {
     const port = 8400;
     const redirectUri = `http://localhost:${port}/callback`;
@@ -65,9 +98,7 @@ async function login() {
     const authUrl = `https://github.com/login/oauth/authorize?client_id=${GITHUB_CLIENT_ID}&redirect_uri=${encodeURIComponent(redirectUri)}&scope=${scope}`;
     console.log('Opening GitHub...');
     openBrowser(authUrl);
-    // 1. Wait for GitHub to redirect back with code
     const code = await waitForCallback(port);
-    // 2. Exchange code for access token (server-side, needs client_secret)
     const authRes = await fetch(`${API_URL}/auth/github`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
@@ -81,136 +112,278 @@ async function login() {
     saveConfig({ api_key: authData.api_key, github_username: authData.github_username });
     console.log(`Logged in as ${authData.github_username}`);
 }
-// --- Commands ---
 async function ruc(rucNumber) {
-    const config = loadConfig();
-    if (!config) {
-        console.error('Not logged in. Run: latinfo login');
-        process.exit(1);
-    }
-    if (!/^\d{11}$/.test(rucNumber)) {
+    const config = requireAuth();
+    if (!rucNumber || !/^\d{11}$/.test(rucNumber)) {
+        if (jsonFlag)
+            jsonError('invalid_input', 'Invalid RUC. Must be 11 digits.');
         console.error('Invalid RUC. Must be 11 digits.');
         process.exit(1);
     }
-    const res = await fetch(`${API_URL}/pe/ruc/${rucNumber}`, {
-        headers: { Authorization: `Bearer ${config.api_key}` },
-    });
-    if (!res.ok) {
-        const err = await res.json();
-        console.error(err.message || err.error);
-        process.exit(1);
-    }
+    const res = await apiRequest(config, `/pe/ruc/${rucNumber}`);
     const data = await res.json();
+    if (jsonFlag) {
+        console.log(JSON.stringify(data));
+        return;
+    }
     console.log(`
   RUC:           ${data.ruc}
-  Razón Social:  ${data.razonSocial}
+  Razón Social:  ${data.razon_social}
   Estado:        ${data.estado}
   Condición:     ${data.condicion}
   Ubigeo:        ${data.ubigeo}
-  Dirección:     ${[data.tipoVia, data.nombreVia, data.numero].filter(v => v && v !== '-').join(' ')}
-  Zona:          ${[data.codigoZona, data.tipoZona].filter(v => v && v !== '-').join(' ')}
+  Dirección:     ${[data.tipo_via, data.nombre_via, data.numero].filter(v => v && v !== '-').join(' ')}
+  Zona:          ${[data.codigo_zona, data.tipo_zona].filter(v => v && v !== '-').join(' ')}
   `.trim());
 }
 async function dni(dniNumber) {
-    const config = loadConfig();
-    if (!config) {
-        console.error('Not logged in. Run: latinfo login');
-        process.exit(1);
-    }
-    if (!/^\d{8}$/.test(dniNumber)) {
+    const config = requireAuth();
+    if (!dniNumber || !/^\d{8}$/.test(dniNumber)) {
+        if (jsonFlag)
+            jsonError('invalid_input', 'Invalid DNI. Must be 8 digits.');
         console.error('Invalid DNI. Must be 8 digits.');
         process.exit(1);
     }
-    const res = await fetch(`${API_URL}/pe/dni/${dniNumber}`, {
-        headers: { Authorization: `Bearer ${config.api_key}` },
-    });
-    if (!res.ok) {
-        const err = await res.json();
-        console.error(err.message || err.error);
-        process.exit(1);
-    }
+    const res = await apiRequest(config, `/pe/dni/${dniNumber}`);
     const data = await res.json();
+    if (jsonFlag) {
+        console.log(JSON.stringify(data));
+        return;
+    }
     console.log(`
-  DNI:           ${data.dni}
   RUC:           ${data.ruc}
-  Razón Social:  ${data.razonSocial}
+  Razón Social:  ${data.razon_social}
   Estado:        ${data.estado}
   Condición:     ${data.condicion}
   Ubigeo:        ${data.ubigeo}
-  Dirección:     ${[data.tipoVia, data.nombreVia, data.numero].filter(v => v && v !== '-').join(' ')}
-  Zona:          ${[data.codigoZona, data.tipoZona].filter(v => v && v !== '-').join(' ')}
+  Dirección:     ${[data.tipo_via, data.nombre_via, data.numero].filter(v => v && v !== '-').join(' ')}
+  Zona:          ${[data.codigo_zona, data.tipo_zona].filter(v => v && v !== '-').join(' ')}
   `.trim());
 }
 async function search(query) {
-    const config = loadConfig();
-    if (!config) {
-        console.error('Not logged in. Run: latinfo login');
+    const config = requireAuth();
+    if (!query) {
+        if (jsonFlag)
+            jsonError('invalid_input', 'Search query is required.');
+        console.error('Search query is required.');
         process.exit(1);
     }
-    const res = await fetch(`${API_URL}/pe/search?q=${encodeURIComponent(query)}`, {
-        headers: { Authorization: `Bearer ${config.api_key}` },
+    const res = await apiRequest(config, `/pe/search?q=${encodeURIComponent(query)}`);
+    const results = await res.json();
+    if (jsonFlag) {
+        console.log(JSON.stringify(results));
+        return;
+    }
+    if (results.length === 0) {
+        console.log('No results found.');
+        return;
+    }
+    for (const r of results) {
+        console.log(`  ${r.ruc}  ${r.razon_social}  [${r.estado}]`);
+    }
+    console.log(`\n${results.length} result(s)`);
+}
+function whoami() {
+    const config = requireAuth();
+    if (jsonFlag) {
+        console.log(JSON.stringify({ username: config.github_username, api_key: config.api_key }));
+        return;
+    }
+    console.log(config.github_username);
+}
+function plan() {
+    const config = requireAuth();
+    if (jsonFlag) {
+        console.log(JSON.stringify({ plan: 'free', limit: '1M requests/month' }));
+        return;
+    }
+    console.log(`
+  User:   ${config.github_username}
+  Plan:   free
+  Limit:  1M requests/month
+  `.trim());
+}
+function calcCf(requests) {
+    if (requests <= 3_000_000)
+        return { cost: 0, tier: 'free' };
+    if (requests <= 10_000_000)
+        return { cost: 5, tier: 'paid' };
+    return { cost: 5 + Math.ceil((requests - 10_000_000) / 1_000_000) * 0.50, tier: 'paid' };
+}
+function printCosts(data) {
+    if (jsonFlag) {
+        console.log(JSON.stringify(data));
+        return;
+    }
+    const fmt = (n) => n.toLocaleString();
+    const fmtMoney = (n) => `$${n.toFixed(2)}`;
+    console.log(`
+  ${data.month ? `Month:         ${data.month}\n  ` : ''}Users:         ${fmt(data.users)}
+  Pro users:     ${fmt(data.pro_users)}
+  Requests:      ${fmt(data.requests)}/month
+
+  CF tier:       ${data.cf_tier}
+  CF cost:       ${fmtMoney(data.cf_cost)}/month
+  Revenue:       ${fmtMoney(data.revenue)}/month
+  Margin:        ${data.margin >= 0 ? '+' : ''}${fmtMoney(data.margin)}/month
+
+  Status:        ${data.safe ? 'SAFE' : 'DEFICIT'}
+  `.trim());
+}
+async function costsLive() {
+    const adminSecret = process.env.LATINFO_ADMIN_SECRET;
+    if (!adminSecret) {
+        if (jsonFlag)
+            jsonError('missing_secret', 'Set LATINFO_ADMIN_SECRET env var.');
+        console.error('Set LATINFO_ADMIN_SECRET env var.');
+        process.exit(1);
+    }
+    const res = await fetch(`${API_URL}/admin/stats`, {
+        headers: { Authorization: `Bearer ${adminSecret}` },
     });
     if (!res.ok) {
         const err = await res.json();
+        if (jsonFlag)
+            jsonError(err.error, err.message || err.error);
         console.error(err.message || err.error);
         process.exit(1);
     }
     const data = await res.json();
-    if (data.count === 0) {
-        console.log('No results found.');
-        return;
-    }
-    for (const r of data.results) {
-        console.log(`  ${r.ruc}  ${r.razonSocial}  [${r.estado}]`);
-    }
-    console.log(`\n${data.count} result(s)`);
+    printCosts(data);
 }
-function whoami() {
-    const config = loadConfig();
-    if (!config) {
-        console.error('Not logged in. Run: latinfo login');
+function costsSimulate(usersStr, rpmStr, proPctStr) {
+    const users = parseInt(usersStr);
+    const avgRpm = parseInt(rpmStr || '1000');
+    const proPct = parseFloat(proPctStr || '1');
+    if (!users || users < 0) {
+        if (jsonFlag)
+            jsonError('invalid_input', 'Usage: latinfo costs <users> [avg_req/user/month] [pro_%]');
+        console.error('Usage: latinfo costs <users> [avg_req/user/month] [pro_%]');
         process.exit(1);
     }
-    console.log(config.github_username);
+    const requests = users * avgRpm;
+    const proUsers = Math.floor(users * proPct / 100);
+    const revenue = proUsers * 1;
+    const { cost: cfCost, tier: cfTier } = calcCf(requests);
+    const margin = revenue - cfCost;
+    printCosts({ users, pro_users: proUsers, requests, cf_tier: cfTier, cf_cost: cfCost, revenue, margin, safe: margin >= 0 });
 }
 function logout() {
     deleteConfig();
     console.log('Logged out.');
 }
 function help() {
-    console.log(`
-  latinfo - Public data API for Latin America
-
-  Commands:
-    login                 Authenticate with GitHub
-    logout                Sign out
-    whoami                Show current user
-    ruc <ruc>             Lookup by RUC (11 digits)
-    dni <dni>             Lookup by DNI (8 digits)
-    search <query>        Search by business name
-    help                  Show this help
-  `.trim());
+    console.log(`latinfo v${VERSION} — Public data API for Latin America
+
+API base: ${API_URL}
+
+USAGE
+  latinfo <command> [args] [--json]
+
+COMMANDS
+  login
+    Authenticate via GitHub OAuth. Opens a browser, waits for callback
+    on localhost:8400, and stores the API key in ~/.latinfo/config.json.
+
+  logout
+    Remove stored credentials from ~/.latinfo/config.json.
+
+  whoami
+    Show the authenticated GitHub username.
+    Output fields (--json): username, api_key
+
+  plan
+    Show current plan and limits.
+    Output fields (--json): plan, limit
+
+  ruc <ruc>
+    Lookup a Peruvian taxpayer by RUC (11 digits).
+    Output fields (--json): ruc, razon_social, estado, condicion,
+      ubigeo, tipo_via, nombre_via, numero, codigo_zona, tipo_zona,
+      departamento, provincia, distrito, direccion_completa, tipo_contribuyente
+
+  dni <dni>
+    Lookup a Peruvian taxpayer by DNI (8 digits). Finds the RUC
+    associated with the person and returns the same fields as 'ruc'.
+    Output fields (--json): same as ruc
+
+  search <query>
+    Search taxpayers by business name (razón social). Returns an array.
+    Output fields (--json): array of objects with same fields as ruc
+
+  costs <users> [avg_req] [pro_%]
+    Simulate Cloudflare cost vs revenue. Defaults: 1000 req/user, 1% Pro.
+    Output fields (--json): users, pro_users, requests, cf_tier,
+      cf_cost, revenue, margin, safe
+
+  costs --live
+    Real-time cost report from production data (admin only).
+    Requires LATINFO_ADMIN_SECRET env var.
+    Output fields (--json): month, users, pro_users, requests,
+      cf_tier, cf_cost, revenue, margin, safe
+
+  help
+    Show this help text.
+
+FLAGS
+  --json    Output raw JSON instead of human-formatted text.
+            Errors are written to stderr as {"error":"...","message":"..."}.
+  --live    Use real-time production data (for 'costs' command).
+  --version, -v
+            Print version and exit.
+
+COUNTRIES
+  pe        Peru (SUNAT padrón). Active and available.
+
+AUTH
+  Run 'latinfo login' to authenticate with GitHub. This opens your
+  browser for OAuth, then stores your API key locally. All data
+  commands (ruc, dni, search) require authentication.
+
+  Config file: ~/.latinfo/config.json
+  Environment: LATINFO_API_URL to override API base URL.
+
+EXIT CODES
+  0  Success
+  1  Error (invalid input, auth failure, API error)`);
+}
+function version() {
+    console.log(`latinfo/${VERSION}`);
 }
 // --- Main ---
-const [command, ...args] = process.argv.slice(2);
-switch (command) {
-    case 'login':
-        login().catch(e => { console.error(e); process.exit(1); });
-        break;
-    case 'logout':
-        logout();
-        break;
-    case 'whoami':
-        whoami();
-        break;
-    case 'ruc':
-        ruc(args[0]).catch(e => { console.error(e); process.exit(1); });
-        break;
-    case 'dni':
-        dni(args[0]).catch(e => { console.error(e); process.exit(1); });
-        break;
-    case 'search':
-        search(args.join(' ')).catch(e => { console.error(e); process.exit(1); });
-        break;
-    default: help();
+const [command, ...args] = rawArgs;
+if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
+    version();
+}
+else {
+    switch (command) {
+        case 'login':
+            login().catch(e => { console.error(e); process.exit(1); });
+            break;
+        case 'logout':
+            logout();
+            break;
+        case 'whoami':
+            whoami();
+            break;
+        case 'plan':
+            plan();
+            break;
+        case 'costs':
+            (liveFlag ? costsLive() : Promise.resolve(costsSimulate(args[0], args[1], args[2]))).catch(e => { console.error(e); process.exit(1); });
+            break;
+        case 'ruc':
+            ruc(args[0]).catch(e => { console.error(e); process.exit(1); });
+            break;
+        case 'dni':
+            dni(args[0]).catch(e => { console.error(e); process.exit(1); });
+            break;
+        case 'search':
+            search(args.join(' ')).catch(e => { console.error(e); process.exit(1); });
+            break;
+        case 'help':
+            help();
+            break;
+        default: help();
+    }
 }

package/dist/sdk.d.ts

@@ -1,13 +1,13 @@
-interface RucResult {
+export interface PeRecord {
     ruc: string;
-    razonSocial: string;
+    razon_social: string;
     estado: string;
     condicion: string;
     ubigeo: string;
-    tipoVia: string;
-    nombreVia: string;
-    codigoZona: string;
-    tipoZona: string;
+    tipo_via: string;
+    nombre_via: string;
+    codigo_zona: string;
+    tipo_zona: string;
     numero: string;
     interior: string;
     lote: string;
@@ -15,19 +15,6 @@ interface RucResult {
     manzana: string;
     kilometro: string;
 }
-interface DniResult extends RucResult {
-    dni: string;
-}
-interface SearchResult {
-    ruc: string;
-    razonSocial: string;
-    estado: string;
-    condicion: string;
-}
-interface SearchResponse {
-    count: number;
-    results: SearchResult[];
-}
 declare class Country {
     private request;
     private prefix;
@@ -36,9 +23,9 @@ declare class Country {
 }
 declare class Peru extends Country {
     constructor(request: <T>(path: string) => Promise<T>);
-    ruc(ruc: string): Promise<RucResult>;
-    dni(dni: string): Promise<DniResult>;
-    search(query: string): Promise<SearchResponse>;
+    ruc(ruc: string): Promise<PeRecord>;
+    dni(dni: string): Promise<PeRecord>;
+    search(query: string): Promise<PeRecord[]>;
 }
 export declare class Latinfo {
     private apiKey;

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "latinfo",
-  "version": "0.3.0",
-  "description": "Public data API for Latin America - SDK & CLI",
+  "version": "0.4.1",
+  "description": "CLI & SDK to query RUC, DNI, and business data from SUNAT Peru. JSON output, AI-friendly.",
+  "keywords": ["ruc", "sunat", "peru", "dni", "api", "cli", "tax", "taxpayer", "consulta", "padron", "latin-america", "latam", "json"],
   "main": "dist/sdk.js",
   "types": "dist/sdk.d.ts",
   "bin": {