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

package/src/lib/dev/startApp.js

@@ -1,16 +1,59 @@
-/* eslint-disable consistent-return */
+import child_process from "child_process";
+import path from "path";
 
-const actionMethod = () => {
+const handleStartServerProcess = (execArgv = {}, sessionsBeforeHMRUpdate = {}) => {
   try {
-    // Perform a single step in your action here.
+    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) {
     throw new Error(`[startApp.validateOptions] ${exception.message}`);
@@ -20,8 +63,11 @@ const validateOptions = (options) => {
 const startApp = (options, { resolve, reject }) => {
   try {
     validateOptions(options);
-    // Call action methods in sequence here.
-    resolve();
+
+    const execArgv = getExecArgs(options?.nodeMajorVersion);
+    const serverProcess = handleStartServerProcess(execArgv);
+
+    return resolve(serverProcess);
   } catch (exception) {
     reject(`[startApp] ${exception.message}`);
   }

package/src/lib/dev/startDatabases.js

@@ -1,8 +1,8 @@
 /* eslint-disable consistent-return */
 
-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',
@@ -31,13 +31,14 @@ const startDatabaseProvider = async (
   }
 };
 
-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((database) => database?.provider === database?.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.
@@ -53,8 +54,8 @@ 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);
@@ -95,6 +96,7 @@ const validateDatabasesFromSettings = (databases = []) => {
 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) throw new Error('options.settings is required.');
   } catch (exception) {
@@ -106,11 +108,15 @@ 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();

package/src/lib/dev/startHMR.js

@@ -1,17 +1,43 @@
-/* eslint-disable consistent-return */
+import child_process from "child_process";
+import path from "path";
 
-const actionMethod = () => {
+const handleStartHMRProcess = (execArgv = {}, __dirname = '') => {
   try {
-    // Perform a single step in your action here.
+    // NOTE: Port is automatically pulled via process.env.PORT
+    // in the hmrServer.js script.
+    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}`);
   }
@@ -20,8 +46,11 @@ const validateOptions = (options) => {
 const startHMR = (options, { resolve, reject }) => {
   try {
     validateOptions(options);
-    // Call action methods in sequence here.
-    resolve();
+
+    const execArgv = getExecArgs(options?.nodeMajorVersion);
+    const hmrProcess = handleStartHMRProcess(execArgv, options?.__dirname);
+
+    return resolve(hmrProcess);
   } catch (exception) {
     reject(`[startHMR] ${exception.message}`);
   }

package/src/lib/getProcessIdFromPort.js

@@ -0,0 +1,92 @@
+import condense from 'selective-whitespace';
+import netstats from 'netstats';
+
+const platform = process.platform;
+
+function pushTo(target, item) {
+  if (item !== '' && typeof item === 'number' && item !== 0 && target.indexOf(item) === -1) {
+    target.push(item);
+  }
+}
+
+// Example output to parse (macOS):
+// $ lsof -i :8017
+/*
+ COMMAND   PID    USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME
+ nc      20661 michael    3u  IPv4 0x3b190d9d07c2c3db      0t0  TCP *:8017 (LISTEN)
+ nc      21145 michael    3u  IPv4 0x3b190d9d054773db      0t0  TCP *:8017 (LISTEN)
+ Python  21221 michael    3u  IPv4 0x3b190d9ceb8dfd7b      0t0  UDP localhost:8017
+ */
+
+// [WIN] $ netstat.exe -a -n -o | findstr :9000
+
+/*
+ TCP    0.0.0.0:9000           0.0.0.0:0              LISTENING       5220
+ TCP    127.0.0.1:9000         127.0.0.1:62376        ESTABLISHED     5220
+ TCP    127.0.0.1:9000         127.0.0.1:62379        ESTABLISHED     5220
+ TCP    127.0.0.1:62288        127.0.0.1:9000         TIME_WAIT       0
+ TCP    127.0.0.1:62299        127.0.0.1:9000         TIME_WAIT       0
+ TCP    127.0.0.1:62376        127.0.0.1:9000         ESTABLISHED     7604
+ TCP    127.0.0.1:62378        127.0.0.1:9000         ESTABLISHED     7604
+ UDP    127.0.0.1:9000         *:*                                    1240
+ */
+
+async function processNetStats(arr) {
+  const pidindex = 1;
+  let items = arr.slice(1);
+
+  if (platform === 'win32') {
+    items = arr;
+  }
+
+  const pids = {
+    all: [],
+    tcp: [],
+    udp: [],
+  };
+
+  await Promise.all(items.map((item) => {
+    const values = condense(item).split(' ');
+    let pid = parseInt(values[pidindex], 10);
+
+    if (platform === 'win32') {
+      pid = parseInt(values.pop(), 10);
+    }
+
+    if (values.length > 1) {
+      if (values.indexOf('TCP') !== -1) {
+        pushTo(pids.tcp, pid);
+        pushTo(pids.all, pid);
+      } else if (values.indexOf('UDP') !== -1) {
+        pushTo(pids.udp, pid);
+        pushTo(pids.all, pid);
+      }
+    }
+
+    return Promise.resolve();
+  }));
+
+  return pids;
+}
+
+function getProcessIdFromPort(port) {
+  if (typeof port !== 'number') {
+    throw new TypeError('Expected a port number');
+  }
+
+  return new Promise(((resolve) => {
+    netstats(port).then((stats) => {
+      processNetStats(stats).then((ps) => {
+        resolve(ps);
+      });
+    }).catch(() => {
+      resolve({
+        all: [],
+        tcp: [],
+        udp: [],
+      });
+    });
+  }));
+}
+
+export default getProcessIdFromPort;

package/src/lib/types.js

@@ -0,0 +1,3 @@
+export const isObject = (value) => {
+  return value !== null && !Array.isArray(value) && typeof value === 'object';
+};