@secondlayer/cli 5.3.0 → 5.4.1

package/dist/cli.js

@@ -32321,7 +32321,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "5.3.0",
+  version: "5.4.1",
   description: "CLI for subgraphs and blockchain indexing on Stacks",
   type: "module",
   bin: {
@@ -32365,9 +32365,9 @@ var package_default = {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.3.5",
     "@secondlayer/sdk": "^3.6.0",
-    "@secondlayer/shared": "^6.4.0",
+    "@secondlayer/shared": "^6.4.1",
     "@secondlayer/stacks": "^2.2.0",
-    "@secondlayer/subgraphs": "^2.0.0",
+    "@secondlayer/subgraphs": "^2.0.2",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.0",
     esbuild: "^0.19.0",
@@ -33095,6 +33095,21 @@ async function validateSubscriptionTargetFromApi(client, input) {
   }
 }
 
+// src/utils/urls.ts
+function deriveBaseUrl(apiUrl) {
+  const override = process.env.SL_DASHBOARD_URL?.trim();
+  if (override)
+    return override.replace(/\/$/, "");
+  try {
+    const url = new URL(apiUrl);
+    url.hostname = url.hostname.replace(/^api\./, "");
+    url.pathname = "/";
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return apiUrl.replace(/\/$/, "");
+  }
+}
+
 // src/commands/create.ts
 var RUNTIMES = ["inngest", "trigger", "cloudflare", "node"];
 var FORMAT_BY_RUNTIME = {
@@ -33158,6 +33173,10 @@ function buildSubscriptionAuthConfig(authToken) {
   return { authType: "bearer", token };
 }
 async function createSubscription(name, opts) {
+  if (opts.runtime && !RUNTIMES.includes(opts.runtime)) {
+    error(`Unknown --runtime "${opts.runtime}". Valid: ${RUNTIMES.join(", ")}`);
+    process.exit(1);
+  }
   const { runtime, subgraph, table, url } = await promptFor(name, opts);
   let filter;
   let authConfig;
@@ -33220,31 +33239,52 @@ async function createSubscription(name, opts) {
       info("Template copied, but the subscription was not created. Provision it in the dashboard, or remove the template directory and rerun this command after fixing the API error.");
     }
   }
+  let subscriptionId;
+  let subscriptionStatus;
+  if (sl) {
+    try {
+      const list = await sl.subscriptions.list();
+      const rows = list.data ?? [];
+      const created = rows.find((s) => s.name === name);
+      subscriptionId = created?.id;
+      subscriptionStatus = created?.status;
+    } catch {}
+  }
   if (signingSecret) {
     const envTarget = join4(targetDir, ".env");
     const envExample = join4(targetDir, ".env.example");
     if (existsSync(envExample) && !existsSync(envTarget)) {
       copyFileSync(envExample, envTarget);
     }
-    if (existsSync(envTarget)) {
+    if (!existsSync(envTarget)) {
+      writeFileSync(envTarget, `SIGNING_SECRET=${signingSecret}
+`);
+    } else {
       const cur = readFileSync(envTarget, "utf8");
-      const next = cur.replace(/^SIGNING_SECRET=.*/m, `SIGNING_SECRET=${signingSecret}`);
-      writeFileSync(envTarget, next.includes("SIGNING_SECRET=") ? next : `${cur}
+      writeFileSync(envTarget, cur.match(/^SIGNING_SECRET=/m) ? cur.replace(/^SIGNING_SECRET=.*/m, `SIGNING_SECRET=${signingSecret}`) : `${cur}
 SIGNING_SECRET=${signingSecret}
 `);
-      success(`Signing secret written to ${relative(process.cwd(), envTarget)}`);
-    } else {
-      info(`Signing secret (copy this — won't be shown again):
-${dim("  ")}${signingSecret}`);
     }
+    success(`Signing secret written to ${relative(process.cwd(), envTarget)}`);
   }
   console.log();
   if (provisioningFailed) {
     error("Subscription was not created.");
     process.exit(1);
   }
+  let dashboardLine = "";
+  try {
+    const { apiUrl } = await resolveActiveTenant();
+    const base = deriveBaseUrl(apiUrl);
+    dashboardLine = subscriptionId ? `Dashboard: ${base}/platform/subgraphs/${subgraph}/subscriptions/${subscriptionId}
+  ` : `Dashboard: ${base}/platform/subgraphs/${subgraph}/subscriptions
+  `;
+  } catch {}
+  const pausedLine = subscriptionStatus === "paused" ? `Subscription is paused. Resume:
+  sl subscriptions resume ${name}
+  ` : "";
   success(`Done. Next:
-  cd ${name}
+  ${dashboardLine}${pausedLine}cd ${name}
   bun install
   bun run dev`);
 }
@@ -33428,6 +33468,10 @@ async function resolveSubscriptionRef(client, ref) {
       detail: await client.subscriptions.get(nameMatches[0].id)
     };
   }
+  const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  if (!UUID_RE.test(ref)) {
+    throw new Error(`Subscription "${ref}" not found.`);
+  }
   return {
     id: ref,
     detail: await client.subscriptions.get(ref)
@@ -33485,6 +33529,7 @@ function printSubscriptionDetail(sub) {
     ["Circuit Opened", sub.circuitOpenedAt ?? "none"],
     ["Last Error", sub.lastError ?? "none"],
     ["Max Retries", String(sub.maxRetries)],
+    ["Backoff", "30s → 2m → 10m → 1h → 6h → 24h → 72h"],
     ["Timeout", `${sub.timeoutMs}ms`],
     ["Concurrency", String(sub.concurrency)],
     ["Created", sub.createdAt],
@@ -33791,7 +33836,22 @@ ${data.length} subscription(s) total`));
   commonOptions(subscriptions.command("delete <idOrName>").description("Delete a subscription").option("-y, --yes", "Skip confirmation").option("--json", "Output as JSON")).action(async (idOrName, options) => {
     try {
       const client = await getSubscriptionClient(options);
-      const { id, detail } = await resolveSubscriptionRef(client, idOrName);
+      let resolved = null;
+      try {
+        resolved = await resolveSubscriptionRef(client, idOrName);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const status = err?.status;
+        if (status === 404 || /not found/i.test(msg)) {
+          if (options.json)
+            printJson({ deleted: false, reason: "not_found" });
+          else
+            info(`Subscription "${idOrName}" not found (already deleted?)`);
+          return;
+        }
+        throw err;
+      }
+      const { id, detail } = resolved;
       const ok = await confirmOrExit(`Delete subscription "${detail.name}"? Pending outbox rows will be removed.`, options.yes);
       if (!ok)
         return;
@@ -34971,6 +35031,45 @@ function decodeBuffUtf8(value: unknown): string | null {
 
 // src/commands/subgraphs.ts
 init_api();
+init_resolve_tenant();
+async function loadSubgraphWithDepCheck(absPath) {
+  try {
+    return await import(absPath);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    const code = err?.code;
+    const missingSdk = (code === "ERR_MODULE_NOT_FOUND" || msg.includes("ERR_MODULE_NOT_FOUND")) && msg.includes("@secondlayer/subgraphs");
+    if (!missingSdk)
+      throw err;
+    warn("Missing dependency: @secondlayer/subgraphs");
+    const install = await confirm3({
+      message: "Install with `bun add @secondlayer/subgraphs`?",
+      default: true
+    });
+    if (!install)
+      throw err;
+    await new Promise((res, rej) => {
+      const child = spawn("bun", ["add", "@secondlayer/subgraphs"], {
+        stdio: "inherit"
+      });
+      child.on("error", rej);
+      child.on("exit", (c) => c === 0 ? res() : rej(new Error(`bun add exit ${c}`)));
+    });
+    return await import(absPath);
+  }
+}
+async function typecheckHandler(absPath) {
+  await new Promise((res, rej) => {
+    const child = spawn("bunx", ["tsc", "--noEmit", "--allowJs", "--target", "es2022", absPath], { stdio: "inherit" });
+    child.on("error", (err) => rej(new Error(`Failed to run tsc — install typescript (\`bun add -d typescript\`) or drop --strict. (${err.message})`)));
+    child.on("exit", (code) => {
+      if (code === 0)
+        res();
+      else
+        rej(new Error(`Type-check failed (tsc exit ${code})`));
+    });
+  });
+}
 function parseStartBlockOption(value) {
   if (value === undefined)
     return;
@@ -35290,7 +35389,7 @@ Stopped watching.`);
     });
     await new Promise(() => {});
   });
-  subgraphs.command("deploy <file>").description("Deploy a subgraph definition file").option("--version <semver>", "Explicit version (default: auto-increment patch)").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").action(async (file, options2) => {
+  subgraphs.command("deploy <file>").description("Deploy a subgraph definition file").option("--version <semver>", "Explicit version (default: auto-increment patch)").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) => {
     try {
       const absPath = resolve2(file);
       const config = await loadConfig();
@@ -35302,8 +35401,12 @@ Stopped watching.`);
       if (startBlock !== undefined) {
         warn(`--start-block ${startBlock} overrides the definition's startBlock for this deploy.`);
       }
+      if (options2.strict) {
+        info("Type-checking handler (tsc --noEmit)...");
+        await typecheckHandler(absPath);
+      }
       info(`Loading subgraph from ${absPath}`);
-      const mod = await import(absPath);
+      const mod = await loadSubgraphWithDepCheck(absPath);
       const def = mod.default ?? mod;
       const effectiveDef = startBlock === undefined ? def : { ...def, startBlock };
       const { validateSubgraphDefinition } = await import("@secondlayer/subgraphs/validate");
@@ -35338,10 +35441,23 @@ Stopped watching.`);
           sourceCode: source,
           ...startBlock !== undefined ? { startBlock } : {}
         });
+        const printDeployFooter = async () => {
+          try {
+            const { apiUrl } = await resolveActiveTenant();
+            const baseUrl = deriveBaseUrl(apiUrl);
+            const firstTable = Object.keys(effectiveDef.schema ?? {})[0];
+            info(`  Dashboard: ${baseUrl}/platform/subgraphs/${effectiveDef.name}`);
+            if (firstTable) {
+              info(`  REST:      ${apiUrl}/api/subgraphs/${effectiveDef.name}/${firstTable}`);
+            }
+            info(`  Watch:     sl subgraphs status ${effectiveDef.name}`);
+          } catch {}
+        };
         if (result.action === "unchanged") {
           info(`Subgraph "${effectiveDef.name}" is up to date (v${result.version} — no changes)`);
         } else if (result.action === "created") {
           success(`Subgraph "${effectiveDef.name}" created → v${result.version}`);
+          await printDeployFooter();
         } else if (result.action === "reindexed") {
           if (result.diff) {
             const { addedTables, addedColumns, breakingChanges } = result.diff;
@@ -35364,6 +35480,7 @@ Stopped watching.`);
             process.exit(0);
           }
           success(`Subgraph "${effectiveDef.name}" updated → v${result.version} (reindexing)`);
+          await printDeployFooter();
         } else {
           if (result.diff) {
             const { addedTables, addedColumns } = result.diff;
@@ -35374,6 +35491,7 @@ Stopped watching.`);
             }
           }
           success(`Subgraph "${effectiveDef.name}" updated → v${result.version}`);
+          await printDeployFooter();
         }
       } else {
         if (dryRun) {
@@ -35438,8 +35556,8 @@ ${data.length} subgraph(s) total`));
       handleApiError(err, "list subgraphs");
     }
   });
-  subgraphs.command("status <name>").description("Show detailed subgraph status").action(async (name) => {
-    try {
+  subgraphs.command("status <name>").description("Show detailed subgraph status").option("-w, --watch", "Refresh every 2s until synced or Ctrl-C").action(async (name, options2) => {
+    const renderOnce = async () => {
       const subgraph = await getSubgraphApi(name);
       const rowCounts = Object.entries(subgraph.tables).map(([t, info2]) => `${t}: ${info2.rowCount}`).join(", ") || "N/A";
       const totalRows = Object.values(subgraph.tables).reduce((sum, info2) => sum + info2.rowCount, 0);
@@ -35482,6 +35600,23 @@ Table endpoints:`));
           console.log(dim(`  ${info2.endpoint}`));
         }
       }
+      return subgraph;
+    };
+    try {
+      if (!options2.watch) {
+        await renderOnce();
+        return;
+      }
+      while (true) {
+        process.stdout.write("\x1Bc");
+        const sg = await renderOnce();
+        if (sg && sg.status === "synced") {
+          console.log(dim(`
+Synced — exiting watch.`));
+          return;
+        }
+        await new Promise((res) => setTimeout(res, 2000));
+      }
     } catch (err) {
       handleApiError(err, "get subgraph status");
     }
@@ -35671,9 +35806,19 @@ ${rows.length} row(s)`));
     try {
       if (!options2.yes && !options2.force) {
         const { confirm: confirm4 } = await import("@inquirer/prompts");
-        const ok = await confirm4({
-          message: `Delete subgraph "${name}" and all its data? This cannot be undone.`
-        });
+        let ok = false;
+        try {
+          ok = await confirm4({
+            message: `Delete subgraph "${name}" and all its data? This cannot be undone.`
+          });
+        } catch (promptErr) {
+          const m = promptErr instanceof Error ? promptErr.message : String(promptErr);
+          if (m.includes("ExitPromptError") || m.includes("force closed")) {
+            error("Interactive prompt unavailable. Re-run with -y to skip confirmation.");
+            process.exit(1);
+          }
+          throw promptErr;
+        }
         if (!ok) {
           info("Cancelled");
           return;
@@ -36955,5 +37100,5 @@ registerAccountCommand(program);
 registerBillingCommand(program);
 program.parse();
 
-//# debugId=C9F2E56BDB69B19A64756E2164756E21
+//# debugId=F6198A7D6A4B4A3F64756E2164756E21
 //# sourceMappingURL=cli.js.map