@joystick.js/cli-canary 0.0.0-canary.67 → 0.0.0-canary.670

package/src/lib/dev/getCodependenciesForFile.js

@@ -1,84 +0,0 @@
-import fs from "fs";
-import readFileDependencyMap from "./readFileDependencyMap.js";
-
-const findCodependenciesInMap = (pathVariations = [], map = {}) => {
-  return Object.entries(map)
-    .filter(([codependentPath, codependentDependencies]) => {
-      const hasMatchingImports =
-        codependentDependencies &&
-        codependentDependencies.imports &&
-        codependentDependencies.imports.some((codependentDependency) => {
-          return pathVariations.some((pathVariation) => {
-            return codependentDependency.path.includes(pathVariation);
-          });
-        });
-
-      const hasMatchingRequires =
-        codependentDependencies &&
-        codependentDependencies.requires &&
-        codependentDependencies.requires.some((codependentDependency) => {
-          return pathVariations.some((pathVariation) => {
-            return codependentDependency.path.includes(pathVariation);
-          });
-        });
-
-      return hasMatchingImports || hasMatchingRequires;
-    })
-    .map(([matchingCodependentPath]) => {
-      return matchingCodependentPath.replace(`${process.cwd()}/`, "");
-    });
-};
-
-const getPathVariations = (path = "") => {
-  const pathParts = path.split("/");
-  const variations = [];
-  const lastPathPart = pathParts && pathParts[pathParts.length - 1];
-
-  pathParts.forEach((pathPart, pathPartIndex) => {
-    let base = `${pathPart}`;
-
-    variations.push(`/${pathPart}`);
-
-    pathParts.slice(pathPartIndex + 1, pathParts.length).forEach((part) => {
-      base = base += `/${part}`;
-      variations.push(base);
-      if (part.includes(".")) {
-        variations.push(base.split(".")[0]);
-      }
-    });
-  });
-
-  if (lastPathPart?.includes('.')) {
-    variations.push(`./${lastPathPart}`);
-    variations.push(`./${lastPathPart?.split('.')[0]}`);
-  }
-
-  variations.push(`./${pathParts[0]}`);
-  variations.push(`./${pathParts[0]}/index`);
-  variations.push(`./${pathParts[0]}/index.js`);
-
-  // TODO: This may wreak havoc eventually, but going to let it slide
-  // for now.
-  variations.push(`/index`);
-  variations.push(`/index.js`);
-
-  return variations;
-};
-
-export default (pathToFind = "") => {
-  const pathVariations = getPathVariations(pathToFind);
-  const fileDependencyMap = readFileDependencyMap();
-  const codpendencies = findCodependenciesInMap(
-    pathVariations,
-    fileDependencyMap
-    );
-
-  return {
-    existing: codpendencies.filter((codependency) => {
-      return !!fs.existsSync(codependency);
-    }),
-    deleted: codpendencies.filter((codependency) => {
-      return !fs.existsSync(codependency);
-    }),
-  };
-};

package/src/lib/dev/getFilesToBuild.js

@@ -1,47 +0,0 @@
-import fs from "fs";
-import { join } from "path";
-import masterIgnoreList from "../masterIgnoreList.js";
-
-const getFileListFromPath = (directoryPath = '', files = []) => {
-  const filesInDirectory = fs.readdirSync(directoryPath);
-  const filesWithDirectoryPathPrefix = filesInDirectory.map((filePathInDirectory = '') => {
-    return join(directoryPath, filePathInDirectory);
-  });
-
-  files.push(...filesWithDirectoryPathPrefix);
-
-  filesWithDirectoryPathPrefix.forEach((filePathWithDirectoryPrefix = '') => {
-    const pathIsDirectory = fs.statSync(filePathWithDirectoryPrefix).isDirectory();
-
-    if (pathIsDirectory) {
-      getFileListFromPath(filePathWithDirectoryPrefix, files);
-    }
-  });
-
-  return files;
-};
-
-export default (excludedPaths = [], context = null) => {
-  const files = getFileListFromPath("./");
-  
-  const masterIgnoreListFilteredForContext = context && context === 'start' ? masterIgnoreList?.filter((fileToIgnore) => {
-    return !fileToIgnore.includes('settings');
-  }) : masterIgnoreList;
-
-  return files
-    .filter((path) => {
-      const isExcluded = excludedPaths.some((excludedPath) => {
-        return path.includes(excludedPath);
-      });
-
-      return !isExcluded;
-    })
-    .filter((path) => {
-      return !masterIgnoreListFilteredForContext.some((excludedPath) => {
-        return path.includes(excludedPath);
-      });
-    })
-    .filter((path) => {
-      return !fs.lstatSync(path).isDirectory();
-    });
-};

package/src/lib/dev/index.js

@@ -1,560 +0,0 @@
-/* eslint-disable consistent-return */
-
-import fs from 'fs';
-import path, { dirname } from "path";
-import { fileURLToPath } from "url";
-import child_process from "child_process";
-import chokidar from "chokidar";
-import CLILog from "../CLILog.js";
-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";
-import watchlist from "./watchlist.js";
-import getFilesToBuild from "./getFilesToBuild.js";
-import buildFiles from "../build/buildFiles.js";
-import filesToCopy from "../filesToCopy.js";
-import { SETTINGS_FILE_NAME_REGEX } from "../regexes.js";
-import getCodependenciesForFile from "./getCodependenciesForFile.js";
-import removeDeletedDependenciesFromMap from "../build/removeDeletedDependenciesFromMap.js";
-import chalk from "chalk";
-
-const getDatabaseProcessIds = () => {
-  try {
-    const databaseProcessIds = [];
-    const databases = Object.entries(process._databases || {});
-
-    for (let i = 0; i < databases?.length; i += 1) {
-      const [_provider, providerConnection] = databases[i];
-
-      if (providerConnection?.pid) {
-        databaseProcessIds.push(providerConnection.pid);
-      }
-
-      if (!providerConnection?.pid) {
-        const providerConnections = Object.entries(providerConnection);
-
-        for (let pc = 0; pc < providerConnections?.length; pc += 1) {
-          const [_connectionName, connection] = providerConnections[pc];
-
-          if (connection?.pid) {
-            databaseProcessIds.push(connection.pid);
-          }
-        }
-      }
-    }
-
-    return databaseProcessIds;
-  } catch (exception) {
-    throw new Error(`[dev.getDatabaseProcessIds] ${exception.message}`);
-  }
-};
-
-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`),
-      [],
-      {
-        // NOTE: Run in detached mode so when parent process dies, the child still runs
-        // and cleanup completes.
-        detached: true,
-        execArgv,
-        // NOTE: Pipe stdin, stdout, and stderr. IPC establishes a message channel so we
-        // communicate with the child_process.
-        silent: true,
-      }
-    );
-
-    process.on("SIGINT", async () => {
-      const databaseProcessIds = getDatabaseProcessIds();
-      cleanupProcess.send(JSON.stringify(({ processIds: [...processIds, ...databaseProcessIds] })));
-      process.exit();
-    });
-
-    process.on("SIGTERM", async () => {
-      const databaseProcessIds = getDatabaseProcessIds();
-      cleanupProcess.send(JSON.stringify(({ processIds: [...processIds, ...databaseProcessIds] })));
-      process.exit();
-    });
-  } catch (exception) {
-    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 = {}, path = '') => {
-  try {
-    if (context.isAddingOrChangingFile) {
-      const codependencies = await getCodependenciesForFile(path);
-      const fileResults = await buildFiles(
-        [path, ...(codependencies?.existing || [])],
-        null,
-        process.env.NODE_ENV
-      );
-
-      const fileResultsHaveErrors = fileResults
-        .filter((result) => !!result)
-        .map(({ success }) => success)
-        .includes(false);
-
-      removeDeletedDependenciesFromMap(codependencies.deleted);
-
-      if (process.serverProcess && fileResultsHaveErrors) {
-        // NOTE: If there's a build error while the app is running, relay it to
-        // the app's server process to display an error page in the browser.
-        process.serverProcess.send(
-          JSON.stringify({
-            error: "BUILD_ERROR",
-            paths: fileResults
-              .filter(({ success }) => !success)
-              .map(({ path: pathWithError, error }) => ({
-                path: pathWithError,
-                error,
-              })),
-          })
-        );
-
-        return;
-      }
-
-      if (!fileResultsHaveErrors) {
-        process.initialBuildComplete = true;
-
-        if (context.isUIUpdate) {
-          handleNotifyHMRClients(context.isHTMLUpdate);
-        } else {
-          handleRestartApplicationProcess();
-        }
-
-        return;
-      }
-    }
-  } catch (exception) {
-    throw new Error(`[dev.handleAddOrChangeFile] ${exception.message}`);
-  }
-};
-
-const handleAddDirectory = (context = {}, path = '') => {
-  try {
-    if (context.isAddDirectory) {
-      fs.mkdirSync(`./.joystick/build/${path}`);
-
-      if (context.isUIUpdate) {
-        handleNotifyHMRClients(context.isHTMLUpdate);
-      } else {
-        handleRestartApplicationProcess();
-      }
-    }
-  } catch (exception) {
-    throw new Error(`[dev.handleAddDirectory] ${exception.message}`);
-  }
-};
-
-const handleCopyFile = (context = {}, path = '') => {
-  try {
-    if (context.isFileToCopy && !context.isDirectory) {
-      fs.writeFileSync(`./.joystick/build/${path}`, fs.readFileSync(path));
-
-      if (context.isUIUpdate) {
-        handleNotifyHMRClients(context.isHTMLUpdate);
-      } else {
-        handleRestartApplicationProcess();
-      }
-    }
-  } catch (exception) {
-    throw new Error(`[dev.handleCopyFile] ${exception.message}`);
-  }
-};
-
-const handleCopyDirectory = (context = {}, path = '') => {
-  try {
-    if (context.isFileToCopy && context.isDirectory && !context.isExistingDirectoryInBuild) {
-      fs.mkdirSync(`./.joystick/build/${path}`);
-
-      if (context.isUIUpdate) {
-        handleNotifyHMRClients(context.isHTMLUpdate);
-      } else {
-        handleRestartApplicationProcess();
-      }
-    }
-  } catch (exception) {
-    throw new Error(`[dev.handleCopyDirectory] ${exception.message}`);
-  }
-};
-
-const handleRestartApplicationProcess = () => {
-  try {
-    // Perform a single step in your action here.
-  } catch (exception) {
-    throw new Error(`[dev.handleRestartApplicationProcess] ${exception.message}`);
-  }
-};
-
-const handleNotifyHMRClients = (indexHTMLChanged = false) => {
-  try {
-    if (process.hmrProcess) {
-      const settings = loadSettings(process.env.NODE_ENV);
-      process.hmrProcess.send(
-        JSON.stringify({
-          type: "RESTART_SERVER",
-          settings,
-          indexHTMLChanged,
-        })
-      );
-    }
-  } catch (exception) {
-    throw new Error(`[dev.handleNotifyHMRClients] ${exception.message}`);
-  }
-};
-
-const getWatchChangeContext = (event = '', path = '') => {
-  try {
-    const isHTMLUpdate = path === "index.html";
-    const isUIPath = path?.includes("ui/") || path === 'index.css' || isHTMLUpdate;
-    // TODO: Flimsy. May want to wait until HMR and server are up to do the builds/watching.
-    const isUIUpdate = (process.hmrProcess && process.hmrProcess.hasConnections && isUIPath) || false;
-    const isSettingsUpdate = path?.match(SETTINGS_FILE_NAME_REGEX)?.length > 0;
-    const isDirectory = fs.statSync(path).isDirectory();
-    const isFile = fs.statSync(path).isFile();
-    const isExistingDirectoryInSource = isDirectory && fs.existsSync(path);
-    const isExistingDirectoryInBuild = !!fs.existsSync(`./.joystick/build/${path}`);
-    const isAddDirectory = event === 'addDir' && isExistingDirectoryInSource && !isExistingDirectoryInBuild;
-    const isFileToCopy = !!filesToCopy.find((fileToCopy) => fileToCopy.path === path);
-    const isExistingFileInSource = isFile && fs.existsSync(path);
-    const isAddingOrChangingFile = event === 'add' && isExistingFileInSource;
-
-    return {
-      isHTMLUpdate,
-      isUIPath,
-      isUIUpdate,
-      isSettingsUpdate,
-      isDirectory,
-      isFile,
-      isExistingDirectoryInSource,
-      isExistingDirectoryInBuild,
-      isAddDirectory,
-      isFileToCopy,
-      isExistingFileInSource,
-      isAddingOrChangingFile,
-    };
-  } catch (exception) {
-    throw new Error(`[dev.getWatchChangeContext] ${exception.message}`);
-  }
-};
-
-const startFileWatcher = (options = {}) => {
-  try {
-    const watcher = chokidar.watch(
-      watchlist.map(({ path }) => path),
-      { ignoreInitial: true }
-    );
-
-    watcher.on('all', async (event, path) => {
-      // NOTE: Do this here in case a required file/folder goes missing inbetween builds.
-      checkForRequiredFiles();
-
-      process.loader.text("Rebuilding app...");
-
-      const watchChangeContext = getWatchChangeContext(event, path);
-
-      handleCopyDirectory(watchChangeContext, path);
-      handleCopyFile(watchChangeContext, path);
-      handleAddDirectory(watchChangeContext, path);
-      await handleAddOrChangeFile(watchChangeContext, path);
-
-      if (watchChangeContext?.isSettingsUpdate) {
-        await loadSettings({
-          environment: options.environment,
-          process: options.process,
-        });
-      }
-    });
-  } catch (exception) {
-    throw new Error(`[dev.startFileWatcher] ${exception.message}`);
-  }
-};
-
-const runInitialBuild = async (buildSettings = {}) => {
-  try {
-    process.loader.text('Building app...');
-
-    const filesToBuild = getFilesToBuild(buildSettings?.excludedPaths, "start");
-    const fileResults = await buildFiles({
-      files: filesToBuild,
-      environment: process.env.NODE_ENV
-    });
-
-    const hasErrors = [...fileResults]
-      .filter((result) => !!result)
-      .map(({ success }) => success)
-      .includes(false);
-
-    // NOTE: If the initial build fails, exit the startup process.
-    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}`);
-  }
-};
-
-const initProcess = (options = {}) => {
-  try {
-    process.title = options?.environment === 'test' ? "joystick_test" : 'joystick';
-    process.loader = new Loader({
-      defaultMessage: options?.environment === 'test' ? "Initializing test environment..." : "Starting app...",
-    });
-
-    process.env.LOGS_PATH = options?.logs || null;
-    process.env.NODE_ENV = options?.environment || "development";
-    process.env.PORT = options?.port ? parseInt(options?.port, 10) : 2600;
-    process.env.IS_DEBUG_MODE = options?.debug;
-
-  } catch (exception) {
-    throw new Error(`[dev.initProcess] ${exception.message}`);
-  }
-};
-
-const checkForRequiredFiles = () => {
-  try {
-    const missingFiles = [];
-
-    for (let i = 0; i < requiredFiles?.length; i += 1) {
-      const requiredFile = requiredFiles[i];
-      const exists = fs.existsSync(`${process.cwd()}/${requiredFile.path}`);
-      const stats = exists && fs.statSync(`${process.cwd()}/${requiredFile.path}`);
-
-      if (requiredFile && requiredFile.type === "file" && (!exists || (exists && !stats.isFile()))) {
-        missingFiles.push({ type: 'file', path: requiredFile.path });
-      }
-
-      if (requiredFile && requiredFile.type === "directory" && (!exists || (exists && !stats.isDirectory()))) {
-        missingFiles.push({ type: 'directory', path: requiredFile.path });
-      }
-    }
-
-    if (missingFiles?.length > 0) {
-      const files = missingFiles?.filter((path) => path.type === 'file');
-      const directories = missingFiles?.filter((path) => path.type === 'directory');
-
-      let error = `The following paths are missing and required in a Joystick project:\n\n`;
-
-      if (files?.length > 0) {
-        error += `  > Required Files:\n\n`;
-
-        for (let i = 0; i < files?.length; i += 1) {
-          const file = files[i];
-          error += `  /${file.path}\n`;
-        }
-      }
-
-      if (directories?.length > 0) {
-        error += `  > Required Directories:\n\n`;
-
-        for (let i = 0; i < directories?.length; i += 1) {
-          const file = directories[i];
-          error += `  /${file.path}\n`;
-        }
-      }
-
-      CLILog(error, {
-        level: "danger",
-        docs: "https://cheatcode.co/docs/joystick/structure",
-      });
-
-      process.exit(0);
-    }
-  } catch (exception) {
-    throw new Error(`[dev.checkForRequiredFiles] ${exception.message}`);
-  }
-};
-
-const warnInvalidJoystickEnvironment = () => {
-  try {
-    const hasJoystickFolder = fs.existsSync(`${process.cwd()}/.joystick`);
-    const hasTestsFolder = fs.existsSync(`${process.cwd()}/tests`);
-
-    if (process.env.NODE_ENV === 'test' && (!hasJoystickFolder || !hasTestsFolder)) {
-      CLILog(
-        "joystick test must be run in a directory with a .joystick folder and tests folder.",
-        {
-          level: "danger",
-          docs: "https://cheatcode.co/docs/joystick/cli/test",
-        }
-      );
-
-      process.exit(0);
-    }
-
-    if (process.env.NODE_ENV !== 'test' && !hasJoystickFolder) {
-      CLILog(
-        "joystick start must be run in a directory with a .joystick folder.",
-        {
-          level: "danger",
-          docs: "https://cheatcode.co/docs/joystick/cli/start",
-        }
-      );
-
-      process.exit(0);
-    }
-  } catch (exception) {
-    throw new Error(`[dev.warnInvalidJoystickEnvironment] ${exception.message}`);
-  }
-};
-
-const validateOptions = (options) => {
-  try {
-    if (!options) throw new Error('options object is required.');
-    if (!options.environment) throw new Error('options.environment is required.');
-  } catch (exception) {
-    throw new Error(`[dev.validateOptions] ${exception.message}`);
-  }
-};
-
-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,
-      port: options.port,
-      settings: settings.parsed
-    });
-
-    await runInitialBuild(settings?.parsed?.config?.build);
-    await startFileWatcher(options);
-
-    const serverProcess = await startApp({
-      nodeMajorVersion,
-      port: options?.port,
-    });
-
-    if (serverProcess) {
-      process.serverProcess = serverProcess;
-      handleServerProcessSTDIO();
-      handleServerProcessMessages();
-    }
-
-    // NOTE: Scope this out here so we can reference the processId below.
-    let hmrProcess;
-
-    if (options?.environment !== 'test') {
-      hmrProcess = await startHMR({
-        nodeMajorVersion,
-        __dirname,
-      });
-    }
-
-    handleSignalEvents(
-      [serverProcess.pid, hmrProcess.pid],
-      nodeMajorVersion,
-      __dirname
-    );
-//
-//    if (options?.environment === 'test') {
-//      await runTests(options);
-//      await cleanup();
-//    }
-
-    /*
-      TODO:
-    
-      - [x] Make sure we're in a Joystick project.
-      - [x] If environment === 'test', check that both a .joystick fo lder exists AND a /tests folder
-            exists. If no /tests, log out docs on how to scaffold your tests.
-      - [x] Load settings.<environment>.json.
-      - [x] Start databases relative to options.environment (development|test) from settings.<environment>.json.
-      - [x] Run the initial build
-      - [x] Start the file watcher
-      - [ ] Start the app as normal from the build directory.
-      - [ ] If environment === 'test', run the tests.
-      - [ ] If environment === 'test', after tests, run process.exit(0).
-    */
-    
-    resolve();
-  } catch (exception) {
-    console.warn(exception);
-    reject(`[dev] ${exception.message}`);
-  }
-};
-
-export default (options) =>
-  new Promise((resolve, reject) => {
-    dev(options, { resolve, reject });
-  });
-	

package/src/lib/dev/isWindows.js

@@ -1,3 +0,0 @@
-import os from "os";
-
-export default os.platform() === "win32";