@secondlayer/cli 5.0.1 → 5.1.1

package/dist/cli.js

@@ -32443,7 +32443,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "5.0.1",
+  version: "5.1.1",
   description: "CLI for subgraphs and blockchain indexing on Stacks",
   type: "module",
   bin: {
@@ -34631,18 +34631,42 @@ var SUBGRAPH_TEMPLATE_DESCRIPTIONS = {
   "bns-names": "BNS-V2 name ownership and lifecycle"
 };
 function generateSubgraphTemplate(name, slug = "basic") {
-  switch (slug) {
-    case "sip-010-balances":
-      return sip010Balances(name);
-    case "sbtc-flows":
-      return sbtcFlows(name);
-    case "pox-stacking":
-      return poxStacking(name);
-    case "bns-names":
-      return bnsNames(name);
-    default:
-      return basic(name);
-  }
+  const body = (() => {
+    switch (slug) {
+      case "sip-010-balances":
+        return sip010Balances(name);
+      case "sbtc-flows":
+        return sbtcFlows(name);
+      case "pox-stacking":
+        return poxStacking(name);
+      case "bns-names":
+        return bnsNames(name);
+      default:
+        return basic(name);
+    }
+  })();
+  return `${nextStepsHeader(name)}
+${body}`;
+}
+function nextStepsHeader(name) {
+  return `// ───────────────────────────────────────────────────────────────────
+// What to do next
+//
+//   1. Edit the source filter + schema below to match what you want to track.
+//   2. Edit the handler at the bottom — it runs once per matching event.
+//   3. Deploy:   sl subgraphs deploy ${name}.ts
+//      (You'll be prompted to log in if this is your first remote deploy.)
+//   4. Wait for sync:   sl subgraphs status ${name}
+//      Mainnet backfill from genesis can take an hour or more depending on
+//      your filter scope. Use --start-block to skip ahead.
+//   5. Query:    sl subgraphs query ${name} <table-name>
+//      Or hit the auto-generated REST endpoint listed in the deploy output.
+//
+// Bind a typed Subscription to any table you write here — see
+// https://www.secondlayer.tools/docs/subscriptions
+// ───────────────────────────────────────────────────────────────────
+
+`;
 }
 function basic(name) {
   return `import { defineSubgraph } from "@secondlayer/subgraphs";
@@ -35919,6 +35943,152 @@ async function stackStop(options2) {
   success("Stack stopped");
   console.log("");
 }
+// src/commands/streams.ts
+init_output();
+import { createStreamsClient } from "@secondlayer/sdk";
+var DEFAULT_BASE_URL = "https://api.secondlayer.tools";
+var VALID_TYPES = [
+  "stx_transfer",
+  "stx_mint",
+  "stx_burn",
+  "stx_lock",
+  "ft_transfer",
+  "ft_mint",
+  "ft_burn",
+  "nft_transfer",
+  "nft_mint",
+  "nft_burn",
+  "print"
+];
+function readApiKey() {
+  const key = process.env.SL_STREAMS_API_KEY;
+  if (!key) {
+    error("SL_STREAMS_API_KEY env var not set. Issue a key at https://www.secondlayer.tools/platform/api-keys (product: Streams).");
+    process.exit(1);
+  }
+  return key;
+}
+function client() {
+  return createStreamsClient({
+    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL,
+    apiKey: readApiKey()
+  });
+}
+function parseTypes(value) {
+  if (!value)
+    return;
+  const parts = value.split(",").map((s) => s.trim());
+  for (const p of parts) {
+    if (!VALID_TYPES.includes(p)) {
+      throw new Error(`invalid --types value "${p}"; expected one of: ${VALID_TYPES.join(", ")}`);
+    }
+  }
+  return parts;
+}
+function parseLimit(value) {
+  if (value === undefined)
+    return;
+  const n = Number.parseInt(value, 10);
+  if (!Number.isFinite(n) || n < 1 || n > 1000) {
+    throw new Error("--limit must be an integer between 1 and 1000");
+  }
+  return n;
+}
+function parseHeight(value, name) {
+  if (value === undefined)
+    return;
+  const n = Number.parseInt(value, 10);
+  if (!Number.isFinite(n) || n < 0) {
+    throw new Error(`${name} must be a non-negative integer`);
+  }
+  return n;
+}
+function registerStreamsCommand(program2) {
+  const streams = program2.command("streams").description("Read raw chain events from Streams (requires SL_STREAMS_API_KEY)");
+  streams.command("tip").description("Print current canonical tip").action(async () => {
+    try {
+      const tip = await client().tip();
+      process.stdout.write(`${JSON.stringify(tip, null, 2)}
+`);
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+  streams.command("events").description("List events (cursor-paginated; one page per call)").option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")})`).option("--contract-id <id>", "filter to a single contract identifier").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--from-height <n>", "filter to blocks >= n").option("--to-height <n>", "filter to blocks <= n").option("--limit <n>", "page size (1-1000, default 100)", "100").action(async (options2) => {
+    try {
+      const envelope = await client().events.list({
+        types: parseTypes(options2.types),
+        contractId: options2.contractId,
+        cursor: options2.cursor,
+        fromHeight: parseHeight(options2.fromHeight, "--from-height"),
+        toHeight: parseHeight(options2.toHeight, "--to-height"),
+        limit: parseLimit(options2.limit)
+      });
+      process.stdout.write(`${JSON.stringify(envelope, null, 2)}
+`);
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+  streams.command("consume").description("Long-running pull from a cursor; emits one event per line (jsonl) until SIGINT or --max-pages").option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")})`).option("--contract-id <id>", "filter to a single contract identifier").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--batch-size <n>", "events per batch (1-1000, default 100)", "100").option("--max-pages <n>", "stop after N pages (default: run until SIGINT)").action(async (options2) => {
+    try {
+      const types6 = parseTypes(options2.types);
+      const batchSize = parseLimit(options2.batchSize) ?? 100;
+      const maxPages = options2.maxPages ? Number.parseInt(options2.maxPages, 10) : undefined;
+      info(dim("# streaming events to stdout (jsonl); next_cursor printed to stderr"));
+      await client().events.consume({
+        fromCursor: options2.cursor,
+        types: types6,
+        contractId: options2.contractId,
+        batchSize,
+        mode: "tail",
+        maxPages,
+        onBatch: (events, envelope) => {
+          for (const e of events) {
+            process.stdout.write(`${JSON.stringify(e)}
+`);
+          }
+          if (envelope.next_cursor) {
+            process.stderr.write(`# next_cursor=${envelope.next_cursor}
+`);
+          }
+          return envelope.next_cursor;
+        }
+      });
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+  streams.command("reorgs").description("List recent reorgs (cursor-paginated)").requiredOption("--since <cursor>", "start cursor (block_height:event_index)").option("--limit <n>", "page size (default 100)", "100").action(async (options2) => {
+    try {
+      const envelope = await client().reorgs.list({
+        since: options2.since,
+        limit: parseLimit(options2.limit)
+      });
+      process.stdout.write(`${JSON.stringify(envelope, null, 2)}
+`);
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+  streams.command("canonical <height>").description("Canonical block metadata at a given height").action(async (heightArg) => {
+    try {
+      const height = parseHeight(heightArg, "<height>");
+      if (height === undefined)
+        throw new Error("<height> is required");
+      const block = await client().canonical(height);
+      process.stdout.write(`${JSON.stringify(block, null, 2)}
+`);
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+}
 // src/commands/doctor.ts
 init_config();
 
@@ -37130,6 +37300,7 @@ registerInstanceCommand(program);
 registerSubgraphsCommand(program);
 registerCreateCommand(program);
 registerSubscriptionsCommand(program);
+registerStreamsCommand(program);
 registerStatusCommand(program);
 registerStackCommand(program);
 registerDbCommand(program);
@@ -37139,5 +37310,5 @@ registerLocalCommand(program);
 registerAccountCommand(program);
 program.parse();
 
-//# debugId=40B4A90A59C890CE64756E2164756E21
+//# debugId=7C4F9780AD65C38D64756E2164756E21
 //# sourceMappingURL=cli.js.map