NetMesh/lib/localShell.cjs

"use strict";

const localShellRules = require("./localShellRules.json");

const POWERSHELL_SHELLS = new Set(localShellRules.powershellShells);
const CMD_SHELLS = new Set(localShellRules.cmdShells);
const FISH_SHELLS = new Set(localShellRules.fishShells);
const POSIX_SHELLS = new Set(localShellRules.posixShells);
const WSL_SHELLS = new Set(localShellRules.wslShells);

function getExecutableBaseName(filePath) {
  const normalized = String(filePath || "").trim();
  if (!normalized) return "";
  const parts = normalized.split(/[\\/]/);
  return (parts[parts.length - 1] || "").toLowerCase();
}

function detectLocalOs(platformLike) {
  const platform = String(platformLike || "").toLowerCase();
  if (platform.includes("mac")) return "macos";
  if (platform.includes("win")) return "windows";
  if (platform.includes("darwin")) return "macos";
  return "linux";
}

/**
 * True when `filePath` points inside `%LOCALAPPDATA%\Microsoft\WindowsApps`,
 * i.e. it is a Windows App Execution Alias (MSIX/Store install stub).
 *
 * Aliases are zero-byte reparse points: `fs.statSync()` fails with EACCES and
 * `fs.existsSync()` returns false, yet spawning the alias path still launches
 * the packaged application. Consumers must not use existence checks to reject
 * these paths. Deliberately free of `node:path` — this module is also bundled
 * for the renderer.
 */
function isWindowsAppExecutionAliasPath(filePath) {
  if (!filePath || typeof filePath !== "string") return false;
  // Read via globalThis so renderer bundles (where `process` is not a global)
  // stay valid; alias detection is a main-process concern and safely
  // returns false when the env is unavailable.
  const localAppData = globalThis.process?.env?.LOCALAPPDATA;
  if (!localAppData) return false;
  const normalize = (p) => p.replace(/\\/g, "/").replace(/\/+/g, "/").toLowerCase();
  const aliasDir = `${normalize(localAppData)}/microsoft/windowsapps/`;
  return normalize(filePath).startsWith(aliasDir);
}

function classifyLocalShellType(shellPath, platformLike) {
  const shellName = getExecutableBaseName(shellPath);
  if (POWERSHELL_SHELLS.has(shellName)) return "powershell";
  if (CMD_SHELLS.has(shellName)) return "cmd";
  if (FISH_SHELLS.has(shellName)) return "fish";
  if (POSIX_SHELLS.has(shellName)) return "posix";
  if (WSL_SHELLS.has(shellName)) return "posix";
  if (!shellName) {
    return detectLocalOs(platformLike) === "windows" ? "powershell" : "posix";
  }
  return "unknown";
}

module.exports = {
  classifyLocalShellType,
  detectLocalOs,
  isWindowsAppExecutionAliasPath,
};