@dotcms/dotcli 24.2.26-rc1 → 24.2.26-rc3

package/README.md

@@ -1,7 +1,19 @@
 # dotCMS CLI 
-The dotCMS CLI is a command-line tool that you can use to populate and modify your dotCMS instances from a command shell.
+The **dotCMS CLI**, sometimes shortened to **dotCLI**, is a standalone tool for interacting with a dotCMS instance through a command shell, allowing a wide array of automated operations and behaviors.
+
+## Getting Started
+
+### Installation
+
+### NPM
+
+The simplest and most recommended way to get the dotCMS CLI is from its npm package:
+
+```shell script
+npm install -g @dotcms/cli
+```
+### Manual JAR Download
 
-## Quick start
 1. Download the CLI: The dotCMS CLI is delivered as an uber jar that can be downloaded from [here](https://repo.dotcms.com/artifactory/libs-snapshot-local/com/dotcms/dotcms-cli/).
  Once downloaded, you just need to run it with: 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/dotcli",
-  "version": "24.02.26-rc1",
+  "version": "24.02.26-rc3",
   "scripts": {
     "postinstall": "node src/postinstall.js install",
     "postuninstall": "node src/postinstall.js uninstall && npm prune"

package/src/postinstall.js

@@ -1,9 +1,11 @@
 "use strict";
 
+// Dependencies
 const path = require('path');
 const fs = require('fs').promises;
 const os = require('os');
 
+// Architecture and platform mappings
 const ARCHITECTURE_MAPPING = {
     "x64": "x86_64",
     "arm64": "aarch_64"
@@ -14,26 +16,35 @@ const PLATFORM_MAPPING = {
     "linux": "linux"
 };
 
+const EXTENSION_MAP = {
+    "win32": ".exe",
+    "default": ""
+};
+
+// Utility functions
 function getGlobalBinPath() {
     const npmGlobalPrefix = process.env.PREFIX || process.env.npm_config_prefix || process.env.HOME;
     return path.join(npmGlobalPrefix, 'bin');
 }
 
 function validatePackageConfig(packageJson) {
+    // Validation of package.json configuration
     if (!packageJson.version || !packageJson.packageName || !packageJson.alias || !packageJson.binaries || typeof packageJson.binaries !== "object") {
         throw new Error("Invalid package.json. 'version', 'packageName', 'alias' and 'binaries' must be specified.");
     }
 }
 
+// Read and parse package.json
 async function parsePackageJson() {
-
     console.log("Installing CLI");
+
     const platform = os.platform();
     const architecture = os.arch();
 
     console.log("Platform: " + platform);
     console.log("Architecture: " + architecture);
 
+    // Check installation support for platform and architecture
     if (!(os.arch() in ARCHITECTURE_MAPPING) || !(os.platform() in PLATFORM_MAPPING)) {
         throw new Error(`Installation is not supported for this ${platform}/${architecture} combination.`);
     }
@@ -48,7 +59,7 @@ async function parsePackageJson() {
         const packageName = packageJson.packageName;
         const alias = packageJson.alias;
         const binaries = packageJson.binaries;
-        const extension = platform === "win32" ? ".exe" : "";
+        const extension = EXTENSION_MAP[platform] || EXTENSION_MAP.default;
         const binaryKey = `${packageName}-${platform}-${architecture}`;
         const binaryPath = binaries[binaryKey];
 
@@ -69,76 +80,86 @@ async function parsePackageJson() {
     }
 }
 
+// Create symlink for the binary
+async function createSymlink(globalBinPath, config) {
+    try {
+        console.info(`Creating symlink for the relevant binary for your platform ${os.platform()}-${os.arch()}`);
 
-async function createSymlink(binarySource, binaryDestination) {
-    const globalBinPath = getGlobalBinPath();
-    const symlinkPath = path.join(globalBinPath, binaryDestination);
+        const currentDir = __dirname;
+        const targetDir = path.join(currentDir, '..');
+        const binarySource = path.join(targetDir, config.binaryPath);
+        const binaryDestination = config.alias;
+        const fullSymlinkPath = path.join(globalBinPath, binaryDestination);
 
-    try {
-        try {
-            await fs.access(symlinkPath, fs.constants.F_OK);
-            // If the symlink exists, remove it.
-            await fs.unlink(symlinkPath);
-            console.log(`Existing symlink ${symlinkPath} found and removed.`);
-        } catch (error) {
-            // The symlink does not exist, continue.
-        }
+        await fs.symlink(binarySource, fullSymlinkPath);
 
-        if (os.platform() === "win32") {
-            // Create a junction for the binary for Windows.
-            // await fs.symlink(binarySource, symlinkPath, "junction");
-        } else {
-            // Create a symlink for the binary for macOS and Linux.
-            await fs.symlink(binarySource, symlinkPath);
-        }
-        console.info(`Created symlink ${symlinkPath} pointing to ${binarySource}`);
+        console.info(`Created symlink ${fullSymlinkPath} pointing to ${binarySource}`);
     } catch (error) {
         console.error("Error while creating symlink:", error);
         throw new Error("Failed to create symlink.");
     }
 }
 
-async function installCli() {
-    const config = await parsePackageJson();
+// Remove symlink if exists
+async function removeSymlinkIfExists(globalBinPath, config) {
+    try {
+        console.info("Global bin path location:", globalBinPath);
 
-    console.log({
-        config
-    });
+        const files = await fs.readdir(globalBinPath);
+        const symlinkFileName = config.alias + config.extension;
+        const symlinkPath = files.find(file => file === symlinkFileName);
 
-    console.info(`Creating symlink for the relevant binary for your platform ${os.platform()}-${os.arch()}`);
+        if (!symlinkPath) {
+            console.warn(`Symlink '${symlinkFileName}' not found in the global bin directory.`);
+            return;
+        }
 
-    const currentDir = __dirname;
-    const targetDir = path.join(currentDir, '..');
-    const binarySource = path.join(targetDir, config.binaryPath);
-    const binaryDestination = config.alias;
+        const fullSymlinkPath = path.join(globalBinPath, symlinkPath);
+        await fs.unlink(fullSymlinkPath);
+        console.info(`Removed symlink: ${fullSymlinkPath}`);
+    } catch (error) {
+        console.warn("Error while removing symlink:", error);
+    }
+}
 
-    console.info("Installing cli:", binarySource, binaryDestination);
+// Install CLI
+async function installCli() {
+    const config = await parsePackageJson();
+    const globalBinPath = getGlobalBinPath();
 
-    await createSymlink(binarySource, binaryDestination + config.extension);
+    try{
+        await removeSymlinkIfExists(globalBinPath, config);
+        await createSymlink(globalBinPath, config);
+    } catch (ex) {
+        console.error("Error while installing:", ex);
+        throw new Error(`Failed to install ${config.alias}.`);
+    }
+
+    console.info(`${config.alias} installed successfully.`);
 }
 
+// Uninstall CLI
 async function uninstallCli() {
     const config = await parsePackageJson();
+    const globalBinPath = getGlobalBinPath();
 
     try {
-        const globalBinPath = getGlobalBinPath();
-        const symlinkPath = path.join(globalBinPath, config.alias + config.extension);
-
-        console.info("Removing symlink:", symlinkPath);
-
-        await fs.unlink(symlinkPath);
+        await removeSymlinkIfExists(globalBinPath, config);
     } catch (ex) {
         console.error("Error while uninstalling:", ex);
+        throw new Error(`Failed to uninstall ${config.alias}.`);
     }
 
-    console.info("Uninstalled cli successfully");
+    console.info(`${config.alias} uninstalled successfully.`);
 }
 
+// Available actions
 const actions = {
     "install": installCli,
     "uninstall": uninstallCli
 };
 
+// Execute action based on provided command
 const [cmd] = process.argv.slice(2);
 if (cmd && actions[cmd]) {
     actions[cmd]().then(
@@ -151,4 +172,4 @@ if (cmd && actions[cmd]) {
 } else {
     console.log("Invalid command. `install` and `uninstall` are the only supported commands");
     process.exit(1);
-}
+}