@noego/app 0.0.1

package/src/commands/serve.js

@@ -0,0 +1,213 @@
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+
+import { createBuildContext } from '../build/context.js';
+import { runCommand } from '../utils/command.js';
+
+export async function runServe(config) {
+  const context = createBuildContext(config);
+  const { logger } = context;
+
+  const runner = await resolveRunner(context);
+  logger.info(`Starting dev server using ${runner.kind}`);
+
+  if (!config.dev.watch) {
+    const args = [...runner.args, config.server.entry.absolute];
+    await runCommand(process.execPath, args, {
+      cwd: config.rootDir,
+      env: { NODE_ENV: 'development' },
+      logger
+    });
+    return;
+  }
+
+  const watcher = await createWatcher(context);
+  let frontend = null;
+  if (config.dev.splitServe) {
+    frontend = await startFrontend(context).catch((e) => {
+      logger.info(`Frontend split-serve disabled: ${e?.message || e}`);
+      return null;
+    });
+  }
+  await runWithRestart(context, runner, watcher, frontend);
+}
+
+async function resolveRunner(context) {
+  const { requireFromRoot } = context;
+
+  // Prefer tsx (handles ESM/CJS seamlessly and integrates well with Vite/dev loaders)
+  try {
+    const tsxCli = requireFromRoot.resolve('tsx/dist/cli.js');
+    const args = [tsxCli];
+    // If Forge dev loader is available, attach it (keeps current dev SSR behavior)
+    try {
+      // Use export path if available; if resolution fails, we skip attaching a loader
+      requireFromRoot.resolve('@noego/forge/loader');
+      args.push('--loader', '@noego/forge/loader');
+    } catch {}
+    return { kind: 'tsx', args };
+  } catch {}
+
+  // Fallback: ts-node (transpile-only)
+  try {
+    const tsnode = requireFromRoot.resolve('ts-node/register/transpile-only');
+    return { kind: 'ts-node', args: ['-r', tsnode] };
+  } catch {}
+
+  // Last resort: plain node (will likely fail on .ts). Provide a helpful error.
+  const err = new Error(
+    'No dev TypeScript runner found. Please install "tsx" (preferred) or "ts-node" in your project.'
+  );
+  err.code = 'CLI_USAGE';
+  throw err;
+}
+
+async function createWatcher(context) {
+  const { config, requireFromRoot, logger } = context;
+  const chokidar = requireFromRoot('chokidar');
+
+  // Build watch list
+  const patterns = new Set();
+
+  const addPattern = (value) => {
+    if (!value) return;
+    patterns.add(value);
+  };
+
+  const resolveGlob = (entry) => {
+    if (!entry) return null;
+    if (typeof entry === 'string') {
+      return path.isAbsolute(entry) ? entry : path.join(config.rootDir, entry);
+    }
+    if (entry.isAbsolute) {
+      return entry.pattern;
+    }
+    if (entry.cwd) {
+      return path.join(entry.cwd, entry.pattern);
+    }
+    return entry.pattern;
+  };
+
+  // User-supplied patterns
+  for (const entry of config.dev.watchPaths) {
+    const pattern = resolveGlob(entry);
+    if (pattern) addPattern(pattern);
+  }
+
+  // Server-side defaults
+  addPattern(path.join(config.server.controllersDir, '**/*.{ts,js}'));
+  addPattern(path.join(config.server.middlewareDir, '**/*.{ts,js}'));
+  addPattern(config.server.openapiFile);
+  addPattern(path.join(path.dirname(config.server.openapiFile), 'openapi/**/*.yaml'));
+  for (const entry of config.server.sqlGlobs) {
+    const pattern = resolveGlob(entry);
+    if (pattern) addPattern(pattern);
+  }
+
+  // UI OpenAPI changes should restart (routes/manifest)
+  addPattern(config.ui.openapiFile);
+  addPattern(path.join(path.dirname(config.ui.openapiFile), 'openapi/**/*.yaml'));
+
+  // Ignore Svelte/client files to let Vite HMR handle them
+  const uiIgnores = [
+    path.join(config.ui.rootDir, '**/*.svelte'),
+    path.join(config.ui.rootDir, '**/*.{ts,tsx,css,scss,html}')
+  ];
+
+  logger.info('Watching for changes to restart server...');
+  const watcher = chokidar.watch(Array.from(patterns), {
+    ignoreInitial: true,
+    ignored: uiIgnores,
+    cwd: config.rootDir
+  });
+  return watcher;
+}
+
+async function runWithRestart(context, runner, watcher, frontendProc) {
+  const { config, logger } = context;
+
+  let child = null;
+  const start = () => {
+    const args = [...runner.args, config.server.entry.absolute];
+    child = spawn(process.execPath, args, {
+      cwd: config.rootDir,
+      env: { ...process.env, NODE_ENV: 'development' },
+      stdio: 'inherit'
+    });
+    child.on('exit', (code) => {
+      if (code !== null && code !== 0) {
+        logger.info(`Server exited with code ${code}`);
+      }
+    });
+  };
+
+  const stop = () =>
+    new Promise((resolve) => {
+      if (!child) return resolve();
+      const to = setTimeout(resolve, 2000);
+      child.once('exit', () => {
+        clearTimeout(to);
+        resolve();
+      });
+      try {
+        child.kill('SIGTERM');
+      } catch {
+        resolve();
+      }
+    });
+
+  let pending = false;
+  const scheduleRestart = async (reason, file) => {
+    if (pending) return;
+    pending = true;
+    logger.info(`Change detected (${reason}): ${file}. Restarting...`);
+    await stop();
+    start();
+    pending = false;
+  };
+
+  watcher
+    .on('add', (p) => scheduleRestart('add', p))
+    .on('change', (p) => scheduleRestart('change', p))
+    .on('unlink', (p) => scheduleRestart('unlink', p));
+
+  // Start initial server
+  start();
+
+  // Keep process alive until SIGINT/SIGTERM
+  const shutdown = async () => {
+    await stop();
+    await watcher.close();
+    if (frontendProc) {
+      try { frontendProc.kill('SIGTERM'); } catch {}
+    }
+    process.exit(0);
+  };
+  process.on('SIGINT', shutdown);
+  process.on('SIGTERM', shutdown);
+}
+
+async function startFrontend(context) {
+  const { config, requireFromRoot, logger } = context;
+  const cmd = (config.dev.frontendCmd || 'vite').toLowerCase();
+  if (cmd !== 'vite') {
+    throw new Error(`Unsupported --frontend-cmd '${cmd}'. Only 'vite' is supported currently.`);
+  }
+  // Resolve vite bin and spawn
+  let viteBin;
+  try {
+    viteBin = requireFromRoot.resolve('vite/bin/vite.js');
+  } catch {
+    throw new Error('vite not found in project. Install it or omit --split-serve.');
+  }
+  logger.info('Starting frontend dev server (vite) in separate process');
+  const child = spawn(process.execPath, [viteBin], {
+    cwd: config.ui.rootDir,
+    env: { ...process.env, NODE_ENV: 'development' },
+    stdio: 'inherit'
+  });
+  child.on('exit', (code) => {
+    logger.info(`Frontend dev server exited with code ${code}`);
+  });
+  return child;
+}