@secondlayer/cli 3.3.2 → 3.4.0

package/README.md

@@ -63,7 +63,7 @@ One instance per project. The platform API spawns a dedicated `sl-pg-{slug}`,
 
 | Command | What it does |
 |---|---|
-| `sl create subscription <name> --runtime <inngest\|trigger\|cloudflare\|node> [--filter key=value]` | Scaffold a receiver project wired to a new subscription. Copies the runtime template into `./<name>/`, provisions through the active project/instance, supports scalar filters, and wires the signing secret so the dev server starts consuming events immediately. |
+| `sl create subscription <name> --runtime <inngest\|trigger\|cloudflare\|node> [--auth-token <token>] [--filter key=value]` | Scaffold a receiver project wired to a new subscription. Copies the runtime template into `./<name>/`, provisions through the active project/instance, supports scalar filters and bearer auth, and wires the signing secret so the dev server starts consuming events immediately. |
 
 ### Subscriptions (tenant-scoped)
 
@@ -76,7 +76,7 @@ active project/instance the same way as `sl subgraphs ...`; `SL_API_URL` and
 |---|---|
 | `sl subscriptions list` | List subscriptions with status, target table, format, and last success |
 | `sl subscriptions get <id\|name>` | Show full config, filter, retry/circuit state |
-| `sl subscriptions update <id\|name> --url <url> [--filter key.gte=value]` | Patch URL, filter, format, runtime, retry, timeout, concurrency |
+| `sl subscriptions update <id\|name> --url <url> [--auth-token <token>] [--filter key.gte=value]` | Patch URL, bearer auth, filter, format, runtime, retry, timeout, concurrency |
 | `sl subscriptions pause/resume <id\|name>` | Stop or restart delivery |
 | `sl subscriptions rotate-secret <id\|name>` | Rotate signing secret and print the new value once |
 | `sl subscriptions deliveries <id\|name>` | Last 100 delivery attempts |
@@ -99,7 +99,7 @@ invocation. No long-lived key on disk.
 | Command | What it does |
 |---|---|
 | `sl subgraphs new <name>` | Scaffold a subgraph definition file |
-| `sl subgraphs deploy <file>` | Deploy to the active instance |
+| `sl subgraphs deploy <file> [--start-block <n>]` | Deploy to the active instance; `--start-block` overrides the definition start block for that deploy |
 | `sl subgraphs dev <file>` | Watch + hot-redeploy |
 | `sl subgraphs list` | List deployed subgraphs |
 | `sl subgraphs status <name>` | Indexing progress, row counts, gaps |

package/dist/cli.js

@@ -32430,7 +32430,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "3.3.2",
+  version: "3.4.0",
   description: "CLI for subgraphs and blockchain indexing on Stacks",
   type: "module",
   bin: {
@@ -32473,8 +32473,8 @@ var package_default = {
   dependencies: {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.3.1",
-    "@secondlayer/sdk": "^3.1.0",
-    "@secondlayer/shared": "^4.1.1",
+    "@secondlayer/sdk": "^3.2.0",
+    "@secondlayer/shared": "^4.2.0",
     "@secondlayer/stacks": "^2.0.0",
     "@secondlayer/subgraphs": "^1.2.0",
     "@biomejs/js-api": "^0.7.0",
@@ -33138,11 +33138,22 @@ async function promptFor(_name, opts) {
   });
   return { runtime, subgraph, table, url };
 }
+function buildSubscriptionAuthConfig(authToken) {
+  if (authToken === undefined)
+    return;
+  const token = authToken.trim();
+  if (token.length === 0) {
+    throw new Error("--auth-token must not be empty");
+  }
+  return { authType: "bearer", token };
+}
 async function createSubscription(name, opts) {
   const { runtime, subgraph, table, url } = await promptFor(name, opts);
   let filter;
+  let authConfig;
   try {
     filter = parseSubscriptionFilter(opts.filter);
+    authConfig = buildSubscriptionAuthConfig(opts.authToken);
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
     process.exit(1);
@@ -33187,7 +33198,8 @@ async function createSubscription(name, opts) {
         url,
         format: FORMAT_BY_RUNTIME[runtime],
         runtime,
-        ...filter ? { filter } : {}
+        ...filter ? { filter } : {},
+        ...authConfig ? { authConfig } : {}
       });
       signingSecret = res.signingSecret;
       success(`Subscription provisioned: ${blue(res.subscription.id)}`);
@@ -33253,7 +33265,7 @@ async function getSubscriptionClient(opts) {
 }
 function registerCreateCommand(program2) {
   const create = program2.command("create").description("Scaffold new resources (subscription receivers, etc.)");
-  create.command("subscription <name>").description("Scaffold a subscription receiver for a runtime").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("--filter <kv...>", "Filter as key=value (supports .eq/.neq/.gt/.gte/.lt/.lte suffixes)").option("--service-key <key>", "SL_SERVICE_KEY override").option("--base-url <url>", "SL_API_URL override").option("--skip-api", "Copy template only, don't call the API").action(async (name, options) => {
+  create.command("subscription <name>").description("Scaffold a subscription receiver for a runtime").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("--service-key <key>", "SL_SERVICE_KEY override").option("--base-url <url>", "SL_API_URL override").option("--skip-api", "Copy template only, don't call the API").action(async (name, options) => {
     await createSubscription(name, options);
   });
 }
@@ -33412,6 +33424,9 @@ function buildUpdatePatch(options) {
     patch.name = options.name;
   if (options.url)
     patch.url = options.url;
+  const authConfig = buildSubscriptionAuthConfig(options.authToken);
+  if (authConfig)
+    patch.authConfig = authConfig;
   if (options.format) {
     patch.format = options.format;
   }
@@ -33722,7 +33737,7 @@ ${data.length} subscription(s) total`));
       handleApiError(err, "get subscription");
     }
   });
-  commonOptions(subscriptions.command("update <idOrName>").description("Update subscription config").option("--name <name>", "Rename subscription").option("--url <url>", "Webhook URL").option("--format <format>", "standard-webhooks | inngest | trigger | cloudflare | cloudevents | raw").option("--runtime <runtime>", "inngest | trigger | cloudflare | node | none").option("--filter <kv...>", "Filter as key=value (supports .eq/.neq/.gt/.gte/.lt/.lte suffixes)").option("--clear-filter", "Replace filter with {}").option("--max-retries <n>", "Maximum delivery retries").option("--timeout-ms <n>", "Delivery timeout in milliseconds").option("--concurrency <n>", "Per-subscription delivery concurrency").option("--json", "Output as JSON")).action(async (idOrName, options) => {
+  commonOptions(subscriptions.command("update <idOrName>").description("Update subscription config").option("--name <name>", "Rename subscription").option("--url <url>", "Webhook URL").option("--auth-token <token>", "Set bearer token auth config").option("--format <format>", "standard-webhooks | inngest | trigger | cloudflare | cloudevents | raw").option("--runtime <runtime>", "inngest | trigger | cloudflare | node | none").option("--filter <kv...>", "Filter as key=value (supports .eq/.neq/.gt/.gte/.lt/.lte suffixes)").option("--clear-filter", "Replace filter with {}").option("--max-retries <n>", "Maximum delivery retries").option("--timeout-ms <n>", "Delivery timeout in milliseconds").option("--concurrency <n>", "Per-subscription delivery concurrency").option("--json", "Output as JSON")).action(async (idOrName, options) => {
     try {
       const client = await getSubscriptionClient(options);
       const patch = buildUpdatePatch(options);
@@ -34548,6 +34563,19 @@ export default defineSubgraph({
 
 // src/commands/subgraphs.ts
 init_api();
+function parseStartBlockOption(value) {
+  if (value === undefined)
+    return;
+  const trimmed = value.trim();
+  if (!/^(0|[1-9]\d*)$/.test(trimmed)) {
+    throw new Error("--start-block must be a nonnegative integer");
+  }
+  const parsed = Number(trimmed);
+  if (!Number.isSafeInteger(parsed)) {
+    throw new Error("--start-block must be a safe integer");
+  }
+  return parsed;
+}
 function registerSubgraphsCommand(program2) {
   const subgraphs = program2.command("subgraphs").description("Manage materialized subgraphs");
   subgraphs.command("new <name>").description("Scaffold a new subgraph definition file").action(async (name) => {
@@ -34626,15 +34654,20 @@ 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("--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("--force", "Skip confirmation prompt for reindex operations").action(async (file, options2) => {
     try {
       const absPath = resolve3(file);
       const config = await loadConfig();
+      const startBlock = parseStartBlockOption(options2.startBlock);
+      if (startBlock !== undefined) {
+        warn(`--start-block ${startBlock} overrides the definition's startBlock for this deploy.`);
+      }
       info(`Loading subgraph from ${absPath}`);
       const mod = await import(absPath);
       const def = mod.default ?? mod;
+      const effectiveDef = startBlock === undefined ? def : { ...def, startBlock };
       const { validateSubgraphDefinition } = await import("@secondlayer/subgraphs/validate");
-      validateSubgraphDefinition(def);
+      validateSubgraphDefinition(effectiveDef);
       if (config.network !== "local") {
         info(`Bundling for remote deploy (${config.network})...`);
         const { readFile: readFile4 } = await import("node:fs/promises");
@@ -34643,17 +34676,18 @@ Stopped watching.`);
         const bundled = await bundleSubgraphCode(source);
         const handlerCode = bundled.handlerCode;
         const result = await deploySubgraphApi({
-          name: def.name,
+          name: effectiveDef.name,
           version: options2.version,
-          description: def.description,
-          sources: def.sources,
-          schema: def.schema,
-          handlerCode
+          description: effectiveDef.description,
+          sources: effectiveDef.sources,
+          schema: effectiveDef.schema,
+          handlerCode,
+          ...startBlock !== undefined ? { startBlock } : {}
         });
         if (result.action === "unchanged") {
-          info(`Subgraph "${def.name}" is up to date (v${result.version} — no changes)`);
+          info(`Subgraph "${effectiveDef.name}" is up to date (v${result.version} — no changes)`);
         } else if (result.action === "created") {
-          success(`Subgraph "${def.name}" created → v${result.version}`);
+          success(`Subgraph "${effectiveDef.name}" created → v${result.version}`);
         } else if (result.action === "reindexed") {
           if (result.diff) {
             const { addedTables, addedColumns, breakingChanges } = result.diff;
@@ -34675,7 +34709,7 @@ Stopped watching.`);
             info("Aborted.");
             process.exit(0);
           }
-          success(`Subgraph "${def.name}" updated → v${result.version} (reindexing)`);
+          success(`Subgraph "${effectiveDef.name}" updated → v${result.version} (reindexing)`);
         } else {
           if (result.diff) {
             const { addedTables, addedColumns } = result.diff;
@@ -34685,23 +34719,24 @@ Stopped watching.`);
               info(`  + columns: ${t}.${cols.join(", ")}`);
             }
           }
-          success(`Subgraph "${def.name}" updated → v${result.version}`);
+          success(`Subgraph "${effectiveDef.name}" updated → v${result.version}`);
         }
       } else {
         const { deploySchema } = await import("@secondlayer/subgraphs");
         const { getDb: getDb2, closeDb } = await import("@secondlayer/shared/db");
         const db = getDb2();
-        const result = await deploySchema(db, def, absPath, {
-          version: options2.version
+        const result = await deploySchema(db, effectiveDef, absPath, {
+          version: options2.version,
+          forceReindex: startBlock !== undefined
         });
         if (result.action === "unchanged") {
-          info(`Subgraph "${def.name}" is up to date (v${result.version} — no changes)`);
+          info(`Subgraph "${effectiveDef.name}" is up to date (v${result.version} — no changes)`);
         } else if (result.action === "created") {
-          success(`Subgraph "${def.name}" created → v${result.version}`);
+          success(`Subgraph "${effectiveDef.name}" created → v${result.version}`);
         } else if (result.action === "reindexed") {
-          success(`Subgraph "${def.name}" updated → v${result.version} (reindexing)`);
+          success(`Subgraph "${effectiveDef.name}" updated → v${result.version} (reindexing)`);
         } else {
-          success(`Subgraph "${def.name}" updated → v${result.version}`);
+          success(`Subgraph "${effectiveDef.name}" updated → v${result.version}`);
         }
         await closeDb();
       }
@@ -36314,5 +36349,5 @@ registerLocalCommand(program);
 registerAccountCommand(program);
 program.parse();
 
-//# debugId=6B94E8C4AE7AD17564756E2164756E21
+//# debugId=5D73330C3279063064756E2164756E21
 //# sourceMappingURL=cli.js.map