@joystick.js/cli-canary 0.0.0-canary.9 → 0.0.0-canary.91

package/dist/lib/build/buildFiles.js

@@ -8,6 +8,37 @@ import browserPathExclusions from "./browserPathExclusions.js";
 import nodePaths from "./nodePaths.js";
 import nodePathExclusions from "./nodePathExclusions.js";
 import buildPlugins from "./buildPlugins.js";
+import getCodeFrame from "./getCodeFrame.js";
+import onWarn from "./onWarn.js";
+const handleBuildException = (exception = {}, file = "") => {
+  try {
+    const error = exception?.errors && exception?.errors[0];
+    const snippet = fs.existsSync(file) ? getCodeFrame(file, {
+      line: error?.location?.line,
+      column: error?.location?.column
+    }) : null;
+    onWarn({
+      file,
+      stack: exception?.stack,
+      line: error?.location?.line,
+      column: error?.location?.column,
+      snippet,
+      lineWithError: error?.location?.lineText?.trim(),
+      message: error?.text
+    });
+    return snippet;
+  } catch (exception2) {
+    throw new Error(`[actionName.handleBuildException] ${exception2.message}`);
+  }
+};
+const handleParseFilePathFromException = (exception = {}) => {
+  try {
+    const rawErrorMessage = exception?.message?.split(":");
+    return rawErrorMessage[1] && rawErrorMessage[1]?.replace("\n", "") || "";
+  } catch (exception2) {
+    throw new Error(`[actionName.handleParseFilePathFromException] ${exception2.message}`);
+  }
+};
 const handleBuildForNode = (nodePaths2 = [], options = {}) => {
   try {
     return esbuild.build({
@@ -60,7 +91,7 @@ const handleCopyFiles = (files = [], outputPath = "") => {
     for (let i = 0; i < files?.length; i += 1) {
       const file = files[i];
       const fileContents = fs.readFileSync(file.path);
-      fs.writeFileSync(
+      fs.outputFileSync(
         `${outputPath || "./.joystick/build"}/${file.path}`,
         fileContents
       );
@@ -71,7 +102,7 @@ const handleCopyFiles = (files = [], outputPath = "") => {
 };
 const isNodePath = (path = "") => {
   try {
-    return nodePaths.some((nodePath) => {
+    return !isNotJavaScript(path) && nodePaths.some((nodePath) => {
       return path.includes(nodePath);
     }) && !nodePathExclusions.some((nodeExclusionPath) => {
       return path.includes(nodeExclusionPath);
@@ -82,7 +113,7 @@ const isNodePath = (path = "") => {
 };
 const isBrowserPath = (path = "") => {
   try {
-    return browserPaths.some((browserPath) => {
+    return !isNotJavaScript(path) && browserPaths.some((browserPath) => {
       return path.includes(browserPath);
     }) && !browserPathExclusions.some((browserExclusionPath) => {
       return path.includes(browserExclusionPath);
@@ -161,16 +192,41 @@ const buildFiles = async (options, { resolve, reject }) => {
     const browserFiles = filesWithPlatform?.filter((file) => file?.platform === "browser");
     const nodeFiles = filesWithPlatform?.filter((file) => file?.platform === "node");
     handleCopyFiles(copyFiles, options?.outputPath);
-    await Promise.all([
-      handleBuildForBrowser(browserFiles, options),
-      handleBuildForNode(nodeFiles, options)
+    const fileResults = await Promise.all([
+      handleBuildForBrowser(browserFiles, options).then(() => {
+        return { success: true };
+      }).catch((exception) => {
+        const file = handleParseFilePathFromException(exception);
+        console.log(file, exception);
+        const snippet = handleBuildException(exception, file);
+        return {
+          success: false,
+          path: file,
+          error: {
+            stack: exception?.stack,
+            snippet
+          }
+        };
+      }),
+      handleBuildForNode(nodeFiles, options).catch((exception) => {
+        const file = handleParseFilePathFromException(exception);
+        const snippet = handleBuildException(exception, file);
+        return {
+          success: false,
+          path: file,
+          error: {
+            stack: exception?.stack,
+            snippet
+          }
+        };
+      })
     ]);
     if (options?.environment !== "development") {
       await Promise.all([browserFiles, nodeFiles].map((file) => {
         return minifyFile(`${options?.outputPath || "./.joystick/build"}/${file.path}`);
       }));
     }
-    resolve();
+    resolve(fileResults);
   } catch (exception) {
     reject(`[buildFiles] ${exception.message}`);
   }

package/dist/lib/build/buildPlugins.js

@@ -114,21 +114,24 @@ var buildPlugins_default = {
       });
       build.onEnd(() => {
         return new Promise((resolve) => {
-          const shouldSetComponentId = [
-            getPlatformSafePath("ui/"),
-            getPlatformSafePath("email/")
-          ].some((bootstrapTarget) => {
-            return build.initialOptions.outfile.includes(bootstrapTarget);
-          });
-          if (shouldSetComponentId) {
-            const file = fs.readFileSync(build.initialOptions.outfile, "utf-8");
-            const joystickUIMatches = file?.match(JOYSTICK_COMPONENT_REGEX) || [];
-            if (joystickUIMatches?.length > 0) {
-              let contents = setComponentId(file)?.replace(
-                /\.component\(\/\*\*\//g,
-                ".component("
-              );
-              fs.writeFileSync(build.initialOptions.outfile, contents);
+          for (let i = 0; i < build?.initialOptions?.entryPoints?.length; i += 1) {
+            const entryPoint = build?.initialOptions?.entryPoints[i];
+            const shouldSetComponentId = [
+              getPlatformSafePath("ui/"),
+              getPlatformSafePath("email/")
+            ].some((bootstrapTarget) => {
+              return entryPoint.includes(bootstrapTarget);
+            });
+            if (shouldSetComponentId) {
+              const file = fs.readFileSync(`${build?.initialOptions?.outdir}/${entryPoint}`, "utf-8");
+              const joystickUIMatches = file?.match(JOYSTICK_COMPONENT_REGEX) || [];
+              if (joystickUIMatches?.length > 0) {
+                let contents = setComponentId(file)?.replace(
+                  /\.component\(\/\*\*\//g,
+                  ".component("
+                );
+                fs.writeFileSync(`${build?.initialOptions?.outdir}/${entryPoint}`, contents);
+              }
             }
           }
           resolve();

package/dist/lib/build/getCodeFrame.js

@@ -1,9 +1,8 @@
 import fs from "fs";
 import { codeFrameColumns } from "@babel/code-frame";
-var getCodeFrame_default = (id = "", location = {}) => {
-  const file = fs.readFileSync(id, "utf-8");
-  const frame = codeFrameColumns(file, { start: location });
-  return frame;
+var getCodeFrame_default = (path = "", location = {}) => {
+  const file = fs.readFileSync(path, "utf-8");
+  return codeFrameColumns(file, { start: location });
 };
 export {
   getCodeFrame_default as default

package/dist/lib/build/onWarn.js

@@ -1,7 +1,7 @@
 import chalk from "chalk";
 import { OBJECT_REGEX } from "../regexes.js";
 import rainbowRoad from "../rainbowRoad.js";
-import getCodeFrame from "../getCodeFrame.js";
+import getCodeFrame from "./getCodeFrame.js";
 const removeLocationDataFromStackTrace = (stackTrace = "") => {
   return stackTrace.replace(OBJECT_REGEX, "");
 };

package/dist/lib/dev/cleanup.js

@@ -1,30 +1,18 @@
-const actionMethod = () => {
-  try {
-  } catch (exception) {
-    throw new Error(`[cleanup.actionMethod] ${exception.message}`);
-  }
-};
-const validateOptions = (options) => {
-  try {
-    if (!options)
-      throw new Error("options object is required.");
-    if (!options.someOption)
-      throw new Error("options.someOption is required.");
-  } catch (exception) {
-    throw new Error(`[cleanup.validateOptions] ${exception.message}`);
-  }
+import ps from "ps-node";
+process.title = "joystick_cleanup";
+const killProcess = (pid = 0) => {
+  return new Promise((resolve) => {
+    ps.kill(pid, () => {
+      resolve();
+    });
+  });
 };
-const cleanup = (options, { resolve, reject }) => {
-  try {
-    validateOptions(options);
-    resolve();
-  } catch (exception) {
-    reject(`[cleanup] ${exception.message}`);
+process.on("message", async (message) => {
+  const parsedMessage = JSON.parse(message);
+  const processIds = parsedMessage?.processIds;
+  for (let i = 0; i < processIds?.length; i += 1) {
+    const processId = processIds[i];
+    await killProcess(processId);
   }
-};
-var cleanup_default = (options) => new Promise((resolve, reject) => {
-  cleanup(options, { resolve, reject });
+  process.exit();
 });
-export {
-  cleanup_default as default
-};

package/dist/lib/dev/databases/mongodb/index.js

@@ -4,7 +4,7 @@ import child_process from "child_process";
 import { kill as killPortProcess } from "cross-port-killer";
 import isWindows from "../../isWindows.js";
 import CLILog from "../../../../lib/CLILog.js";
-import getProcessIdFromPort from "../../getProcessIdFromPort.js";
+import getProcessIdFromPort from "../../../getProcessIdFromPort.js";
 const getMongoProcessId = async (port = 2601) => {
   const pids = await getProcessIdFromPort(port);
   return pids.tcp && pids.tcp[0];

package/dist/lib/dev/databases/postgresql/index.js

@@ -4,8 +4,8 @@ import util from "util";
 import commandExists from "command-exists";
 import child_process from "child_process";
 import { kill as killPortProcess } from "cross-port-killer";
-import getProcessIdFromPort from "../../getProcessIdFromPort.js";
-import CLILog from "../../../../lib/CLILog.js";
+import getProcessIdFromPort from "../../../getProcessIdFromPort.js";
+import CLILog from "../../../CLILog.js";
 const exec = util.promisify(child_process.exec);
 const getPostgreSQLProcessId = async (port = 2610) => {
   const pids = await getProcessIdFromPort(port);

package/dist/lib/dev/databases/providerMap.js

@@ -1,4 +1,4 @@
-import connectMongoDB from "./mongodb/connect.js.js";
+import connectMongoDB from "./mongodb/connect.js";
 import connectPostgreSQL from "./postgresql/connect.js";
 var providerMap_default = {
   mongodb: {

package/dist/lib/dev/index.js

@@ -8,7 +8,6 @@ import loadSettings from "./loadSettings.js";
 import Loader from "../loader.js";
 import startDatabases from "./startDatabases.js";
 import runTests from "./runTests.js";
-import cleanup from "./cleanup.js";
 import startHMR from "./startHMR.js";
 import startApp from "./startApp.js";
 import requiredFiles from "./requiredFiles.js";
@@ -19,12 +18,7 @@ import filesToCopy from "../filesToCopy.js";
 import { SETTINGS_FILE_NAME_REGEX } from "../regexes.js";
 import getCodependenciesForFile from "./getCodependenciesForFile.js";
 import removeDeletedDependenciesFromMap from "../build/removeDeletedDependenciesFromMap.js";
-const nodeMajorVersion = parseInt(
-  process?.version?.split(".")[0]?.replace("v", ""),
-  10
-);
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+import chalk from "chalk";
 const getDatabaseProcessIds = () => {
   try {
     const databaseProcessIds = [];
@@ -49,14 +43,14 @@ const getDatabaseProcessIds = () => {
     throw new Error(`[dev.getDatabaseProcessIds] ${exception.message}`);
   }
 };
-const handleSignalEvents = (processIds = []) => {
+const handleSignalEvents = (processIds = [], nodeMajorVersion = 0, __dirname = "") => {
   try {
     const execArgv = ["--no-warnings"];
     if (nodeMajorVersion < 19) {
       execArgv.push("--experimental-specifier-resolution=node");
     }
     const cleanupProcess = child_process.fork(
-      path.resolve(`${__dirname}/cleanup/index.js`),
+      path.resolve(`${__dirname}/cleanup.js`),
       [],
       {
         // NOTE: Run in detached mode so when parent process dies, the child still runs
@@ -82,6 +76,46 @@ const handleSignalEvents = (processIds = []) => {
     throw new Error(`[dev.handleSignalEvents] ${exception.message}`);
   }
 };
+const handleServerProcessMessages = () => {
+  try {
+    process.serverProcess.on("message", (message) => {
+      const processMessages = ["SERVER_CLOSED"];
+      if (!processMessages.includes(message)) {
+        process.loader.stable(message);
+      }
+    });
+  } catch (exception) {
+    throw new Error(`[dev.handleServerProcessMessages] ${exception.message}`);
+  }
+};
+const handleServerProcessSTDIO = () => {
+  try {
+    if (process.serverProcess) {
+      process.serverProcess.on("error", (error) => {
+        console.log(error);
+      });
+      process.serverProcess.stdout.on("data", (data) => {
+        const message = data.toString();
+        if (message && message.includes("App running at:")) {
+          process.loader.stable(message);
+        } else {
+          if (message && !message.includes("BUILD_ERROR")) {
+            console.log(message);
+          }
+        }
+      });
+      process.serverProcess.stderr.on("data", (data) => {
+        process.loader.stop();
+        CLILog(data.toString(), {
+          level: "danger",
+          docs: "https://cheatcode.co/docs/joystick"
+        });
+      });
+    }
+  } catch (exception) {
+    throw new Error(`[dev.handleServerProcessSTDIO] ${exception.message}`);
+  }
+};
 const handleAddOrChangeFile = async (context = {}, path2 = "") => {
   try {
     if (context.isAddingOrChangingFile) {
@@ -187,7 +221,7 @@ const getWatchChangeContext = (event = "", path2 = "") => {
   try {
     const isHTMLUpdate = path2 === "index.html";
     const isUIPath = path2?.includes("ui/") || path2 === "index.css" || isHTMLUpdate;
-    const isUIUpdate = process.hmrProcess.hasConnections && isUIPath || false;
+    const isUIUpdate = process.hmrProcess && process.hmrProcess.hasConnections && isUIPath || false;
     const isSettingsUpdate = path2?.match(SETTINGS_FILE_NAME_REGEX)?.length > 0;
     const isDirectory = fs.statSync(path2).isDirectory();
     const isFile = fs.statSync(path2).isFile();
@@ -242,14 +276,19 @@ const startFileWatcher = (options = {}) => {
 };
 const runInitialBuild = async (buildSettings = {}) => {
   try {
+    process.loader.text("Building app...");
     const filesToBuild = getFilesToBuild(buildSettings?.excludedPaths, "start");
-    const fileResults = await buildFiles(
-      filesToBuild,
-      null,
-      process.env.NODE_ENV
-    );
+    const fileResults = await buildFiles({
+      files: filesToBuild,
+      environment: process.env.NODE_ENV
+    });
     const hasErrors = [...fileResults].filter((result) => !!result).map(({ success }) => success).includes(false);
+    if (hasErrors) {
+      console.log(chalk.redBright("Failed to start app. Correct the errors above and run joystick start again.\n"));
+      process.exit(1);
+    }
   } catch (exception) {
+    console.warn(exception);
     throw new Error(`[dev.runInitialBuild] ${exception.message}`);
   }
 };
@@ -287,21 +326,25 @@ const checkForRequiredFiles = () => {
       let error = `The following paths are missing and required in a Joystick project:
 
 `;
-      error += `Files:
+      if (files?.length > 0) {
+        error += `  > Required Files:
 
 `;
-      for (let i = 0; i < files?.length; i += 1) {
-        const file = files[i];
-        error += `${file.path}
-
+        for (let i = 0; i < files?.length; i += 1) {
+          const file = files[i];
+          error += `  /${file.path}
 `;
+        }
       }
-      error += `Directories:
+      if (directories?.length > 0) {
+        error += `  > Required Directories:
 
 `;
-      for (let i = 0; i < directories?.length; i += 1) {
-        const file = directories[i];
-        error += `${file.path}`;
+        for (let i = 0; i < directories?.length; i += 1) {
+          const file = directories[i];
+          error += `  /${file.path}
+`;
+        }
       }
       CLILog(error, {
         level: "danger",
@@ -327,7 +370,7 @@ const warnInvalidJoystickEnvironment = () => {
       );
       process.exit(0);
     }
-    if (process.env.NODE_ENV !== "test" && (!hasJoystickFolder || !hasTestsFolder)) {
+    if (process.env.NODE_ENV !== "test" && !hasJoystickFolder) {
       CLILog(
         "joystick start must be run in a directory with a .joystick folder.",
         {
@@ -355,18 +398,51 @@ const dev = async (options, { resolve, reject }) => {
   try {
     validateOptions(options);
     initProcess(options);
+    const nodeMajorVersion = parseInt(
+      process?.version?.split(".")[0]?.replace("v", ""),
+      10
+    );
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
     warnInvalidJoystickEnvironment();
     checkForRequiredFiles();
     const settings = await loadSettings({
+      environment: options.environment
+    });
+    await startDatabases({
       environment: options.environment,
-      process: options.process
+      port: options.port,
+      settings: settings.parsed
     });
-    await startDatabases(settings.parsed);
     await runInitialBuild(settings?.parsed?.config?.build);
     await startFileWatcher(options);
-    handleSignalEvents();
+    const serverProcess = await startApp({
+      nodeMajorVersion,
+      port: options?.port
+    });
+    if (serverProcess) {
+      process.serverProcess = serverProcess;
+      handleServerProcessSTDIO();
+      handleServerProcessMessages();
+    }
+    let hmrProcess;
+    if (options?.environment !== "test") {
+      hmrProcess = await startHMR({
+        nodeMajorVersion,
+        __dirname
+      });
+    }
+    handleSignalEvents(
+      [serverProcess.pid, hmrProcess.pid],
+      nodeMajorVersion,
+      __dirname
+    );
+    if (options?.environment === "test") {
+      process.loader.text("Running tests...");
+    }
     resolve();
   } catch (exception) {
+    console.warn(exception);
     reject(`[dev] ${exception.message}`);
   }
 };

package/dist/lib/dev/isWindows.js

@@ -0,0 +1,5 @@
+import os from "os";
+var isWindows_default = os.platform() === "win32";
+export {
+  isWindows_default as default
+};

package/dist/lib/dev/loadSettings.js

@@ -62,9 +62,7 @@ const loadSettings = (options, { resolve, reject }) => {
     warnIfSettingsNotFound(settingsPath);
     const settings = getSettings(settingsPath);
     warnIfInvalidJSONInSettings(settings);
-    if (options?.process) {
-      options.process.env.JOYSTICK_SETTINGS = settings;
-    }
+    process.env.JOYSTICK_SETTINGS = settings;
     resolve({
       parsed: JSON.parse(settings),
       unparsed: settings

package/dist/lib/dev/startApp.js

@@ -1,13 +1,51 @@
-const actionMethod = () => {
+import child_process from "child_process";
+import path from "path";
+const handleStartServerProcess = (execArgv = {}, sessionsBeforeHMRUpdate = {}) => {
   try {
+    process.loader.text("Starting app...");
+    return child_process.fork(
+      path.resolve(".joystick/build/index.server.js"),
+      [],
+      {
+        execArgv,
+        // NOTE: Pipe stdin, stdout, and stderr. IPC establishes a message channel so we
+        // communicate with the child_process.
+        silent: true,
+        env: {
+          FORCE_COLOR: "1",
+          LOGS_PATH: process.env.LOGS_PATH,
+          NODE_ENV: process.env.NODE_ENV,
+          ROOT_URL: process.env.ROOT_URL,
+          PORT: process.env.PORT,
+          JOYSTICK_SETTINGS: process.env.JOYSTICK_SETTINGS,
+          HMR_SESSIONS: JSON.stringify(sessionsBeforeHMRUpdate)
+        }
+      }
+    );
   } catch (exception) {
-    throw new Error(`[startApp.actionMethod] ${exception.message}`);
+    throw new Error(`[startApp.handleStartServerProcess] ${exception.message}`);
+  }
+};
+const getExecArgs = (nodeMajorVersion = 0) => {
+  try {
+    const execArgv = ["--no-warnings"];
+    if (nodeMajorVersion < 19) {
+      execArgv.push("--experimental-specifier-resolution=node");
+    }
+    if (process.env.NODE_ENV === "development" && process.env.IS_DEBUG_MODE === "true") {
+      execArgv.push("--inspect");
+    }
+    return execArgv;
+  } catch (exception) {
+    throw new Error(`[startApp.getExecArgs] ${exception.message}`);
   }
 };
 const validateOptions = (options) => {
   try {
     if (!options)
       throw new Error("options object is required.");
+    if (!options.nodeMajorVersion)
+      throw new Error("options.nodeMajorVersion is required.");
     if (!options.port)
       throw new Error("options.port is required.");
   } catch (exception) {
@@ -17,7 +55,9 @@ const validateOptions = (options) => {
 const startApp = (options, { resolve, reject }) => {
   try {
     validateOptions(options);
-    resolve();
+    const execArgv = getExecArgs(options?.nodeMajorVersion);
+    const serverProcess = handleStartServerProcess(execArgv);
+    return resolve(serverProcess);
   } catch (exception) {
     reject(`[startApp] ${exception.message}`);
   }

package/dist/lib/dev/startDatabases.js

@@ -1,6 +1,6 @@
-import util from "util";
 import CLILog from "../CLILog.js";
 import providerMap from "./databases/providerMap.js";
+import { isObject } from "../types.js";
 const startDatabaseProvider = async (environment = "development", database = {}, port = 2610, hasMultipleOfProvider = false) => {
   try {
     const provider = providerMap[database?.provider];
@@ -19,12 +19,13 @@ const startDatabaseProvider = async (environment = "development", database = {},
     throw new Error(`[startDatabases.startDatabaseProvider] ${exception.message}`);
   }
 };
-const startDatabaseProviders = async (databases = [], databasePortStart = 2610) => {
+const startDatabaseProviders = async (databases = [], databasePortStart = 2610, environment = "") => {
   try {
     for (let i = 0; i < databases?.length; i += 1) {
       const database = databases[i];
       const hasMultipleOfProvider = databases?.filter((database2) => database2?.provider === database2?.provider)?.length > 1;
       await startDatabaseProvider(
+        environment,
         database,
         // NOTE: Increment each database port using index in the databases array from settings if no port
         // is assigned in the settings.
@@ -39,7 +40,7 @@ const startDatabaseProviders = async (databases = [], databasePortStart = 2610)
 const validateDatabasesFromSettings = (databases = []) => {
   try {
     const databasesNotAsObjects = databases.filter(
-      (database) => !util.types.isKeyObject(database)
+      (database) => !isObject(database)
     );
     const userDatabases = databases.filter((database) => !!database.users);
     const queueDatabases = databases.filter((database) => !!database.queues);
@@ -73,6 +74,8 @@ const validateOptions = (options) => {
   try {
     if (!options)
       throw new Error("options object is required.");
+    if (!options.environment)
+      throw new Error("options.environment is required.");
     if (!options.port)
       throw new Error("options.port is required.");
     if (!options.settings)
@@ -84,10 +87,14 @@ const validateOptions = (options) => {
 const startDatabases = async (options, { resolve, reject }) => {
   try {
     validateOptions(options);
-    const databases = options?.settings?.databases || [];
+    const databases = options?.settings?.config?.databases || [];
     if (databases?.length > 0) {
       validateDatabasesFromSettings(databases);
-      await startDatabaseProviders(databases, options?.port);
+      await startDatabaseProviders(
+        databases,
+        options?.port + 10,
+        options?.environment
+      );
     }
     resolve();
   } catch (exception) {

package/dist/lib/dev/startHMR.js

@@ -1,15 +1,38 @@
-const actionMethod = () => {
+import child_process from "child_process";
+import path from "path";
+const handleStartHMRProcess = (execArgv = {}, __dirname = "") => {
   try {
+    return child_process.fork(
+      path.resolve(`${__dirname}/hmrServer.js`),
+      [],
+      {
+        execArgv,
+        // NOTE: Pipe stdin, stdout, and stderr. IPC establishes a message channel so we
+        // communicate with the child_process.
+        silent: true
+      }
+    );
   } catch (exception) {
-    throw new Error(`[startHMR.actionMethod] ${exception.message}`);
+    throw new Error(`[startHMR.handleStartHMRProcess] ${exception.message}`);
+  }
+};
+const getExecArgs = (nodeMajorVersion = 0) => {
+  try {
+    const execArgv = ["--no-warnings"];
+    if (nodeMajorVersion < 19) {
+      execArgv.push("--experimental-specifier-resolution=node");
+    }
+    return execArgv;
+  } catch (exception) {
+    throw new Error(`[startHMR.getExecArgs] ${exception.message}`);
   }
 };
 const validateOptions = (options) => {
   try {
     if (!options)
       throw new Error("options object is required.");
-    if (!options.port)
-      throw new Error("options.port is required.");
+    if (!options.nodeMajorVersion)
+      throw new Error("options.nodeMajorVersion is required.");
   } catch (exception) {
     throw new Error(`[startHMR.validateOptions] ${exception.message}`);
   }
@@ -17,7 +40,9 @@ const validateOptions = (options) => {
 const startHMR = (options, { resolve, reject }) => {
   try {
     validateOptions(options);
-    resolve();
+    const execArgv = getExecArgs(options?.nodeMajorVersion);
+    const hmrProcess = handleStartHMRProcess(execArgv, options?.__dirname);
+    return resolve(hmrProcess);
   } catch (exception) {
     reject(`[startHMR] ${exception.message}`);
   }