nansen-cli 1.2.0 → 1.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/nansen-cli.svg)](https://www.npmjs.com/package/nansen-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Tests](https://img.shields.io/badge/tests-356%20passing-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-323%20passing-brightgreen.svg)]()
 [![Coverage](https://img.shields.io/badge/coverage-80%25-brightgreen.svg)]()
 
 > **Built by agents, for agents.** We prioritize the best possible AI agent experience.
@@ -156,6 +156,7 @@ nansen cache clear
 | `--cache` | Enable response caching |
 | `--no-cache` | Bypass cache for this request |
 | `--cache-ttl <s>` | Cache TTL in seconds (default: 300) |
+| `--stream` | Output as JSON lines (NDJSON) for incremental processing |
 | `--chain <chain>` | Blockchain to query |
 | `--chains <json>` | Multiple chains as JSON array |
 | `--limit <n>` | Number of results |

package/TODO.md

@@ -2,17 +2,6 @@
 
 > **Built by agents, for agents.** We prioritize improvements that create the best possible AI agent experience.
 
-## P1 - Should Have
-
-### Test Cleanup
-- [ ] Remove duplicated `parseArgs` in unit.test.js (now exported from cli.js)
-- [ ] Reduce cli.test.js subprocess tests to ~10 smoke tests
-
-### Streaming Output
-- [ ] `--stream` flag for large result sets
-- [ ] Output as JSON lines (newline-delimited JSON)
-- [ ] Enable incremental processing by agents
-
 ## P2 - Nice to Have
 
 ### Test Coverage Gaps

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nansen-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Command-line interface for Nansen API - designed for AI agents",
   "main": "src/index.js",
   "type": "module",

package/src/cli.js

@@ -278,7 +278,7 @@ export function parseArgs(args) {
       const key = arg.slice(2);
       const next = args[i + 1];
       
-      if (key === 'pretty' || key === 'help' || key === 'table' || key === 'no-retry' || key === 'cache' || key === 'no-cache') {
+      if (key === 'pretty' || key === 'help' || key === 'table' || key === 'no-retry' || key === 'cache' || key === 'no-cache' || key === 'stream') {
         result.flags[key] = true;
       } else if (next && !next.startsWith('-')) {
         // Try to parse as JSON first
@@ -411,6 +411,34 @@ export function formatError(error) {
   };
 }
 
+/**
+ * Format data as JSON lines (NDJSON) for streaming output
+ * Each record is output as a separate JSON line
+ */
+export function formatStream(data) {
+  // Extract array of records from various response shapes
+  let records = [];
+  if (Array.isArray(data)) {
+    records = data;
+  } else if (data?.data && Array.isArray(data.data)) {
+    records = data.data;
+  } else if (data?.results && Array.isArray(data.results)) {
+    records = data.results;
+  } else if (data?.data?.results && Array.isArray(data.data.results)) {
+    records = data.data.results;
+  } else if (typeof data === 'object' && data !== null) {
+    // Single object - output as single line
+    records = [data];
+  }
+
+  if (records.length === 0) {
+    return '';
+  }
+
+  // Output each record as a separate JSON line
+  return records.map(record => JSON.stringify(record)).join('\n');
+}
+
 // Parse simple sort syntax: "field:direction" or "field" (defaults to DESC)
 export function parseSort(sortOption, orderByOption) {
   // If --order-by is provided, use it (full JSON control)
@@ -463,6 +491,7 @@ GLOBAL OPTIONS:
   --cache        Enable response caching (default: off)
   --no-cache     Disable cache for this request
   --cache-ttl <s> Cache TTL in seconds (default: 300)
+  --stream       Output as JSON lines (NDJSON) for incremental processing
 
 EXAMPLES:
   # Get Smart Money netflow on Solana
@@ -814,6 +843,7 @@ export async function runCLI(rawArgs, deps = {}) {
   const subArgs = positional.slice(1);
   const pretty = flags.pretty || flags.p;
   const table = flags.table || flags.t;
+  const stream = flags.stream || flags.s;
 
   const commands = { ...buildCommands(deps), ...commandOverrides };
 
@@ -868,6 +898,16 @@ export async function runCLI(rawArgs, deps = {}) {
       result = filterFields(result, fields);
     }
     
+    // Output in requested format
+    if (stream) {
+      // Stream mode: output each record as a JSON line (NDJSON)
+      const streamOutput = formatStream(result);
+      if (streamOutput) {
+        output(streamOutput);
+      }
+      return { type: 'stream', data: result };
+    }
+    
     const successData = { success: true, data: result };
     const formatted = formatOutput(successData, { pretty, table });
     output(formatted.text);