@elliemae/ds-monorepo-devops 3.50.1-next.9 → 3.51.0-next.0

package/bin/cli.mjs

@@ -0,0 +1,20 @@
+import arg from 'arg';
+import { checkCommandOrInquire, executeCommandsMap } from './execute-commands-map.mjs';
+
+function parseArgumentsIntoOptions(rawArgs) {
+  const args = arg(
+    {},
+    {
+      argv: rawArgs.slice(2),
+    },
+  );
+  return {
+    command: args._[0],
+  };
+}
+
+export async function cli(args) {
+  let options = parseArgumentsIntoOptions(args);
+  options = await checkCommandOrInquire(options);
+  executeCommandsMap(args, options);
+}

package/bin/ds-monorepo-devops.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { cli } from './cli.mjs';
+
+cli(process.argv);

package/bin/execSyncNxTags/index.mjs

@@ -0,0 +1,104 @@
+/* eslint-disable complexity, no-console, max-statements */
+import inquirer from 'inquirer';
+import defGlob from 'glob';
+import path from 'node:path';
+import fs from 'node:fs';
+const { glob } = defGlob;
+
+export async function promptForCommandOptions(options) {
+  const questions = [];
+  if (!options.hello) {
+    questions.push({
+      type: 'list',
+      name: 'dryRun',
+      message: 'dry-run?',
+      default: 'n',
+      choices: ['y', 'n'],
+    });
+  }
+  const answers = await inquirer.prompt(questions);
+
+  return {
+    ...answers,
+  };
+}
+
+/**
+ * check all subfolders under cwd + packages/ for a package.json file
+ * - if it exists, check for project.json file in the same folder
+ *    - if it doesn't exist, continue to the next folder
+ *    - if both exist, check the "tags" array in the project.json file to
+ *      - package.json `typesafety`
+ *        - true
+ *          - tag ensure "strict-eslint" exists in the tags array
+ *        - false
+ *          - tag remove "strict-eslint" from the tags array if it exists
+ *    - `"status:eol"`
+ *        - yes
+ *          - remove the taxonomy tag from the tags array
+ *        - no
+ *          - add the taxonomy tag to the tags array if it doesn't exist or prompt the user to add it(in dry-run mode)
+ *          (E.G. packages/layout/... -> "layout", packages/atom/... -> "atom")
+ * - if it doesn't exist, continue to the next folder
+ * @param options
+ * @param {string} [options.dryRun='n'] - Indicates whether to perform a dry run ('y' or 'n').
+ * @returns {Promise<void>}
+ */
+const fixMissingTags = async (options) => {
+  const { dryRun } = options;
+  const globPatternPackage = 'packages/**/*/package.json';
+  const packageJsonFilesPaths = glob(globPatternPackage, { sync: true, ignore: ['**/node_modules/**', '**/dist/**'] });
+  for (let i = 0; i < packageJsonFilesPaths.length; i += 1) {
+    const packageJsonFilePath = packageJsonFilesPaths[i];
+    const finalPath = path.resolve(process.cwd(), packageJsonFilePath);
+    const packageJson = JSON.parse(fs.readFileSync(finalPath, 'utf8'));
+    const { publishConfig: { typeSafety = false } = {} } = packageJson;
+    const taxonomy = finalPath.split('/').reverse()[2];
+
+    const projectJsonFilePath = path.resolve(finalPath, '../project.json');
+    if (!fs.existsSync(projectJsonFilePath)) continue;
+    const projectJson = JSON.parse(fs.readFileSync(projectJsonFilePath, 'utf8'));
+    const missingTags = [];
+    const extraTags = [];
+
+    const isMarkedAsStrict = projectJson.tags.includes('strict-eslint');
+    if (typeSafety && !isMarkedAsStrict) missingTags.push('strict-eslint');
+    if (!typeSafety && isMarkedAsStrict) extraTags.push('strict-eslint');
+
+    const isEol = projectJson.tags.includes('status:eol');
+    const hasTaxonomy = projectJson.tags.includes(taxonomy);
+    if (!isEol && !hasTaxonomy) missingTags.push(taxonomy);
+    if (isEol && hasTaxonomy) extraTags.push(taxonomy);
+
+    const shouldRemoveTags = extraTags.length !== 0;
+    const shouldAddTags = missingTags.length !== 0;
+    const shouldDoNothing = !shouldAddTags && !shouldRemoveTags;
+    if (shouldDoNothing) continue;
+
+    // mutate projectJson.tags
+    if (shouldAddTags) {
+      projectJson.tags.push(...missingTags);
+    }
+    // mutate projectJson.tags
+    if (shouldRemoveTags) {
+      projectJson.tags = projectJson.tags.filter((tag) => !extraTags.includes(tag));
+    }
+
+    if (dryRun === 'n') {
+      projectJson.tags.sort();
+      fs.writeFileSync(projectJsonFilePath, JSON.stringify(projectJson, null, 2));
+      if (shouldAddTags) console.log(`Added ${missingTags.join(', ')} tag to ${projectJsonFilePath}`);
+      if (shouldRemoveTags) console.log(`Removed ${taxonomy} tag from ${projectJsonFilePath}`);
+      continue;
+    }
+    if (dryRun === 'y') {
+      if (shouldAddTags) console.log(`Would have added ${missingTags.join(', ')} to ${projectJsonFilePath}`);
+      if (shouldRemoveTags) console.log(`Would have removed ${taxonomy} from ${projectJsonFilePath}`);
+    }
+  }
+};
+
+export const execSyncNxTags = async (options) => {
+  const commandOptions = await promptForCommandOptions(options);
+  await fixMissingTags(commandOptions);
+};

package/bin/execute-commands-map.mjs

@@ -0,0 +1,33 @@
+import inquirer from 'inquirer';
+import { execSyncNxTags } from './execSyncNxTags/index.mjs';
+
+const COMMANDS = {
+  SYNC_NX_TAGS: 'sync-nx-tags',
+  EXIT: 'exit',
+};
+export const checkCommandOrInquire = async (options) => {
+  const questions = [];
+  if (!options.command) {
+    questions.push({
+      type: 'list',
+      name: 'command',
+      message: 'Please choose which command to run',
+      choices: Object.values(COMMANDS),
+    });
+  }
+  const answers = await inquirer.prompt(questions);
+  return {
+    ...options,
+    ...answers,
+  };
+};
+
+export async function executeCommandsMap(args, options) {
+  switch (options.command) {
+    case COMMANDS.SYNC_NX_TAGS:
+      execSyncNxTags(options);
+      break;
+    default:
+      break;
+  }
+}

package/configs/jest.config.mjs

@@ -1,14 +1,70 @@
 import { jestConfig } from '@elliemae/pui-cli';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url); // get the resolved path to the file
+const __dirname = path.dirname(__filename); // get the name of the directory
+const getFileFromCurrentFolder = (fileName) => path.normalize(path.resolve(__dirname, fileName));
+/**
+ * Generates an array of setup files for Jest based on provided flags.
+ *
+ * @param {Object} options - The options object.
+ * @param {boolean} [options.silenceConsole=false] - Flag to determine if console output should be silenced.
+ * @returns {string[]} An array of setup files for Jest.
+ */
+const getSetupFilesAfterEnvBasedOnFlags = ({ silenceConsole = false }) => {
+  const setupFilesAfterEnv = [];
 
-export const config = (specificFile = undefined, specialRules = {}) => ({
-  ...jestConfig,
-  collectCoverage: false,
-  collectCoverageFrom: [],
-  coverageDirectory: undefined,
-  coverageReporters: undefined,
-  ...specialRules,
-  // testRegex: 'tests/.*\\.test\\.[jt]sx?$',
-  testRegex: specificFile ? `.*/tests/${specificFile}$` : 'tests/.*\\.test\\.[jt]sx?$',
-  testTimeout: 120000,
-});
+  if (silenceConsole) {
+    setupFilesAfterEnv.push(getFileFromCurrentFolder('noConsoleMode.mjs'));
+  }
+
+  return setupFilesAfterEnv;
+};
+
+/**
+ * Generates a Jest configuration object.
+ *
+ * @param {Object} options - Configuration options.
+ * @param {string} [options.relativePathAfterTestsFolder] - Relative path after the tests folder to match test files.
+ * @param {Object} [options.firstLevelSpread] - Configuration options to override defaults.
+ * @param {Object} options.flags - Flags for configuration.
+ * @param {boolean} [options.flags.silenceConsole=false] - Flag to silence the console during tests.
+ * @returns {import('jest').Config} Jest configuration object.
+ *
+ * @example
+ * config({
+ *   // matches tests/GlobalHeader.keyboard.test.js
+ *   relativePathAfterTestsFolder: 'GlobalHeader.keyboard.test.js',
+ *   // overrides the default configuration for jest config 'verbose' to true
+ *   firstLevelSpread: { verbose: true },
+ *   // silences the console during tests via custom setup file
+ *   flags: { silenceConsole: true }
+ * });
+ *
+ * @example
+ * // matches tests/GlobalHeader/a11y/test.keys.js
+ * config({
+ *   relativePathAfterTestsFolder: 'GlobalHeader/a11y/test.keys.js',
+ *   flags: { silenceConsole: true }
+ * });
+ */
+export const config = ({ relativePathAfterTestsFolder = undefined, firstLevelSpread = {}, flags = {} } = {}) => {
+  const silenceConsole = flags.silenceConsole ?? process.env.JEST_FORCE_SILENT_CONSOLE ?? false;
+
+  /** @type {import('jest').Config} */
+  return {
+    ...jestConfig,
+    collectCoverage: false,
+    collectCoverageFrom: [],
+    coverageDirectory: undefined,
+    coverageReporters: undefined,
+    // testRegex: 'tests/.*\\.test\\.[jt]sx?$',
+    testRegex: relativePathAfterTestsFolder
+      ? `.*/tests/${relativePathAfterTestsFolder}$`
+      : 'tests/.*\\.test\\.[jt]sx?$',
+    testTimeout: 120000,
+    setupFilesAfterEnv: [...jestConfig.setupFilesAfterEnv, ...getSetupFilesAfterEnvBasedOnFlags({ silenceConsole })],
+    ...firstLevelSpread,
+  };
+};
 export default config;

package/configs/noConsoleMode.mjs

@@ -0,0 +1 @@
+global.console = { jestLog: console.log, error: jest.fn(), warn: jest.fn(), log: jest.fn() };

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@elliemae/ds-monorepo-devops",
-  "version": "3.50.1-next.9",
+  "version": "3.51.0-next.0",
   "license": "MIT",
   "description": "ICE MT - Dimsum - Monorepo Devops",
+  "type": "module",
   "files": [
+    "bin",
     "configs"
   ],
+  "bin": {
+    "@elliemae/ds-monorepo-devops": "./bin/ds-monorepo-devops.mjs",
+    "ds-monorepo-devops": "./bin/ds-monorepo-devops.mjs"
+  },
   "exports": {
     "./configs/jest.config": {
       "import": "./configs/jest.config.mjs",
@@ -29,7 +35,11 @@
     "indent": 4
   },
   "peerDependencies": {
-    "@elliemae/pui-cli": "9.0.0-next.31",
+    "@elliemae/pui-cli": "9.0.0-next.50",
+    "arg": "~5.0.2",
+    "glob": "~10.2.5",
+    "ignore": "^5.3.0",
+    "inquirer": "~12.0.0",
     "jest": "~29.7.0"
   },
   "publishConfig": {