@secondlayer/cli 8.4.2 → 8.5.0

package/README.md

@@ -119,6 +119,14 @@ Read/action commands support `--json`. Destructive commands prompt unless
 `-y` / `--yes`. Filters are schema-aware: unknown tables/columns, bad operators,
 and non-scalar columns are rejected before the API call.
 
+Subscriptions are polymorphic — **subgraph** (fires on a subgraph table's rows)
+or **chain** (fires on raw chain events with no subgraph). `sl subscriptions
+create` makes subgraph subscriptions only (via the `--subgraph`/`--table`
+flags). Create chain subscriptions — a webhook on a contract / event / function /
+trait — via the SDK, REST, or MCP with a `triggers` array. Every other
+`sl subscriptions` command (list/get/update/pause/resume/delete/doctor/test/
+deliveries/...) operates on both kinds.
+
 ### Local dev & OSS
 
 | Command | What it does |

package/dist/cli.js

@@ -32354,7 +32354,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "8.4.2",
+  version: "8.5.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -32403,8 +32403,8 @@ var package_default = {
   dependencies: {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.3.7",
-    "@secondlayer/sdk": "^6.2.1",
-    "@secondlayer/shared": "^6.12.0",
+    "@secondlayer/sdk": "^6.9.0",
+    "@secondlayer/shared": "^6.18.0",
     "@secondlayer/stacks": "^2.3.0",
     "@secondlayer/subgraphs": "^3.5.0",
     "@biomejs/js-api": "^0.7.0",
@@ -33095,6 +33095,30 @@ async function validateDatabaseConnection(url) {
     console.log(dim("The URL was saved but connection failed. Check your database settings."));
   }
 }
+// src/commands/context.ts
+init_output();
+init_resolve_auth();
+import { SecondLayer as SecondLayer2 } from "@secondlayer/sdk";
+var DEFAULT_BASE_URL = "https://api.secondlayer.tools";
+function registerContextCommand(program2) {
+  program2.command("context").description("Print an agent orientation snapshot: account, live Streams/Index tips, your subgraphs/subscriptions, and in-flight reindex operations").option("--json", "Print as JSON (default)").action(async (o) => {
+    try {
+      const sl = new SecondLayer2({
+        baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL,
+        apiKey: resolveEnvKey()
+      });
+      const snapshot = await sl.context();
+      output({
+        json: o.json,
+        data: snapshot,
+        human: () => writeData(JSON.stringify(snapshot, null, 2))
+      });
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
+}
 // src/commands/status.ts
 init_config();
 init_output();
@@ -33287,7 +33311,7 @@ import {
 import { dirname as dirname2, join as join4, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { input, select as select2 } from "@inquirer/prompts";
-import { SecondLayer as SecondLayer2 } from "@secondlayer/sdk";
+import { SecondLayer as SecondLayer3 } from "@secondlayer/sdk";
 init_output();
 init_resolve_auth();
 
@@ -33492,7 +33516,7 @@ SIGNING_SECRET=${signingSecret}
 }
 async function getSubscriptionClient() {
   const { apiUrl, ephemeralKey } = await resolveAuth();
-  return new SecondLayer2({ baseUrl: apiUrl, apiKey: ephemeralKey });
+  return new SecondLayer3({ baseUrl: apiUrl, apiKey: ephemeralKey });
 }
 function addSubscriptionScaffold(parent, commandSpec, opts) {
   parent.command(commandSpec).description(opts.description).option("-r, --runtime <runtime>", "inngest | trigger | cloudflare | node").option("-s, --subgraph <name>", "Subgraph to subscribe to").option("-t, --table <name>", "Table to subscribe to").option("-u, --url <url>", "Webhook URL").option("--auth-token <token>", "Bearer token for receiver API auth").option("--filter <kv...>", "Filter as key=value (supports .eq/.neq/.gt/.gte/.lt/.lte suffixes)").option("--skip-api", "Copy template only, don't call the API").option("--no-scaffold", "Skip the local runtime template directory (webhook-only setups)").addHelpText("after", `
@@ -36358,7 +36382,7 @@ init_resolve_auth();
 import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname6, join as join8 } from "node:path";
 import { createStreamsClient } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL = "https://api.secondlayer.tools";
+var DEFAULT_BASE_URL2 = "https://api.secondlayer.tools";
 var VALID_TYPES = [
   "stx_transfer",
   "stx_mint",
@@ -36382,7 +36406,7 @@ function readApiKey() {
 }
 function client() {
   return createStreamsClient({
-    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL,
+    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL2,
     apiKey: readApiKey()
   });
 }
@@ -36393,7 +36417,7 @@ function dumpsClient(dumpsUrl) {
     process.exit(1);
   }
   return createStreamsClient({
-    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL,
+    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL2,
     apiKey: resolveEnvKey() ?? "",
     dumpsBaseUrl
   });
@@ -36446,7 +36470,7 @@ function registerStreamsCommand(program2) {
       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("--not-types <types>", "comma-separated event types to exclude").option("--contract-id <ids>", "comma-separated contract identifier(s)").option("--sender <addrs>", "comma-separated sender principal(s)").option("--recipient <addrs>", "comma-separated recipient principal(s)").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--from-block <n>", "filter to blocks >= n").option("--to-block <n>", "filter to blocks <= n").option("--limit <n>", "page size (1-1000, default 100)", "100").option("--json", "Output as JSON (streams always emits JSON)").addHelpText("after", `
+  const events = streams.command("events").description("List events (cursor-paginated; one page per call)").option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")})`).option("--not-types <types>", "comma-separated event types to exclude").option("--contract-id <ids>", "comma-separated contract identifier(s)").option("--sender <addrs>", "comma-separated sender principal(s)").option("--recipient <addrs>", "comma-separated recipient principal(s)").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--from-block <n>", "filter to blocks >= n").option("--to-block <n>", "filter to blocks <= n").option("--limit <n>", "page size (1-1000, default 100)", "100").option("--json", "Output as JSON (streams always emits JSON)").addHelpText("after", `
 Examples:
   $ sl streams events --types stx_transfer,print --limit 50
   $ sl streams events --not-types print --contract-id SP00....token,SP01....token
@@ -36470,6 +36494,15 @@ Examples:
       process.exit(1);
     }
   });
+  events.command("by-tx <txId>").description("List all events emitted by a single transaction").option("--json", "Output as JSON (streams always emits JSON)").action(async (txId) => {
+    try {
+      const envelope = await client().events.byTxId(txId);
+      writeData(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("--not-types <types>", "comma-separated event types to exclude").option("--contract-id <ids>", "comma-separated contract identifier(s)").option("--sender <addrs>", "comma-separated sender principal(s)").option("--recipient <addrs>", "comma-separated recipient principal(s)").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)").addHelpText("after", `
 Examples:
   $ sl streams consume --types print --cursor 150000:0
@@ -36488,8 +36521,8 @@ Examples:
         batchSize,
         mode: "tail",
         maxPages,
-        onBatch: (events, envelope) => {
-          for (const e of events) {
+        onBatch: (events2, envelope) => {
+          for (const e of events2) {
             process.stdout.write(`${JSON.stringify(e)}
 `);
           }
@@ -36562,13 +36595,23 @@ Examples:
       process.exit(1);
     }
   });
+  streams.command("block-events <heightOrHash>").description("List all events in a single block (by height or block hash)").option("--json", "Output as JSON (streams always emits JSON)").action(async (heightOrHash) => {
+    try {
+      const ref = /^\d+$/.test(heightOrHash) ? Number.parseInt(heightOrHash, 10) : heightOrHash;
+      const envelope = await client().blocks.events(ref);
+      writeData(JSON.stringify(envelope, null, 2));
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
 }
 // src/commands/datasets.ts
 init_output();
 import { CURSOR_SLUGS, Datasets } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL2 = "https://api.secondlayer.tools";
+var DEFAULT_BASE_URL3 = "https://api.secondlayer.tools";
 function client2() {
-  return new Datasets({ baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL2 });
+  return new Datasets({ baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL3 });
 }
 function parseFilters(pairs) {
   const out = {};
@@ -36623,10 +36666,10 @@ Examples:
 init_output();
 init_resolve_auth();
 import { Index } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL3 = "https://api.secondlayer.tools";
+var DEFAULT_BASE_URL4 = "https://api.secondlayer.tools";
 function client3() {
   return new Index({
-    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL3,
+    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL4,
     apiKey: resolveEnvKey()
   });
 }
@@ -36638,15 +36681,17 @@ function fail(action, err) {
   }
   process.exit(1);
 }
-function rangeParams(o) {
+function heightParams(o) {
   return {
-    contractId: o.contractId,
     fromHeight: o.fromHeight ? Number.parseInt(o.fromHeight, 10) : undefined,
     toHeight: o.toHeight ? Number.parseInt(o.toHeight, 10) : undefined,
     cursor: o.cursor,
     limit: o.limit ? Number.parseInt(o.limit, 10) : undefined
   };
 }
+function rangeParams(o) {
+  return { contractId: o.contractId, ...heightParams(o) };
+}
 function emit(env, json) {
   output({
     json,
@@ -36658,9 +36703,21 @@ function emit(env, json) {
     }
   });
 }
+function emitOne(doc, label, json) {
+  if (doc == null) {
+    error(`Not found: ${label}`);
+    process.exit(1);
+  }
+  output({
+    json,
+    data: doc,
+    human: () => writeData(JSON.stringify(doc, null, 2))
+  });
+}
 function registerIndexCommand(program2) {
   const index = program2.command("index").description("Query the decoded Index layer (L2 events + contract calls)");
   const rangeFlags = (cmd) => cmd.option("--contract-id <id>", "Filter by contract id").option("--from-height <n>", "Start block height (inclusive)").option("--to-height <n>", "End block height (inclusive)").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--limit <n>", "Rows per page").option("--json", "Print the full envelope as JSON");
+  const heightFlags = (cmd) => cmd.option("--from-height <n>", "Start block height (inclusive)").option("--to-height <n>", "End block height (inclusive)").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--limit <n>", "Rows per page").option("--json", "Print the full envelope as JSON");
   rangeFlags(index.command("ft-transfers")).description("List decoded SIP-010 fungible-token transfers").option("--sender <principal>", "Filter by sender").option("--recipient <principal>", "Filter by recipient").action(async (o) => {
     try {
       emit(await client3().ftTransfers.list({
@@ -36708,6 +36765,119 @@ function registerIndexCommand(program2) {
       fail("list contract calls", err);
     }
   });
+  heightFlags(index.command("canonical")).description("List the canonical Stacks block sequence (height + hash)").action(async (o) => {
+    try {
+      emit(await client3().canonical.list(heightParams(o)), o.json);
+    } catch (err) {
+      fail("list canonical blocks", err);
+    }
+  });
+  const blocks = heightFlags(index.command("blocks")).description("List decoded blocks (run `blocks get <ref>` for one block)").action(async (o) => {
+    try {
+      emit(await client3().blocks.list(heightParams(o)), o.json);
+    } catch (err) {
+      fail("list blocks", err);
+    }
+  });
+  blocks.command("get <ref>").description("Get a single block by height or block hash").option("--json", "Print as JSON").action(async (ref, o) => {
+    try {
+      const block = await client3().blocks.get(/^\d+$/.test(ref) ? Number.parseInt(ref, 10) : ref);
+      emitOne(block, `block ${ref}`, o.json);
+    } catch (err) {
+      fail("get block", err);
+    }
+  });
+  const transactions = rangeFlags(index.command("transactions")).description("List decoded transactions (run `transactions get <txId>` for one)").option("--type <type>", "Filter by transaction type").option("--sender <principal>", "Filter by sender").action(async (o) => {
+    try {
+      emit(await client3().transactions.list({
+        ...rangeParams(o),
+        type: o.type,
+        sender: o.sender
+      }), o.json);
+    } catch (err) {
+      fail("list transactions", err);
+    }
+  });
+  transactions.command("get <txId>").description("Get a single transaction by tx_id").option("--json", "Print as JSON").action(async (txId, o) => {
+    try {
+      emitOne(await client3().transactions.get(txId), `tx ${txId}`, o.json);
+    } catch (err) {
+      fail("get transaction", err);
+    }
+  });
+  heightFlags(index.command("stacking")).description("List decoded PoX-4 stacking actions").option("--function-name <name>", "Filter by PoX function name").option("--stacker <principal>", "Filter by stacker").option("--caller <principal>", "Filter by caller").action(async (o) => {
+    try {
+      emit(await client3().stacking.list({
+        ...heightParams(o),
+        functionName: o.functionName,
+        stacker: o.stacker,
+        caller: o.caller
+      }), o.json);
+    } catch (err) {
+      fail("list stacking actions", err);
+    }
+  });
+  const mempool = index.command("mempool").description("List pending mempool transactions (run `mempool get <txId>` for one)").option("--contract-id <id>", "Filter to pending calls to a contract").option("--sender <principal>", "Filter by sender").option("--type <type>", "Filter by transaction type").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--limit <n>", "Rows per page").option("--json", "Print the full envelope as JSON").action(async (o) => {
+    try {
+      emit(await client3().mempool.list({
+        contractId: o.contractId,
+        sender: o.sender,
+        type: o.type,
+        cursor: o.cursor,
+        limit: o.limit ? Number.parseInt(o.limit, 10) : undefined
+      }), o.json);
+    } catch (err) {
+      fail("list mempool", err);
+    }
+  });
+  mempool.command("get <txId>").description("Get a single pending transaction by tx_id (404 once mined)").option("--json", "Print as JSON").action(async (txId, o) => {
+    try {
+      emitOne(await client3().mempool.get(txId), `pending tx ${txId}`, o.json);
+    } catch (err) {
+      fail("get mempool tx", err);
+    }
+  });
+}
+// src/commands/keys.ts
+init_output();
+init_resolve_auth();
+import { SecondLayer as SecondLayer4 } from "@secondlayer/sdk";
+var DEFAULT_BASE_URL5 = "https://api.secondlayer.tools";
+function registerKeysCommand(program2) {
+  const keys = program2.command("keys").description("Manage API keys");
+  keys.command("create").description("Mint a scoped streams/index read key (requires an account-level key)").option("--product <product>", "Key scope: streams or index", "streams").option("--name <name>", "Optional label for the key").option("--json", "Print the full response as JSON").action(async (o) => {
+    if (o.product && o.product !== "streams" && o.product !== "index") {
+      error("--product must be 'streams' or 'index'");
+      process.exit(1);
+    }
+    const apiKey = resolveEnvKey();
+    if (!apiKey) {
+      error("No API key set. Export SL_API_KEY with an account-level key (issue one at https://www.secondlayer.tools/platform/api-keys).");
+      process.exit(1);
+    }
+    try {
+      const sl = new SecondLayer4({
+        baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL5,
+        apiKey
+      });
+      const minted = await sl.apiKeys.create({
+        product: o.product === "index" ? "index" : "streams",
+        name: o.name
+      });
+      output({
+        json: o.json,
+        data: minted,
+        human: () => {
+          success(`Created ${minted.product} key (${minted.prefix}…)`);
+          note("This key is shown once — store it now:");
+          writeData(minted.key);
+        }
+      });
+    } catch (err) {
+      error(err instanceof Error ? err.message : String(err));
+      process.exit(1);
+    }
+  });
 }
 // src/commands/doctor.ts
 init_config();
@@ -38221,9 +38391,11 @@ program.commandsGroup("Diagnostics:");
 registerStatusCommand(program);
 registerDoctorCommand(program);
 registerConfigCommand(program);
+registerContextCommand(program);
 program.commandsGroup("Account:");
 registerAccountCommand(program);
+registerKeysCommand(program);
 program.parse();
 
-//# debugId=1CE2C8D6E9B70EC764756E2164756E21
+//# debugId=09F28BAC8C0CF0E864756E2164756E21
 //# sourceMappingURL=cli.js.map