evophp 1.0.30 → 1.1.0

package/bin/evophp.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+const yargs = require("yargs/yargs")(process.argv.slice(2));
+const { hideBin } = require("yargs/helpers");
+
+yargs(hideBin(process.argv))
+  .command(require("../commands/new"))
+  .command(require("../commands/init"))
+  .command(require("../commands/uninstall"))
+  .command(require("../commands/dependencies"))
+  .command(require("../commands/help"))
+  .demandCommand(1, "Please specify a valid command. Use --help to see available commands.")
+  .help()
+  .argv;
+

package/commands/dependencies.js

@@ -0,0 +1,80 @@
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const { readLineAsync } = require("../utils/helpers");
+const log = require("../utils/logger");
+
+module.exports = {
+  command: "install-dependencies <plugin> [--dev|--composer]",
+  aliases: ["d"],
+  describe: "Add and install plugin or theme dependencies",
+
+  builder: yargs =>
+    yargs
+      .positional("plugin", { describe: "Plugin or theme name", type: "string" })
+      .option("dev", { describe: "Install as dev dependency (JS)", type: "boolean" })
+      .option("composer", { describe: "Use composer for PHP", type: "boolean" }),
+
+  handler: async ({ plugin, dev, composer }) => {
+    try {
+      const depType = dev ? "dev" : "prod";
+
+      const isPHP = !!composer;
+      const baseDir = isPHP
+        ? path.join("Public", "Modules", plugin)
+        : path.join("EvoJsDev", "Modules", plugin);
+
+      if (!fs.existsSync(baseDir)) {
+        log.error(`Plugin not found at ${baseDir}`);
+        process.exit(1);
+      }
+
+      const dependenciesFile = path.join(baseDir, "dependencies.json");
+      let dependencies = fs.existsSync(dependenciesFile)
+        ? JSON.parse(fs.readFileSync(dependenciesFile, "utf-8"))
+        : {};
+
+      log.info(`Existing ${isPHP ? "PHP" : "JS"} dependencies:`);
+      log.info("Production:", dependencies.prod || "None");
+      if (!isPHP) log.info("Development:", dependencies.dev || "None");
+
+      const additionalDeps = await readLineAsync(
+        `Enter additional ${depType} dependencies (space separated): `
+      );
+      const newDeps = additionalDeps
+        .split(" ")
+        .map(dep => dep.trim())
+        .filter(Boolean);
+
+      if (newDeps.length === 0) {
+        log.warn("No dependencies provided.");
+        return;
+      }
+
+      // Merge and deduplicate
+      const depField = isPHP || depType === "prod" ? "prod" : "dev";
+      dependencies[depField] = (
+        (dependencies[depField] || "") + " " + newDeps.join(" ")
+      )
+        .trim()
+        .split(" ")
+        .filter((value, i, arr) => arr.indexOf(value) === i)
+        .join(" ");
+
+      fs.writeFileSync(dependenciesFile, JSON.stringify(dependencies, null, 2));
+      log.success("Updated dependencies.json");
+
+      // Install
+      const installCmd = isPHP
+        ? `composer require ${newDeps.join(" ")}`
+        : `npm install ${newDeps.join(" ")} ${dev ? "--save-dev" : "--save"}`;
+
+      log.info("Installing dependencies...");
+      execSync(installCmd, { stdio: "inherit" });
+      log.success("Installation complete.");
+    } catch (err) {
+      log.error("Error installing dependencies: " + err.message);
+      process.exit(1);
+    }
+  }
+};

package/commands/help.js

@@ -0,0 +1,70 @@
+module.exports = {
+  command: "help",
+  aliases: ["h"],
+  describe: "Show all available EvoPHP CLI commands",
+
+  handler: () => {
+    console.log(`
+==========================================
+        EvoPHP CLI - Help Guide
+==========================================
+
+Initialization:
+  evophp init [project-name]         
+      → Initialize a new Evolution PHP project.
+      → Aliases: none
+      → Example: evophp init my-project
+
+Plugin/Theme Creation:
+  evophp new plugin <author>/<name>  
+  evophp n plugin <author>/<name>    
+      → Create a new plugin from template.
+      → Aliases: new → n
+      → Example: evophp n plugin johndoe/exampleplugin
+
+  evophp new theme <author>/<name>   
+  evophp n theme <author>/<name>     
+      → Create a new theme from template.
+
+Plugin/Theme Installation:
+  evophp install plugin <author>/<name>  
+  evophp i plugin <author>/<name>        
+      → Install a plugin from GitHub.
+      → Aliases: install → i
+
+  evophp install theme <author>/<name>   
+  evophp i theme <author>/<name>         
+      → Install a theme from GitHub.
+
+Plugin/Theme Uninstallation:
+  evophp uninstall plugin <name>     
+  evophp u plugin <name>             
+      → Remove installed plugin.
+      → Aliases: uninstall → u
+
+  evophp uninstall theme <name>      
+  evophp u theme <name>              
+      → Remove installed theme.
+
+Dependency Management:
+  evophp install-dependencies <plugin>
+  evophp d <plugin> [--dev|--composer]
+      → Add and install dependencies.
+      → JS dev: --dev
+      → PHP: --composer
+      → Aliases: install-dependencies → d
+
+General:
+  evophp help
+  evophp h
+      → Show this help guide.
+      → Aliases: help → h
+
+==========================================
+  Tip: Use --help after any command
+       for command-specific usage.
+==========================================
+    `);
+    process.exit(0);
+  }
+};

package/commands/init.js

@@ -0,0 +1,57 @@
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const { readLineAsync } = require("../utils/helpers");
+const log = require("../utils/logger");
+
+module.exports = {
+  command: "init [name]",
+  describe: "Initialize a new EvoPHP project",
+
+  builder: yargs =>
+    yargs
+      .positional("name", {
+        describe: "Project folder name (optional)",
+        type: "string",
+        default: "",
+      }),
+
+  handler: async ({ name }) => {
+    try {
+      if (!name) {
+        name = await readLineAsync("Enter the name of the project: ");
+        if (!name.trim()) {
+          log.error("You must enter a valid project name.");
+          process.exit(1);
+        }
+      }
+
+      const repoUrl = "https://github.com/kinsokafor/evolution.git";
+      const projectPath = path.join(process.cwd(), name);
+
+      log.info(`Cloning Evolution repo to "${name}"...`);
+      execSync(`git clone ${repoUrl} ${name}`, { stdio: "inherit" });
+
+      process.chdir(projectPath);
+
+      log.info(`Running bootstrap script: node evolution ${name}`);
+      execSync(`node evolution ${name}`, { stdio: "inherit" });
+
+      if (fs.existsSync("composer.json")) {
+        log.info("Installing Composer dependencies...");
+        execSync("composer install", { stdio: "inherit" });
+      } else {
+        log.info("No composer.json found. Skipping Composer installation.");
+      }
+
+      log.info("Installing NPM dependencies...");
+      execSync("npm install", { stdio: "inherit" });
+
+      log.success("Project setup complete!");
+      log.info(`Navigate into your project:\n  cd ${name}`);
+    } catch (err) {
+      log.error("Project initialization failed: " + err.message);
+      process.exit(1);
+    }
+  }
+};

package/commands/install.js

@@ -0,0 +1,72 @@
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+const { readLineAsync, splitPluginName, mergeConfig } = require('../utils/helpers');
+const { cloneRepo } = require('../utils/git');
+const { installDependencies } = require('../utils/dependencies');
+const log = require('../utils/logger');
+
+module.exports = {
+  command: 'install [type] [name]',
+  aliases: ['i'],
+  describe: 'Install a plugin or theme',
+  builder: yargs => yargs
+    .positional('type', { describe: 'plugin or theme', type: 'string' })
+    .positional('name', { describe: 'author/plugin-name', type: 'string' }),
+
+  handler: async ({ type, name }) => {
+    try {
+      // Prompt if missing
+      if (!type || !['plugin', 'theme'].includes(type.toLowerCase())) {
+        type = await readLineAsync("What are you installing? (plugin/theme): ");
+        type = type.toLowerCase();
+        if (!['plugin', 'theme'].includes(type)) {
+          log.error("Invalid type.");
+          process.exit(1);
+        }
+      }
+
+      if (!name) {
+        name = await readLineAsync(`Enter the ${type} name (e.g., johndoe/example${type}): `);
+      }
+
+      const [author, itemName] = await splitPluginName(name);
+
+      const paths = type === 'plugin'
+        ? [path.join('Public', 'Modules', itemName), path.join('EvoJsDev', 'Modules', itemName)]
+        : [path.join('Public', 'Themes', itemName)];
+
+      // Check existing
+      for (const p of paths) {
+        if (fs.existsSync(p)) {
+          log.warn(`${type} "${itemName}" already exists at ${p}`);
+          process.exit(0);
+        }
+      }
+
+      log.info(`Installing ${type} "${itemName}" by ${author}...`);
+
+      if (type === 'plugin') {
+        await cloneRepo(`https://github.com/${author}/${itemName}.git`, paths[0]);
+        await cloneRepo(`https://github.com/${author}/${itemName}.js.git`, paths[1]);
+
+        const configFile = path.resolve(`./EvoJsDev/Modules/${itemName}/config.json`);
+        if (fs.existsSync(configFile)) {
+          const pluginConfig = require(configFile);
+          mergeConfig(pluginConfig);
+        }
+
+        await installDependencies(paths[1], 'js');
+        await installDependencies(paths[0], 'php');
+
+      } else if (type === 'theme') {
+        await cloneRepo(`https://github.com/${author}/${itemName}.git`, paths[0]);
+      }
+
+      log.success(`The ${type} "${itemName}" has been installed successfully.`);
+    } catch (err) {
+      log.error(`Install failed: ${err.message}`);
+      process.exit(1);
+    }
+  }
+};

package/commands/new.js

@@ -0,0 +1,110 @@
+const path = require("path");
+const fs = require("fs");
+const { readLineAsync, splitPluginName, mergeConfig } = require("../utils/helpers");
+const { getUserData, createGitHubRepo } = require("../utils/github");
+const { cloneRepository } = require("../utils/git");
+const { editFile, renameFile } = require("../utils/edit");
+const { test } = require("../utils/validate");
+const log = require("../utils/logger");
+require("dotenv").config({ path: "./.env.development" });
+
+module.exports = {
+  command: "new <type> <author>/<name>",
+  aliases: ["n"],
+  describe: "Create a new plugin or theme from template",
+  builder: yargs =>
+    yargs
+      .positional("type", { describe: "plugin or theme", type: "string" })
+      .positional("author/name", { describe: "GitHub format name", type: "string" }),
+
+  handler: async ({ type, name }) => {
+    try {
+      const gitHubToken = process.env.GITHUB_TOKEN || await readLineAsync("Enter GitHub PAT: ");
+      type = type.toLowerCase();
+
+      if (!["plugin", "theme"].includes(type)) {
+        log.error("Invalid type. Must be plugin or theme.");
+        process.exit(1);
+      }
+
+      const [author, pluginName] = await splitPluginName(name);
+      const userData = await getUserData(gitHubToken);
+      if (userData.login !== author) {
+        log.error(`Token belongs to ${userData.login}, expected ${author}`);
+        process.exit(1);
+      }
+
+      log.info(`Authenticated as ${userData.login}`);
+
+      if (type === "plugin") {
+        const entry = await setupPlugin(gitHubToken, author, pluginName);
+        log.success(`Plugin "${pluginName}" created with entry "${entry}"`);
+      } else {
+        await setupTheme(gitHubToken, author, pluginName);
+        log.success(`Theme "${pluginName}" created`);
+      }
+
+    } catch (err) {
+      log.error(`Creation failed: ${err.message}`);
+      process.exit(1);
+    }
+  }
+};
+
+async function setupPlugin(token, author, pluginName) {
+  const entry = await setupPluginRepo(token, author, pluginName);
+  const pluginPrefix = entry.replace("Main", "");
+
+  await editFile(`./Public/Modules/${pluginName}/Routes.php`, {
+    pluginName, entry, entryURI: entry.toLowerCase(), pluginPrefix
+  });
+
+  const controllerPath = `./Public/Modules/${pluginName}/Controller.php`;
+  if (fs.existsSync(controllerPath)) {
+    await editFile(controllerPath, { pluginName, pluginPrefix });
+    await renameFile(controllerPath, `./Public/Modules/${pluginName}/${pluginPrefix}Controller.php`);
+    await renameFile(`./Public/Modules/${pluginName}/Views/Entry`, `./Public/Modules/${pluginName}/Views/${entry}`);
+  }
+
+  return entry;
+}
+
+async function setupPluginRepo(token, author, pluginName) {
+  await createGitHubRepo(token, 'kinsokafor/EvoPlugin', pluginName);
+  await cloneRepository(author, pluginName, path.join('Public', 'Modules', pluginName));
+
+  await createGitHubRepo(token, 'kinsokafor/EvoPlugin.js', `${pluginName}.js`);
+  await cloneRepository(author, `${pluginName}.js`, path.join('EvoJsDev', 'Modules', pluginName));
+
+  const pluginPrefix = await getValidatedInput("Enter Plugin Prefix?", 3, true).then(x => x.toUpperCase());
+  const entryURI = await getValidatedInput("Entry URI?", 20).then(x => x.toLowerCase());
+  const entry = pluginPrefix + "Main";
+
+  await editFile(`./EvoJsDev/Modules/${pluginName}/config.json`, { pluginName, entry });
+  await renameFile(`./EvoJsDev/Modules/${pluginName}/Entry`, `./EvoJsDev/Modules/${pluginName}/${entry}`);
+
+  const configPath = `./EvoJsDev/Modules/${pluginName}/config.json`;
+  if (fs.existsSync(configPath)) {
+    const pluginConfig = require(path.resolve(configPath));
+    mergeConfig(pluginConfig);
+  }
+
+  return entry;
+}
+
+async function setupTheme(token, author, pluginName) {
+  await createGitHubRepo(token, 'kinsokafor/EvoTheme', pluginName);
+  await cloneRepository(author, pluginName, path.join('Public', 'Themes', pluginName));
+
+  await editFile(`./Public/Themes/${pluginName}/Data/index.data.php`, { pluginName });
+  await editFile(`./Public/Themes/${pluginName}/Data/login.data.php`, { pluginName });
+  await editFile(`./Public/Themes/${pluginName}/Views/index.blade.php`, { pluginName });
+  await editFile(`./Public/Themes/${pluginName}/Views/login.blade.php`, { pluginName });
+}
+
+async function getValidatedInput(label, maxLength, caps = false) {
+  let input = await readLineAsync(label);
+  while (!test(input, maxLength)) input = await readLineAsync(label);
+  input = input.trim().replaceAll(" ", "");
+  return caps ? input.toUpperCase() : input.toLowerCase();
+}

package/commands/uninstall.js

@@ -0,0 +1,81 @@
+const fs = require("fs");
+const path = require("path");
+const rimraf = require("rimraf");
+const editJsonFile = require("edit-json-file");
+const { readLineAsync } = require("../utils/helpers");
+const log = require("../utils/logger");
+
+module.exports = {
+  command: "uninstall [type] [name]",
+  aliases: ["u"],
+  describe: "Uninstall a plugin or theme",
+
+  builder: yargs =>
+    yargs
+      .positional("type", { describe: "plugin or theme", type: "string" })
+      .positional("name", { describe: "The plugin or theme name", type: "string" }),
+
+  handler: async ({ type, name }) => {
+    try {
+      // Prompt type if missing
+      if (!type || !["plugin", "theme"].includes(type.toLowerCase())) {
+        type = await readLineAsync("What are you uninstalling? (plugin/theme): ");
+        type = type.toLowerCase();
+        if (!["plugin", "theme"].includes(type)) {
+          log.error("Invalid type. Must be 'plugin' or 'theme'.");
+          process.exit(1);
+        }
+      }
+
+      // Prompt name if missing
+      if (!name) {
+        name = await readLineAsync(`Enter the ${type} name (e.g., example${type}): `);
+        if (!name) {
+          log.error("You must provide a name.");
+          process.exit(1);
+        }
+      }
+
+      const paths =
+        type === "plugin"
+          ? [path.join("Public", "Modules", name), path.join("EvoJsDev", "Modules", name)]
+          : [path.join("Public", "Themes", name)];
+
+      const existing = paths.filter(fs.existsSync);
+
+      if (existing.length === 0) {
+        log.warn(`No matching ${type} found for "${name}".`);
+        process.exit(0);
+      }
+
+      log.info(`Preparing to uninstall ${type} "${name}" from:`);
+      existing.forEach(p => log.info(" - " + p));
+
+      const confirm = await readLineAsync("Are you sure you want to proceed? (y/n): ");
+      if (!["y", "yes"].includes(confirm.trim().toLowerCase())) {
+        log.warn("Uninstallation cancelled.");
+        return;
+      }
+
+      for (const dir of existing) {
+        rimraf.sync(dir);
+        log.success(`Deleted: ${dir}`);
+      }
+
+      if (type === "plugin") {
+        const configPath = path.resolve("config.json");
+        if (fs.existsSync(configPath)) {
+          let file = editJsonFile(configPath);
+          file.unset(`modules.${name}`);
+          file.save();
+          log.success(`Removed '${name}' from config.json`);
+        }
+      }
+
+      log.success(`The ${type} "${name}" has been uninstalled successfully.`);
+    } catch (err) {
+      log.error("Error during uninstall: " + err.message);
+      process.exit(1);
+    }
+  }
+};

package/package.json

@@ -1,26 +1,33 @@
 {
   "name": "evophp",
-  "version": "1.0.30",
-  "description": "Installer for the Evolution PHP project",
-  "main": "installer.js",
-  "scripts": {
-    "start": "node installer.js"
-  },
+  "version": "1.1.0",
+  "description": "Command-line installer for the Evolution PHP framework",
   "bin": {
-    "evophp": "installer.js"
+    "evophp": "./bin/evophp.js"
+  },
+  "main": "bin/evophp.js",
+  "scripts": {
+    "start": "node bin/evophp.js"
   },
+  "files": [
+    "bin/",
+    "commands/",
+    "utils/"
+  ],
   "dependencies": {
     "axios": "^1.7.9",
     "dotenv": "^16.4.7",
     "edit-json-file": "^1.8.0",
-    "rimraf": "^6.0.1"
+    "rimraf": "^6.0.1",
+    "yargs": "^17.7.2"
   },
-  "files": [
-    "installer.js",
-    "new-plugin.js",
-    "install-plugin.js",
-    "install-dependencies.js",
-    "helpers.js",
-    "uninstall.js"
-  ]
-}
+  "keywords": [
+    "cli",
+    "evophp",
+    "installer",
+    "php-framework",
+    "evolution"
+  ],
+  "author": "Kingsley Okafor",
+  "license": "MIT"
+}

package/utils/config.js

@@ -0,0 +1,20 @@
+const fs = require('fs');
+const path = require('path');
+const configPath = path.join(require('os').homedir(), '.evophp-cli.json');
+
+function loadConfig() {
+  if (fs.existsSync(configPath)) {
+    return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+  }
+  return {};
+}
+
+function saveConfig(data) {
+  fs.writeFileSync(configPath, JSON.stringify(data, null, 2));
+}
+
+module.exports = {
+  loadConfig,
+  saveConfig,
+  configPath
+};

package/utils/dependencies.js

@@ -0,0 +1,33 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+const log = require('./logger');
+
+async function installDependencies(dir, type) {
+  const dependenciesFile = path.join(dir, 'dependencies.json');
+  if (!fs.existsSync(dependenciesFile)) {
+    log.info(`No ${type} dependencies.json found in ${dir}`);
+    return;
+  }
+
+  const deps = JSON.parse(fs.readFileSync(dependenciesFile, 'utf-8'));
+  const cwd = process.cwd();
+
+  if (type === 'js') {
+    if (deps.prod) {
+      log.info("Installing JS production dependencies...");
+      execSync(`npm install ${deps.prod}`, { cwd, stdio: 'inherit' });
+    }
+    if (deps.dev) {
+      log.info("Installing JS development dependencies...");
+      execSync(`npm install ${deps.dev} --save-dev`, { cwd, stdio: 'inherit' });
+    }
+  }
+
+  if (type === 'php' && deps.prod) {
+    log.info("Installing PHP dependencies...");
+    execSync(`composer require ${deps.prod}`, { cwd, stdio: 'inherit' });
+  }
+}
+
+module.exports = { installDependencies };

package/utils/edit.js

@@ -0,0 +1,42 @@
+const fs = require("fs");
+const path = require("path");
+const log = require("./logger");
+
+async function editFile(file, data) {
+  return new Promise((resolve, reject) => {
+    fs.readFile(file, "utf8", (err, fileData) => {
+      if (err) {
+        log.error(`Failed to read file ${file}`);
+        return reject(err);
+      }
+
+      for (const key in data) {
+        fileData = fileData.replaceAll(`<${key}>`, data[key]);
+      }
+
+      fs.writeFile(file, fileData, "utf8", err => {
+        if (err) {
+          log.error(`Failed to write file ${file}`);
+          return reject(err);
+        }
+        log.success(`${file} updated.`);
+        resolve(file);
+      });
+    });
+  });
+}
+
+async function renameFile(oldPath, newPath) {
+  return new Promise((resolve, reject) => {
+    fs.rename(oldPath, newPath, err => {
+      if (err) {
+        log.error(`Failed to rename ${oldPath}`);
+        return reject(err);
+      }
+      log.success(`Renamed: ${path.basename(oldPath)} → ${path.basename(newPath)}`);
+      resolve();
+    });
+  });
+}
+
+module.exports = { editFile, renameFile };

package/utils/git.js

@@ -0,0 +1,14 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const log = require('./logger');
+
+async function cloneRepo(repoUrl, destination) {
+  if (fs.existsSync(destination)) {
+    log.warn(`Path already exists: ${destination}`);
+    return;
+  }
+  log.info(`Cloning ${repoUrl} → ${destination}`);
+  execSync(`git clone ${repoUrl} ${destination}`, { stdio: 'inherit' });
+}
+
+module.exports = { cloneRepo };