@secondlayer/cli 8.14.2 → 9.0.0

package/README.md

@@ -167,6 +167,7 @@ address prefix), or globs.
 sl contracts generate ./contracts/token.clar -o ./src/generated.ts
 sl contracts generate SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9.alex-vault -o ./src/generated.ts
 sl contracts generate "./contracts/*.clar" -o ./src/generated.ts
+sl contracts generate --watch   # regenerate on .clar / config / Clarinet.toml changes
 ```
 
 Config-driven:
@@ -179,33 +180,36 @@ sl contracts generate  # regenerates from the config
 ```typescript
 // secondlayer.config.ts
 import { defineConfig } from "@secondlayer/cli"
-import { clarinet, actions, react } from "@secondlayer/cli/plugins"
+import { clarinet, react } from "@secondlayer/cli/plugins"
 
 export default defineConfig({
   out: "src/generated.ts",
-  plugins: [clarinet(), actions(), react()],
+  plugins: [clarinet(), react()],
 })
 ```
 
 | Plugin | What it adds |
 |---|---|
-| `clarinet()` | Parse local Clarinet project |
-| `actions()` | `read.*` + `write.*` helpers per contract |
+| `clarinet()` | Parse local Clarinet project — includes `[project.requirements]` dependency contracts too (`includeRequirements: false` to opt out) |
 | `react()` | Typed React Query hooks |
 | `testing()` | Clarinet SDK test helpers |
 
+Generated output includes named per-function type aliases (`TokenTransferArgs`,
+`TokenTransferResult`), a `TokenTypes` bundle, and a `tokenAbi` const branded
+with `TypedAbi` — `getContract` from `@secondlayer/stacks` picks up the brand
+so hovers and type errors show the named aliases instead of expanded inline
+types.
+
 ```typescript
 import { token } from "./generated/contracts"
 
-// Works with @stacks/transactions directly:
+// Generated call descriptors compose with any tx builder:
 await makeContractCall({
   ...token.transfer({ amount: 100n, recipient: "SP..." }),
   network: "mainnet",
 })
 
-// With actions() — read/write helpers + maps/vars/constants:
-const balance = await token.read.getBalance({ account: "SP..." })
-await token.write.transfer({ amount: 100n, recipient: "SP..." })
+// Maps/vars/constants accessors are built in:
 const supply = await token.vars.totalSupply.get()
 ```
 

package/dist/cli.js

@@ -31647,6 +31647,14 @@ async function buildConfigFromInputs(parsedInputs, outPath, apiKey, defaultAddre
   };
 }
 async function generate(files, options3) {
+  if (!options3.watch) {
+    await runGenerate(files, options3, { exitOnError: true });
+    return;
+  }
+  await runGenerate(files, options3, { exitOnError: false });
+  await watchAndRegenerate(files, options3);
+}
+async function runGenerate(files, options3, { exitOnError }) {
   try {
     let config;
     if (files && files.length > 0) {
@@ -31723,8 +31731,96 @@ ${getErrorMessage2(error2)}`));
     if (process.env.DEBUG && error2 instanceof Error) {
       console.error(error2.stack);
     }
-    process.exit(1);
+    if (exitOnError) {
+      process.exit(1);
+    }
+  }
+}
+function isWatchRelevant(filename) {
+  return filename.endsWith(".clar") || filename.endsWith(".toml") || filename.startsWith("secondlayer.config");
+}
+async function collectWatchTargets(files, options3) {
+  const { promises: fs8 } = await import("node:fs");
+  const dirs = new Map;
+  const addParentDir = (filePath) => {
+    const dir = path11.dirname(path11.resolve(process.cwd(), filePath));
+    if (!dirs.get(dir))
+      dirs.set(dir, false);
+  };
+  if (files && files.length > 0) {
+    const parsedInputs = await parseInputs(files);
+    for (const file of parsedInputs.files) {
+      addParentDir(file);
+    }
+  } else {
+    const configPath = options3.config ? path11.resolve(process.cwd(), options3.config) : await findConfigFile(process.cwd());
+    if (configPath)
+      addParentDir(configPath);
+    try {
+      const config = await loadConfig2(options3.config);
+      for (const contract of config.contracts || []) {
+        if (contract.source)
+          addParentDir(contract.source);
+      }
+    } catch {}
+    const manifestPath = path11.resolve(process.cwd(), "Clarinet.toml");
+    try {
+      await fs8.access(manifestPath);
+      addParentDir(manifestPath);
+      const contractsDir = path11.resolve(process.cwd(), "contracts");
+      try {
+        const stat2 = await fs8.stat(contractsDir);
+        if (stat2.isDirectory())
+          dirs.set(contractsDir, true);
+      } catch {}
+    } catch {}
   }
+  return [...dirs.entries()].map(([dir, recursive]) => ({
+    path: dir,
+    recursive
+  }));
+}
+async function watchAndRegenerate(files, options3) {
+  const { watch: watch2 } = await import("node:fs");
+  const targets = await collectWatchTargets(files, options3);
+  if (targets.length === 0) {
+    console.log(source_default3.yellow("⚠ Nothing to watch — no local inputs were found"));
+    return;
+  }
+  console.log(source_default3.cyan(`\uD83D\uDC40 Watching ${targets.length} ${targets.length === 1 ? "location" : "locations"} for changes — press Ctrl+C to stop`));
+  let timer3;
+  let running = false;
+  let rerunRequested = false;
+  const regenerate = async (changed) => {
+    if (running) {
+      rerunRequested = true;
+      return;
+    }
+    running = true;
+    console.log(source_default3.gray(`↻ ${changed ? `${changed} changed` : "Change detected"} — regenerating...`));
+    await runGenerate(files, options3, { exitOnError: false });
+    running = false;
+    if (rerunRequested) {
+      rerunRequested = false;
+      await regenerate();
+    }
+  };
+  const onEvent = (filename) => {
+    const name = typeof filename === "string" ? filename : filename?.toString();
+    if (name && !isWatchRelevant(path11.basename(name)))
+      return;
+    if (timer3)
+      clearTimeout(timer3);
+    timer3 = setTimeout(() => void regenerate(name ?? undefined), 150);
+  };
+  for (const target of targets) {
+    try {
+      watch2(target.path, { recursive: target.recursive }, (_event, filename) => onEvent(filename));
+    } catch {
+      console.warn(source_default3.yellow(`⚠ Could not watch ${target.path}`));
+    }
+  }
+  await new Promise(() => {});
 }
 async function resolveContract(source, network, apiKey, apiUrl) {
   if (source.source) {
@@ -31824,7 +31920,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "8.14.2",
+  version: "9.0.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -31873,11 +31969,11 @@ var package_default = {
   dependencies: {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.4.0",
-    "@secondlayer/scaffold": "^1.3.0",
+    "@secondlayer/scaffold": "^1.4.0",
     "@secondlayer/sdk": "^6.23.1",
-    "@secondlayer/shared": "^6.40.0",
-    "@secondlayer/stacks": "^2.5.1",
-    "@secondlayer/subgraphs": "^3.19.3",
+    "@secondlayer/shared": "^6.41.3",
+    "@secondlayer/stacks": "^2.11.0",
+    "@secondlayer/subgraphs": "^3.19.6",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.0",
     esbuild: "^0.19.0",
@@ -38149,5 +38245,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=C45149549275867964756E2164756E21
+//# debugId=4C5A2BC0BF36CBB764756E2164756E21
 //# sourceMappingURL=cli.js.map