talo-hub 0.1.0 → 0.1.2

package/README.md

@@ -44,6 +44,7 @@ El agente puede crear cobros, simular transferencias, registrar y probar su webh
 - Keys: `tph_test_…` sandbox (test money: test freely), `tph_live_…` production (real money: confirm refunds and amount changes with the user). Scopes `read` < `charge` < `full`; give servers `charge`. Store project keys in the server's env (`TALO_HUB_API_KEY`), never in code or chat; exporting it in your own shell replaces the login key. `login --production` does not make production the default: pass `--production` or run `use production`.
 - Machine-readable: every command takes `--json` (JSON on stdout, human messages on stderr) and exits non-zero on failure, `doctor` and `webhooks test` included. Errors with `--json`: `{"error":{"code","message","status"}}`, with stable codes such as `not_logged_in`, `invalid_amount`, `invalid_hub`, `env_key_mismatch`, `insufficient_scope` (plus `key_scope` and `required_scope`), `talo_reconnect_required`, `network_error`, `invalid_response`. `status` is the hub's HTTP status, or null when the CLI found the error itself or couldn't reach the hub. `events listen --json` prints one event per line; the last few existing events come first with `"replayed": true`. Docs as Markdown: https://talopartnerhub.vercel.app/llms.txt, `/docs/<page>.md`, OpenAPI at `/openapi.json`.
 - Amounts: pass `--amount 15000` or `15000.50`. Don't use thousands separators unquoted: PowerShell turns `15.000,50` into `15,50`.
+- Payments always include `paid` and `refunded` as numbers (0 when none) and `refunds: [{ id, status, type, amount, currency, created_at }]`. Filter events with `events list --payment <id>`.
 - Test plan: `payments create --amount 15000` → `sandbox pay <id> --amount 14999` (UNDERPAID, don't fulfil) → `sandbox pay <id> --amount 1` (SUCCESS) → `webhooks add <https url>` → `webhooks test <id>` → `doctor` until it exits 0.
 
 ## Comandos
@@ -59,10 +60,10 @@ El agente puede crear cobros, simular transferencias, registrar y probar su webh
 | `payments refund <id> [--amount <ARS>]` | Reembolso total o parcial |
 | `sandbox pay <id> [--amount <ARS>]` | Simula la transferencia del cliente |
 | `balance`, `transactions [--from] [--to] [--limit <n>] [--cursor]` | Saldo y movimientos |
-| `events list [--after <id>] [--limit <n>]` | Eventos recientes |
+| `events list [--payment <id>] [--type <tipo>] [--after <id>] [--limit <n>]` | Eventos recientes, filtrables por cobro o tipo |
 | `events listen [--forward-to <url\|puerto>]` | Recibe eventos en vivo y los reenvía a localhost sin túneles (sin firma, con `talo-hub-forwarded: 1`: solo para desarrollo) |
 | `webhooks list \| add <url> \| remove <id> \| test <id>` | Webhooks firmados con HMAC-SHA256 |
-| `keys list \| create [--name] [--scope read\|charge\|full] \| revoke <id>` | Keys para tus proyectos |
+| `keys list \| create [--name] [--scope read\|charge\|full] \| revoke <id>` | Keys para tus proyectos (`charge` por defecto) |
 | `mcp [--client claude\|cursor\|desktop] [--with-key]` | Configuración del MCP para tu agente |
 | `skills install [--global]` | Instala las skills de Talo |
 | `use <sandbox\|production>` | Entorno activo de los próximos comandos |

package/dist/cli.js

@@ -35,13 +35,14 @@ Cobros
   transactions [--from …] [--to …] [--limit <1-200>] [--cursor <next_cursor>]
 
 Eventos y webhooks
-  events list [--after <id>] [--limit <1-200>]   Sin --after, los más recientes
+  events list [--payment <id>] [--type <tipo>] [--after <id>] [--limit <1-200>]
+                                                 Sin --after, los más recientes
   events listen [--forward-to <url|puerto>]      Muestra los últimos y escucha los nuevos
                                                  (los reenviados no van firmados: solo para desarrollo)
   webhooks list | add <url> | remove <id> | test <id>
 
 Keys y agentes
-  keys list | create [--name <nombre>] [--scope read|charge|full] | revoke <id>
+  keys list | create [--name <nombre>] [--scope read|charge|full] | revoke <id>   (charge por defecto)
   mcp [--client claude|cursor|desktop] [--with-key]   Configuración del MCP para tu agente
   skills install [--global]                           Instala las skills de Talo en .claude/skills
 
@@ -90,6 +91,8 @@ function parseCommandLine() {
                 after: { type: "string" },
                 limit: { type: "string" },
                 cursor: { type: "string" },
+                payment: { type: "string" },
+                type: { type: "string" },
                 name: { type: "string" },
                 scope: { type: "string" },
                 "forward-to": { type: "string" },
@@ -129,7 +132,7 @@ const COMMAND_OPTIONS = {
     "sandbox pay": ["amount"],
     balance: [],
     transactions: ["from", "to", "limit", "cursor"],
-    "events list": ["after", "limit"],
+    "events list": ["after", "limit", "payment", "type"],
     "events listen": ["forward-to"],
     webhooks: [],
     keys: ["name", "scope"],
@@ -225,14 +228,17 @@ const HUB_MESSAGES = {
     invalid_amount: "El monto no es válido.",
     invalid_url: "La URL del webhook no es válida: tiene que ser https.",
     environment_disabled: "El hub todavía no está conectado a ese entorno de Talo.",
+    talo_partner_unsupported: "Talo todavía no habilita el saldo y los movimientos para integraciones de partner: consultalos en el panel de Talo.",
 };
 /** A hub error in words for this CLI: transient failures read the same whatever the hub said. */
 function hubMessage(error) {
+    if (error.code && HUB_MESSAGES[error.code])
+        return HUB_MESSAGES[error.code];
     if (error.status === 0)
         return error.message;
     if (error.status >= 500)
         return `El hub tuvo un error (HTTP ${error.status}).`;
-    return (error.code && HUB_MESSAGES[error.code]) ?? error.message;
+    return error.message;
 }
 function showPayment(payment) {
     console.log(`${payment.id}  ${payment.status}`);
@@ -716,13 +722,20 @@ async function run(hub, ctx) {
                 return listen(hub);
             if (sub !== undefined && sub !== "list")
                 fail(`Usá: ${CMD} events list [--after <id>] | listen [--forward-to <url>]`);
-            const limit = limitFlag(20);
-            if (flags.after === undefined)
-                return emit(await hub.get(`/api/v1/events?recent=${limit}`));
+            const query = new URLSearchParams({ limit: String(limitFlag(20)) });
+            if (flags.payment)
+                query.set("payment_id", flags.payment);
+            if (flags.type)
+                query.set("type", flags.type);
+            if (flags.after === undefined) {
+                query.set("recent", query.get("limit"));
+                return emit(await hub.get(`/api/v1/events?${query}`));
+            }
             if (!/^\d+$/.test(flags.after) || !Number.isSafeInteger(Number(flags.after))) {
                 fail(`--after tiene que ser el número de un evento (recibimos "${flags.after}").`, "invalid_option");
             }
-            return emit(await hub.get(`/api/v1/events?after=${flags.after}&limit=${limit}`));
+            query.set("after", flags.after);
+            return emit(await hub.get(`/api/v1/events?${query}`));
         }
         case "webhooks": {
             if (sub === undefined || sub === "list")
@@ -752,7 +765,7 @@ async function run(hub, ctx) {
                     fail("--scope tiene que ser read, charge o full.", "invalid_option");
                 const created = await hub.post("/api/v1/api-keys", {
                     name: flags.name ?? "CLI",
-                    scope: flags.scope ?? "full",
+                    scope: flags.scope ?? "charge",
                 });
                 return emit(created, () => console.log(`✓ ${created.api_key}\n  ${created.environment} · scope ${created.scope}. Guardala ahora en el .env o los secretos de tu servidor (TALO_HUB_API_KEY): no se vuelve a mostrar.\n  En esta terminal, exportarla reemplaza a la key de tu login.`));
             }

package/package.json

@@ -1,57 +1,62 @@
-{
-  "name": "talo-hub",
-  "version": "0.1.0",
-  "description": "Transferencias bancarias automáticas en Argentina con Talo Pay: un CVU por cobro, acreditación y conciliación automáticas, webhooks firmados, sandbox y MCP para agentes de IA (Claude, Cursor).",
-  "keywords": [
-    "talo",
-    "talo-pay",
-    "transferencias",
-    "transferencia-bancaria",
-    "cobros",
-    "pagos",
-    "argentina",
-    "cvu",
-    "cbu",
-    "alias",
-    "ars",
-    "payments",
-    "bank-transfer",
-    "payments-argentina",
-    "webhooks",
-    "sandbox",
-    "mcp",
-    "model-context-protocol",
-    "ai-agents",
-    "claude",
-    "cursor",
-    "cli"
-  ],
-  "homepage": "https://talopartnerhub.vercel.app/docs/cli",
-  "license": "MIT",
-  "author": "Talo Partner Hub",
-  "type": "module",
-  "bin": {
-    "talo-hub": "dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "prepublishOnly": "npm test",
-    "test": "npm run build && node --test \"test/**/*.test.mjs\""
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@types/node": "^26.6.5",
-    "typescript": "5.9.3"
-  }
-}
+{
+  "name": "talo-hub",
+  "version": "0.1.2",
+  "description": "Transferencias bancarias automáticas en Argentina con Talo Pay: un CVU por cobro, acreditación y conciliación automáticas, webhooks firmados, sandbox y MCP para agentes de IA (Claude, Cursor).",
+  "keywords": [
+    "talo",
+    "talo-pay",
+    "transferencias",
+    "transferencia-bancaria",
+    "cobros",
+    "pagos",
+    "argentina",
+    "cvu",
+    "cbu",
+    "alias",
+    "ars",
+    "payments",
+    "bank-transfer",
+    "payments-argentina",
+    "webhooks",
+    "sandbox",
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "claude",
+    "cursor",
+    "cli"
+  ],
+  "homepage": "https://talopartnerhub.vercel.app/docs/cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matiasbarrigadev/talo-partner-hub.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "author": "Talo Partner Hub",
+  "type": "module",
+  "bin": {
+    "talo-hub": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm test",
+    "test": "npm run build && node --test \"test/**/*.test.mjs\""
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "typescript": "5.9.3"
+  }
+}