xypriss 9.0.1 → 9.0.3

package/package.json

@@ -6,7 +6,8 @@
     },
     "bin": {
         "xsys": "scripts/xys.run.js",
-        "xypriss-sys": "scripts/xys.run.js"
+        "xypriss-sys": "scripts/xys.run.js",
+        "xems": "scripts/xems.run.js"
     },
     "browserslist": [
         "> 1%",
@@ -274,6 +275,6 @@
     "support": "https://github.com/Nehonix-Team/XyPriss/issues",
     "type": "module",
     "types": "dist/index.d.ts",
-    "version": "9.0.1"
+    "version": "9.0.3"
 }
 

package/scripts/install-memory-cli.js

@@ -128,14 +128,21 @@ async function installMemoryCLI() {
     const info = getPlatformBinary();
     if (!info) return;
 
+    console.log(`📂 Target directory: ${BIN_DIR}`);
+    console.log(`📦 Binary: ${info.binaryName}`);
+
     if (fs.existsSync(info.genericPath)) {
-        console.log("✨ Memory CLI already present.");
+        console.log(
+            `✨ Memory CLI already present at ${info.genericPath}, skipping.`,
+        );
         return;
     }
 
     try {
-        console.log(`📥 Fetching Memory CLI...`);
+        console.log(`📥 Fetching Memory CLI from:`);
+        console.log(`   🔗 URL: ${info.url}`);
         await downloadFile(info.url, info.localPath);
+        console.log("✅ Downloaded successfully.");
 
         if (process.platform !== "win32") {
             fs.chmodSync(info.localPath, 0o755);
@@ -151,7 +158,9 @@ async function installMemoryCLI() {
 
         const isValid = await verifyBinary(info.localPath);
         if (isValid) {
-            console.log("🎉 XyPriss MCLI installed successfully!");
+            console.log(
+                `🎉 XyPriss MCLI installed successfully at: ${info.genericPath}`,
+            );
         } else {
             console.warn(
                 "⚠️  MCLI verification failed, it might not work as expected.",

package/scripts/install-xems.js

@@ -14,13 +14,70 @@ import https from "https";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+// ─────────────────────────────────────────────
+//  ANSI Color Palette
+// ─────────────────────────────────────────────
+const c = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+
+    // Foreground
+    white: "\x1b[97m",
+    gray: "\x1b[90m",
+    red: "\x1b[91m",
+    green: "\x1b[92m",
+    yellow: "\x1b[93m",
+    blue: "\x1b[94m",
+    magenta: "\x1b[95m",
+    cyan: "\x1b[96m",
+};
+
+// ─────────────────────────────────────────────
+//  Logger
+// ─────────────────────────────────────────────
+const log = {
+    info: (msg) =>
+        console.log(
+            `${c.cyan}${c.bold}  ℹ ${c.reset}${c.white}${msg}${c.reset}`,
+        ),
+    success: (msg) =>
+        console.log(
+            `${c.green}${c.bold}  ✔ ${c.reset}${c.green}${msg}${c.reset}`,
+        ),
+    warn: (msg) =>
+        console.log(
+            `${c.yellow}${c.bold}  ⚠ ${c.reset}${c.yellow}${msg}${c.reset}`,
+        ),
+    error: (msg) =>
+        console.log(`${c.red}${c.bold}  ✖ ${c.reset}${c.red}${msg}${c.reset}`),
+    step: (msg) =>
+        console.log(
+            `${c.magenta}${c.bold}  ▶ ${c.reset}${c.magenta}${msg}${c.reset}`,
+        ),
+    link: (label, url) =>
+        console.log(
+            `${c.gray}    └─ ${c.dim}${label}:${c.reset} ${c.blue}${url}${c.reset}`,
+        ),
+    detail: (msg) => console.log(`${c.gray}    ${msg}${c.reset}`),
+    divider: () => console.log(`${c.gray}  ${"─".repeat(52)}${c.reset}`),
+    blank: () => console.log(),
+};
+
+// ─────────────────────────────────────────────
+//  Constants
+// ─────────────────────────────────────────────
 const BIN_DIR = path.join(__dirname, "..", "bin");
 const REPO = "Nehonix-Team/XyPriss-XEMS";
-const CDN_BASE_URL = "https://dll.nehonix.com/dl/mds/xems/bin"; // Fallback CDN
+const CDN_BASE_URL = "https://dll.nehonix.com/dl/mds/xems/bin";
+
+// ─────────────────────────────────────────────
+//  Platform Detection
+// ─────────────────────────────────────────────
 
 /**
- * Get platform-specific binary information for XEMS
- * Maps directly to the files in tools/XEMS/dist/
+ * Returns platform-specific binary metadata for XEMS.
+ * Maps to the files in tools/XEMS/dist/
  */
 function getPlatformBinary() {
     const platform = process.platform;
@@ -37,34 +94,32 @@ function getPlatformBinary() {
         return null;
     }
 
-    // Naming convention: xems-linux-x64, xems-windows-x64.exe, etc.
-    const binaryName = `xems-${binaryTarget}${platform === "win32" ? ".exe" : ""}`;
+    const ext = platform === "win32" ? ".exe" : "";
+    const binaryName = `xems-${binaryTarget}${ext}`;
 
     return {
         binaryName,
+        platform,
+        arch,
         url: `https://github.com/${REPO}/releases/latest/download/${binaryName}`,
         fallbackUrl: `${CDN_BASE_URL}/${binaryName}`,
         localPath: path.join(BIN_DIR, binaryName),
-        genericPath: path.join(
-            BIN_DIR,
-            "xems" + (platform === "win32" ? ".exe" : ""),
-        ),
+        genericPath: path.join(BIN_DIR, `xems${ext}`),
     };
 }
 
-/**
- * Download a file with redirect support
- */
+// ─────────────────────────────────────────────
+//  Downloader (with redirect support)
+// ─────────────────────────────────────────────
+
 function downloadFile(url, dest) {
     return new Promise((resolve, reject) => {
         const file = fs.createWriteStream(dest);
-
         const request = https.get(
             url,
-            {
-                headers: { "User-Agent": "XyPriss-Installer" },
-            },
+            { headers: { "User-Agent": "XyPriss-Installer" } },
             (response) => {
+                // Follow redirects
                 if (
                     response.statusCode >= 300 &&
                     response.statusCode < 400 &&
@@ -82,14 +137,23 @@ function downloadFile(url, dest) {
                     fs.unlinkSync(dest);
                     return reject(
                         new Error(
-                            `Server responded with ${response.statusCode}`,
+                            `Server responded with HTTP ${response.statusCode}`,
                         ),
                     );
                 }
 
-                response.pipe(file);
+                // Stream progress dots
+                let received = 0;
+                process.stdout.write(`${c.gray}    └─ Downloading `);
+                response.on("data", (chunk) => {
+                    received += chunk.length;
+                    if (received % (50 * 1024) < chunk.length)
+                        process.stdout.write(`${c.blue}.${c.reset}`);
+                });
 
+                response.pipe(file);
                 file.on("finish", () => {
+                    process.stdout.write(` ${c.green}done${c.reset}\n`);
                     file.close();
                     resolve();
                 });
@@ -104,58 +168,102 @@ function downloadFile(url, dest) {
     });
 }
 
+// ─────────────────────────────────────────────
+//  Main Installer
+// ─────────────────────────────────────────────
+
 async function installXems() {
+    log.blank();
+    log.divider();
+    console.log(
+        `${c.cyan}${c.bold}  XEMS Installer — XyPriss Entry Management System${c.reset}`,
+    );
+    log.divider();
+    log.blank();
+
+    // Ensure bin directory exists
     if (!fs.existsSync(BIN_DIR)) {
         fs.mkdirSync(BIN_DIR, { recursive: true });
+        log.detail(`Created bin directory: ${BIN_DIR}`);
     }
 
     const info = getPlatformBinary();
     if (!info) {
-        console.error(
-            "❌ XEMS is not supported on this platform/architecture.",
+        log.error(
+            "Unsupported platform/architecture. XEMS cannot be installed.",
         );
         return;
     }
 
+    log.info(
+        `Platform  : ${c.yellow}${info.platform}${c.reset} ${c.gray}(${info.arch})${c.reset}`,
+    );
+    log.info(`Binary    : ${c.yellow}${info.binaryName}${c.reset}`);
+    log.info(`Target    : ${c.yellow}${BIN_DIR}${c.reset}`);
+    log.blank();
+
+    // Skip if already installed
     if (fs.existsSync(info.genericPath)) {
-        console.log("✨ XEMS binary already present.");
+        log.success(`XEMS is already installed → ${info.genericPath}`);
+        log.blank();
         return;
     }
 
-    console.log(`🌐 Downloading XEMS (${info.binaryName})...`);
-
+    // Attempt GitHub download, then fallback CDN
+    log.step("Downloading XEMS binary…");
     try {
         try {
+            log.link("GitHub", info.url);
             await downloadFile(info.url, info.localPath);
-        } catch (e) {
-            console.log("📡 GitHub download failed, trying fallback CDN...");
+            log.success("Downloaded from GitHub.");
+        } catch (githubErr) {
+            log.warn(`GitHub download failed: ${githubErr.message}`);
+            log.step("Retrying with fallback CDN…");
+            log.link("CDN", info.fallbackUrl);
             await downloadFile(info.fallbackUrl, info.localPath);
+            log.success("Downloaded from fallback CDN.");
         }
 
+        // Set executable bit on Unix
         if (process.platform !== "win32") {
             fs.chmodSync(info.localPath, 0o755);
+            log.detail("Executable permission set (chmod 755).");
         }
 
+        // Create generic alias (symlink on Unix, copy on Windows)
         if (process.platform === "win32") {
             fs.copyFileSync(info.localPath, info.genericPath);
+            log.detail(`Copied binary → ${info.genericPath}`);
         } else {
             if (fs.existsSync(info.genericPath))
                 fs.unlinkSync(info.genericPath);
             fs.symlinkSync(path.basename(info.localPath), info.genericPath);
+            log.detail(`Symlink created → ${info.genericPath}`);
         }
 
-        console.log(`✅ XEMS successfully installed.`);
+        log.blank();
+        log.success(
+            `XEMS successfully installed at: ${c.bold}${info.genericPath}${c.reset}`,
+        );
     } catch (err) {
-        console.error("❌ XEMS download failed:", err.message);
+        log.blank();
+        log.error(`XEMS installation failed: ${err.message}`);
     }
+
+    log.blank();
+    log.divider();
+    log.blank();
 }
 
+// ─────────────────────────────────────────────
+//  Entry Point
+// ─────────────────────────────────────────────
+
 if (import.meta.url === `file://${process.argv[1]}`) {
     installXems().catch((error) => {
-        console.error("🔥 Installation failed:", error.message);
+        log.error(`Fatal error: ${error.message}`);
         process.exit(0);
     });
 }
 
 export { installXems };
-

package/scripts/postinstall-xsys.js

@@ -1,4 +1,11 @@
-import { execSync } from "child_process";
+#!/usr/bin/env node
+
+/**
+ * XSYS Installer Script
+ * Downloads the XSYS (XyPriss System Core) binary from GitHub Releases.
+ * Supports cross-platform: Windows, Linux, and macOS (Intel & Silicon).
+ */
+
 import fs from "fs";
 import { join, dirname, basename } from "path";
 import { platform, arch } from "os";
@@ -8,22 +15,73 @@ import { fileURLToPath } from "url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
+// ─────────────────────────────────────────────
+//  ANSI Color Palette
+// ─────────────────────────────────────────────
+const c = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    white: "\x1b[97m",
+    gray: "\x1b[90m",
+    red: "\x1b[91m",
+    green: "\x1b[92m",
+    yellow: "\x1b[93m",
+    blue: "\x1b[94m",
+    magenta: "\x1b[95m",
+    cyan: "\x1b[96m",
+};
+
+// ─────────────────────────────────────────────
+//  Logger
+// ─────────────────────────────────────────────
+const log = {
+    info: (msg) =>
+        console.log(
+            `${c.cyan}${c.bold}  ℹ ${c.reset}${c.white}${msg}${c.reset}`,
+        ),
+    success: (msg) =>
+        console.log(
+            `${c.green}${c.bold}  ✔ ${c.reset}${c.green}${msg}${c.reset}`,
+        ),
+    warn: (msg) =>
+        console.log(
+            `${c.yellow}${c.bold}  ⚠ ${c.reset}${c.yellow}${msg}${c.reset}`,
+        ),
+    error: (msg) =>
+        console.log(`${c.red}${c.bold}  ✖ ${c.reset}${c.red}${msg}${c.reset}`),
+    step: (msg) =>
+        console.log(
+            `${c.magenta}${c.bold}  ▶ ${c.reset}${c.magenta}${msg}${c.reset}`,
+        ),
+    link: (label, url) =>
+        console.log(
+            `${c.gray}    └─ ${c.dim}${label}:${c.reset} ${c.blue}${url}${c.reset}`,
+        ),
+    detail: (msg) => console.log(`${c.gray}    ${msg}${c.reset}`),
+    divider: () => console.log(`${c.gray}  ${"─".repeat(52)}${c.reset}`),
+    blank: () => console.log(),
+};
+
+// ─────────────────────────────────────────────
+//  Constants
+// ─────────────────────────────────────────────
 const REPO = "Nehonix-Team/XyPriss";
 const BIN_NAME = "xsys";
 const BIN_DIR = join(__dirname, "..", "bin");
 
-/**
- * Téléchargement avec support des redirections GitHub
- */
+// ─────────────────────────────────────────────
+//  Downloader (with redirect support)
+// ─────────────────────────────────────────────
+
 function downloadFile(url, dest) {
     return new Promise((resolve, reject) => {
         const file = fs.createWriteStream(dest);
         const request = https.get(
             url,
-            {
-                headers: { "User-Agent": "XyPriss-Installer" },
-            },
+            { headers: { "User-Agent": "XyPriss-Installer" } },
             (response) => {
+                // Follow redirects
                 if (
                     response.statusCode >= 300 &&
                     response.statusCode < 400 &&
@@ -35,18 +93,35 @@ function downloadFile(url, dest) {
                         .then(resolve)
                         .catch(reject);
                 }
+
                 if (response.statusCode !== 200) {
                     file.close();
                     fs.unlinkSync(dest);
-                    return reject(new Error(`HTTP ${response.statusCode}`));
+                    return reject(
+                        new Error(
+                            `Server responded with HTTP ${response.statusCode}`,
+                        ),
+                    );
                 }
+
+                // Stream progress dots
+                let received = 0;
+                process.stdout.write(`${c.gray}    └─ Downloading `);
+                response.on("data", (chunk) => {
+                    received += chunk.length;
+                    if (received % (50 * 1024) < chunk.length)
+                        process.stdout.write(`${c.blue}.${c.reset}`);
+                });
+
                 response.pipe(file);
                 file.on("finish", () => {
+                    process.stdout.write(` ${c.green}done${c.reset}\n`);
                     file.close();
                     resolve();
                 });
             },
         );
+
         request.on("error", (err) => {
             file.close();
             if (fs.existsSync(dest)) fs.unlinkSync(dest);
@@ -55,68 +130,104 @@ function downloadFile(url, dest) {
     });
 }
 
+// ─────────────────────────────────────────────
+//  Main Installer
+// ─────────────────────────────────────────────
+
 async function installXsys() {
+    log.blank();
+    log.divider();
+    console.log(
+        `${c.cyan}${c.bold}  XSYS Installer — XyPriss System Core${c.reset}`,
+    );
+    log.divider();
+    log.blank();
+
+    // Ensure bin directory exists
     if (!fs.existsSync(BIN_DIR)) {
         fs.mkdirSync(BIN_DIR, { recursive: true });
+        log.detail(`Created bin directory: ${BIN_DIR}`);
     }
 
     const osName = platform();
     const archName = arch();
 
-    // Mappage exact avec tes fichiers dans tools/xypriss-sys-go/dist/
+    // Map to binary target name
     let binaryTarget = "";
     if (osName === "linux") {
         binaryTarget = archName === "arm64" ? "linux-arm64" : "linux-amd64";
     } else if (osName === "darwin") {
-        binaryTarget = archName === "arm64" ? "darwin-arm64" : "darwin-amd64"; // Support macOS Intel & Silicon
+        binaryTarget = archName === "arm64" ? "darwin-arm64" : "darwin-amd64";
     } else if (osName === "win32") {
         binaryTarget = archName === "arm64" ? "windows-arm64" : "windows-amd64";
     } else {
-        console.error(`❌ Plateforme non supportée : ${osName}`);
+        log.error(`Unsupported platform: ${osName}`);
         return;
     }
 
-    const binaryFileName = `${BIN_NAME}-${binaryTarget}${osName === "win32" ? ".exe" : ""}`;
+    const ext = osName === "win32" ? ".exe" : "";
+    const binaryFileName = `${BIN_NAME}-${binaryTarget}${ext}`;
     const url = `https://github.com/${REPO}/releases/latest/download/${binaryFileName}`;
     const localPath = join(BIN_DIR, binaryFileName);
-    const genericPath = join(
-        BIN_DIR,
-        BIN_NAME + (osName === "win32" ? ".exe" : ""),
+    const genericPath = join(BIN_DIR, `${BIN_NAME}${ext}`);
+
+    log.info(
+        `Platform  : ${c.yellow}${osName}${c.reset} ${c.gray}(${archName})${c.reset}`,
     );
+    log.info(`Binary    : ${c.yellow}${binaryFileName}${c.reset}`);
+    log.info(`Target    : ${c.yellow}${BIN_DIR}${c.reset}`);
+    log.blank();
 
+    // Skip if already installed
     if (fs.existsSync(genericPath)) {
-        console.log("✨ XSYS est déjà présent.");
+        log.success(`XSYS is already installed → ${genericPath}`);
+        log.blank();
         return;
     }
 
-    console.log(`🌐 Téléchargement de XSYS (${binaryTarget})...`);
+    // Download
+    log.step("Downloading XSYS binary…");
+    log.link("GitHub", url);
 
     try {
         await downloadFile(url, localPath);
 
+        // Set executable bit on Unix
         if (osName !== "win32") {
             fs.chmodSync(localPath, 0o755);
+            log.detail("Executable permission set (chmod 755).");
         }
 
-        // Création du lien/copie générique
+        // Create generic alias (symlink on Unix, copy on Windows)
         if (osName === "win32") {
             fs.copyFileSync(localPath, genericPath);
+            log.detail(`Copied binary → ${genericPath}`);
         } else {
             if (fs.existsSync(genericPath)) fs.unlinkSync(genericPath);
             fs.symlinkSync(basename(localPath), genericPath);
+            log.detail(`Symlink created → ${genericPath}`);
         }
 
-        console.log(`✅ XSYS installé avec succès : ${genericPath}`);
-    } catch (err) {
-        console.error(
-            `❌ Échec de l'acquisition du binaire XSYS : ${err.message}`,
+        log.blank();
+        log.success(
+            `XSYS successfully installed at: ${c.bold}${genericPath}${c.reset}`,
         );
+    } catch (err) {
+        log.blank();
+        log.error(`XSYS installation failed: ${err.message}`);
     }
+
+    log.blank();
+    log.divider();
+    log.blank();
 }
 
+// ─────────────────────────────────────────────
+//  Entry Point
+// ─────────────────────────────────────────────
+
 if (import.meta.url === `file://${process.argv[1]}`) {
     installXsys().catch(() => process.exit(0));
 }
 
 export { installXsys };
-

package/scripts/postinstall.js

@@ -2,42 +2,132 @@
 
 /**
  * XyPriss Post-Install Script
- * Runs after npm install to set up platform-specific binaries
+ * Runs after `npm install` to set up all platform-specific binaries.
  */
 
 import { installMemoryCLI } from "./install-memory-cli.js";
 import { installXems } from "./install-xems.js";
 import { installXsys } from "./postinstall-xsys.js";
 
+// ─────────────────────────────────────────────
+//  ANSI Color Palette
+// ─────────────────────────────────────────────
+const c = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    white: "\x1b[97m",
+    gray: "\x1b[90m",
+    red: "\x1b[91m",
+    green: "\x1b[92m",
+    yellow: "\x1b[93m",
+    blue: "\x1b[94m",
+    magenta: "\x1b[95m",
+    cyan: "\x1b[96m",
+};
+
+// ─────────────────────────────────────────────
+//  Logger
+// ─────────────────────────────────────────────
+const log = {
+    info: (msg) =>
+        console.log(
+            `${c.cyan}${c.bold}  ℹ ${c.reset}${c.white}${msg}${c.reset}`,
+        ),
+    success: (msg) =>
+        console.log(
+            `${c.green}${c.bold}  ✔ ${c.reset}${c.green}${msg}${c.reset}`,
+        ),
+    warn: (msg) =>
+        console.log(
+            `${c.yellow}${c.bold}  ⚠ ${c.reset}${c.yellow}${msg}${c.reset}`,
+        ),
+    error: (msg) =>
+        console.log(`${c.red}${c.bold}  ✖ ${c.reset}${c.red}${msg}${c.reset}`),
+    step: (n, label) =>
+        console.log(
+            `${c.magenta}${c.bold}  [${n}] ${c.reset}${c.magenta}${label}${c.reset}`,
+        ),
+    divider: () => console.log(`${c.gray}  ${"─".repeat(52)}${c.reset}`),
+    blank: () => console.log(),
+};
+
+// ─────────────────────────────────────────────
+//  Steps Definition
+// ─────────────────────────────────────────────
+const STEPS = [
+    { label: "Memory CLI", fn: installMemoryCLI },
+    { label: "XEMS — XyPriss Entry Management System", fn: installXems },
+    { label: "XSYS — XyPriss System Core", fn: installXsys },
+];
+
+// ─────────────────────────────────────────────
+//  Post-Install Orchestrator
+// ─────────────────────────────────────────────
 async function postInstall() {
-    console.log("🔧 Running XyPriss post-install setup...");
+    log.blank();
+    log.divider();
+    console.log(`${c.cyan}${c.bold}  XyPriss — Post-Install Setup${c.reset}`);
+    log.divider();
+    log.blank();
 
-    try {
-        // 1. Install Memory CLI
-        await installMemoryCLI();
+    const results = [];
 
-        // 2. Install XEMS (Security Core)
-        await installXems();
+    for (let i = 0; i < STEPS.length; i++) {
+        const { label, fn } = STEPS[i];
+        log.step(`${i + 1}/${STEPS.length}`, label);
+
+        try {
+            await fn();
+            results.push({ label, ok: true });
+        } catch (err) {
+            log.warn(`Step "${label}" encountered an issue: ${err.message}`);
+            results.push({ label, ok: false, err: err.message });
+        }
+
+        log.blank();
+    }
 
-        // 3. Install XSYS (System Core)
-        await installXsys();
+    // ── Summary ──────────────────────────────────
+    log.divider();
+    console.log(`${c.cyan}${c.bold}  Setup Summary${c.reset}`);
+    log.divider();
 
-        console.log("✅ XyPriss setup complete!");
-    } catch (error) {
-        console.warn(
-            "⚠️  Post-install setup encountered issues:",
-            error.message,
+    let allOk = true;
+    for (const r of results) {
+        if (r.ok) {
+            log.success(r.label);
+        } else {
+            log.warn(`${r.label}  ${c.gray}(skipped: ${r.err})${c.reset}`);
+            allOk = false;
+        }
+    }
+
+    log.blank();
+
+    if (allOk) {
+        log.success("All components installed. XyPriss is ready!");
+    } else {
+        log.warn(
+            "Setup completed with warnings. XyPriss will run in fallback mode.",
+        );
+        log.info(
+            "Some features may be limited until missing binaries are installed.",
         );
-        console.log("📝 XyPriss will continue to work with fallback mode.");
     }
+
+    log.blank();
+    log.divider();
+    log.blank();
 }
 
-// Only run if this is the main module (not being imported)
+// ─────────────────────────────────────────────
+//  Entry Point
+// ─────────────────────────────────────────────
 if (import.meta.url === `file://${process.argv[1]}`) {
     postInstall().catch((error) => {
-        console.error("💥 Post-install failed:", error);
-        // Don't exit with error code to avoid breaking npm install
-        process.exit(0);
+        log.error(`Fatal error during post-install: ${error.message}`);
+        process.exit(0); // Don't break `npm install`
     });
 }
 

package/scripts/xems.run.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+/***************************************************************************
+ * XyPrissJS - Fast And Secure
+ *
+ * @author Nehonix
+ * @license Nehonix OSL (NOSL)
+ *
+ * Copyright (c) 2025 Nehonix. All rights reserved.
+ *
+ * This License governs the use, modification, and distribution of software
+ * provided by NEHONIX under its open source projects.
+ * NEHONIX is committed to fostering collaborative innovation while strictly
+ * protecting its intellectual property rights.
+ * Violation of any term of this License will result in immediate termination of all granted rights
+ * and may subject the violator to legal action.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
+ * AND NON-INFRINGEMENT.
+ * IN NO EVENT SHALL NEHONIX BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+ * OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE THE SOFTWARE,
+ * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+ *
+ ***************************************************************************** */
+
+/**
+ * Nehonix XEMS CLI Bridge
+ *
+ * This is the main bridge for the xems command.
+ * It manages the execution of the proprietary Go-based XEMS binary.
+ *
+ * © 2026 Nehonix Team. All rights reserved.
+ */
+
+import { spawn } from "node:child_process";
+import path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Get the path to the xems binary
+ */
+function getBinaryPath() {
+    const isWin = os.platform() === "win32";
+    const binName = isWin ? "xems.exe" : "xems";
+
+    // Strategic locations for the binary
+    const locations = [
+        path.join(__dirname, "..", "bin", binName), // Production (npm install)
+        path.join(process.cwd(), "bin", binName), // Local development
+        path.join(__dirname, "..", "tools", "XEMS", "bin", binName), // Dev target
+        path.join(__dirname, "..", "tools", "XEMS", "dist", binName), // Dist target
+    ];
+
+    for (const loc of locations) {
+        if (fs.existsSync(loc)) {
+            return loc;
+        }
+    }
+
+    return null;
+}
+
+/**
+ * Execute the binary with the provided arguments
+ */
+function main() {
+    const binaryPath = getBinaryPath();
+    const args = process.argv.slice(2);
+
+    if (!binaryPath) {
+        console.error("\x1b[31m[ERROR] XEMS Binary not found.\x1b[0m");
+        console.error(
+            "Please ensure the binary is installed by running: \x1b[36mxfpm update xypriss\x1b[0m",
+        );
+        process.exit(1);
+    }
+
+    // Spawn the binary process
+    const child = spawn(binaryPath, args, {
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            XEMS_BINARY_PATH: binaryPath,
+            XEMS_EXEC_CONTEXT: "npm-bin",
+        },
+    });
+
+    // Mirror exit signals and codes
+    child.on("exit", (code, signal) => {
+        if (signal) {
+            process.kill(process.pid, signal);
+        } else {
+            process.exit(code ?? 0);
+        }
+    });
+
+    child.on("error", (err) => {
+        console.error(
+            "\x1b[31m[CRITICAL] Failed to initiate xems execution:\x1b[0m",
+            err.message,
+        );
+        process.exit(1);
+    });
+}
+
+main();
+
+