@b9g/shovel 0.2.6 → 0.2.8

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to Shovel will be documented in this file.
 
+## [0.2.7] - 2026-02-06
+
+### Features
+
+- **Request logger middleware** - New `logger()` middleware in `@b9g/router/middleware` logs requests and responses with timing via LogTape (default category: `["app", "router"]`)
+- **CLI flags for create-shovel** - `--template`, `--typescript`/`--no-typescript`, `--platform` flags to bypass interactive prompts. `--template crank` is shorthand for static-site + Crank.js.
+- **Logger in generated templates** - All Router-based templates (api, full-stack) now include `router.use(logger())` out of the box
+
+### Dependencies
+
+- **`@b9g/router`** `0.2.2` - Added `@logtape/logtape` as explicit dependency (was previously resolved via workspace only)
+
 ## [0.2.6] - 2026-02-06
 
 ### Features

package/bin/cli.js

@@ -75,7 +75,7 @@ program.command("develop <entrypoint>").description("Start development server wi
   DEFAULTS.WORKERS
 ).option("--platform <name>", "Runtime platform (node, cloudflare, bun)").action(async (entrypoint, options) => {
   checkPlatformReexec(options);
-  const { developCommand } = await import("../src/_chunks/develop-JUQG2G7M.js");
+  const { developCommand } = await import("../src/_chunks/develop-SVLFKAF5.js");
   await developCommand(entrypoint, options, config);
 });
 program.command("create [name]").description("Create a new Shovel project").action(async (name) => {
@@ -91,7 +91,7 @@ program.command("build <entrypoint>").description("Build app for production").op
   "Run ServiceWorker lifecycle after build (install or activate, default: activate)"
 ).action(async (entrypoint, options) => {
   checkPlatformReexec(options);
-  const { buildCommand } = await import("../src/_chunks/build-KBQU2OA7.js");
+  const { buildCommand } = await import("../src/_chunks/build-O5LLUOND.js");
   await buildCommand(entrypoint, options, config);
   process.exit(0);
 });

package/bin/create.js

@@ -20,10 +20,26 @@ function validateProjectName(name) {
     return "Use lowercase letters, numbers, and hyphens only";
   return void 0;
 }
+function parseFlags(args) {
+  const flags = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--template" && args[i + 1])
+      flags.template = args[++i];
+    else if (arg === "--typescript")
+      flags.typescript = true;
+    else if (arg === "--no-typescript")
+      flags.typescript = false;
+    else if (arg === "--platform" && args[i + 1])
+      flags.platform = args[++i];
+  }
+  return flags;
+}
 async function main() {
   console.info("");
   intro("Create Shovel App");
-  let projectName = process.argv[2];
+  const flags = parseFlags(process.argv.slice(2));
+  let projectName = process.argv[2]?.startsWith("-") ? void 0 : process.argv[2];
   if (projectName) {
     const validationError = validateProjectName(projectName);
     if (validationError) {
@@ -52,37 +68,53 @@ async function main() {
       process.exit(0);
     }
   }
-  const template = await select({
-    message: "Choose a starter template:",
-    options: [
-      {
-        value: "hello-world",
-        label: "Hello World",
-        hint: "Minimal fetch handler to get started"
-      },
-      {
-        value: "api",
-        label: "API",
-        hint: "REST endpoints with JSON responses"
-      },
-      {
-        value: "static-site",
-        label: "Static Site",
-        hint: "Server-rendered HTML pages"
-      },
-      {
-        value: "full-stack",
-        label: "Full Stack",
-        hint: "HTML pages + API routes"
-      }
-    ]
-  });
-  if (typeof template === "symbol") {
-    outro("Project creation cancelled");
-    process.exit(0);
-  }
+  let template;
   let uiFramework = "vanilla";
-  if (template === "static-site" || template === "full-stack") {
+  if (flags.template === "crank") {
+    template = "static-site";
+    uiFramework = "crank";
+  } else if (flags.template) {
+    const valid = ["hello-world", "api", "static-site", "full-stack"];
+    if (!valid.includes(flags.template)) {
+      console.error(
+        `Error: Unknown template "${flags.template}". Valid options: ${valid.join(", ")}, crank`
+      );
+      process.exit(1);
+    }
+    template = flags.template;
+  } else {
+    const templateResult = await select({
+      message: "Choose a starter template:",
+      options: [
+        {
+          value: "hello-world",
+          label: "Hello World",
+          hint: "Minimal fetch handler to get started"
+        },
+        {
+          value: "api",
+          label: "API",
+          hint: "REST endpoints with JSON responses"
+        },
+        {
+          value: "static-site",
+          label: "Static Site",
+          hint: "Server-rendered HTML pages"
+        },
+        {
+          value: "full-stack",
+          label: "Full Stack",
+          hint: "HTML pages + API routes"
+        }
+      ]
+    });
+    if (typeof templateResult === "symbol") {
+      outro("Project creation cancelled");
+      process.exit(0);
+    }
+    template = templateResult;
+  }
+  if (uiFramework === "vanilla" && (template === "static-site" || template === "full-stack")) {
     const framework = await select({
       message: "UI framework:",
       initialValue: "crank",
@@ -115,39 +147,58 @@ async function main() {
     }
     uiFramework = framework;
   }
-  const typescript = await confirm({
-    message: "Use TypeScript?",
-    initialValue: true
-  });
-  if (typeof typescript === "symbol") {
-    outro("Project creation cancelled");
-    process.exit(0);
+  let typescript;
+  if (flags.typescript !== void 0) {
+    typescript = flags.typescript;
+  } else {
+    const tsResult = await confirm({
+      message: "Use TypeScript?",
+      initialValue: true
+    });
+    if (typeof tsResult === "symbol") {
+      outro("Project creation cancelled");
+      process.exit(0);
+    }
+    typescript = tsResult;
   }
-  const detectedPlatform = detectPlatform();
-  const platform = await select({
-    message: "Which platform?",
-    initialValue: detectedPlatform,
-    options: [
-      {
-        value: "node",
-        label: "Node.js",
-        hint: detectedPlatform === "node" ? "detected" : void 0
-      },
-      {
-        value: "bun",
-        label: "Bun",
-        hint: detectedPlatform === "bun" ? "detected" : void 0
-      },
-      {
-        value: "cloudflare",
-        label: "Cloudflare Workers",
-        hint: "Edge runtime"
-      }
-    ]
-  });
-  if (typeof platform === "symbol") {
-    outro("Project creation cancelled");
-    process.exit(0);
+  let platform;
+  if (flags.platform) {
+    const valid = ["node", "bun", "cloudflare"];
+    if (!valid.includes(flags.platform)) {
+      console.error(
+        `Error: Unknown platform "${flags.platform}". Valid options: ${valid.join(", ")}`
+      );
+      process.exit(1);
+    }
+    platform = flags.platform;
+  } else {
+    const detectedPlatform = detectPlatform();
+    const platformResult = await select({
+      message: "Which platform?",
+      initialValue: detectedPlatform,
+      options: [
+        {
+          value: "node",
+          label: "Node.js",
+          hint: detectedPlatform === "node" ? "detected" : void 0
+        },
+        {
+          value: "bun",
+          label: "Bun",
+          hint: detectedPlatform === "bun" ? "detected" : void 0
+        },
+        {
+          value: "cloudflare",
+          label: "Cloudflare Workers",
+          hint: "Edge runtime"
+        }
+      ]
+    });
+    if (typeof platformResult === "symbol") {
+      outro("Project creation cancelled");
+      process.exit(0);
+    }
+    platform = platformResult;
   }
   const config = {
     name: projectName,
@@ -287,8 +338,10 @@ self.addEventListener("fetch", (event) => {
 }
 function generateApi(config) {
   return `import { Router } from "@b9g/router";
+import { logger } from "@b9g/router/middleware";
 
 const router = new Router();
+router.use(logger());
 
 // In-memory data store
 const users = [
@@ -622,8 +675,10 @@ function generateFullStackVanilla(config) {
   const ext = config.typescript ? "ts" : "js";
   const t = config.typescript;
   return `import { Router } from "@b9g/router";
+import { logger } from "@b9g/router/middleware";
 
 const router = new Router();
+router.use(logger());
 
 // API routes
 router.route("/api/hello").get(() => {
@@ -688,8 +743,10 @@ function generateFullStackHtmx(config) {
   const ext = config.typescript ? "ts" : "js";
   const t = config.typescript;
   return `import { Router } from "@b9g/router";
+import { logger } from "@b9g/router/middleware";
 
 const router = new Router();
+router.use(logger());
 
 // API routes \u2014 return HTML fragments when HTMX requests, JSON otherwise
 router.route("/api/hello").get((req) => {
@@ -764,8 +821,10 @@ function generateFullStackAlpine(config) {
   const ext = config.typescript ? "ts" : "js";
   const t = config.typescript;
   return `import { Router } from "@b9g/router";
+import { logger } from "@b9g/router/middleware";
 
 const router = new Router();
+router.use(logger());
 
 // API routes
 router.route("/api/hello").get(() => {
@@ -837,9 +896,11 @@ self.addEventListener("fetch", (event) => {
 function generateFullStackCrank(config) {
   const t = config.typescript;
   return `import { Router } from "@b9g/router";
+import { logger } from "@b9g/router/middleware";
 import {renderer} from "@b9g/crank/html";
 
 const router = new Router();
+router.use(logger());
 
 const css = \`
 ${css}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@b9g/shovel",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "ServiceWorker-first universal deployment platform. Write ServiceWorker apps once, deploy anywhere (Node/Bun/Cloudflare). Registry-based multi-app orchestration.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/bikeshaving/shovel.git"
+    "url": "git+https://github.com/bikeshaving/shovel.git"
   },
   "bin": {
     "shovel": "bin/cli.js",
@@ -16,11 +16,11 @@
   "dependencies": {
     "@b9g/async-context": "^0.2.1",
     "@b9g/cache": "^0.2.2",
-    "@b9g/filesystem": "^0.1.10",
+    "@b9g/filesystem": "^0.1.11",
     "@b9g/http-errors": "^0.2.1",
     "@b9g/node-webworker": "^0.2.1",
     "@b9g/platform": "^0.1.17",
-    "@b9g/platform-bun": "^0.1.15",
+    "@b9g/platform-bun": "^0.1.16",
     "@b9g/platform-cloudflare": "^0.1.15",
     "@b9g/platform-node": "^0.1.17",
     "@clack/prompts": "^0.7.0",
@@ -36,7 +36,7 @@
     "@b9g/assets": "^0.2.1",
     "@b9g/crank": "^0.7.2",
     "@b9g/libuild": "^0.1.22",
-    "@b9g/router": "^0.2.1",
+    "@b9g/router": "^0.2.2",
     "@logtape/file": "^1.0.0",
     "@types/bun": "^1.3.4",
     "@typescript-eslint/eslint-plugin": "^8.0.0",

package/src/_chunks/{build-KBQU2OA7.js → build-O5LLUOND.js}

@@ -1,7 +1,7 @@
 import {
   ServerBundler,
   loadPlatformModule
-} from "./chunk-ABGHNBNM.js";
+} from "./chunk-DQDUKJQ4.js";
 import {
   findProjectRoot,
   findWorkspaceRoot

package/src/_chunks/{chunk-ABGHNBNM.js → chunk-DQDUKJQ4.js}

@@ -448,10 +448,15 @@ function createConfigPlugin(projectRoot, outDir = "dist", options = {}) {
           const typesPath = join2(serverOutDir, "shovel.d.ts");
           writeFileSync2(typesPath, typesCode);
         }
+        const watchFiles = [
+          join2(projectRoot, "shovel.json"),
+          join2(projectRoot, "package.json")
+        ];
         return {
           contents: configModuleCode,
           loader: "js",
-          resolveDir: projectRoot
+          resolveDir: projectRoot,
+          watchFiles
         };
       });
     }
@@ -720,7 +725,6 @@ var ServerBundler = class {
   #initialBuildComplete;
   #initialBuildResolve;
   #currentOutputs;
-  #configWatchers;
   #dirWatchers;
   #userEntryPath;
   #watchOptions;
@@ -732,7 +736,6 @@ var ServerBundler = class {
     this.#projectRoot = findProjectRoot();
     this.#initialBuildComplete = false;
     this.#currentOutputs = { worker: "" };
-    this.#configWatchers = [];
     this.#dirWatchers = /* @__PURE__ */ new Map();
     this.#userEntryPath = "";
     this.#changedFiles = /* @__PURE__ */ new Set();
@@ -798,9 +801,18 @@ var ServerBundler = class {
     this.#ctx = await ESBuild2.context(buildOptions);
     logger3.debug("Starting esbuild watch mode");
     await this.#ctx.watch();
-    this.#watchConfigFiles();
     return initialBuildPromise;
   }
+  /**
+   * Trigger an immediate rebuild.
+   * Only works in watch mode (after calling watch()).
+   */
+  async rebuild() {
+    if (!this.#ctx) {
+      throw new Error("Cannot rebuild: bundler is not in watch mode");
+    }
+    await this.#ctx.rebuild();
+  }
   /**
    * Stop watching and dispose of resources.
    */
@@ -809,10 +821,6 @@ var ServerBundler = class {
       clearTimeout(this.#rebuildTimeout);
       this.#rebuildTimeout = void 0;
     }
-    for (const watcher of this.#configWatchers) {
-      watcher.close();
-    }
-    this.#configWatchers = [];
     for (const entry of this.#dirWatchers.values()) {
       entry.watcher.close();
     }
@@ -1123,30 +1131,6 @@ These modules are not bundled and won't be available at runtime.`
       }
     }
   }
-  /**
-   * Watch config files for changes.
-   */
-  #watchConfigFiles() {
-    const configFiles = ["shovel.json", "package.json"];
-    for (const filename of configFiles) {
-      const filepath = join5(this.#projectRoot, filename);
-      if (!existsSync4(filepath))
-        continue;
-      try {
-        const watcher = watch(filepath, { persistent: false }, (event) => {
-          if (event === "change") {
-            this.#scheduleRebuild(filepath);
-          }
-        });
-        this.#configWatchers.push(watcher);
-      } catch (err) {
-        logger3.warn("Failed to watch {file}: {error}", {
-          file: filename,
-          error: err
-        });
-      }
-    }
-  }
   /**
    * Update source file watchers from metafile.
    */

package/src/_chunks/{develop-JUQG2G7M.js → develop-SVLFKAF5.js}

@@ -1,7 +1,7 @@
 import {
   ServerBundler,
   loadPlatformModule
-} from "./chunk-ABGHNBNM.js";
+} from "./chunk-DQDUKJQ4.js";
 import {
   DEFAULTS
 } from "./chunk-7GONPLNW.js";
@@ -56,6 +56,7 @@ async function developCommand(entrypoint, options, config) {
     const platformModule = await loadPlatformModule(platformName);
     const platformESBuildConfig = platformModule.getESBuildConfig();
     let devServer = null;
+    const SHORTCUTS_HELP = "Shortcuts: Ctrl+R (reload) \xB7 Ctrl+L (clear) \xB7 Ctrl+C (quit) \xB7 ? (help)";
     const startOrReloadServer = async (workerPath) => {
       if (!devServer) {
         devServer = await platformModule.createDevServer({
@@ -73,6 +74,9 @@ async function developCommand(entrypoint, options, config) {
         } else {
           logger.info("Server running at {url}", { url: urls.local });
         }
+        if (process.stdin.isTTY) {
+          logger.info(SHORTCUTS_HELP);
+        }
       } else {
         await devServer.reload(workerPath);
       }
@@ -109,6 +113,28 @@ async function developCommand(entrypoint, options, config) {
     };
     process.on("SIGINT", () => shutdown("SIGINT"));
     process.on("SIGTERM", () => shutdown("SIGTERM"));
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.setEncoding("utf8");
+      process.stdin.on("data", async (key) => {
+        switch (key) {
+          case "":
+            logger.info("Manual reload...");
+            await bundler.rebuild();
+            break;
+          case "\f":
+            console.clear();
+            break;
+          case "":
+            await shutdown("SIGINT");
+            break;
+          case "?":
+            logger.info(SHORTCUTS_HELP);
+            break;
+        }
+      });
+    }
     await new Promise(() => {
     });
   } catch (error) {