latinfo 0.6.1 → 0.7.0

package/dist/index.js

@@ -10,7 +10,7 @@ const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const child_process_1 = require("child_process");
 const demo_data_1 = require("./demo-data");
-const VERSION = '0.6.1';
+const VERSION = '0.7.0';
 const API_URL = process.env.LATINFO_API_URL || 'https://api.latinfo.dev';
 const GITHUB_CLIENT_ID = process.env.GITHUB_CLIENT_ID || 'Ov23li5fcQaiCsVtaMKK';
 const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.latinfo');
@@ -391,6 +391,124 @@ function costsSimulate(usersStr, rpmStr, proPctStr) {
     const margin = revenue - cfCost;
     printCosts({ users, pro_users: proUsers, requests, cf_tier: cfTier, cf_cost: cfCost, revenue, margin, safe: margin >= 0 });
 }
+// --- Licitaciones ---
+function parseFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+}
+async function licitaciones(args) {
+    // Parse flags from raw process.argv to avoid them being stripped
+    const allArgs = process.argv.slice(2);
+    const opts = {
+        category: parseFlag(allArgs, '--category') || parseFlag(allArgs, '-c'),
+        minAmount: parseFlag(allArgs, '--min-amount') ? Number(parseFlag(allArgs, '--min-amount')) : undefined,
+        maxAmount: parseFlag(allArgs, '--max-amount') ? Number(parseFlag(allArgs, '--max-amount')) : undefined,
+        buyer: parseFlag(allArgs, '--buyer') || parseFlag(allArgs, '-b'),
+        method: parseFlag(allArgs, '--method') || parseFlag(allArgs, '-m'),
+        status: parseFlag(allArgs, '--status') || parseFlag(allArgs, '-s'),
+        limit: parseFlag(allArgs, '--limit') || parseFlag(allArgs, '-l') ? Number(parseFlag(allArgs, '--limit') || parseFlag(allArgs, '-l')) : undefined,
+    };
+    // Query: everything in args that isn't a flag or flag value
+    const flagNames = ['--category', '-c', '--min-amount', '--max-amount', '--buyer', '-b', '--method', '-m', '--status', '-s', '--limit', '-l', '--json'];
+    const queryParts = [];
+    for (let i = 0; i < args.length; i++) {
+        if (flagNames.includes(args[i])) {
+            i++;
+            continue;
+        } // skip flag + value
+        queryParts.push(args[i]);
+    }
+    if (queryParts.length > 0)
+        opts.query = queryParts.join(' ');
+    // Subcommand: info
+    if (args[0] === 'info') {
+        const config = requireAuth();
+        const res = await apiRequest(config, '/pe/licitaciones/info');
+        const info = await res.json();
+        if (jsonFlag) {
+            console.log(JSON.stringify(info));
+        }
+        else {
+            console.log(`  Records:   ${info.records.toLocaleString()}`);
+        }
+        return;
+    }
+    // Subcommand: help
+    if (args[0] === 'help' || (!opts.query && !opts.category && !opts.buyer && !opts.method && !opts.status && opts.minAmount === undefined && opts.maxAmount === undefined)) {
+        console.log(`latinfo licitaciones — Search Peru government procurement (OECE/SEACE)
+
+USAGE
+  latinfo licitaciones <query> [flags]
+  latinfo licitaciones [flags]
+  latinfo licitaciones info
+  latinfo licitaciones help
+
+EXAMPLES
+  latinfo licitaciones "construccion puente"
+  latinfo licitaciones "servicio alimentacion" --category services
+  latinfo licitaciones --category works --min-amount 1000000
+  latinfo licitaciones --buyer "municipalidad" --limit 5
+  latinfo licitaciones "software" --json
+
+FILTERS
+  --category, -c   goods, services, works
+  --min-amount      Minimum amount in PEN
+  --max-amount      Maximum amount in PEN
+  --buyer, -b       Buyer name (substring match)
+  --method, -m      Procurement method (substring match)
+  --status, -s      Status: CONVOCADO, CONTRATADO, DESIERTO, NULO, CONSENTIDO
+  --limit, -l       Max results (default: 20)
+  --json            JSON output
+
+DATA
+  Source: OECE/SEACE (contratacionesabiertas.oece.gob.pe)
+  License: CC BY 4.0`);
+        return;
+    }
+    const config = requireAuth();
+    // Build query string
+    const params = new URLSearchParams();
+    if (opts.query)
+        params.set('q', opts.query);
+    if (opts.category)
+        params.set('category', opts.category);
+    if (opts.minAmount !== undefined)
+        params.set('min_amount', String(opts.minAmount));
+    if (opts.maxAmount !== undefined)
+        params.set('max_amount', String(opts.maxAmount));
+    if (opts.buyer)
+        params.set('buyer', opts.buyer);
+    if (opts.method)
+        params.set('method', opts.method);
+    if (opts.status)
+        params.set('status', opts.status);
+    if (opts.limit !== undefined)
+        params.set('limit', String(opts.limit));
+    const res = await apiRequest(config, `/pe/licitaciones?${params}`);
+    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) {
+        const monto = parseFloat(r.monto);
+        const montoFmt = monto > 0 ? `S/ ${monto.toLocaleString('es-PE', { minimumFractionDigits: 2 })}` : 'N/A';
+        const fecha = r.fecha?.split('T')[0] || '';
+        const desc = r.descripcion?.length > 100 ? r.descripcion.substring(0, 100) + '...' : (r.descripcion || '');
+        console.log(`  ${fecha}  ${montoFmt}  [${r.categoria}] [${r.estado}]`);
+        console.log(`  ${desc}`);
+        console.log(`  Buyer: ${r.buyer_nombre}`);
+        if (r.url)
+            console.log(`  ${r.url}`);
+        console.log(`  ${r.metodo} — ${r.ocid}`);
+        console.log();
+    }
+    console.log(`${results.length} result(s)`);
+}
 function logout() {
     deleteConfig();
     console.log('Logged out.');
@@ -451,6 +569,16 @@ COMMANDS
     Real-time cost report from production (admin only).
     Requires LATINFO_ADMIN_SECRET env var.
 
+  licitaciones <query> [flags]
+    Search Peru government procurement (OECE/SEACE).
+    Flags: --category, --min-amount, --max-amount, --buyer, --method, --status, --limit
+    Run 'latinfo licitaciones help' for details.
+
+  completion [bash|zsh]
+    Output shell completion script.
+    bash: eval "$(latinfo completion bash)"
+    zsh:  eval "$(latinfo completion zsh)"
+
   help       Show this help text.
 
 FLAGS
@@ -482,6 +610,41 @@ EXIT CODES
 function version() {
     console.log(`latinfo/${VERSION}`);
 }
+function completion() {
+    const shell = rawArgs[1] || 'bash';
+    if (shell === 'zsh') {
+        console.log(`#compdef latinfo
+_latinfo() {
+  local -a commands=(login logout whoami plan costs ruc dni search licitaciones lic help)
+  local -a lic_flags=(--category --min-amount --max-amount --buyer --method --status --limit --json)
+  local -a global_flags=(--json --live --version --token)
+  if (( CURRENT == 2 )); then
+    _describe 'command' commands
+  elif [[ "\${words[2]}" == "licitaciones" || "\${words[2]}" == "lic" ]]; then
+    _describe 'flag' lic_flags
+  else
+    _describe 'flag' global_flags
+  fi
+}
+compdef _latinfo latinfo`);
+    }
+    else {
+        console.log(`_latinfo_completions() {
+  local cur="\${COMP_WORDS[COMP_CWORD]}"
+  local prev="\${COMP_WORDS[1]}"
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "login logout whoami plan costs ruc dni search licitaciones lic help" -- "$cur") )
+  elif [[ "$prev" == "licitaciones" || "$prev" == "lic" ]]; then
+    COMPREPLY=( $(compgen -W "--category --min-amount --max-amount --buyer --method --status --limit --json info help" -- "$cur") )
+  elif [[ "$prev" == "--category" || "$prev" == "-c" ]]; then
+    COMPREPLY=( $(compgen -W "goods services works" -- "$cur") )
+  elif [[ "$prev" == "--status" || "$prev" == "-s" ]]; then
+    COMPREPLY=( $(compgen -W "CONVOCADO CONTRATADO DESIERTO NULO CONSENTIDO" -- "$cur") )
+  fi
+}
+complete -F _latinfo_completions latinfo`);
+    }
+}
 // --- Main ---
 const [command, ...args] = rawArgs;
 if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
@@ -513,6 +676,13 @@ else {
         case 'search':
             search(args.join(' ')).catch(e => { console.error(e); process.exit(1); });
             break;
+        case 'licitaciones':
+        case 'lic':
+            licitaciones(args).catch(e => { console.error(e); process.exit(1); });
+            break;
+        case 'completion':
+            completion();
+            break;
         case 'help':
             help();
             break;

package/dist/licitaciones.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Local licitaciones search for CLI prototype.
+ * Reads binary files from ~/.latinfo/data/
+ */
+export interface LicitacionesOptions {
+    query?: string;
+    category?: string;
+    minAmount?: number;
+    maxAmount?: number;
+    buyer?: string;
+    method?: string;
+    status?: string;
+    limit?: number;
+}
+export declare function searchLicitaciones(opts: LicitacionesOptions): Record<string, string>[];
+export declare function dataInfo(): {
+    records: number;
+    binSize: number;
+    date: string;
+} | null;

package/dist/licitaciones.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Local licitaciones search for CLI prototype.
+ * Reads binary files from ~/.latinfo/data/
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchLicitaciones = searchLicitaciones;
+exports.dataInfo = dataInfo;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os_1 = __importDefault(require("os"));
+const BASE_NAME = 'pe-oece-licitaciones';
+const FIELD_COUNT = 12;
+const DATA_DIR = path.join(os_1.default.homedir(), '.latinfo', 'data');
+const FIELD_NAMES = [
+    'ocid', 'titulo', 'descripcion', 'monto', 'moneda',
+    'categoria', 'metodo', 'buyer_nombre', 'buyer_id',
+    'fecha', 'estado', 'unspsc',
+];
+function decodeRecord(data, offset) {
+    if (offset + 4 > data.length)
+        return null;
+    const recordLen = data.readUInt32LE(offset);
+    if (offset + recordLen > data.length)
+        return null;
+    const fields = [];
+    let pos = offset + 4;
+    for (let i = 0; i < FIELD_COUNT; i++) {
+        if (pos + 2 > offset + recordLen)
+            break;
+        const fieldLen = data.readUInt16LE(pos);
+        pos += 2;
+        fields.push(data.subarray(pos, pos + fieldLen).toString('utf-8'));
+        pos += fieldLen;
+    }
+    return { fields, size: recordLen };
+}
+function fieldsToObject(fields) {
+    const obj = {};
+    for (let i = 0; i < FIELD_NAMES.length && i < fields.length; i++) {
+        obj[FIELD_NAMES[i]] = fields[i];
+    }
+    return obj;
+}
+function searchLicitaciones(opts) {
+    const binPath = path.join(DATA_DIR, `${BASE_NAME}.bin`);
+    const idxPath = path.join(DATA_DIR, `${BASE_NAME}.idx`);
+    if (!fs.existsSync(binPath) || !fs.existsSync(idxPath)) {
+        throw new Error('Licitaciones data not found. Build it first:\n' +
+            '  npx tsx src/imports/pe-oece-build.ts <input.jsonl> ~/.latinfo/data');
+    }
+    const bin = fs.readFileSync(binPath);
+    const idx = fs.readFileSync(idxPath);
+    if (idx.subarray(0, 4).toString() !== 'LOCE')
+        throw new Error('Invalid index file');
+    const count = idx.readUInt32LE(4);
+    const maxResults = opts.limit || 20;
+    const results = [];
+    const queryTokens = opts.query
+        ? opts.query.toLowerCase().split(/\s+/).filter(t => t.length > 0)
+        : [];
+    const categoryFilter = opts.category?.toLowerCase();
+    const buyerFilter = opts.buyer?.toLowerCase();
+    const methodFilter = opts.method?.toLowerCase();
+    const statusFilter = opts.status?.toUpperCase();
+    for (let i = 0; i < count && results.length < maxResults; i++) {
+        const offset = idx.readUInt32LE(12 + i * 8);
+        const decoded = decodeRecord(bin, offset);
+        if (!decoded)
+            continue;
+        const obj = fieldsToObject(decoded.fields);
+        if (categoryFilter && obj.categoria.toLowerCase() !== categoryFilter)
+            continue;
+        const monto = parseFloat(obj.monto);
+        if (opts.minAmount !== undefined && monto < opts.minAmount)
+            continue;
+        if (opts.maxAmount !== undefined && monto > opts.maxAmount)
+            continue;
+        if (buyerFilter && !obj.buyer_nombre.toLowerCase().includes(buyerFilter))
+            continue;
+        if (methodFilter && !obj.metodo.toLowerCase().includes(methodFilter))
+            continue;
+        if (statusFilter && obj.estado.toUpperCase() !== statusFilter)
+            continue;
+        if (queryTokens.length > 0) {
+            const searchText = (obj.titulo + ' ' + obj.descripcion + ' ' + obj.buyer_nombre).toLowerCase();
+            const allMatch = queryTokens.every(token => searchText.includes(token));
+            if (!allMatch)
+                continue;
+        }
+        results.push(obj);
+    }
+    return results;
+}
+function dataInfo() {
+    const binPath = path.join(DATA_DIR, `${BASE_NAME}.bin`);
+    const idxPath = path.join(DATA_DIR, `${BASE_NAME}.idx`);
+    if (!fs.existsSync(binPath) || !fs.existsSync(idxPath))
+        return null;
+    const idx = fs.readFileSync(idxPath);
+    const records = idx.readUInt32LE(4);
+    const binSize = fs.statSync(binPath).size;
+    const date = fs.statSync(binPath).mtime.toISOString().split('T')[0];
+    return { records, binSize, date };
+}

package/dist/sdk.d.ts

@@ -15,6 +15,31 @@ export interface PeRecord {
     manzana: string;
     kilometro: string;
 }
+export interface PeLicitacion {
+    ocid: string;
+    titulo: string;
+    descripcion: string;
+    monto: string;
+    moneda: string;
+    categoria: string;
+    metodo: string;
+    buyer_nombre: string;
+    buyer_id: string;
+    fecha: string;
+    estado: string;
+    unspsc: string;
+    url: string;
+}
+export interface LicitacionesQuery {
+    q?: string;
+    category?: string;
+    min_amount?: number;
+    max_amount?: number;
+    buyer?: string;
+    method?: string;
+    status?: string;
+    limit?: number;
+}
 declare class Country {
     private request;
     private prefix;
@@ -26,6 +51,7 @@ declare class Peru extends Country {
     ruc(ruc: string): Promise<PeRecord>;
     dni(dni: string): Promise<PeRecord>;
     search(query: string): Promise<PeRecord[]>;
+    licitaciones(query: LicitacionesQuery): Promise<PeLicitacion[]>;
 }
 export declare class Latinfo {
     private apiKey;

package/dist/sdk.js

@@ -26,6 +26,26 @@ class Peru extends Country {
     async search(query) {
         return this.countryRequest(`/search?q=${encodeURIComponent(query)}`);
     }
+    async licitaciones(query) {
+        const params = new URLSearchParams();
+        if (query.q)
+            params.set('q', query.q);
+        if (query.category)
+            params.set('category', query.category);
+        if (query.min_amount !== undefined)
+            params.set('min_amount', String(query.min_amount));
+        if (query.max_amount !== undefined)
+            params.set('max_amount', String(query.max_amount));
+        if (query.buyer)
+            params.set('buyer', query.buyer);
+        if (query.method)
+            params.set('method', query.method);
+        if (query.status)
+            params.set('status', query.status);
+        if (query.limit !== undefined)
+            params.set('limit', String(query.limit));
+        return this.countryRequest(`/licitaciones?${params}`);
+    }
 }
 class Latinfo {
     apiKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "latinfo",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Tax registry API for Latin America. Query RUC, DNI, and company data from SUNAT Peru. 18M+ records, updated daily, sub-100ms from anywhere.",
   "homepage": "https://latinfo.dev",
   "repository": {