@secondlayer/cli 17.0.1 → 17.0.3

package/README.md

@@ -23,6 +23,22 @@ export SECONDLAYER_API_URL=http://127.0.0.1:3800
 export INSTANCE_TOKEN=<from secondlayer init>
 ```
 
+### Hosted commands (`webhooks`, `subgraphs`) — credential resolution order
+
+Against `api.secondlayer.tools`, `resolveHostedAuth()` tries these in order —
+the first one set wins:
+
+| Order | Source | Notes |
+|---|---|---|
+| 1 | `SECONDLAYER_API_KEY` (`sk-sl_*`) | Hosted account key |
+| 2 | `INSTANCE_TOKEN` / `--api-key` | Rarely set on the merchant host |
+| 3 | Saved session, `~/.secondlayer/session.json` | Written by `secondlayer login`, scoped per API URL, 0600 |
+| — | none of the above | Fails: `Not logged in — run secondlayer login` |
+
+A shell with no `SECONDLAYER_API_KEY` exported can still authenticate against
+the merchant host if this machine ran `secondlayer login` at some point — that's
+#3, a real (if easy to forget) credential, not a bug.
+
 ## Quickstart
 
 ```bash

package/dist/cli.js

@@ -202495,7 +202495,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "17.0.1",
+  version: "17.0.3",
   description: "Run a Stacks index on your own hardware — set it up, restore verified history, and keep it current.",
   repository: {
     type: "git",
@@ -202534,10 +202534,10 @@ var package_default = {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.6.1",
     "@secondlayer/scaffold": "^1.6.1",
-    "@secondlayer/sdk": "^12.1.0",
-    "@secondlayer/shared": "^11.10.1",
+    "@secondlayer/sdk": "^12.3.0",
+    "@secondlayer/shared": "^11.12.4",
     "@secondlayer/stacks": "^6.1.0",
-    "@secondlayer/subgraphs": "^6.1.0",
+    "@secondlayer/subgraphs": "^6.2.5",
     esbuild: "^0.28.2",
     "smol-toml": "^1.8.0",
     zod: "^4.3.6"
@@ -205248,12 +205248,19 @@ function buildWebhookUpdatePatch(options) {
   }
   return patch;
 }
+function formatWebhookTarget(sub) {
+  if (sub.kind === "chain") {
+    const types = sub.triggers?.map((t) => t.type);
+    return types && types.length > 0 ? `chain.${types.join(",")}` : "chain";
+  }
+  return `${sub.subgraphName}.${sub.tableName}`;
+}
 function printWebhookDetail(sub) {
   console.log(formatKeyValue([
     ["ID", sub.id],
     ["Name", sub.name],
     ["Status", sub.status],
-    ["Target", `${sub.subgraphName}.${sub.tableName}`],
+    ["Target", formatWebhookTarget(sub)],
     ["Format", sub.format],
     ["Runtime", sub.runtime ?? "none"],
     ["URL", sub.url],
@@ -205278,54 +205285,103 @@ Auth config:`));
     console.log(JSON.stringify(sub.authConfig, null, 2));
   }
 }
-function printDoctorReport(report) {
+var DOCTOR_ISSUE_TITLES = {
+  warning: "This webhook can't fire yet",
+  paused: "This webhook is paused",
+  last_error: "The last delivery failed",
+  circuit: "Your receiver is failing",
+  dead_letters: "Some events exhausted every retry",
+  subgraph_gaps: "The linked subgraph has gaps",
+  subgraph_catching_up: "The linked subgraph is still catching up",
+  no_deliveries: "No deliveries yet",
+  receiver_rate_limited: "Your receiver is rate-limiting us",
+  receiver_down: "Your receiver looks down",
+  receiver_rejects: "Your receiver is rejecting deliveries",
+  receiver_slow: "Your receiver is slow",
+  delivery_lag: "Deliveries are running behind"
+};
+function formatPrimaryInsight(primary) {
+  const severityColor = primary.severity === "bad" ? redStatus : primary.severity === "warn" ? yellow : dim;
+  const lines = [dim(`
+Insight:`)];
+  lines.push(`  ${severityColor(DOCTOR_ISSUE_TITLES[primary.code])} ${dim(`[${primary.severity}]`)}`);
+  for (const evidence of primary.evidence ?? []) {
+    lines.push(`    ${dim(`${evidence.label}:`)} ${evidence.value}`);
+  }
+  if (primary.fix) {
+    lines.push(`  ${primary.fix.text}`);
+    if (primary.fix.command)
+      lines.push(`    $ ${primary.fix.command}`);
+  }
+  return lines.join(`
+`);
+}
+function formatDoctorReport(report) {
   const sub = report.webhook;
-  console.log(formatKeyValue([
-    ["Webhook", `${sub.name} (${sub.id})`],
-    ["Status", sub.status],
-    ["Target", `${sub.subgraphName}.${sub.tableName}`],
-    ["Format", sub.format],
-    ["Runtime", sub.runtime ?? "none"],
-    ["URL", sub.url],
-    [
-      "Circuit",
-      sub.circuitOpenedAt ? `open at ${sub.circuitOpenedAt}` : `${sub.circuitFailures} failures`
-    ],
-    ["Last Error", sub.lastError ?? "none"],
-    ["Last Delivery", sub.lastDeliveryAt ?? "none"],
-    ["Last Success", sub.lastSuccessAt ?? "none"]
-  ]));
-  console.log(dim(`
-Delivery summary:`));
-  console.log(formatKeyValue([
-    ["Recent Attempts", String(report.deliverySummary.total)],
-    ["Successful", String(report.deliverySummary.successful)],
-    ["Failed", String(report.deliverySummary.failed)],
-    [
-      "Last Attempt",
-      report.deliverySummary.last ? `${report.deliverySummary.last.statusCode ?? "error"} at ${report.deliverySummary.last.dispatchedAt}` : "none"
-    ],
-    ["Dead Letter Rows", String(report.deadCount)]
-  ]));
-  if (report.subgraph) {
-    console.log(dim(`
-Linked subgraph:`));
-    console.log(formatKeyValue([
-      ["Name", report.subgraph.name],
-      ["Status", report.subgraph.status],
-      ["Sync", report.subgraph.syncStatus],
+  const sections = [
+    formatKeyValue([
+      ["Webhook", `${sub.name} (${sub.id})`],
+      ["Status", sub.status],
+      ["Target", formatWebhookTarget(sub)],
+      ["Format", sub.format],
+      ["Runtime", sub.runtime ?? "none"],
+      ["URL", sub.url],
       [
-        "Blocks",
-        `${report.subgraph.lastProcessedBlock} / ${report.subgraph.chainTip}`
+        "Circuit",
+        sub.circuitOpenedAt ? `open at ${sub.circuitOpenedAt}` : `${sub.circuitFailures} failures`
       ],
-      ["Integrity", report.subgraph.integrity],
-      ["Gaps", String(report.subgraph.gapCount)]
-    ]));
+      ["Last Error", sub.lastError ?? "none"],
+      ["Last Delivery", sub.lastDeliveryAt ?? "none"],
+      ["Last Success", sub.lastSuccessAt ?? "none"]
+    ]),
+    [
+      dim(`
+Delivery summary:`),
+      formatKeyValue([
+        ["Recent Attempts", String(report.deliverySummary.total)],
+        ["Successful", String(report.deliverySummary.successful)],
+        ["Failed", String(report.deliverySummary.failed)],
+        [
+          "Last Attempt",
+          report.deliverySummary.last ? `${report.deliverySummary.last.statusCode ?? "error"} at ${report.deliverySummary.last.dispatchedAt}` : "none"
+        ],
+        ["Dead Letter Rows", String(report.deadCount)]
+      ])
+    ].join(`
+`)
+  ];
+  if (report.subgraph) {
+    sections.push([
+      dim(`
+Linked subgraph:`),
+      formatKeyValue([
+        ["Name", report.subgraph.name],
+        ["Status", report.subgraph.status],
+        ["Sync", report.subgraph.syncStatus],
+        [
+          "Blocks",
+          `${report.subgraph.lastProcessedBlock} / ${report.subgraph.chainTip}`
+        ],
+        ["Integrity", report.subgraph.integrity],
+        ["Gaps", String(report.subgraph.gapCount)]
+      ])
+    ].join(`
+`));
   }
-  console.log(dim(`
-Next steps:`));
-  for (const hint of report.hints)
-    console.log(`  - ${hint}`);
+  if (report.primary)
+    sections.push(formatPrimaryInsight(report.primary));
+  const primaryIndex = report.primary ? report.issues.indexOf(report.primary) : -1;
+  const rest = report.hints.filter((_, i) => i !== primaryIndex);
+  if (rest.length > 0) {
+    sections.push([dim(`
+Next steps:`), ...rest.map((hint) => `  - ${hint}`)].join(`
+`));
+  }
+  return sections.join(`
+`);
+}
+function printDoctorReport(report) {
+  console.log(formatDoctorReport(report));
 }
 function syntheticValue(type) {
   switch (type) {
@@ -205475,7 +205531,7 @@ function attachWebhookSubcommands(parent) {
         sub.name,
         sub.id,
         sub.status === "active" ? green(sub.status) : sub.status === "paused" ? yellow(sub.status) : redStatus(sub.status),
-        `${sub.subgraphName}.${sub.tableName}`,
+        formatWebhookTarget(sub),
         sub.format,
         formatMaybeDate(sub.lastSuccessAt)
       ])));
@@ -209003,5 +209059,5 @@ registerCreditsCommand(program);
 registerArchiveCommand(program);
 program.parse();
 
-//# debugId=AE6E7533FECA57AE64756E2164756E21
+//# debugId=071DD5EE0E04E9D664756E2164756E21
 //# sourceMappingURL=cli.js.map