@secondlayer/cli 5.6.6 → 5.8.0

package/dist/cli.js

@@ -15419,8 +15419,8 @@ var require_to_regex_range = __commonJS((exports, module) => {
     let relax = String(opts.relaxZeros);
     let shorthand = String(opts.shorthand);
     let capture = String(opts.capture);
-    let wrap = String(opts.wrap);
-    let cacheKey = min + ":" + max + "=" + relax + shorthand + capture + wrap;
+    let wrap2 = String(opts.wrap);
+    let cacheKey = min + ":" + max + "=" + relax + shorthand + capture + wrap2;
     if (toRegexRange.cache.hasOwnProperty(cacheKey)) {
       return toRegexRange.cache[cacheKey].result;
     }
@@ -15700,9 +15700,9 @@ var require_fill_range = __commonJS((exports, module) => {
   };
   var toRegex = (start, end, options2) => {
     if (Array.isArray(start)) {
-      let wrap = options2.wrap === true;
+      let wrap2 = options2.wrap === true;
       let prefix = options2.capture ? "" : "?:";
-      return wrap ? `(${prefix}${start.join("|")})` : start.join("|");
+      return wrap2 ? `(${prefix}${start.join("|")})` : start.join("|");
     }
     return toRegexRange(start, end, options2);
   };
@@ -22353,9 +22353,9 @@ function requireLines() {
 }
 function requireWrap() {
   if (hasRequiredWrap)
-    return wrap;
+    return wrap2;
   hasRequiredWrap = 1;
-  wrap = (msg, opts = {}) => {
+  wrap2 = (msg, opts = {}) => {
     const tab = Number.isSafeInteger(parseInt(opts.margin)) ? new Array(parseInt(opts.margin)).fill(" ").join("") : opts.margin || "";
     const width = opts.width;
     return (msg || "").split(/\r?\n/g).map((line) => line.split(/\s+/g).reduce((arr, w2) => {
@@ -22368,7 +22368,7 @@ function requireWrap() {
 `)).join(`
 `);
   };
-  return wrap;
+  return wrap2;
 }
 function requireEntriesToDisplay() {
   if (hasRequiredEntriesToDisplay)
@@ -22660,7 +22660,7 @@ function requireSelect() {
   hasRequiredSelect = 1;
   const color = requireKleur();
   const Prompt = requirePrompt();
-  const { style: style2, clear: clear2, figures, wrap: wrap2, entriesToDisplay: entriesToDisplay2 } = requireUtil();
+  const { style: style2, clear: clear2, figures, wrap: wrap3, entriesToDisplay: entriesToDisplay2 } = requireUtil();
   const { cursor } = requireSrc();
 
   class SelectPrompt extends Prompt {
@@ -22791,7 +22791,7 @@ function requireSelect() {
               desc = ` - ${v2.description}`;
               if (prefix.length + title.length + desc.length >= this.out.columns || v2.description.split(/\r?\n/).length > 1) {
                 desc = `
-` + wrap2(v2.description, { margin: 3, width: this.out.columns });
+` + wrap3(v2.description, { margin: 3, width: this.out.columns });
               }
             }
           }
@@ -23557,7 +23557,7 @@ function requireMultiselect() {
   const color = requireKleur();
   const { cursor } = requireSrc();
   const Prompt = requirePrompt();
-  const { clear: clear2, figures, style: style2, wrap: wrap2, entriesToDisplay: entriesToDisplay2 } = requireUtil();
+  const { clear: clear2, figures, style: style2, wrap: wrap3, entriesToDisplay: entriesToDisplay2 } = requireUtil();
 
   class MultiselectPrompt extends Prompt {
     constructor(opts = {}) {
@@ -23715,7 +23715,7 @@ Instructions:
           desc = ` - ${v2.description}`;
           if (prefix.length + title.length + desc.length >= this.out.columns || v2.description.split(/\r?\n/).length > 1) {
             desc = `
-` + wrap2(v2.description, { margin: prefix.length, width: this.out.columns });
+` + wrap3(v2.description, { margin: prefix.length, width: this.out.columns });
           }
         }
       }
@@ -23788,7 +23788,7 @@ function requireAutocomplete() {
   const color = requireKleur();
   const Prompt = requirePrompt();
   const { erase, cursor } = requireSrc();
-  const { style: style2, clear: clear2, figures, wrap: wrap2, entriesToDisplay: entriesToDisplay2 } = requireUtil();
+  const { style: style2, clear: clear2, figures, wrap: wrap3, entriesToDisplay: entriesToDisplay2 } = requireUtil();
   const getVal = (arr, i2) => arr[i2] && (arr[i2].value || arr[i2].title || arr[i2]);
   const getTitle = (arr, i2) => arr[i2] && (arr[i2].title || arr[i2].value || arr[i2]);
   const getIndex = (arr, valOrTitle) => {
@@ -23975,7 +23975,7 @@ function requireAutocomplete() {
         desc = ` - ${v2.description}`;
         if (prefix.length + title.length + desc.length >= this.out.columns || v2.description.split(/\r?\n/).length > 1) {
           desc = `
-` + wrap2(v2.description, { margin: 3, width: this.out.columns });
+` + wrap3(v2.description, { margin: 3, width: this.out.columns });
         }
       }
       return prefix + " " + title + color.gray(desc || "");
@@ -24929,7 +24929,7 @@ async function detect2({ autoInstall, programmatic, cwd } = {}) {
   }
   return agent;
 }
-var ini$1, hasRequiredIni, iniExports, prompts$2, kleur, hasRequiredKleur, action, hasRequiredAction, strip, hasRequiredStrip, src, hasRequiredSrc, clear, hasRequiredClear, figures_1, hasRequiredFigures, style, hasRequiredStyle, lines, hasRequiredLines, wrap, hasRequiredWrap, entriesToDisplay, hasRequiredEntriesToDisplay, util, hasRequiredUtil, prompt, hasRequiredPrompt, text, hasRequiredText, select4, hasRequiredSelect, toggle, hasRequiredToggle, datepart, hasRequiredDatepart, meridiem, hasRequiredMeridiem, day, hasRequiredDay, hours, hasRequiredHours, milliseconds, hasRequiredMilliseconds, minutes, hasRequiredMinutes, month, hasRequiredMonth, seconds, hasRequiredSeconds, year, hasRequiredYear, dateparts, hasRequiredDateparts, date, hasRequiredDate, number, hasRequiredNumber, multiselect, hasRequiredMultiselect, autocomplete, hasRequiredAutocomplete, autocompleteMultiselect, hasRequiredAutocompleteMultiselect, confirm6, hasRequiredConfirm, elements, hasRequiredElements, hasRequiredPrompts$1, lib$1, hasRequiredLib$1, prompts$1, hasRequiredPrompts, promptsExports, prompts, isBrowser, platform, OSC = "\x1B]", BEL = "\x07", SEP = ";", link = (text2, url) => [
+var ini$1, hasRequiredIni, iniExports, prompts$2, kleur, hasRequiredKleur, action, hasRequiredAction, strip, hasRequiredStrip, src, hasRequiredSrc, clear, hasRequiredClear, figures_1, hasRequiredFigures, style, hasRequiredStyle, lines, hasRequiredLines, wrap2, hasRequiredWrap, entriesToDisplay, hasRequiredEntriesToDisplay, util, hasRequiredUtil, prompt, hasRequiredPrompt, text, hasRequiredText, select4, hasRequiredSelect, toggle, hasRequiredToggle, datepart, hasRequiredDatepart, meridiem, hasRequiredMeridiem, day, hasRequiredDay, hours, hasRequiredHours, milliseconds, hasRequiredMilliseconds, minutes, hasRequiredMinutes, month, hasRequiredMonth, seconds, hasRequiredSeconds, year, hasRequiredYear, dateparts, hasRequiredDateparts, date, hasRequiredDate, number, hasRequiredNumber, multiselect, hasRequiredMultiselect, autocomplete, hasRequiredAutocomplete, autocompleteMultiselect, hasRequiredAutocompleteMultiselect, confirm6, hasRequiredConfirm, elements, hasRequiredElements, hasRequiredPrompts$1, lib$1, hasRequiredLib$1, prompts$1, hasRequiredPrompts, promptsExports, prompts, isBrowser, platform, OSC = "\x1B]", BEL = "\x07", SEP = ";", link = (text2, url) => [
   OSC,
   "8",
   SEP,
@@ -32321,7 +32321,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "5.6.6",
+  version: "5.8.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -32370,10 +32370,10 @@ var package_default = {
   dependencies: {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.3.7",
-    "@secondlayer/sdk": "^5.0.0",
-    "@secondlayer/shared": "^6.8.1",
-    "@secondlayer/stacks": "^2.2.1",
-    "@secondlayer/subgraphs": "^3.2.1",
+    "@secondlayer/sdk": "^5.6.0",
+    "@secondlayer/shared": "^6.9.0",
+    "@secondlayer/stacks": "^2.3.0",
+    "@secondlayer/subgraphs": "^3.4.0",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.0",
     esbuild: "^0.19.0",
@@ -34444,6 +34444,7 @@ import { confirm as confirm4 } from "@inquirer/prompts";
 
 // src/generators/subgraph-scaffold.ts
 init_format();
+import { classifyContract } from "@secondlayer/stacks/clarity";
 
 // src/generators/clarity-to-subgraph.ts
 import {
@@ -34496,65 +34497,121 @@ function mapType(abiType, nullable) {
 function toCamelCase2(str) {
   return str.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
 }
-async function generateSubgraphScaffold(input2) {
-  const { contractId, functions } = input2;
-  const contractParts = contractId.split(".");
-  const contractName = contractParts[contractParts.length - 1] ?? contractId;
-  const subgraphName = input2.subgraphName ?? contractName;
-  const publicFunctions = functions.filter((f) => f.access === "public");
-  if (publicFunctions.length === 0) {
-    throw new Error(`No public functions found in ${contractId}`);
-  }
-  const sourceEntries = publicFunctions.map((fn) => {
-    const sourceName = toCamelCase2(fn.name);
-    return `    ${sourceName}: { type: 'contract_call', contractId: '${contractId}', functionName: '${fn.name}' }`;
-  });
-  const sourcesBlock = sourceEntries.join(`,
-`);
-  const tables = publicFunctions.map((fn) => {
-    const columns = fn.args.map((arg) => {
-      const mapped = clarityTypeToSubgraphColumn(arg.type);
-      const nullable = mapped.nullable ? ", nullable: true" : "";
-      return `        ${arg.name.replace(/-/g, "_")}: { type: '${mapped.type}'${nullable} }`;
-    }).join(`,
-`);
-    const tableName = fn.name.replace(/-/g, "_");
-    return `    ${tableName}: {
-      columns: {
-${columns || "        _placeholder: { type: 'text' }"}
-      }
-    }`;
-  });
-  const schemaBlock = tables.join(`,
-`);
-  const handlerEntries = publicFunctions.map((fn) => {
-    const sourceName = toCamelCase2(fn.name);
-    return `    ${sourceName}: async (event, ctx) => {
-      // TODO: implement ${fn.name} handler
-      // event.args contains the function arguments
-      // ctx.insert('${fn.name.replace(/-/g, "_")}', { ... })
-    }`;
-  });
-  const handlersBlock = handlerEntries.join(`,
-
-`);
-  const code = `
+function snake(str) {
+  return str.replace(/-/g, "_");
+}
+function wrap(name, sources, schema, handlers) {
+  return `
 import { defineSubgraph } from '@secondlayer/subgraphs';
 
 export default defineSubgraph({
-  name: '${subgraphName}',
+  name: '${name}',
   sources: {
-${sourcesBlock}
+${sources}
   },
   schema: {
-${schemaBlock}
+${schema}
   },
   handlers: {
-${handlersBlock}
+${handlers}
   }
 });
 `.trimStart();
-  return formatCode(code);
+}
+function tokenScaffold(name, source) {
+  const isFt = source.type === "ft_transfer";
+  const scope = source.trait ? `trait: '${source.trait}'` : `assetIdentifier: '${source.assetIdentifier}'`;
+  const cols = isFt ? `        sender: { type: 'principal' },
+        recipient: { type: 'principal' },
+        amount: { type: 'uint' },
+        asset_identifier: { type: 'principal', indexed: true }` : `        sender: { type: 'principal' },
+        recipient: { type: 'principal' },
+        token_id: { type: 'text' },
+        asset_identifier: { type: 'principal', indexed: true }`;
+  const insert = isFt ? `{ sender: event.sender, recipient: event.recipient, amount: event.amount, asset_identifier: event.assetIdentifier }` : `{ sender: event.sender, recipient: event.recipient, token_id: String(event.tokenId), asset_identifier: event.assetIdentifier }`;
+  return wrap(name, `    transfers: { type: '${source.type}', ${scope} }`, `    transfers: {
+      columns: {
+${cols}
+      }
+    }`, `    transfers: (event, ctx) => {
+      ctx.insert('transfers', ${insert});
+    }`);
+}
+function genericCallsScaffold(name, contractId) {
+  return wrap(name, `    calls: { type: 'contract_call', contractId: '${contractId}' }`, `    calls: {
+      columns: {
+        function_name: { type: 'text', indexed: true },
+        sender: { type: 'principal' },
+        args: { type: 'jsonb' }
+      }
+    }`, `    calls: (event, ctx) => {
+      ctx.insert('calls', { function_name: event.functionName, sender: event.sender, args: { values: event.args } });
+    }`);
+}
+function functionsScaffold(name, contractId, abi, fnNames) {
+  const fns = abi.functions.filter((f) => f.access === "public" && fnNames.includes(f.name));
+  if (fns.length === 0) {
+    throw new Error(`none of --functions [${fnNames.join(", ")}] are public functions of ${contractId}`);
+  }
+  const sources = fns.map((f) => `    ${toCamelCase2(f.name)}: { type: 'contract_call', contractId: '${contractId}', functionName: '${f.name}' }`).join(`,
+`);
+  const schema = fns.map((f) => {
+    const cols = f.args.map((arg) => {
+      const m = clarityTypeToSubgraphColumn(arg.type);
+      return `        ${snake(arg.name)}: { type: '${m.type}'${m.nullable ? ", nullable: true" : ""} }`;
+    }).join(`,
+`);
+    return `    ${snake(f.name)}: {
+      columns: {
+${cols || "        sender: { type: 'principal' }"}
+      }
+    }`;
+  }).join(`,
+`);
+  const handlers = fns.map((f) => {
+    const inserts = f.args.map((arg, i) => {
+      const m = clarityTypeToSubgraphColumn(arg.type);
+      const ts = m.type === "uint" || m.type === "int" ? "bigint" : m.type === "boolean" ? "boolean" : "string";
+      return `${snake(arg.name)}: event.args[${i}] as ${ts}`;
+    }).join(", ");
+    return `    ${toCamelCase2(f.name)}: (event, ctx) => {
+      ctx.insert('${snake(f.name)}', { ${inserts} });
+    }`;
+  }).join(`,
+
+`);
+  return wrap(name, sources, schema, handlers);
+}
+async function generateSubgraphScaffold(input2) {
+  if (input2.trait) {
+    const name2 = input2.subgraphName ?? `${input2.trait}-transfers`;
+    const type = input2.trait === "sip-009" ? "nft_transfer" : "ft_transfer";
+    return formatCode(tokenScaffold(name2, { type, trait: input2.trait }));
+  }
+  const { contractId, abi } = input2;
+  if (!contractId || !abi) {
+    throw new Error("scaffold requires a contractId + abi (or --trait)");
+  }
+  const name = input2.subgraphName ?? contractId.split(".").pop() ?? contractId;
+  if (input2.functions && input2.functions.length > 0) {
+    return formatCode(functionsScaffold(name, contractId, abi, input2.functions));
+  }
+  const standards = classifyContract(abi);
+  if (standards.includes("sip-010")) {
+    const asset = abi.fungible_tokens?.[0]?.name;
+    return formatCode(tokenScaffold(name, {
+      type: "ft_transfer",
+      assetIdentifier: asset ? `${contractId}::${asset}` : contractId
+    }));
+  }
+  if (standards.includes("sip-009")) {
+    const asset = abi.non_fungible_tokens?.[0]?.name;
+    return formatCode(tokenScaffold(name, {
+      type: "nft_transfer",
+      assetIdentifier: asset ? `${contractId}::${asset}` : contractId
+    }));
+  }
+  return formatCode(genericCallsScaffold(name, contractId));
 }
 
 // src/utils/case-conversion.ts
@@ -35475,7 +35532,7 @@ Stopped watching.`);
     });
     await new Promise(() => {});
   });
-  subgraphs.command("deploy <file>").description("Deploy a subgraph definition file").option("--start-block <n>", "Override the subgraph definition startBlock for this deploy").option("--dry-run", "Validate and preview deploy without writing changes").option("--preview", "Alias for --dry-run").option("--force", "Skip confirmation prompt for reindex operations").option("--strict", "Run `tsc --noEmit` against the handler before deploy (slower; catches TS type errors)").action(async (file, options2) => {
+  subgraphs.command("deploy <file>").description("Deploy a subgraph definition file").option("--start-block <n>", "Override the subgraph definition startBlock for this deploy").option("--dry-run", "Validate and preview deploy without writing changes").option("--preview", "Alias for --dry-run").option("--force", "Skip confirmation prompt for reindex operations").option("--database-url <url>", "BYO data plane: write the subgraph's schema/rows to your own Postgres. With --dry-run, prints the DDL + grant script and verifies the connection.").option("--strict", "Run `tsc --noEmit` against the handler before deploy (slower; catches TS type errors)").action(async (file, options2) => {
     try {
       const absPath = resolve2(file);
       const config = await loadConfig();
@@ -35518,6 +35575,9 @@ Stopped watching.`);
           return;
         }
         const deployStartBlock = startBlock ?? effectiveDef.startBlock;
+        if (options2.databaseUrl) {
+          info("BYO data plane: schema + rows will live in your database. The server verifies the connection before deploying.");
+        }
         const result = await deploySubgraphApi({
           name: effectiveDef.name,
           version: undefined,
@@ -35526,7 +35586,8 @@ Stopped watching.`);
           schema: effectiveDef.schema,
           handlerCode,
           sourceCode: source,
-          ...deployStartBlock !== undefined ? { startBlock: deployStartBlock } : {}
+          ...deployStartBlock !== undefined ? { startBlock: deployStartBlock } : {},
+          ...options2.databaseUrl ? { databaseUrl: options2.databaseUrl } : {}
         });
         const printDeployFooter = async () => {
           try {
@@ -35772,6 +35833,48 @@ Synced — exiting watch.`));
       process.exit(1);
     }
   });
+  subgraphs.command("codegen <file>").description("Generate an ORM schema (Prisma or Drizzle) for a subgraph's tables — point it at your BYO database").option("--target <orm>", "ORM target: prisma | drizzle", "prisma").option("--schema <name>", "Postgres schema name (defaults to subgraph_<name>)").option("--env <var>", "datasource url env var", "DATABASE_URL").option("--models-only", "Emit only Prisma models (compose via prismaSchemaFolder)").option("-o, --output <path>", "Write to a file (defaults to stdout)").action(async (file, options2) => {
+    try {
+      const target = options2.target ?? "prisma";
+      if (target !== "prisma" && target !== "drizzle") {
+        error(`Unsupported --target "${target}" (supported: prisma, drizzle). For Kysely, run kysely-codegen against your database.`);
+        process.exit(1);
+      }
+      const absPath = resolve2(file);
+      if (!existsSync2(absPath)) {
+        error(`File not found: ${absPath}`);
+        process.exit(1);
+      }
+      const { readFile: readFile3 } = await import("node:fs/promises");
+      const { bundleSubgraphCode } = await import("@secondlayer/bundler");
+      const { generatePrismaSchema, generateDrizzleSchema } = await import("@secondlayer/subgraphs");
+      const source = await readFile3(absPath, "utf8");
+      const bundled = await bundleSubgraphCode(source);
+      const def = {
+        name: bundled.name,
+        version: bundled.version,
+        description: bundled.description,
+        sources: bundled.sources,
+        schema: bundled.schema,
+        handlers: {}
+      };
+      const out = target === "drizzle" ? generateDrizzleSchema(def, { schemaName: options2.schema }) : generatePrismaSchema(def, {
+        schemaName: options2.schema,
+        datasourceEnv: options2.env,
+        modelsOnly: options2.modelsOnly
+      });
+      if (options2.output) {
+        await writeTextFile(resolve2(options2.output), out);
+        success(`Wrote ${target} schema to ${options2.output}`);
+        info("Next: point its datasource at your BYO database, then `prisma generate`.");
+      } else {
+        process.stdout.write(out);
+      }
+    } catch (err) {
+      error(`Failed to generate schema: ${err}`);
+      process.exit(1);
+    }
+  });
   subgraphs.command("reindex <name>").description("Reindex a subgraph from historical blocks (drops + reprocesses)").option("--from <block>", "Start block height").option("--to <block>", "End block height").option("-y, --yes", "Skip confirmation").action(async (name, options2) => {
     try {
       const fromBlock = options2.from ? Number.parseInt(options2.from, 10) : undefined;
@@ -35965,24 +36068,41 @@ ${rows.length} row(s)`));
       handleApiError(err, "delete subgraph");
     }
   });
-  subgraphs.command("scaffold <contractAddress>").description("Scaffold a defineSubgraph() file from a contract ABI").option("-o, --output <path>", "Output file path (required)").option("--api-key <key>", "Stacks node API key for direct RPC URLs").option("--no-install", "Skip bun install after writing package.json").action(async (contractAddress, options2) => {
+  subgraphs.command("scaffold [contractAddress]").description("Scaffold a defineSubgraph() file. Detects SIP-010/009 → ft/nft source; --functions for typed call tables; --trait for a trait-scoped source (no contract)").option("-o, --output <path>", "Output file path (required)").option("--api-key <key>", "Stacks node API key for direct RPC URLs").option("--functions <names>", "Comma-separated public functions to index as typed contract_call tables").option("--trait <std>", "Scaffold a trait-scoped source (sip-009|sip-010|sip-013) — no contract needed").option("--no-install", "Skip bun install after writing package.json").action(async (contractAddress, options2) => {
     try {
       if (!options2.output) {
         error("--output <path> is required");
         process.exit(1);
       }
+      const trait = options2.trait;
+      if (trait && !["sip-009", "sip-010", "sip-013"].includes(trait)) {
+        error("--trait must be one of: sip-009, sip-010, sip-013");
+        process.exit(1);
+      }
+      if (!trait && !contractAddress) {
+        error("a <contractAddress> is required (or use --trait)");
+        process.exit(1);
+      }
       const outPath = resolve2(options2.output);
-      const network = inferNetwork(contractAddress) ?? "mainnet";
-      const apiKey = options2.apiKey ?? process.env.STACKS_NODE_API_KEY ?? process.env.HIRO_API_KEY;
-      const client = new StacksApiClient(network, apiKey);
-      info(`Fetching ABI for ${contractAddress} via ${client.describeContractInfoSource()}...`);
-      const contractInfo = await client.getContractInfo(contractAddress);
-      const abi = parseApiResponse(contractInfo);
-      info("Generating scaffold...");
-      const content = await generateSubgraphScaffold({
-        contractId: contractAddress,
-        functions: abi.functions
-      });
+      let content;
+      if (trait) {
+        info(`Generating trait-scoped scaffold for ${trait}...`);
+        content = await generateSubgraphScaffold({ trait });
+      } else {
+        const address = contractAddress;
+        const network = inferNetwork(address) ?? "mainnet";
+        const apiKey = options2.apiKey ?? process.env.STACKS_NODE_API_KEY ?? process.env.HIRO_API_KEY;
+        const client = new StacksApiClient(network, apiKey);
+        info(`Fetching ABI for ${address} via ${client.describeContractInfoSource()}...`);
+        const contractInfo = await client.getContractInfo(address);
+        const abi = parseApiResponse(contractInfo);
+        info("Generating scaffold...");
+        content = await generateSubgraphScaffold({
+          contractId: address,
+          abi,
+          functions: options2.functions?.split(",").map((f) => f.trim()).filter(Boolean)
+        });
+      }
       const dir = resolve2(outPath, "..");
       if (!existsSync2(dir))
         mkdirSync2(dir, { recursive: true });
@@ -36007,7 +36127,7 @@ ${rows.length} row(s)`));
       process.exit(1);
     }
   });
-  subgraphs.command("generate <subgraphName>").description("Generate a typed client for a deployed subgraph").option("-o, --output <path>", "Output file path (required)").action(async (subgraphName, options2) => {
+  subgraphs.command("client <subgraphName>").alias("generate").description("Generate a typed query client for a deployed subgraph").option("-o, --output <path>", "Output file path (required)").action(async (subgraphName, options2) => {
     try {
       if (!options2.output) {
         error("--output <path> is required");
@@ -36353,6 +36473,60 @@ function registerStreamsCommand(program2) {
     }
   });
 }
+// src/commands/datasets.ts
+init_output();
+import { CURSOR_SLUGS, Datasets } from "@secondlayer/sdk";
+var DEFAULT_BASE_URL2 = "https://api.secondlayer.tools";
+function client2() {
+  return new Datasets({ baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL2 });
+}
+function parseFilters(pairs) {
+  const out = {};
+  for (const pair of pairs ?? []) {
+    const eq = pair.indexOf("=");
+    if (eq <= 0) {
+      throw new Error(`invalid --filter "${pair}" (expected key=value)`);
+    }
+    out[pair.slice(0, eq)] = pair.slice(eq + 1);
+  }
+  return out;
+}
+function registerDatasetsCommand(program2) {
+  const datasets = program2.command("datasets").description("Query Foundation Datasets (sBTC, BNS, PoX-4, STX transfers)");
+  datasets.command("list").description("List the dataset catalog + freshness").action(async () => {
+    try {
+      const catalog = await client2().listDatasets();
+      process.stdout.write(`${JSON.stringify(catalog, null, 2)}
+`);
+    } catch (err) {
+      error(`Failed to list datasets: ${err}`);
+      process.exit(1);
+    }
+  });
+  datasets.command("query <dataset>").description(`Query a cursor-paginated dataset (${Object.keys(CURSOR_SLUGS).join(", ")})`).option("--filter <key=value...>", "Filter as key=value (e.g. --filter stacker=SP… --filter address=SP…)").option("--limit <n>", "Rows per page").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--json", "Print the full envelope as JSON").action(async (dataset, options2) => {
+    try {
+      const params = parseFilters(options2.filter);
+      if (options2.limit)
+        params.limit = Number.parseInt(options2.limit, 10);
+      if (options2.cursor)
+        params.cursor = options2.cursor;
+      const env = await client2().query(dataset, params);
+      if (options2.json) {
+        process.stdout.write(`${JSON.stringify(env, null, 2)}
+`);
+      } else {
+        process.stdout.write(`${JSON.stringify(env.rows, null, 2)}
+`);
+        if (env.next_cursor) {
+          info(`next_cursor: ${env.next_cursor}`);
+        }
+      }
+    } catch (err) {
+      error(`Failed to query dataset: ${err}`);
+      process.exit(1);
+    }
+  });
+}
 // src/commands/doctor.ts
 init_config();
 
@@ -37203,7 +37377,7 @@ Quickstart:
   $ sl subgraphs deploy subgraphs/my-watcher.ts
   $ sl subgraphs status my-watcher
 `);
-program.command("generate [files...]").aliases(["gen", "codegen"]).description("Generate TypeScript interfaces from Clarity contracts").option("-c, --config <path>", "Path to config file").option("-o, --out <path>", "Output file path (required when using direct files)").option("-k, --api-key <key>", "Stacks node API key for direct RPC URLs").option("-w, --watch", "Watch for changes").action(async (files, options3) => {
+program.command("generate [files...]").aliases(["gen"]).description("Generate TypeScript interfaces from Clarity contracts").option("-c, --config <path>", "Path to config file").option("-o, --out <path>", "Output file path (required when using direct files)").option("-k, --api-key <key>", "Stacks node API key for direct RPC URLs").option("-w, --watch", "Watch for changes").action(async (files, options3) => {
   const { generate: generate2 } = await Promise.resolve().then(() => (init_generate(), exports_generate));
   await generate2(files, options3);
 });
@@ -37219,6 +37393,7 @@ registerSubgraphsCommand(program);
 registerCreateCommand(program);
 registerSubscriptionsCommand(program);
 registerStreamsCommand(program);
+registerDatasetsCommand(program);
 registerStatusCommand(program);
 registerStackCommand(program);
 registerDbCommand(program);
@@ -37229,5 +37404,5 @@ registerAccountCommand(program);
 registerBillingCommand(program);
 program.parse();
 
-//# debugId=D5912487DCB1DB8664756E2164756E21
+//# debugId=BC7D4D440C943F4464756E2164756E21
 //# sourceMappingURL=cli.js.map