@luckystack/devkit 0.6.7 → 0.7.1

package/dist/supervisor.js

@@ -46,7 +46,44 @@ var CORE_WATCH_DIRS = ["server/bootstrap", "server/auth"].filter(
 var CORE_WATCH_TARGETS = [...CORE_WATCH_FILES, ...CORE_WATCH_DIRS];
 var tsxCliPath = path.resolve(process.cwd(), "node_modules", "tsx", "dist", "cli.mjs");
 var tsconfigServerArgs = existsSync(path.resolve(process.cwd(), "tsconfig.server.json")) ? ["--tsconfig", "tsconfig.server.json"] : [];
-var childArgs = [tsxCliPath, ...tsconfigServerArgs, "server/server.ts"];
+var BUN_BINARY_PATTERN = /(?:^|[\\/])bun(?:\.exe)?$/i;
+var resolveChildSpawn = ({
+  isBun,
+  execPath,
+  npmUserAgent,
+  npmExecPath,
+  tsxCliPath: tsxCli,
+  tsconfigServerArgs: tsconfigArgs,
+  entry,
+  fileExists
+}) => {
+  if (isBun) return { ok: true, spec: { command: execPath, args: [entry], runtime: "bun" } };
+  const launchedByBun = (npmUserAgent ?? "").startsWith("bun/") || BUN_BINARY_PATTERN.test(npmExecPath ?? "");
+  if (!launchedByBun) {
+    return {
+      ok: true,
+      spec: { command: execPath, args: [tsxCli, ...tsconfigArgs, entry], runtime: "node" }
+    };
+  }
+  const bunBinary = npmExecPath ?? "";
+  if (!BUN_BINARY_PATTERN.test(bunBinary) || !fileExists(bunBinary)) {
+    return {
+      ok: false,
+      message: `Detected a \`bun run\` launch, but could not locate the bun binary to run the server with (npm_execpath=${npmExecPath ?? "<unset>"}). Refusing to silently fall back to Node \u2014 that would look like a working Bun boot while actually running Node. Run \`npm run server\` for the Node path, or reinstall/repair Bun so it is on PATH.`
+    };
+  }
+  return { ok: true, spec: { command: bunBinary, args: ["--bun", "run", entry], runtime: "bun" } };
+};
+var resolvedChildSpawn = resolveChildSpawn({
+  isBun: "Bun" in globalThis,
+  execPath: process.execPath,
+  npmUserAgent: process.env.npm_config_user_agent,
+  npmExecPath: process.env.npm_execpath,
+  tsxCliPath,
+  tsconfigServerArgs,
+  entry: path.resolve(process.cwd(), "server", "server.ts"),
+  fileExists: existsSync
+});
 var childProcess = null;
 var pendingRestart = false;
 var restartTimer = null;
@@ -56,8 +93,10 @@ var consecutiveFastCrashes = 0;
 var isShuttingDown = false;
 var startChild = () => {
   if (isShuttingDown) return;
+  if (!resolvedChildSpawn.ok) return;
+  const { command: childCommand, args: childArgs, runtime: childRuntime } = resolvedChildSpawn.spec;
   childBootStartedAt = performance.now();
-  const spawned = spawn(process.execPath, childArgs, {
+  const spawned = spawn(childCommand, childArgs, {
     stdio: "inherit",
     //? `process.env` is guaranteed `.env`-free here (see the invariant at the
     //? top of this file), so the child loads `.env` fresh on every restart and
@@ -68,7 +107,9 @@ var startChild = () => {
     }
   });
   childProcess = spawned;
-  console.log(`[Supervisor] Started server process (pid: ${String(spawned.pid)})`);
+  console.log(
+    `[Supervisor] Started server process (pid: ${String(spawned.pid)}, runtime: ${childRuntime})`
+  );
   let handled = false;
   spawned.on("error", (err) => {
     console.log(`[Supervisor] Failed to spawn server process: ${String(err)}`, "red");
@@ -160,49 +201,59 @@ var shutdownSupervisor = () => {
     process.exit(0);
   }
 };
-if (resolveNodeEnv() === "production") {
-  process.on("SIGINT", () => {
-    isShuttingDown = true;
-    shutdownSupervisor();
-  });
-  process.on("SIGTERM", () => {
-    isShuttingDown = true;
-    shutdownSupervisor();
-  });
-  startChild();
-} else {
-  const watcher = watch(CORE_WATCH_TARGETS, {
-    ignoreInitial: true,
-    awaitWriteFinish: {
-      stabilityThreshold: 120,
-      pollInterval: 20
-    }
-  });
-  watcher.on("all", (event, changedPath) => {
-    if (event === "addDir" || event === "unlinkDir") return;
-    const normalized = changedPath.replaceAll("\\", "/");
-    const relevant = normalized.endsWith(".ts") || CORE_WATCH_FILES.some((file) => normalized.endsWith(file));
-    if (!relevant) return;
-    scheduleRestart({ event, changedPath });
-  });
-  const handleSignal = (signalName) => {
-    if (isShuttingDown) {
-      process.exit(1);
-    }
-    isShuttingDown = true;
-    console.log(`[Supervisor] Received ${signalName}, shutting down`);
-    void watcher.close().then(() => {
+var bootSupervisor = () => {
+  if (!resolvedChildSpawn.ok) {
+    console.error(`[Supervisor] ${resolvedChildSpawn.message}`);
+    process.exit(1);
+  }
+  if (resolveNodeEnv() === "production") {
+    process.on("SIGINT", () => {
+      isShuttingDown = true;
       shutdownSupervisor();
-    }).catch(() => {
+    });
+    process.on("SIGTERM", () => {
+      isShuttingDown = true;
       shutdownSupervisor();
     });
-  };
-  process.on("SIGINT", () => {
-    handleSignal("SIGINT");
-  });
-  process.on("SIGTERM", () => {
-    handleSignal("SIGTERM");
-  });
-  startChild();
-}
+    startChild();
+  } else {
+    const watcher = watch(CORE_WATCH_TARGETS, {
+      ignoreInitial: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 120,
+        pollInterval: 20
+      }
+    });
+    watcher.on("all", (event, changedPath) => {
+      if (event === "addDir" || event === "unlinkDir") return;
+      const normalized = changedPath.replaceAll("\\", "/");
+      const relevant = normalized.endsWith(".ts") || CORE_WATCH_FILES.some((file) => normalized.endsWith(file));
+      if (!relevant) return;
+      scheduleRestart({ event, changedPath });
+    });
+    const handleSignal = (signalName) => {
+      if (isShuttingDown) {
+        process.exit(1);
+      }
+      isShuttingDown = true;
+      console.log(`[Supervisor] Received ${signalName}, shutting down`);
+      void watcher.close().then(() => {
+        shutdownSupervisor();
+      }).catch(() => {
+        shutdownSupervisor();
+      });
+    };
+    process.on("SIGINT", () => {
+      handleSignal("SIGINT");
+    });
+    process.on("SIGTERM", () => {
+      handleSignal("SIGTERM");
+    });
+    startChild();
+  }
+};
+if (!process.env.LUCKYSTACK_SUPERVISOR_IMPORT_ONLY) bootSupervisor();
+export {
+  resolveChildSpawn
+};
 //# sourceMappingURL=supervisor.js.map

package/dist/supervisor.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/supervisor.ts"],"sourcesContent":["#!/usr/bin/env node\r\n//? CRITICAL INVARIANT: this process must NEVER merge `.env` files into its own\r\n//? `process.env`. The child is spawned with `{ ...process.env }`, and the\r\n//? child's own `loadEnvFiles()` loads `.env` with `override: false` — any\r\n//? `.env`-derived value that leaks into the supervisor's env would therefore\r\n//? WIN over freshly edited file values on every restart (stale-env bug).\r\n//? That is why this file imports NOTHING from `@luckystack/core` (core runs\r\n//? `bootstrapEnv()` as an import side-effect) and reads env files via\r\n//? `dotenv.parse` (pure — no `process.env` mutation). The previous design\r\n//? (an `ambientEnvSnapshot` module imported first) broke as soon as tsup\r\n//? inlined the snapshot into the entry body: ESM imports are hoisted, so\r\n//? core's side-effect ran BEFORE the snapshot line.\r\nimport { spawn, type ChildProcess } from 'node:child_process';\r\nimport { existsSync, readFileSync } from 'node:fs';\r\nimport { performance } from 'node:perf_hooks';\r\nimport path from 'node:path';\r\nimport { watch } from 'chokidar';\r\nimport { parse as parseDotenv } from 'dotenv';\r\n\r\nconst RESTART_DEBOUNCE_MS = 150;\r\nconst CRASH_RESTART_DELAY_MS = 300;\r\n//? Rapid-crash-loop breaker. A child that exits non-zero within\r\n//? FAST_CRASH_THRESHOLD_MS of booting counts as a \"fast crash\" (it died during\r\n//? startup rather than after serving). MAX_CONSECUTIVE_FAST_CRASHES of those in\r\n//? a row means the startup error is not transient (a port already in use, a\r\n//? syntax error, a missing env) — restarting forever just spams the console, so\r\n//? we give up and print an actionable message. A child that survives longer than\r\n//? the threshold resets the counter, so a normal restart loop is unaffected.\r\nconst FAST_CRASH_THRESHOLD_MS = 3000;\r\nconst MAX_CONSECUTIVE_FAST_CRASHES = 4;\r\n//? Force-exit grace: how long we wait for the child to honour SIGTERM before\r\n//? the supervisor hard-exits. Windows does not deliver SIGKILL so the only\r\n//? lever is this timer. 1 500 ms is intentionally short (dev restarts should\r\n//? be fast); increase via LUCKYSTACK_SUPERVISOR_GRACE_MS for slow servers.\r\nconst SHUTDOWN_GRACE_MS = Number(process.env.LUCKYSTACK_SUPERVISOR_GRACE_MS) || 1500;\r\n\r\n//? Mirrors `getEnvFiles()` from @luckystack/core — duplicated on purpose so the\r\n//? supervisor never imports core (see the invariant above). Keep in sync.\r\nconst DEFAULT_ENV_FILES = ['.env', '.env.local'];\r\nconst getEnvFiles = (): string[] => {\r\n  const override = process.env.LUCKYSTACK_ENV_FILES;\r\n  if (override) {\r\n    const list = override.split(',').map((entry) => entry.trim()).filter(Boolean);\r\n    if (list.length > 0) return list;\r\n  }\r\n  return DEFAULT_ENV_FILES;\r\n};\r\n\r\n//? Resolve NODE_ENV without mutating `process.env`: a real ambient env var\r\n//? wins; otherwise read the env files via the pure `dotenv.parse` (\"later\r\n//? overrides earlier\", matching loadEnvFiles' file order).\r\nconst resolveNodeEnv = (): string => {\r\n  if (process.env.NODE_ENV) return process.env.NODE_ENV;\r\n  let fromFiles: string | undefined;\r\n  for (const file of getEnvFiles()) {\r\n    const filePath = path.resolve(process.cwd(), file);\r\n    if (!existsSync(filePath)) continue;\r\n    const parsed = parseDotenv(readFileSync(filePath, 'utf8'));\r\n    if (typeof parsed.NODE_ENV === 'string' && parsed.NODE_ENV.length > 0) fromFiles = parsed.NODE_ENV;\r\n  }\r\n  return fromFiles ?? 'development';\r\n};\r\n\r\n//? chokidar v5 removed glob support — a `server/bootstrap/**/*.ts` pattern is no\r\n//? longer expanded; it is watched as a LITERAL path that never exists, so changes\r\n//? under `server/bootstrap` / `server/auth` silently never triggered a restart.\r\n//? Watch the concrete files directly, and the bootstrap/auth DIRECTORIES\r\n//? recursively (chokidar's default for a directory), then filter events down to\r\n//? the file types the old globs targeted in the `all` handler below.\r\nconst CORE_WATCH_FILES = [\r\n  'config.ts',\r\n  ...getEnvFiles(),\r\n  'server/server.ts',\r\n  'server/functions/db.ts',\r\n  'server/functions/redis.ts',\r\n  'server/functions/sentry.ts',\r\n];\r\n//? Only watch dirs that exist — chokidar watching a recursive non-existent\r\n//? directory is wasteful/odd; a dir created later is picked up on next boot.\r\nconst CORE_WATCH_DIRS = ['server/bootstrap', 'server/auth'].filter((dir) =>\r\n  existsSync(path.resolve(process.cwd(), dir)),\r\n);\r\nconst CORE_WATCH_TARGETS = [...CORE_WATCH_FILES, ...CORE_WATCH_DIRS];\r\n\r\nconst tsxCliPath = path.resolve(process.cwd(), 'node_modules', 'tsx', 'dist', 'cli.mjs');\r\n//? Scaffolded projects carry a dedicated server tsconfig — pass it when present\r\n//? so the child matches a manual `tsx --tsconfig tsconfig.server.json` run.\r\nconst tsconfigServerArgs = existsSync(path.resolve(process.cwd(), 'tsconfig.server.json'))\r\n  ? ['--tsconfig', 'tsconfig.server.json']\r\n  : [];\r\nconst childArgs = [tsxCliPath, ...tsconfigServerArgs, 'server/server.ts'];\r\n\r\nlet childProcess: ChildProcess | null = null;\r\nlet pendingRestart = false;\r\nlet restartTimer: NodeJS.Timeout | null = null;\r\nlet crashRestartTimer: NodeJS.Timeout | null = null;\r\nlet childBootStartedAt = 0;\r\nlet consecutiveFastCrashes = 0;\r\nlet isShuttingDown = false;\r\n\r\nconst startChild = () => {\r\n  if (isShuttingDown) return;\r\n  childBootStartedAt = performance.now();\r\n  const spawned = spawn(process.execPath, childArgs, {\r\n    stdio: 'inherit',\r\n    //? `process.env` is guaranteed `.env`-free here (see the invariant at the\r\n    //? top of this file), so the child loads `.env` fresh on every restart and\r\n    //? picks up edited values — mirroring a cold `npm run server` boot.\r\n    env: {\r\n      ...process.env,\r\n      LUCKYSTACK_CORE_SUPERVISED: 'true',\r\n    },\r\n  });\r\n  childProcess = spawned;\r\n\r\n  console.log(`[Supervisor] Started server process (pid: ${String(spawned.pid)})`);\r\n\r\n  //? `'error'` and `'exit'` can BOTH fire for a single spawn (a failed spawn\r\n  //? emits `'error'`, and some platforms then emit `'exit'` too). This flag\r\n  //? resolves THIS child's lifecycle exactly once regardless of event order, so\r\n  //? we never double-schedule a restart.\r\n  let handled = false;\r\n\r\n  //? A failed `spawn` (ENOENT/EACCES — e.g. a missing `tsx`) emits `'error'`,\r\n  //? NOT `'exit'`. Without this listener Node re-throws it as an uncaught\r\n  //? exception that kills the SUPERVISOR instead of retrying — the dev wrapper\r\n  //? would just disappear. Route it through the same crash-restart delay.\r\n  spawned.on('error', (err) => {\r\n    console.log(`[Supervisor] Failed to spawn server process: ${String(err)}`, 'red');\r\n    if (handled) return;\r\n    handled = true;\r\n    childProcess = null;\r\n\r\n    if (isShuttingDown) {\r\n      process.exit(1);\r\n    }\r\n\r\n    console.log(`[Supervisor] Retrying server spawn in ${String(CRASH_RESTART_DELAY_MS)}ms`);\r\n    crashRestartTimer = setTimeout(() => {\r\n      crashRestartTimer = null;\r\n      startChild();\r\n    }, CRASH_RESTART_DELAY_MS);\r\n  });\r\n\r\n  spawned.on('exit', (code, signal) => {\r\n    const uptimeMs = Math.round(performance.now() - childBootStartedAt);\r\n    const shouldRestart = pendingRestart;\r\n\r\n    if (handled) return;\r\n    handled = true;\r\n    childProcess = null;\r\n\r\n    //? Once the user has asked us to stop, never spawn another child — no matter\r\n    //? what the previous one's exit reason was. Without this guard a crash that\r\n    //? races with Ctrl+C re-spawns indefinitely.\r\n    if (isShuttingDown) {\r\n      process.exit(0);\r\n    }\r\n\r\n    if (shouldRestart) {\r\n      pendingRestart = false;\r\n      //? A watcher-driven restart is an explicit edit to a watched file — give\r\n      //? the new code a clean slate instead of inheriting a previous crash burst.\r\n      consecutiveFastCrashes = 0;\r\n      console.log(`[Supervisor] Restarting server after ${String(uptimeMs)}ms uptime`);\r\n      startChild();\r\n      return;\r\n    }\r\n\r\n    if (signal === 'SIGTERM' || signal === 'SIGINT') {\r\n      return;\r\n    }\r\n\r\n    if (typeof code === 'number' && code !== 0) {\r\n      //? Rapid-crash-loop breaker: a child that died within the boot window\r\n      //? counts toward the consecutive-fast-crash tally; one that lived longer\r\n      //? proves the startup error cleared, so reset the tally.\r\n      if (uptimeMs < FAST_CRASH_THRESHOLD_MS) {\r\n        consecutiveFastCrashes += 1;\r\n      } else {\r\n        consecutiveFastCrashes = 0;\r\n      }\r\n\r\n      if (consecutiveFastCrashes >= MAX_CONSECUTIVE_FAST_CRASHES) {\r\n        console.log(\r\n          `[Supervisor] Server crashed ${String(consecutiveFastCrashes)} times within ` +\r\n            `${String(FAST_CRASH_THRESHOLD_MS / 1000)}s of starting — giving up. Fix the startup ` +\r\n            `error above (e.g. a port already in use), then re-run \\`npm run server\\`.`,\r\n        );\r\n        process.exit(1);\r\n      }\r\n\r\n      console.log(`[Supervisor] Server crashed with code ${String(code)}. Restarting in ${String(CRASH_RESTART_DELAY_MS)}ms`);\r\n      crashRestartTimer = setTimeout(() => {\r\n        crashRestartTimer = null;\r\n        startChild();\r\n      }, CRASH_RESTART_DELAY_MS);\r\n    }\r\n  });\r\n};\r\n\r\nconst scheduleRestart = ({\r\n  event,\r\n  changedPath,\r\n}: {\r\n  event: string;\r\n  changedPath: string;\r\n}) => {\r\n  if (restartTimer) {\r\n    clearTimeout(restartTimer);\r\n  }\r\n\r\n  restartTimer = setTimeout(() => {\r\n    restartTimer = null;\r\n    pendingRestart = true;\r\n\r\n    console.log(`[Supervisor] Core change detected (${event}): ${changedPath}. Restarting server`);\r\n\r\n    if (!childProcess) {\r\n      pendingRestart = false;\r\n      startChild();\r\n      return;\r\n    }\r\n\r\n    childProcess.kill('SIGTERM');\r\n  }, RESTART_DEBOUNCE_MS);\r\n};\r\n\r\nconst shutdownSupervisor = () => {\r\n  isShuttingDown = true;\r\n\r\n  if (restartTimer) {\r\n    clearTimeout(restartTimer);\r\n    restartTimer = null;\r\n  }\r\n  if (crashRestartTimer) {\r\n    clearTimeout(crashRestartTimer);\r\n    crashRestartTimer = null;\r\n  }\r\n\r\n  pendingRestart = false;\r\n\r\n  if (childProcess) {\r\n    //? Child is still alive — its 'exit' handler will see isShuttingDown\r\n    //? and call process.exit(0) once the child is gone. Force-exit after a\r\n    //? short grace period in case the child ignores SIGTERM (Windows).\r\n    childProcess.kill('SIGTERM');\r\n    setTimeout(() => process.exit(0), SHUTDOWN_GRACE_MS).unref();\r\n  } else {\r\n    //? No child running (e.g. we were between crashes, sitting in the\r\n    //? crash-restart setTimeout we just cleared above) — exit immediately.\r\n    process.exit(0);\r\n  }\r\n};\r\n\r\nif (resolveNodeEnv() === 'production') {\r\n  //? In production the supervisor has no file watcher, but it still needs to\r\n  //? forward shutdown signals so the child gets a chance to drain (e.g. flush\r\n  //? error trackers, close DB connections). Without these handlers a SIGTERM\r\n  //? from a process manager (systemd, Docker) kills the supervisor instantly\r\n  //? and the child may never exit cleanly.\r\n  process.on('SIGINT', () => {\r\n    isShuttingDown = true;\r\n    shutdownSupervisor();\r\n  });\r\n  process.on('SIGTERM', () => {\r\n    isShuttingDown = true;\r\n    shutdownSupervisor();\r\n  });\r\n  startChild();\r\n} else {\r\n  const watcher = watch(CORE_WATCH_TARGETS, {\r\n    ignoreInitial: true,\r\n    awaitWriteFinish: {\r\n      stabilityThreshold: 120,\r\n      pollInterval: 20,\r\n    },\r\n  });\r\n\r\n  watcher.on('all', (event, changedPath) => {\r\n    //? Ignore pure directory churn from the recursively-watched bootstrap/auth dirs.\r\n    if (event === 'addDir' || event === 'unlinkDir') return;\r\n    //? Restore the old `**/*.ts` glob intent: within the watched directories only\r\n    //? TS sources matter. A `.ts` suffix covers every concrete watched TS file too\r\n    //? (config.ts, server.ts, functions/*.ts); the non-TS watched files are the\r\n    //? `.env*` set, matched explicitly. A stray non-TS file under a watched dir is\r\n    //? correctly ignored.\r\n    const normalized = changedPath.replaceAll('\\\\', '/');\r\n    const relevant = normalized.endsWith('.ts') || CORE_WATCH_FILES.some((file) => normalized.endsWith(file));\r\n    if (!relevant) return;\r\n    scheduleRestart({ event, changedPath });\r\n  });\r\n\r\n  const handleSignal = (signalName: string) => {\r\n    //? Set the flag synchronously so any in-flight child 'exit' handler\r\n    //? running BEFORE watcher.close() resolves won't schedule a new spawn.\r\n    if (isShuttingDown) {\r\n      //? Second Ctrl+C — user is impatient. Hard-exit immediately.\r\n      process.exit(1);\r\n    }\r\n    isShuttingDown = true;\r\n    console.log(`[Supervisor] Received ${signalName}, shutting down`);\r\n    void watcher.close().then(() => {\r\n      shutdownSupervisor();\r\n    }).catch(() => {\r\n      shutdownSupervisor();\r\n    });\r\n  };\r\n\r\n  process.on('SIGINT', () => { handleSignal('SIGINT'); });\r\n  process.on('SIGTERM', () => { handleSignal('SIGTERM'); });\r\n\r\n  startChild();\r\n}\r\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/supervisor.ts"],"sourcesContent":["#!/usr/bin/env node\n//? CRITICAL INVARIANT: this process must NEVER merge `.env` files into its own\n//? `process.env`. The child is spawned with `{ ...process.env }`, and the\n//? child's own `loadEnvFiles()` loads `.env` with `override: false` — any\n//? `.env`-derived value that leaks into the supervisor's env would therefore\n//? WIN over freshly edited file values on every restart (stale-env bug).\n//? That is why this file imports NOTHING from `@luckystack/core` (core runs\n//? `bootstrapEnv()` as an import side-effect) and reads env files via\n//? `dotenv.parse` (pure — no `process.env` mutation). The previous design\n//? (an `ambientEnvSnapshot` module imported first) broke as soon as tsup\n//? inlined the snapshot into the entry body: ESM imports are hoisted, so\n//? core's side-effect ran BEFORE the snapshot line.\nimport { spawn, type ChildProcess } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { performance } from 'node:perf_hooks';\nimport path from 'node:path';\nimport { watch } from 'chokidar';\nimport { parse as parseDotenv } from 'dotenv';\n\nconst RESTART_DEBOUNCE_MS = 150;\nconst CRASH_RESTART_DELAY_MS = 300;\n//? Rapid-crash-loop breaker. A child that exits non-zero within\n//? FAST_CRASH_THRESHOLD_MS of booting counts as a \"fast crash\" (it died during\n//? startup rather than after serving). MAX_CONSECUTIVE_FAST_CRASHES of those in\n//? a row means the startup error is not transient (a port already in use, a\n//? syntax error, a missing env) — restarting forever just spams the console, so\n//? we give up and print an actionable message. A child that survives longer than\n//? the threshold resets the counter, so a normal restart loop is unaffected.\nconst FAST_CRASH_THRESHOLD_MS = 3000;\nconst MAX_CONSECUTIVE_FAST_CRASHES = 4;\n//? Force-exit grace: how long we wait for the child to honour SIGTERM before\n//? the supervisor hard-exits. Windows does not deliver SIGKILL so the only\n//? lever is this timer. 1 500 ms is intentionally short (dev restarts should\n//? be fast); increase via LUCKYSTACK_SUPERVISOR_GRACE_MS for slow servers.\nconst SHUTDOWN_GRACE_MS = Number(process.env.LUCKYSTACK_SUPERVISOR_GRACE_MS) || 1500;\n\n//? Mirrors `getEnvFiles()` from @luckystack/core — duplicated on purpose so the\n//? supervisor never imports core (see the invariant above). Keep in sync.\nconst DEFAULT_ENV_FILES = ['.env', '.env.local'];\nconst getEnvFiles = (): string[] => {\n  const override = process.env.LUCKYSTACK_ENV_FILES;\n  if (override) {\n    const list = override.split(',').map((entry) => entry.trim()).filter(Boolean);\n    if (list.length > 0) return list;\n  }\n  return DEFAULT_ENV_FILES;\n};\n\n//? Resolve NODE_ENV without mutating `process.env`: a real ambient env var\n//? wins; otherwise read the env files via the pure `dotenv.parse` (\"later\n//? overrides earlier\", matching loadEnvFiles' file order).\nconst resolveNodeEnv = (): string => {\n  if (process.env.NODE_ENV) return process.env.NODE_ENV;\n  let fromFiles: string | undefined;\n  for (const file of getEnvFiles()) {\n    const filePath = path.resolve(process.cwd(), file);\n    if (!existsSync(filePath)) continue;\n    const parsed = parseDotenv(readFileSync(filePath, 'utf8'));\n    if (typeof parsed.NODE_ENV === 'string' && parsed.NODE_ENV.length > 0) fromFiles = parsed.NODE_ENV;\n  }\n  return fromFiles ?? 'development';\n};\n\n//? chokidar v5 removed glob support — a `server/bootstrap/**/*.ts` pattern is no\n//? longer expanded; it is watched as a LITERAL path that never exists, so changes\n//? under `server/bootstrap` / `server/auth` silently never triggered a restart.\n//? Watch the concrete files directly, and the bootstrap/auth DIRECTORIES\n//? recursively (chokidar's default for a directory), then filter events down to\n//? the file types the old globs targeted in the `all` handler below.\nconst CORE_WATCH_FILES = [\n  'config.ts',\n  ...getEnvFiles(),\n  'server/server.ts',\n  'server/functions/db.ts',\n  'server/functions/redis.ts',\n  'server/functions/sentry.ts',\n];\n//? Only watch dirs that exist — chokidar watching a recursive non-existent\n//? directory is wasteful/odd; a dir created later is picked up on next boot.\nconst CORE_WATCH_DIRS = ['server/bootstrap', 'server/auth'].filter((dir) =>\n  existsSync(path.resolve(process.cwd(), dir)),\n);\nconst CORE_WATCH_TARGETS = [...CORE_WATCH_FILES, ...CORE_WATCH_DIRS];\n\nconst tsxCliPath = path.resolve(process.cwd(), 'node_modules', 'tsx', 'dist', 'cli.mjs');\n//? Scaffolded projects carry a dedicated server tsconfig — pass it when present\n//? so the child matches a manual `tsx --tsconfig tsconfig.server.json` run.\nconst tsconfigServerArgs = existsSync(path.resolve(process.cwd(), 'tsconfig.server.json'))\n  ? ['--tsconfig', 'tsconfig.server.json']\n  : [];\n\n//? ---------------------------------------------------------------------------\n//? Runtime honouring — `bun run server` must ACTUALLY run Bun\n//? ---------------------------------------------------------------------------\n//? A LuckyStack project must work on Node AND Bun. On Windows that is not\n//? automatic and the failure is SILENT: npm generates a `.cmd` shim per bin\n//? (`node_modules/.bin/luckystack-dev.cmd`) which hardcodes a `node` call, so\n//? `bun run server` dutifully launches NODE while every log line still looks\n//? green. Windows has no shebang to intercept, so the shim always wins.\n//? Verified empirically on bun 1.3.14 / Windows:\n//?   `bun run server`       -> child ran C:\\Program Files\\nodejs\\node.exe\n//?   `bun --bun run server` -> child ran Bun (via a node-shim Bun injects at\n//?                             %TEMP%\\bun-node-<hash>\\node.exe)\n//? Bun does leave fingerprints even when it hands off to Node:\n//?   npm_config_user_agent = \"bun/1.3.14 npm/? node/v24.3.0 win32 x64\"\n//?   npm_execpath          = \"<abs>/bun.exe\"\n//? That lets us tell \"the developer typed `bun run`\" from \"the developer typed\n//? `npm run`\", and `npm_execpath` hands us the real bun binary to correct\n//? course with. The CHILD is what actually serves the app, so the child is\n//? where the intended runtime gets honoured. This keeps the promise honest\n//? with NO new runtime choice: no extra script name, no wizard question, no\n//? manifest dimension — `npm run server` stays Node, `bun run server` is Bun.\nconst BUN_BINARY_PATTERN = /(?:^|[\\\\/])bun(?:\\.exe)?$/i;\n\nexport type SupervisorRuntime = 'node' | 'bun';\n\nexport interface ChildSpawnSpec {\n  command: string;\n  args: string[];\n  runtime: SupervisorRuntime;\n}\n\nexport interface ResolveChildSpawnInput {\n  //? `'Bun' in globalThis` at the call site — passed in so the branch is testable.\n  isBun: boolean;\n  execPath: string;\n  npmUserAgent: string | undefined;\n  npmExecPath: string | undefined;\n  tsxCliPath: string;\n  tsconfigServerArgs: string[];\n  //? MUST be absolute — see the fork-bomb note in the bun re-exec branch.\n  entry: string;\n  fileExists: (candidate: string) => boolean;\n}\n\n//? Result shape rather than a throw: this module may not import\n//? `@luckystack/core` (see the invariant at the top of this file), so the\n//? framework's `tryCatch` is unavailable here and a bare throw at module scope\n//? would surface as an ugly unhandled stack instead of an actionable message.\nexport type ResolveChildSpawnResult =\n  | { ok: true; spec: ChildSpawnSpec }\n  | { ok: false; message: string };\n\nexport const resolveChildSpawn = ({\n  isBun,\n  execPath,\n  npmUserAgent,\n  npmExecPath,\n  tsxCliPath: tsxCli,\n  tsconfigServerArgs: tsconfigArgs,\n  entry,\n  fileExists,\n}: ResolveChildSpawnInput): ResolveChildSpawnResult => {\n  //? Already executing under Bun (`bun --bun run server`, or `bun server/server.ts`).\n  //? `process.execPath` is then either bun itself or the node-shim Bun injects for\n  //? bin scripts — BOTH re-enter Bun (verified on 1.3.14/Windows), so spawning\n  //? execPath keeps the child on Bun. tsx is dropped deliberately: Bun compiles\n  //? TypeScript natively, so tsx would only add a redundant transpile hop, and\n  //? `--tsconfig` is not a Bun flag at all (Bun reads `tsconfig.json` itself).\n  if (isBun) return { ok: true, spec: { command: execPath, args: [entry], runtime: 'bun' } };\n\n  const launchedByBun =\n    (npmUserAgent ?? '').startsWith('bun/') || BUN_BINARY_PATTERN.test(npmExecPath ?? '');\n\n  //? Plain `npm run server` — the canonical Node path, unchanged. Node cannot\n  //? run the whole TypeScript server tree on its own, so tsx stays.\n  if (!launchedByBun) {\n    return {\n      ok: true,\n      spec: { command: execPath, args: [tsxCli, ...tsconfigArgs, entry], runtime: 'node' },\n    };\n  }\n\n  //? `bun run server` on Windows: WE are Node (the .cmd shim won), but the\n  //? developer asked for Bun. Re-exec the child through the real bun binary.\n  const bunBinary = npmExecPath ?? '';\n  if (!BUN_BINARY_PATTERN.test(bunBinary) || !fileExists(bunBinary)) {\n    //? Fail LOUD rather than quietly serving from Node. Silently continuing is\n    //? the exact trap this branch exists to remove: it would look green while\n    //? proving nothing about Bun compatibility.\n    return {\n      ok: false,\n      message:\n        'Detected a `bun run` launch, but could not locate the bun binary to run the server with ' +\n        `(npm_execpath=${npmExecPath ?? '<unset>'}). Refusing to silently fall back to Node — ` +\n        'that would look like a working Bun boot while actually running Node. ' +\n        'Run `npm run server` for the Node path, or reinstall/repair Bun so it is on PATH.',\n    };\n  }\n\n  //? `entry` MUST be absolute: `bun run <name>` resolves a package.json SCRIPT\n  //? before a file, so a relative `server/server.ts` could re-enter the `server`\n  //? script and fork-bomb. An absolute path can never be read as a script name.\n  return { ok: true, spec: { command: bunBinary, args: ['--bun', 'run', entry], runtime: 'bun' } };\n};\n\nconst resolvedChildSpawn = resolveChildSpawn({\n  isBun: 'Bun' in globalThis,\n  execPath: process.execPath,\n  npmUserAgent: process.env.npm_config_user_agent,\n  npmExecPath: process.env.npm_execpath,\n  tsxCliPath,\n  tsconfigServerArgs,\n  entry: path.resolve(process.cwd(), 'server', 'server.ts'),\n  fileExists: existsSync,\n});\n\n\nlet childProcess: ChildProcess | null = null;\nlet pendingRestart = false;\nlet restartTimer: NodeJS.Timeout | null = null;\nlet crashRestartTimer: NodeJS.Timeout | null = null;\nlet childBootStartedAt = 0;\nlet consecutiveFastCrashes = 0;\nlet isShuttingDown = false;\n\nconst startChild = () => {\n  if (isShuttingDown) return;\n  //? Defensive: `bootSupervisor()` already aborts on an unresolved spawn, so this\n  //? is unreachable in practice — it exists to narrow the result type here.\n  if (!resolvedChildSpawn.ok) return;\n  const { command: childCommand, args: childArgs, runtime: childRuntime } = resolvedChildSpawn.spec;\n  childBootStartedAt = performance.now();\n  const spawned = spawn(childCommand, childArgs, {\n    stdio: 'inherit',\n    //? `process.env` is guaranteed `.env`-free here (see the invariant at the\n    //? top of this file), so the child loads `.env` fresh on every restart and\n    //? picks up edited values — mirroring a cold `npm run server` boot.\n    env: {\n      ...process.env,\n      LUCKYSTACK_CORE_SUPERVISED: 'true',\n    },\n  });\n  childProcess = spawned;\n\n  //? Name the runtime explicitly. `bun run server` silently serving from Node is\n  //? the bug this file guards against, so the runtime must be observable rather\n  //? than assumed — a green boot log is exactly what made the old trap invisible.\n  console.log(\n    `[Supervisor] Started server process (pid: ${String(spawned.pid)}, runtime: ${childRuntime})`,\n  );\n\n  //? `'error'` and `'exit'` can BOTH fire for a single spawn (a failed spawn\n  //? emits `'error'`, and some platforms then emit `'exit'` too). This flag\n  //? resolves THIS child's lifecycle exactly once regardless of event order, so\n  //? we never double-schedule a restart.\n  let handled = false;\n\n  //? A failed `spawn` (ENOENT/EACCES — e.g. a missing `tsx`) emits `'error'`,\n  //? NOT `'exit'`. Without this listener Node re-throws it as an uncaught\n  //? exception that kills the SUPERVISOR instead of retrying — the dev wrapper\n  //? would just disappear. Route it through the same crash-restart delay.\n  spawned.on('error', (err) => {\n    console.log(`[Supervisor] Failed to spawn server process: ${String(err)}`, 'red');\n    if (handled) return;\n    handled = true;\n    childProcess = null;\n\n    if (isShuttingDown) {\n      process.exit(1);\n    }\n\n    console.log(`[Supervisor] Retrying server spawn in ${String(CRASH_RESTART_DELAY_MS)}ms`);\n    crashRestartTimer = setTimeout(() => {\n      crashRestartTimer = null;\n      startChild();\n    }, CRASH_RESTART_DELAY_MS);\n  });\n\n  spawned.on('exit', (code, signal) => {\n    const uptimeMs = Math.round(performance.now() - childBootStartedAt);\n    const shouldRestart = pendingRestart;\n\n    if (handled) return;\n    handled = true;\n    childProcess = null;\n\n    //? Once the user has asked us to stop, never spawn another child — no matter\n    //? what the previous one's exit reason was. Without this guard a crash that\n    //? races with Ctrl+C re-spawns indefinitely.\n    if (isShuttingDown) {\n      process.exit(0);\n    }\n\n    if (shouldRestart) {\n      pendingRestart = false;\n      //? A watcher-driven restart is an explicit edit to a watched file — give\n      //? the new code a clean slate instead of inheriting a previous crash burst.\n      consecutiveFastCrashes = 0;\n      console.log(`[Supervisor] Restarting server after ${String(uptimeMs)}ms uptime`);\n      startChild();\n      return;\n    }\n\n    if (signal === 'SIGTERM' || signal === 'SIGINT') {\n      return;\n    }\n\n    if (typeof code === 'number' && code !== 0) {\n      //? Rapid-crash-loop breaker: a child that died within the boot window\n      //? counts toward the consecutive-fast-crash tally; one that lived longer\n      //? proves the startup error cleared, so reset the tally.\n      if (uptimeMs < FAST_CRASH_THRESHOLD_MS) {\n        consecutiveFastCrashes += 1;\n      } else {\n        consecutiveFastCrashes = 0;\n      }\n\n      if (consecutiveFastCrashes >= MAX_CONSECUTIVE_FAST_CRASHES) {\n        console.log(\n          `[Supervisor] Server crashed ${String(consecutiveFastCrashes)} times within ` +\n            `${String(FAST_CRASH_THRESHOLD_MS / 1000)}s of starting — giving up. Fix the startup ` +\n            `error above (e.g. a port already in use), then re-run \\`npm run server\\`.`,\n        );\n        process.exit(1);\n      }\n\n      console.log(`[Supervisor] Server crashed with code ${String(code)}. Restarting in ${String(CRASH_RESTART_DELAY_MS)}ms`);\n      crashRestartTimer = setTimeout(() => {\n        crashRestartTimer = null;\n        startChild();\n      }, CRASH_RESTART_DELAY_MS);\n    }\n  });\n};\n\nconst scheduleRestart = ({\n  event,\n  changedPath,\n}: {\n  event: string;\n  changedPath: string;\n}) => {\n  if (restartTimer) {\n    clearTimeout(restartTimer);\n  }\n\n  restartTimer = setTimeout(() => {\n    restartTimer = null;\n    pendingRestart = true;\n\n    console.log(`[Supervisor] Core change detected (${event}): ${changedPath}. Restarting server`);\n\n    if (!childProcess) {\n      pendingRestart = false;\n      startChild();\n      return;\n    }\n\n    childProcess.kill('SIGTERM');\n  }, RESTART_DEBOUNCE_MS);\n};\n\nconst shutdownSupervisor = () => {\n  isShuttingDown = true;\n\n  if (restartTimer) {\n    clearTimeout(restartTimer);\n    restartTimer = null;\n  }\n  if (crashRestartTimer) {\n    clearTimeout(crashRestartTimer);\n    crashRestartTimer = null;\n  }\n\n  pendingRestart = false;\n\n  if (childProcess) {\n    //? Child is still alive — its 'exit' handler will see isShuttingDown\n    //? and call process.exit(0) once the child is gone. Force-exit after a\n    //? short grace period in case the child ignores SIGTERM (Windows).\n    childProcess.kill('SIGTERM');\n    setTimeout(() => process.exit(0), SHUTDOWN_GRACE_MS).unref();\n  } else {\n    //? No child running (e.g. we were between crashes, sitting in the\n    //? crash-restart setTimeout we just cleared above) — exit immediately.\n    process.exit(0);\n  }\n};\n\nconst bootSupervisor = () => {\n  //? Fail loud before anything is watched or spawned: we were asked for Bun but\n  //? cannot deliver it, and Node-in-disguise is not an acceptable substitute.\n  if (!resolvedChildSpawn.ok) {\n    console.error(`[Supervisor] ${resolvedChildSpawn.message}`);\n    process.exit(1);\n  }\n\n  if (resolveNodeEnv() === 'production') {\n    //? In production the supervisor has no file watcher, but it still needs to\n    //? forward shutdown signals so the child gets a chance to drain (e.g. flush\n    //? error trackers, close DB connections). Without these handlers a SIGTERM\n    //? from a process manager (systemd, Docker) kills the supervisor instantly\n    //? and the child may never exit cleanly.\n    process.on('SIGINT', () => {\n      isShuttingDown = true;\n      shutdownSupervisor();\n    });\n    process.on('SIGTERM', () => {\n      isShuttingDown = true;\n      shutdownSupervisor();\n    });\n    startChild();\n  } else {\n    const watcher = watch(CORE_WATCH_TARGETS, {\n      ignoreInitial: true,\n      awaitWriteFinish: {\n        stabilityThreshold: 120,\n        pollInterval: 20,\n      },\n    });\n\n    watcher.on('all', (event, changedPath) => {\n      //? Ignore pure directory churn from the recursively-watched bootstrap/auth dirs.\n      if (event === 'addDir' || event === 'unlinkDir') return;\n      //? Restore the old `**/*.ts` glob intent: within the watched directories only\n      //? TS sources matter. A `.ts` suffix covers every concrete watched TS file too\n      //? (config.ts, server.ts, functions/*.ts); the non-TS watched files are the\n      //? `.env*` set, matched explicitly. A stray non-TS file under a watched dir is\n      //? correctly ignored.\n      const normalized = changedPath.replaceAll('\\\\', '/');\n      const relevant = normalized.endsWith('.ts') || CORE_WATCH_FILES.some((file) => normalized.endsWith(file));\n      if (!relevant) return;\n      scheduleRestart({ event, changedPath });\n    });\n\n    const handleSignal = (signalName: string) => {\n      //? Set the flag synchronously so any in-flight child 'exit' handler\n      //? running BEFORE watcher.close() resolves won't schedule a new spawn.\n      if (isShuttingDown) {\n        //? Second Ctrl+C — user is impatient. Hard-exit immediately.\n        process.exit(1);\n      }\n      isShuttingDown = true;\n      console.log(`[Supervisor] Received ${signalName}, shutting down`);\n      void watcher.close().then(() => {\n        shutdownSupervisor();\n      }).catch(() => {\n        shutdownSupervisor();\n      });\n    };\n\n    process.on('SIGINT', () => { handleSignal('SIGINT'); });\n    process.on('SIGTERM', () => { handleSignal('SIGTERM'); });\n\n    startChild();\n  }\n};\n\n//? Importing this module must not boot a server: the unit tests import\n//? `resolveChildSpawn` to exercise every runtime branch, and this file is an\n//? ENTRY (the `luckystack-dev` bin + the repo's `server/dev/supervisor.ts`\n//? shim both rely on the import side-effect, so a `main`-module check would\n//? break the shim). Default is unchanged — boot unless explicitly told not to.\nif (!process.env.LUCKYSTACK_SUPERVISOR_IMPORT_ONLY) bootSupervisor();\n"],"mappings":"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","names":[]}

package/dist/templates/api.template.ts

@@ -1,55 +1,55 @@
-/* eslint-disable unicorn/no-abusive-eslint-disable */
-/* eslint-disable */
-
-//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
-import { AuthProps, SessionLayout } from '{{REL_PATH}}config';
-//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
-import { Functions, ApiResponse, MaybePromise, ApiStreamEmitter } from '{{REL_PATH}}src/_sockets/apiTypes.generated';
-
-// Set the request limit per minute. Set to false to use the default config value config.rateLimiting
-export const rateLimit: number | false = 20;
-
-// HTTP method for this API. If not set, inferred from name (get* = GET, delete* = DELETE, else POST)
-export const httpMethod: 'GET' | 'POST' | 'PUT' | 'DELETE' = 'POST';
-
-export const auth: AuthProps = {
-  login: true,
-  additional: []
-};
-
-export interface ApiParams {
-  data: {
-    // Define your input data shape here e.g.
-    // name: string;
-    // email: string;
-  };
-  user: SessionLayout;
-  functions: Functions;
-  stream: ApiStreamEmitter;
-  //? Aborts on client-side cancel (`apiRequest({ signal })`) or socket
-  //? disconnect. Check `abortSignal.aborted` in long-running loops and
-  //? bail out — already-emitted chunks are not unsent, but new ones are
-  //? short-circuited automatically.
-  abortSignal: AbortSignal;
-  //? Awaitable backpressure helper. Resolves once the originator socket's
-  //? pending write-buffer drops below the threshold (default 1 MB). Opt-in;
-  //? handlers that don't stream can ignore it.
-  flushPressure: (options?: { thresholdBytes?: number }) => Promise<void>;
-}
-
-export const main = ({  }: ApiParams): MaybePromise<ApiResponse> => {
-  // Stream payload types are generated from your stream(...) calls.
-  // stream({ phase: 'started', progress: 0 });
-  // stream({ phase: 'done', progress: 100, done: true });
-
-  // Error responses must include errorCode
-  // return { status: 'error', errorCode: 'api.someError', errorParams: [{ key: 'id', value: 1 }] };
-
-  // Optional: set custom HTTP status on this response
-  // return { status: 'success', httpStatus: 201 };
-
-  return {
-    status: 'success',
-    // Your response data here
-  };
+/* eslint-disable unicorn/no-abusive-eslint-disable */
+/* eslint-disable */
+
+//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
+import { AuthProps, SessionLayout } from '{{REL_PATH}}config';
+//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
+import { Functions, ApiResponse, MaybePromise, ApiStreamEmitter } from '{{REL_PATH}}src/_sockets/apiTypes.generated';
+
+// Set the request limit per minute. Set to false to use the default config value config.rateLimiting
+export const rateLimit: number | false = 20;
+
+// HTTP method for this API. If not set, inferred from name (get* = GET, delete* = DELETE, else POST)
+export const httpMethod: 'GET' | 'POST' | 'PUT' | 'DELETE' = 'POST';
+
+export const auth: AuthProps = {
+  login: true,
+  additional: []
+};
+
+export interface ApiParams {
+  data: {
+    // Define your input data shape here e.g.
+    // name: string;
+    // email: string;
+  };
+  user: SessionLayout;
+  functions: Functions;
+  stream: ApiStreamEmitter;
+  //? Aborts on client-side cancel (`apiRequest({ signal })`) or socket
+  //? disconnect. Check `abortSignal.aborted` in long-running loops and
+  //? bail out — already-emitted chunks are not unsent, but new ones are
+  //? short-circuited automatically.
+  abortSignal: AbortSignal;
+  //? Awaitable backpressure helper. Resolves once the originator socket's
+  //? pending write-buffer drops below the threshold (default 1 MB). Opt-in;
+  //? handlers that don't stream can ignore it.
+  flushPressure: (options?: { thresholdBytes?: number }) => Promise<void>;
+}
+
+export const main = ({  }: ApiParams): MaybePromise<ApiResponse> => {
+  // Stream payload types are generated from your stream(...) calls.
+  // stream({ phase: 'started', progress: 0 });
+  // stream({ phase: 'done', progress: 100, done: true });
+
+  // Error responses must include errorCode
+  // return { status: 'error', errorCode: 'api.someError', errorParams: [{ key: 'id', value: 1 }] };
+
+  // Optional: set custom HTTP status on this response
+  // return { status: 'success', httpStatus: 201 };
+
+  return {
+    status: 'success',
+    // Your response data here
+  };
 };

package/dist/templates/page_dashboard.template.tsx

@@ -1,35 +1,35 @@
-/* eslint-disable unicorn/no-abusive-eslint-disable */
-/* eslint-disable */
-
-//? Dashboard page template — wrapped in the `'dashboard'` template
-//? (sidebar + main content). Includes a login-required middleware as a
-//? sane default — adjust the role check or remove the middleware if this
-//? page is public.
-
-//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
-import type { PageMiddleware } from '@luckystack/core/client';
-//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
-import type { SessionLayout } from '{{REL_PATH}}config';
-
-export const template = 'dashboard';
-
-//? Default: require login. Customize for role checks
-//? (e.g. `if (!session.admin) return undefined;` to bounce non-admins back).
-export const middleware: PageMiddleware<SessionLayout> = ({ session }) => {
-  if (!session) return { success: false, redirect: '/login' };
-  return { success: true };
-};
-
-interface PageProps {
-  params: Record<string, string | undefined>;
-  searchParams: Record<string, string>;
-}
-
-export default function Page({ params, searchParams }: PageProps) {
-  return (
-    <div className='flex flex-col gap-4 p-6 w-full h-full'>
-      <h1 className='text-2xl font-semibold text-title'>{/* TODO: page title */}</h1>
-      <div className='text-common'>{/* TODO: page content */}</div>
-    </div>
-  );
-}
+/* eslint-disable unicorn/no-abusive-eslint-disable */
+/* eslint-disable */
+
+//? Dashboard page template — wrapped in the `'dashboard'` template
+//? (sidebar + main content). Includes a login-required middleware as a
+//? sane default — adjust the role check or remove the middleware if this
+//? page is public.
+
+//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
+import type { PageMiddleware } from '@luckystack/core/client';
+//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
+import type { SessionLayout } from '{{REL_PATH}}config';
+
+export const template = 'dashboard';
+
+//? Default: require login. Customize for role checks
+//? (e.g. `if (!session.admin) return undefined;` to bounce non-admins back).
+export const middleware: PageMiddleware<SessionLayout> = ({ session }) => {
+  if (!session) return { success: false, redirect: '/login' };
+  return { success: true };
+};
+
+interface PageProps {
+  params: Record<string, string | undefined>;
+  searchParams: Record<string, string>;
+}
+
+export default function Page({ params, searchParams }: PageProps) {
+  return (
+    <div className='flex flex-col gap-4 p-6 w-full h-full'>
+      <h1 className='text-2xl font-semibold text-title'>{/* TODO: page title */}</h1>
+      <div className='text-common'>{/* TODO: page content */}</div>
+    </div>
+  );
+}

package/dist/templates/page_plain.template.tsx

@@ -1,32 +1,32 @@
-/* eslint-disable unicorn/no-abusive-eslint-disable */
-/* eslint-disable */
-
-//? Plain page template — no UI chrome. Use for landing/public pages where
-//? the default surrounding layout (`'plain'`) is what you want. Per-page
-//? middleware is OPTIONAL — uncomment when this route needs a guard.
-
-//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
-// import type { PageMiddleware } from '@luckystack/core/client';
-//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
-// import type { SessionLayout } from '{{REL_PATH}}config';
-
-export const template = 'plain';
-
-// export const middleware: PageMiddleware<SessionLayout> = ({ session }) => {
-//   if (!session) return { success: false, redirect: '/login' };
-//   return { success: true };
-// };
-
-interface PageProps {
-  params: Record<string, string | undefined>;
-  searchParams: Record<string, string>;
-}
-
-export default function Page({ params, searchParams }: PageProps) {
-  return (
-    <div className='flex items-center justify-center w-full h-full text-title'>
-      {/* TODO: replace with your page content */}
-      <span>page scaffold — replace this</span>
-    </div>
-  );
-}
+/* eslint-disable unicorn/no-abusive-eslint-disable */
+/* eslint-disable */
+
+//? Plain page template — no UI chrome. Use for landing/public pages where
+//? the default surrounding layout (`'plain'`) is what you want. Per-page
+//? middleware is OPTIONAL — uncomment when this route needs a guard.
+
+//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
+// import type { PageMiddleware } from '@luckystack/core/client';
+//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
+// import type { SessionLayout } from '{{REL_PATH}}config';
+
+export const template = 'plain';
+
+// export const middleware: PageMiddleware<SessionLayout> = ({ session }) => {
+//   if (!session) return { success: false, redirect: '/login' };
+//   return { success: true };
+// };
+
+interface PageProps {
+  params: Record<string, string | undefined>;
+  searchParams: Record<string, string>;
+}
+
+export default function Page({ params, searchParams }: PageProps) {
+  return (
+    <div className='flex items-center justify-center w-full h-full text-title'>
+      {/* TODO: replace with your page content */}
+      <span>page scaffold — replace this</span>
+    </div>
+  );
+}

package/dist/templates/sync_client.template.ts

@@ -1,41 +1,41 @@
-/* eslint-disable unicorn/no-abusive-eslint-disable */
-/* eslint-disable */
-
-//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
-import { Functions, SyncClientResponse, SyncClientStreamEmitter } from '{{REL_PATH}}src/_sockets/apiTypes.generated';
-
-
-export interface SyncParams {
-  clientInput: {
-    // Define the data shape sent from the client e.g.
-    // message: string;
-  };
-  serverOutput: {
-    // Define the data shape returned from the server e.g.
-    // message: string;
-  };
-  token: string | null; // target client's session token (fetch session only when needed)
-  functions: Functions; // contains all functions that are available on the server in the functions folder
-  roomCode: string; // room code
-  stream: SyncClientStreamEmitter;
-}
-
-export const main = async ({  }: SyncParams): Promise<SyncClientResponse> => {
-  // THIS FILE RUNS ON THE SERVER AND IT EXECUTES FOR EVERY CLIENT THAT IS IN THE GIVEN ROOM
-  // stream payload types are generated from your stream(...) calls in this file
-  // Use functions.session.getSession(token) when you need session data for this target client.
-
-  // Return { status: 'error', message: '...' } OR { status: 'error', errorCode: '...' }
-  // Returning error here only affects the current target client and does not stop other clients.
-
-  // Example: Only allow users on set page to receive the event
-  // const targetUser = token ? await functions.session.getSession(token) : null;
-  // if (targetUser?.location?.pathName === '/your-page') {
-  //   return { status: 'success' };
-  // }
-
-  return {
-    status: 'success',
-    // Add any additional data to pass to the client
-  };
+/* eslint-disable unicorn/no-abusive-eslint-disable */
+/* eslint-disable */
+
+//@ts-ignore We replace {{REL_PATH}} with the relative path to the project root at scaffold time.
+import { Functions, SyncClientResponse, SyncClientStreamEmitter } from '{{REL_PATH}}src/_sockets/apiTypes.generated';
+
+
+export interface SyncParams {
+  clientInput: {
+    // Define the data shape sent from the client e.g.
+    // message: string;
+  };
+  serverOutput: {
+    // Define the data shape returned from the server e.g.
+    // message: string;
+  };
+  token: string | null; // target client's session token (fetch session only when needed)
+  functions: Functions; // contains all functions that are available on the server in the functions folder
+  roomCode: string; // room code
+  stream: SyncClientStreamEmitter;
+}
+
+export const main = async ({  }: SyncParams): Promise<SyncClientResponse> => {
+  // THIS FILE RUNS ON THE SERVER AND IT EXECUTES FOR EVERY CLIENT THAT IS IN THE GIVEN ROOM
+  // stream payload types are generated from your stream(...) calls in this file
+  // Use functions.session.getSession(token) when you need session data for this target client.
+
+  // Return { status: 'error', message: '...' } OR { status: 'error', errorCode: '...' }
+  // Returning error here only affects the current target client and does not stop other clients.
+
+  // Example: Only allow users on set page to receive the event
+  // const targetUser = token ? await functions.session.getSession(token) : null;
+  // if (targetUser?.location?.pathName === '/your-page') {
+  //   return { status: 'success' };
+  // }
+
+  return {
+    status: 'success',
+    // Add any additional data to pass to the client
+  };
 };