nexora-code 1.0.2 → 1.0.3

package/scripts/desktop/shortcut.cjs

@@ -0,0 +1,139 @@
+'use strict';
+// ╔══════════════════════════════════════════════════════════════════════════════╗
+// ║  Nexora Code — Desktop Shortcut Orchestrator                                 ║
+// ║  Handles context detection, routing, and cleanup across all platforms        ║
+// ╚══════════════════════════════════════════════════════════════════════════════╝
+
+const os   = require('os');
+const path = require('path');
+const fs   = require('fs');
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+
+function fileExistsSync(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}
+
+/**
+ * Finds the real home directory, even when running under sudo.
+ * On Linux/macOS: SUDO_USER env var tells us who actually invoked sudo.
+ * On Windows: USERPROFILE is always the actual user, even in admin shell.
+ */
+function getRealHomeDir() {
+  if (process.env.SUDO_USER) {
+    const plat = process.platform;
+    if (plat === 'linux')  return `/home/${process.env.SUDO_USER}`;
+    if (plat === 'darwin') return `/Users/${process.env.SUDO_USER}`;
+  }
+  return process.env.USERPROFILE || process.env.HOME || os.homedir();
+}
+
+/**
+ * Finds the desktop path, trying multiple locale variants.
+ * Returns null if no desktop directory is found (headless/server/WSL).
+ */
+function findDesktopPath(homeDir, platform) {
+  const candidates = [];
+
+  if (platform === 'windows') {
+    candidates.push(
+      path.join(homeDir, 'Desktop'),
+      path.join(homeDir, 'OneDrive', 'Desktop'),  // Very common on Win11 + OneDrive
+      path.join(homeDir, 'OneDrive - Personal', 'Desktop'),
+    );
+  } else if (platform === 'macos') {
+    candidates.push(path.join(homeDir, 'Desktop'));
+  } else {
+    // Linux: XDG standard + locale variants
+    const xdgDesktop = process.env.XDG_DESKTOP_DIR;
+    if (xdgDesktop) candidates.push(xdgDesktop);
+    candidates.push(
+      path.join(homeDir, 'Desktop'),
+      path.join(homeDir, 'Escritorio'),    // Spanish
+      path.join(homeDir, 'Bureau'),        // French
+      path.join(homeDir, 'Schreibtisch'),  // German
+      path.join(homeDir, 'デスクトップ'),   // Japanese
+      path.join(homeDir, '桌面'),           // Chinese (Simplified)
+    );
+  }
+
+  for (const candidate of candidates) {
+    if (fileExistsSync(candidate)) return candidate;
+  }
+  return null; // No desktop (headless, WSL, server, etc.)
+}
+
+/**
+ * Resolves the package root directory.
+ * When postinstall runs, __dirname is scripts/desktop/ inside the package.
+ */
+function getPackageDir() {
+  // __dirname = <pkg>/scripts/desktop/
+  return path.resolve(__dirname, '..', '..');
+}
+
+/**
+ * Assembles all paths needed to create/remove shortcuts.
+ * @returns {{ platform, realHomeDir, desktopPath, packageDir, binaryPath, iconDir }}
+ */
+function buildUserContext() {
+  const rawPlatform = process.platform;
+  const platform =
+    rawPlatform === 'win32'  ? 'windows' :
+    rawPlatform === 'darwin' ? 'macos'   : 'linux';
+
+  const realHomeDir  = getRealHomeDir();
+  const desktopPath  = findDesktopPath(realHomeDir, platform);
+  const packageDir   = getPackageDir();
+  const iconDir      = path.join(packageDir, 'assets');
+
+  // Determine where npm placed the nexora-code binary
+  const binaryName   = platform === 'windows' ? 'nexora-code.cmd' : 'nexora-code';
+  // npm puts global bins next to the node executable on Windows,
+  // or in /usr/local/bin (or prefix/bin) on Unix.
+  // process.execPath → e.g. C:\Program Files\nodejs\node.exe
+  // dirname → C:\Program Files\nodejs\ → that's where nexora-code.cmd lives
+  const npmBinDir    = path.dirname(process.execPath);
+  const binaryPath   = path.join(npmBinDir, binaryName);
+
+  return { platform, realHomeDir, desktopPath, packageDir, binaryPath, iconDir };
+}
+
+// ── Public API ────────────────────────────────────────────────────────────────
+
+function createShortcut() {
+  const ctx = buildUserContext();
+
+  if (!ctx.desktopPath) {
+    console.log('  ℹ  No desktop found (headless / server / WSL environment).');
+    console.log('     Run "nexora-code" in any terminal to start.');
+    return;
+  }
+
+  console.log('');
+  console.log('  ┌─────────────────────────────────────────────┐');
+  console.log('  │  Nexora Code  —  Desktop Shortcut Setup     │');
+  console.log('  └─────────────────────────────────────────────┘');
+  console.log('');
+
+  switch (ctx.platform) {
+    case 'windows': require('./windows.cjs').createWindowsShortcut(ctx); break;
+    case 'macos':   require('./macos.cjs').createMacosShortcut(ctx);     break;
+    case 'linux':   require('./linux.cjs').createLinuxShortcut(ctx);     break;
+    default:
+      console.log('  ⚠  Unrecognised platform — skipping shortcut creation.');
+  }
+}
+
+function removeShortcut() {
+  const ctx = buildUserContext();
+  if (!ctx.desktopPath) return;
+
+  switch (ctx.platform) {
+    case 'windows': require('./windows.cjs').removeWindowsShortcut(ctx); break;
+    case 'macos':   require('./macos.cjs').removeMacosShortcut(ctx);     break;
+    case 'linux':   require('./linux.cjs').removeLinuxShortcut(ctx);     break;
+  }
+}
+
+module.exports = { createShortcut, removeShortcut, buildUserContext };

package/scripts/desktop/windows.cjs

@@ -0,0 +1,99 @@
+'use strict';
+// ╔══════════════════════════════════════════════════════════════════════════════╗
+// ║  Nexora Code — Windows Shortcut Creator                                      ║
+// ║  Creates a .lnk file via PowerShell COM (WScript.Shell) — zero deps        ║
+// ╚══════════════════════════════════════════════════════════════════════════════╝
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs   = require('fs');
+
+/**
+ * Detect the best available terminal on Windows.
+ * Priority: Windows Terminal > PowerShell 7 > PowerShell 5
+ */
+function detectWindowsTerminal() {
+  // Windows Terminal (wt.exe) — best colour/font support
+  try {
+    execSync('where wt.exe', { stdio: 'pipe' });
+    return {
+      exe:   'wt.exe',
+      args:  'nexora-code',
+      label: 'Windows Terminal',
+    };
+  } catch { /* not installed */ }
+
+  // PowerShell 7+ (pwsh.exe) — modern, cross-platform
+  try {
+    execSync('where pwsh.exe', { stdio: 'pipe' });
+    return {
+      exe:   'pwsh.exe',
+      args:  '-NoExit -Command nexora-code',
+      label: 'PowerShell 7',
+    };
+  } catch { /* not installed */ }
+
+  // PowerShell 5 (built into all Windows 10/11) — guaranteed fallback
+  return {
+    exe:   'powershell.exe',
+    args:  '-NoExit -Command nexora-code',
+    label: 'PowerShell 5 (built-in)',
+  };
+}
+
+/**
+ * Creates a Windows .lnk shortcut using PowerShell's WScript.Shell COM object.
+ * No external libraries required.
+ */
+function createWindowsShortcut(ctx) {
+  const shortcutPath = path.join(ctx.desktopPath, 'Nexora Code.lnk');
+  const iconPath     = path.join(ctx.iconDir, 'icon.ico');
+  const iconExists   = fs.existsSync(iconPath);
+  const terminal     = detectWindowsTerminal();
+
+  // Escape single-quotes in paths for PowerShell string literals
+  const safeShortcutPath = shortcutPath.replace(/'/g, "''");
+  const safeIconPath     = iconPath.replace(/'/g, "''");
+  const safeWorkingDir   = '%USERPROFILE%';
+
+  const psLines = [
+    `$s = New-Object -ComObject WScript.Shell`,
+    `$lnk = $s.CreateShortcut('${safeShortcutPath}')`,
+    `$lnk.TargetPath = '${terminal.exe}'`,
+    `$lnk.Arguments = '${terminal.args}'`,
+    `$lnk.WorkingDirectory = '$env:USERPROFILE'`,
+    `$lnk.Description = 'Launch Nexora Code AI Workspace'`,
+    iconExists ? `$lnk.IconLocation = '${safeIconPath}'` : '',
+    `$lnk.Save()`,
+  ].filter(Boolean).join('; ');
+
+  try {
+    execSync(
+      `powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command "${psLines}"`,
+      { stdio: 'pipe', timeout: 20_000 }
+    );
+    console.log(`  ✓  Shortcut created:  ${shortcutPath}`);
+    console.log(`  ✓  Opens with:        ${terminal.label}`);
+    if (iconExists) console.log(`  ✓  Icon applied:      Nexora Code logo`);
+    console.log('');
+    console.log('  → Double-click "Nexora Code" on your Desktop to launch!');
+    console.log('');
+  } catch (err) {
+    throw new Error(`Windows .lnk creation failed: ${err.message}`);
+  }
+}
+
+/**
+ * Removes the Nexora Code desktop shortcut on Windows.
+ */
+function removeWindowsShortcut(ctx) {
+  const shortcutPath = path.join(ctx.desktopPath, 'Nexora Code.lnk');
+  try {
+    fs.unlinkSync(shortcutPath);
+    console.log('  ✓  Desktop shortcut removed: Nexora Code.lnk');
+  } catch {
+    // Already removed or never existed — that's fine
+  }
+}
+
+module.exports = { createWindowsShortcut, removeWindowsShortcut };