lucy-cli 0.8.2 → 0.9.0

package/src/helpers.ts

@@ -1,15 +1,14 @@
 import chalk from 'chalk';
-import { join } from 'path';
 import { simpleGit } from 'simple-git';
-import fs from 'fs/promises';
 import { spawnSync } from 'child_process';
 // https://www.sergevandenoever.nl/run-gulp4-tasks-programatically-from-node/
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { ModuleSettings, ProjectSettings } from '.';
 import { exec } from 'child_process';
+import os from 'os';
 
-import { blue, green, orange, red } from './index.js';
+import { blue, green, orange, red, yellow, magenta } from './index.js';
 
 export async function installPackages(wixPackages: Record<string, string>, devPackages: Record<string, string>,  cwd: string, locked: boolean ) {
 	if (locked) console.log("🐕" + blue.underline(` => Installing & version locked packages!`));
@@ -83,19 +82,84 @@ export async function runGulp(moduleSettings: ModuleSettings, projectSettings: P
 /**
  * Clean up and run a command before exiting the process.
  */
-export function handleExit() {
+export function cleanupWatchers() {
+    console.log(`🧹 ${magenta.underline('Cleaning up Watchman watchers...')}`);
     const cwd = process.cwd();
-    const command = `watchman watch-del '${cwd}'`;
-
-	console.log("🐕" + blue.underline(' => Cleaning up...'));
+    const command = `watchman watch-del "${cwd}"`; // Adjust for Windows paths
     exec(command, (error, stdout, stderr) => {
         if (error) {
-            console.error(`💩 Failed to run cleanup: ${error.message}`);
+            console.error(`💩 ${red.underline('Failed to run cleanup:')} ${orange(error.message)}`);
             return;
         }
         if (stderr) {
-            console.error(`⚠️  Watchman stderr: ${stderr}`);
+            console.error(`⚠️ ${yellow.underline('Watchman stderr:')} ${stderr}`);
         }
-        console.log(`✅ Watchman cleanup success: ${stdout}`);
+        console.log(`✅ ${green.underline('Watchman cleanup success:')} ${stdout}`);
     });
 }
+
+/**
+ * Kill all processes matching a specific substring in their command, with a fallback for Windows.
+ * @param {string} processPattern - The substring to match (e.g., "wix:dev" or "@wix/cli/bin/wix.cjs").
+ */
+export function killAllProcesses(processPattern: string) {
+    const isWindows = os.platform() === 'win32';
+    const command = isWindows
+        ? `tasklist /FI "IMAGENAME eq node.exe" /FO CSV | findstr "${processPattern}"` // Adjust for Node.js processes
+        : `ps -eo pid,command | grep "${processPattern}" | grep -v grep`;
+
+    exec(command, (error, stdout, stderr) => {
+        if (error) {
+            console.error(`💩 ${red.underline('Failed to find processes:')} ${orange(error.message)}`);
+            return;
+        }
+        if (stderr) {
+            console.error(`⚠️ ${yellow.underline('Error output:')} ${stderr}`);
+        }
+        if (!stdout.trim()) {
+            console.log(`ℹ️ ${blue.underline(`No processes found matching pattern:`)} ${orange(processPattern)}`);
+            return;
+        }
+
+        console.log(`📝 ${magenta.underline('Found matching processes:')}\n${stdout}`);
+        const lines = stdout.trim().split('\n');
+        const pids = isWindows
+            ? lines.map(line => line.match(/"(\d+)"/)?.[1]) // Extract PID from Windows tasklist output
+            : lines.map(line => line.trim().split(/\s+/)[0]).filter(pid => !isNaN(Number(pid)));
+
+        pids.forEach(pid => {
+            if (!pid) return;
+            try {
+                const killCommand = isWindows
+                    ? `taskkill /PID ${pid} /T /F` // Forcefully terminate the process on Windows
+                    : `kill -SIGTERM ${pid}`;
+                
+                exec(killCommand, (killError) => {
+                    if (killError) {
+                        console.error(`⚠️ ${yellow.underline('Failed to kill process with PID')} ${orange(pid)}: ${red(killError.message)}`);
+                    } else {
+                        console.log(`✅ ${green.underline('Killed process with PID:')} ${orange(pid)}`);
+                    }
+                });
+
+                // Schedule SIGKILL fallback for non-Windows platforms
+                if (!isWindows) {
+                    setTimeout(() => {
+                        try {
+                            process.kill(parseInt(pid, 10), 'SIGKILL');
+                            console.log(`🔪 ${red.underline('Sent SIGKILL to process with PID:')} ${orange(pid)} (fallback).`);
+                        } catch (killError: any) {
+                            if (killError.code === 'ESRCH') {
+                                console.log(`✅ ${green.underline('Process with PID')} ${orange(pid)} ${green.underline('already terminated.')}`);
+                            } else {
+                                console.error(`⚠️ ${yellow.underline('Failed to send SIGKILL to process with PID')} ${orange(pid)}: ${red(killError.message)}`);
+                            }
+                        }
+                    }, 10000);
+                }
+            } catch (err: any) {
+                console.error(`⚠️ ${yellow.underline('Failed to kill process with PID')} ${orange(pid)}: ${red(err.message)}`);
+            }
+        });
+    });
+}

package/src/index.ts

@@ -11,8 +11,9 @@ import fs from 'fs/promises';
 
 import { init } from './init.js';
 import { sync } from './sync.js';
-import { runGulp, installPackages, handleExit } from './helpers.js';
+import { runGulp, installPackages, killAllProcesses, cleanupWatchers } from './helpers.js';
 import { prepare } from './prepare.js';
+import { spawnSync } from 'child_process';
 
 export type LucySettings = {
 	modules: {
@@ -70,10 +71,50 @@ const __filename = fileURLToPath(import.meta.url);
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const __dirname = dirname(__filename);
 
+// const cwd = process.cwd();
+// const command = `watchman watch-del '${cwd}'`;
+// killAllProcesses('@wix/cli/bin/wix.cjs'); // Matches processes running the Wix CLI
+// killAllProcesses('wix:dev');   
+
+
+process.on('exit', (code) => {
+	killAllProcesses('@wix/cli/bin/wix.cjs'); // Matches processes running the Wix CLI
+	killAllProcesses('wix:dev');   
+    cleanupWatchers();
+	console.log(`🚪 ${magenta.underline('Process exiting with code:')} ${orange(code)}`);
+});
+
 process.on('SIGINT', () => {
-    console.log("🐕 Received Ctrl+C, cleaning up...");
-    handleExit();
-    process.exit(); // Exit the process explicitly
+	console.log(`🐕 ${green.underline('Received Ctrl+C (SIGINT), cleaning up...')}`);
+	killAllProcesses('@wix/cli/bin/wix.cjs'); // Matches processes running the Wix CLI
+	killAllProcesses('wix:dev');  
+    cleanupWatchers();
+    process.exit(); // Exit explicitly after handling
+});
+
+process.on('SIGTERM', () => {
+	console.log(`🛑 ${red.underline('Received termination signal (SIGTERM), cleaning up...')}`);
+	killAllProcesses('@wix/cli/bin/wix.cjs'); // Matches processes running the Wix CLI
+	killAllProcesses('wix:dev');  
+    cleanupWatchers();
+    process.exit(); // Exit explicitly after handling
+});
+
+process.on('uncaughtException', (error) => {
+	console.error(`💥 ${red.underline('Uncaught Exception:')}`, error);
+	killAllProcesses('@wix/cli/bin/wix.cjs'); // Matches processes running the Wix CLI
+	killAllProcesses('wix:dev');  
+    cleanupWatchers();
+    process.exit(1); // Exit with an error code
+});
+
+process.on('unhandledRejection', (reason, promise) => {
+	console.error(`🚨 ${yellow.underline('Unhandled Rejection at:')} ${orange(promise)}`);
+	console.error(`🚨 ${red.underline('Reason:')} ${reason}`);    cleanupWatchers();
+	killAllProcesses('@wix/cli/bin/wix.cjs'); // Matches processes running the Wix CLI
+	killAllProcesses('wix:dev');  
+    cleanupWatchers();
+    process.exit(1); // Exit with an error code
 });
 
 /**
@@ -113,6 +154,7 @@ async function main(): Promise<void> {
 		console.log("🦮 " + magenta.bold('sync') + "               : Synchronizes the database (not Implemented)");
 		console.log("🦮 " + magenta.bold('install') + "            : Installs all Wix npm packages listed in the 'lucy.json' file in the project directory.");
 		console.log("🦮 " + magenta.bold('fix') + "                : Runs a fix command to resolve common issues in development or production settings.");
+		console.log("🦮 " + magenta.bold('docs') + "               : Generates documentation for the project.");
 		console.log("\nOptions:");
 		console.log("🦮 " + magenta.bold('-h, help') + "           : Displays this help message.");
 		console.log("🦮 " + magenta.bold('-v, version') + "        : Displays the current version of Lucy CLI as defined in the project’s package.json.");
@@ -189,6 +231,14 @@ async function main(): Promise<void> {
 	}
 
 
+	if(moduleSettings.args.includes('docs')){
+		const res = spawnSync('yarn docs', { shell: true, stdio: 'inherit' });
+		if (res.error) {
+			return console.log((`💩 ${red.underline.bold("=> Failed to install dev packages =>")} ${orange(res.error.message)}`));
+		}
+		return console.log("🐕" + blue.underline(` => Docs generated!`));
+	}
+
 	if(moduleSettings.args.includes('prepare')){
 		await prepare( moduleSettings, projectSettings);
 

package/src/settings.json

@@ -12,33 +12,39 @@
   "initialized": false,
   "wixPackages": {},
   "devPackages": {
-    "@wix/cli": "latest",
+    "@eslint/js": "^9.15.0",
     "@styled/typescript-styled-plugin": "^1.0.1",
-    "@total-typescript/ts-reset": "0.6.1",
-    "@types/jest": "^29.5.3",
-    "@types/node": "22.9.0",
-    "@types/react": "^18.2.21",
-    "@typescript-eslint/parser": "8.14.0",
-    "@typescript-eslint/utils": "8.14.0",
-    "@wix/eslint-plugin-cli": "latest",
-    "cypress": "13.15.2",
-    "cypress-cloud": "^1.9.3",
-    "esbuild": "0.24.0",
-    "eslint": "9.14.0",
-    "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-jsdoc": "50.5.0",
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.9.1",
+    "@types/nodemailer": "^6.4.17",
+    "@types/react": "^18.3.12",
+    "@typescript-eslint/eslint-plugin": "^8.15.0",
+    "@typescript-eslint/parser": "^8.15.0",
+    "@typescript-eslint/utils": "^8.15.0",
+    "@wix/cli": "^1.1.52",
+    "@wix/eslint-plugin-cli": "^1.0.2",
+    "cypress": "^13.16.0",
+    "cypress-cloud": "^1.11.0",
+    "esbuild": "^0.24.0",
+    "eslint": "^9.15.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsdoc": "^50.5.0",
     "eslint-plugin-named-import-spacing": "^1.0.3",
-    "eslint-plugin-neverthrow": "^1.1.4",
-    "eslint-plugin-simple-import-sort": "12.1.1",
-    "jest": "^29.6.1",
-    "prettier": "^3.0.3",
-    "sass": "^1.65.1",
-    "ts-jest": "^29.1.1",
-    "ts-node": "^10.9.1",
-    "tsx": "4.19.2",
-    "typedoc": "0.26.11",
-    "typedoc-theme-hierarchy": "5.0.3",
-    "typescript": "^5.1.6",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "jest": "^29.7.0",
+    "prettier": "^3.3.3",
+    "react": "^18.3.1",
+    "sass": "^1.81.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.19.2",
+    "typedoc": "^0.26.11",
+    "typedoc-plugin-merge-modules": "^6.0.3",
+    "typedoc-plugin-zod": "^1.3.0",
+    "typedoc-theme-hierarchy": "^5.0.3",
+    "typescript": "5.6.3",
+    "typescript-eslint": "^8.15.0",
     "typescript-eslint-language-service": "^5.0.5"
   },
   "scripts": {

package/src/types.d.ts

@@ -4,4 +4,5 @@ declare module 'gulp-foreach';
 declare module 'gulp-string-replace';
 declare module 'gulp-wait';
 declare module 'gulp-jest';
-declare module 'gulp-flatmap';
+declare module 'gulp-flatmap';
+declare module 'gulp-swc';

package/files/.eslintrc.cjs

@@ -1,108 +0,0 @@
-module.exports = {
-	extends: ['eslint:recommended', 'plugin:import/recommended', 'plugin:jsdoc/recommended', 'plugin:@typescript-eslint/recommended', 'plugin:@wix/cli/recommended'],
-	plugins: ['simple-import-sort', 'eslint-plugin-named-import-spacing', '@typescript-eslint'],
-	parser: '@typescript-eslint/parser',
-	parserOptions: {
-		ecmaVersion: 2021,
-	},		
-	ignorePatterns: ['src/**/*', 'typescript/types/backend/**/*', 'typescript/types/pages/**/*', 'typescript/types/public/**/*', 'typescript/types/node/**/*', '.wix/**/*', 'coverage/**/*', 'docs/**/*'],
-	rules: {
-		'no-static-block': 'error',
-		quotes: [2, 'single', { 'avoidEscape': true, 'allowTemplateLiterals': true }],
-		curly: ['error', 'multi-line'],
-		'simple-import-sort/imports': 'error',
-		'simple-import-sort/exports': 'error',
-		indent: ['error', 'tab'],
-		'no-tabs': 0,
-		'semi-style': ['error', 'last'],
-		semi: [2, 'always'],
-		'object-curly-spacing': ['error', 'always'],
-		'space-in-parens': ['error', 'never'],
-		'newline-before-return': 'error',
-		'space-before-blocks': ['error', { functions: 'always', keywords: 'never', classes: 'always' }],
-		'comma-spacing': ['error', { before: false, after: true }],
-		'no-multi-spaces': ['error'],
-		'import/newline-after-import': ['error', { count: 1 }],
-		'named-import-spacing/named-import-spacing': 2,
-		'no-unused-vars': 'warn',
-		'import/no-unresolved': [0],
-		'no-forbidden-relative-imports': [0],
-		'@typescript-eslint/triple-slash-reference': 'off',
-		'@typescript-eslint/member-ordering': [
-			'error',
-			{ classes: ['constructor', 'private-instance-field', 'protected-instance-field', 'public-instance-field', 'public-instance-method', 'private-instance-method'] }
-		],
-		'@typescript-eslint/naming-convention': [
-			'error',
-			{
-				selector: ['variable', 'function'],
-				format: ['camelCase'],
-				leadingUnderscore: 'allow'
-			},
-			{
-				selector: ['objectLiteralProperty'],
-				format: null,
-				leadingUnderscore: 'allow'
-			},
-			{
-				selector: 'memberLike',
-				modifiers: ['private'],
-				format: ['camelCase'],
-				leadingUnderscore: 'require'
-			},
-			{
-				selector: 'memberLike',
-				modifiers: ['protected'],
-				format: ['camelCase'],
-				leadingUnderscore: 'require'
-			},
-			{
-				selector: 'memberLike',
-				modifiers: ['public'],
-				format: ['camelCase'],
-				leadingUnderscore: 'forbid'
-			},
-			{
-				selector: ['parameterProperty', 'parameter'],
-				format: ['camelCase'],
-				leadingUnderscore: 'forbid'
-			},
-			{
-				selector: 'default',
-				format: ['UPPER_CASE'],
-				leadingUnderscore: 'forbid',
-				trailingUnderscore: 'forbid',
-				custom: {
-					regex: '^[A-Z_]+$',
-					match: true
-				}
-			},
-			{
-				selector: 'typeLike',
-				format: ['PascalCase']
-			},
-			// Custom rule added
-			{
-				selector: 'function',
-				format: ['UPPER_CASE']
-			}
-		],
-	},
-    overrides: [
-        {
-            files: ['**/*.tsx', '**/*.ts'],
-            rules: {
-                'no-static-block': 'error'
-            }
-        }
-    ],
-	root: true,
-	env: {
-		es6: true,
-		browser: true,
-		node: true
-	},
-	globals: {
-		$w: 'readonly'
-	}
-};