@lark-apaas/coding-template-nestjs-react-fullstack 0.1.27-alpha.20260824122815 → 0.1.27

package/template/scripts/server-startup-runtime.mjs

@@ -1,445 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'node:fs';
-import net from 'node:net';
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-
-const projectRoot = path.resolve(
-  process.env.MIAODA_WORKSPACE_ROOT || process.cwd()
-);
-
-// The bundle orchestrator may be started directly by the image before the
-// project npm task exists. Load the same project .env contract as dev.js so the
-// later source service receives identical application configuration.
-const projectEnvFile = path.join(projectRoot, '.env');
-if (fs.existsSync(projectEnvFile)) {
-  for (const line of fs.readFileSync(projectEnvFile, 'utf8').split('\n')) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-    const separator = trimmed.indexOf('=');
-    if (separator < 1) continue;
-    const key = trimmed.slice(0, separator).trim();
-    const value = trimmed.slice(separator + 1).trim();
-    if (!(key in process.env)) process.env[key] = value;
-  }
-}
-const scriptsRoot = path.dirname(fileURLToPath(import.meta.url));
-const swcRuntimeConfigRelativePath = path.join(
-  '.miaoda-runtime',
-  'nest-cli.swc.json'
-);
-const workspaceReadyFile = path.resolve(
-  process.env.MIAODA_WORKSPACE_READY_FILE || '/tmp/event/WORKSPACE_READY'
-);
-const actionPluginReadyFile = path.resolve(
-  process.env.MIAODA_ACTION_PLUGIN_READY_FILE ||
-    '/tmp/event/MIAODA_ACTION_PLUGIN_READY.json'
-);
-const bundleFallbackFile = path.resolve(
-  process.env.MIAODA_NEST_BUNDLE_FALLBACK_FILE ||
-    '/tmp/event/MIAODA_NEST_BUNDLE_FALLBACK'
-);
-const serverHost = process.env.SERVER_HOST || '0.0.0.0';
-const serverPort = Number(process.env.SERVER_PORT || 3000);
-const requestedMode = process.env.MIAODA_NEST_START_MODE || 'workspace';
-const skipActionPluginInit =
-  process.env.MIAODA_NEST_SKIP_ACTION_PLUGIN_INIT === 'true';
-const expectedRestoreEpochMs =
-  process.env.MIAODA_PLATFORM_ENV_NOT_BEFORE_MS || '';
-const supportedModes = new Set([
-  'bundle-handoff',
-  'workspace',
-  'swc',
-]);
-const runtimeStartedAtEpochMs = Date.now();
-const startedAt = process.hrtime.bigint();
-let stopping = false;
-let serviceChild;
-let compilerChild;
-
-if (!supportedModes.has(requestedMode)) {
-  throw new Error(`MIAODA_NEST_START_MODE_INVALID: ${requestedMode}`);
-}
-if (
-  !Number.isSafeInteger(serverPort) ||
-  serverPort <= 0 ||
-  serverPort > 65_535
-) {
-  throw new Error('MIAODA_NEST_SERVER_PORT_INVALID');
-}
-
-function durationMs(since = startedAt) {
-  return Number(process.hrtime.bigint() - since) / 1_000_000;
-}
-
-function emit(phase, since, details = {}) {
-  const atEpochMs = Date.now();
-  const phaseDurationMs = Number(durationMs(since).toFixed(3));
-  process.stdout.write(
-    `${JSON.stringify({
-      event: 'miaoda_workspace_runtime_phase',
-      runtime: 'nest',
-      mode: requestedMode,
-      phase,
-      atEpochMs,
-      phaseStartedAtEpochMs: Number((atEpochMs - phaseDurationMs).toFixed(3)),
-      runtimeStartedAtEpochMs,
-      durationMs: phaseDurationMs,
-      ...details,
-    })}\n`
-  );
-}
-
-function delay(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-function markBundleFallback(reason) {
-  fs.mkdirSync(path.dirname(bundleFallbackFile), { recursive: true });
-  const temporaryFile = `${bundleFallbackFile}.${process.pid}.tmp`;
-  fs.writeFileSync(
-    temporaryFile,
-    `${JSON.stringify({ schemaVersion: 1, reason, at: new Date().toISOString() })}\n`,
-    { mode: 0o600 }
-  );
-  fs.renameSync(temporaryFile, bundleFallbackFile);
-}
-
-function childRunning(child) {
-  return Boolean(
-    child?.pid && child.exitCode === null && child.signalCode === null
-  );
-}
-
-function terminate(child, signal = 'SIGTERM') {
-  if (!child?.pid) return;
-  try {
-    process.kill(-child.pid, signal);
-  } catch {
-    try {
-      child.kill(signal);
-    } catch {}
-  }
-}
-
-function workspaceDependenciesReady() {
-  try {
-    return (
-      fs.statSync(workspaceReadyFile).isFile() &&
-      fs.statSync(path.join(projectRoot, 'node_modules')).isDirectory()
-    );
-  } catch {
-    return false;
-  }
-}
-
-async function waitForDependencies() {
-  const waitStartedAt = process.hrtime.bigint();
-  while (!stopping && !workspaceDependenciesReady()) await delay(100);
-  if (stopping) throw new Error('MIAODA_NEST_STARTUP_STOPPING');
-  emit('dependency_wait', waitStartedAt, { workspaceReadyFile });
-}
-
-function actionPluginPreconditionReady() {
-  try {
-    const marker = JSON.parse(fs.readFileSync(actionPluginReadyFile, 'utf8'));
-    return (
-      marker?.schemaVersion === 1 &&
-      (!expectedRestoreEpochMs ||
-        String(marker.restoreEpochMs || '') === expectedRestoreEpochMs)
-    );
-  } catch {
-    return false;
-  }
-}
-
-async function waitForActionPluginPrecondition() {
-  const waitStartedAt = process.hrtime.bigint();
-  while (!stopping && !actionPluginPreconditionReady()) await delay(100);
-  if (stopping) throw new Error('MIAODA_NEST_STARTUP_STOPPING');
-  emit('action_plugin_wait', waitStartedAt, {
-    actionPluginReadyFile,
-    ownership: 'shared-parent',
-  });
-}
-
-function probeHost(host) {
-  if (!host || host === '0.0.0.0') return '127.0.0.1';
-  if (host === '::' || host === '[::]') return '::1';
-  return host.replace(/^\[|\]$/g, '');
-}
-
-async function waitForPort(child = serviceChild) {
-  const listenStartedAt = process.hrtime.bigint();
-  const deadline = Date.now() + 60_000;
-  const host = probeHost(serverHost);
-  while (!stopping && Date.now() < deadline) {
-    if (child && !childRunning(child)) {
-      throw new Error('MIAODA_NEST_PROCESS_EXITED_BEFORE_READY');
-    }
-    const connected = await new Promise(resolve => {
-      const socket = net.createConnection({ host, port: serverPort });
-      socket.once('connect', () => {
-        socket.destroy();
-        resolve(true);
-      });
-      socket.once('error', () => resolve(false));
-    });
-    if (connected) {
-      emit('listen_ready', listenStartedAt, {
-        host: serverHost,
-        port: serverPort,
-      });
-      return;
-    }
-    await delay(100);
-  }
-  throw new Error('MIAODA_NEST_READY_TIMEOUT');
-}
-
-function spawnInherited(command, args, extraEnv = {}) {
-  return spawn(command, args, {
-    cwd: projectRoot,
-    detached: true,
-    stdio: 'inherit',
-    env: {
-      ...process.env,
-      ...extraEnv,
-      MIAODA_CACHE_BOOTSTRAP_ENABLED: 'false',
-    },
-  });
-}
-
-async function runCommand(command, args, phase) {
-  const phaseStartedAt = process.hrtime.bigint();
-  compilerChild = spawnInherited(command, args);
-  const result = await new Promise((resolve, reject) => {
-    compilerChild.once('error', reject);
-    compilerChild.once('exit', (code, signal) => resolve({ code, signal }));
-  });
-  compilerChild = undefined;
-  emit(phase, phaseStartedAt, result);
-  if (result.code !== 0) {
-    throw new Error(
-      `MIAODA_NEST_COMMAND_FAILED: ${command} ${args.join(' ')} code=${result.code} signal=${result.signal}`
-    );
-  }
-}
-
-async function initializeActionPlugins() {
-  if (skipActionPluginInit) {
-    await waitForActionPluginPrecondition();
-    emit('action_plugin_init_skipped', process.hrtime.bigint(), {
-      reason: 'shared-parent-initialized',
-    });
-    return;
-  }
-  if (actionPluginPreconditionReady()) {
-    emit('action_plugin_init_skipped', process.hrtime.bigint(), {
-      reason: 'shared-parent-initialized',
-    });
-    return;
-  }
-  const cli = [
-    process.env.MIAODA_FULLSTACK_CLI_BIN,
-    path.join(
-      projectRoot,
-      'node_modules',
-      '@lark-apaas',
-      'fullstack-cli',
-      'bin',
-      'cli.js'
-    ),
-    '/usr/lib/node_modules/@lark-apaas/fullstack-cli/bin/cli.js',
-  ].find(candidate => candidate && fs.existsSync(candidate));
-  if (!cli) {
-    throw new Error('MIAODA_ACTION_PLUGIN_CLI_MISSING');
-  }
-  try {
-    await runCommand(
-      process.execPath,
-      [cli, 'action-plugin', 'init'],
-      'action_plugin_init'
-    );
-  } catch (error) {
-    // Match the original dev.js contract: plugin discovery failure is visible
-    // in logs but does not replace the Nest process with a platform failure.
-    process.stderr.write(
-      `${JSON.stringify({
-        event: 'miaoda_action_plugin_init_failed',
-        continueStartup: true,
-        error: error instanceof Error ? error.message : String(error),
-      })}\n`
-    );
-  }
-}
-
-function spawnWorkspaceService() {
-  const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  return spawnInherited(npmCommand, ['run', 'dev:server'], {
-    NODE_ENV: 'development',
-    MIAODA_NEST_CLI_INSTRUMENTATION: 'true',
-  });
-}
-
-function prepareSwcRuntimeConfig() {
-  const sourceConfigPath = path.join(projectRoot, 'nest-cli.json');
-  const runtimeConfigPath = path.join(
-    projectRoot,
-    swcRuntimeConfigRelativePath
-  );
-  const configuration = JSON.parse(fs.readFileSync(sourceConfigPath, 'utf8'));
-  const compilerOptions = configuration.compilerOptions || {};
-  const configuredBuilder = compilerOptions.builder;
-  const configuredSwcOptions =
-    configuredBuilder &&
-    typeof configuredBuilder === 'object' &&
-    configuredBuilder.type === 'swc'
-      ? configuredBuilder.options || {}
-      : {};
-  configuration.compilerOptions = {
-    ...compilerOptions,
-    builder: {
-      type: 'swc',
-      options: {
-        ...configuredSwcOptions,
-        extensions: ['.ts'],
-      },
-    },
-  };
-  fs.mkdirSync(path.dirname(runtimeConfigPath), { recursive: true });
-  const temporaryPath = `${runtimeConfigPath}.${process.pid}.tmp`;
-  fs.writeFileSync(
-    temporaryPath,
-    `${JSON.stringify(configuration, null, 2)}\n`
-  );
-  fs.renameSync(temporaryPath, runtimeConfigPath);
-  return swcRuntimeConfigRelativePath;
-}
-
-function spawnSwcService() {
-  const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  const runtimeConfig = prepareSwcRuntimeConfig();
-  return spawnInherited(
-    npmCommand,
-    ['run', 'dev:server', '--', '--config', runtimeConfig],
-    {
-      NODE_ENV: 'development',
-      MIAODA_NEST_CLI_INSTRUMENTATION: 'true',
-    }
-  );
-}
-
-async function waitForServiceLifetime() {
-  if (!serviceChild) return { code: 1, signal: null };
-  return new Promise((resolve, reject) => {
-    serviceChild.once('error', reject);
-    serviceChild.once('exit', (code, signal) => resolve({ code, signal }));
-  });
-}
-
-async function runDependencyBackedMode(mode) {
-  await waitForDependencies();
-  await initializeActionPlugins();
-  if (mode === 'workspace') {
-    const spawnStartedAt = process.hrtime.bigint();
-    serviceChild = spawnWorkspaceService();
-    emit('process_spawn', spawnStartedAt, { pid: serviceChild.pid });
-  } else if (mode === 'swc') {
-    const spawnStartedAt = process.hrtime.bigint();
-    serviceChild = spawnSwcService();
-    emit('process_spawn', spawnStartedAt, {
-      pid: serviceChild.pid,
-      builder: 'swc',
-      config: swcRuntimeConfigRelativePath,
-      sourceExtensions: ['.ts'],
-    });
-  } else {
-    throw new Error(`MIAODA_NEST_DEPENDENCY_MODE_INVALID: ${mode}`);
-  }
-  await waitForPort();
-  emit('startup', startedAt, { pid: serviceChild.pid, port: serverPort });
-  return waitForServiceLifetime();
-}
-
-async function runBundleHandoff() {
-  const dependenciesReadyAtEntry = workspaceDependenciesReady();
-  // Once dependencies exist, never put the stale bundle back in front during
-  // a supervisor retry. This preserves the original Preview failure/retry UI
-  // when the complete workspace service fails after the transition window.
-  if (dependenciesReadyAtEntry) {
-    emit('bundle_skipped', process.hrtime.bigint(), {
-      reason: 'workspace-dependencies-ready',
-    });
-    return runDependencyBackedMode('workspace');
-  }
-  const runtime = path.join(scriptsRoot, 'server-cache-runtime.mjs');
-  if (!fs.existsSync(runtime)) {
-    markBundleFallback('runtime-missing');
-    process.stderr.write(
-      `${JSON.stringify({
-        event: 'miaoda_nest_bundle_unavailable',
-        reason: 'runtime-missing',
-      })}\n`
-    );
-    return runDependencyBackedMode('workspace');
-  }
-  const spawnStartedAt = process.hrtime.bigint();
-  serviceChild = spawnInherited(process.execPath, [runtime], {
-    MIAODA_NEST_SKIP_ACTION_PLUGIN_INIT: 'true',
-  });
-  emit('process_spawn', spawnStartedAt, {
-    pid: serviceChild.pid,
-    childRuntime: 'server-cache-runtime',
-  });
-  const exitPromise = new Promise((resolve, reject) => {
-    serviceChild.once('error', reject);
-    serviceChild.once('exit', (code, signal) => resolve({ code, signal }));
-  });
-  try {
-    await Promise.race([
-      waitForPort(),
-      exitPromise.then(exit => {
-        throw new Error(
-          `MIAODA_NEST_BUNDLE_EXITED_BEFORE_READY: code=${exit.code} signal=${exit.signal}`
-        );
-      }),
-    ]);
-    emit('startup', startedAt, { pid: serviceChild.pid, port: serverPort });
-    return exitPromise;
-  } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
-    markBundleFallback(reason);
-    process.stderr.write(
-      `${JSON.stringify({
-        event: 'miaoda_nest_bundle_fallback',
-        reason,
-      })}\n`
-    );
-    terminate(serviceChild);
-    return runDependencyBackedMode('workspace');
-  }
-}
-
-async function close(signal) {
-  if (stopping) return;
-  stopping = true;
-  terminate(compilerChild, signal);
-  terminate(serviceChild, signal);
-  setTimeout(() => {
-    terminate(compilerChild, 'SIGKILL');
-    terminate(serviceChild, 'SIGKILL');
-  }, 1_000).unref();
-}
-
-for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
-  process.once(signal, () => void close(signal));
-}
-
-const exit =
-  requestedMode === 'bundle-handoff'
-    ? await runBundleHandoff()
-    : await runDependencyBackedMode(requestedMode);
-process.exit(exit?.code ?? (stopping ? 0 : 1));